.\" 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, rigctl.c .\" .TH RIGCTL "1" "2026-01-06" "Hamlib" "Hamlib Utilities" . . .SH "نام (NAME)" . rigctl \- کنترل فرستنده‌گیرنده‌ها و گیرنده‌های رادیویی . . .SH "خلاصه دستور (SYNOPSIS)" . .SY rigctl .OP \-hiIlLnouV .OP \-m id .OP \-r device .OP \-p device .OP \-d device .OP \-P type .OP \-D type .OP \-s baud .OP \-c id .OP \-t char .OP \-C parm=val .RB \-Y .RB [ \-v [ \-Z ]] .RB [ command | \- ] .YS . . .SH "توضیحات (DESCRIPTION)" . فرستنده‌گیرنده‌ها و گیرنده‌های رادیویی را کنترل می‌کند. .B rigctl دستورها را از خط فرمان و همچنین در صورتی که هیچ دستوری در خط فرمان ارائه نشده باشد، در حالت تعاملی می‌پذیرد. . .PP به یاد داشته باشید که Hamlib نرم‌افزاری در سطح آزمایشی (BETA) است. گرچه بسیاری از کتابخانه‌های backend فاقد پشتیبانی کامل از رادیو هستند، عملکردهای پایه معمولاً به خوبی پشتیبانی می‌شوند. . .PP لطفاً باگ‌ها را گزارش کرده و بازخوردها را به نشانی ایمیل ارائه‌شده در بخش .B "گزارش باگ‌ها (BUGS)" در زیر ارسال کنید. وصله‌ها و بهبودهای کد ارسالی به همین نشانی نیز مورد استقبال قرار می‌گیرند. . . .SH "گزینه‌ها (OPTIONS)" . این برنامه از نحو معمول خط فرمان GNU پیروی می‌کند. گزینه‌های کوتاهی که آرگومان می‌گیرند، می‌توانند مقدار را بلافاصله پس از خود داشته باشند یا با یک فاصله از آن جدا شوند. گزینه‌های بلندی که با دو خط تیره (\(oq\-\-\(cq) آغاز می‌شوند، نیازمند یک \(oq=\(cq میان گزینه و آرگومان هستند. . .PP در اینجا خلاصه‌ای از گزینه‌های پشتیبانی‌شده آمده است: . .TP .BR \-m ", " \-\-model = \fIid\fP انتخاب شماره مدل رادیو. پیش‌فرض، dummy rig (رادیوی مجازی) است. .IP فهرست مدل‌ها را ببینید (از \(lqrigctl -l\(rq استفاده کنید). .IP .BR نکته : .B rigctl (یا نرم‌افزارهای شخص ثالثی که از C API استفاده می‌کنند) از مدل رادیویی ۲ برای .B NET rigctl (جهت برقراری ارتباط با .BR rigctld ) استفاده خواهند کرد. . .TP .BR \-r ", " \-\-rig\-file = \fIdevice\fP استفاده از .I device به‌عنوان نام فایل درگاهی که به رادیو متصل است. .IP معمولاً .IR /dev/ttyS0 "، " /dev/ttyS1 "، " /dev/ttyUSB0 و غیره در لینوکس، و .IR COM1 "، " COM2 و غیره در MS Windows. مشتقات BSD و Mac OS/X نام‌گذاری‌های خاص خود را دارند. به مستندات سیستم خود مراجعه کنید. .IP می‌تواند یک نشانی شبکه:درگاه باشد، مانند .IR 127.0.0.1:12345 .IP رشتهٔ ویژهٔ \(lquh\-rig\(rq می‌تواند برای فعال‌سازی پشتیبانی از دستگاه micro-ham ارائه شود. . .TP .BR \-p ", " \-\-ptt\-file = \fIdevice\fP استفاده از .I device به‌عنوان نام فایل دستگاه Push-To-Talk با استفاده از یک فایل دستگاه به‌گونه‌ای که در بالا توضیح داده شد. . .TP .BR \-d ", " \-\-dcd\-file = \fIdevice\fP استفاده از .I device به‌عنوان نام فایل دستگاه Data Carrier Detect با استفاده از یک فایل دستگاه به‌گونه‌ای که در بالا توضیح داده شد. . .TP .BR \-P ", " \-\-ptt\-type = \fItype\fP استفاده از .I type (نوع) برای دستگاه Push-To-Talk. .IP نوع‌های پشتیبانی‌شده عبارتند از \(oqRIG\(cq (دستور CAT)،‏ \(oqDTR\(cq،‏ \(oqRTS\(cq،‏ \(oqPARALLEL\(cq،‏ \(oqCM108\(cq،‏ \(oqGPIO\(cq،‏ \(oqGPION\(cq،‏ \(oqNONE\(cq، که نوع PTT تعریف‌شده در backend رادیو را بازنویسی (override) می‌کنند. .IP برخی از اثرات جانبی این دستور آن است که با تنظیم نوع روی DTR، وضعیت خوانده‌شدهٔ PTT از سمت frontend در .B Hamlib می‌آید و از رادیو خوانده نمی‌شود. در صورت تنظیم روی NONE، وضعیت PTT حتی اگر backend رادیو از خواندن/تنظیم وضعیت PTT دستگاه پشتیبانی کند، قابل خواندن یا تنظیم نخواهد بود. . .TP .BR \-D ", " \-\-dcd\-type = \fItype\fP استفاده از .I type (نوع) برای دستگاه Data Carrier Detect. .IP نوع‌های پشتیبانی‌شده عبارتند از \(oqRIG\(cq (دستور CAT)،‏ \(oqDSR\(cq،‏ \(oqCTS\(cq،‏ \(oqCD\(cq،‏ \(oqPARALLEL\(cq،‏ \(oqCM108\(cq،‏ \(oqGPIO\(cq،‏ \(oqGPION\(cq،‏ \(oqNONE\(cq. . .TP .BR \-s ", " \-\-serial\-speed = \fIbaud\fP تنظیم سرعت سریال روی نرخ .IR baud . .IP به‌طور پیش‌فرض از بیشینه سرعت سریال بر اساس قابلیت‌های backend رادیو (تعیین‌شده توسط .B \-m در بالا) استفاده می‌کند. . .TP .BR \-c ", " \-\-civaddr = \fIid\fP استفاده از .I id به‌عنوان نشانی CI-V برای ارتباط با رادیو. .IP تنها برای رادیوهای Icom و برخی از رادیوهای Ten-Tec کاربرد دارد. .IP .BR نکته : شناسهٔ .I id در قالب ده‌دهی (decimal) است، مگر آنکه پیشوند .IR 0x داشته باشد که در آن صورت در مبنای شانزده (hexadecimal) خواهد بود. . .TP .BR \-t ", " \-\-send\-cmd\-term = \fIchar\fP تغییر نویسهٔ پایانی .I char برای پروتکل متنی در هنگام استفاده از دستور .BR send_cmd . .IP مقدار پیش‌فرض ASCII CR (\(oq0x0D\(cq) است. نویسه‌های غیرقابل‌چاپ ASCII را می‌توان به صورت کد ASCII در قالب مبنای شانزده همراه با پیشوند \(lq0x\(rq وارد کرد. برای نداشتن نویسهٔ پایانی می‌توانید یک رشتهٔ خالی ارسال کنید. رشتهٔ \(lq\-1\(rq به .B rigctl می‌گوید که به پروتکل باینری جابه‌جا شود. برای توضیحات بیشتر به دستور .B send_cmd مراجعه کنید. .IP برای نمونه، جهت مشخص کردن پایان‌دهندهٔ دستور در دستورهای متنی به سبک Kenwood، عبارت \(lq-t ';'\(rq را به rigctl بدهید. بخش .B "مثال‌ها (EXAMPLES)" را در زیر ببینید. ..TP .BR \-L ", " \-\-show\-conf فهرست کردن تمامی پارامترهای پیکربندی برای رادیوی تعریف‌شده با .B \-m در بالا. . .TP .BR \-C ", " \-\-set\-conf = \fIparm=val\fP [ \fI,parm=val\fP ] تنظیم پارامتر(های) پیکربندی. برخی از موارد رایج عبارت‌اند از: .in +4 .EX .BR async: "مقدار True انتقال ناهمگام داده را برای بک‌اندهایی که از آن پشتیبانی می‌کنند فعال می‌سازد. این کار امکان استفاده از داده‌های transceive و طیف را فراهم می‌کند." .BR auto_power_on: "مقدار True امکان روشن شدن رادیوهای سازگار را هنگام باز شدن ارتباط فعال می‌کند" .BR auto_power_off: "مقدار True امکان خاموش شدن رادیوهای سازگار را هنگام بسته شدن ارتباط فعال می‌کند" .BR auto_disable_screensaver: "مقدار True محافظ صفحهٔ رادیوهای سازگار را هنگام باز شدن غیرفعال می‌کند" .BR dcd_type: "بازنویسی نوع رابط Data Carrier Detect (یا اسکوئلچ)" .BR dcd_pathname: "مسیر فایل دستگاه مربوط به Data Carrier Detect (یا اسکوئلچ)" .BR disable_yaesu_bandselect: "مقدار True انتخاب خودکار باند هنگام تغییر باند را برای رادیوهای Yaesu غیرفعال می‌کند" .BR dtr_state: "مقدار ON سیگنال DTR را روشن، OFF آن را خاموش، و Unset آن را غیرفعال می‌کند" .BR freq_skip: "مقدار !=0 از تنظیم فرکانس روی TX_VFO در هنگام RX و روی RX_VFO در هنگام TX صرف‌نظر می‌کند -- برای استفاده با gpredict و رادیوهایی که TARGETABLE_VFO ندارند" .BR lo_freq: "فرکانسی که برای استفاده با یک ترانسورتر به فرکانس VFO افزوده می‌شود" .BR post_write_delay: "تأخیر بر حسب میلی‌ثانیه بین هر دستور ارسال‌شده" .BR ptt_share: "مقدار True اشتراک‌گذاری درگاه ptt را با سایر برنامه‌ها فعال می‌کند" .BR ptt_type: "بازنویسی نوع رابط Push-To-Talk" .BR ptt_pathname: "مسیر فایل دستگاه مربوط به Push-To-Talk" .BR ptt_bitnum: "شماره بیت GPIO برای Push-To-Talk" .BR retry: "حداکثر تعداد تلاش مجدد" .BR rts_state: "مقدار ON سیگنال DTR را روشن، OFF آن را خاموش، و Unset آن را غیرفعال می‌کند" .BR twiddle_timeout: "برای عملیات ماهواره‌ای، هنگامی که VFOB دستکاری شود دستورات VFOB را تا پایان مهلت متوقف می‌کند" .BR twiddle_rit: "جلوگیری از اجرای get_freq روی VFOB برای تنظیم ماهواره‌های دارای RIT" .BR timeout: "مهلت زمانی بر حسب میلی‌ثانیه" .BR write_delay: "تأخیر بر حسب میلی‌ثانیه بین هر بایت ارسال‌شده" .BR tuner_control_pathname: "مسیر فایل اسکریپت/برنامه برای کنترل تیونر با ۱ آرگومان 0/1 جهت خاموش/روشن کردن تیونر" .EE .in .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 در Windows، فهرست را به عقب پیمایش کرد. همچنین خروجی را می‌توان به .BR more (1) یا .BR less (1) هدایت (pipe) کرد؛ مانند \(lqrigctl -l | more\(rq. . .TP .BR \-o ", " \-\-vfo فعال کردن حالت vfo. .IP یک آرگومان VFO اضافی پیش از هر دستور مربوطه (به‌جز .BR set_vfo ) لازم خواهد بود. در غیر این صورت، هنگامی که این گزینه تنظیم نشده باشد و آرگومان VFO اضافی استفاده نشود، \(oqcurrVFO\(cq به کار می‌رود. . .TP .BR \-n ", " \-\-no\-restore\-ai هنگام خروج، .B rigctl وضعیت اطلاع‌رسانی خودکار (AI) را روی رادیوی تحت کنترل بازیابی می‌کند. .IP اگر این رفتار مورد نظر نیست، مثلاً اگر از .B rigctl برای روشن یا خاموش کردن حالت AI استفاده می‌کنید، این گزینه را ارسال کنید. . .TP .BR \-i ", " \-\-read\-history خواندن تاریخچهٔ دستورها و آرگومان‌های ذخیره‌شدهٔ قبلی از یک فایل (پیش‌فرض: .IR $HOME/.rigctl_history ) برای نشست فعلی. .IP زمانی در دسترس است که .B rigctl با پشتیبانی از Readline ساخته شده باشد (بخش READLINE را در زیر ببینید). .IP .BR نکته : برای خواندن فایل تاریخچه ذخیره‌شده در یک دایرکتوری دیگر، متغیر محیطی .B RIGCTL_HIST_DIR را تنظیم کنید؛ برای مثال: \(lqRIGCTL_HIST_DIR=~/tmp rigctl -i\(rq. هنگامی که RIGCTL_HIST_DIR تنظیم نشده باشد، مقدار .B HOME استفاده می‌شود. . .TP .BR \-I ", " \-\-save\-history نوشتن تاریخچهٔ دستورها و آرگومان‌های نشست فعلی (و نشست(های) قبلی، در صورت استفاده از گزینهٔ .B -i ) در یک فایل (پیش‌فرض: .IR $HOME/.rigctl_history ) در پایان نشست فعلی. .IP دستورهای کامل همراه با آرگومان‌هایشان به صورت یک خط واحد ذخیره می‌شوند تا بتوان آنها را بازخوانی، استفاده یا ویرایش کرد. زمانی در دسترس است که .B rigctl با پشتیبانی از Readline ساخته شده باشد (بخش .B READLINE را در زیر ببینید). .IP .BR نکته : برای نوشتن فایل تاریخچه در دایرکتوری دیگر، متغیر محیطی .B RIGCTL_HIST_DIR را تنظیم کنید؛ مانند \(lqRIGCTL_HIST_DIR=~/tmp rigctl -I\(rq. هنگامی که RIGCTL_HIST_DIR تنظیم نشده باشد، مقدار .B HOME استفاده می‌شود. . .TP .BR \-v ", " \-\-verbose تنظیم حالت پرگو (verbose)، به صورت تجمعی (بخش .B خطاها (DIAGNOSTICS) در زیر را ببینید). .TP .BR \-Y "," \-\-\ignore\-err نادیده گرفتن خطاهای باز کردن رادیو . .TP .BR \-Z ", " \-\-debug\-time\-stamps فعال‌سازی برچسب‌های زمانی برای پیام‌های اشکال‌زدایی. .IP تنها در ترکیب با گزینهٔ .B -v استفاده شود، زیرا به خودی خود هیچ خروجی‌ای تولید نمی‌کند. . .TP .BR \-h ", " \-\-help نمایش خلاصه‌ای از این گزینه‌ها و خروج. . .TP .BR \-V ", " \-\-version نمایش نسخهٔ .B rigctl و خروج. . .TP .BR \-! ", " \-\-cookie تنظیم کوکی مورد استفاده برای امنیت دسترسی از راه دور . .TP .BR \-# ", " \-\-skip_init صرف‌نظر کردن از بیشتر مقداردهی‌های اولیه هنگام راه‌اندازی. . .TP .B \- توقف پردازش گزینه‌ها و خواندن دستورها از ورودی استاندارد. .IP بخش .B ورودی استاندارد (Standard Input) در زیر را ببینید. . .PP .BR نکته : ممکن است برخی گزینه‌ها توسط یک بک‌اند مشخص پیاده‌سازی نشده باشند و خطایی را بازگردانند. این وضعیت بیش از همه برای گزینه‌های .B \-\-set\-conf و .B \-\-show\-conf رخ می‌دهد. . .PP لطفاً توجه داشته باشید که ممکن است بک‌اند مربوط به رادیوی تحت کنترل، یا خود رادیو از برخی دستورها پشتیبانی نکنند. در این صورت، عملیات با یک کد خطای .B Hamlib با شکست مواجه خواهد شد. . ..SH "دستورها (COMMANDS)" . دستورها می‌توانند به صورت یک نویسه تک یا به صورت یک نام کامل دستور وارد شوند. برخلاف گزینه‌ها، پیشوند خط تیره به دستورها اضافه نمی‌شود. آن‌ها ممکن است در حالت تعاملی تایپ شوند یا به عنوان آرگومان در حالت رابط خط فرمان ارائه گردند. در حالت تعاملی، دستورها و آرگومان‌های آن‌ها را می‌توان در یک خط تکی وارد کرد: . .PP .in +4n .EX .B M LSB 2400 .EE .in . .PP از آنجا که بیشتر عملیات‌های .B Hamlib دارای متدهای .BR set " و " get هستند، از یک حرف بزرگ لاتین برای متدهای .B set استفاده می‌شود؛ در حالی که حرف کوچک متناظر با آن به متد .B get اشاره دارد. هر عملیات نام بلندی نیز دارد؛ در حالت تعاملی، یک بک‌اسلش، \(oq\\\(cq، را در ابتدا قرار دهید تا یک نام دستور بلند با حروف کوچک وارد شود. . .PP مثال: از \(lq\\dump_caps\(rq برای مشاهدهٔ اینکه این رادیو و backend از چه قابلیت‌هایی پشتیبانی می‌کنند استفاده کنید. . .IP .BR نکته : بک‌اندِ رادیویی که باید کنترل شود یا خود رادیو ممکن است از برخی دستورها پشتیبانی نکنند. در این صورت، عملیات با یک پیام خطای .B Hamlib شکست خواهد خورد. . . .SS "ورودی استاندارد (Standard Input)" . به عنوان جایگزینی برای ورود تعاملی دستورها با .B READLINE یا اجرای یک دستور تکی در هر بار اجرا، .B rigctl دارای یک گزینهٔ ویژه است که در آن می‌توان از یک خط تیره تنها (\(oq\-\(cq) برای خواندن دستورها از ورودی استاندارد .RB ( stdin ) استفاده کرد. دستورها باید مشابه دستورهای داده شده در خط فرمان، با فاصله (whitespace) جدا شوند. توضیحات را می‌توان با استفاده از نویسهٔ \(oq#\(cq اضافه کرد؛ تمام متن تا انتهای خط جاری شامل نویسهٔ \(oq#\(cq نادیده گرفته می‌شود. . .PP یک مثال ساده (متن تایپ‌شده برجسته است): . .PP .in +4n .EX .RB $ " cat <<.EOF. >cmds.txt" .RB > " # File of commands" .RB > " v f m # query rig" .RB > " V VFOB F 14200000 M CW 500 # set rig" .RB > " v f m # query rig" .RB > " .EOF." .RB $ " rigctl -m1 - 0 شماره آنتن بر مبنای ۱ هستند (\(oq1\(cq، \(oq2\(cq، \(oq3\(cq، ...). .IP مقدار Option بازگردانده‌شده به رادیو بستگی دارد. برای Icom احتمالاً پرچم RX only است. . .TP .BR b ", " send_morse " \(aq" \fIMorse\fP \(aq ارسال نمادهای .RI \(aq Morse \(aq. برای رادیوهای Yaesu از memory# (۱-۵ برای بیشتر رادیوها) یا پیامی حداکثر تا ۵۰ نویسه (که از memory#1 استفاده خواهد کرد) استفاده کنید مثال از خط فرمان: .EX rigctl -m 3073 -r /dev/ttyUSB0 b "CQ CQ DE ME" .EE مثال Yaesu برای ارسال message#1: .EX rigctl -m 1035 -r /dev/ttyUSB0 b 1 .EE . .TP .BR 0xbb ", " stop_morse " توقف ارسال کد مورس فعلی. . .TP .BR 0xbc ", " wait_morse " انتظار برای پایان یافتن مورس \-\- فقط در حالت full break-in کار می‌کند. . .TP .BR 0x94 ", " send_voice_mem " \(aq" \fIMsgnum\fP \(aq دستور به رادیو برای ارسال پیام داخلی .RI \(aq Msgnum \(aq . .TP .BR 0xab ", " stop_voice_mem توقف ارسال پیام داخلی . .TP .BR 0x8b ", " get_dcd دریافت وضعیت .RI \(aq DCD \(aq (squelch): \(oq0\(cq (بسته) یا \(oq1\(cq (باز). . .TP .BR 0x8d ", " set_twiddle " \(aq" \fITimeout\fP \(aq تنظیم .RI \(aq Timeout \(aq twiddle به ثانیه. . .TP .BR 0x8e ", " get_twiddle دریافت .RI \(aq Timeout \(aq twiddle به ثانیه. . .TP .BR R ", " set_rptr_shift " \(aq" "\fIRptr Shift\fP" \(aq تنظیم .RI \(aq "Rptr Shift" \(aq. .IP مقدار Rptr Shift یکی از این موارد است: \(oq+\(cq، \(oq-\(cq، یا مقداری دیگر برای \(oqNone\(cq. . .TP .BR r ", " get_rptr_shift دریافت .RI \(aq "Rptr Shift" \(aq. .IP مقدار \(oq+\(cq، \(oq-\(cq، یا \(oqNone\(cq را برمی‌گرداند. . .TP .BR O ", " set_rptr_offs " \(aq" "\fIRptr Offset\fP" \(aq تنظیم .RI \(aq "Rptr Offset" \(aq، به هرتز. ..TP .BR o ", " get_rptr_offs دریافت .RI \(aq "Rptr Offset" "\(aq،" بر حسب هرتز. . .TP .BR C ", " set_ctcss_tone " \(aq" "\fICTCSS Tone\fP" \(aq تنظیم .RI \(aq "CTCSS Tone" "\(aq،" بر حسب دهم هرتز. . .TP .BR c ", " get_ctcss_tone دریافت .RI \(aq "CTCSS Tone" "\(aq،" بر حسب دهم هرتز. . .TP .BR D ", " set_dcs_code " \(aq" "\fIDCS Code\fP" \(aq تنظیم .RI \(aq "DCS Code" \(aq. . .TP .BR d ", " get_dcs_code دریافت .RI \(aq "DCS Code" \(aq. . .TP .BR 0x90 ", " set_ctcss_sql " \(aq" "\fICTCSS Sql\fP" \(aq تنظیم تن .RI \(aq "CTCSS Sql" "\(aq،" بر حسب دهم هرتز. . .TP .BR 0x91 ", " get_ctcss_sql دریافت تن .RI \(aq "CTCSS Sql" "\(aq،" بر حسب دهم هرتز. . .TP .BR 0x92 ", " set_dcs_sql " \(aq" "\fIDCS Sql\fP" \(aq تنظیم کد .RI \(aq "DCS Sql" \(aq. . .TP .BR 0x93 ", " get_dcs_sql دریافت کد .RI \(aq "DCS Sql" \(aq. . .TP .BR 0x95 ", " set_cache " \(aq" "\fITimeout\fP" \(aq تنظیم مهلت حافظهٔ پنهان بر حسب میلی‌ثانیه. . .TP .BR 0x96 ", " get_cache دریافت مهلت حافظهٔ پنهان بر حسب میلی‌ثانیه. . .TP .BR 0x97 ", " uplink " \(aq" "\fIUplink\fP" \(aq تنظیم VFO آپ‌لینک روی .RI \(aq Uplink \(aq (1=Sub، 2=Main). . .TP .BR N ", " set_ts " \(aq" "\fITuning Step\fP" \(aq تنظیم .RI \(aq "Tuning Step" "\(aq،" بر حسب هرتز. . .TP .BR n ", " get_ts دریافت .RI \(aq "Tuning Step" "\(aq،" بر حسب هرتز. . .TP .BR U ", " set_func " \(aq" \fIFunc\fP "\(aq \(aq" "\fIFunc Status\fP" \(aq تنظیم .RI \(aq Func \(aq و .RI \(aq "Func Status" \(aq. .IP شناسهٔ Func یک توکن است: \(oqABM\(cq، \(oqAFC\(cq، \(oqAFLT\(cq، \(oqAIP\(cq، \(oqANF\(cq، \(oqANL\(cq، \(oqAPF\(cq، \(oqARO\(cq، \(oqBC2\(cq، \(oqBC\(cq، \(oqCOMP\(cq، \(oqCSQL\(cq، \(oqDIVERSITY\(cq، \(oqDSQL\(cq، \(oqDUAL_WATCH\(cq، \(oqFAGC\(cq، \(oqFBKIN\(cq، \(oqLOCK\(cq، \(oqMBC\(cq، \(oqMN\(cq، \(oqMON\(cq، \(oqMUTE\(cq، \(oqNB2\(cq، \(oqNB\(cq، \(oqNR\(cq، \(oqOVF_STATUS\(cq، \(oqRESUME\(cq، \(oqREV\(cq، \(oqRF\(cq، \(oqRIT\(cq، \(oqSATMODE\(cq، \(oqSBKIN\(cq، \(oqSCEN\(cq، \(oqSCOPE\(cq، \(oqSEND_MORSE\(cq، \(oqSEND_VOICE_MEM\(cq، \(oqSPECTRUM\(cq، \(oqSPECTRUM_HOLD\(cq، \(oqSQL\(cq، \(oqSYNC\(cq، \(oqTBURST\(cq، \(oqTONE\(cq، \(oqTRANSCEIVE\(cq، \(oqTSQL\(cq، \(oqTUNER\(cq، \(oqVOX\(cq، \(oqVSC\(cq، \(oqXIT\(cq. 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) برای \(lqactivate\(rq (فعال‌سازی) یا در غیر این صورت \(lqde-activate\(rq (غیرفعال‌سازی) است، بسیار شبیه به تعاریف TRUE/FALSE در زبان C (درست برابر با غیر صفر و نادرست برابر با صفر، \(oq0\(cq است). .IP .BR نکته : ارسال یک \(oq?\(cq (پرس‌وجو) به‌عنوان آرگومان اول به‌جای یک توکن Func، فهرستی از توکن‌های توابع تنظیم (set function) پشتیبانی‌شده توسط backend رادیو را که با فاصله از هم جدا شده‌اند بازمی‌گرداند. از این قابلیت برای تعیین توابع پشتیبانی‌شدهٔ یک backend رادیویی مشخص استفاده کنید. . .TP .BR u ", " get_func " \(aq" \fIFunc\fP \(aq دریافت .RI \(aq "Func Status" \(aq. .IP مقدار Func Status را به‌صورت یک مقدار غیر تهی (non-null) برای توکن Func داده‌شده مانند آنچه در .B set_func در بالا آمده است بازمی‌گرداند. .IP .BR نکته : ارسال یک \(oq?\(cq (پرس‌وجو) به‌عنوان آرگومان اول به‌جای یک توکن Func، فهرستی از توکن‌های توابع دریافت (get function) پشتیبانی‌شده توسط backend رادیو را که با فاصله از هم جدا شده‌اند بازمی‌گرداند. از این قابلیت برای تعیین توابع پشتیبانی‌شدهٔ یک backend رادیویی مشخص استفاده کنید. . .TP .BR L ", " set_level " \(aq" \fILevel\fP "\(aq \(aq" "\fILevel Value\fP" \(aq تنظیم .RI \(aq Level \(aq و .RI \(aq "Level Value" \(aq. .IP مقدار Level یک توکن از موارد زیر است: \(oqAF\(cq, \(oqAGC\(cq, \(oqAGC_TIME\(cq, \(oqALC\(cq, \(oqANTIVOX\(cq, \(oqAPF\(cq, \(oqATT\(cq, \(oqBAL\(cq, \(oqBAND_SELECT\(cq, \(oqBKINDL\(cq, \(oqBKIN_DLYMS\(cq, \(oqCOMP\(cq, \(oqCOMP_METER\(cq, \(oqCWPITCH\(cq, \(oqID_METER\(cq, \(oqIF\(cq, \(oqKEYSPD\(cq, \(oqMETER\(cq, \(oqMGC\(cq, \(oqMGF\(cq, \(oqMGL\(cq, \(oqMICGAIN\(cq, \(oqMONITOR_GAIN\(cq, \(oqNB\(cq, \(oqNOTCHF\(cq, \(oqNOTCHF_RAW\(cq, \(oqNR\(cq, \(oqPBT_IN\(cq, \(oqPBT_OUT\(cq, \(oqPREAMP\(cq, \(oqRAWSTR\(cq, \(oqRF\(cq, \(oqRFPOWER\(cq, \(oqRFPOWER_METER\(cq, \(oqRFPOWER_METER_WATTS\(cq, \(oqSLOPE_HIGH\(cq, \(oqSLOPE_LOW\(cq, \(oqSPECTRUM_ATT\(cq, \(oqSPECTRUM_AVG\(cq, \(oqSPECTRUM_EDGE_HIGH\(cq, \(oqSPECTRUM_EDGE_LOW\(cq, \(oqSPECTRUM_MODE\(cq, \(oqSPECTRUM_REF\(cq, \(oqSPECTRUM_SPAN\(cq, \(oqSPECTRUM_SPEED\(cq, \(oqSQL\(cq, \(oqSTRENGTH\(cq, \(oqSWR\(cq, \(oqTEMP_METER\(cq, \(oqUSB_AF\(cq, \(oqUSB_AF_INPUT\(cq, \(oqVD_METER\(cq, \(oqVOXDELAY\(cq, \(oqVOXGAIN\(cq. .IP مقدار Level Value می‌تواند یک مقدار اعشاری (float) یا عدد صحیح (integer) باشد. برای توکن AGC مقدار یکی از این موارد است: \(oq0\(cq = OFF، \(oq1\(cq = SUPERFAST، \(oq2\(cq = FAST، \(oq3\(cq = SLOW، \(oq4\(cq = USER، \(oq5\(cq = MEDIUM، \(oq6\(cq = AUTO. توجه داشته باشید که همه مقادیر روی تمام دستگاه‌ها (rigs) کار نمی‌کنند. برای فهرست کردن مقادیر قابل استفاده، دستور زیر را اجرا کنید: .EX rigctl -m MODEL_ID -u | grep "AGC levels" .EE یا برای Windows: .EX rigctl -m MODEL_ID -u | find "AGC levels" .EE .IP واحدهای اندازه‌گیری سطح (Level units) .in +4n .EX 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 .in .EE .IP .BR نکته : ارسال یک \(oq?\(cq (پرس‌وجو) به‌عنوان آرگومان اول به‌جای یک توکن Level، فهرستی از توکن‌های سطح تنظیم (set level) پشتیبانی‌شده توسط backend رادیو را که با فاصله از هم جدا شده‌اند بازمی‌گرداند. از این قابلیت برای تعیین سطوح پشتیبانی‌شدهٔ یک backend رادیویی مشخص استفاده کنید. . .TP .BR l ", " get_level " \(aq" \fILevel\fP \(aq دریافت .RI \(aq "Level Value" \(aq. .IP مقدار Level Value را به‌صورت یک عدد اعشاری (float) یا عدد صحیح (integer) برای توکن Level داده‌شده مانند آنچه در .B set_level در بالا آمده است بازمی‌گرداند. .IP .BR نکته : ارسال یک \(oq?\(cq (پرس‌وجو) به‌عنوان آرگومان اول به‌جای یک توکن Level، فهرستی از توکن‌های سطح دریافت (get level) پشتیبانی‌شده توسط backend رادیو را که با فاصله از هم جدا شده‌اند بازمی‌گرداند. از این قابلیت برای تعیین سطوح پشتیبانی‌شدهٔ یک backend رادیویی مشخص استفاده کنید. . .TP .BR P ", " set_parm " \(aq" \fIParm\fP "\(aq \(aq" "\fIParm Value\fP" \(aq تنظیم .RI \(aq Parm \(aq و .RI \(aq "Parm Value" \(aq. .IP مقدار Parm یک توکن از موارد زیر است: \(oqAFIF\(cq, \(oqAFIF_ACC\(cq, \(oqAFIF_LAN\(cq, \(oqAFIF_WLAN\(cq, \(oqANN\(cq, \(oqAPO\(cq, \(oqBACKLIGHT\(cq, \(oqBANDSELECT\(cq, \(oqBAT\(cq, \(oqBEEP\(cq, \(oqKEYERTYPE\(cq, \(oqKEYLIGHT\(cq, \(oqSCREENSAVER\(cq, \(oqTIME\(cq..IP .BR نکته : ارسال یک \(oq?\(cq (پرسش) به عنوان نخستین آرگومان به‌جای شناسهٔ Parm، فهرستی جداشده با فاصله از شناسه‌های پارامترِ تنظیم (set parameter) پشتیبانی‌شده توسط بخش پشتیبان (backend) رادیو را بازمی‌گرداند. از این امکان برای تعیین پارامترهای پشتیبانی‌شدهٔ بخش پشتیبانِ یک رادیوی مشخص استفاده کنید. .IP 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 . .TP .BR p ", " get_parm " \(aq" \fIParm\fP \(aq دریافت .RI \(aq "Parm Value" \(aq. .IP مقدار Parm Value را به‌صورت float یا integer برای شناسهٔ Parm مشخص‌شده، مشابه .B set_parm در بالا بازمی‌گرداند. .IP .BR نکته : ارسال یک \(oq?\(cq (پرسش) به عنوان نخستین آرگومان به‌جای شناسهٔ Parm، فهرستی جداشده با فاصله از شناسه‌های پارامترِ دریافت (get parameter) پشتیبانی‌شده توسط بخش پشتیبان رادیو را بازمی‌گرداند. از این امکان برای تعیین پارامترهای پشتیبانی‌شدهٔ بخش پشتیبانِ یک رادیوی مشخص استفاده کنید. . .TP .BR B ", " set_bank " \(aq" \fIBank\fP \(aq تنظیم .RI \(aq Bank \(aq. .IP شمارهٔ بانک حافظهٔ کنونی را تنظیم می‌کند. . .TP .BR E ", " set_mem " \(aq" \fIMemory#\fP \(aq تنظیم شماره کانال .RI \(aq Memory# \(aq. . .TP .BR e ", " get_mem دریافت شماره کانال .RI \(aq Memory# \(aq. . .TP .BR G ", " vfo_op " \(aq" "\fIMem/VFO Op\fP" \(aq انجام یک .RI \(aq "Mem/VFO Op" \(aq. .IP شناسهٔ Mem/VFO Operation یکی از مقادیر زیر است: \(oqCPY\(cq، \(oqXCHG\(cq، \(oqFROM_VFO\(cq، \(oqTO_VFO\(cq، \(oqMCL\(cq، \(oqUP\(cq، \(oqDOWN\(cq، \(oqBAND_UP\(cq، \(oqBAND_DOWN\(cq، \(oqLEFT\(cq، \(oqRIGHT\(cq، \(oqTUNE\(cq، \(oqTOGGLE\(cq. .IP .BR نکته : ارسال یک \(oq?\(cq (پرسش) به عنوان نخستین آرگومان به‌جای شناسهٔ Mem/VFO Op، فهرستی جداشده با فاصله از شناسه‌های Set Mem/VFO Op پشتیبانی‌شده توسط بخش پشتیبان رادیو را بازمی‌گرداند. از این امکان برای تعیین Mem/VFO Opهای پشتیبانی‌شدهٔ بخش پشتیبانِ یک رادیوی مشخص استفاده کنید. . .TP .BR g ", " scan " \(aq" "\fIScan Function\fP" "\(aq \(aq" "\fIScan Channel\fP" \(aq انجام یک .RI \(aq "Scan Function" \(aq روی یک .RI \(aq "Scan Option" \(aq. .IP شناسهٔ Scan Function یکی از مقادیر زیر است: \(oqDELTA\(cq, \(oqMEM\(cq, \(oqPLT\(cq, \(oqPRIO\(cq, \(oqPROG\(cq, \(oqSLCT\(cq, \(oqSTOP\(cq, \(oqVFO\(cq. .IP مقدار Scan Option یک عدد صحیح است. .IP مقدار Scan Option برای رادیوهای Yaesu عبارت است از 0=STOP، 1=UP، 2=DOWN. .IP مقدار Scan Option برای رادیوهای Icom شماره کانالی است که باید با G برنامه‌ریزی شود، در غیر این صورت استفاده نمی‌شود. .IP مقدار Scan Option برای رادیوهای Kenwood استفاده نمی‌شود. .IP .BR نکته : ارسال یک \(oq?\(cq (پرسش) به عنوان نخستین آرگومان به‌جای شناسهٔ Scan Fct، فهرستی جداشده با فاصله از شناسه‌های Scan Function پشتیبانی‌شده توسط بخش پشتیبان رادیو را بازمی‌گرداند. از این امکان برای تعیین Scan Functionهای پشتیبانی‌شدهٔ بخش پشتیبانِ یک رادیوی مشخص استفاده کنید. . .TP .BR H ", " set_channel " \(aq" \fIChannel\fP \(aq تنظیم داده‌های حافظهٔ .RI \(aq Channel \(aq. .IP اطلاعات کانال حافظه را تنظیم می‌کند. . .TP .BR h ", " get_channel " \(aq" \fIChannel\fP \(aq " \(aq" \fIreadonly\fP \(aq دریافت حافظهٔ کانال. .IP اگر readonly!=0 باشد، فقط داده‌های کانال بازگردانده می‌شود و رادیو روی کانال کنونی باقی می‌ماند. اگر readonly=0 باشد، رادیو روی کانال درخواست‌شده تنظیم خواهد شد. . .TP .BR A ", " set_trn " \(aq" \fITransceive\fP \(aq تنظیم حالت .RI \(aq Transceive \(aq. .IP شناسهٔ Transceive یکی از این مقادیر است: \(oqOFF\(cq، \(oqRIG\(cq، \(oqPOLL\(cq. .IP قابلیت Transceive سازوکاری برای رادیوهاست تا بدون فراخوانی مستقیم برای دریافت اطلاعات، رویدادها را گزارش دهند. .IP .BR نکته : ارسال یک \(oq?\(cq (پرسش) به عنوان نخستین آرگومان به‌جای شناسهٔ Transceive، فهرستی جداشده با فاصله از شناسه‌های حالت Transceive پشتیبانی‌شده توسط بخش پشتیبان رادیو را بازمی‌گرداند. از این امکان برای تعیین حالت‌های Transceive پشتیبانی‌شدهٔ بخش پشتیبانِ یک رادیوی مشخص استفاده کنید. . .TP .BR a ", " get_trn دریافت حالت .RI \(aq Transceive \(aq. .IP حالت Transceive (گزارش رویداد) همان‌طور که در .B set_trn در بالا آمده است. . .TP .BR * ", " reset " \(aq" \fIReset\fP \(aq انجام .RI \(aq Reset \(aq رادیو. .IP مقدار Reset یکی از این مقادیر است: \(oq0\(cq = هیچ‌کدام، \(oq1\(cq = بازنشانی نرم‌افزاری، \(oq2\(cq = بازنشانی VFO، \(oq4\(cq = بازنشانی پاک‌سازی حافظه، \(oq8\(cq = بازنشانی اصلی (Master reset). .IP از آنجا که این مقادیر به‌صورت یک ماسک بیتی (bitmask) در .IR include/hamlib/rig.h تعریف شده‌اند، در صورتی که بخش پشتیبان از آن یا کلاً از عمل بازنشانی از طریق کنترل رادیو پشتیبانی کند، می‌توان این مقادیر را با یکدیگر OR بیتی کرد تا چند بازنشانی به طور هم‌زمان انجام شود. . .TP .BR 0x87 ", " set_powerstat " \(aq" "\fIPower Status\fP" \(aq تنظیم .RI \(aq "Power Status" \(aq. .IP مقدار Power Status یکی از این مقادیر است: \(oq0\(cq = خاموش، \(oq1\(cq = روشن، \(oq2\(cq = آماده‌به‌کار (ورود به حالت standby)، \(oq4\(cq = حالت عملیاتی (خروج از حالت standby). . .TP .BR 0x88 ", " get_powerstat دریافت .RI \(aq "Power Status" \(aq همان‌طور که در .B set_powerstat در بالا آمده است. . .TP .BR 0x89 ", " send_dtmf " \(aq" \fIDigits\fP \(aq تنظیم ارقام DTMF .RI \(aq Digits \(aq. . .TP .BR 0x8a ", " recv_dtmf دریافت ارقام DTMF .RI \(aq Digits \(aq. ..TP .BR 0xac ", " set_conf " \(aq" "\fIToken\fP" \(aq " " \(aq "\fIValue\fP" \(aq تنظیم .RI \(aq Token \(aq به .RI \(aq Value \(aq. . .TP .BR 0xad ", " get_conf " \(aq" "\fIToken\fP" \(aq دریافت مقدار .RI \(aq Token \(aq. . .TP .BR _ ", " get_info دریافت اطلاعات متفرقه درباره رادیو. . .TP .BR 0xf5 ", " get_rig_info دریافت اطلاعات متفرقه درباره وضعیت VFO رادیو و سایر اطلاعات. . .TP .BR 0xf1 ", " halt هنگامی که درون .B rigctl صادر شود، از آن خارج می‌شود؛ هنگامی که توسط کلاینت دیگری صادر شود، در عوض از .B rigctld خارج می‌شود. . .TP .BR 0xf3 ", " get_vfo_info " \(aq" \fIVFO\fP \(aq دریافت اطلاعات متفرقه درباره یک VFO خاص. . .TP .BR 0xf4 ", " get_vfo_list دریافت نام‌های VFOهای در دسترس. . .TP .BR 0xf6 ", " get_modes دریافت تمام پهنای‌باندهای پشتیبانی‌شده برای تمام حالت‌ها (modes). . .TP .BR 0xf7 ", " get_mode_bandwidths " \(aq" \fIMode\fP \(aq دریافت پهنای‌باندهای مربوط به . .RI \(aq Mode \(aq. همچنین ببینید: .B get_modes. . .TP .B dump_state بازگرداندن اطلاعات وضعیتی خاص درباره بک‌اند رادیو. . .TP .BR 1 ", " dump_caps یک دستور ریموت واقعی برای رادیو نیست، بلکه صرفاً قابلیت‌ها را تخلیه (dump) می‌کند؛ یعنی آنچه بک‌اند درباره این مدل می‌داند و کارهایی که می‌تواند انجام دهد. .IP یادداشت (TODO): اطمینان حاصل شود که قالب این خروجی یکدست باشد تا بتوان آن را در یک هش، دیکشنری و غیره خواند. گزارش باگ‌ها مورد درخواست است. .IP .BR نکته : این دستور خطوط خروجی زیادی تولید خواهد کرد، بنابراین اگر از آرایه‌ای با طول ثابت استفاده می‌کنید بسیار مراقب باشید! برای نمونه، اجرای این دستور در برابر بک‌اند Dummy منجر به بیش از ۵ کیلوبایت خروجی متنی می‌شود. .IP پارامتر VFO در «حالت VFO» استفاده نمی‌شود. . .TP .BR 2 ", " power2mW " \(aq" "\fIPower [0.0..1.0]\fP" "\(aq \(aq" \fIFrequency\fP "\(aq \(aq" \fIMode\fP \(aq مقدار .RI \(aq "Power mW" \(aq را برمی‌گرداند. .IP مقداری از توان در محدوده .IR 0.0 ... 1.0 را به توان ارسال واقعی بر حسب میلی‌وات (عدد صحیح) تبدیل می‌کند. .IP همچنین مقادیر .RI \(aq Frequency \(aq و .RI \(aq Mode \(aq نیز باید ارائه شوند، چرا که توان خروجی ممکن است بر اساس این مقادیر تغییر کند. .IP پارامتر VFO در حالت VFO استفاده نمی‌شود. . .TP .BR 3 ", " dump_conf یک دستور ریموت واقعی برای رادیو نیست، بلکه صرفاً پیکربندی فعلی را همراه با محدوده‌های مجاز مقادیر تخلیه (dump) می‌کند. . .TP .BR 4 ", " mW2power " \(aq" "\fIPower mW\fP" "\(aq \(aq" \fIFrequency\fP "\(aq \(aq" \fIMode\fP \(aq مقدار .RI \(aq "Power [0.0..1.0]" \(aq را برمی‌گرداند. .IP توان ارسال واقعی بر حسب میلی‌وات (عدد صحیح) را به مقداری از توان در محدوده .IR "0.0 ... 1.0" تبدیل می‌کند. .IP همچنین مقادیر .RI \(aq Frequency \(aq و .RI \(aq Mode \(aq نیز باید ارائه شوند، چرا که توان خروجی ممکن است بر اساس این مقادیر متغیر باشد. .IP پارامتر VFO در حالت VFO استفاده نمی‌شود. . .TP .BR w ", " send_cmd " \(aq" \fICmd\fP \(aq ارسال یک رشته دستور خام به رادیو. .IP این دستور برای آزمایش و عیب‌یابی فرامین و پاسخ‌های رادیو هنگام توسعه یک بک‌اند مفید است. .IP برای پروتکل‌های باینری مقادیر را به صورت \\0xAA\\0xBB وارد کنید. انتظار دریافت یک .RI \(aq Reply \(aq از سوی رادیو را داشته باشید که بسته به پروتکل رادیو احتمالاً یک بلوک باینری یا یک رشته ASCII خواهد بود (به مستندات کنترل رایانه‌ای رادیوی خود مراجعه کنید). اگر در حال آزمایش پروتکلی مانند SmartSDR هستید که در دستورات آن فاصله وجود دارد، از علامت نقل‌قول استفاده کنید؛ مانند: w "C0|set slice 0 tx=1" .IP پایان‌دهنده دستور، که توسط گزینه .B send-cmd-term در بالا تعیین می‌شود، به هر رشته دستور ارسالی به رادیو خاتمه می‌دهد. این نویسه نباید بخشی از رشته ورودی باشد. . .TP .BR W ", " send_cmd_rx " \(aq" \fICmd\fP\(aq " " \fInbytes_or_terminator_char\fP ارسال یک رشته دستور خام به رادیو و انتظار دریافت nbytes بایت یا نویسه پایان‌دهنده (مانند ;). .IP این دستور برای آزمایش و عیب‌یابی فرامین و پاسخ‌های رادیو هنگام توسعه یک بک‌اند مفید است. اگر تعداد بایت‌های درخواستی <= تعداد بایت‌های واقعاً دریافت شده باشد، هیچ وقفه‌ای (timeout) رخ نخواهد داد. اگر یک نویسه ارائه شود، برای پایان دادن به خواندن رشته استفاده می‌شود؛ برای نمونه ';' برای دستورات Kenwood/Yaesu بسیار پرکاربرد است. .IP آرگومان دستور نمی‌تواند شامل هیچ فاصله‌ای باشد. برای پروتکل‌های باینری مقادیر را به صورت \\0xAA\\0xBB وارد کنید. انتظار دریافت یک .RI \(aq Reply \(aq از سوی رادیو را داشته باشید که بسته به پروتکل رادیو احتمالاً یک بلوک باینری یا یک رشته ASCII خواهد بود (به مستندات کنترل رایانه‌ای رادیوی خود مراجعه کنید). .IP پایان‌دهنده دستور، که توسط گزینه .B send-cmd-term در بالا تعیین می‌شود، به هر رشته دستور ارسالی به رادیو خاتمه می‌دهد. این نویسه نباید بخشی از رشته ورودی باشد. . .TP .BR set_clock " \(aq" \fIDateTime\fP \(aq تنظیم .RI \(aq DateTime \(aq .IP ساعت رادیو را تنظیم می‌کند -- توجه داشته باشید که برخی از رادیوها ثانیه یا میلی‌ثانیه را مدیریت نمی‌کنند. اگر سعی کنید ثانیه/میلی‌ثانیه را تنظیم کنید و رادیو از آن پشتیبانی نکند، یک پیام هشدار اشکال‌زدایی (debug) دریافت خواهید کرد. قالب آن ISO8601 است. قالب‌های پذیرفته‌شده امکان منطقه زمانی ۲ رقمی یا ۴ رقمی را فراهم می‌کنند .EX 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) .EE نکته: رادیوهای Icom انتظار دارند که شما زمان محلی و میزان اختلاف ساعت تا UTC را تنظیم کنید. بنابراین... برای نمونه ساعت 4PM EST به صورت 2021-12-01T16:00:00-0500 خواهد بود اما... اگر می‌خواهید GMT نمایش داده شود باید ساعت را روی GMT با افست صفرِ UTC تنظیم کنید. امید است در آینده Icom امکان نمایش هر یک از دو ساعت را فراهم کند نکته: رادیوهای Kenwood تنها اجازه تنظیم ساعت محلی را می‌دهند، آن هم فقط در صورتی که به‌طور خودکار توسط NTP تنظیم نشده باشد. تلاش برای تنظیم ساعت هنگامی که NTP در حال استفاده است افست را تنظیم خواهد کرد، اما زمان را خیر - و هیچ وضعیت خطایی بازگردانده نخواهد شد. زمان نمایش‌داده‌شده روی ساعت کمکی صرفاً توسط UTC و افست کمکی تعیین می‌شود. .TP .BR get_clock دریافت .RI \(aq RigTime \(aq .IP ساعت رادیو را دریافت می‌کند -- توجه داشته باشید که برخی از رادیوها ثانیه یا میلی‌ثانیه را مدیریت نمی‌کنند. قالب آن ISO8601 YYYY-MM-DDTHH:MM:SS.sss+ZZ است که در آن +ZZ نشان‌دهنده اختلاف UTC به صورت -/+ می‌باشد. ..TP .BR chk_vfo دریافت .RI \(aq Status \(aq .IP اگر گزینه vfo فعال باشد وضعیت (Status) را ۱ و در صورتی که غیرفعال باشد ۰ برمی‌گرداند. این دستور بازتاب‌دهنده سوییچ \-o برای .B rigctl و .B rigctld است و می‌تواند به صورت پویا توسط .B set_vfo_opt تغییر یابد. . .TP .BR set_vfo_opt " \(aq" \fIStatus\fP \(aq تنظیم .RI \(aq Status \(aq .IP تنظیم وضعیت (Status) گزینه vfo به صورت 1=روشن یا 0=خاموش. این دستور مشابه استفاده از سوییچ \-o برای .B rigctl و .B rigctld است. این مقدار در هنگام اجرا می‌تواند به صورت پویا تغییر کند. . .TP .BR set_separator " \(aq" \fISeparatorChar\fP \(aq تنظیم .RI \(aq SeparatorChar \(aq .IP پاسخ rigctld را تغییر می‌دهد تا به جای خط جدید از یک نویسه ویژه استفاده کند (نویسه # پیشنهاد می‌شود). برای گره tcprequest در node-red سودمند است. این مقدار در هنگام اجرا می‌تواند به صورت پویا تغییر یابد. . .TP .BR get_separator دریافت .RI \(aq SeparatorChar \(aq .IP نویسه جداکننده (SeparatorChar) فعلی را نمایش می‌دهد. . .TP .BR pause " \(aq" \fISeconds\fP \(aq مکث به میزان عدد صحیح داده‌شده برحسب .RI \(aq Seconds \(aq (ثانیه) پیش از ارسال دستور بعدی به رادیو. . .TP .BR password " \(aq" \fIPassword\fP \(aq هنگامی که rigctld با \-A ایمن‌سازی شده باشد، گذرواژه را به rigctld ارسال می‌کند. باید از کلید مشترک ۳۲ نویسه‌ای rigctld استفاده کند. (پیاده‌سازی نشده است) . .TP .BR set_lock_mode " \(aq" \fILocked\fP \(aq قفل حالت را روشن (1) یا خاموش (0) می‌کند (تنها هنگام استفاده از rigctld). روشن کردن آن مانع از تغییر حالت دستگاه توسط تمامی کلاینت‌ها می‌شود. برای نمونه این ویژگی هنگام اجرای CW Skimmer در حالت FM روی یک دستگاه IC-7300 سودمند است. با فعال بودن قفل، کلیک کردن روی spotها در برنامه spotting باعث تغییر حالت VFOA نمی‌شود. بنابراین هنگام شروع CW Skimmer دستور "set_lock_mode 1" و هنگام توقف CW Skimmer دستور "set_lock_mode 0" را اجرا کنید. . .TP .BR get_lock_mode وضعیت فعلی حالت قفل را برمی‌گرداند: 1=روشن، 2=خاموش (تنها هنگام استفاده از rigctld کاربرد دارد). . .TP .BR send_raw " \(aq" \fITerminator\fP "\(aq \(aq" \fIString\fP \(aq می‌تواند رشته ASCII یا مقادیر 0xnn یا xnn را ارسال کند \-\- در رشته دستور نباید هیچ فاصله‌ای وجود داشته باشد. مقادیر ممکن برای پایان‌دهنده (terminator) عبارتند از CR، LF، ;، ICOM، 1-100 (بایت‌ها برای خواندن)، یا 0 به معنای عدم پاسخ و \-1 به معنای نامشخص (در زمان خواندن با انقضای زمان مواجه خواهد شد). مثال‌ها (توجه داشته باشید که ; در یونیکس/لینوکس باید گریز داده شود یا در نقل‌قول تکی یا دوتایی محصور گردد): .IP برای Windows و Unix/Linux قالب جدیدی با جداکننده دونقطه برای ارقام هگزادسیمال در دسترس است: .EX 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\\; .EE برای Windows: .EX 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 .EE برای Unix/Linux: .EX 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 .EE . .TP .BR client_version " \(aq" \fIString\fP "\(aq کلاینت می‌تواند نسخه خود را به .B rigctld ارسال کند و بازخوردی پیرامون سازگاری، منسوخ‌شدن، و گزینه‌های جایگزین دریافت کند. .TP .BR hamlib_version نسخه Hamlib را به همراه تاریخ/زمان با فرمت ISO8601 بازمی‌گرداند. . .TP .BR test روال‌های آزمایشی را اجرا می‌کند. در حال توسعه است. . .TP .BR set_gpio " \(aq" \fIGPIO#\fP "\(aq \(aq" \fI0/1\fP "\(aq پایه‌های GPIO1، GPIO2، GPIO3، GPIO4 را روی درگاه ptt مربوط به GPIO تنظیم می‌کند. می‌توان از 1,2,3,4 نیز استفاده کرد. . .TP .BR get_gpio " \(aq" \fIGPIO#\fP "\(aq پایه‌های GPIO1، GPIO2، GPIO3، GPIO4 را از روی درگاه ptt مربوط به GPIO می‌خواند. می‌توان از 1,2,3,4 نیز استفاده کرد. . .TP .BR skip_init از راه‌اندازی اولیه رادیو صرف‌نظر می‌کند \-\- هنگام اجرای دستورها با rigctl جهت بالا بردن سرعت مفید است. ..SH "ریدلاین (READLINE)" . اگر فایل‌های توسعهٔ کتابخانهٔ .B Readline در زمان پیکربندی (configure) یافت شوند، .B rigctl به‌طور مشروط با پشتیبانی از Readline برای ورود دستورها و آرگومان‌ها ساخته خواهد شد. کلیدهای میانبر دستورهای Readline بر روی مقادیر پیش‌فرض خود قرار دارند، همان‌گونه که در .UR https://tiswww.cwru.edu/php/chet/readline/rluserman.html راهنمای Readline .UE شرح داده شده است. .B rigctl نام \(lqrigctl\(rq را تنظیم می‌کند که می‌تواند در ساختارهای مقداردهی اولیهٔ مشروط در فایل مقداردهی اولیهٔ Readline .RI ( $HOME/.inputrc به‌طور پیش‌فرض) برای کلیدهای میانبر سفارشی مختص به .BR rigctl به کار رود. . .PP تاریخچهٔ دستورها همراه با پشتیبانی Readline در دسترس است، همان‌گونه که در .UR https://tiswww.case.edu/php/chet/readline/history.html#SEC1 راهنمای تاریخچهٔ Readline .UE توضیح داده شده است. رشته‌های دستور و آرگومان به‌صورت تک‌خطی ذخیره می‌شوند، حتی زمانی که آرگومان‌ها به‌صورت جداگانه برای ورودی درخواست شوند. دستورها و آرگومان‌ها اعتبارسنجی نمی‌شوند و دقیقاً همان‌گونه که تایپ شده‌اند و با مقادیری که با یک فاصله از هم جدا شده‌اند، ذخیره می‌شوند. . .PP در حالت عادی تاریخچهٔ نشست ذخیره نمی‌شود؛ با این حال، استفاده از هر یک از گزینه‌های .BR \-i / \-\-read\-history یا .BR \-I / \-\-save\-history هنگام راه‌اندازی .B rigctl باعث می‌شود که هر تاریخچهٔ ذخیره‌شدهٔ قبلی خوانده شود و/یا تاریخچهٔ نشست فعلی و هر نشست قبلی (به شرطی که گزینه‌های .BR \-i " و " \-I با هم داده شده باشند) هنگام بسته شدن .B rigctl ذخیره گردد. هر گزینه مستقل از دیگری است؛ یعنی می‌توان آن‌ها را به‌صورت جداگانه یا ترکیبی به کار برد. این قابلیت برای مثال جهت ذخیرهٔ مجموعه‌ای از دستورها و سپس خواندن آن‌ها در آینده بدون بازنویسی تاریخچهٔ تغییریافته برای داشتن مجموعه‌ای پایدار از دستورهای آزمایشی در حالت تعاملی مفید است. . .PP تاریخچه به‌طور پیش‌فرض در .I $HOME/.rigctl_history ذخیره می‌شود، اگرچه دایرکتوری مقصد را می‌توان با تنظیم متغیر محیطی .B RIGCTL_HIST_DIR تغییر داد. در صورتی که RIGCTL_HIST_DIR تنظیم نشده باشد، مقدار متغیر محیطی .B HOME به‌جای آن استفاده می‌شود. در حال حاضر تنها دایرکتوری مقصد قابل تغییر است. . .PP اگر پشتیبانی از Readline در زمان پیکربندی یافت نشود، از پردازشگر داخلی اولیهٔ دستورها استفاده می‌شود. بدون در نظر گرفتن اینکه پشتیبانی از Readline فعال شده باشد یا خیر، از Readline برای دستورهای .B rigctl که در خط فرمان وارد می‌شوند استفاده نخواهد شد. . .PP .BR نکته : پشتیبانی از Readline در نسخه‌های باینری ۳۲ بیتی یا ۶۴ بیتی MS Windows که توسط پروژهٔ Hamlib ارائه می‌شوند گنجانده نشده است. اجرای .B rigctl روی بستر MS Windows در پوستهٔ \(oqcmd\(cq تاریخچهٔ خط فرمان نشست را ارائه می‌دهد، اما این تاریخچه بین نشست‌ها روی دیسک ذخیره نمی‌شود. . . .SH "خطاها (DIAGNOSTICS)" . گزینهٔ .BR \-v ، .B \-\-verbose امکان می‌دهد سطوح مختلفی از خروجی‌های عیب‌یابی به .B stderr فرستاده شوند که به این صورت هستند: \-v برای .BR BUG ، \-vv برای .BR ERR ، \-vvv برای .BR WARN ، \-vvvv برای .BR VERBOSE یا \-vvvvv برای .BR TRACE . . .PP سطح پرگویی (verbose) مشخص‌شده برای ارائهٔ اطلاعات اشکال‌زدایی لازم به نشانی ایمیل زیر مفید است. برای نمونه، خروجی TRACE تمام مقادیر ارسالی به رادیو و دریافتی از آن را نشان می‌دهد که برای توسعهٔ کتابخانهٔ بک‌اند رادیو بسیار مفید است و ممکن است توسط توسعه‌دهندگان درخواست شود. . ..SH "وضعیت خروج (EXIT STATUS)" .B rigctl با وضعیت‌های زیر خارج می‌شود: . .TP .B 0 اگر تمام عملیات‌ها به‌طور عادی کامل شوند؛ . .TP .B 1 اگر یک گزینه یا آرگومان نامعتبر در خط فرمان وجود داشته باشد؛ . .TP .B 2 اگر خطایی از سوی .B Hamlib بازگردانده شود. . . .SH "مثال‌ها (EXAMPLES)" . اجرای .B rigctl برای Yaesu FT-920 با استفاده از مبدل USB به سریال در Linux در حالت تعاملی: . .PP .in +4n .EX .RB $ " rigctl -m 1014 -r /dev/ttyUSB1" .EE .in . .PP اجرای .B rigctl برای Yaesu FT-920 با استفاده از COM1 در MS Windows همراه با تولید خروجی TRACE روی .IR stderr : . .PP .in +4n .EX .RB > " rigctl -m 1014 -r COM1 -vvvvv" .EE .in . .PP اجرای .B rigctl برای Yaesu FT-920 با استفاده از مبدل USB به سریال همراه با تنظیم نرخ باود (baud rate) و بیت‌های توقف (stop bits): . .PP .in +4n .EX .RB $ " rigctl -m 1014 -r /dev/ttyUSB1 -s 4800 -C stop_bits=2" .EE .in . .PP اجرای .B rigctl برای Elecraft K3 با استفاده از مبدل USB به سریال همراه با تعیین پایان‌دهنده برای دستور .BR w : . .PP .in +4n .EX .RB $ " rigctl -m 2029 -r /dev/ttyUSB0 -t';'" .EE .in . .PP اتصال به یک .B rigctld در حال اجرا با مدل رادیوی 2 (\(lqNET rigctl\(rq) روی میزبان محلی و تعیین درگاه TCP، همراه با تنظیم فرکانس و حالت: . .PP .in +4n .EX .RB $ " rigctl -m 2 -r localhost:4532 F 7253500 M LSB 0" .EE .in . ..SH "گزارش باگ‌ها (BUGS)" . .B set_chan تاکنون هیچ متد ورودی ندارد، بنابراین پیاده‌سازی‌نشده باقی مانده است. .PP این بخش تقریباً خالی... .PP گزارش باگ‌ها به: .IP .nf .MT hamlib\-developer@lists.sourceforge.net لیست پستی توسعه‌دهندگان Hamlib .ME .fi . . .SH "کپی‌رایت و تکثیر (COPYRIGHT)" . این فایل بخشی از Hamlib است؛ پروژه‌ای برای توسعه کتابخانه‌ای که توابع کنترلی رادیو، روتاتور و تقویت‌کننده را برای توسعه‌دهندگان نرم‌افزارهایی که عمدتاً مورد توجه رادیوآماتورها و علاقه‌مندان به ارتباطات رادیویی هستند، ساده‌سازی می‌کند. . .PP کپی‌رایت \(co 2000-2011 Stephane Fillod .br کپی‌رایت \(co 2000-2018 گروه Hamlib (مشارکت‌کنندگان گوناگون) .br کپی‌رایت \(co 2010-2020 Nate Bargmann . .PP این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر، فایل COPYING را ببینید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب برای یک هدف خاص. . . .SH "همچنین ببینید (SEE ALSO)" . .BR less (1), .BR more (1), .BR rigctld (1), .BR hamlib (7) . . .SH "شناسنامه (COLOPHON)" . پیوندها به ویکی Hamlib، مخزن Git، بایگانی‌های انتشار و بایگانی‌های وضعیت‌های لحظه‌ای (daily snapshots) روزانه از طریق . .UR http://www.hamlib.org hamlib.org .UE در دسترس هستند.