نام (NAME)

xgps - کلاینت X برای gpsd

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

xgps [OPTIONS] [service[:port[:device]]]

xgps -h

xgps -V

توضیحات (DESCRIPTION)

برنامه xgps یک کلاینت نمونه ساده با رابط گرافیکی X برای gpsd است. این برنامه اطلاعات موقعیت/زمان/سرعت فعلی GNSS و (برای گیرنده‌های GNSS که از این قابلیت پشتیبانی می‌کنند) موقعیت ماهواره‌های در دسترس را نمایش می‌دهد.

در نمای آسمان (sky view)، ماهواره‌ها برای نمایش کیفیت سیگنال رنگ‌بندی شده‌اند؛ برای مقادیر دقیق برحسب dB به بخش نمایش داده در سمت چپ مراجعه کنید. شمایل‌های لوزی‌شکل نشان‌دهنده ماهواره‌های GLONASS، مربع‌ها برای SBAS (مانند WAAS، EGNOS)، دایره‌ها نشان‌دهنده GPS، و مثلث‌های رو به پایین، رو به بالا، رو به راست و رو به چپ به ترتیب نشان‌دهنده ماهواره‌های سامانه‌های Galileo، BeiDou، QZSS و سامانه‌های دیگر (مانند IMES، IRNSS و همچنین سامانه‌های ناشناخته) هستند. شمایل‌های پُر در تعیین موقعیت (fix) فعلی استفاده شده‌اند و شمایل‌های توخالی استفاده نشده‌اند. نگه‌داشتن نشانگر ماوس روی یک نماد، موقتاً پنجره پاپ‌آپ کوچکی حاوی جزئیات ماهواره از پنل فهرست ماهواره‌ها (Satellite List) را نمایش می‌دهد.

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

گزینه‌ها (OPTIONS)

-?, -h, --help

باعث می‌شود کلاینت خلاصه‌ای از گزینه‌های خود را نمایش داده و خارج شود.

-device DEVICE

دستگاهی روی میزبان که باید به آن متصل شود. مقدار پیش‌فرض خالی (هر دستگاهی) است.

-D LVL, --debug LVL

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

--host HOST

میزبان (سرور) برای اتصال. پیش‌فرض localhost است.

-l FMT, --llfmt FMT

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

-p PORT, --port PORT

درگاهی (پورت) که باید به آن متصل شود. پیش‌فرض 2947 است.

-r DEG, --rotate DEG

آرگومانی برحسب درجه دریافت می‌کند تا نمای آسمان را در خلاف جهت عقربه‌های ساعت بچرخاند.

-c FORMAT, --const FORMAT

قالب نمایش صورت فلکی ماهواره‌ای. می‌تواند به صورت مخفف، نام کامل، یا در صورت امکان نام کامل به همراه پرچم نمایش داده شود. نکته: پرچم‌ها نیازمند قلم UTF-8 با ایموجی‌های پرچم هستند.

-V, --version

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

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

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

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

محیط (ENVIRONMENT)

متغیر محیطی XGPSOPTS> می‌تواند برای انتقال گزینه‌های پرکاربرد خط فرمان به xgps تنظیم شود. این متغیر معمولاً برای تنظیم گزینه -u متناسب با واحدهای محلی (locale) استفاده می‌شود. XGPSOPTS پیش از گزینه‌های خط فرمان پردازش می‌شود.

برنامه xgps همچنین سایر متغیرهای محیطی را برای تعیین واحدهای نمایش — امپریال، دریایی، یا متریک بررسی می‌کند. متغیرها و مقادیر بررسی‌شده عبارتند از:

GPSD_UNITS one of:
          i          = miles/feet
          imperial   = miles/feet
          n          = knots/feet
          nautical   = knots/feet
          m          = km/meters
          metric     = km/meters
LC_MEASUREMENT
          en_US      = miles/feet
          C          = miles/feet
          POSIX      = miles/feet
          [other]    = km/meters
LANG
          en_US      = miles/feet
          C          = miles/feet
          POSIX      = miles/feet
          [other]    = km/meters

گزینه -u یا --units بر این تنظیمات اولویت دارد.

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

نکته: پای نقشه‌برداری ایالات متحده (USA Survey Foot) پشتیبانی نمی‌شود.

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

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

گزینه‌های منو (MENU OPTIONS)

File > Connect

تلاش برای برقراری یک اتصال جدید به سرور، که به‌طور پیش‌فرض سرور قبلی است.

File > Disconnect

استفاده از قابلیت قطع اتصال برای قطع ارتباط فعلی سرور بدون خروج از نرم‌افزار.

File > Devices

این گزینه به شما امکان می‌دهد دستگاهی را که XGPS داده‌ها را از آن گزارش می‌کند تغییر دهید، که پیش‌فرض آن همه دستگاه‌ها است.

File > Quit

خروج از xgps.

View

تغییر وضعیت نمایش پنل‌ها در صفحه؛ پنل‌ها (از بالا به پایین) عبارتند از: نمای آسمان ماهواره‌ها، داده‌های ماهواره‌های موقعیت‌یاب جهانی (GPS)، سامانه شناسایی خودکار (دریایی) (AIS)، حسگر وضعیت (attitude sensor)، واحدهای اندازه‌گیری اینرسی (IMU)، آمارهای نویز، و موقعیت‌یابی کینماتیک آنی (RTK). برنامه Xgps به‌طور پیش‌فرض پنل‌های Skyview و GPS را نمایش می‌دهد، پنل AIS تا زمان انتخاب پنهان می‌ماند، و پنل‌های وضعیت، IMU، نویز و RTK تا زمان دریافت داده‌های مربوطه به‌طور خودکار آشکار نمی‌شوند.

Units > Imperial, Metric, Nautical

انتخاب مجموعه واحدهای مورد استفاده برای سرعت و ارتفاع. این تنظیم به‌طور پیش‌فرض متریک است، مگر اینکه xgps مقادیر آمریکایی، "C" یا "POSIX" را برای متغیرهای محیطی LANG یا LC_MEASUREMENT تشخیص دهد (به بالا مراجعه کنید).

Units > DD.dd, DD MM.mm, DD MM SS.ss

تنظیم قالب زاویه برحسب درجات، درجات-دقایق، یا درجات-دقایق ثانیه‌ها. آخرین واحد یک عدد ممیز شناور و واحدهای قبلی اعداد صحیح هستند.

Units > 30, 45, Off

تغییر خطوط درجه‌بندی نمودار پراکندگی ماهواره؛ پیش‌فرض ۳۰ درجه است.

Units > Mag North Up, Track Up, True North Up

تغییر جهت‌گیری در نمودار پراکندگی ماهواره مطابق سلیقه شما، که پیش‌فرض آن شمال حقیقی (True North) به سمت بالا است.

Help > About

نمایش اطلاعات درباره xgps.