ZERK(1) GPSD Documentation ZERK(1) نام (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 . برنامه 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 . gpsd(8) منابع (RESOURCES) وبگاه پروژه: کپی‌رایت و تکثیر (COPYING) حق نشر این فایل متعلق به پروژه GPSD در سال ۲۰۱۳ است (Copyright 2013 by the GPSD project) SPDX-License-Identifier: BSD-2-clause نویسندگان (AUTHORS) Gary E. Miller GPSD, Version 3.27.5 2025-11-04 ZERK(1)