نام (NAME)

rigswr - اندازه‌گیری VSWR بر حسب فرکانس.

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

rigswr [-hvV] [-m id] [-r device] [-s baud] [-c id] [-C parm=val] [-p device] [-P type] start_freq stop_freq [freq_step]

توضیحات (DESCRIPTION)

دستور rigswr از Hamlib برای کنترل یک رادیو جهت اندازه‌گیری VSWR (نسبت موج ایستاده ولتاژ) در یک بازه فرکانسی استفاده می‌کند.

این برنامه فرکانس‌ها را از start_freq تا stop_freq با گام افزایشی اختیاریِ freq_step پویش می‌کند (گام پیش‌فرض ۱۰۰ کیلوهرتز است). تمام مقادیر باید به‌صورت یک عدد صحیح بر حسب هرتز (سیکل بر ثانیه) وارد شوند.

نکته: دستور rigswr فرض می‌کند که start_freq کوچک‌تر یا مساوی stop_freq است. در صورتی که بزرگ‌تر باشد، rigswr بدون انجام هیچ کاری خارج خواهد شد.

برای هر فرکانس، برنامه با ۲۵٪ توان کل (POWER) به مدت ۰٫۵ ثانیه در حالت CW ارسال انجام می‌دهد و مقدار VSWR را می‌خواند.

فرکانس و VSWR متناظر با آن سپس در stdout چاپ می‌شوند.

برای کارکرد درست، rigswr به رادیویی نیاز دارد که قابلیت سنجش VSWR را داشته باشد و همچنین یک backend در Hamlib که از خواندن VSWR از رادیو پشتیبانی کند.

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

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

گزینه‌ها (OPTIONS)

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

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

-m, --model=id: انتخاب شماره مدل رادیو.

: مشاهده فهرست مدل‌ها (با استفاده از “rigctl -l”).

-r, --rig-file=device: استفاده از device به‌عنوان نام فایل درگاه متصل به رادیو.

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

-s, --serial-speed=baud: تنظیم سرعت سریال رادیو بر روی نرخ baud.

: به‌عنوان پیش‌فرض از حداکثر سرعت سریال موجود در قابلیت‌های backend رادیو استفاده می‌کند.

-c, --civaddr=id: استفاده از id به‌عنوان آدرس CI-V برای ارتباط با رادیو.

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

-C, --set-conf=parm=val[,parm=val]: تنظیم پارامتر(های) پیکربندی رادیو، مانند stop_bits=2.

: برای مشاهده فهرست پارامترهای پیکربندی برای یک شماره مدل معین، از گزینه -L دستور rigctl استفاده کنید.

-p, --ptt-file=device: استفاده از device به‌عنوان نام فایل درگاه Push-To-Talk با بهره‌گیری از یک فایل دستگاه مانند گزینه -r در بالا.

: این مورد تنها زمانی لازم است که رادیو کنترل CAT PTT نداشته باشد و برای فعال‌سازی فرستنده به یک درگاه دستگاه جداگانه نیاز داشته باشد.

-P, --ptt-type=type: استفاده از type دستگاه Push-To-Talk.

: انواع پشتیبانی‌شده عبارتند از RIG (CAT)، DTR، RTS، PARALLEL و NONE.

-v, --verbose: تنظیم حالت پرگو (verbose)، تجمعی (به بخش خطاها (DIAGNOSTICS) در زیر مراجعه کنید).
-h, --help: نمایش خلاصه‌ای از این گزینه‌ها و خروج.
-V, --version: نمایش نسخه rigswr و خروج.

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

خطاها (DIAGNOSTICS)

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

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

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

دستور rigswr با وضعیت‌های زیر خاتمه می‌یابد:

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

مثال‌ها (EXAMPLES)

پویش فرکانس‌های بین 14.000 MHz و 14.200 MHz با گام 50 kHz بر روی یک TS-850 و ذخیره اندازه‌گیری‌های VSWR در فایل cswr (متن تایپ‌شده به‌صورت پررنگ نشان داده شده است):

$ rigswr -m 2009 -r /dev/ttyS1 14000000 14200000 50000 > cswr

پس از اتمام، cswr حاوی خطوط زیر خواهد بود:

14000000 1.50
14050000 1.31
14100000 1.22
14150000 1.07
14200000 1.07

نتیجه را می‌توان با gnuplot(1) رسم کرد:

$ gnuplot
set data style linespoints
set grid
plot cswr

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

بسته به پیکربندی keyer/QSK، ممکن است ارسال‌ها در حالت CW مدوله نشوند و در نتیجه احتمالاً نتیجه نادرستی حاصل شود. لطفاً در صورت وقوع، این وضعیت را گزارش دهید.

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


Hamlib Developer mailing list

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

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

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

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

gnuplot(1), rigctl(1), hamlib(7)

COLOPHON

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