.\"                                      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, rigctltcp.c
.\"
.TH RIGCTLTCP "1" "2026-02-14" "Hamlib" "Hamlib Utilities"
.
.
.SH "نام (NAME)"
.
rigctltcp \- دیمن کنترل از راه دور رادیو ترنسیور بر بستر TCP
.
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.SY rigctltcp
.OP \-hlLuoVR
.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 \-S char
.OP \-C parm=val
.OP \-T ipaddr
.OP \-t num
.OP \-M addr
.OP \-n port
.OP \-W secs
.OP \-w secs
.OP \-x option
.OP \-A password
.RB [ \-v [ \-Z ]]
.YS
.
.
.SH "توضیحات (DESCRIPTION)"
.
دیمن شبکه‌ای که پخش‌های چندپخشی (multicast) مبتنی بر UDP شامل داده‌های لحظه‌ای (snapshot) رادیو را فعال می‌کند.
.
از کنترل دوطرفه رادیو و دریافت وضعیت پشتیبانی می‌نماید.
.
داده‌های پخش‌شده می‌توانند جفت‌توکن‌های
.BR rigctld (1)
یا
.IR JSON
باشند.
.
.PP
تمام بسته‌ها با یک رشته
.I id
منحصربه‌فرد برچسب‌گذاری می‌شوند تا چندین رادیو بتوانند روی یک پورت یکسان اقدام به ارسال یا دریافت (broadcast/rx) نمایند.
.
در ابتدا امکان تنظیم فرکانس، حالت (mode)، پهنای باند عبوری (passband width)، وضعیت PTT، حالت ماهواره‌ای (satmode) و وضعیت split را فراهم خواهد کرد زیرا این موارد در بسیاری از برنامه‌ها مشترک هستند.
.
قابلیت‌های بیشتری در آینده به مرور افزوده خواهند شد.
.
.PP
محتوای بسته‌های ارسالی بر پایه خروجی
.I get_rig_info
بوده و ممکن است شامل چندین خط VFO باشد.
.
بخش
.B "مثال‌ها (EXAMPLES)"
در زیر را ببینید.
.
.
.SH "گزینه‌ها (OPTIONS)"
این برنامه از سینتکس معمول خط فرمان گنو پیروی می‌کند.
.
در گزینه‌های کوتاه دارای آرگومان، مقدار می‌تواند بلافاصله پس از گزینه بیاید یا با یک فاصله جدا شود.
.
گزینه‌های طولانی که با دو خط تیره (\(oq\-\(cq) آغاز می‌شوند به یک علامت مساوی (\(oq=\(cq) میان گزینه و آرگومان نیاز دارند.
.
.PP
در اینجا خلاصه‌ای از گزینه‌های پشتیبانی‌شده آورده شده است:
.
.TP
.BR \-m ", " \-\-model = \fIID\fP
انتخاب شماره مدل رادیو.
.
مقدار پیش‌فرض Dummy با شناسه
.I ID
.BR 1
است.
.IP
مشاهده فهرست مدل‌ها (با دستور \(lqrigctltcp \-l\(rq).
.IP
.BR نکته :
برنامه
.B rigctltcp
(یا نرم‌افزارهای شخص ثالث با استفاده از C API) از شناسه
.I ID
.B 2
برای
.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
و غیره در ویندوز.
.
توزیع‌های مختلف BSD و MacOS نام‌های دستگاهی مختص به خود را دارند.
.
مستندات سیستم خود را بررسی کنید.
.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 با همان ساختار نام‌گذاری دستگاه که در گزینه
.B \-r
در بالا شرح داده شد.
.
.
.TP
.BR \-d ", " \-\-dcd\-file = \fIDEVICE\fP
استفاده از
.I DEVICE
به‌عنوان نام فایل دستگاه Data Carrier Detect با همان ساختار نام‌گذاری دستگاه که در گزینه
.B \-r
در بالا شرح داده شد.
.
.
.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 تعریف‌شده در بک‌اند رادیو را بازنویسی (override) می‌کنند.
.IP
برخی اثرات جانبی این گزینه بدین صورت است که با تنظیم نوع روی DTR، وضعیت خوانده‌شده PTT از فرانت‌اند
.B Hamlib
می‌آید و مستقیماً از رادیو خوانده نمی‌شود.
.
با تنظیم روی NONE، وضعیت PTT نه قابل خواندن و نه قابل تنظیم خواهد بود، حتی اگر بک‌اند رادیو از خواندن یا تنظیم وضعیت 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
به‌طور پیش‌فرض از حداکثر سرعت سریال پشتیبانی‌شده در قابلیت‌های بک‌اند رادیو (تعیین‌شده توسط
.B \-m
در بالا) استفاده می‌کند.
.
.
.TP
.BR \-c ", " \-\-civaddr = \fIID\fP
استفاده از
.I ID
به‌عنوان آدرس CI\[en]V جهت برقراری ارتباط با رادیو.
.IP
فقط برای رادیوهای Icom و برخی از رادیوهای Ten\[en]Tec کاربرد دارد.
.IP
.BR نکته :
شناسه
.I id
در قالب ده‌دهی (decimal) است، مگر اینکه با
.I 0x
شروع شده باشد که در این صورت هگزادسیمال در نظر گرفته می‌شود.
.
.
.TP
.BR \-S ", " \-\-separator = \fICHAR\fP
استفاده از
.I CHAR
به‌عنوان جداکننده به جای نویسه خط جدید (line feed).
.IP
مقدار پیش‌فرض
.I \[rs]n
است.
.
استفاده از
.I $
یا
.I @
توصیه می‌شود زیرا در هر دو محیط POSIX و ویندوز کار می‌کنند.
.IP
.
.
.TP
.BR \-L ", " \-\-show\-conf
فهرست کردن تمامی پارامترهای پیکربندی رادیوی مشخص‌شده با
.B \-m
در بالا.
.
در صورت عدم تعیین
.BR \-r ،
برنامه خارج می‌شود.
.B توجه
کنید که دستگاه dummy پارامترهای سریال ندارد.
.
.
.TP
.BR \-C ", " \-\-set\-conf = \fIPARM=val\fP [ \fI,PARM=val\fP ]
تنظیم پارامتر(های) پیکربندی. برخی از موارد پرکاربرد عبارتند از:
.in +4
.BR async :
مقدار
.I True
انتقال ناهمگام داده‌ها را برای بک‌اندهایی که از آن پشتیبانی می‌کنند فعال می‌سازد.
.
این امر امکان استفاده از داده‌های transceive و طیف (spectrum) را فراهم می‌کند.
.br
.BR auto_power_on :
مقدار
.I True
روشن شدن خودکار رادیوهای سازگار را در زمان باز شدن پورت فعال می‌کند.
.br
.BR auto_power_off :
مقدار
.I True
خاموش شدن خودکار رادیوهای سازگار را در زمان بسته شدن پورت فعال می‌کند.
.br
.BR auto_disable_screensaver :
مقدار
.I True
غیرفعال‌سازی خودکار محافظ صفحه (screensaver) رادیوهای سازگار را هنگام باز شدن اتصال ممکن می‌سازد.
.br
.BR dcd_type :
بازنویسی نوع رابط Data Carrier Detect (یا squelch).
.br
.BR dcd_pathname :
مسیر فایل دستگاه رابط Data Carrier Detect (یا squelch).
.br
.BR disable_yaesu_bandselect :
مقدار
.I True
انتخاب خودکار باند هنگام تغییر باند را در رادیوهای Yaesu غیرفعال می‌کند.
.br
.BR dtr_state :
مقدار
.I ON
سیگنال DTR را روشن و
.I OFF
آن را خاموش می‌کند؛ در صورت عدم تنظیم غیرفعال است.
.br
.BR freq_skip :
مقدار
.RI != 0
تنظیم فرکانس روی TX_VFO را هنگام دریافت (RX) و روی RX_VFO را هنگام ارسال (TX) نادیده می‌گیرد؛ کاربرد در gpredict و رادیوهایی که فاقد TARGETABLE_VFO هستند.
.br
.BR lo_freq :
فرکانسی که برای استفاده با ترانسورتر به فرکانس VFO افزوده می‌شود.
.br
.BR post_write_delay :
تأخیر بر حسب میلی‌ثانیه میان ارسال هر دستور.
.br
.BR ptt_share :
مقدار
.I True
امکان اشتراک‌گذاری پورت PTT با سایر برنامه‌ها را فعال می‌کند.
.br
.BR ptt_type :
بازنویسی نوع رابط Push\[en]To\[en]Talk.
.br
.BR ptt_pathname :
مسیر فایل دستگاه رابط Push\[en]To\[en]Talk.
.br
.BR ptt_bitnum :
شماره بیت GPIO برای Push\[en]To\[en]Talk.
.br
.BR retry :
حداکثر تعداد تلاش‌های مجدد.
.br
.BR rts_state :
مقدار
.I ON
سیگنال RTS را روشن و
.I OFF
آن را خاموش می‌کند؛ در صورت عدم تنظیم غیرفعال است.
.br
.BR twiddle_timeout :
برای عملیات‌های ماهواره‌ای، با دستکاری VFOB ارسال دستورات به آن تا زمان انقضای مهلت متوقف می‌شود.
.br
.BR twiddle_rit :
جلوگیری از اجرای get_freq روی VFOB به منظور تنظیم RIT در ماهواره‌ها.
.br
.BR timeout :
مهلت زمانی بر حسب میلی‌ثانیه.
.br
.BR write_delay :
تأخیر بر حسب میلی‌ثانیه میان ارسال هر بایت.
.br
.BR tuner_control_pathname :
مسیر فایل اسکریپت یا برنامه‌ای جهت کنترل تیونر با یک آرگومان
.IR 0 / 1
برای
.IR خاموش / روشن
کردن تیونر.
.in
.
.IP
برای دریافت فهرست پارامترهای پیکربندی برای یک شماره مدل خاص از گزینه
.B -L
در بالا استفاده کنید.
.
.
.TP
.BR \-l ", " \-\-list
فهرست کردن تمامی شماره مدل‌های تعریف‌شده در
.B Hamlib
و خروج.
.IP
فهرست بر اساس شماره مدل مرتب شده است.
.IP
.BR نکته :
می‌توان فهرست را با استفاده از کلیدهای
.BR Shift-PageUp / Shift-PageDown
یا با استفاده از نوار اسکرول شبیه‌ساز ترمینال در X/Wayland یا پنجره cmd در ویندوز به بالا و پایین پیمایش کرد.
.
می‌توان خروجی را به
.BR more (1)
یا
.BR less (1)
هدایت (pipe) کرد، مانند \(lqrigctltcp \-l | more\(rq.
.
.
.TP
.BR \-u ", " \-\-dump\-caps
تخلیه و نمایش قابلیت‌های رادیوی مشخص‌شده با
.B \-m
در بالا و خروج.
.
.
.TP
.BR \-o ", " \-\-vfo
فعال‌سازی حالت VFO.
.IP
یک آرگومان اضافی VFO در ابتدای هر دستور مرتبط (به‌جز
.BR set_vfo )
مورد نیاز خواهد بود. در غیر این صورت، با فعال نبودن این گزینه مقدار \(oqcurrVFO\(cq به کار می‌رود و آرگومان اضافی VFO استفاده نمی‌شود.
.IP
دستور
.B chk_vfo
در زیر را ببینید.
.
.
.TP
.BR \-v ", " \-\-verbose
تنظیم حالت پرگویی (verbose)، به صورت افزایشی (بخش
.B عیب‌یابی
در زیر را ببینید).
.
.
.TP
.BR \-T ", " \-\-listen\-addr = \fIIPADDR\fP
استفاده از
.I IPADDR
به‌عنوان نشانی IP شنود.
.IP
مقدار پیش‌فرض ANY (0.0.0.0) است.
.
.
.TP
.BR \-t ", " \-\-port = \fINUM\fP
استفاده از
.I NUM
به‌عنوان پورت شنود TCP.
.IP
مقدار پیش‌فرض 4531 است.
.
.
.TP
.BR \-M ", " \-\-multicast\-addr = \fIADDR\fP
استفاده از
.I ADDR
به‌عنوان نشانی IP چندپخشی (multicast).
.IP
مقدار پیش‌فرض OFF (0.0.0.0) است.
.IP
مقدار پیشنهادی برای IPv4 برابر با 224.0.1.1 است.
.
.
.TP
.BR \-n ", " \-\-multicast\-port = \fIPORT\fP
استفاده از
.I PORT
به‌عنوان پورت شنود چندپخشی.
.IP
مقدار پیش‌فرض 4532 است.
.
.
.TP
.BR \-W ", " \-\-twiddle_timeout = \fISECONDS\fP
فعال‌سازی مهلت زمانی هنگام تشخیص تغییر وضعیت VFO.
.
برخی عملکردها نادیده گرفته خواهند شد.
.IP
تنها زمانی نیاز است که نرم‌افزار کنترل‌کننده باید موقتاً متوقف (pause) شود تا بتوانید VFO را جابه‌جا کنید.
.
حرکت مداوم این مهلت زمانی را تمدید می‌کند.
.
.
.TP
.BR \-w ", " \-\-twiddle_rit = \fISECONDS\fP
جلوگیری از اجرای
.B get_freq
روی VFOB تا امکان تغییر RIT فراهم شود.
.
.
.TP
.BR \-x ", " \-\-uplink = \fIOPTION\fP
.IR 1 =Sub,
.IR 2 =Main.
.IP
در GPredict از این گزینه برای نادیده گرفتن
.B get_freq
در VFO آپ‌لینک Sub یا Main استفاده کنید.
.IP
امکان تغییر VFO در داون‌لینک را بدون تداخل در عملکرد GPredict یا آپ‌لینک فراهم می‌سازد.
.
.
.TP
.BR \-Z ", " \-\-debug\-time\-stamps
فعال‌سازی برچسب‌های زمانی برای پیام‌های اشکال‌زدایی.
.IP
فقط همراه با گزینه
.B \-v
استفاده شود، زیرا به‌تنهایی خروجی تولید نمی‌کند.
.
.
.TP
.BR \-A ", " \-\-password = \fIPASSWORD\fP
تنظیم گذرواژه برای
.B rigctltcp
که نیازمند استفاده از
.B rig_set_password
در Hamlib و استفاده کلاینت‌ها از
.I PASSWORD
جهت دسترسی به rigctltcp است.
.
یک کلید مخفی مشترک ۳۲ کاراکتری جهت استفاده در سمت کلاینت نمایش داده خواهد شد.
.IP
.B (پیاده‌سازی نشده است)
.
.
.TP
.BR \-R ", " \-\-rigctltcp\-idle
موجب می‌شود در زمانی که هیچ کلاینتی متصل نیست،
.B rigctltcp
اتصال به رادیو را ببندد.
.
در حالت عادی جهت تسریع اتصالات بعدی، ارتباط همچنان برقرار می‌ماند.
.
.
.TP
.BR \-h ", " \-\-help
نمایش خلاصه‌ای از این گزینه‌ها و خروج.
.
.
.TP
.BR \-V ", " \-\-version
نمایش نسخه
.B rigctltcp
و خروج.
.
.
.PP
.BR نکته :
برخی از گزینه‌ها ممکن است در یک بک‌اند خاص پیاده‌سازی نشده باشند و با خطا مواجه شوند.
.
این مسئله معمولاً در گزینه‌های
.B \-\-set\-conf
و
.B \-\-show\-conf
رخ می‌دهد.
.
.
.PP
لطفاً توجه داشته باشید که بک‌اند رادیوی تحت کنترل یا خود رادیو ممکن است از برخی دستورات پشتیبانی نکنند.
.
در این حالت، عملیات با یک کد خطای
.B Hamlib
شکست خواهد خورد.
.
.
.SH "عیب‌یابی (DIAGNOSTICS)"
.
گزینه
.BR \-v ,
.B \-\-verbose
امکان ارسال سطوح مختلف پیام‌های تشخیصی به
.B stderr
را فراهم می‌سازد که به ترتیب شامل \-v برای
.BR BUG ،
\-vv برای
.BR ERR ،
\-vvv برای
.BR WARN ،
\-vvvv برای
.BR VERBOSE
یا \-vvvvv برای
.BR TRACE
است.
.
.PP
هر یک از این سطوح برای ارائه اطلاعات لازم اشکال‌زدایی سودمند هستند. برای مثال، خروجی TRACE تمام مقادیر ارسال‌شده به رادیو و دریافت‌شده از آن را نشان می‌دهد که برای توسعه کتابخانه بک‌اند رادیو بسیار مفید بوده و ممکن است توسط توسعه‌دهندگان درخواست شود.
.
.
.SH "وضعیت خروج (EXIT STATUS)"
.B rigctltcp
با این مقادیر خارج می‌شود:
.
.TP
.B 0
اگر تمام عملیات‌ها با موفقیت و به طور عادی انجام شوند؛
.
.TP
.B 1
اگر گزینه یا آرگومان نامعتبری در خط فرمان وارد شده باشد؛
.
.TP
.B 2
اگر خطایی از سوی
.B Hamlib
بازگردانده شود.
.
.
.SH "مثال‌ها (EXAMPLES)"
.
نمونه‌ای از یک بسته ارسالی چندپخشی (multicast) به تاریخ 2023-10-20:
.
.PP
.EX
{
  "app": "Hamlib",
  "version": "4.6~git 2023-10-20T16:52:59Z SHA=d87671",
  "seq": 183,
  "time": "2023-10-20T20:13:53.139869-0000",
  "crc": 0,
  "rig": {
    "id": "FLRig:127.0.0.1:12345:30508",
    "status": "OK",
    "errorMsg": "",
    "name": "FLRig",
    "split": false,
    "splitVfo": "VFOA",
    "satMode": false,
    "modelist": "AM CW USB LSB FM CWR PKTLSB PKTUSB "
  },
  "vfos": [
    {
      "name": "VFOA",
      "freq": 14074270,
      "mode": "PKTUSB",
      "width": 3,
      "ptt": false,
      "rx": true,
      "tx": true
    },
    {
      "name": "VFOB",
      "freq": 14074500,
      "mode": "",
      "width": 0,
      "ptt": false,
      "rx": false,
      "tx": false
    }
  ],
  "spectra": [
    {
      "id": 0,
      "name": "?",
      "type": "FIXED",
      "minLevel": 0,
      "maxLevel": 0,
      "minStrength": 0,
      "maxStrength": 0,
      "centerFreq": 0,
      "span": 0,
      "lowFreq": 0,
      "highFreq": 0,
      "length": 0,
      "data": ""
    }
  ]
}
.EE
.
.
.SH "اشکالات (BUGS)"
.
این مستند به شکلی ناقص رها شده است.
.
.
.SH "کپی‌رایت و تکثیر (COPYING)"
.
این فایل بخشی از Hamlib است؛ پروژه‌ای برای توسعه کتابخانه‌ای که عملکردهای کنترل رادیو، روتاتور و تقویت‌کننده را برای توسعه‌دهندگان نرم‌افزارهای مرتبط با رادیوآماتوری و علاقه‌مندان به ارتباطات رادیویی تسهیل می‌کند.
.
.PP
کپی‌رایت \(co 2000-2011 Stephane Fillod
.br
کپی‌رایت \(co 2000-2026 the Hamlib Group (مشارکت‌کنندگان مختلف)
.br
کپی‌رایت \(co 2010-2026 Nate Bargmann
.
.PP
این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر و کپی‌رایت فایل COPYING را ببینید.
.
هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.
.
.SH "همچنین ببینید (SEE ALSO)"
.
.BR rigctl (1),
.BR hamlib (7)
.
.
.SH COLOPHON
.
پیوندها به ویکی Hamlib، مخزن گیت، آرشیوهای انتشار و آرشیوهای اسنپ‌شات روزانه از طریق
.
.UR http://www.hamlib.org
hamlib.org
.UE
در دسترس است.