'\" t
.\"     Title: gpsctl
.\"    Author: Eric S. Raymond
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: English
.\"
.TH "GPSCTL" "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)"
gpsctl \- کنترل حالت‌های یک گیرنده GNSS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBgpsctl\fP [OPTIONS] [serial\-port]
.sp
\fBgpsctl\fP \-h
.sp
\fBgpsctl\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgpsctl\fP می‌تواند یک گیرنده GNSS دوحالته را بین حالت‌های NMEA و دودوییِ سازنده (vendor\-binary) تغییر دهد. همچنین می‌تواند برای تنظیم نرخ باود (baud rate) دستگاه استفاده شود. نکته: همه دستگاه‌ها این قابلیت‌ها را ندارند.
.sp
اگر تنها یک گیرنده GNSS به رایانه شما متصل باشد و \fBgpsd\fP در حال اجرا باشد، نیازی به مشخص کردن دستگاه نیست؛ \fBgpsctl\fP کار خود را از طریق \fBgpsd\fP انجام می‌دهد و آن سرویس دستگاه را برای شما پیدا خواهد کرد.
.sp
هنگامی که \fBgpsd\fP در حال اجرا است، \fBgpsctl\fP می‌تواند توسط هر کاربری یا به عنوان ریشه (root) اجرا شود.
.sp
هنگامی که \fBgpsd\fP در حال اجرا نیست، مشخص کردن دستگاه الزامی است و برای داشتن دسترسی نوشتن به دستگاه، باید با دسترسی ریشه (root) اجرا شوید یا عضوی از گروه مالک دستگاه باشید. در بسیاری از مشتقات یونیکس، گروه مالک با نام \*(Aqdialout\*(Aq شناخته می‌شود.
.sp
اجرا تحت \fBsudo\fP باعث از دست رفتن برخی از قابلیت‌ها خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.sp
این برنامه گزینه‌های زیر را می‌پذیرد:
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش نحوه استفاده از برنامه و خروج.
.RE
.sp
\fB\-b\fP, \fB\-\-binary\fP
.RS 4
قرار دادن گیرنده GNSS در حالت بومی (دودویی یا binary).
.RE
.sp
\fB\-c RATE\fP, \fB\-\-rate RATE\fP
.RS 4
تغییر زمان چرخه (cycle time) گیرنده‌ها. واحد آن ثانیه است. توجه داشته باشید که بیشتر گیرنده‌ها زمان چرخه ثابت ۱ ثانیه دارند.
.RE
.sp
\fB\-D LVL\fP, \fB\-\-debug LVL\fP
.RS 4
تنظیم سطح پیام‌های اشکال‌زدایی (debug).
.RE
.sp
\fB\-e\fP, \fB\-\-echo\fP
.RS 4
تولید بسته از روی سایر آرگومان‌های مشخص‌شده و ارسال آن به خروجی استاندارد به جای دستگاه. این سوئیچ می‌تواند همراه با گزینه \fB\-t\fP بدون مشخص کردن دستگاه استفاده شود. نکته: داده‌های بسته برای یک پیش‌نمونه دودویی به صورت خام خواهد بود و به هیچ وجه به ASCII تبدیل نمی‌شود.
.RE
.sp
\fB\-f\fP, \fB\-\-force\fP
.RS 4
اجبار دسترسی سطح پایین و مستقیم (نه از طریق دیمن).
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
نمایش جدولی که مشخص می‌کند کدام سوئیچ‌های گزینه‌ها می‌توانند روی کدام انواع دستگاه‌ها اعمال شوند، و سپس خروج.
.RE
.sp
\fB\-n\fP, \fB\-\-nmea\fP
.RS 4
قرار دادن گیرنده GNSS در حالت NMEA.
.RE
.sp
\fB\-r\fP, \fB\-\-reset\fP
.RS 4
راه‌اندازی مجدد (ریست) گیرنده GNSS. درگاه و نوع دستگاه باید مشخص شوند.
.RE
.sp
\fB\-R\fP, \fB\-\-rmshm\fP
.RS 4
حذف بخش حافظه اشتراکی GPSD که برای صدور SHM استفاده می‌شود. این گزینه معمولاً فقط برای توسعه‌دهندگان GPSD کاربرد دارد.
.RE
.sp
\fB\-s SPEED\fP, \fB\-\-speed SPEED\fP
.RS 4
تنظیم نرخ باود (baud rate) که گیرنده با آن بسته‌ها را ارسال می‌کند.
.RE
.sp
از گزینه \fB\-s\fP با احتیاط استفاده کنید. در GPSهای USB و Bluetooth نیز ممکن است تنظیم حالت سریال با شکست مواجه شود؛ چه به این دلیل که تراشه مبدل سریال از حالت‌های غیر 8N1 پشتیبانی نمی‌کند، یا به این دلیل که سفت‌افزار دستگاه هنگام تغییر سرعت، تراشه مبدل سریال را به درستی با UART روی چیپ‌ست GPS همگام نمی‌سازد. این خرابی‌ها می‌توانند باعث هنگ کردن دستگاه شما شوند و احتمالاً نیاز به قطع و وصل تغذیه GPS یا (در موارد حاد) جدا کردن فیزیکی باتری پشتیبان NVRAM داشته باشند.
.sp
\fB\-t TYPE\fP, \fB\-\-type TYPE\fP
.RS 4
تحمیل نوع دستگاه.
.RE
.sp
\fB\-T TIMEOUT\fP, \fB\-\-timeout TIMEOUT\fP
.RS 4
تغییر زمان‌انتظار (timeout) نمونه‌برداری. مقدار پیش‌فرض ۸ ثانیه است که باید همیشه برای دریافت بسته شناسایی از دستگاهی که با نرخ معمول ۱ بار در ثانیه ارسال می‌کند، کافی باشد.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه برنامه و خروج.
.RE
.sp
\fB\-x STR\fP, \fB\-\-ship STR\fP
.RS 4
ارسال رشته کنترلی مشخص‌شده به گیرنده GNSS. نویسه‌های گریز اسلش وارونه به سبک C در رشته رمزگشایی می‌شوند. از \(rsxNN برای هگزادسیمال استفاده کنید، \(rse با ESC جایگزین خواهد شد.
.sp
.if n .RS 4
.nf
.fam C
In normal mode, through _gpsd_, the decoded string is passed through,
unchanged top _gpsd_ which in turns sends it to the receiver.\&  Headers,
checksums, and suffffices must be provided.
.fam
.fi
.if n .RE
.sp
.if n .RS 4
.nf
.fam C
In low\-level, (direct) mode *gpsctl* will provide packet headers and
trailers and checksum as appropriate for binary packet types, and
whatever checksum and trailer is required for text packet types.
.fam
.fi
.if n .RE
.sp
.if n .RS 4
.nf
.fam C
You must include the leading $ for NMEA packets.
.fam
.fi
.if n .RE
.sp
.if n .RS 4
.nf
.fam C
When sending to a UBX, Allystar or CASIC device, the first two bytes
of the string supplied will become the message class and type, and the
remainder the payload.
.fam
.fi
.if n .RE
.sp
.if n .RS 4
.nf
.fam C
When sending to a Navcom NCT or Trimble TSIP device, the first byte is
interpreted as the command ID and the rest as payload.
.fam
.fi
.if n .RE
.sp
.if n .RS 4
.nf
.fam C
When sending to a Zodiac device, the first two bytes are used as a
message ID of type little\-endian short, and the remainder as payload
in byte pairs interpreted as little\-endian short.
.fam
.fi
.if n .RE
.sp
.if n .RS 4
.nf
.fam C
For all other supported binary GPSes (notably including SiRF) the
string is taken as the entire message payload and wrapped with
appropriate header, trailer and checksum bytes.
.fam
.fi
.if n .RE
.RE
.sp
آرگومان گزینه تحمیل، \fB\-t\fP، باید رشته‌ای باشد که دقیقاً در یکی از نام‌های درایورهای شناخته‌شده موجود باشد؛ برای دیدن فهرست، دستور \fBgpsctl \-l\fP را اجرا کنید.
.sp
تحمیل نوع دستگاه بسته به اینکه این ابزار از طریق دیمن عمل می‌کند یا خیر، رفتاری تا حدی متفاوت دارد. در حالت سطح بالا، اگر دستگاهی که دیمن برای شما انتخاب می‌کند با درایوری که مشخص کرده‌اید مطابقت نداشته باشد، \fBgpsctl\fP با یک هشدار خارج می‌شود. (این امر ممکن است در اسکریپت‌ها مفید باشد.)
.sp
در حالت سطح پایین، اگر دستگاه به عنوان Generic NMEA شناسایی شود، درایور انتخاب‌شده به جای آن استفاده می‌شود. این قابلیت زمانی مفید خواهد بود که یک دستگاه GPS با نوع مشخص دارید که در حالت NMEA قرار دارد و به کاوش‌ها (probes) پاسخ نمی‌دهد. (این گزینه در ابتدا برای ارتباط با تراشه‌های SiRFStar I پیاده‌سازی شده بود که به کاوش شناسه معمول SiRF پاسخ نمی‌دهند.)
.sp
اگر هیچ گزینه‌ای داده نشود، برنامه پیامی مبنی بر شناسایی نوع GPS دستگاه انتخاب‌شده را نمایش داده و خارج می‌شود.
.sp
عملیات راه‌اندازی مجدد (\fB\-r\fP) باید به صورت مستقل اجرا شود؛ سایر گزینه‌ها می‌توانند با یکدیگر ترکیب شوند.
دستور gpsctl چندین گزینه را به این ترتیب اجرا خواهد کرد: ابتدا تغییر حالت (\-b یا \-n)، سپس تغییر سرعت (\-s)، سوم نرخ چرخه (\-c) و در آخر رشته‌های کنترلی (\-x).
.SH "محیط (ENVIRONMENT)"
.sp
با تنظیم متغیر محیطی \fBGPSD_SHM_KEY\fP، می‌توانید مقدار کلیدی را که برای تعیین بخش حافظه اشتراکیِ حذف‌شده با گزینه \-R استفاده می‌شود، کنترل کنید. این ویژگی عمدتاً هنگام جداسازی نمونه‌های آزمایشی \fBgpsd\fP از نمونه‌های عملیاتی کاربرد خواهد داشت.
.SH "مثال‌ها (EXAMPLES)"
.sp
\fBgpsctl /dev/ttyUSB0\fP
.RS 4
تلاش برای شناسایی دستگاه روی درگاه سریال یواس‌بی 0 (USB serial device 0). پس از مدت‌زمان پیش‌فرض منقضی می‌شود. افزودن \fB\-f\fP دسترسی سطح پایین را تحمیل کرده و از پیام خطای معمول در زمانی که این ابزار نمی‌تواند یک GPSD را برای کار پیدا کند، جلوگیری می‌کند.
.RE
.sp
\fBgpsctl \-f \-n \-s 9600 /dev/ttyUSB0\fP
.RS 4
استفاده از عملیات سطح پایین (بدون عبور از یک نمونه \fBgpsd\fP) برای بردن یک GPS به حالت NMEA در سرعت 9600bps. این ابزار نوع GPS را خودش شناسایی خواهد کرد.
.RE
.sp
\fBgpsctl \-x \*(Aq\(rsxb5\(rsx62\(rsx0a\(rsx04\(rsx00\(rsx00\(rsx0e\(rsx34\*(Aq\fP
.RS 4
ارسال یک درخواست برای UBX\-MON\-VER به یک گیرنده GNSS متصل به \fIgpsd\fP.
.RE
.SH "گزارش باگ‌ها (BUGS)"
.sp
دستگاه‌های SiRF GPS تنها از طریق موفقیت‌آمیز بودن تلاش برای تغییر حالت آن‌ها به حالت دودویی SiRF قابل شناسایی هستند. بنابراین، فرآیند کاوش یکی از این دستگاه‌ها که در حالت NMEA کار می‌کند، رفتار آن را تغییر خواهد داد.
.sp
تغییر نرخ باود و حالت کاری در حالت مستقیم عمل می‌کند، اما در حالت کلاینت قابل اطمینان نیست. این مورد در نگارش‌های آینده اصلاح خواهد شد.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgpsd\fP(8), \fBgpsdctl\fP(1), \fBgps\fP(1), \fBubxtool\fP(1), \fBzerk\fP(1)
.SH "منابع (RESOURCES)"
.sp
\fBتارنمای پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
This file is Copyright by the GPSD project
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسندگان (AUTHORS)"
.sp
Eric S. Raymond