نام (NAME)

rigctlsync - همگام‌سازی یک رادیو با SDR# (یا رادیوی دیگر)

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

توضیحات (DESCRIPTION)

امکان همگام‌سازی فرکانس از یک رادیو به SDR# را فراهم می‌کند. بهترین عملکرد زمانی حاصل می‌شود که به همراه rigctld، FlRig یا یک رادیوی چنددرگاهی استفاده شود.

لطفاً گزارش باگ‌ها و بازخوردهای خود را به نشانی رایانامه ارائه‌شده در بخش گزارش باگ‌ها (BUGS) در زیر ارسال کنید. وصله‌ها و بهبودهای کد ارسالی به همین نشانی مورد استقبال قرار می‌گیرند.

گزینه‌ها (OPTIONS)

این برنامه از نحو معمول خط فرمان GNU پیروی می‌کند. در گزینه‌های کوتاهی که آرگومان دریافت می‌کنند، مقدار می‌تواند بلافاصله پس از گزینه بیاید یا با یک فاصله جدا شود. در گزینه‌های بلندی که با دو خط تیره (‘-’) آغاز می‌شوند، وجود یک علامت ‘=’ میان گزینه و آرگومان الزامی است.

در اینجا خلاصه‌ای از گزینه‌های پشتیبانی‌شده آمده است:

-m, --model=id

انتخاب شماره مدل رادیو.

فهرست مدل‌ها را ببینید (از “rigctlsync -l” استفاده کنید).

نکته: برنامه rigctlsync (یا نرم‌افزارهای شخص ثالثی که از C API استفاده می‌کنند) از مدل رادیویی ۲ برای NET rigctl (جهت ارتباط با rigctld) استفاده خواهد کرد.

-r, --rig-file=device

استفاده از device به‌عنوان نام فایل درگاه متصل به رادیو.

معمولاً یک درگاه سریال است، اما می‌تواند مبدل USB به سریال نیز باشد. به‌طور معمول در لینوکس /dev/ttyS0، /dev/ttyS1، /dev/ttyUSB0 و غیره، و در MS Windows به‌صورت COM1، COM2 و غیره است. سیستم‌های خانواده BSD و Mac OS/X نام‌گذاری‌های ویژه خود را دارند. مستندات سیستم خود را ببینید.

رشته ویژه “uh-rig” می‌تواند برای فعال‌سازی پشتیبانی از دستگاه micro-ham مشخص شود.

-R, --rig-file2=device

استفاده از device به‌عنوان نام فایل یکی از درگاه‌های com مجازی -- برنامه شما به درگاه com دیگر از جفت مجازی متصل خواهد شد.

-s, --serial-speed=baud

تنظیم سرعت سریال روی نرخ baud.

به‌طور پیش‌فرض از حداکثر سرعت سریال موجود در قابلیت‌های پسانه (backend) رادیو (تعیین‌شده توسط -m در بالا) استفاده می‌کند.

-S, --serial-speed2=baud

تنظیم سرعت سریال روی نرخ baud برای درگاه com مجازی (گزینه -R را ببینید).

به‌طور پیش‌فرض از حداکثر سرعت سریال موجود در قابلیت‌های پسانه رادیو (تعیین‌شده توسط -m در بالا) استفاده می‌کند.

-c, --civaddr=id

استفاده از id به‌عنوان آدرس CI-V برای ارتباط با رادیو.

تنها برای رادیوهای Icom و برخی از رادیوهای Ten-Tec کاربرد دارد.

نکته: مقدار id در مبنای ده است، مگر اینکه پیشوند 0x داشته باشد که در این صورت در مبنای شانزده (هگزادسیمال) خواهد بود.

-L, --show-conf

فهرست کردن تمام پارامترهای پیکربندی برای رادیوی تعریف‌شده با گزینه -m در بالا.

-C, --set-conf=parm=val[,parm=val]

تنظیم پارامتر(های) پیکربندی رادیو، مانند stop_bits=2.

برای مشاهده فهرست پارامترهای پیکربندی یک شماره مدل مشخص، از گزینه -L در بالا استفاده کنید.

-u, --dump-caps

تخلیه قابلیت‌های رادیوی تعریف‌شده با گزینه -m در بالا و خروج.

-l, --list

فهرست کردن تمام شماره مدل‌های تعریف‌شده در Hamlib و خروج.

فهرست بر اساس شماره مدل مرتب شده است.

نکته: در لینوکس می‌توان با استفاده از کلیدهای Shift-PageUp/Shift-PageDown یا با استفاده از نوارهای پیمایش یک ترمینال مجازی در X یا پنجره cmd در ویندوز، فهرست را به عقب پیمایش کرد. خروجی را می‌توان به more(1) یا less(1) هدایت (pipe) کرد، مانند “rigctl -l | more”.

-n, --no-restore-ai

برنامه rigctl وضعیت اطلاعات خودکار (AI) را در رادیوی کنترل‌شده بازیابی می‌کند.

اگر این رفتار مطلوب نیست، برای نمونه زمانی که از rigctl برای روشن یا خاموش کردن حالت AI استفاده می‌کنید، این گزینه را مشخص کنید.

-B, --mapa2b

نگاشت set_freq روی VFOA به جای آن بر روی VFOB. این قابلیت امکان استفاده از CW skimmer همراه با رادیو در حالت split را فراهم می‌کند و کلیک روی یک فرکانس در CW skimmer، مقدار VFOB را روی فرکانس ارسال تنظیم خواهد کرد.

-v, --verbose

تنظیم حالت پرگویی (verbose)، انباشته‌شونده (بخش خطاها (DIAGNOSTICS) در زیر را ببینید). -Z, --debug-time-stamps فعال‌سازی برچسب‌های زمانی برای پیام‌های اشکال‌زدایی.

تنها در ترکیب با گزینهٔ -v استفاده شود، چرا که به خودی خود هیچ خروجی‌ای تولید نمی‌کند.

-h, --help

نمایش خلاصه‌ای از این گزینه‌ها و خروج.

-V, --version

نمایش نسخهٔ rigctl و خروج.

نکته: ممکن است برخی گزینه‌ها توسط یک بک‌اند خاص پیاده‌سازی نشده باشند و خطایی را برگردانند. این حالت به احتمال زیاد با گزینه‌های --set-conf و --show-conf رخ می‌دهد.

خطاها (DIAGNOSTICS)

گزینهٔ -v، --verbose امکان می‌دهد سطوح مختلفی از عیب‌یابی در stderr خروجی داده شوند که متناظر است با -v برای BUG، -vv برای ERR، -vvv برای WARN، -vvvv برای VERBOSE، یا -vvvvv برای TRACE.

یک سطح پرگویی مشخص، برای ارائهٔ اطلاعات اشکال‌زدایی لازم به نشانی ایمیل زیر مفید است. برای نمونه، خروجی TRACE تمام مقادیر ارسال‌شده به رادیو و دریافت‌شده از آن را نشان می‌دهد که برای توسعهٔ کتابخانهٔ بک‌اند رادیو بسیار مفید است و ممکن است توسط توسعه‌دهندگان درخواست شود.

وضعیت خروج (EXIT STATUS)

rigctlsync با این وضعیت‌ها خارج می‌شود:

0

اگر تمام عملیات‌ها به‌طور عادی کامل شوند؛

1

اگر گزینه یا آرگومان خط فرمان نامعتبری وجود داشته باشد؛

2

اگر خطایی از طرف Hamlib بازگردانده شود.

مثال‌ها (EXAMPLES)

راه‌اندازی rigctlsync با FLRig به‌عنوان مدل Hamlib

$ rigctlsync -m 4 -M 9 -R 192.168.1.1:4532

نمودار زیر جریان ارتباطی را نشان می‌دهد که به N1MM Logger+ امکان می‌دهد با یک رادیوی متصل به Flrig ارتباط برقرار کند:

Flrig -><- rigctlcom -> COM9 <- virt_port_pipe -> COM10 <- N1MM

گزارش باگ‌ها به:

فهرست پستی توسعه‌دهندگان Hamlib

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

این فایل بخشی از Hamlib است؛ پروژه‌ای برای توسعهٔ کتابخانه‌ای که توابع کنترلی رادیو، چرخاننده و تقویت‌کننده را برای توسعه‌دهندگان نرم‌افزارهایی که اساساً مورد توجه رادیوآماتورها و علاقه‌مندان به ارتباطات رادیویی هستند، ساده می‌کند.

کپی‌رایت © 2000-2011 Stephane Fillod
کپی‌رایت © 2000-2018 گروه Hamlib (مشارکت‌کنندگان گوناگون)
کپی‌رایت © 2010-2020 Nate Bargmann
کپی‌رایت © 2019 Michael Black W9MDB

این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر، فایل COPYING را ببینید. هیچ ضمانتی وجود ندارد؛ حتی برای قابل فروش بودن یا تناسب با یک هدف خاص.

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

rigctld(1), rigctl(1), socat(1), hamlib(7)

اطلاعات تکمیلی (COLOPHON)

پیوندهای مربوط به ویکی Hamlib، مخزن Git، بایگانی‌های انتشار و بایگانی رونوشت‌های روزانه از طریق hamlib.org در دسترس است.