نام (NAME)

gpssubframe - ابزاری برای استخراج و تخلیه جملات زیرفریم (subframe) از gpsd

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

gpssubframe [OPTIONS] [server[:port[:device]]]

gpssubframe -h

gpssubframe -V

توضیحات (DESCRIPTION)

gpssubframe ابزاری برای اتصال به gpsd و تخلیه داده‌های رمزگشایی‌شده زیرفریم در خروجی استاندارد (stdout) است. این ابزار تنها زمانی کاربرد دارد که گیرنده GNSS شما قادر به ارسال پیام‌های زیرفریم GPS باشد و برای انجام این کار پیکربندی شده باشد. همچنین داشتن دانش کاربردی از استاندارد IS-GPS-200 الزامی است؛ نسخه این استاندارد را در دسترس خود نگه دارید.

gpssubframe نیازی به مجوزهای ریشه (root) ندارد، اما با دسترسی ریشه نیز بدون مشکل اجرا می‌شود. این ابزار می‌تواند هم‌زمان با سایر ابزارهای متصل به gpsd محلی بدون ایجاد اختلال اجرا شود.

این برنامه پیام‌های زیرفریم را جمع‌آوری کرده و هنگام خروج، آن‌ها را بر اساس شماره ماهواره GPS در خروجی چاپ می‌کند. به‌طور پیش‌فرض، برنامه هرگز خارج نمی‌شود مگر اینکه کاربر تعداد ثانیه‌های اجرا یا تعداد پیام‌های دریافتی را تعیین کرده باشد.

به‌طور پیش‌فرض، gpssubframe به یک سرویس gpsd در حال اجرا روی میزبان محلی متصل می‌شود. به صورت اختیاری می‌توان میزبان، شماره پورت TCP/IP و دستگاه راه دور را نیز مشخص کرد.

گزینه‌ها (OPTIONS)

-?, -h, --help

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

-c COUNT, --count COUNT

خروج پس از دریافت COUNT پیام زیرفریم.

-D DEBUG, --debug DEBUG

تنظیم سطح اشکال‌زدایی. باید یک عدد صحیح باشد. پیش‌فرض 0 است.

--desc

چاپ توضیحات کامل و تفصیلی.

--device DEVICE

اتصال به دستگاه DEVICE روی میزبان gpsd.

-D LVL, --debug LVL

تنظیم سطح اشکال‌زدایی به LVL.

--file FILE

خواندن داده‌های JSON مربوط به gpsd از FILE به‌جای دریافت از gpsd.

--host HOST

اتصال به gpsd روی میزبان HOST.

--load LOADFILE

بارگذاری داده‌های ذخیره‌شده JSON شامل Subframe، TPV و RAW از LOADFILE.

-n COUNT, --count COUNT

تعداد پیام‌ها برای تجزیه. مقدار 0 برای غیرفعال کردن.

--port PORT

اتصال به gpsd روی پورت PORT.

--progress

چاپ گزارش‌های پیشرفت هم‌زمان با دریافت پیام‌ها.

--satpos

محاسبه موقعیت ماهواره‌های GPS پیش از خروج. اگر --time مشخص شده باشد، موقعیت‌ها در آن زمان محاسبه می‌شوند. در غیر این صورت، اگر یک پیام RAW دریافت شده باشد، زمان اندازه‌گیری در آن پیام استفاده خواهد شد. آخرین راهکار، استفاده از زمان آخرین پیام TPV است.

--save SAVEFILE

ذخیره داده‌های رمزگشایی‌شده زیرفریم در SAVEFILE در قالب JSON. در صورت وجود، آخرین رکوردهای JSON مربوط به TPV و RAW نیز ذخیره خواهند شد.

--test

اجرای کد خودآزمایی --satpos.

--time SEC

محاسبه موقعیت ماهواره در زمان SEC بر حسب ثانیه‌های POSIX.

-V, --version

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

-x SEC, --seconds SEC

مدت زمان بر حسب ثانیه برای تجزیه پیام‌ها. مقدار 0 برای غیرفعال کردن.

آرگومان‌ها (ARGUMENTS)

به‌طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی gpsd در حال اجرا روی میزبان محلی (localhost)، با استفاده از پورت پیش‌فرض GPSD یعنی 2947 جمع‌آوری می‌کنند. آرگومان اختیاری برای هر کلاینت می‌تواند این رفتار را لغو کند: [server[:port[:device]]]

برای توضیحات بیشتر و مشاهده مثال‌ها، بخش آرگومان‌ها (ARGUMENTS) را در صفحه راهنمای gps(1) ببینید.

مثال‌ها (EXAMPLES)

ابتدا یک گیرنده سری 9 شرکت u-blox را برای ارسال پیام‌های زیرفریم پیکربندی کنید. سپس از gpssubframe بخواهید یک مجموعه کامل از زیرفریم‌ها را جمع‌آوری کرده و داده‌ها را مرتب‌شده بر اساس شماره ماهواره GPS چاپ کند. اطمینان حاصل کنید که -P 22 را با نسخه پروتکل صحیح گیرنده خود جایگزین کرده‌اید. سپس موقعیت‌های شناخته‌شده ماهواره و همچنین زاویه سمت (azimuth)، ارتفاع (elevation) و فاصله از موقعیت فعلی را محاسبه و چاپ کنید:

ubxtool -P 22 -e SFRBX
gpssubframe -x 750 --satpos

اگر خیره شدن به صفحه خالی به مدت ۱۲٫۵ دقیقه بیش از حد استرس‌زاست، پیام‌های پیشرفت را فعال کنید:

gpssubframe -x 750 --satpos --progress

کدهای بازگشتی (RETURN VALUES)

0

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

1

در صورت بروز خطا.

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

gpsd(8), gps(1), gpsprof(1), gpsfake(1).

IS-GPS-200 "NAVSTAR GPS Space Segment/Navigation User Segment Interfaces"

منابع (RESOURCES)

تارنمای پروژه: https://gpsd.io

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

حق نشر این فایل متعلق به پروژه GPSD در سال 2020 است.
SPDX-License-Identifier: BSD-2-clause

نویسنده (AUTHOR)

Gary E. Miller