.\"                                      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, rigsmtr.c
.\"
.TH RIGSMTR "1" "2020-09-09" "Hamlib" "Hamlib Utilities"
.
.
.SH "نام (NAME)"
.
rigsmtr \- سنجش مقادیر S-Meter در برابر زاویه سمت با استفاده از Hamlib
.
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.SY rigsmtr
.OP \-hvV
.OP \-m id
.OP \-r device
.OP \-s baud
.OP \-c id
.OP \-C parm=val
.OP \-M id
.OP \-R device
.OP \-S baud
.OP \-N parm=val
.RI [ time_step ]
.YS
.
.
.SH "توضیحات (DESCRIPTION)"
.
برنامه
.B rigsmtr
از
.B Hamlib
برای کنترل رادیو جهت اندازه‌گیری مقدار S-Meter در برابر زاویه سمت (azimuth) آنتن استفاده می‌کند.
.
.PP
این برنامه آنتن را از کمترین زاویه سمت تا بیشترین زاویه سمت می‌چرخاند.
در هر ثانیه، یا هر
.I time_step
در صورتی که بر حسب ثانیه مشخص شده باشد، قدرت سیگنال را دریافت می‌کند. زاویه سمت بر حسب درجه
و سطح متناظر S-Meter بر حسب dB نسبت به S9 سپس در
.BR stdout
چاپ می‌شوند.
.
.PP
برای کارکرد درست، rigsmtr به رادیویی نیاز دارد که بتواند S-Meter را بسنجد و یک
بک‌اند Hamlib که قادر به دریافت آن باشد، که به یک روتاتور (چرخاننده) پشتیبانی‌شده توسط Hamlib متصل شده باشد.
.
.PP
به یاد داشته باشید که Hamlib نرم‌افزاری در مرحله آزمایشی (BETA) است. اگرچه بسیاری از کتابخانه‌های
بک‌اند فاقد پشتیبانی کامل از رادیو هستند، عملکردهای پایه معمولاً به خوبی پشتیبانی می‌شوند.
.
.PP
لطفاً باگ‌ها را گزارش کرده و بازخورد خود را به نشانی رایانامه ارائه‌شده در بخش
.B گزارش باگ‌ها (BUGS)
در زیر ارسال کنید. وصله‌ها و بهبودهای کد ارسال‌شده به همان نشانی مورد استقبال قرار می‌گیرند.
.
.
.SH "گزینه‌ها (OPTIONS)"
.
این برنامه از نحو معمول خط فرمان GNU پیروی می‌کند. در گزینه‌های کوتاهی که
آرگومان می‌گیرند، مقدار می‌تواند بلافاصله پس از گزینه بیاید یا با یک فاصله جدا
شود. گزینه‌های بلندی که با دو خط تیره (\(oq\-\(cq) آغاز می‌شوند، نیازمند یک
\(oq=\(cq بین گزینه و هرگونه آرگومان هستند.
.
.PP
در اینجا خلاصه‌ای از گزینه‌های پشتیبانی‌شده آمده است:
.
.TP
.BR \-m ", " \-\-model = \fIid\fP
انتخاب شماره مدل رادیو.
.IP
فهرست مدل‌ها را ببینید (از \(lqrigctl \-l\(rq استفاده کنید).
.
.TP
.BR \-r ", " \-\-rig\-file = \fIdevice\fP
استفاده از
.I device
به‌عنوان نام فایل درگاهی که به رادیو متصل است.
.IP
اغلب یک درگاه سریال است، اما می‌تواند مبدل USB به سریال نیز باشد. معمولاً
.IR /dev/ttyS0 ", " /dev/ttyS1 ", " /dev/ttyUSB0
و غیره در Linux، و
.IR COM1 ", " COM2
و غیره در MS Windows. توزیع‌های BSD و Mac OS/X نام‌گذاری‌های خاص خود را دارند.
مستندات سیستم خود را ببینید.
.
.TP
.BR \-s ", " \-\-serial\-speed = \fIbaud\fP
تنظیم سرعت سریال رادیو به نرخ
.IR baud .
.IP
به‌طور پیش‌فرض از حداکثر سرعت سریال موجود در قابلیت‌های بک‌اند رادیو استفاده می‌کند.
.
.TP
.BR \-c ", " \-\-civaddr = \fIid\fP
استفاده از
.I id
به‌عنوان آدرس CI-V برای ارتباط با رادیو.
.IP
تنها برای رادیوهای Icom و برخی از رادیوهای Ten-Tec کاربرد دارد.
.IP
.BR نکته :
مقدار
.I id
در قالب ده‌دهی است، مگر اینکه پیشوند
.IR 0x
داشته باشد که در این صورت در قالب شانزده‌شانزدهی (hexadecimal) خواهد بود.
.
.TP
.BR \-C ", " \-\-set\-conf = \fIparm=val\fP [ \fI,parm=val\fP ]
تنظیم پارامتر(های) پیکربندی رادیو، برای مثال
.IR stop_bits=2 .
.IP
برای مشاهده فهرست پارامترهای پیکربندی یک شماره مدل مشخص، از گزینه
.B -L
در
.B rigctl
استفاده کنید.
.
.TP
.BR \-M ", " \-\-rot\-model = \fIid\fP
انتخاب شماره مدل روتاتور.
.IP
فهرست مدل‌ها را ببینید (از \(lqrotctl \-l\(rq استفاده کنید).
.
.TP
.BR \-R ", " \-\-rot\-file = \fIdevice\fP
استفاده از
.I device
به‌عنوان نام فایل درگاهی که به روتاتور متصل است.
.IP
اغلب یک درگاه سریال است، اما می‌تواند مبدل USB به سریال نیز باشد. معمولاً
.IR /dev/ttyS0 ", " /dev/ttyS1 ", " /dev/ttyUSB0
و غیره در Linux، و
.IR COM1 ", " COM2
و غیره در MS Windows. توزیع‌های BSD و Mac OS/X نام‌گذاری‌های خاص خود را دارند.
مستندات سیستم خود را ببینید.
.
.TP
.BR \-S ", " \-\-rot\-serial\-speed = \fIbaud\fP
تنظیم سرعت سریال روتاتور به نرخ
.IR baud .
.IP
به‌طور پیش‌فرض از حداکثر سرعت سریال موجود در قابلیت‌های بک‌اند روتاتور استفاده می‌کند.
.
.TP
.BR \-N ", " \-\-rot\-set\-conf = \fIparm=val\fP [ \fI,parm=val\fP ]
تنظیم پارامتر(های) پیکربندی روتاتور، برای مثال
.IR stop_bits=2 .
.IP
برای مشاهده فهرست پارامترهای پیکربندی یک شماره مدل مشخص، از گزینه
.B -L
در
.B rotctl
استفاده کنید.
.
.TP
.BR \-v ", " \-\-verbose
تنظیم حالت پرگو (verbose)، تجمعی (به بخش
.B خطاها (DIAGNOSTICS)
در زیر مراجعه کنید).
.
.TP
.BR \-h ", " \-\-help
نمایش خلاصه‌ای از این گزینه‌ها و خروج.
.
.TP
.BR \-V ", " \-\-version
نمایش نسخه
.B rigsmtr
و خروج.
..PP
.BR نکته :
برخی از گزینه‌ها ممکن است توسط یک backend خاص پیاده‌سازی نشده باشند و خطایی بازگردانند. این حالت بیش از همه ممکن است با گزینه‌های
.BR \-\-set\-conf " و " \-\-rot\-set\-conf
رخ دهد.
.
.
.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 تمام مقادیر ارسال‌شده به رادیو و دریافت‌شده از آن را نشان می‌دهد که برای توسعه کتابخانه backend رادیو بسیار مفید بوده و ممکن است توسط توسعه‌دهندگان درخواست شود.
.
.
.SH "وضعیت خروج (EXIT STATUS)"
.
.B rigsmtr
با این وضعیت‌ها خارج می‌شود:
.
.TP
.B 0
اگر تمام عملیات‌ها به‌طور عادی کامل شوند؛
.
.TP
.B 1
اگر یک گزینه یا آرگومان خط فرمان نامعتبر مشخص شده باشد؛
.
.TP
.B 2
اگر خطایی از سوی
.BR Hamlib
بازگردانده شود؛
.
.TP
.B 3
اگر رادیو قابلیت‌های لازم را نداشته باشد.
.
.
.SH "مثال‌ها (EXAMPLES)"
.
جمع‌آوری مقادیر خوانده‌شدهٔ S-Meter در یک TS\-850 در حین چرخش کامل 360\(de یک روتاتور EasycommII و ضبط اندازه‌گیری‌ها در فایل
.I csmtr
(متن تایپ‌شده به‌صورت پررنگ نشان داده شده است):
.
.PP
.in +4n
.EX
.RB $ " rigsmtr \-m 2009 \-r /dev/ttyS1 \-M 202 > csmtr"
.EE
.in
.
.PP
پس از اتمام، فایل
.I csmtr
شامل خطوطی مانند این خواهد بود:
.
.PP
.in +4n
.EX
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
.EE
.in
.
.PP
نتایج را می‌توان با
.BR gnuplot (1)
رسم کرد:
.
.PP
.in +4n
.EX
.RB $ " gnuplot"
.B set angles degrees
.B set polar
.B set grid polar 15.
.B unset border
.B unset param
.B set style data line
.B set rrange [-60:60]
.B set xrange [-60:60]
.B set yrange [-60:60]
.B plot csmtr
.EE
.in
.
..SH "گزارش باگ‌ها (BUGS)"
.
گزارش باگ‌ها به:
.IP
.nf
.MT hamlib\-developer@lists.sourceforge.net
فهرست پستی توسعه‌دهندگان Hamlib
.ME
.fi
.
.
.SH "کپی‌رایت و تکثیر (COPYING)"
.
این پرونده بخشی از Hamlib است؛ پروژه‌ای برای توسعهٔ کتابخانه‌ای که توابع کنترلی
رادیو، چرخاننده و تقویت‌کننده را برای توسعه‌دهندگان نرم‌افزارهایی که عمدتاً
مورد توجه رادیوآماتورها و علاقه‌مندان به ارتباطات رادیویی هستند، ساده می‌کند.
.
.PP
حق نشر \(co 2007-2009 Stephane Fillod
.br
حق نشر \(co 2018-2020 Nate Bargmann
.PP
این یک نرم‌افزار آزاد است؛ برای شرایط رونوشت‌برداری پروندهٔ COPYING را ببینید.
هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.
.
.SH "همچنین ببینید (SEE ALSO)"
.
.BR gnuplot (1),
.BR rigctl (1),
.BR rotctl (1),
.BR hamlib (7)
.
.
.SH "شناسنامه (COLOPHON)"
.
پیوندها به ویکی Hamlib، مخزن Git، بایگانی‌های انتشار و بایگانی‌های نسخه‌های
روزانه (daily snapshot) از طریق
.
.UR http://www.hamlib.org
hamlib.org
.UE
در دسترس هستند.