'\" t
.\"     Title: gpssubframe
.\"    Author: Gary E. Miller
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD Version 3.27.5
.\"  Language: English
.\"
.TH "GPSSUBFRAME" "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)"
gpssubframe \- ابزاری برای استخراج و تخلیه جملات زیرفریم (subframe) از gpsd
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBgpssubframe\fP [OPTIONS] [server[:port[:device]]]
.sp
\fBgpssubframe\fP \-h
.sp
\fBgpssubframe\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
\fBgpssubframe\fP ابزاری برای اتصال به \fBgpsd\fP و تخلیه داده‌های رمزگشایی‌شده زیرفریم در خروجی استاندارد (stdout) است. این ابزار تنها زمانی کاربرد دارد که گیرنده GNSS شما قادر به ارسال پیام‌های زیرفریم GPS باشد و برای انجام این کار پیکربندی شده باشد. همچنین داشتن دانش کاربردی از استاندارد IS\-GPS\-200 الزامی است؛ نسخه این استاندارد را در دسترس خود نگه دارید.
.sp
\fBgpssubframe\fP نیازی به مجوزهای ریشه (root) ندارد، اما با دسترسی ریشه نیز بدون مشکل اجرا می‌شود. این ابزار می‌تواند هم‌زمان با سایر ابزارهای متصل به \fBgpsd\fP محلی بدون ایجاد اختلال اجرا شود.
.sp
این برنامه پیام‌های زیرفریم را جمع‌آوری کرده و هنگام خروج، آن‌ها را بر اساس شماره ماهواره GPS در خروجی چاپ می‌کند. به‌طور پیش‌فرض، برنامه هرگز خارج نمی‌شود مگر اینکه کاربر تعداد ثانیه‌های اجرا یا تعداد پیام‌های دریافتی را تعیین کرده باشد.
.sp
به‌طور پیش‌فرض، \fBgpssubframe\fP به یک سرویس \fBgpsd\fP در حال اجرا روی میزبان محلی متصل می‌شود. به صورت اختیاری می‌توان میزبان، شماره پورت TCP/IP و دستگاه راه دور را نیز مشخص کرد.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
چاپ پیام راهنمای استفاده و خروج.
.RE
.sp
\fB\-c COUNT\fP, \fB\-\-count COUNT\fP
.RS 4
خروج پس از دریافت COUNT پیام زیرفریم.
.RE
.sp
\fB\-D DEBUG\fP, \fB\-\-debug DEBUG\fP
.RS 4
تنظیم سطح اشکال‌زدایی. باید یک عدد صحیح باشد. پیش‌فرض 0 است.
.RE
.sp
\fB\-\-desc\fP
.RS 4
چاپ توضیحات کامل و تفصیلی.
.RE
.sp
\fB\-\-device DEVICE\fP
.RS 4
اتصال به دستگاه DEVICE روی میزبان \fBgpsd\fP.
.RE
.sp
\fB\-D LVL\fP, \fB\-\-debug LVL\fP
.RS 4
تنظیم سطح اشکال‌زدایی به LVL.
.RE
.sp
\fB\-\-file FILE\fP
.RS 4
خواندن داده‌های JSON مربوط به gpsd از FILE به‌جای دریافت از gpsd.
.RE
.sp
\fB\-\-host HOST\fP
.RS 4
اتصال به gpsd روی میزبان HOST.
.RE
.sp
\fB\-\-load LOADFILE\fP
.RS 4
بارگذاری داده‌های ذخیره‌شده JSON شامل Subframe، TPV و RAW از LOADFILE.
.RE
.sp
\fB\-n COUNT\fP, \fB\-\-count COUNT\fP
.RS 4
تعداد پیام‌ها برای تجزیه. مقدار 0 برای غیرفعال کردن.
.RE
.sp
\fB\-\-port PORT\fP
.RS 4
اتصال به \fBgpsd\fP روی پورت PORT.
.RE
.sp
\fB\-\-progress\fP
.RS 4
چاپ گزارش‌های پیشرفت هم‌زمان با دریافت پیام‌ها.
.RE
.sp
\fB\-\-satpos\fP
.RS 4
محاسبه موقعیت ماهواره‌های GPS پیش از خروج. اگر \fB\-\-time\fP مشخص شده باشد، موقعیت‌ها در آن زمان محاسبه می‌شوند. در غیر این صورت، اگر یک پیام RAW دریافت شده باشد، زمان اندازه‌گیری در آن پیام استفاده خواهد شد. آخرین راهکار، استفاده از زمان آخرین پیام TPV است.
.RE
.sp
\fB\-\-save SAVEFILE\fP
.RS 4
ذخیره داده‌های رمزگشایی‌شده زیرفریم در SAVEFILE در قالب JSON. در صورت وجود، آخرین رکوردهای JSON مربوط به TPV و RAW نیز ذخیره خواهند شد.
.RE
.sp
\fB\-\-test\fP
.RS 4
اجرای کد خودآزمایی \fB\-\-satpos\fP.
.RE
.sp
\fB\-\-time SEC\fP
.RS 4
محاسبه موقعیت ماهواره در زمان SEC بر حسب ثانیه‌های POSIX.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
چاپ نسخه برنامه و سپس خروج.
.RE
.sp
\fB\-x SEC\fP, \fB\-\-seconds SEC\fP
.RS 4
مدت زمان بر حسب ثانیه برای تجزیه پیام‌ها. مقدار 0 برای غیرفعال کردن.
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
به‌طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی \fBgpsd\fP در حال اجرا روی میزبان محلی (localhost)، با استفاده از پورت پیش‌فرض GPSD یعنی 2947 جمع‌آوری می‌کنند. آرگومان اختیاری برای هر کلاینت می‌تواند این رفتار را لغو کند: \fB[server[:port[:device]]]\fP
.sp
برای توضیحات بیشتر و مشاهده مثال‌ها، بخش \fBآرگومان‌ها (ARGUMENTS)\fP را در صفحه راهنمای \fBgps\fP(1) ببینید.
.SH "مثال‌ها (EXAMPLES)"
.sp
ابتدا یک گیرنده سری 9 شرکت u\-blox را برای ارسال پیام‌های زیرفریم پیکربندی کنید. سپس از \fBgpssubframe\fP بخواهید یک مجموعه کامل از زیرفریم‌ها را جمع‌آوری کرده و داده‌ها را مرتب‌شده بر اساس شماره ماهواره GPS چاپ کند. اطمینان حاصل کنید که \fB\-P 22\fP را با نسخه پروتکل صحیح گیرنده خود جایگزین کرده‌اید. سپس موقعیت‌های شناخته‌شده ماهواره و همچنین زاویه سمت (azimuth)، ارتفاع (elevation) و فاصله از موقعیت فعلی را محاسبه و چاپ کنید:
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-P 22 \-e SFRBX
gpssubframe \-x 750 \-\-satpos
.fam
.fi
.if n .RE
.sp
اگر خیره شدن به صفحه خالی به مدت ۱۲٫۵ دقیقه بیش از حد استرس‌زاست، پیام‌های پیشرفت را فعال کنید:
.sp
.if n .RS 4
.nf
.fam C
gpssubframe \-x 750 \-\-satpos \-\-progress
.fam
.fi
.if n .RE
.SH "کدهای بازگشتی (RETURN VALUES)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgpsd\fP(8), \fBgps\fP(1), \fBgpsprof\fP(1), \fBgpsfake\fP(1).
.sp
IS\-GPS\-200 "NAVSTAR GPS Space Segment/Navigation User Segment Interfaces"
.SH "منابع (RESOURCES)"
.sp
\fBتارنمای پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق نشر این فایل متعلق به پروژه GPSD در سال 2020 است.
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسنده (AUTHOR)"
.sp
Gary E. Miller