نام (NAME)

rigctld - دیمن کنترل رادیو از طریق TCP

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

توضیحات (DESCRIPTION)

برنامهٔ rigctld یک دیمن کنترل رادیو است که درخواست‌های کلاینت را از طریق سوکت‌های TCP مدیریت می‌کند. این امر اجازه می‌دهد تا چندین برنامهٔ کاربر یک رادیو را به اشتراک بگذارند (این ویژگی نیازمند توسعهٔ بیشتری است). با استفاده از چندین فرایند rigctld، می‌توان چندین رادیو را روی درگاه‌های TCP مختلف کنترل کرد. توجه داشته باشید که اگر برخی کلاینت‌ها از پاسخ‌های توسعه‌یافته و/یا حالت vfo استفاده کنند، استفاده از چندین فرایند/درگاه نیز الزامی خواهد بود. بنابراین برای هر ترکیب از پاسخ‌های توسعه‌یافته/حالت vfo ممکن است تا ۴ فرایند/درگاه مورد نیاز باشد. قواعد نحوی دستورها همانند rigctl(1) است. امید است که rigctld به‌ویژه برای توسعه‌دهندگان کلاینت با زبان‌هایی مانند Perl، Python، PHP و غیره سودمند باشد.

rigctld از طریق یک سوکت TCP با استفاده از دستورهای متنی مشترک با rigctl با کلاینت ارتباط برقرار می‌کند. پروتکل ساده است؛ دستورها در یک خط به rigctld ارسال می‌شوند و rigctld در صورت موفقیت، به دستورهای get با مقادیر درخواستی، هر کدام در یک خط، پاسخ می‌دهد؛ در غیر این صورت با یک خط شامل “RPRT x” پاسخ می‌دهد که در آن ‘x’ یک عدد منفی نشان‌دهندهٔ کد خطا است. دستورهایی که مقداری را برنمی‌گردانند با خط “RPRT x” پاسخ می‌دهند، که در صورت موفقیت ‘x’ برابر ‘0’ و در غیر این صورت یک عدد منفی نشان‌دهندهٔ کد خطا است. هر خط با یک نویسهٔ خط جدید ‘\n’ پایان می‌یابد. این پروتکل اساساً برای استفاده توسط بک‌اند NET rigctl (مدل رادیوی ۲) در نظر گرفته شده است.

یک پروتکل پاسخ توسعه‌یافته (Extended Response Protocol) مجزا رفتار فوق را با بازتاب دادن رشتهٔ دستور دریافتی در قالب یک سرایند، مقادیر بازگردانده‌شده به‌صورت جفت key: value، و رشتهٔ “RPRT x” به‌عنوان نشانگر پایان پاسخ که شامل مقدار موفقیت یا شکست Hamlib است، گسترش می‌دهد. برای جزئیات بیشتر بخش PROTOCOL را ببینید. استفاده از این پروتکل را برای کلاینت‌هایی در نظر بگیرید که مستقیماً از طریق یک سوکت TCP با rigctld در تعامل خواهند بود.

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

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

گزینه‌ها (OPTIONS)

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

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

-m, --model=id

انتخاب شماره مدل رادیو. پیش‌فرض رادیوی ساختگی (dummy) است.

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

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

-r, --rig-file=device

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

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

می‌تواند یک آدرس:درگاه شبکه باشد؛ برای نمونه: 127.0.0.1:12345

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

-p, --ptt-file=device

استفاده از device به‌عنوان نام فایل دستگاه Push-To-Talk با استفاده از یک فایل دستگاه به همان صورت که در بالا شرح داده شد.

-d, --dcd-file=device

استفاده از device به‌عنوان نام فایل دستگاه Data Carrier Detect با استفاده از یک فایل دستگاه به همان صورت که در بالا شرح داده شد.

-P, --ptt-type=type

استفاده از type دستگاه Push-To-Talk.

انواع پشتیبانی‌شده عبارتند از ‘RIG’ (دستور CAT)،‏ ‘DTR’،‏ ‘RTS’،‏ ‘PARALLEL’،‏ ‘CM108’،‏ ‘GPIO’،‏ ‘GPION’ و ‘NONE’، که نوع PTT تعریف‌شده در بک‌اند رادیو را بازنویسی می‌کند.

برخی از عوارض جانبی این دستور آن است که وقتی نوع روی DTR تنظیم شود، وضعیت PTT خوانده‌شده از فرانت‌اند Hamlib می‌آید و از رادیو خوانده نمی‌شود. هنگامی که روی NONE تنظیم شود، وضعیت PTT نه قابل خواندن است و نه قابل تنظیم، حتی اگر بک‌اند رادیو از خواندن/تنظیم وضعیت PTT از رادیو پشتیبانی کند.

-D, --dcd-type=type

استفاده از type دستگاه Data Carrier Detect.

انواع پشتیبانی‌شده عبارتند از ‘RIG’ (دستور CAT)،‏ ‘DSR’،‏ ‘CTS’،‏ ‘CD’،‏ ‘PARALLEL’،‏ ‘CM108’،‏ ‘GPIO’،‏ ‘GPION’ و ‘NONE’.

-s, --serial-speed=baud

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

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

-c, --civaddr=id

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

تنها برای رادیوهای Icom و برخی از رادیوهای Ten-Tec کاربرد دارد..IP نکته: شناسه id در نماد ده‌دهی است، مگر این‌که پیشوند 0x داشته باشد که در این صورت در نماد شانزده‌شانزدهی (هگزادسیمال) است.

-S, --separator=char

استفاده از char به عنوان جداکننده به جای نویسهٔ سطر جدید (line feed).

پیش‌فرض ‘\n’ است. استفاده از $ یا @ پیشنهاد می‌شود زیرا در هر دو سیستم‌عامل Unix و Windows کار می‌کنند.

-T, --listen-addr=IPADDR

استفاده از IPADDR به عنوان نشانی IP شنود.

پیش‌فرض ANY (0.0.0.0) است.

دستور rigctld را می‌توان به این صورت اجرا کرد و به آن متصل شد:

rigctld
rigctl -m 2
rigctl -m 2 -r 127.0.0.1
rigctl -m 2 -r localhost
rigctl -m 2 -r 192.168.1.1 (نشانی IP محلی)
rigctl -m 2 -r ::1 (در لینوکس rigctld به‌طور پیش‌فرض روی IPV6 شنود نمی‌کند)

rigctld -T 127.0.0.1
rigctl -m 2 (اتصال به همه رابط‌ها)
rigctl -m 2 -r 127.0.0.1 (تنها اتصال به 127.0.0.1)

استثناها:

rigctl -m 2 -r localhost (تنها در صورتی کار می‌کند که localhost یک نشانی IPV4 باشد)

rigctld -T localhost (بر اساس localhost روی IPV4 یا IPV6 راه‌اندازی می‌شود)
rigctl -m 2
rigctl -m 2 -r localhost
rigctl -m 2 ip6-localhost

استثناها:

rigctl -m 2 -r 127.0.0.1 (تنها در صورتی کار می‌کند که localhost یک نشانی IPV4 باشد)
rigctl -m 2 -r ::1 (تنها در صورتی کار می‌کند که localhost یک نشانی IPV6 باشد)

تنها در Linux در صورتی که ip6-localhost برابر fe00::0 باشد:

rigctld -T ip6-localhost
rigctl -m 2 -r ip6-localhost

-t, --port=number

استفاده از number به عنوان درگاه شنود TCP.

پیش‌فرض 4532 است.

نکته: از آنجا که درگاه پیش‌فرض rotctld برابر 4533 است، توصیه می‌شود برای rigctld از شماره درگاه‌های زوج استفاده کنید، مانند 4532، 4534، 4536 و غیره.

-L, --show-conf

فهرست کردن تمام پارامترهای پیکربندی برای رادیوی تعریف‌شده با -m در بالا. در صورت عدم تعیین -r برنامه خارج خواهد شد. توجه داشته باشید که دستگاه ساختگی (dummy) هیچ پارامتر سریالی ندارد.

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

تنظیم پارامتر(های) پیکربندی. برخی موارد متداول عبارتند از:

async:مقدار True انتقال ناهمگام داده را برای پشت‌بندهایی که از آن پشتیبانی می‌کنند، فعال می‌کند. این کار امکان استفاده از داده‌های ترانسیور و طیف را فراهم می‌سازد.
auto_power_on:مقدار True امکان روشن شدن رادیوهای سازگار را هنگام باز شدن فعال می‌کند
auto_power_off:مقدار True امکان خاموش شدن رادیوهای سازگار را هنگام بسته شدن فعال می‌کند
auto_disable_screensaver:مقدار True غیرفعال شدن محافظ صفحهٔ رادیوهای سازگار را هنگام باز شدن فعال می‌کند
dcd_type:جایگزینی نوع رابط Data Carrier Detect (یا squelch)
dcd_pathname:نام مسیر فایل دستگاه مربوط به Data Carrier Detect (یا squelch)
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 در بالا استفاده کنید.

-u, --dump-caps

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

-l, --list

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

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

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

-o, --vfo

فعال کردن حالت vfo.

یک آرگومان اضافی VFO در جلوی هر دستور مربوطه (به جز set_vfo) الزامی خواهد بود. در غیر این صورت، هنگامی که این گزینه تنظیم نشده باشد و آرگومان اضافی VFO به کار نرود، مقدار ‘currVFO’ استفاده می‌شود.

بخش chk_vfo در زیر را ببینید.

-v, --verbose

تنظیم حالت پرگو (verbose)، افزایشی (بخش DIAGNOSTICS در زیر را ببینید).

-W, --twiddle_timeout=seconds

فعال کردن مهلت زمانی هنگام تشخیص تغییرات سریع VFO (twiddling). برخی عملکردها نادیده گرفته خواهند شد.

تنها زمانی لازم است که نرم‌افزار کنترل‌کننده باید «مکث» کند تا بتوانید VFO را جابه‌جا کنید. حرکت مداوم، مهلت زمانی را تمدید می‌کند.

-w, --twiddle_rit=seconds

جلوگیری از get_freq در VFOB تا RIT قابل تنظیم (twiddle) باشد.

-x, --uplink=option

1=Sub, 2=Main

برای استفاده در GPredict به منظور نادیده گرفتن get_freq برای VFO بالاسوی (uplink) نوع Sub یا Main.

باید اجازه دهد VFO فروسو (downlink) بدون ایجاد اختلال در GPredict یا بالاسو (uplink) جابه‌جا شود.

-Z, --debug-time-stamps

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

-A, --password

گذرواژه‌ای را روی rigctld تنظیم می‌کند که باعث می‌شود hamlib ملزم به استفاده از rig_set_password و rigctl ملزم به استفاده از assword
برای دسترسی به rigctld شوند. یک کلید مشترک ۳۲ نویسه‌ای برای استفاده در سمت کلاینت نمایش داده خواهد شد. (پیاده‌سازی نشده است)

-R, --rigctld-idle

باعث می‌شود rigctld هنگامی که هیچ کلاینتی متصل نیست، دستگاه رادیویی (rig) را ببندد. در حالت عادی برای افزایش سرعت اتصالات بعدی، متصل باقی می‌ماند.

-b, --bind-all

باعث می‌شود rigctld تلاش کند به نخستین دستگاه شبکهٔ در دسترس متصل (bind) شود.

-h, --help

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

-V, --version

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

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

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

دستورها (COMMANDS)

دستورها را می‌توان روی سوکت TCP یا به صورت یک نویسهٔ منفرد، یا به شکل نام کامل دستور به همراه مقدار(ها) که با فاصله از هم جدا شده‌اند، روی خطی منتهی به ‘\n’ ارسال کرد. ببینید: PROTOCOL.

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

مثال (Perl): عبارت “print $socket "\\dump_caps\n";” برای مشاهدهٔ کارهایی که بک‌اندِ رادیو می‌تواند انجام دهد (نکته: در Perl و بسیاری از زبان‌های دیگر یک ‘\’ باید با یک ‘\’ قبل از خود گریز داده شود (escape شود)، به طوری که اگرچه دو نویسهٔ بک‌اسلش در کد دیده می‌شوند، تنها یکی از آن‌ها به rigctld ارسال خواهد شد. این موضوع می‌تواند موجب بروز خطا شود، مراقب باشید!).

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

در اینجا خلاصه‌ای از دستورهای پشتیبانی‌شده آمده است (در مورد دستورهای set رشتهٔ مورب داخل گیومه با مقدار موجود در توضیحات جایگزین می‌شود. در مورد دستورهای get رشتهٔ مورب داخل گیومه نام کلیدِ مقدار بازگردانده شده است):

F, set_freq 'Frequency'

تنظیم 'Frequency' بر حسب هرتز (Hz).

مقدار Frequency می‌تواند یک عدد ممیز شناور یا عدد صحیح باشد.

f, get_freq

دریافت 'Frequency' بر حسب هرتز (Hz).

یک مقدار عدد صحیح و VFOای که hamlib تصور می‌کند فعال است را بازمی‌گرداند. توجه داشته باشید که برخی دستگاه‌ها (مانند تمام رادیوهای Icom) قادر به ردگیری VFO فعلی نیستند، بنابراین اگر کاربر دکمه‌های روی دستگاه مثل VFO را فشار دهد، ممکن است hamlib با دستگاه از همگام‌سازی خارج شود. کلاینت‌های rigctld باید مطمئن شوند که VFO مد نظر را تنظیم کرده‌اند یا از حالت vfo استفاده کنند.

M, set_mode 'Mode' 'Passband'

تنظیم '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 بر حسب هرتز به صورت یک عدد صحیح است، -1 برای عدم تغییر، یا ‘0’ برای پیش‌فرض بک‌اندِ رادیو. دستگاه IC7300 می‌تواند از 1، 2 و 3 برای انتخاب فیلتر مورد استفاده بهره ببرد.

نکته: ارسال یک ‘?’ (پرس‌وجو) به عنوان نخستین آرگومان به جای نشانهٔ Mode، فهرستی جداشده با فاصله از Modeهای پشتیبانی‌شده توسط بک‌اند رادیو را بازمی‌گرداند. از این روش برای تعیین Modeهای پشتیبانی‌شدهٔ یک بک‌اند رادیویی معین استفاده کنید.

m, get_mode

دریافت 'Mode' و 'Passband'.

مقدار Mode را به صورت یک نشانه و Passband را بر حسب هرتز مانند set_mode در بالا بازمی‌گرداند.

V, set_vfo 'VFO'

تنظیم 'VFO'.

مقدار VFO یک نشانه است: ‘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:

v, get_vfo

دریافت 'VFO' فعلی.

مقدار VFO را به عنوان یک نشانه مانند set_vfo در بالا بازمی‌گرداند.

J, set_rit 'RIT'

تنظیم 'RIT'.

مقدار RIT بر حسب هرتز است و می‌تواند + یا - باشد. مقدار ‘0’ تنظیمات RIT (تنظیم افزایشی گیرنده) را به حالت تطابق با فرکانس VFO بازنشانی می‌کند.

نکته: قابلیت RIT باید به صراحت با دستور set_func فعال یا غیرفعال شود. این ویژگی امکان تنظیم آفست RIT را مستقل از فعال‌سازی آن فراهم می‌کند و اجازه می‌دهد RIT در هنگام تنظیم آفست روی ‘0’ فعال باقی بماند.

j, get_rit

دریافت 'RIT' بر حسب هرتز (Hz).

مقدار بازگردانده شده یک عدد صحیح است. Z, set_xit 'XIT' تنظیم 'XIT'.

‏XIT برحسب هرتز (Hz) است و می‌تواند + یا - باشد. مقدار ‘0’ تنظیم XIT (تنظیم تدریجی فرستنده یا Transmitter Incremental Tuning) را برای تطابق با بسامد VFO بازنشانی می‌کند.

نکته: ‏XIT باید به‌طور صریح با دستور set_func فعال یا غیرفعال شود. این امر اجازه می‌دهد افست XIT مستقل از فعال‌سازی آن تنظیم شود و امکان می‌دهد در حالی که افست روی ‘0’ تنظیم می‌شود، XIT همچنان فعال باقی بماند.

z, get_xit

دریافت 'XIT' برحسب هرتز (Hz).

مقدار بازگردانده‌شده یک عدد صحیح است.

T, set_ptt 'PTT'

تنظیم 'PTT'.

‏PTT یک مقدار است: ‘0’ (RX)، ‘1’ (TX)، ‘2’ (TX mic)، یا ‘3’ (TX data).

t, get_ptt

دریافت وضعیت 'PTT'.

مقدار PTT را مطابق با مقادیر ذکرشده در set_ptt در بالا بازمی‌گرداند.

S, set_split_vfo 'Split' 'TX VFO'

تنظیم حالت 'Split'.

‏Split یا ‘0’ = Normal است یا ‘1’ = Split.

تنظیم 'TX VFO'.

‏TX VFO یک نشانه است: ‘VFOA’، ‘VFOB’، ‘VFOC’، ‘currVFO’، ‘VFO’، ‘MEM’، ‘Main’، ‘Sub’، ‘TX’، ‘RX’.

s, get_split_vfo

دریافت حالت 'Split'.

‏Split یا ‘0’ = Normal است یا ‘1’ = Split.

دریافت 'TX VFO'.

‏TX VFO نشانه‌ای مطابق با set_split_vfo در بالا است.

I, set_split_freq 'Tx Frequency'

تنظیم 'TX Frequency'، برحسب هرتز (Hz).

بسامد می‌تواند یک مقدار ممیز شناور یا یک عدد صحیح باشد.

i, get_split_freq

دریافت 'TX Frequency'، برحسب هرتز (Hz).

یک مقدار عدد صحیح بازمی‌گرداند.

K, set_split_freq_mode 'TX Frequency' 'TX Mode' 'TX Passband'

تنظیم 'TX Frequency' ، 'TX Mode' و 'TX Passband'. برای اطلاعات بیشتر set_split_mode را ببینید.

k, get_split_freq_mode

دریافت تنظیمات فعلی split.

X, set_split_mode 'TX Mode' 'TX Passband'

تنظیم '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’ برای مقدار پیش‌فرض backend رادیو.

نکته: ارسال یک ‘?’ (پرس‌وجو) به عنوان آرگومان نخست به جای نشانه‌ی TX Mode، فهرستی جداشده با فاصله از حالت‌های TX پشتیبانی‌شده توسط backend رادیو را بازمی‌گرداند. از این قابلیت برای تعیین حالت‌های TX پشتیبانی‌شده‌ی یک backend رادیویی خاص استفاده کنید.

x, get_split_mode

دریافت 'TX Mode' و 'TX Passband'.

‏TX Mode را به صورت یک نشانه و TX Passband را برحسب هرتز مطابق با set_split_mode در بالا بازمی‌گرداند.

Y, set_ant 'Antenna' 'Option'

تنظیم 'Antenna' و 'Option'.

عدد مورد نظر، شماره آنتن مبتنی بر ۱ است (‘1’، ‘2’، ‘3’، ...).

گزینه (Option) به دستگاه رادیویی بستگی دارد. برای Icom احتمالاً همانند IC-7851 آنتن‌های Tx و Rx را تنظیم می‌کند. برای مقادیر اختصاصی گزینه، به دفترچه راهنمای رادیوی خود مراجعه کنید. بیشتر رادیوها به این گزینه اهمیتی نمی‌دهند.

برای 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

y, get_ant 'Antenna'

دریافت 'Antenna'

مقدار 0 برای Antenna، آنتن جاری TX را بازمی‌گرداند.

مقدار > 0، شماره آنتن مبتنی بر ۱ است (‘1’، ‘2’، ‘3’، ...).

گزینه‌ی بازگردانده‌شده به دستگاه رادیویی وابسته است. برای Icom احتمالاً پرچم RX only است.

b, send_morse 'Morse'

ارسال نمادهای 'Morse'. برای رادیوهای Yaesu از memory# (شماره حافظه ۱ تا ۵ برای اکثر رادیوها) یا پیامی با حداکثر ۵۰ نویسه (که از memory#1 استفاده خواهد کرد) استفاده کنید.

مثال از طریق سوکت rigctld:

b CQ CQ DE ME

مثال Yaesu برای ارسال message#1 از سوکت rigctld:

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' (اسکوئلچ): ‘0’ (بسته) یا ‘1’ (باز).

0x8d, set_twiddle 'Timeout'

تنظیم 'Timeout' مربوط به twiddle به ثانیه.

0x8e, get_twiddle

دریافت 'Timeout' مربوط به twiddle به ثانیه.

R, set_rptr_shift 'Rptr Shift'

تنظیم 'Rptr Shift'.

مقدار Rptr Shift یکی از این موارد است: ‘+’، ‘-’ یا مقداری دیگر برای ‘None’.

r, get_rptr_shift

دریافت 'Rptr Shift'.

مقادیر ‘+’، ‘-’ یا ‘None’ را برمی‌گرداند.

O, set_rptr_offs 'Rptr Offset'

تنظیم 'Rptr Offset'، به هرتز.

o, get_rptr_offs

دریافت 'Rptr Offset'، به هرتز.

C, set_ctcss_tone 'CTCSS Tone'

تنظیم 'CTCSS Tone'، بر حسب دهم هرتز.

c, get_ctcss_tone

دریافت 'CTCSS Tone'، بر حسب دهم هرتز.

D, set_dcs_code 'DCS Code'

تنظیم 'DCS Code'.

d, get_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'

تنظیم مهلت زمانی cache به میلی‌ثانیه.

0x96, get_cache

دریافت مهلت زمانی cache به میلی‌ثانیه.

0x97, uplink 'Uplink'

تنظیم VFO آپ‌لینک به 'Uplink' (1=Sub، 2=Main).

N, set_ts 'Tuning Step'

تنظیم 'Tuning Step'، به هرتز.

n, get_ts

دریافت 'Tuning Step'، به هرتز.

U, set_func 'Func' 'Func Status'

تنظیم 'Func' و 'Func Status'.

مقدار Func یک نشانه (token) است: ‘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 (در Kenwood به نام AIP، در Yaesu به نام IPO و غیره)
ANF -- فیلتر شکافی خودکار (DSP)
ANL -- تنظیم محدودکننده نویز
APF -- فیلتر اوج صوتی
ARO -- آفست خودکار تکرارکننده (ریپیتر)
BC -- حذف‌کننده ضربان
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 -- ازسرگیری خودکار پویش (Scan)
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
TRANSCEIVE -- ارسال خودکار تغییرات وضعیت رادیو روشن/خاموش
TSQL -- فعال/غیرفعال‌سازی دریافت CTCSS
TUNER -- فعال‌سازی تیونر خودکار
VOX -- رله با فرمان صوتی (VOX)
VSC -- کنترل پویش صدا (VSC)
XIT -- تنظیم افزایشی فرستنده (XIT).IP مقدار Func Status برای “activate” یک مقدار غیرصفر و در غیر این صورت برای “de-activate” برابر صفر است؛ دقیقاً مانند تعاریف TRUE/FALSE در زبان C (مقدار درست غیرصفر و مقدار نادرست صفر، ‘0’ است).

نکته: ارسال یک ‘?’ (پرس‌وجو) به عنوان نخستین آرگومان به‌جای شناسهٔ Func، فهرستی از شناسه‌های توابع تنظیم (set function) پشتیبانی‌شده توسط بک‌اند رادیو را که با فاصله از هم جدا شده‌اند، برمی‌گرداند. از این قابلیت برای تعیین توابع پشتیبانی‌شدهٔ یک بک‌اند رادیویی مشخص استفاده کنید.

u, get_func 'Func'

دریافت 'Func Status'.

مقدار Func Status را به صورت یک مقدار غیرصفر برای شناسهٔ Func داده‌شده، همانند set_func در بالا بازمی‌گرداند.

نکته: ارسال یک ‘?’ (پرس‌وجو) به عنوان نخستین آرگومان به‌جای شناسهٔ Func، فهرستی از شناسه‌های توابع دریافت (get function) پشتیبانی‌شده توسط بک‌اند رادیو را که با فاصله از هم جدا شده‌اند، برمی‌گرداند. از این قابلیت برای تعیین توابع پشتیبانی‌شدهٔ یک بک‌اند رادیویی مشخص استفاده کنید.

L, set_level 'Level' 'Level Value'

تنظیم '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 می‌تواند یک مقدار اعشاری یا عدد صحیح باشد. برای شناسهٔ AGC مقدار یکی از این موارد است: ‘0’ = OFF، ‘1’ = SUPERFAST، ‘2’ = FAST، ‘3’ = SLOW، ‘4’ = USER، ‘5’ = MEDIUM، ‘6’ = AUTO. توجه داشته باشید که همهٔ مقادیر روی همهٔ دستگاه‌ها کار نمی‌کنند. برای فهرست کردن مقادیر قابل استفاده، این دستور را اجرا کنید:

rigctl -m MODEL_ID -u | grep "AGC levels"

یا برای Windows:

rigctl -m MODEL_ID -u | find "AGC levels"

واحدهای Level

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)
اطلاعات خام از رادیو (Raw info from 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 مختص رادیو
METER -- SWR,COMP,ALC,IC/ID,DB,PO,VDD,TEMP یا می‌توان از اعداد بالای جدول مقادیر استفاده کرد؛ دستور l METER مقدار meter number=name را برمی‌گرداند
وات (Watts)
    RFPOWER_METER_WATTS
کلمه در دقیقه (WPM)
    KEYSPD

نکته: ارسال یک ‘?’ (پرس‌وجو) به عنوان نخستین آرگومان به‌جای شناسهٔ Level، فهرستی از شناسه‌های تنظیم سطح (set level) پشتیبانی‌شده توسط بک‌اند رادیو را که با فاصله از هم جدا شده‌اند، برمی‌گرداند. از این قابلیت برای تعیین سطوح پشتیبانی‌شدهٔ یک بک‌اند رادیویی مشخص استفاده کنید.

l, get_level 'Level'

دریافت 'Level Value'.

مقدار Level Value را به صورت یک مقدار اعشاری یا عدد صحیح برای شناسهٔ Level داده‌شده، همانند set_level در بالا بازمی‌گرداند.

نکته: ارسال یک ‘?’ (پرس‌وجو) به عنوان نخستین آرگومان به‌جای شناسهٔ Level، فهرستی از شناسه‌های دریافت سطح (get level) پشتیبانی‌شده توسط بک‌اند رادیو را که با فاصله از هم جدا شده‌اند، برمی‌گرداند. از این قابلیت برای تعیین سطوح پشتیبانی‌شدهٔ یک بک‌اند رادیویی مشخص استفاده کنید.

P, set_parm 'Parm' 'Parm Value'

تنظیم 'Parm' و 'Parm Value'.

شناسهٔ Parm یکی از موارد زیر است: ‘AFIF’, ‘AFIF_ACC’, ‘AFIF_LAN’, ‘AFIF_WLAN’, ‘ANN’, ‘APO’, ‘BACKLIGHT’, ‘BANDSELECT’, ‘BAT’, ‘BEEP’, ‘KEYERTYPE’, ‘KEYLIGHT’, ‘SCREENSAVER’, ‘TIME’.

نکته: ارسال یک ‘?’ (پرس‌وجو) به عنوان نخستین آرگومان به‌جای شناسهٔ Parm، فهرستی از شناسه‌های پارامترهای تنظیم (set parameter) پشتیبانی‌شده توسط بک‌اند رادیو را که با فاصله از هم جدا شده‌اند، برمی‌گرداند. از این قابلیت برای تعیین پارامترهای پشتیبانی‌شدهٔ یک بک‌اند رادیویی مشخص استفاده کنید.

ANN -- سطح «اعلان» (Announce)، ساختار ann_t را ببینید
APO -- خاموشی خودکار (Auto power off)، عدد صحیح برحسب دقیقه
BACKLIGHT -- روشنایی LCD، عدد اعشاری [0.0 ... 1.0]
BEEP -- بوق هنگام فشردن کلید، عدد صحیح (0,1)
TIME -- فرمت hh:mm:ss، عدد صحیح برحسب ثانیه از 00:00:00
BAT -- سطح باتری، عدد اعشاری [0.0 ... 1.0]
KEYLIGHT -- نور پس‌زمینه کلیدها، روشن/خاموش (on/off)
SCREENSAVER -- زمان‌بندی‌های خاموشی صفحهٔ نمایش مختص هر رادیو
AFIF -- مقدار 0=AF صوتی، 1=IF صوتی -- مدل‌های IC-7300/9700/705 را ببینید
BANDSELECT -- نام باند، مانند BAND160M، BAND80M.... قرار دادن ؟ به‌جای باند، گزینه‌های ممکن را نشان می‌دهد
KEYERTYPE -- نوع کلیدزن Icom به صورت 0,1,2 یا STRAIGHT,BUG,PADDLE

p, get_parm 'Parm' دریافت 'Parm Value'.

مقدار Parm Value را به‌صورت یک عدد اعشاری یا عدد صحیح برای نشانهٔ Parm داده‌شده، همان‌طور که در set_parm در بالا آمده است، برمی‌گرداند.

نکته: دادن یک ‘?’ (پرس‌وجو) به‌عنوان آرگومان نخست به‌جای نشانهٔ Parm، فهرستی از نشانه‌های پارامتر get پشتیبانی‌شده توسط بک‌اند رادیو را که با فاصله از هم جدا شده‌اند، برمی‌گرداند. از این برای تعیین پارامترهای پشتیبانی‌شدهٔ بک‌اند رادیویی مشخص استفاده کنید.

B, set_bank 'Bank'

تنظیم 'Bank'.

شمارهٔ بانک حافظهٔ فعلی را تنظیم می‌کند.

E, set_mem 'Memory#'

تنظیم شماره کانال 'Memory#'.

e, get_mem

دریافت شماره کانال 'Memory#'.

G, vfo_op 'Mem/VFO Op'

انجام یک 'Mem/VFO Op'.

عملیات Mem/VFO یک نشانه است: ‘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های پشتیبانی‌شدهٔ یک بک‌اند رادیویی مشخص استفاده کنید.

g, scan 'Scan Function' 'Scan Channel'

انجام یک 'Scan Function' روی یک 'Scan Channel'.

نشانهٔ 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های پشتیبانی‌شدهٔ یک بک‌اند رادیویی مشخص استفاده کنید.

H, set_channel 'Channel'

تنظیم داده‌های حافظهٔ 'Channel'.

اطلاعات کانال حافظه را تنظیم می‌کند.

h, get_channel 'Channel' 'readonly'

دریافت حافظهٔ کانال.

اگر readonly!=0 باشد تنها داده‌های کانال برگردانده می‌شوند و دستگاه روی کانال فعلی باقی می‌ماند. اگر readonly=0 باشد دستگاه روی کانال درخواستی تنظیم خواهد شد.

A, set_trn 'Transceive'

تنظیم حالت 'Transceive'.

نشانهٔ Transceive یکی از موارد روبرو است: ‘OFF’، ‘RIG’، ‘POLL’.

حالت Transceive سازوکاری است برای رادیوها تا بدون نیاز به درخواستی مشخص برای اطلاعات، رویدادها را گزارش دهند.

نکته: دادن یک ‘?’ (پرس‌وجو) به‌عنوان آرگومان نخست به‌جای نشانهٔ Transceive، فهرستی از نشانه‌های حالت Transceive پشتیبانی‌شده توسط بک‌اند رادیو را که با فاصله از هم جدا شده‌اند، برمی‌گرداند. از این برای تعیین حالت‌های Transceive پشتیبانی‌شدهٔ یک بک‌اند رادیویی مشخص استفاده کنید.

a, get_trn

دریافت حالت 'Transceive'.

حالت Transceive (گزارش‌دهی رویداد) همان‌طور که در set_trn در بالا آمده است.

*, reset 'Reset'

انجام 'Reset' دستگاه.

مقدار Reset یکی از این مقادیر است: ‘0’ = هیچ‌کدام (None)، ‘1’ = بازنشانی نرم‌افزاری (Software reset)، ‘2’ = بازنشانی VFO، ‘4’ = بازنشانی پاک‌کردن حافظه (Memory Clear reset)، ‘8’ = بازنشانی کلی (Master reset).

از آنجا که این مقادیر به‌صورت یک بیت‌ماسک در include/hamlib/rig.h تعریف شده‌اند، در صورت پشتیبانی بک‌اند یا در صورتی که اصلاً از عمل بازنشانی از طریق کنترل دستگاه پشتیبانی شود، امکان OR کردن این مقادیر با یکدیگر برای انجام هم‌زمان چندین بازنشانی وجود دارد.

0x87, set_powerstat 'Power Status'

تنظیم 'Power Status'.

مقدار Power Status یکی از این مقادیر است: ‘0’ = خاموش (Power Off)، ‘1’ = روشن (Power On)، ‘2’ = آماده‌به‌کار (Power Standby ‏- ورود به حالت آماده‌به‌کار)، ‘4’ = کارکرد فعال (Power Operate ‏- خروج از حالت آماده‌به‌کار).

0x88, get_powerstat

دریافت 'Power Status' همان‌طور که در set_powerstat در بالا آمده است.

0x89, send_dtmf 'Digits'

تنظیم 'Digits' DTMF.

0x8a, recv_dtmf

دریافت 'Digits' DTMF.

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

دریافت تمام پهنای‌باندهای پشتیبانی‌شده برای تمام حالت‌ها. 0xf7, get_mode_bandwidths 'Mode' پهنای باندهای 'Mode' را دریافت می‌کند. همچنین ببینید: get_modes.

dump_state

اطلاعات وضعیت مشخصی را در مورد بک‌اند رادیو بازمی‌گرداند.

1, dump_caps

یک دستور واقعی کنترل از راه دور دستگاه نیست؛ صرفاً قابلیت‌ها را تخلیه (dump) می‌کند، یعنی آنچه را که بک‌اند درباره این مدل می‌داند و کارهایی که می‌تواند انجام دهد.

اقدام لازم (TODO): اطمینان حاصل شود که خروجی در قالبی سازگار باشد تا بتوان آن را در یک هش، دیکشنری یا موارد مشابه خواند. ارسال گزارش باگ درخواست می‌شود.

نکته: این دستور خطوط خروجی بسیار زیادی تولید خواهد کرد، بنابراین در صورت استفاده از یک آرایه با طول ثابت بسیار دقت کنید! برای مثال، اجرای این دستور در برابر بک‌اند Dummy منجر به بیش از ۵ کیلوبایت خروجی متنی می‌شود.

پارامتر VFO در «حالت VFO» استفاده نمی‌شود.

2, power2mW 'Power [0.0..1.0]' 'Frequency' 'Mode'

مقدار 'Power mW' را بازمی‌گرداند.

یک مقدار Power در بازهٔ 0.0...1.0 را به توان ارسال واقعی بر حسب میلی‌وات (عدد صحیح) تبدیل می‌کند.

همچنین لازم است مقادیر 'Frequency' و 'Mode' ارائه شوند، زیرا ممکن است توان خروجی بر اساس این مقادیر متغیر باشد.

پارامتر VFO در حالت VFO استفاده نمی‌شود.

3, dump_conf

یک دستور واقعی کنترل از راه دور دستگاه نیست؛ صرفاً پیکربندی فعلی را همراه با بازه‌های مجاز مقادیر تخلیه (dump) می‌کند.

4, mW2power 'Power mW' 'Frequency' 'Mode'

مقدار 'Power [0.0..1.0]' را بازمی‌گرداند.

توان ارسال واقعی بر حسب میلی‌وات (عدد صحیح) را به یک مقدار Power در بازهٔ 0.0 ... 1.0 تبدیل می‌کند.

همچنین لازم است مقادیر 'Frequency' و 'Mode' ارائه شوند، زیرا ممکن است توان خروجی بر اساس این مقادیر متغیر باشد.

پارامتر VFO در حالت VFO استفاده نمی‌شود.

w, send_cmd 'Cmd'

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

این دستور برای آزمایش و عیب‌یابی دستورات و پاسخ‌های رادیو هنگام توسعهٔ یک بک‌اند مفید است.

برای پروتکل‌های باینری مقادیر را به صورت \0xAA\0xBB وارد کنید. منتظر یک 'Reply' از سوی رادیو باشید که بسته به پروتکل رادیو، احتمالاً یک بلوک باینری یا یک رشتهٔ ASCII خواهد بود (مستندات کنترل رایانه‌ای رادیوی خود را ببینید). اگر در حال آزمایش پروتکلی مانند SmartSDR هستید که در دستورات آن فاصله (space) وجود دارد، از علامت نقل‌قول استفاده کنید، مثلاً: w "C0|set slice 0 tx=1"

پایان‌دهندهٔ دستور، که با گزینهٔ send-cmd-term در بالا تعیین می‌شود، به هر رشته دستور ارسال‌شده به رادیو خاتمه می‌دهد. این نویسه نباید بخشی از رشتهٔ ورودی باشد.

W, send_cmd_rx 'Cmd' nbytes_or_terminator_char

یک رشته دستور خام را به رادیو ارسال کرده و منتظر بازگشت nbytes بایت یا نویسهٔ پایان‌دهنده (مانند ;) می‌ماند.

این دستور برای آزمایش و عیب‌یابی دستورات و پاسخ‌های رادیو هنگام توسعهٔ یک بک‌اند مفید است. اگر تعداد بایت‌های درخواستی <= تعداد بایت‌های بازگردانده شده در واقعیت باشد، هیچ وقفه‌ای (timeout) رخ نخواهد داد. اگر یک نویسه ارائه شود، از آن برای پایان دادن به خواندن رشته استفاده خواهد شد؛ برای نمونه ';' برای دستورات Kenwood/Yaesu رایج است.

آرگومان دستور نمی‌تواند شامل فاصله باشد. برای پروتکل‌های باینری مقادیر را به صورت \0xAA\0xBB وارد کنید. منتظر یک 'Reply' از سوی رادیو باشید که بسته به پروتکل رادیو، احتمالاً یک بلوک باینری یا یک رشتهٔ ASCII خواهد بود (مستندات کنترل رایانه‌ای رادیوی خود را ببینید).

پایان‌دهندهٔ دستور، که با گزینهٔ send-cmd-term در بالا تعیین می‌شود، به هر رشته دستور ارسال‌شده به رادیو خاتمه می‌دهد. این نویسه نباید بخشی از رشتهٔ ورودی باشد.

set_clock 'DateTime'

تنظیم 'DateTime'

ساعت دستگاه را تنظیم می‌کند -- توجه داشته باشید که برخی دستگاه‌ها ثانیه یا میلی‌ثانیه را پردازش نمی‌کنند. اگر سعی در تنظیم ثانیه/میلی‌ثانیه داشته باشید و دستگاه از آن پشتیبانی نکند، یک پیام هشدار اشکال‌زدایی دریافت خواهید کرد. قالب بر اساس 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 (تنها تاریخ را تنظیم می‌کند)
local (هر دو ساعت را روی ساعت محلی تنظیم می‌کند)
utc (هر دو ساعت را روی ساعت utc تنظیم می‌کند)

نکته: دستگاه‌های Icom انتظار دارند که ساعت محلی و میزان اختلاف ساعت با UTC را تنظیم کنید. بنابراین... برای نمونه ساعت ۴ بعدازظهر به وقت EST به صورت 2021-12-01T16:00:00-0500 خواهد بود. اما... اگر می‌خواهید GMT نمایش داده شود، باید ساعت را برای GMT با اختلاف صفر نسبت به UTC تنظیم کنید. امید است که در آینده Icom امکان نمایش هر یک از دو ساعت را فراهم کند.

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

get_clock

دریافت 'RigTime'

ساعت دستگاه را دریافت می‌کند -- توجه داشته باشید که برخی دستگاه‌ها ثانیه یا میلی‌ثانیه را پردازش نمی‌کنند. قالب بر اساس ISO8601 به صورت YYYY-MM-DDTHH:MM:SS.sss+ZZ است که در آن +ZZ اختلاف -/+ با UTC می‌باشد.

chk_vfo

دریافت 'Status'

اگر گزینهٔ vfo روشن باشد Status را ۱ و اگر خاموش باشد ۰ بازمی‌گرداند. این دستور منعکس‌کنندهٔ سوییچ -o برای rigctl و rigctld است و می‌تواند به صورت پویا توسط set_vfo_opt تغییر داده شود.

set_vfo_opt 'Status'

تنظیم 'Status'

تنظیم وضعیت (Status) گزینهٔ vfo به صورت 1=on یا 0=off. این معادل استفاده از سوییچ -o برای rigctl و rigctld است. این مقدار را می‌توان به صورت پویا در زمان اجرا تغییر داد.

set_separator 'SeparatorChar'

تنظیم 'SeparatorChar'

پاسخ rigctld را به جای خط جدید (newline) به استفاده از یک نویسهٔ ویژه تغییر می‌دهد (استفاده از # توصیه می‌شود). برای گرهٔ tcprequest در node-red کاربردی است. این مقدار را می‌توان به صورت پویا در زمان اجرا تغییر داد.

get_separator

دریافت 'SeparatorChar'

مقدار فعلی SeparatorChar را نمایش می‌دهد.

pause 'Seconds'

پیش از ارسال دستور بعدی به رادیو، به تعداد عدد صحیح داده‌شده از 'Seconds' (ثانیه) مکث می‌کند.

password 'Password'

هنگامی که rigctld با گزینهٔ -A ایمن‌سازی شده باشد، گذرواژه را به rigctld ارسال می‌کند. باید از کلید مشترک (shared secret) ۳۲ نویسه‌ای مربوط به rigctld استفاده شود. (پیاده‌سازی نشده است / NOT IMPLEMENTED)

set_lock_mode 'Locked'

قفل حالت (mode lock) را فعال (1) یا غیرفعال (0) می‌کند (تنها هنگام استفاده از rigctld). فعال کردن آن مانع از تغییر حالت دستگاه توسط تمام کلاینت‌ها می‌شود. برای نمونه، این قابلیت هنگام اجرای CW Skimmer در حالت FM روی یک IC-7300 کاربردی است. در صورت فعال بودن قفل، کلیک کردن روی spotها در یک برنامهٔ spotting، حالت VFOA را تغییر نخواهد داد. بنابراین هنگام شروع CW Skimmer دستور "set_lock_mode 1" و هنگام توقف CW Skimmer دستور "set_lock_mode 0" را اجرا کنید.

get_lock_mode

وضعیت فعلی قفل حالت را بازمی‌گرداند: 1=On (روشن)، 2=Off (خاموش) (تنها هنگام استفاده از rigctld کاربرد دارد). send_raw 'Terminator' 'String' می‌تواند یک رشته ASCII یا مقادیر 0xnn یا مقادیر xnn را ارسال کند -- هیچ فاصله‌ای نباید در رشته دستور وجود داشته باشد. مقادیر ممکن برای terminator عبارتند از CR، LF، ;، ICOM، 0-100 (بایت‌ها برای خواندن)، یا -1 به معنی ناشناخته (در خواندن دچار وقفه زمانی خواهد شد) مثال‌ها (توجه داشته باشید که ; در Unix/Linux باید گریز داده شود (escape شود)):

برای 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

client_version 'String'

کلاینت می‌تواند نسخه خود را به rigctld ارسال کرده و بازخوردی در مورد سازگاری، منسوخ‌شدن و گزینه‌های جایگزین دریافت کند

hamlib_version

نسخه Hamlib را به همراه تاریخ/زمان ISO8601 بازمی‌گرداند

test

روال‌های آزمایشی را اجرا می‌کند. در حال توسعه است.

set_gpio 'GPIO#' '0/1'

مقدارهای GPIO1، GPIO2، GPIO3 و GPIO4 را روی درگاه GPIO ptt تنظیم می‌کند همچنین می‌توان از 1,2,3,4 استفاده کرد

get_gpio 'GPIO#'

مقدارهای GPIO1، GPIO2، GPIO3 و GPIO4 را روی درگاه GPIO ptt می‌خواند همچنین می‌توان از 1,2,3,4 استفاده کرد

skip_init

از مقداردهی اولیه rig صرف‌نظر می‌کند -- هنگام اجرای دستورها با rigctl برای افزایش سرعت مفید است

پروتکل (PROTOCOL)

دو پروتکل توسط rigctld مورد استفاده قرار می‌گیرد، Default Protocol و Extended Response Protocol.

پروتکل Default Protocol در درجه اول برای ارتباط بین توابع کتابخانه Hamlib و rigctld طراحی شده است (“NET rigctl”، که با استفاده از مدل رادیویی ‘2’ در دسترس است).

پروتکل Extended Response Protocol برای استفاده در اسکریپت‌ها یا سایر برنامه‌هایی که مستقیماً با rigctld در تعامل هستند در نظر گرفته شده است زیرا بازخورد هماهنگ و یکنواختی ارائه می‌دهد.

print $socket "F 14250000\n";
print $socket "\\set_mode LSB 2400\n";   # escape leading '\'

print $socket "f\n";
"14250000\n"

$ echo "+M USB 2400" | nc -w 1 localhost 4532
set_mode: USB 2400
RPRT 0

$ echo "+\get_mode" | nc -w 1 localhost 4532
get_mode:
Mode: USB
Passband: 2400
RPRT 0

get_mode:;Mode: USB;Passband: 2400;RPRT 0

get_mode:|Mode: USB|Passband: 2400|RPRT 0

set_mode: USB 2400|RPRT 0

مثال‌ها (EXAMPLES)

راه‌اندازی rigctld برای یک Yaesu FT-920 با استفاده از مبدل USB به سریال و ارسال آن به پس‌زمینه:

$ rigctld -m 1014 -r /dev/ttyUSB1 &

راه‌اندازی rigctld برای یک Yaesu FT-920 با استفاده از مبدل USB به سریال همراه با تنظیم baud rate و stop bits، و ارسال آن به پس‌زمینه:

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

راه‌اندازی rigctld برای یک Elecraft K3 با استفاده از COM2 در MS Windows:

$ rigctld -m 2029 -r COM2

اتصال به rigctld در حال اجرا و تنظیم فرکانس روی 14.266 مگاهرتز با مهلت زمانی خواندن ۱ ثانیه، با استفاده از پروتکل پیش‌فرض از خط فرمان شل:

$ echo "\set_freq 14266000" | nc -w 1 localhost 4532

اتصال به یک rigctld در حال اجرا با rigctl روی میزبان محلی:

$ rigctl -m2

امنیت (SECURITY)

هیچ‌گونه احراز هویتی وجود ندارد؛ این درگاه TCP را به هیچ وجه روی اینترنت باز نگذارید. لطفاً در صورت نیاز به امنیت قوی‌تر موضوع را مطرح کنید یا استفاده از یک تونل Secure Shell (ssh(1)) را مد نظر قرار دهید.

از آنجا که rigctld به هیچ مجوزی فراتر از rigctl نیاز ندارد، توصیه می‌شود به منظور محدود ساختن هرگونه آسیب‌پذیری، rigctld با کاربر “root” یا حساب کاربری سیستمی دیگری اجرا نشود.

گزارش باگ‌ها (BUGS)

دیمن به طور خودکار از ترمینال جدا نشده و به پس‌زمینه نمی‌رود.

استفاده هم‌زمان چندین کلاینت از این دیمن ممکن است منجر به تداخل (contention) با رادیوی متصل شود.

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

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

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

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

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

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

kill(1), rigctl(1), ssh(1), hamlib(7)

شناسنامه (COLOPHON)

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