نام (NAME)

zerk - ابزار همه‌منظوره پیکربندی و اتصال GREIS

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

zerk [OPTIONS] [server[:port[:device]]]

zerk -h

zerk -V

توضیحات (DESCRIPTION)

ابزار zerk یک اتصال‌دهنده و ابزار همه‌منظوره GREIS (مشخصات رابط خارجی گیرنده ناوبری ماهواره‌ای - GNSS Receiver External Interface Specification) است. اگر دستگاه GPS ساخت Javad که از پروتکل GREIS پشتیبانی کند ندارید، نیازی به مطالعه ادامه این راهنما نیست.

این ابزار در سطحی بسیار پایین با GPS جاواد شما ارتباط برقرار می‌کند. برای درک عملکرد zerk باید از پیش با GPS جاواد خود و مستندات پروتکل GREIS آشنایی داشته باشید. GREIS Guide https://www.javad.com/downloads/javadgnss/manuals/GREIS/GREIS_Reference_Guide.pdf.

برنامه zerk می‌تواند پیام‌های رایج GREIS را رمزگشایی کند، وضعیت GPS را استعلام نماید، قابلیت‌های GPS را فعال یا غیرفعال کند، و دستورات سفارشی کاربر را به GPS ارسال نماید. این ابزار قادر است پیام‌های GREIS را از یک فایل بخواند، و همچنین می‌تواند به طور مستقیم از طریق یک پورت سریال یا از طریق یک نمونه در حال اجرای gpsd به تبادل اطلاعات (خواندن و نوشتن) بپردازد.

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

گزینه‌ها (OPTIONS)

این برنامه گزینه‌های زیر را می‌پذیرد:

-?, -h

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

-c COMMAND

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

-d OPTION

غیرفعال کردن یک قابلیت در GPS. یک پارامتر OPTION (گزینه‌ای که باید غیرفعال شود) می‌پذیرد. zerk پس از تایید دستور توسط GPS خارج می‌شود، مگر اینکه گزینه -W مشخص شده باشد.

4HZ

غیرفعال‌سازی پیام‌های پایه GREIS در نرخ 4Hz. این پیام‌ها عبارتند از: [RT]، [UO]، [GT]، [PV]، [SG]، [DP]، [SI]، [EL]، [AZ]، [EC]، [SS]، و [ET]

COMPASS

غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای COMPASS (BeiDou).

CONS

غیرفعال‌سازی استفاده از تمام صورت‌های فلکی ماهواره‌ای.

DEFMSG

غیرفعال‌سازی مجموعه پیام‌های پیش‌فرض (/dev/msg) در نرخ 1Hz.

GALILEO

غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای GALILEO.

GLONASS

غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای GLONASS.

GPS

غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای GPS.

IPR

غیرفعال‌سازی تمام پیام‌های فواصل شبه‌تصادفی صحیح (Integer Pseudo Range). این پیام‌ها شامل موارد زیر هستند: [rx]، [rc]، [r1]، [r2]، [r3]، [r5]، [rl].

IRNSS

غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای IRNSS.

NMEA

غیرفعال‌سازی پیام‌های پایه NMEA 4.1e در نرخ 4Hz. این پیام‌ها شامل GBS، GGA، GSA، GST، GSV، RMC، VTG، و ZDA هستند.

QZSS

غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای QZSS.

SBAS

غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای SBAS.

SNR

غیرفعال‌سازی تمام پیام‌های نسبت سیگنال به نویز (SNR)، به استثنای [EC]. پیام‌های غیرفعال‌شده شامل موارد زیر هستند: [E1]، [E2]، [E3]، [E5]، [El].

-e OPTION

فعال کردن یک قابلیت در GPS. یک پارامتر OPTION (گزینه‌ای که باید فعال شود) می‌پذیرد. zerk پس از تایید دستور توسط GPS خارج می‌شود، مگر اینکه گزینه -W مشخص شده باشد. گزینه -e همان شناسه‌های OPTION موجود در گزینه -d را می‌پذیرد، با این تفاوت که به جای غیرفعال‌سازی، آن‌ها را فعال می‌کند.

-f FILE

اتصال به یک فایل یا دستگاه. یک پارامتر FILE (فایل یا دستگاهی که باید باز شود) می‌پذیرد. فایل‌ها به صورت فقط‌خواندنی باز می‌شوند. دستگاه‌های نویسه‌ای به صورت خواندن/نوشتن باز می‌شوند، مگر اینکه گزینه -r تعیین شده باشد. استفاده از این گزینه مستلزم نصب ماژول pyserial است.

-O OAF

بارگذاری یک فایل مجوز گزینه‌ها (OAF یا Option Authorization File) در GPS. یک پارامتر OAF (فایل دستوراتی که باید خوانده شود) می‌پذیرد. فایل OAF نوع خاصی از فایل‌های '.jpo' (فایل دستورات GREIS) است. گزینه -O هر فایل معتبر .jpo را به GPS ارسال می‌کند.

-p PRESET

ارسال یک دستور از پیش تنظیم‌شده به GPS. یک پارامتر PRESET (نام دستور ارسالی) می‌پذیرد. zerk پس از تایید دستور توسط GPS خارج می‌شود، مگر اینکه گزینه -W مشخص شده باشد.

COLDBOOT

راه‌اندازی سرد (Coldboot) دستگاه GPS.

CONS

استعلام صورت‌های فلکی ماهواره‌ای فعال‌شده.

DM

غیرفعال کردن تمام پیام‌های متناوب و دوره‌ای GREIS.

ID

استعلام شناسه (ID) گیرنده.

IPR

استعلام تمام پیام‌های فواصل شبه‌تصادفی صحیح. این پیام‌ها شامل موارد زیر هستند: [rx]، [rc]، [r1]، [r2]، [r3]، [r5]، [rl].

OAF

استعلام تمام گزینه‌های مجوز OAF.

RESET

راه‌اندازی مجدد (Reboot) دستگاه GPS.

SERIAL

استعلام شماره سریال گیرنده.

SNR

استعلام تمام پیام‌های نسبت سیگنال به نویز (SNR): [EC]، [E1]، [E2]، [E3]، [E5]، [El].

VENDOR

استعلام سازنده دستگاه GPS.

VER

استعلام نسخه نرم‌افزاری GPS.

-r

فقط‌خواندنی. هیچ داده‌ای به GPS ارسال نمی‌کند.

-R RAW

ذخیره تمام داده‌های خام دریافتی از GPS درون فایل RAW.

-S SPEED

پیکربندی سرعت پورت سریال GPS روی SPEED بیت بر ثانیه (bps).

-s SPEED

تنظیم سرعت پورت سریال محلی روی SPEED بیت بر ثانیه (bps). مقدار پیش‌فرض 115,200 است.

-V

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

-v VERBOSITY

تنظیم سطح پرگویی و جزئیات خروجی روی VERBOSITY. مقدار جزئیات می‌تواند از 0 (بسیار کم و بدون جزئیات) تا 4 (بسیار پرجزئیات) باشد. مقدار پیش‌فرض 2 است.

-W

اجبار به منتظر ماندن در تمام طول زمان تعیین‌شده. بدون خروج زودهنگام پس از اتمام دستورات -d، -e یا -p.

-w WAIT

انتظار به مدت WAIT ثانیه پیش از خروج. در صورت اتمام دستورات -d، -e یا -p برنامه زودتر خارج خواهد شد، مگر اینکه گزینه -W داده شده باشد. مقدار پیش‌فرض 2.0 ثانیه است.

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

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

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

محیط (ENVIRONMENT)

گزینه‌ها را می‌توان در متغیر محیطی ZERKOPTS قرار داد. این متغیر محیطی پیش از گزینه‌های خط فرمان پردازش می‌شود.

مثال‌ها (EXAMPLES)

چاپ پورت سریال فعلی دستگاه GPS متصل به gpsd محلی در حال اجرا:

zerk -c "print,/cur/term"

رمزگشایی یک فایل لاگ خام:

zerk -r -f greis-binary.log -v 2

تغییر سرعت پورت GPS دستگاه روی /dev/ttyAMA0 به 230,400 بیت بر ثانیه:

zerk -S 230400 -f /dev/ttyAMA0

مشاهده کامل چرخه راه‌اندازی مجدد (Reset) دستگاه GPS:

zerk -p RESET -v 2 -w 20 -W

استعلام وضعیت ماهواره‌ها (SVs):

zerk -W -w 2 -v 2 -c "out,,jps/{CS,ES,GS,Is,WS,QS}"

استخراج داده‌های gpsd از یک سرور راه دور:

zerk -v 2 -w 5 server

کدهای خروج (RETURN VALUES)

0

در صورت اجرای موفقیت‌آمیز.

1

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

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

برنامه zerk به گونه‌ای نوشته شده است که با مستندات رسمی Javad برای پروتکل GREIS مطابقت داشته باشد. GREIS Guide https://www.javad.com/downloads/javadgnss/manuals/GREIS/GREIS_Reference_Guide.pdf.

gpsd(8)

منابع (RESOURCES)

وبگاه پروژه: https://gpsd.io

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

حق نشر این فایل متعلق به پروژه GPSD در سال ۲۰۱۳ است (Copyright 2013 by the GPSD project)
SPDX-License-Identifier: BSD-2-clause

نویسندگان (AUTHORS)

Gary E. Miller