RIGSMTR(1) Hamlib Utilities RIGSMTR(1)

rigsmtr - سنجش مقادیر S-Meter در برابر زاویه سمت با استفاده از Hamlib

rigsmtr [-hvV] [-m id] [-r device] [-s baud] [-c id] [-C parm=val] [-M id] [-R device] [-S baud] [-N parm=val] [time_step]

برنامه rigsmtr از Hamlib برای کنترل رادیو جهت اندازه‌گیری مقدار S-Meter در برابر زاویه سمت (azimuth) آنتن استفاده می‌کند.

این برنامه آنتن را از کمترین زاویه سمت تا بیشترین زاویه سمت می‌چرخاند. در هر ثانیه، یا هر time_step در صورتی که بر حسب ثانیه مشخص شده باشد، قدرت سیگنال را دریافت می‌کند. زاویه سمت بر حسب درجه و سطح متناظر S-Meter بر حسب dB نسبت به S9 سپس در stdout چاپ می‌شوند.

برای کارکرد درست، rigsmtr به رادیویی نیاز دارد که بتواند S-Meter را بسنجد و یک بک‌اند Hamlib که قادر به دریافت آن باشد، که به یک روتاتور (چرخاننده) پشتیبانی‌شده توسط Hamlib متصل شده باشد.

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

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

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

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

انتخاب شماره مدل رادیو.
فهرست مدل‌ها را ببینید (از “rigctl -l” استفاده کنید).
استفاده از device به‌عنوان نام فایل درگاهی که به رادیو متصل است.
اغلب یک درگاه سریال است، اما می‌تواند مبدل USB به سریال نیز باشد. معمولاً /dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0 و غیره در Linux، و COM1, COM2 و غیره در MS Windows. توزیع‌های BSD و Mac OS/X نام‌گذاری‌های خاص خود را دارند. مستندات سیستم خود را ببینید.
تنظیم سرعت سریال رادیو به نرخ baud.
به‌طور پیش‌فرض از حداکثر سرعت سریال موجود در قابلیت‌های بک‌اند رادیو استفاده می‌کند.
استفاده از id به‌عنوان آدرس CI-V برای ارتباط با رادیو.
تنها برای رادیوهای Icom و برخی از رادیوهای Ten-Tec کاربرد دارد.
نکته: مقدار id در قالب ده‌دهی است، مگر اینکه پیشوند 0x داشته باشد که در این صورت در قالب شانزده‌شانزدهی (hexadecimal) خواهد بود.
تنظیم پارامتر(های) پیکربندی رادیو، برای مثال stop_bits=2.
برای مشاهده فهرست پارامترهای پیکربندی یک شماره مدل مشخص، از گزینه -L در rigctl استفاده کنید.
انتخاب شماره مدل روتاتور.
فهرست مدل‌ها را ببینید (از “rotctl -l” استفاده کنید).
استفاده از device به‌عنوان نام فایل درگاهی که به روتاتور متصل است.
اغلب یک درگاه سریال است، اما می‌تواند مبدل USB به سریال نیز باشد. معمولاً /dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0 و غیره در Linux، و COM1, COM2 و غیره در MS Windows. توزیع‌های BSD و Mac OS/X نام‌گذاری‌های خاص خود را دارند. مستندات سیستم خود را ببینید.
تنظیم سرعت سریال روتاتور به نرخ baud.
به‌طور پیش‌فرض از حداکثر سرعت سریال موجود در قابلیت‌های بک‌اند روتاتور استفاده می‌کند.
تنظیم پارامتر(های) پیکربندی روتاتور، برای مثال stop_bits=2.
برای مشاهده فهرست پارامترهای پیکربندی یک شماره مدل مشخص، از گزینه -L در rotctl استفاده کنید.
تنظیم حالت پرگو (verbose)، تجمعی (به بخش خطاها (DIAGNOSTICS) در زیر مراجعه کنید).
نمایش خلاصه‌ای از این گزینه‌ها و خروج.
نمایش نسخه rigsmtr و خروج. نکته: برخی از گزینه‌ها ممکن است توسط یک backend خاص پیاده‌سازی نشده باشند و خطایی بازگردانند. این حالت بیش از همه ممکن است با گزینه‌های --set-conf و --rot-set-conf رخ دهد.

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

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

rigsmtr با این وضعیت‌ها خارج می‌شود:

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

جمع‌آوری مقادیر خوانده‌شدهٔ S-Meter در یک TS-850 در حین چرخش کامل 360° یک روتاتور EasycommII و ضبط اندازه‌گیری‌ها در فایل csmtr (متن تایپ‌شده به‌صورت پررنگ نشان داده شده است):


$ rigsmtr -m 2009 -r /dev/ttyS1 -M 202 > csmtr

پس از اتمام، فایل csmtr شامل خطوطی مانند این خواهد بود:


0 -47
30 -40
60 -22
90 -3
120 10
150 1
180 -11
210 -24
240 -35
270 -42
300 -48
330 -51
360 -49

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


$ gnuplot
set angles degrees
set polar
set grid polar 15.
unset border
unset param
set style data line
set rrange [-60:60]
set xrange [-60:60]
set yrange [-60:60]
plot csmtr
گزارش باگ‌ها به: 

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

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

حق نشر © 2007-2009 Stephane Fillod
حق نشر © 2018-2020 Nate Bargmann

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

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

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

2020-09-09 Hamlib