'\" t
.\"     Title: zerk
.\"    Author: Gary E. Miller
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: English
.\"
.TH "ZERK" "1" "2025-11-04" "GPSD, Version 3.27.5" "GPSD Documentation"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
zerk \- ابزار همه‌منظوره پیکربندی و اتصال GREIS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBzerk\fP [OPTIONS] [server[:port[:device]]]
.sp
\fBzerk\fP \-h
.sp
\fBzerk\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار
\fBzerk\fP
یک اتصال‌دهنده و ابزار همه‌منظوره GREIS (مشخصات رابط خارجی گیرنده ناوبری ماهواره‌ای \- GNSS Receiver External Interface Specification) است. اگر دستگاه GPS ساخت Javad که از پروتکل GREIS پشتیبانی کند ندارید، نیازی به مطالعه ادامه این راهنما نیست.
.sp
این ابزار در سطحی بسیار پایین با GPS جاواد شما ارتباط برقرار می‌کند. برای درک عملکرد
\fBzerk\fP
باید از پیش با GPS جاواد خود و مستندات پروتکل GREIS آشنایی داشته باشید.
.URL "https://www.javad.com/downloads/javadgnss/manuals/GREIS/GREIS_Reference_Guide.pdf" "GREIS Guide" "."
.sp
برنامه
\fBzerk\fP
می‌تواند پیام‌های رایج GREIS را رمزگشایی کند، وضعیت GPS را استعلام نماید، قابلیت‌های GPS را فعال یا غیرفعال کند، و دستورات سفارشی کاربر را به GPS ارسال نماید. این ابزار قادر است پیام‌های GREIS را از یک فایل بخواند، و همچنین می‌تواند به طور مستقیم از طریق یک پورت سریال یا از طریق یک نمونه در حال اجرای
\fBgpsd\fP
به تبادل اطلاعات (خواندن و نوشتن) بپردازد.
.sp
برنامه
\fBzerk\fP
نیازی به دسترسی‌های ریشه (root) ندارد، مگر احتمالاً برای دسترسی مستقیم به درگاه سریال. این ابزار با دسترسی کاربر ریشه نیز به خوبی اجرا می‌شود، اما اجرای آن با sudo ممکن است باعث از دست رفتن برخی عملکردهای آن شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
این برنامه گزینه‌های زیر را می‌پذیرد:
.sp
\fB\-?\fP, \fB\-h\fP
.RS 4
چاپ پیام نحوه استفاده از
\fBzerk\fP
و خروج از برنامه.
.RE
.sp
\fB\-c COMMAND\fP
.RS 4
ارسال یک رشته متنی به GPS. یک پارامتر COMMAND (رشته دستوری که باید به GPS ارسال شود) می‌پذیرد. رشته ارسالی دقیقاً و عینا فرستاده می‌شود، با این تفاوت که یک خط جدید به انتهای آن افزوده خواهد شد.
.RE
.sp
\fB\-d OPTION\fP
.RS 4
غیرفعال کردن یک قابلیت در GPS. یک پارامتر OPTION (گزینه‌ای که باید غیرفعال شود) می‌پذیرد.
\fBzerk\fP
پس از تایید دستور توسط GPS خارج می‌شود، مگر اینکه گزینه
\fB\-W\fP
مشخص شده باشد.
.sp
4HZ
.RS 4
غیرفعال‌سازی پیام‌های پایه GREIS در نرخ 4Hz. این پیام‌ها عبارتند از:
[RT]، [UO]، [GT]، [PV]، [SG]، [DP]، [SI]، [EL]، [AZ]، [EC]، [SS]، و [ET]
.RE
.sp
COMPASS
.RS 4
غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای COMPASS (BeiDou).
.RE
.sp
CONS
.RS 4
غیرفعال‌سازی استفاده از تمام صورت‌های فلکی ماهواره‌ای.
.RE
.sp
DEFMSG
.RS 4
غیرفعال‌سازی مجموعه پیام‌های پیش‌فرض (/dev/msg) در نرخ 1Hz.
.RE
.sp
GALILEO
.RS 4
غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای GALILEO.
.RE
.sp
GLONASS
.RS 4
غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای GLONASS.
.RE
.sp
GPS
.RS 4
غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای GPS.
.RE
.sp
IPR
.RS 4
غیرفعال‌سازی تمام پیام‌های فواصل شبه‌تصادفی صحیح (Integer Pseudo Range). این پیام‌ها شامل موارد زیر هستند:
[rx]، [rc]، [r1]، [r2]، [r3]، [r5]، [rl].
.RE
.sp
IRNSS
.RS 4
غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای IRNSS.
.RE
.sp
NMEA
.RS 4
غیرفعال‌سازی پیام‌های پایه NMEA 4.1e در نرخ 4Hz. این پیام‌ها شامل GBS، GGA، GSA، GST، GSV، RMC، VTG، و ZDA هستند.
.RE
.sp
QZSS
.RS 4
غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای QZSS.
.RE
.sp
SBAS
.RS 4
غیرفعال‌سازی استفاده از صورت فلکی ماهواره‌ای SBAS.
.RE
.sp
SNR
.RS 4
غیرفعال‌سازی تمام پیام‌های نسبت سیگنال به نویز (SNR)، به استثنای [EC]. پیام‌های غیرفعال‌شده شامل موارد زیر هستند:
[E1]، [E2]، [E3]، [E5]، [El].
.RE
.RE
.sp
\fB\-e OPTION\fP
.RS 4
فعال کردن یک قابلیت در GPS. یک پارامتر OPTION (گزینه‌ای که باید فعال شود) می‌پذیرد.
\fBzerk\fP
پس از تایید دستور توسط GPS خارج می‌شود، مگر اینکه گزینه
\fB\-W\fP
مشخص شده باشد. گزینه
\fB\-e\fP
همان شناسه‌های OPTION موجود در گزینه
\fB\-d\fP
را می‌پذیرد، با این تفاوت که به جای غیرفعال‌سازی، آن‌ها را فعال می‌کند.
.RE
.sp
\fB\-f FILE\fP
.RS 4
اتصال به یک فایل یا دستگاه. یک پارامتر FILE (فایل یا دستگاهی که باید باز شود) می‌پذیرد. فایل‌ها به صورت فقط‌خواندنی باز می‌شوند. دستگاه‌های نویسه‌ای به صورت خواندن/نوشتن باز می‌شوند، مگر اینکه گزینه \-r تعیین شده باشد. استفاده از این گزینه مستلزم نصب ماژول pyserial است.
.RE
.sp
\fB\-O OAF\fP
.RS 4
بارگذاری یک فایل مجوز گزینه‌ها (OAF یا Option Authorization File) در GPS. یک پارامتر OAF (فایل دستوراتی که باید خوانده شود) می‌پذیرد. فایل OAF نوع خاصی از فایل‌های \*(Aq.jpo\*(Aq (فایل دستورات GREIS) است. گزینه \-O هر فایل معتبر .jpo را به GPS ارسال می‌کند.
.RE
.sp
\fB\-p PRESET\fP
.RS 4
ارسال یک دستور از پیش تنظیم‌شده به GPS. یک پارامتر PRESET (نام دستور ارسالی) می‌پذیرد.
\fBzerk\fP
پس از تایید دستور توسط GPS خارج می‌شود، مگر اینکه گزینه
\fB\-W\fP
مشخص شده باشد.
.sp
COLDBOOT
.RS 4
راه‌اندازی سرد (Coldboot) دستگاه GPS.
.RE
.sp
CONS
.RS 4
استعلام صورت‌های فلکی ماهواره‌ای فعال‌شده.
.RE
.sp
DM
.RS 4
غیرفعال کردن تمام پیام‌های متناوب و دوره‌ای GREIS.
.RE
.sp
ID
.RS 4
استعلام شناسه (ID) گیرنده.
.RE
.sp
IPR
.RS 4
استعلام تمام پیام‌های فواصل شبه‌تصادفی صحیح. این پیام‌ها شامل موارد زیر هستند:
[rx]، [rc]، [r1]، [r2]، [r3]، [r5]، [rl].
.RE
.sp
OAF
.RS 4
استعلام تمام گزینه‌های مجوز OAF.
.RE
.sp
RESET
.RS 4
راه‌اندازی مجدد (Reboot) دستگاه GPS.
.RE
.sp
SERIAL
.RS 4
استعلام شماره سریال گیرنده.
.RE
.sp
SNR
.RS 4
استعلام تمام پیام‌های نسبت سیگنال به نویز (SNR):
[EC]، [E1]، [E2]، [E3]، [E5]، [El].
.RE
.sp
VENDOR
.RS 4
استعلام سازنده دستگاه GPS.
.RE
.sp
VER
.RS 4
استعلام نسخه نرم‌افزاری GPS.
.RE
.RE
.sp
\fB\-r\fP
.RS 4
فقط‌خواندنی. هیچ داده‌ای به GPS ارسال نمی‌کند.
.RE
.sp
\fB\-R RAW\fP
.RS 4
ذخیره تمام داده‌های خام دریافتی از GPS درون فایل RAW.
.RE
.sp
\fB\-S SPEED\fP
.RS 4
پیکربندی سرعت پورت سریال GPS روی SPEED بیت بر ثانیه (bps).
.RE
.sp
\fB\-s SPEED\fP
.RS 4
تنظیم سرعت پورت سریال محلی روی SPEED بیت بر ثانیه (bps). مقدار پیش‌فرض 115,200 است.
.RE
.sp
\fB\-V\fP
.RS 4
چاپ نسخه
\fBzerk\fP
و خروج از برنامه.
.RE
.sp
\fB\-v VERBOSITY\fP
.RS 4
تنظیم سطح پرگویی و جزئیات خروجی روی VERBOSITY. مقدار جزئیات می‌تواند از 0 (بسیار کم و بدون جزئیات) تا 4 (بسیار پرجزئیات) باشد. مقدار پیش‌فرض 2 است.
.RE
.sp
\fB\-W\fP
.RS 4
اجبار به منتظر ماندن در تمام طول زمان تعیین‌شده. بدون خروج زودهنگام پس از اتمام دستورات
\fB\-d\fP، \fB\-e\fP
یا
\fB\-p\fP.
.RE
.sp
\fB\-w WAIT\fP
.RS 4
انتظار به مدت WAIT ثانیه پیش از خروج. در صورت اتمام دستورات
\fB\-d\fP، \fB\-e\fP
یا
\fB\-p\fP
برنامه زودتر خارج خواهد شد، مگر اینکه گزینه
\fB\-W\fP
داده شده باشد. مقدار پیش‌فرض 2.0 ثانیه است.
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
به طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی
\fBgpsd\fP
در حال اجرا روی localhost با استفاده از پورت پیش‌فرض GPSD یعنی 2947 جمع‌آوری می‌کنند. آرگومان اختیاری برای هر کلاینت می‌تواند این رفتار را بازتعریف کند:
\fB[server[:port[:device]]]\fP
.sp
برای توضیحات و مثال‌های بیشتر، بخش
\fBARGUMENTS\fP
را در صفحه راهنمای
\fBgps\fP(1)
ببینید.
.SH "محیط (ENVIRONMENT)"
.sp
گزینه‌ها را می‌توان در متغیر محیطی ZERKOPTS قرار داد. این متغیر محیطی پیش از گزینه‌های خط فرمان پردازش می‌شود.
.SH "مثال‌ها (EXAMPLES)"
.sp
چاپ پورت سریال فعلی دستگاه GPS متصل به
\fBgpsd\fP
محلی در حال اجرا:
.sp
.if n .RS 4
.nf
.fam C
 zerk \-c "print,/cur/term"
.fam
.fi
.if n .RE
.sp
رمزگشایی یک فایل لاگ خام:
.sp
.if n .RS 4
.nf
.fam C
zerk \-r \-f greis\-binary.log \-v 2
.fam
.fi
.if n .RE
.sp
تغییر سرعت پورت GPS دستگاه روی /dev/ttyAMA0 به 230,400 بیت بر ثانیه:
.sp
.if n .RS 4
.nf
.fam C
zerk \-S 230400 \-f /dev/ttyAMA0
.fam
.fi
.if n .RE
.sp
مشاهده کامل چرخه راه‌اندازی مجدد (Reset) دستگاه GPS:
.sp
.if n .RS 4
.nf
.fam C
zerk \-p RESET \-v 2 \-w 20 \-W
.fam
.fi
.if n .RE
.sp
استعلام وضعیت ماهواره‌ها (SVs):
.sp
.if n .RS 4
.nf
.fam C
zerk \-W \-w 2 \-v 2 \-c "out,,jps/{CS,ES,GS,Is,WS,QS}"
.fam
.fi
.if n .RE
.sp
استخراج داده‌های
\fBgpsd\fP
از یک سرور راه دور:
.sp
.if n .RS 4
.nf
.fam C
zerk \-v 2 \-w 5 server
.fam
.fi
.if n .RE
.SH "کدهای خروج (RETURN VALUES)"
.sp
\fB0\fP
.RS 4
در صورت اجرای موفقیت‌آمیز.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
برنامه
\fBzerk\fP
به گونه‌ای نوشته شده است که با مستندات رسمی Javad برای پروتکل GREIS مطابقت داشته باشد.
.URL "https://www.javad.com/downloads/javadgnss/manuals/GREIS/GREIS_Reference_Guide.pdf" "GREIS Guide" "."
.sp
\fBgpsd\fP(8)
.SH "منابع (RESOURCES)"
.sp
\fBوبگاه پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق نشر این فایل متعلق به پروژه GPSD در سال ۲۰۱۳ است (Copyright 2013 by the GPSD project)
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسندگان (AUTHORS)"
.sp
Gary E. Miller