RIGCTL(1) Hamlib Utilities RIGCTL(1)

rigctl - کنترل فرستنده‌گیرنده‌ها و گیرنده‌های رادیویی

rigctl [-hiIlLnouV] [-m id] [-r device] [-p device] [-d device] [-P type] [-D type] [-s baud] [-c id] [-t char] [-C parm=val] -Y [-v[-Z]] [command|-]

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

به یاد داشته باشید که Hamlib نرم‌افزاری در سطح آزمایشی (BETA) است. گرچه بسیاری از کتابخانه‌های backend فاقد پشتیبانی کامل از رادیو هستند، عملکردهای پایه معمولاً به خوبی پشتیبانی می‌شوند.

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

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

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

انتخاب شماره مدل رادیو. پیش‌فرض، dummy rig (رادیوی مجازی) است.
فهرست مدل‌ها را ببینید (از “rigctl -l” استفاده کنید).
نکته: rigctl (یا نرم‌افزارهای شخص ثالثی که از C API استفاده می‌کنند) از مدل رادیویی ۲ برای NET rigctl (جهت برقراری ارتباط با rigctld) استفاده خواهند کرد.
استفاده از device به‌عنوان نام فایل درگاهی که به رادیو متصل است.
معمولاً /dev/ttyS0، /dev/ttyS1، /dev/ttyUSB0 و غیره در لینوکس، و COM1، COM2 و غیره در MS Windows. مشتقات BSD و Mac OS/X نام‌گذاری‌های خاص خود را دارند. به مستندات سیستم خود مراجعه کنید.
می‌تواند یک نشانی شبکه:درگاه باشد، مانند 127.0.0.1:12345
رشتهٔ ویژهٔ “uh-rig” می‌تواند برای فعال‌سازی پشتیبانی از دستگاه micro-ham ارائه شود.
استفاده از device به‌عنوان نام فایل دستگاه Push-To-Talk با استفاده از یک فایل دستگاه به‌گونه‌ای که در بالا توضیح داده شد.
استفاده از device به‌عنوان نام فایل دستگاه Data Carrier Detect با استفاده از یک فایل دستگاه به‌گونه‌ای که در بالا توضیح داده شد.
استفاده از type (نوع) برای دستگاه Push-To-Talk.
نوع‌های پشتیبانی‌شده عبارتند از ‘RIG’ (دستور CAT)،‏ ‘DTR’،‏ ‘RTS’،‏ ‘PARALLEL’،‏ ‘CM108’،‏ ‘GPIO’،‏ ‘GPION’،‏ ‘NONE’، که نوع PTT تعریف‌شده در backend رادیو را بازنویسی (override) می‌کنند.
برخی از اثرات جانبی این دستور آن است که با تنظیم نوع روی DTR، وضعیت خوانده‌شدهٔ PTT از سمت frontend در Hamlib می‌آید و از رادیو خوانده نمی‌شود. در صورت تنظیم روی NONE، وضعیت PTT حتی اگر backend رادیو از خواندن/تنظیم وضعیت PTT دستگاه پشتیبانی کند، قابل خواندن یا تنظیم نخواهد بود.
استفاده از type (نوع) برای دستگاه Data Carrier Detect.
نوع‌های پشتیبانی‌شده عبارتند از ‘RIG’ (دستور CAT)،‏ ‘DSR’،‏ ‘CTS’،‏ ‘CD’،‏ ‘PARALLEL’،‏ ‘CM108’،‏ ‘GPIO’،‏ ‘GPION’،‏ ‘NONE’.
تنظیم سرعت سریال روی نرخ baud.
به‌طور پیش‌فرض از بیشینه سرعت سریال بر اساس قابلیت‌های backend رادیو (تعیین‌شده توسط -m در بالا) استفاده می‌کند.
استفاده از id به‌عنوان نشانی CI-V برای ارتباط با رادیو.
تنها برای رادیوهای Icom و برخی از رادیوهای Ten-Tec کاربرد دارد.
نکته: شناسهٔ id در قالب ده‌دهی (decimal) است، مگر آنکه پیشوند 0x داشته باشد که در آن صورت در مبنای شانزده (hexadecimal) خواهد بود.
تغییر نویسهٔ پایانی char برای پروتکل متنی در هنگام استفاده از دستور send_cmd.
مقدار پیش‌فرض ASCII CR (‘0x0D’) است. نویسه‌های غیرقابل‌چاپ ASCII را می‌توان به صورت کد ASCII در قالب مبنای شانزده همراه با پیشوند “0x” وارد کرد. برای نداشتن نویسهٔ پایانی می‌توانید یک رشتهٔ خالی ارسال کنید. رشتهٔ “-1” به rigctl می‌گوید که به پروتکل باینری جابه‌جا شود. برای توضیحات بیشتر به دستور send_cmd مراجعه کنید.
برای نمونه، جهت مشخص کردن پایان‌دهندهٔ دستور در دستورهای متنی به سبک Kenwood، عبارت “-t ';'” را به rigctl بدهید. بخش مثال‌ها (EXAMPLES) را در زیر ببینید. -L, --show-conf فهرست کردن تمامی پارامترهای پیکربندی برای رادیوی تعریف‌شده با -m در بالا.
تنظیم پارامتر(های) پیکربندی. برخی از موارد رایج عبارت‌اند از:
async:مقدار True انتقال ناهمگام داده را برای بک‌اندهایی که از آن پشتیبانی می‌کنند فعال می‌سازد. این کار امکان استفاده از داده‌های transceive و طیف را فراهم می‌کند.
auto_power_on:مقدار True امکان روشن شدن رادیوهای سازگار را هنگام باز شدن ارتباط فعال می‌کند
auto_power_off:مقدار True امکان خاموش شدن رادیوهای سازگار را هنگام بسته شدن ارتباط فعال می‌کند
auto_disable_screensaver:مقدار True محافظ صفحهٔ رادیوهای سازگار را هنگام باز شدن غیرفعال می‌کند
dcd_type:بازنویسی نوع رابط Data Carrier Detect (یا اسکوئلچ)
dcd_pathname:مسیر فایل دستگاه مربوط به Data Carrier Detect (یا اسکوئلچ)
disable_yaesu_bandselect:مقدار True انتخاب خودکار باند هنگام تغییر باند را برای رادیوهای Yaesu غیرفعال می‌کند
dtr_state:مقدار ON سیگنال DTR را روشن، OFF آن را خاموش، و Unset آن را غیرفعال می‌کند
freq_skip:مقدار !=0 از تنظیم فرکانس روی TX_VFO در هنگام RX و روی RX_VFO در هنگام TX صرف‌نظر می‌کند -- برای استفاده با gpredict و رادیوهایی که TARGETABLE_VFO ندارند
lo_freq:فرکانسی که برای استفاده با یک ترانسورتر به فرکانس VFO افزوده می‌شود
post_write_delay:تأخیر بر حسب میلی‌ثانیه بین هر دستور ارسال‌شده
ptt_share:مقدار True اشتراک‌گذاری درگاه ptt را با سایر برنامه‌ها فعال می‌کند
ptt_type:بازنویسی نوع رابط Push-To-Talk
ptt_pathname:مسیر فایل دستگاه مربوط به Push-To-Talk
ptt_bitnum:شماره بیت GPIO برای Push-To-Talk
retry:حداکثر تعداد تلاش مجدد
rts_state:مقدار ON سیگنال DTR را روشن، OFF آن را خاموش، و Unset آن را غیرفعال می‌کند
twiddle_timeout:برای عملیات ماهواره‌ای، هنگامی که VFOB دستکاری شود دستورات VFOB را تا پایان مهلت متوقف می‌کند
twiddle_rit:جلوگیری از اجرای get_freq روی VFOB برای تنظیم ماهواره‌های دارای RIT
timeout:مهلت زمانی بر حسب میلی‌ثانیه
write_delay:تأخیر بر حسب میلی‌ثانیه بین هر بایت ارسال‌شده
tuner_control_pathname:مسیر فایل اسکریپت/برنامه برای کنترل تیونر با ۱ آرگومان 0/1 جهت خاموش/روشن کردن تیونر

از گزینهٔ -L در بالا برای دریافت فهرستی از پارامترهای پیکربندی شماره مدل مشخص‌شده استفاده کنید.
تخلیه قابلیت‌های رادیوی تعریف‌شده با -m در بالا و خروج.
فهرست کردن تمامی شماره مدل‌های تعریف‌شده در Hamlib و خروج.
این فهرست بر اساس شماره مدل مرتب شده است.
نکته: در لینوکس می‌توان با استفاده از Shift-PageUp/Shift-PageDown یا با استفاده از نوارهای پیمایش یک ترمینال مجازی در X یا پنجرهٔ cmd در Windows، فهرست را به عقب پیمایش کرد. همچنین خروجی را می‌توان به more(1) یا less(1) هدایت (pipe) کرد؛ مانند “rigctl -l | more”.
فعال کردن حالت vfo.
یک آرگومان VFO اضافی پیش از هر دستور مربوطه (به‌جز set_vfo) لازم خواهد بود. در غیر این صورت، هنگامی که این گزینه تنظیم نشده باشد و آرگومان VFO اضافی استفاده نشود، ‘currVFO’ به کار می‌رود.
هنگام خروج، rigctl وضعیت اطلاع‌رسانی خودکار (AI) را روی رادیوی تحت کنترل بازیابی می‌کند.
اگر این رفتار مورد نظر نیست، مثلاً اگر از rigctl برای روشن یا خاموش کردن حالت AI استفاده می‌کنید، این گزینه را ارسال کنید.
خواندن تاریخچهٔ دستورها و آرگومان‌های ذخیره‌شدهٔ قبلی از یک فایل (پیش‌فرض: $HOME/.rigctl_history) برای نشست فعلی.
زمانی در دسترس است که rigctl با پشتیبانی از Readline ساخته شده باشد (بخش READLINE را در زیر ببینید).
نکته: برای خواندن فایل تاریخچه ذخیره‌شده در یک دایرکتوری دیگر، متغیر محیطی RIGCTL_HIST_DIR را تنظیم کنید؛ برای مثال: “RIGCTL_HIST_DIR=~/tmp rigctl -i”. هنگامی که RIGCTL_HIST_DIR تنظیم نشده باشد، مقدار HOME استفاده می‌شود.
نوشتن تاریخچهٔ دستورها و آرگومان‌های نشست فعلی (و نشست(های) قبلی، در صورت استفاده از گزینهٔ -i ) در یک فایل (پیش‌فرض: $HOME/.rigctl_history) در پایان نشست فعلی.
دستورهای کامل همراه با آرگومان‌هایشان به صورت یک خط واحد ذخیره می‌شوند تا بتوان آنها را بازخوانی، استفاده یا ویرایش کرد. زمانی در دسترس است که rigctl با پشتیبانی از Readline ساخته شده باشد (بخش READLINE را در زیر ببینید).
نکته: برای نوشتن فایل تاریخچه در دایرکتوری دیگر، متغیر محیطی RIGCTL_HIST_DIR را تنظیم کنید؛ مانند “RIGCTL_HIST_DIR=~/tmp rigctl -I”. هنگامی که RIGCTL_HIST_DIR تنظیم نشده باشد، مقدار HOME استفاده می‌شود.
تنظیم حالت پرگو (verbose)، به صورت تجمعی (بخش خطاها (DIAGNOSTICS) در زیر را ببینید).
نادیده گرفتن خطاهای باز کردن رادیو
فعال‌سازی برچسب‌های زمانی برای پیام‌های اشکال‌زدایی.
تنها در ترکیب با گزینهٔ -v استفاده شود، زیرا به خودی خود هیچ خروجی‌ای تولید نمی‌کند.
نمایش خلاصه‌ای از این گزینه‌ها و خروج.
نمایش نسخهٔ rigctl و خروج.
-!, --cookie
تنظیم کوکی مورد استفاده برای امنیت دسترسی از راه دور
-#, --skip_init
صرف‌نظر کردن از بیشتر مقداردهی‌های اولیه هنگام راه‌اندازی.
-
توقف پردازش گزینه‌ها و خواندن دستورها از ورودی استاندارد.
بخش ورودی استاندارد (Standard Input) در زیر را ببینید.

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

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


M LSB 2400

از آنجا که بیشتر عملیات‌های Hamlib دارای متدهای set و get هستند، از یک حرف بزرگ لاتین برای متدهای set استفاده می‌شود؛ در حالی که حرف کوچک متناظر با آن به متد get اشاره دارد. هر عملیات نام بلندی نیز دارد؛ در حالت تعاملی، یک بک‌اسلش، ‘\’، را در ابتدا قرار دهید تا یک نام دستور بلند با حروف کوچک وارد شود.

مثال: از “\dump_caps” برای مشاهدهٔ اینکه این رادیو و backend از چه قابلیت‌هایی پشتیبانی می‌کنند استفاده کنید.

نکته: بک‌اندِ رادیویی که باید کنترل شود یا خود رادیو ممکن است از برخی دستورها پشتیبانی نکنند. در این صورت، عملیات با یک پیام خطای Hamlib شکست خواهد خورد.

به عنوان جایگزینی برای ورود تعاملی دستورها با READLINE یا اجرای یک دستور تکی در هر بار اجرا، rigctl دارای یک گزینهٔ ویژه است که در آن می‌توان از یک خط تیره تنها (‘-’) برای خواندن دستورها از ورودی استاندارد (stdin) استفاده کرد. دستورها باید مشابه دستورهای داده شده در خط فرمان، با فاصله (whitespace) جدا شوند. توضیحات را می‌توان با استفاده از نویسهٔ ‘#’ اضافه کرد؛ تمام متن تا انتهای خط جاری شامل نویسهٔ ‘#’ نادیده گرفته می‌شود.

یک مثال ساده (متن تایپ‌شده برجسته است):


$ cat <<.EOF. >cmds.txt
> # File of commands
> v f m	# query rig
> V VFOB F 14200000 M CW 500	# set rig
> v f m	# query rig
> .EOF.
$ rigctl -m1 - <cmds.txt
v VFOA
f 145000000
m FM
15000
V VFOB
F 14200000
M CW 500
v VFOB
f 14200000
m CW
500
$
خلاصه‌ای از دستورها در ادامه آورده شده است (در خصوص دستورهای set رشته‌های مورب درون گیومه با مقدار شرح‌داده‌شده جایگزین می‌شوند. در خصوص دستورهای get رشته‌های مورب درون گیومه نام کلیدِ مقدارِ بازگشتی هستند.):
خروج از rigctl در حالت تعاملی (interactive).
هنگامی که rigctl مستقیماً در حال کنترل رادیو (rig) است، backend رادیو و پورت را خواهد بست. هنگامی که rigctl به rigctld (مدل رادیوی ۲) متصل است، اتصال TCP/IP به rigctld بسته می‌شود و rigctld همچنان در حال اجرا باقی می‌ماند و برای یک اتصال شبکهٔ TCP/IP دیگر در دسترس خواهد بود.
تنظیم 'Frequency' بر حسب Hz.
مقدار Frequency می‌تواند یک عدد ممیز شناور یا یک عدد صحیح باشد.
دریافت 'Frequency' بر حسب Hz.
یک مقدار صحیح و VFOای را که hamlib فعال می‌داند، بازمی‌گرداند. توجه داشته باشید که برخی رادیوها (مانند تمام دستگاه‌های Icom) نمی‌توانند VFO فعلی را دنبال کنند؛ بنابراین اگر کاربر دکمه‌های رادیو مانند VFO را فشار دهد، ممکن است hamlib با رادیو ناهماهنگ شود. کلاینت‌های rigctld باید اطمینان حاصل کنند که VFO مورد نظر را تنظیم کرده‌اند یا از حالت vfo استفاده کنند.
تنظیم 'Mode' و 'Passband'.
‏Mode یک نشان (token) است: ‘USB’، ‘LSB’، ‘CW’، ‘CWR’، ‘RTTY’، ‘RTTYR’، ‘AM’، ‘FM’، ‘WFM’، ‘AMS’، ‘PKTLSB’، ‘PKTUSB’، ‘PKTFM’، ‘ECSSUSB’، ‘ECSSLSB’، ‘FA’، ‘SAM’، ‘SAL’، ‘SAH’، ‘DSB’.
‏Passband یک عدد صحیح بر حسب Hz است؛ -1 برای عدم تغییر، یا ‘0’ برای مقدار پیش‌فرض backend رادیو. دستگاه IC7300 می‌تواند از 1، 2، 3 برای انتخاب فیلتر مورد استفاده بهره ببرد.
نکته: ارسال یک ‘?’ (علامت پرسش) به عنوان آرگومان نخست به جای نشان Mode، فهرستی جداشده با فاصله از Modeهای پشتیبانی‌شده توسط backend رادیو را بازمی‌گرداند. از این قابلیت برای تعیین Modeهای پشتیبانی‌شده در یک backend رادیویی مشخص استفاده کنید.
دریافت 'Mode' و 'Passband'.
مقدار Mode را به عنوان یک نشان (token) و Passband را بر حسب Hz، همان‌طور که در set_mode در بالا آمد، بازمی‌گرداند.
تنظیم 'VFO'.
‏VFO یک نشان (token) است: ‘VFOA’، ‘VFOB’، ‘VFOC’، ‘currVFO’، ‘VFO’، ‘MEM’، ‘Main’، ‘Sub’، ‘TX’، ‘RX’، ‘MainA’، ‘MainB’، ‘MainC’، ‘SubA’، ‘SubB’ ‘SubC’.
در حالت VFO (گزینهٔ --vfo در بالا را ببینید) تنها یک پارامتر VFO لازم است:

$ rigctl -m 2029 -r /dev/rig -o
Rig command: V
VFO: VFOB
Rig command:

دریافت 'VFO' فعلی.
مقدار VFO را به عنوان یک نشان (token)، همان‌طور که در set_vfo در بالا آمد، بازمی‌گرداند.
تنظیم 'RIT'.
‏RIT بر حسب Hz است و می‌تواند + یا - باشد. مقدار ‘0’ قابلیت RIT (تنظیم تدریجی گیرنده یا Receiver Incremental Tuning) را برای تطابق با فرکانس VFO بازنشانی می‌کند.
نکته: ‏RIT باید صراحتاً با دستور set_func فعال یا غیرفعال شود. این ویژگی امکان تنظیم آفست RIT را مستقل از فعال‌سازی آن فراهم کرده و اجازه می‌دهد RIT در حین تنظیم آفست روی ‘0’ همچنان فعال بماند.
دریافت 'RIT' بر حسب Hz.
مقدار بازگردانده‌شده یک عدد صحیح است.
تنظیم 'XIT'.
‏XIT بر حسب Hz است و می‌تواند + یا - باشد. مقدار ‘0’ قابلیت XIT (تنظیم تدریجی فرستنده یا Transmitter Incremental Tuning) را برای تطابق با فرکانس VFO بازنشانی می‌کند.
نکته: ‏XIT باید صراحتاً با دستور set_func فعال یا غیرفعال شود. این ویژگی امکان تنظیم آفست XIT را مستقل از فعال‌سازی آن فراهم کرده و اجازه می‌دهد XIT در حین تنظیم آفست روی ‘0’ همچنان فعال بماند.
دریافت 'XIT' بر حسب Hz.
مقدار بازگردانده‌شده یک عدد صحیح است.
تنظیم 'PTT'.
‏PTT یک مقدار است: ‘0’ (حالت RX)، ‘1’ (حالت TX)، ‘2’ (میکروفون TX)، یا ‘3’ (داده‌های TX).
دریافت وضعیت 'PTT'.
مقدار PTT را همانند مقادیر set_ptt در بالا بازمی‌گرداند.
تنظیم حالت 'Split'.
‏Split یا برابر با ‘0’ = Normal (عادی) است یا ‘1’ = Split (مجزا).
تنظیم 'TX VFO'.
‏TX VFO یک نشان (token) است: ‘VFOA’، ‘VFOB’، ‘VFOC’، ‘currVFO’، ‘VFO’، ‘MEM’، ‘Main’، ‘Sub’، ‘TX’، ‘RX’.
دریافت حالت 'Split'..IP حالت Split یا ‘0’ = Normal یا ‘1’ = Split است.
دریافت 'TX VFO'.
مقدار TX VFO یک توکن است، مشابه آنچه در set_split_vfo در بالا آمده است.
تنظیم 'TX Frequency'، به هرتز.
فرکانس می‌تواند یک مقدار ممیز شناور یا یک عدد صحیح باشد.
دریافت 'TX Frequency'، به هرتز.
یک مقدار عدد صحیح برمی‌گرداند.
تنظیم 'TX Frequency' ، 'TX Mode' و 'TX Passband'. برای اطلاعات بیشتر set_split_mode را ببینید.
دریافت تنظیمات فعلی split.
تنظیم 'TX Mode' و 'TX Passband'.
مقدار TX Mode یک توکن است: ‘USB’، ‘LSB’، ‘CW’، ‘CWR’، ‘RTTY’، ‘RTTYR’، ‘AM’، ‘FM’، ‘WFM’، ‘AMS’، ‘PKTLSB’، ‘PKTUSB’، ‘PKTFM’، ‘ECSSUSB’، ‘ECSSLSB’، ‘FA’، ‘SAM’، ‘SAL’، ‘SAH’، ‘DSB’.
مقدار TX Passband به هرتز و به صورت یک عدد صحیح است، یا ‘0’ برای مقدار پیش‌فرض بک‌اند رادیو.
نکته: ارسال یک ‘?’ (پرس‌وجو) به عنوان نخستین آرگومان به جای توکن TX Mode، فهرستی جداشده با فاصله از TX Modeهای پشتیبانی‌شده توسط بک‌اند رادیو را برمی‌گرداند. از این قابلیت برای تعیین TX Modeهای پشتیبانی‌شده در یک بک‌اند رادیوی مشخص استفاده کنید.
دریافت 'TX Mode' و 'TX Passband'.
مقدار TX Mode را به عنوان یک توکن و TX Passband را به هرتز، مشابه آنچه در set_split_mode در بالا آمده است، برمی‌گرداند.
تنظیم 'Antenna' و 'Option'.
مقدار Number شماره آنتن بر مبنای ۱ است (‘1’، ‘2’، ‘3’، ...).
مقدار Option به رادیو بستگی دارد. برای Icom احتمالاً آنتن‌های Tx و Rx را مانند IC-7851 تنظیم می‌کند. برای مقادیر مختص به هر رادیو در این گزینه، به دفترچه راهنمای رادیوی خود مراجعه کنید. بیشتر رادیوها به این گزینه اهمیتی نمی‌دهند.
برای IC-7851، FTDX3000 (و احتمالاً برخی دیگر) این مقادیر بدین معنا هستند:

1 = TX/RX = ANT1  FTDX3000=ANT1/ANT3
2 = TX/RX = ANT2  FTDX3000=ANT2/ANT3
3 = TX/RX = ANT3  FTDX3000=ANT3
4 = TX/RX = ANT1/ANT4
5 = TX/RX = ANT2/ANT4
6 = TX/RX = ANT3/ANT4

دریافت 'Antenna'
مقدار 0 برای Antenna آنتن فعلی TX را برمی‌گرداند
مقادیر > 0 شماره آنتن بر مبنای ۱ هستند (‘1’، ‘2’، ‘3’، ...).
مقدار Option بازگردانده‌شده به رادیو بستگی دارد. برای Icom احتمالاً پرچم RX only است.
ارسال نمادهای 'Morse'. برای رادیوهای Yaesu از memory# (۱-۵ برای بیشتر رادیوها) یا پیامی حداکثر تا ۵۰ نویسه (که از memory#1 استفاده خواهد کرد) استفاده کنید

مثال از خط فرمان:

rigctl -m 3073 -r /dev/ttyUSB0 b "CQ CQ DE ME"
مثال Yaesu برای ارسال message#1:
rigctl -m 1035 -r /dev/ttyUSB0 b 1
0xbb, stop_morse
توقف ارسال کد مورس فعلی.
0xbc, wait_morse
انتظار برای پایان یافتن مورس -- فقط در حالت full break-in کار می‌کند.
0x94, send_voice_mem 'Msgnum'
دستور به رادیو برای ارسال پیام داخلی 'Msgnum'
0xab, stop_voice_mem
توقف ارسال پیام داخلی
0x8b, get_dcd
دریافت وضعیت 'DCD' (squelch): ‘0’ (بسته) یا ‘1’ (باز).
0x8d, set_twiddle 'Timeout'
تنظیم 'Timeout' twiddle به ثانیه.
0x8e, get_twiddle
دریافت 'Timeout' twiddle به ثانیه.
تنظیم 'Rptr Shift'.
مقدار Rptr Shift یکی از این موارد است: ‘+’، ‘-’، یا مقداری دیگر برای ‘None’.
دریافت 'Rptr Shift'.
مقدار ‘+’، ‘-’، یا ‘None’ را برمی‌گرداند.
تنظیم 'Rptr Offset'، به هرتز. o, get_rptr_offs دریافت 'Rptr Offset'، بر حسب هرتز.
تنظیم 'CTCSS Tone'، بر حسب دهم هرتز.
دریافت 'CTCSS Tone'، بر حسب دهم هرتز.
تنظیم 'DCS Code'.
دریافت 'DCS Code'.
0x90, set_ctcss_sql 'CTCSS Sql'
تنظیم تن 'CTCSS Sql'، بر حسب دهم هرتز.
0x91, get_ctcss_sql
دریافت تن 'CTCSS Sql'، بر حسب دهم هرتز.
0x92, set_dcs_sql 'DCS Sql'
تنظیم کد 'DCS Sql'.
0x93, get_dcs_sql
دریافت کد 'DCS Sql'.
0x95, set_cache 'Timeout'
تنظیم مهلت حافظهٔ پنهان بر حسب میلی‌ثانیه.
0x96, get_cache
دریافت مهلت حافظهٔ پنهان بر حسب میلی‌ثانیه.
0x97, uplink 'Uplink'
تنظیم VFO آپ‌لینک روی 'Uplink' (1=Sub، 2=Main).
تنظیم 'Tuning Step'، بر حسب هرتز.
دریافت 'Tuning Step'، بر حسب هرتز.
تنظیم 'Func' و 'Func Status'.
شناسهٔ Func یک توکن است: ‘ABM’، ‘AFC’، ‘AFLT’، ‘AIP’، ‘ANF’، ‘ANL’، ‘APF’، ‘ARO’، ‘BC2’، ‘BC’، ‘COMP’، ‘CSQL’، ‘DIVERSITY’، ‘DSQL’، ‘DUAL_WATCH’، ‘FAGC’، ‘FBKIN’، ‘LOCK’، ‘MBC’، ‘MN’، ‘MON’، ‘MUTE’، ‘NB2’، ‘NB’، ‘NR’، ‘OVF_STATUS’، ‘RESUME’، ‘REV’، ‘RF’، ‘RIT’، ‘SATMODE’، ‘SBKIN’، ‘SCEN’، ‘SCOPE’، ‘SEND_MORSE’، ‘SEND_VOICE_MEM’، ‘SPECTRUM’، ‘SPECTRUM_HOLD’، ‘SQL’، ‘SYNC’، ‘TBURST’، ‘TONE’، ‘TRANSCEIVE’، ‘TSQL’، ‘TUNER’، ‘VOX’، ‘VSC’، ‘XIT’.


ABM -- حالت باند خودکار
AFC -- روشن/خاموش کردن واپایش خودکار فرکانس
AFLT -- تنظیم فیلتر AF
AIP -- پیش‌تقویت‌کنندهٔ RF (به نام AIP در Kenwood، و IPO در Yaesu و غیره)
ANF -- فیلتر شکافی خودکار (DSP)
ANL -- تنظیم محدودکنندهٔ نویز
APF -- فیلتر قلهٔ صوتی
ARO -- آفست خودکار تکرارکننده
BC -- حذف‌کنندهٔ ضربان (Beat Canceller)
BC2 -- دومین حذف‌کنندهٔ ضربان
COMP -- فشرده‌سازی گفتار
CSQL -- تنظیم اسکلچ DCS
DIVERSITY -- دریافت چندمسیره/تنوعی (Diversity)
DSQL -- اسکلچ حالت‌های دیجیتال
DUAL_WATCH -- پایش دوگانه / گیرندهٔ فرعی
FAGC -- واپایش خودکار بهرهٔ سریع (Fast AGC)
FBKIN -- وقفهٔ کامل (در حالت CW)
LOCK -- قفل کردن
MBC -- حذف‌کنندهٔ دستی ضربان
MN -- فیلتر شکافی دستی (Manual Notch)
MON -- پایش سیگنال ارسالی
MUTE -- بی‌صدا کردن
NB -- حذف‌کنندهٔ نویز ضربه‌ای (Noise Blanker)
NB2 -- دومین حذف‌کنندهٔ نویز ضربه‌ای
NR -- کاهش نویز (DSP)
OVF_STATUS -- خواندن وضعیت سرریز: 0=خاموش، 1=روشن
RESUME -- ازسرگیری خودکار پویش
REV -- معکوس کردن فرکانس‌های ارسال و دریافت
RF -- فیلتر RTTY
RIT -- تنظیم دقیق تدریجی فرکانس گیرنده (RIT)
SATMODE -- روشن/خاموش کردن حالت ماهواره
SBKIN -- نیمه‌وقفه (در حالت CW)
SCEN -- درهم‌سازی/رمزنگاری
SCOPE -- روشن/خاموش کردن اسکوپ باند ساده
SEND_MORSE -- ارسال نویسه‌های مشخص‌شده با CW (مورس)
SEND_VOICE_MEM -- ارسال پیام صوتی ذخیره‌شده در حافظه در حالت SSB
SPECTRUM -- روشن/خاموش کردن خروجی داده‌های اسکوپ طیف
SPECTRUM_HOLD -- روشن/خاموش کردن توقف به‌روزرسانی‌های اسکوپ طیف
SQL -- روشن/خاموش کردن پایشگر اسکلچ
SYNC -- همگام‌سازی VFOها
TBURST -- پالس تن ۱۷۵۰ هرتز
TONE -- ارسال تن CTCSS (بخش TX)
TRANSCEIVE -- روشن/خاموش کردن ارسال خودکار تغییرات وضعیت رادیو
TSQL -- فعال/غیرفعال کردن دریافت CTCSS (بخش RX)
TUNER -- فعال‌سازی تیونر خودکار
VOX -- رلهٔ فعال‌شونده با صدا (VOX)
VSC -- واپایش پویش صوتی (Voice Scan Control)
XIT -- تنظیم دقیق تدریجی فرکانس فرستنده (XIT).IP مقدار Func Status یک مقدار غیر تهی (non-null) برای “activate” (فعال‌سازی) یا در غیر این صورت “de-activate” (غیرفعال‌سازی) است، بسیار شبیه به تعاریف TRUE/FALSE در زبان C (درست برابر با غیر صفر و نادرست برابر با صفر، ‘0’ است).

نکته: ارسال یک ‘?’ (پرس‌وجو) به‌عنوان آرگومان اول به‌جای یک توکن Func، فهرستی از توکن‌های توابع تنظیم (set function) پشتیبانی‌شده توسط backend رادیو را که با فاصله از هم جدا شده‌اند بازمی‌گرداند. از این قابلیت برای تعیین توابع پشتیبانی‌شدهٔ یک backend رادیویی مشخص استفاده کنید.
دریافت 'Func Status'.
مقدار Func Status را به‌صورت یک مقدار غیر تهی (non-null) برای توکن Func داده‌شده مانند آنچه در set_func در بالا آمده است بازمی‌گرداند.
نکته: ارسال یک ‘?’ (پرس‌وجو) به‌عنوان آرگومان اول به‌جای یک توکن Func، فهرستی از توکن‌های توابع دریافت (get function) پشتیبانی‌شده توسط backend رادیو را که با فاصله از هم جدا شده‌اند بازمی‌گرداند. از این قابلیت برای تعیین توابع پشتیبانی‌شدهٔ یک backend رادیویی مشخص استفاده کنید.
تنظیم 'Level' و 'Level Value'.
مقدار Level یک توکن از موارد زیر است: ‘AF’, ‘AGC’, ‘AGC_TIME’, ‘ALC’, ‘ANTIVOX’, ‘APF’, ‘ATT’, ‘BAL’, ‘BAND_SELECT’, ‘BKINDL’, ‘BKIN_DLYMS’, ‘COMP’, ‘COMP_METER’, ‘CWPITCH’, ‘ID_METER’, ‘IF’, ‘KEYSPD’, ‘METER’, ‘MGC’, ‘MGF’, ‘MGL’, ‘MICGAIN’, ‘MONITOR_GAIN’, ‘NB’, ‘NOTCHF’, ‘NOTCHF_RAW’, ‘NR’, ‘PBT_IN’, ‘PBT_OUT’, ‘PREAMP’, ‘RAWSTR’, ‘RF’, ‘RFPOWER’, ‘RFPOWER_METER’, ‘RFPOWER_METER_WATTS’, ‘SLOPE_HIGH’, ‘SLOPE_LOW’, ‘SPECTRUM_ATT’, ‘SPECTRUM_AVG’, ‘SPECTRUM_EDGE_HIGH’, ‘SPECTRUM_EDGE_LOW’, ‘SPECTRUM_MODE’, ‘SPECTRUM_REF’, ‘SPECTRUM_SPAN’, ‘SPECTRUM_SPEED’, ‘SQL’, ‘STRENGTH’, ‘SWR’, ‘TEMP_METER’, ‘USB_AF’, ‘USB_AF_INPUT’, ‘VD_METER’, ‘VOXDELAY’, ‘VOXGAIN’.
مقدار Level Value می‌تواند یک مقدار اعشاری (float) یا عدد صحیح (integer) باشد. برای توکن AGC مقدار یکی از این موارد است: ‘0’ = OFF، ‘1’ = SUPERFAST، ‘2’ = FAST، ‘3’ = SLOW، ‘4’ = USER، ‘5’ = MEDIUM، ‘6’ = AUTO. توجه داشته باشید که همه مقادیر روی تمام دستگاه‌ها (rigs) کار نمی‌کنند. برای فهرست کردن مقادیر قابل استفاده، دستور زیر را اجرا کنید:
rigctl -m MODEL_ID -u | grep "AGC levels"
یا برای Windows:
rigctl -m MODEL_ID -u | find "AGC levels"
واحدهای اندازه‌گیری سطح (Level units)
0.0-1.0 که در آن 0=0% و 1.0=100% است (به‌جز برای BAL که در آن 50% مرکز است)
    AF, ALC, ANTIVOX, BAL, COMP, MICGAIN, MONITOR_GAIN, NOTCHF_RAW, NR, RF, RFPOWER, RFPOWER_METER, USB_AF, VOXGAIN
آمپر (Amps)
    ID_METER(A)
دسی‌بل (dB)
    NL, COMP_METER, PREAMP, ATT, SLOPE_LOW, SLOPE_HIGH, SPECTRUM_REF, SPECTRUM_ATT, STRENGTH
درجه (دما)
    TEMP_METER(C)
هرتز (Hz)
    CWPITCH, IF, NOTCHF, PBT_IN, PBT_OUT, SPECTRUM_EDGE_LOW, SPECTRUM_EDGE_HIGH, SPECTRUM_SPAN
ثانیه (Seconds)
    VOXDELAY(ds), BKINDL(ms), BKIN_DLYMS(ms)
اطلاعات خام از rig
    RAWSTR, BANDSELECT (احتمال تغییر وجود دارد -- در حال حاضر شاخص است اما ممکن است به نام باند تبدیل شود)
SWR
    SWR
ولت (Volts)
    VD_METER
Lookup - اگر level مقدار 0/0/0 را نشان دهد احتمالا یک مقدار lookup است
    METER RIG_METER_XXXX 1=SWR, 2=COMP, 4=ALC, 8=IC, 16=DB, 32=PO, 64=VDD, 128=Temp
    AGC 0=None, 1=SuperFast, 2=Fast, 3=Slow, 4=User, 5=Medium, 6=Auto
        نکته: همه مقادیر AGC ممکن است در دسترس نباشند -- به AGC Level در dumpcaps مراجعه کنید (مثلاً rigctl -m 1035 -u | grep AGC)
    SPECTRUM_MODE 0=None, 1=Center, 2=Fixed, 3=Center Scroll, 4=Fixed Scroll
    SPECTRUM_AVG مخصوص هر rig
METER -- SWR,COMP,ALC,IC/ID,DB,PO,VDD,TEMP یا می‌توان از اعداد بالا در Lookup استفاده کرد؛ l METER مقدار meter number=name را برمی‌گرداند
وات (Watts)
    RFPOWER_METER_WATTS
کلمه در دقیقه (WPM)
    KEYSPD
نکته: ارسال یک ‘?’ (پرس‌وجو) به‌عنوان آرگومان اول به‌جای یک توکن Level، فهرستی از توکن‌های سطح تنظیم (set level) پشتیبانی‌شده توسط backend رادیو را که با فاصله از هم جدا شده‌اند بازمی‌گرداند. از این قابلیت برای تعیین سطوح پشتیبانی‌شدهٔ یک backend رادیویی مشخص استفاده کنید.
دریافت 'Level Value'.
مقدار Level Value را به‌صورت یک عدد اعشاری (float) یا عدد صحیح (integer) برای توکن Level داده‌شده مانند آنچه در set_level در بالا آمده است بازمی‌گرداند.
نکته: ارسال یک ‘?’ (پرس‌وجو) به‌عنوان آرگومان اول به‌جای یک توکن Level، فهرستی از توکن‌های سطح دریافت (get level) پشتیبانی‌شده توسط backend رادیو را که با فاصله از هم جدا شده‌اند بازمی‌گرداند. از این قابلیت برای تعیین سطوح پشتیبانی‌شدهٔ یک backend رادیویی مشخص استفاده کنید.
تنظیم 'Parm' و 'Parm Value'.
مقدار Parm یک توکن از موارد زیر است: ‘AFIF’, ‘AFIF_ACC’, ‘AFIF_LAN’, ‘AFIF_WLAN’, ‘ANN’, ‘APO’, ‘BACKLIGHT’, ‘BANDSELECT’, ‘BAT’, ‘BEEP’, ‘KEYERTYPE’, ‘KEYLIGHT’, ‘SCREENSAVER’, ‘TIME’..IP نکته: ارسال یک ‘?’ (پرسش) به عنوان نخستین آرگومان به‌جای شناسهٔ Parm، فهرستی جداشده با فاصله از شناسه‌های پارامترِ تنظیم (set parameter) پشتیبانی‌شده توسط بخش پشتیبان (backend) رادیو را بازمی‌گرداند. از این امکان برای تعیین پارامترهای پشتیبانی‌شدهٔ بخش پشتیبانِ یک رادیوی مشخص استفاده کنید.

ANN -- سطح "Announce"، ann_t را ببینید
APO -- خاموشی خودکار، int به دقیقه
BACKLIGHT -- نور پس‌زمینه LCD، float [0.0 ... 1.0]
BEEP -- بوق هنگام فشردن کلید، int (0,1)
TIME -- زمان hh:mm:ss، عدد صحیح (int) به ثانیه از 00:00:00
BAT -- سطح باتری، float [0.0 ... 1.0]
KEYLIGHT -- نور پس‌زمینهٔ کلیدها، on/off
SCREENSAVER -- مهلت‌های زمانی ویژهٔ رادیو
AFIF -- 0=AF audio، 1=IF audio -- به IC-7300/9700/705 مراجعه کنید
BANDSELECT -- نام باند، مانند BAND160M، BAND80M.... قرار دادن یک ? به‌جای نام باند گزینه‌های ممکن را نشان می‌دهد
KEYERTYPE -- نوع کلیدزن Icom معادل 0، 1، 2 یا STRAIGHT، BUG، PADDLE
دریافت 'Parm Value'.
مقدار Parm Value را به‌صورت float یا integer برای شناسهٔ Parm مشخص‌شده، مشابه set_parm در بالا بازمی‌گرداند.
نکته: ارسال یک ‘?’ (پرسش) به عنوان نخستین آرگومان به‌جای شناسهٔ Parm، فهرستی جداشده با فاصله از شناسه‌های پارامترِ دریافت (get parameter) پشتیبانی‌شده توسط بخش پشتیبان رادیو را بازمی‌گرداند. از این امکان برای تعیین پارامترهای پشتیبانی‌شدهٔ بخش پشتیبانِ یک رادیوی مشخص استفاده کنید.
تنظیم 'Bank'.
شمارهٔ بانک حافظهٔ کنونی را تنظیم می‌کند.
تنظیم شماره کانال 'Memory#'.
دریافت شماره کانال 'Memory#'.
انجام یک 'Mem/VFO Op'.
شناسهٔ Mem/VFO Operation یکی از مقادیر زیر است: ‘CPY’، ‘XCHG’، ‘FROM_VFO’، ‘TO_VFO’، ‘MCL’، ‘UP’، ‘DOWN’، ‘BAND_UP’، ‘BAND_DOWN’، ‘LEFT’، ‘RIGHT’، ‘TUNE’، ‘TOGGLE’.
نکته: ارسال یک ‘?’ (پرسش) به عنوان نخستین آرگومان به‌جای شناسهٔ Mem/VFO Op، فهرستی جداشده با فاصله از شناسه‌های Set Mem/VFO Op پشتیبانی‌شده توسط بخش پشتیبان رادیو را بازمی‌گرداند. از این امکان برای تعیین Mem/VFO Opهای پشتیبانی‌شدهٔ بخش پشتیبانِ یک رادیوی مشخص استفاده کنید.
انجام یک 'Scan Function' روی یک 'Scan Option'.
شناسهٔ Scan Function یکی از مقادیر زیر است: ‘DELTA’, ‘MEM’, ‘PLT’, ‘PRIO’, ‘PROG’, ‘SLCT’, ‘STOP’, ‘VFO’.
مقدار Scan Option یک عدد صحیح است.
مقدار Scan Option برای رادیوهای Yaesu عبارت است از 0=STOP، 1=UP، 2=DOWN.
مقدار Scan Option برای رادیوهای Icom شماره کانالی است که باید با G برنامه‌ریزی شود، در غیر این صورت استفاده نمی‌شود.
مقدار Scan Option برای رادیوهای Kenwood استفاده نمی‌شود.
نکته: ارسال یک ‘?’ (پرسش) به عنوان نخستین آرگومان به‌جای شناسهٔ Scan Fct، فهرستی جداشده با فاصله از شناسه‌های Scan Function پشتیبانی‌شده توسط بخش پشتیبان رادیو را بازمی‌گرداند. از این امکان برای تعیین Scan Functionهای پشتیبانی‌شدهٔ بخش پشتیبانِ یک رادیوی مشخص استفاده کنید.
تنظیم داده‌های حافظهٔ 'Channel'.
اطلاعات کانال حافظه را تنظیم می‌کند.
دریافت حافظهٔ کانال.
اگر readonly!=0 باشد، فقط داده‌های کانال بازگردانده می‌شود و رادیو روی کانال کنونی باقی می‌ماند. اگر readonly=0 باشد، رادیو روی کانال درخواست‌شده تنظیم خواهد شد.
تنظیم حالت 'Transceive'.
شناسهٔ Transceive یکی از این مقادیر است: ‘OFF’، ‘RIG’، ‘POLL’.
قابلیت Transceive سازوکاری برای رادیوهاست تا بدون فراخوانی مستقیم برای دریافت اطلاعات، رویدادها را گزارش دهند.
نکته: ارسال یک ‘?’ (پرسش) به عنوان نخستین آرگومان به‌جای شناسهٔ Transceive، فهرستی جداشده با فاصله از شناسه‌های حالت Transceive پشتیبانی‌شده توسط بخش پشتیبان رادیو را بازمی‌گرداند. از این امکان برای تعیین حالت‌های Transceive پشتیبانی‌شدهٔ بخش پشتیبانِ یک رادیوی مشخص استفاده کنید.
دریافت حالت 'Transceive'.
حالت Transceive (گزارش رویداد) همان‌طور که در set_trn در بالا آمده است.
*, reset 'Reset'
انجام 'Reset' رادیو.
مقدار Reset یکی از این مقادیر است: ‘0’ = هیچ‌کدام، ‘1’ = بازنشانی نرم‌افزاری، ‘2’ = بازنشانی VFO، ‘4’ = بازنشانی پاک‌سازی حافظه، ‘8’ = بازنشانی اصلی (Master reset).
از آنجا که این مقادیر به‌صورت یک ماسک بیتی (bitmask) در include/hamlib/rig.h تعریف شده‌اند، در صورتی که بخش پشتیبان از آن یا کلاً از عمل بازنشانی از طریق کنترل رادیو پشتیبانی کند، می‌توان این مقادیر را با یکدیگر OR بیتی کرد تا چند بازنشانی به طور هم‌زمان انجام شود.
0x87, set_powerstat 'Power Status'
تنظیم 'Power Status'.
مقدار Power Status یکی از این مقادیر است: ‘0’ = خاموش، ‘1’ = روشن، ‘2’ = آماده‌به‌کار (ورود به حالت standby)، ‘4’ = حالت عملیاتی (خروج از حالت standby).
0x88, get_powerstat
دریافت 'Power Status' همان‌طور که در set_powerstat در بالا آمده است.
0x89, send_dtmf 'Digits'
تنظیم ارقام DTMF 'Digits'.
0x8a, recv_dtmf
دریافت ارقام DTMF 'Digits'. 0xac, set_conf 'Token' 'Value' تنظیم 'Token' به 'Value'.
0xad, get_conf 'Token'
دریافت مقدار 'Token'.
_, get_info
دریافت اطلاعات متفرقه درباره رادیو.
0xf5, get_rig_info
دریافت اطلاعات متفرقه درباره وضعیت VFO رادیو و سایر اطلاعات.
0xf1, halt
هنگامی که درون rigctl صادر شود، از آن خارج می‌شود؛ هنگامی که توسط کلاینت دیگری صادر شود، در عوض از rigctld خارج می‌شود.
0xf3, get_vfo_info 'VFO'
دریافت اطلاعات متفرقه درباره یک VFO خاص.
0xf4, get_vfo_list
دریافت نام‌های VFOهای در دسترس.
0xf6, get_modes
دریافت تمام پهنای‌باندهای پشتیبانی‌شده برای تمام حالت‌ها (modes).
0xf7, get_mode_bandwidths 'Mode'
دریافت پهنای‌باندهای مربوط به 'Mode'. همچنین ببینید: get_modes.
بازگرداندن اطلاعات وضعیتی خاص درباره بک‌اند رادیو.
1, dump_caps
یک دستور ریموت واقعی برای رادیو نیست، بلکه صرفاً قابلیت‌ها را تخلیه (dump) می‌کند؛ یعنی آنچه بک‌اند درباره این مدل می‌داند و کارهایی که می‌تواند انجام دهد.
یادداشت (TODO): اطمینان حاصل شود که قالب این خروجی یکدست باشد تا بتوان آن را در یک هش، دیکشنری و غیره خواند. گزارش باگ‌ها مورد درخواست است.
نکته: این دستور خطوط خروجی زیادی تولید خواهد کرد، بنابراین اگر از آرایه‌ای با طول ثابت استفاده می‌کنید بسیار مراقب باشید! برای نمونه، اجرای این دستور در برابر بک‌اند Dummy منجر به بیش از ۵ کیلوبایت خروجی متنی می‌شود.
پارامتر VFO در «حالت VFO» استفاده نمی‌شود.
2, power2mW 'Power [0.0..1.0]' 'Frequency' 'Mode'
مقدار 'Power mW' را برمی‌گرداند.
مقداری از توان در محدوده 0.0...1.0 را به توان ارسال واقعی بر حسب میلی‌وات (عدد صحیح) تبدیل می‌کند.
همچنین مقادیر 'Frequency' و 'Mode' نیز باید ارائه شوند، چرا که توان خروجی ممکن است بر اساس این مقادیر تغییر کند.
پارامتر VFO در حالت VFO استفاده نمی‌شود.
3, dump_conf
یک دستور ریموت واقعی برای رادیو نیست، بلکه صرفاً پیکربندی فعلی را همراه با محدوده‌های مجاز مقادیر تخلیه (dump) می‌کند.
4, mW2power 'Power mW' 'Frequency' 'Mode'
مقدار 'Power [0.0..1.0]' را برمی‌گرداند.
توان ارسال واقعی بر حسب میلی‌وات (عدد صحیح) را به مقداری از توان در محدوده 0.0 ... 1.0 تبدیل می‌کند.
همچنین مقادیر 'Frequency' و 'Mode' نیز باید ارائه شوند، چرا که توان خروجی ممکن است بر اساس این مقادیر متغیر باشد.
پارامتر VFO در حالت VFO استفاده نمی‌شود.
ارسال یک رشته دستور خام به رادیو.
این دستور برای آزمایش و عیب‌یابی فرامین و پاسخ‌های رادیو هنگام توسعه یک بک‌اند مفید است.
برای پروتکل‌های باینری مقادیر را به صورت \0xAA\0xBB وارد کنید. انتظار دریافت یک 'Reply' از سوی رادیو را داشته باشید که بسته به پروتکل رادیو احتمالاً یک بلوک باینری یا یک رشته ASCII خواهد بود (به مستندات کنترل رایانه‌ای رادیوی خود مراجعه کنید). اگر در حال آزمایش پروتکلی مانند SmartSDR هستید که در دستورات آن فاصله وجود دارد، از علامت نقل‌قول استفاده کنید؛ مانند: w "C0|set slice 0 tx=1"
پایان‌دهنده دستور، که توسط گزینه send-cmd-term در بالا تعیین می‌شود، به هر رشته دستور ارسالی به رادیو خاتمه می‌دهد. این نویسه نباید بخشی از رشته ورودی باشد.
ارسال یک رشته دستور خام به رادیو و انتظار دریافت nbytes بایت یا نویسه پایان‌دهنده (مانند ;).
این دستور برای آزمایش و عیب‌یابی فرامین و پاسخ‌های رادیو هنگام توسعه یک بک‌اند مفید است. اگر تعداد بایت‌های درخواستی <= تعداد بایت‌های واقعاً دریافت شده باشد، هیچ وقفه‌ای (timeout) رخ نخواهد داد. اگر یک نویسه ارائه شود، برای پایان دادن به خواندن رشته استفاده می‌شود؛ برای نمونه ';' برای دستورات Kenwood/Yaesu بسیار پرکاربرد است.
آرگومان دستور نمی‌تواند شامل هیچ فاصله‌ای باشد. برای پروتکل‌های باینری مقادیر را به صورت \0xAA\0xBB وارد کنید. انتظار دریافت یک 'Reply' از سوی رادیو را داشته باشید که بسته به پروتکل رادیو احتمالاً یک بلوک باینری یا یک رشته ASCII خواهد بود (به مستندات کنترل رایانه‌ای رادیوی خود مراجعه کنید).
پایان‌دهنده دستور، که توسط گزینه send-cmd-term در بالا تعیین می‌شود، به هر رشته دستور ارسالی به رادیو خاتمه می‌دهد. این نویسه نباید بخشی از رشته ورودی باشد.
تنظیم 'DateTime'
ساعت رادیو را تنظیم می‌کند -- توجه داشته باشید که برخی از رادیوها ثانیه یا میلی‌ثانیه را مدیریت نمی‌کنند. اگر سعی کنید ثانیه/میلی‌ثانیه را تنظیم کنید و رادیو از آن پشتیبانی نکند، یک پیام هشدار اشکال‌زدایی (debug) دریافت خواهید کرد. قالب آن ISO8601 است. قالب‌های پذیرفته‌شده امکان منطقه زمانی ۲ رقمی یا ۴ رقمی را فراهم می‌کنند
YYYY-MM-DDTHH:MM:SS.SSS+ZZ (where +ZZ is either -/+ UTC offset HH)
YYYY-MM-DDTHH:MM:SS.SSS+ZZZZ (where +ZZZZ is either -/+ UTC offset HHMM)
YYYY-MM-DDTHH:MM:SS+ZZ
YYYY-MM-DDTHH:MM:SS+ZZZZ
YYYY-MM-DDTHH:MM+ZZ
YYYY-MM-DDTHH:MM+ZZZZ
YYYY-MM-DD (sets date only)
local (sets both clocks to local time)
utc (sets both clocks to utc time)
نکته: رادیوهای Icom انتظار دارند که شما زمان محلی و میزان اختلاف ساعت تا UTC را تنظیم کنید. بنابراین... برای نمونه ساعت 4PM EST به صورت 2021-12-01T16:00:00-0500 خواهد بود اما... اگر می‌خواهید GMT نمایش داده شود باید ساعت را روی GMT با افست صفرِ UTC تنظیم کنید. امید است در آینده Icom امکان نمایش هر یک از دو ساعت را فراهم کند

نکته: رادیوهای Kenwood تنها اجازه تنظیم ساعت محلی را می‌دهند، آن هم فقط در صورتی که به‌طور خودکار توسط NTP تنظیم نشده باشد. تلاش برای تنظیم ساعت هنگامی که NTP در حال استفاده است افست را تنظیم خواهد کرد، اما زمان را خیر - و هیچ وضعیت خطایی بازگردانده نخواهد شد. زمان نمایش‌داده‌شده روی ساعت کمکی صرفاً توسط UTC و افست کمکی تعیین می‌شود.

دریافت 'RigTime'
ساعت رادیو را دریافت می‌کند -- توجه داشته باشید که برخی از رادیوها ثانیه یا میلی‌ثانیه را مدیریت نمی‌کنند. قالب آن ISO8601 YYYY-MM-DDTHH:MM:SS.sss+ZZ است که در آن +ZZ نشان‌دهنده اختلاف UTC به صورت -/+ می‌باشد. chk_vfo دریافت 'Status'
اگر گزینه vfo فعال باشد وضعیت (Status) را ۱ و در صورتی که غیرفعال باشد ۰ برمی‌گرداند. این دستور بازتاب‌دهنده سوییچ -o برای rigctl و rigctld است و می‌تواند به صورت پویا توسط set_vfo_opt تغییر یابد.
تنظیم 'Status'
تنظیم وضعیت (Status) گزینه vfo به صورت 1=روشن یا 0=خاموش. این دستور مشابه استفاده از سوییچ -o برای rigctl و rigctld است. این مقدار در هنگام اجرا می‌تواند به صورت پویا تغییر کند.
تنظیم 'SeparatorChar'
پاسخ rigctld را تغییر می‌دهد تا به جای خط جدید از یک نویسه ویژه استفاده کند (نویسه # پیشنهاد می‌شود). برای گره tcprequest در node-red سودمند است. این مقدار در هنگام اجرا می‌تواند به صورت پویا تغییر یابد.
دریافت 'SeparatorChar'
نویسه جداکننده (SeparatorChar) فعلی را نمایش می‌دهد.
مکث به میزان عدد صحیح داده‌شده برحسب 'Seconds' (ثانیه) پیش از ارسال دستور بعدی به رادیو.
هنگامی که rigctld با -A ایمن‌سازی شده باشد، گذرواژه را به rigctld ارسال می‌کند. باید از کلید مشترک ۳۲ نویسه‌ای rigctld استفاده کند. (پیاده‌سازی نشده است)
قفل حالت را روشن (1) یا خاموش (0) می‌کند (تنها هنگام استفاده از rigctld). روشن کردن آن مانع از تغییر حالت دستگاه توسط تمامی کلاینت‌ها می‌شود. برای نمونه این ویژگی هنگام اجرای CW Skimmer در حالت FM روی یک دستگاه IC-7300 سودمند است. با فعال بودن قفل، کلیک کردن روی spotها در برنامه spotting باعث تغییر حالت VFOA نمی‌شود. بنابراین هنگام شروع CW Skimmer دستور "set_lock_mode 1" و هنگام توقف CW Skimmer دستور "set_lock_mode 0" را اجرا کنید.
وضعیت فعلی حالت قفل را برمی‌گرداند: 1=روشن، 2=خاموش (تنها هنگام استفاده از rigctld کاربرد دارد).
می‌تواند رشته ASCII یا مقادیر 0xnn یا xnn را ارسال کند -- در رشته دستور نباید هیچ فاصله‌ای وجود داشته باشد. مقادیر ممکن برای پایان‌دهنده (terminator) عبارتند از CR، LF، ;، ICOM، 1-100 (بایت‌ها برای خواندن)، یا 0 به معنای عدم پاسخ و -1 به معنای نامشخص (در زمان خواندن با انقضای زمان مواجه خواهد شد). مثال‌ها (توجه داشته باشید که ; در یونیکس/لینوکس باید گریز داده شود یا در نقل‌قول تکی یا دوتایی محصور گردد):
برای Windows و Unix/Linux قالب جدیدی با جداکننده دونقطه برای ارقام هگزادسیمال در دسترس است:
send_raw icom 0xFE:0xFE:0x94:0x03:0xFD Note: colon-separated does not have to be escaped on Unix/Linux
send_raw -1 0xFE:0xFE:0x94:0x03:0xFD
send_raw 14 0xFE:0xFE:0x94:0x03:0xFD
Note that ASCII commands still require escaping the semicolon on Unix/Linux
send_raw \; FA\;MD\;
برای Windows:
send_raw ; FA;MD;
send_raw icom 0xFE;0xFE;0x94;0x03;0xFD
send_raw -1 0xFE;0xFE;0x94;0x03;0xFD
send_raw 14 0xFE;0xFE;0x94;0x03;0xFD
برای Unix/Linux:
send_raw icom 0xFE;0xFE;0x94;0x03;0xFD
send_raw \; FA\;MD\;
send_raw -1 0xFE;0xFE;0x94;0x03;0xFD
send_raw 14 0xFE;0xFE;0x94;0x03;0xFD
کلاینت می‌تواند نسخه خود را به rigctld ارسال کند و بازخوردی پیرامون سازگاری، منسوخ‌شدن، و گزینه‌های جایگزین دریافت کند.
نسخه Hamlib را به همراه تاریخ/زمان با فرمت ISO8601 بازمی‌گرداند.
روال‌های آزمایشی را اجرا می‌کند. در حال توسعه است.
پایه‌های GPIO1، GPIO2، GPIO3، GPIO4 را روی درگاه ptt مربوط به GPIO تنظیم می‌کند. می‌توان از 1,2,3,4 نیز استفاده کرد.
پایه‌های GPIO1، GPIO2، GPIO3، GPIO4 را از روی درگاه ptt مربوط به GPIO می‌خواند. می‌توان از 1,2,3,4 نیز استفاده کرد.
از راه‌اندازی اولیه رادیو صرف‌نظر می‌کند -- هنگام اجرای دستورها با rigctl جهت بالا بردن سرعت مفید است. اگر فایل‌های توسعهٔ کتابخانهٔ Readline در زمان پیکربندی (configure) یافت شوند، rigctl به‌طور مشروط با پشتیبانی از Readline برای ورود دستورها و آرگومان‌ها ساخته خواهد شد. کلیدهای میانبر دستورهای Readline بر روی مقادیر پیش‌فرض خود قرار دارند، همان‌گونه که در راهنمای Readline شرح داده شده است. rigctl نام “rigctl” را تنظیم می‌کند که می‌تواند در ساختارهای مقداردهی اولیهٔ مشروط در فایل مقداردهی اولیهٔ Readline ($HOME/.inputrc به‌طور پیش‌فرض) برای کلیدهای میانبر سفارشی مختص به rigctl به کار رود.

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

در حالت عادی تاریخچهٔ نشست ذخیره نمی‌شود؛ با این حال، استفاده از هر یک از گزینه‌های -i/--read-history یا -I/--save-history هنگام راه‌اندازی rigctl باعث می‌شود که هر تاریخچهٔ ذخیره‌شدهٔ قبلی خوانده شود و/یا تاریخچهٔ نشست فعلی و هر نشست قبلی (به شرطی که گزینه‌های -i و -I با هم داده شده باشند) هنگام بسته شدن rigctl ذخیره گردد. هر گزینه مستقل از دیگری است؛ یعنی می‌توان آن‌ها را به‌صورت جداگانه یا ترکیبی به کار برد. این قابلیت برای مثال جهت ذخیرهٔ مجموعه‌ای از دستورها و سپس خواندن آن‌ها در آینده بدون بازنویسی تاریخچهٔ تغییریافته برای داشتن مجموعه‌ای پایدار از دستورهای آزمایشی در حالت تعاملی مفید است.

تاریخچه به‌طور پیش‌فرض در $HOME/.rigctl_history ذخیره می‌شود، اگرچه دایرکتوری مقصد را می‌توان با تنظیم متغیر محیطی RIGCTL_HIST_DIR تغییر داد. در صورتی که RIGCTL_HIST_DIR تنظیم نشده باشد، مقدار متغیر محیطی HOME به‌جای آن استفاده می‌شود. در حال حاضر تنها دایرکتوری مقصد قابل تغییر است.

اگر پشتیبانی از Readline در زمان پیکربندی یافت نشود، از پردازشگر داخلی اولیهٔ دستورها استفاده می‌شود. بدون در نظر گرفتن اینکه پشتیبانی از Readline فعال شده باشد یا خیر، از Readline برای دستورهای rigctl که در خط فرمان وارد می‌شوند استفاده نخواهد شد.

نکته: پشتیبانی از Readline در نسخه‌های باینری ۳۲ بیتی یا ۶۴ بیتی MS Windows که توسط پروژهٔ Hamlib ارائه می‌شوند گنجانده نشده است. اجرای rigctl روی بستر MS Windows در پوستهٔ ‘cmd’ تاریخچهٔ خط فرمان نشست را ارائه می‌دهد، اما این تاریخچه بین نشست‌ها روی دیسک ذخیره نمی‌شود.

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

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

0
اگر تمام عملیات‌ها به‌طور عادی کامل شوند؛
1
اگر یک گزینه یا آرگومان نامعتبر در خط فرمان وجود داشته باشد؛
2
اگر خطایی از سوی Hamlib بازگردانده شود.

اجرای rigctl برای Yaesu FT-920 با استفاده از مبدل USB به سریال در Linux در حالت تعاملی:


$ rigctl -m 1014 -r /dev/ttyUSB1

اجرای rigctl برای Yaesu FT-920 با استفاده از COM1 در MS Windows همراه با تولید خروجی TRACE روی stderr:


> rigctl -m 1014 -r COM1 -vvvvv

اجرای rigctl برای Yaesu FT-920 با استفاده از مبدل USB به سریال همراه با تنظیم نرخ باود (baud rate) و بیت‌های توقف (stop bits):


$ rigctl -m 1014 -r /dev/ttyUSB1 -s 4800 -C stop_bits=2

اجرای rigctl برای Elecraft K3 با استفاده از مبدل USB به سریال همراه با تعیین پایان‌دهنده برای دستور w:


$ rigctl -m 2029 -r /dev/ttyUSB0 -t';'

اتصال به یک rigctld در حال اجرا با مدل رادیوی 2 (“NET rigctl”) روی میزبان محلی و تعیین درگاه TCP، همراه با تنظیم فرکانس و حالت:


$ rigctl -m 2 -r localhost:4532 F 7253500 M LSB 0
set_chan تاکنون هیچ متد ورودی ندارد، بنابراین پیاده‌سازی‌نشده باقی مانده است.

این بخش تقریباً خالی...

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


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

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

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

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

less(1), more(1), rigctld(1), hamlib(7)

پیوندها به ویکی Hamlib، مخزن Git، بایگانی‌های انتشار و بایگانی‌های وضعیت‌های لحظه‌ای (daily snapshots) روزانه از طریق hamlib.org در دسترس هستند.

2026-01-06 Hamlib