'\" t
.\"     Title: gpsdecode
.\"    Author: Eric S. Raymond
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: English
.\"
.TH "GPSDECODE" "1" "2025-11-04" "GPSD, Version 3.27.5" "GPSD Documentation"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
gpsdecode \- رمزگشایی جریان‌های GPS، RTCM یا AIS به قالبی خوانا
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBgpsdecode\fP [OPTIONS]
.sp
\fBgpsdecode\fP \-h
.sp
\fBgpsdecode\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBgpsdecode\fP یک رمزگشا در حالت دسته‌ای (batch\-mode) برای NMEA و قالب‌های مختلف بسته‌های باینری مرتبط با GPS، AIS و خدمات تصحیح تفاضلی (differential\-correction) است. این ابزار از ورودی باینری در ورودی استاندارد، یک خروجی JSON در خروجی استاندارد تولید می‌کند. ساختار JSON تولیدی همان قالبی است که توسط \fBgpsd\fP مستندسازی شده است؛ این ابزار از همان منطق رمزگشایی \fBgpsd\fP بهره می‌برد، اما با یک رابط ساده‌تر که برای پردازش دسته‌ای فایل‌های داده طراحی شده است.
.sp
تمام قالب‌های ورودی حسگر که برای پروژه GPSD شناخته‌شده هستند، توسط این ابزار قابل رمزگشایی می‌باشند. این موارد شامل NMEA، AIVDM (قالب جمله‌ای مشتق‌شده از NMEA که توسط AIS یا همان سامانه شناسایی خودکار شناورها استفاده می‌شود)، RTCM2 و تمام قالب‌های باینری پشتیبانی‌شده GPS (به‌ویژه SiRF) است. برای استانداردهای مرتبط و محدودیت‌های شناخته‌شده منطق رمزگشایی، به \fBgpsd\fP(8) مراجعه کنید.
.sp
شما می‌توانید از این ابزار به همراه \fBnc\fP(1) برای بررسی فیدهای AIS از خدمات تجمیع AIS، فیدهای RTCM از گیرنده‌های RTCM یا فرستنده‌های NTRIP استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش پیام راهنمای نحوه استفاده و سپس خروج.
.RE
.sp
\fB\-c\fP, \fB\-\-json\fP
.RS 4
تنظیم قالب تخلیه خروجی AIS برای جداسازی فیلدها با نویسه خط عمودی (pipe) در ASCII. فیلدها به ترتیبی که در بسته AIS ظاهر می‌شوند تخلیه می‌گردند. مقادیر عددی مقیاس‌بندی نمی‌شوند (\fB\-u\fP اجباری می‌شود). رشته‌ها از حالت ۶ بیتی به ASCII کامل بازگشایی می‌شوند.
.RE
.sp
\fB\-d\fP, \fB\-\-decode\fP
.RS 4
رمزگشایی بسته‌های ارائه‌شده در ورودی استاندارد به خروجی استاندارد. این رفتار پیش‌فرض است.
.RE
.sp
\fB\-D LVL\fP, \fB\-\-debug LVL\fP
.RS 4
تنظیم سطح پرگویی اشکال‌زدایی روی LVL. این گزینه عمدتاً برای عیب‌یابی کاربرد دارد.
.RE
.sp
\fB\-e\fP, \fB\-\-encode\fP
.RS 4
کدگذاری JSON از ورودی استاندارد به JSON در خروجی استاندارد. این گزینه تنها برای آزمون‌های رگرسیونِ کدهای تخلیه و تجزیه JSON مفید است.
.RE
.sp
\fB\-j\fP, \fB\-\-json\fP
.RS 4
تنظیم قالب خروجی روی JSON (رفتار پیش‌فرض).
.RE
.sp
\fB\-m\fP, \fB\-\-minlength\fP
.RS 4
تخلیه حداقل طول برای هر نوع بسته در ورودی (با نادیده گرفتن بسته‌های توضیحات یا comment). این گزینه احتمالاً تنها برای توسعه‌دهندگان GPSD کاربرد دارد.
.RE
.sp
\fB\-n\fP, \fB\-\-nmea\fP
.RS 4
تخلیه شبه\-NME0183 تولیدشده.
.RE
.sp
\fB\-s\fP, \fB\-\-split24\fP
.RS 4
گزارش نیمه‌های جملات AIS نوع ۲۴ به‌صورت جداگانه، به جای تلاش برای تجمیع آن‌ها.
.RE
.sp
\fB\-t TYPES\fP, \fB\-\-types TYPES\fP
.RS 4
فهرستی جداشده با ویرگول از انواع عددی. بسته‌هایی با نوع عددی AIS، RTCM2 یا RTCM3 تنها در صورتی عبور داده شده و خروجی داده می‌شوند که با یکی از انواع موجود در فهرست مطابقت داشته باشند. بسته‌های انواع دیگر (به‌ویژه بسته‌های GPS) بدون قید و شرط عبور داده می‌شوند.
.RE
.sp
\fB\-u\fP, \fB\-\-unsscaled\fP
.RS 4
جلوگیری از مقیاس‌بندی داده‌های AIS به مقادیر ممیز شناور (float) و بازگشایی متنی کدهای عددی. تخلیه داده با این گزینه بدون اتلاف (lossless) خواهد بود.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
تخلیه بسته‌های متنی به خروجی به محض دریافت در ورودی، بلافاصله پیش از خروجی متناظرشان.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
چاپ شماره نسخه و سپس خروج.
.RE
.SH "قالب AIS DSV (AIS DSV FORMAT)"
.sp
با استفاده از گزینه \fB\-c\fP یا \fB\-\-ais\fP، خطوط تخلیه‌شده مقادیر فیلدهای بار داده (payload) در AIS هستند که با خط عمودی (pipe) جدا شده و به همان ترتیبی که در بار داده قرار دارند ارائه می‌شوند. بازه‌هایی از فیلدها که نمایانگر یک تاریخ هستند به صورت برچسب زمانی ISO8601 نمایش داده می‌شوند (به دونقطه‌ها و نویسه Z پایانی که بیانگر زمان Zulu/UTC است دقت کنید)، و گروه ۱۹ بیتی فیلدهای وضعیت TDMA موجود در انتهای پیام‌های نوع ۱ تا ۴ به عنوان یک عدد صحیح بدون علامت واحد تخلیه می‌شوند (به صورت هگزادسیمال با پیشوند "0x"). فیلدهای استفاده‌نشده مربوط به مراجع منطقه‌ای (regional\-authority) نیز تخلیه می‌شوند (به صورت هگزادسیمال با پیشوند "0x"). فیلدهای باینری با طول متغیر به صورت یک طول بیتی عدد صحیح، به دنبال آن یک دونقطه، و سپس یک تخلیه هگزادسیمال نمایش می‌یابند.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
اگر عملیات ناشناخته باشد یا نوشتن در سوکت کنترلی با شکست مواجه شود.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgpsd\fP(8), \fBgps\fP(1)
.SH "منابع (RESOURCES)"
.sp
\fBوبگاه پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
حق نشر این پرونده متعلق به پروژه GPSD در سال ۲۰۱۳ است (Copyright 2013 by the GPSD project)
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسندگان (AUTHORS)"
.sp
Eric S. Raymond