نام (NAME)

rigctlcom - عبوردهنده پورت COM به عنوان شبیه‌ساز TS-2000 برای رادیو آماتور شما

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

توضیحات (DESCRIPTION)

به برنامه‌هایی که می‌توانند از طریق پورت COM به TS-2000 متصل شوند، اجازه می‌دهد از رادیوهای Hamlib یا FLRig استفاده کنند. چندین برنامه می‌توانند از طریق FLRig یا rigctld به رادیو متصل شوند.

پورت‌های سریال/COM مجازی باید ابتدا با استفاده از socat(1) یا ابزارهای مشابه در سیستم‌های POSIX (مانند BSD، لینوکس، OS/X) راه‌اندازی شوند. در مایکروسافت ویندوز ابزارهای در دسترس عبارتند از com0com، Free Virtual Serial Ports یا VPSD.

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

گزینه‌ها (OPTIONS)

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

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

-m, --model=id

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

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

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

-r, --rig-file=device

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

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

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

-R, --rig-file2=device

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

پورت‌های سریال مجازی در سیستم‌های POSIX را می‌توان با socat(1) پیاده‌سازی کرد:

$ socat -d -d pty,raw,echo=0 pty,raw,echo=0

این پاسخ استک‌اورفلو برای استفاده از socat را ببینید.

در مایکروسافت ویندوز ابزارهای در دسترس عبارتند از com0com، Free Virtual Serial Ports، یا VPSD (پیوندهای وب را در بخش توضیحات (DESCRIPTION) در بالا ببینید).

-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’ و ‘NONE’، که نوع PTT تعریف‌شده در بک‌اند رادیو را بازنویسی می‌کند.

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

-D, --dcd-type=type

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

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

-s, --serial-speed=baud

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

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

-S, --serial-speed2=baud

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

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

-c, --civaddr=id

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

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

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

-L, --show-conf

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

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

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

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

-u, --dump-caps

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

-l, --list

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

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

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

-n, --no-restore-ai

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

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

-B, --mapa2b

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

-v, --verbose

تنظیم حالت پرگو، به صورت تجمیعی (به بخش عیب‌یابی (DIAGNOSTICS) در ادامه مراجعه کنید).

-Z, --debug-time-stamps

فعال‌سازی برچسب‌های زمانی برای پیام‌های اشکال‌زدایی.

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

-h, --help

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

-V, --version

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

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

عیب‌یابی (DIAGNOSTICS)

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

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

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

دستور rigctlcom با کدهای زیر خارج می‌شود:

0

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

1

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

2

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

مثال (EXAMPLE)

اجرای rigctlcom با FLRig به عنوان مدل Hamlib و جفت پورت COM مجازی COM9/COM10؛ برای نمونه: N1MM Logger+ متصل به COM10 و استفاده از شبیه‌ساز TS-2000 متصل به COM9 (با فرض اینکه لوله پورت‌های سریال/COM مجازی با ابزار مناسب طبق توضیحات بالا ایجاد شده باشد):

$ rigctlcom -m 4 -R COM9 -S 115200

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

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

اشکالات (BUGS)

گزارش اشکالات به:

Hamlib Developer mailing list

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

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

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

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

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

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

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

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