نام (NAME)

gpsdecode - رمزگشایی جریان‌های GPS، RTCM یا AIS به قالبی خوانا

خلاصه دستور (SYNOPSIS)

gpsdecode [OPTIONS]

gpsdecode -h

gpsdecode -V

توضیحات (DESCRIPTION)

ابزار gpsdecode یک رمزگشا در حالت دسته‌ای (batch-mode) برای NMEA و قالب‌های مختلف بسته‌های باینری مرتبط با GPS، AIS و خدمات تصحیح تفاضلی (differential-correction) است. این ابزار از ورودی باینری در ورودی استاندارد، یک خروجی JSON در خروجی استاندارد تولید می‌کند. ساختار JSON تولیدی همان قالبی است که توسط gpsd مستندسازی شده است؛ این ابزار از همان منطق رمزگشایی gpsd بهره می‌برد، اما با یک رابط ساده‌تر که برای پردازش دسته‌ای فایل‌های داده طراحی شده است.

تمام قالب‌های ورودی حسگر که برای پروژه GPSD شناخته‌شده هستند، توسط این ابزار قابل رمزگشایی می‌باشند. این موارد شامل NMEA، AIVDM (قالب جمله‌ای مشتق‌شده از NMEA که توسط AIS یا همان سامانه شناسایی خودکار شناورها استفاده می‌شود)، RTCM2 و تمام قالب‌های باینری پشتیبانی‌شده GPS (به‌ویژه SiRF) است. برای استانداردهای مرتبط و محدودیت‌های شناخته‌شده منطق رمزگشایی، به gpsd(8) مراجعه کنید.

شما می‌توانید از این ابزار به همراه nc(1) برای بررسی فیدهای AIS از خدمات تجمیع AIS، فیدهای RTCM از گیرنده‌های RTCM یا فرستنده‌های NTRIP استفاده کنید.

گزینه‌ها (OPTIONS)

-?, -h, --help

نمایش پیام راهنمای نحوه استفاده و سپس خروج.

-c, --json

تنظیم قالب تخلیه خروجی AIS برای جداسازی فیلدها با نویسه خط عمودی (pipe) در ASCII. فیلدها به ترتیبی که در بسته AIS ظاهر می‌شوند تخلیه می‌گردند. مقادیر عددی مقیاس‌بندی نمی‌شوند (-u اجباری می‌شود). رشته‌ها از حالت ۶ بیتی به ASCII کامل بازگشایی می‌شوند.

-d, --decode

رمزگشایی بسته‌های ارائه‌شده در ورودی استاندارد به خروجی استاندارد. این رفتار پیش‌فرض است.

-D LVL, --debug LVL

تنظیم سطح پرگویی اشکال‌زدایی روی LVL. این گزینه عمدتاً برای عیب‌یابی کاربرد دارد.

-e, --encode

کدگذاری JSON از ورودی استاندارد به JSON در خروجی استاندارد. این گزینه تنها برای آزمون‌های رگرسیونِ کدهای تخلیه و تجزیه JSON مفید است.

-j, --json

تنظیم قالب خروجی روی JSON (رفتار پیش‌فرض).

-m, --minlength

تخلیه حداقل طول برای هر نوع بسته در ورودی (با نادیده گرفتن بسته‌های توضیحات یا comment). این گزینه احتمالاً تنها برای توسعه‌دهندگان GPSD کاربرد دارد.

-n, --nmea

تخلیه شبه-NME0183 تولیدشده.

-s, --split24

گزارش نیمه‌های جملات AIS نوع ۲۴ به‌صورت جداگانه، به جای تلاش برای تجمیع آن‌ها.

-t TYPES, --types TYPES

فهرستی جداشده با ویرگول از انواع عددی. بسته‌هایی با نوع عددی AIS، RTCM2 یا RTCM3 تنها در صورتی عبور داده شده و خروجی داده می‌شوند که با یکی از انواع موجود در فهرست مطابقت داشته باشند. بسته‌های انواع دیگر (به‌ویژه بسته‌های GPS) بدون قید و شرط عبور داده می‌شوند.

-u, --unsscaled

جلوگیری از مقیاس‌بندی داده‌های AIS به مقادیر ممیز شناور (float) و بازگشایی متنی کدهای عددی. تخلیه داده با این گزینه بدون اتلاف (lossless) خواهد بود.

-v, --verbose

تخلیه بسته‌های متنی به خروجی به محض دریافت در ورودی، بلافاصله پیش از خروجی متناظرشان.

-V, --version

چاپ شماره نسخه و سپس خروج.

قالب AIS DSV (AIS DSV FORMAT)

با استفاده از گزینه -c یا --ais، خطوط تخلیه‌شده مقادیر فیلدهای بار داده (payload) در AIS هستند که با خط عمودی (pipe) جدا شده و به همان ترتیبی که در بار داده قرار دارند ارائه می‌شوند. بازه‌هایی از فیلدها که نمایانگر یک تاریخ هستند به صورت برچسب زمانی ISO8601 نمایش داده می‌شوند (به دونقطه‌ها و نویسه Z پایانی که بیانگر زمان Zulu/UTC است دقت کنید)، و گروه ۱۹ بیتی فیلدهای وضعیت TDMA موجود در انتهای پیام‌های نوع ۱ تا ۴ به عنوان یک عدد صحیح بدون علامت واحد تخلیه می‌شوند (به صورت هگزادسیمال با پیشوند "0x"). فیلدهای استفاده‌نشده مربوط به مراجع منطقه‌ای (regional-authority) نیز تخلیه می‌شوند (به صورت هگزادسیمال با پیشوند "0x"). فیلدهای باینری با طول متغیر به صورت یک طول بیتی عدد صحیح، به دنبال آن یک دونقطه، و سپس یک تخلیه هگزادسیمال نمایش می‌یابند.

وضعیت خروج (EXIT STATUS)

0

در صورت موفقیت.

1

اگر عملیات ناشناخته باشد یا نوشتن در سوکت کنترلی با شکست مواجه شود.

همچنین ببینید (SEE ALSO)

gpsd(8), gps(1)

منابع (RESOURCES)

وبگاه پروژه: https://gpsd.io

کپی‌رایت و تکثیر (COPYRIGHT)

حق نشر این پرونده متعلق به پروژه GPSD در سال ۲۰۱۳ است (Copyright 2013 by the GPSD project)
SPDX-License-Identifier: BSD-2-clause

نویسندگان (AUTHORS)

Eric S. Raymond