.\"                                      Hey, EMACS: -*- nroff -*-
.\"
.\" For layout and available macros, see man(7), man-pages(7), groff_man(7)
.\" Please adjust the date whenever revising the manpage.
.\"
.\" Note: Please keep this page in sync with the source, rigctlsync.c
.\"
.TH RIGCTLSYNC "1" "2023-01-27" "Hamlib" "Hamlib Utilities"
.
.
.SH "نام (NAME)"
.
rigctlsync \- همگام‌سازی یک رادیو با SDR# (یا رادیوی دیگر)
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.
.SY rigctlsync
.OP \-hlLuV
.OP \-m id
.OP \-r device
.OP \-R device
.OP \-s baud
.OP \-S baud
.OP \-c id
.OP \-C parm=val
.OP \-B
.RB [ \-v [ \-Z ]]
.YS
.
.SH "توضیحات (DESCRIPTION)"
امکان همگام‌سازی فرکانس از یک رادیو به SDR# را فراهم می‌کند.
بهترین عملکرد زمانی حاصل می‌شود که به همراه rigctld، FlRig یا یک رادیوی چنددرگاهی استفاده شود.
.
.PP
لطفاً گزارش باگ‌ها و بازخوردهای خود را به نشانی رایانامه ارائه‌شده در بخش
.B "گزارش باگ‌ها (BUGS)"
در زیر ارسال کنید. وصله‌ها و بهبودهای کد ارسالی به همین نشانی مورد استقبال قرار می‌گیرند.
.
.
.SH "گزینه‌ها (OPTIONS)"
.
این برنامه از نحو معمول خط فرمان GNU پیروی می‌کند. در گزینه‌های کوتاهی که
آرگومان دریافت می‌کنند، مقدار می‌تواند بلافاصله پس از گزینه بیاید یا با یک
فاصله جدا شود. در گزینه‌های بلندی که با دو خط تیره (\(oq\-\(cq) آغاز می‌شوند،
وجود یک علامت \(oq=\(cq میان گزینه و آرگومان الزامی است.
.
.PP
در اینجا خلاصه‌ای از گزینه‌های پشتیبانی‌شده آمده است:
.
.TP
.BR \-m ", " \-\-model = \fIid\fP
انتخاب شماره مدل رادیو.
.IP
فهرست مدل‌ها را ببینید (از \(lqrigctlsync -l\(rq استفاده کنید).
.IP
.BR نکته :
برنامه
.B rigctlsync
(یا نرم‌افزارهای شخص ثالثی که از C API استفاده می‌کنند) از مدل رادیویی ۲ برای
.B NET rigctl
(جهت ارتباط با
.BR rigctld )
استفاده خواهد کرد.
.
.TP
.BR \-r ", " \-\-rig\-file = \fIdevice\fP
استفاده از
.I device
به‌عنوان نام فایل درگاه متصل به رادیو.
.IP
معمولاً یک درگاه سریال است، اما می‌تواند مبدل USB به سریال نیز باشد. به‌طور معمول در لینوکس
.IR /dev/ttyS0 "، " /dev/ttyS1 "، " /dev/ttyUSB0
و غیره، و در MS Windows به‌صورت
.IR COM1 "، " COM2
و غیره است. سیستم‌های خانواده BSD و Mac OS/X نام‌گذاری‌های ویژه خود را دارند.
مستندات سیستم خود را ببینید.
.IP
رشته ویژه \(lquh\-rig\(rq می‌تواند برای فعال‌سازی پشتیبانی از دستگاه micro-ham مشخص شود.
.
.TP
.BR \-R ", " \-\-rig\-file2 = \fIdevice\fP
استفاده از
.I device
به‌عنوان نام فایل یکی از درگاه‌های com مجازی -- برنامه شما به درگاه com دیگر از جفت مجازی متصل خواهد شد.
.
.TP
.BR \-s ", " \-\-serial\-speed = \fIbaud\fP
تنظیم سرعت سریال روی نرخ
.IR baud .
.IP
به‌طور پیش‌فرض از حداکثر سرعت سریال موجود در قابلیت‌های پسانه (backend) رادیو (تعیین‌شده توسط
.B \-m
در بالا) استفاده می‌کند.
.
.TP
.BR \-S ", " \-\-serial\-speed2 = \fIbaud\fP
تنظیم سرعت سریال روی نرخ
.I baud
برای درگاه com مجازی (گزینه
.B \-R
را ببینید).
.
.IP
به‌طور پیش‌فرض از حداکثر سرعت سریال موجود در قابلیت‌های پسانه رادیو (تعیین‌شده توسط
.B \-m
در بالا) استفاده می‌کند.
.
.TP
.BR \-c ", " \-\-civaddr = \fIid\fP
استفاده از
.I id
به‌عنوان آدرس CI-V برای ارتباط با رادیو.
.IP
تنها برای رادیوهای Icom و برخی از رادیوهای Ten-Tec کاربرد دارد.
.IP
.BR نکته :
مقدار
.I id
در مبنای ده است، مگر اینکه پیشوند
.I 0x
داشته باشد که در این صورت در مبنای شانزده (هگزادسیمال) خواهد بود.
.
.TP
.BR \-L ", " \-\-show\-conf
فهرست کردن تمام پارامترهای پیکربندی برای رادیوی تعریف‌شده با گزینه
.B \-m
در بالا.
.
.TP
.BR \-C ", " \-\-set\-conf = \fIparm=val\fP [ \fI,parm=val\fP ]
تنظیم پارامتر(های) پیکربندی رادیو، مانند
.IR stop_bits=2 .
.IP
برای مشاهده فهرست پارامترهای پیکربندی یک شماره مدل مشخص، از گزینه
.B \-L
در بالا استفاده کنید.
.
.TP
.BR \-u ", " \-\-dump\-caps
تخلیه قابلیت‌های رادیوی تعریف‌شده با گزینه
.B \-m
در بالا و خروج.
.
.TP
.BR \-l ", " \-\-list
فهرست کردن تمام شماره مدل‌های تعریف‌شده در
.B Hamlib
و خروج.
.IP
فهرست بر اساس شماره مدل مرتب شده است.
.IP
.BR نکته :
در لینوکس می‌توان با استفاده از کلیدهای
.BR Shift-PageUp / Shift-PageDown
یا با استفاده از نوارهای پیمایش یک ترمینال مجازی در X یا پنجره cmd در ویندوز، فهرست را به عقب پیمایش کرد. خروجی را می‌توان به
.BR more (1)
یا
.BR less (1)
هدایت (pipe) کرد، مانند \(lqrigctl -l | more\(rq.
.
.TP
.BR \-n ", " \-\-no\-restore\-ai
برنامه
.B rigctl
وضعیت اطلاعات خودکار (AI) را در رادیوی کنترل‌شده بازیابی می‌کند.
.IP
اگر این رفتار مطلوب نیست، برای نمونه زمانی که از
.B rigctl
برای روشن یا خاموش کردن حالت AI استفاده می‌کنید، این گزینه را مشخص کنید.
.
.TP
.BR \-B ", " \-\-mapa2b
نگاشت set_freq روی VFOA به جای آن بر روی VFOB.
این قابلیت امکان استفاده از CW skimmer همراه با رادیو در حالت split را فراهم می‌کند و کلیک روی یک فرکانس در CW skimmer،
مقدار VFOB را روی فرکانس ارسال تنظیم خواهد کرد.
.
.TP
.BR \-v ", " \-\-verbose
تنظیم حالت پرگویی (verbose)، انباشته‌شونده (بخش
.B "خطاها (DIAGNOSTICS)"
در زیر را ببینید).
..TP
.BR \-Z ", " \-\-debug\-time\-stamps
فعال‌سازی برچسب‌های زمانی برای پیام‌های اشکال‌زدایی.
.IP
تنها در ترکیب با گزینهٔ
.B -v
استفاده شود، چرا که به خودی خود هیچ خروجی‌ای تولید نمی‌کند.
.
.TP
.BR \-h ", " \-\-help
نمایش خلاصه‌ای از این گزینه‌ها و خروج.
.
.TP
.BR \-V ", " \-\-version
نمایش نسخهٔ
.B rigctl
و خروج.
.
.PP
.BR نکته :
ممکن است برخی گزینه‌ها توسط یک بک‌اند خاص پیاده‌سازی نشده باشند و خطایی را برگردانند. این حالت به احتمال زیاد با گزینه‌های
.B \-\-set\-conf
و
.B \-\-show\-conf
رخ می‌دهد.
.
.
.SH "خطاها (DIAGNOSTICS)"
.
گزینهٔ
.BR \-v ،
.B \-\-verbose
امکان می‌دهد سطوح مختلفی از عیب‌یابی در
.B stderr
خروجی داده شوند که متناظر است با \-v برای
.BR BUG ،
\-vv برای
.BR ERR ،
\-vvv برای
.BR WARN ،
\-vvvv برای
.BR VERBOSE ،
یا \-vvvvv برای
.BR TRACE .
.
.PP
یک سطح پرگویی مشخص، برای ارائهٔ اطلاعات اشکال‌زدایی لازم به نشانی ایمیل زیر مفید است. برای نمونه، خروجی TRACE تمام مقادیر ارسال‌شده به رادیو و دریافت‌شده از آن را نشان می‌دهد که برای توسعهٔ کتابخانهٔ بک‌اند رادیو بسیار مفید است و ممکن است توسط توسعه‌دهندگان درخواست شود.
.
.
.SH "وضعیت خروج (EXIT STATUS)"
.B rigctlsync
با این وضعیت‌ها خارج می‌شود:
.
.TP
.B 0
اگر تمام عملیات‌ها به‌طور عادی کامل شوند؛
.
.TP
.B 1
اگر گزینه یا آرگومان خط فرمان نامعتبری وجود داشته باشد؛
.
.TP
.B 2
اگر خطایی از طرف
.BR Hamlib
بازگردانده شود.
.
.
.SH "مثال‌ها (EXAMPLES)"
.
راه‌اندازی
.B rigctlsync
با FLRig به‌عنوان مدل Hamlib
.UE .
.
.PP
.in +4n
.EX
.RB $ " rigctlsync -m 4 -M 9 -R 192.168.1.1:4532"
.EE
.in
.
.PP
نمودار زیر جریان ارتباطی را نشان می‌دهد که به N1MM Logger+ امکان می‌دهد با یک رادیوی متصل به Flrig ارتباط برقرار کند:
.
.PP
.in +4n
.EX
Flrig -><- rigctlcom -> COM9 <- virt_port_pipe -> COM10 <- N1MM
.EE
.in
.
..SH "گزارش باگ‌ها (BUGS)"
.
.PP
گزارش باگ‌ها به:
.IP
.nf
.MT hamlib\-developer@lists.sourceforge.net
فهرست پستی توسعه‌دهندگان Hamlib
.ME
.fi
.
.
.SH "کپی‌رایت و تکثیر (COPYING)"
.
این فایل بخشی از Hamlib است؛ پروژه‌ای برای توسعهٔ کتابخانه‌ای که توابع
کنترلی رادیو، چرخاننده و تقویت‌کننده را برای توسعه‌دهندگان نرم‌افزارهایی
که اساساً مورد توجه رادیوآماتورها و علاقه‌مندان به ارتباطات رادیویی
هستند، ساده می‌کند.
.
.PP
کپی‌رایت \(co 2000-2011 Stephane Fillod
.br
کپی‌رایت \(co 2000-2018 گروه Hamlib (مشارکت‌کنندگان گوناگون)
.br
کپی‌رایت \(co 2010-2020 Nate Bargmann
.br
کپی‌رایت \(co 2019 Michael Black W9MDB
.
.PP
این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر، فایل COPYING را ببینید. هیچ
ضمانتی وجود ندارد؛ حتی برای قابل فروش بودن یا تناسب با یک هدف خاص.
.
.
.SH "همچنین ببینید (SEE ALSO)"
.
.BR rigctld (1),
.BR rigctl (1),
.BR socat (1),
.BR hamlib (7)
.
.
.SH "اطلاعات تکمیلی (COLOPHON)"
.
پیوندهای مربوط به ویکی Hamlib، مخزن Git، بایگانی‌های انتشار و بایگانی رونوشت‌های روزانه از طریق
.
.UR http://www.hamlib.org
hamlib.org
.UE
در دسترس است.