نام (NAME)

cgps - کلاینت پایانه مبتنی بر curses برای gpsd

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

cgps [OPTIONS] [server[:port[:device]]]

cgps -h

cgps -V

توضیحات (DESCRIPTION)

دستور cgps یک کلاینت gpsd مبتنی بر ncurses است. این برنامه قادر است روی یک پایانه سریال یا شبیه‌ساز پایانه اجرا شود. عملکرد آن شبیه به xgps(1) است، اما فاقد نمایش نگاره‌ای ماهواره‌ها بوده و به X یا سایر سیستم‌های پنجره‌بندی نیازی ندارد.

دستور cgps به دسترسی‌های ریشه (root) نیازی ندارد؛ هرچند با کاربر ریشه نیز بدون مشکل اجرا می‌شود. با این حال، اجرا از طریق sudo باعث از دست رفتن کارکردها خواهد شد.

هیچ‌یک از برآوردهای خطای ارائه‌شده توسط gpsd و نمایش‌داده‌شده توسط cgps نباید فراتر از سطح «کیفیت نسبی» در نظر گرفته شوند. سازندگان گیرنده‌های GNSS معمولاً مبنای برآوردهای خود را مستندسازی نمی‌کنند. آن‌هایی هم که برآوردهایشان را مستند می‌کنند، در تعریف و مفهوم آن‌ها ناهماهنگ و متناقض هستند.

گزینه‌ها (OPTIONS)

-?, -h, --help

چاپ خلاصه‌ای از گزینه‌ها و سپس خروج.

-D LVL, --debug LVL

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

-i, --imu

نمایش IMU به جای داده‌های موقعیت (fix) و ماهواره.

-l FMT, --llfmt FMT

تنظیم قالب گزارش‌های عرض و طول جغرافیایی. مقدار 'd' درجات اعشاری را تولید می‌کند که حالت پیش‌فرض است. مقدار 'm' درجات و دقایق اعشاری را تولید می‌کند. مقدار 's' درجات، دقایق و ثانیه‌های اعشاری را ارائه می‌دهد.

-m, --magtrack

نمایش مسیرها به‌صورت مغناطیسی، نه واقعی.

-m, --magtrack

نمایش مسیر مغناطیسی شما (در برابر مسیر واقعی‌تان). این مقدار محاسبه‌شده است و نه اندازه‌گیری‌شده. انحراف مغناطیسی همواره می‌تواند مستعد خطاهای بزرگ باشد، اما معمولاً خطای آن کمتر از دو درجه است.

-s, --silent

جلوگیری از نمایش داده‌های خام دریافتی از دیمن توسط cgps. این نمایش را می‌توان با کلید s نیز تغییر وضعیت داد.

-u UNITS, --units UNITS

تنظیم واحدهای سیستم برای نمایش؛ پس از این کلیدواژه، از 'i' یا 'imperial' برای واحدهای آمریکایی (فوت بین‌المللی برای ارتفاع و برآورد خطا، مایل بر ساعت برای سرعت)، از 'n' یا 'nautical' برای واحدهای دریایی (فوت در ارتفاع و برآورد خطا، گره دریایی برای سرعت) و از 'm' یا 'metric' برای واحدهای متریک (متر برای ارتفاع و برآورد خطا، کیلومتر بر ساعت برای سرعت) استفاده کنید.

نکته: واحد USA Survey Foot پشتیبانی نمی‌شود.

-V, --version

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

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

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

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

دستورها (COMMANDS)

دستور cgps با ارسال سیگنال SIGHUP یا SIGINT متوقف می‌شود؛ با توجه به تنظیمات پیش‌فرض پایانه، این کار هنگام فشردن کلیدهای Ctrl-C صورت می‌گیرد.

دستور cgps در حین اجرا چند دستور تک‌حرفی را می‌پذیرد:

c

پاک کردن پنجره پایینی.

d

نمایش طول/عرض جغرافیایی در قالب‌های dd.dddddddd و dd mm.mmmmmm و dd mm ss.ssss.

h

نمایش پنجره راهنما.

i

استفاده از واحدهای امپریال (imperial).

m

استفاده از واحدهای متریک (metric).

n

استفاده از واحدهای دریایی (nautical).

q

پاک کردن صفحه و خروج.

s

تغییر وضعیت نمایش داده‌های خام JSON در پنجره پایینی.

t

تغییر وضعیت مسیر بین واقعی (true) و مغناطیسی (magnetic).

محیط (ENVIRONMENT)

چنانچه هیچ سیستم واحدی در خط فرمان مشخص نشده باشد، متغیر محیطی GPSD_UNITS بررسی می‌شود. این متغیر می‌تواند مقادیر 'i'، 'imperial'، 'm'، 'metric' یا 'n'، 'nautical' را داشته باشد.

اگر هیچ سیستم واحدی در خط فرمان یا در GPSD_UNITS مشخص نشده باشد، ابتدا LC_MEASUREMENT و سپس LANG بررسی می‌شوند. چنانچه این مقدار برابر با 'C'، 'POSIX' باشد یا با 'en_US' آغاز شود، سیستم واحدها روی imperial تنظیم می‌شود. در صورتی که هیچ سیستمی انتخاب نشده باشد، مقدار پیش‌فرض metric خواهد بود.