.\"                                      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, ampctld.c
.\"
.TH AMPCTLD "1" "2020-09-09" "Hamlib" "Hamlib Utilities"
.
.
.SH "نام (NAME)"
.
ampctld \- دیمن کنترل تقویت‌کننده تحت TCP
.
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.SY ampctld
.OP \-hlLuV
.OP \-m id
.OP \-r device
.OP \-s baud
.OP \-T IPADDR
.OP \-t number
.OP \-C parm=val
.RB [ \-v [ \-Z ]]
.YS
.
.
.SH "توضیحات (DESCRIPTION)"
.
برنامه
.B ampctld
یک دیمن کنترل تقویت‌کننده است که درخواست‌های کلاینت را از طریق سوکت‌های TCP
مدیریت می‌کند. این قابلیت به چندین برنامه کاربر امکان می‌دهد یک تقویت‌کننده را به اشتراک
بگذارند (این ویژگی نیازمند توسعه بیشتر است). چندین تقویت‌کننده را می‌توان با
استفاده از چندین فرایند
.B ampctld
روی درگاه‌های TCP مختلف کنترل کرد. توجه داشته باشید در صورتی که برخی از کلاینت‌ها
از پاسخ‌های توسعه‌یافته (extended responses) و/یا حالت vfo استفاده کنند، استفاده از
چندین فرایند/درگاه نیز الزامی خواهد بود. بنابراین ممکن است برای هر ترکیب از پاسخ
توسعه‌یافته/حالت vfo به حداکثر ۴ فرایند/درگاه نیاز باشد. نحو دستورها همانند
.BR ampctl (1)
است. امید می‌رود که
.B ampctld
به‌ویژه برای نویسندگان کلاینت که از زبان‌هایی مانند Perl، Python، PHP و غیره
استفاده می‌کنند، مفید واقع شود.
.
.PP
.B ampctld
از طریق یک سوکت TCP با استفاده از دستورهای متنی مشترک با
.BR ampctl
با کلاینت ارتباط برقرار می‌کند. پروتکل ساده است؛ دستورها در یک خط به
.B ampctld
ارسال می‌شوند و
.B ampctld
در صورت موفقیت، به دستورهای
.B get
با مقادیر درخواستی (هر مقدار در یک خط) پاسخ می‌دهد؛ در غیر این صورت، پاسخی در قالب یک
خط حاوی \(lqRPRT x\(rq بازمی‌گرداند که در آن \(oqx\(cq یک عدد منفی نشان‌دهنده کد
خطا است. دستورهایی که مقداری را برنمی‌گردانند با خط \(lqRPRT x\(rq پاسخ می‌دهند
که در آن \(oqx\(cq در صورت موفقیت برابر \(oq0\(cq و در غیر این صورت یک عدد منفی
نشان‌دهنده کد خطا است. هر خط با نویسه خط جدید \(oq\\n\(cq پایان می‌یابد. این
پروتکل عمدتاً برای استفاده توسط بک‌اندِ
.B NET ampctl
(تقویت‌کننده مدل ۲) است.
.
.PP
یک
.B Extended Response Protocol
مجزا، رفتار فوق را با بازتاب دادن رشته دستور دریافتی به عنوان سرآیند، هر مقدار
بازگشتی به عنوان یک جفت key: value، و رشته \(lqRPRT x\(rq به عنوان نشانگر پایان
پاسخ که شامل مقدار موفقیت یا شکست
.B Hamlib
است، گسترش می‌دهد. برای جزئیات به بخش
.B PROTOCOL
مراجعه کنید. استفاده از این پروتکل را برای کلاینت‌هایی که مستقیماً از طریق
سوکت TCP با
.B ampctld
تعامل دارند در نظر داشته باشید.
.
.PP
به یاد داشته باشید که Hamlib نرم‌افزاری در سطح آزمایشی (BETA) است. اگرچه بسیاری از
کتابخانه‌های بک‌اند فاقد پشتیبانی کامل از تقویت‌کننده هستند، اما عملکردهای پایه‌ای
معمولاً به خوبی پشتیبانی می‌شوند.
.
.PP
لطفاً باگ‌ها را گزارش کرده و بازخورد خود را به نشانی ایمیل ارائه‌شده در بخش
.B گزارش باگ‌ها (BUGS)
در زیر ارسال کنید. از وصله‌ها و بهبودهای کد ارسالی به همین نشانی استقبال می‌شود.
.
..SH "گزینه‌ها (OPTIONS)"
.
این برنامه از نحو معمول خط فرمان GNU پیروی می‌کند. در گزینه‌های کوتاه که یک آرگومان دریافت می‌کنند، مقدار می‌تواند بلافاصله پس از گزینه بیاید یا با یک فاصله از آن جدا شود. گزینه‌های طولانی که با دو خط تیره (\(oq\-\(cq) آغاز می‌شوند، به یک \(oq=\(cq میان گزینه و هر آرگومان نیاز دارند.
.
.PP
در اینجا خلاصه‌ای از گزینه‌های پشتیبانی‌شده آورده شده است:
.
.TP
.BR \-m ", " \-\-model = \fIid\fP
انتخاب شماره مدل تقویت‌کننده (amplifier).
.IP
فهرست مدل‌ها را ببینید (از \(lqampctl -l\(rq استفاده کنید).
.IP
.BR نکته :
برنامه
.B ampctl
(یا نرم‌افزارهای شخص ثالثی که از C API استفاده می‌کنند) از مدل تقویت‌کننده ۲ برای
.B NET ampctl
(جهت ارتباط با
.BR ampctld )
استفاده خواهد کرد.
.
.TP
.BR \-r ", " \-\-amp\-file = \fIdevice\fP
استفاده از
.I device
به‌عنوان نام فایل پورت متصل به تقویت‌کننده.
.IP
اغلب یک پورت سریال است، اما می‌تواند یک مبدل USB به سریال نیز باشد. معمولاً
.IR /dev/ttyS0 ", " /dev/ttyS1 ", " /dev/ttyUSB0
و غیره در لینوکس، و
.IR COM1 ", " COM2
و غیره در MS Windows است. توزیع‌های BSD و Mac OS/X نام‌گذاری‌های خاص خود را دارند. مستندات سیستم خود را ببینید.
.
.TP
.BR \-s ", " \-\-serial\-speed = \fIbaud\fP
تنظیم سرعت سریال روی نرخ
.IR baud .
.IP
به‌طور پیش‌فرض از حداکثر سرعت سریال برگرفته از قابلیت‌های باک‌اند تقویت‌کننده (تنظیم‌شده توسط
.B \-m
در بالا) استفاده می‌کند.
.
.TP
.BR \-t ", " \-\-port = \fInumber\fP
استفاده از
.I number
به‌عنوان پورت شنود TCP.
.IP
مقدار پیش‌فرض 4531 است.
.IP
.BR نکته :
از آنجا که پورت پیش‌فرض
.B rigctld
برابر با 4532 و پورت پیش‌فرض
.B rotctld
برابر با 4533 است، توصیه می‌شود برای چندین نمونه از
.BR ampctld
از پورت‌های فرد نزولی استفاده شود؛ مانند 4529، 4527، 4525 و غیره.
.
.TP
.BR \-T ", " \-\-listen\-addr = \fIIPADDR\fP
استفاده از
.I IPADDR
به‌عنوان آدرس IP شنود.
.IP
مقدار پیش‌فرض ANY است.
.
.TP
.BR \-L ", " \-\-show\-conf
فهرست کردن تمام پارامترهای پیکربندی برای تقویت‌کنندهٔ تعریف‌شده با
.B \-m
در بالا.
.
.TP
.BR \-C ", " \-\-set\-conf = \fIparm=val\fP [ \fI,parm=val\fP ]
تنظیم پارامتر(های) پیکربندی تقویت‌کننده، مانند
.IR stop_bits=2 .
.IP
برای مشاهدهٔ فهرست پارامترهای پیکربندی یک شماره مدل مشخص، از گزینهٔ
.B \-L
در بالا استفاده کنید.
.
.TP
.BR \-u ", " \-\-dump\-caps
تخلیه (dump) قابلیت‌های تقویت‌کنندهٔ تعریف‌شده با
.B \-m
در بالا و خروج.
.
.TP
.BR \-l ", " \-\-list
فهرست کردن تمام شماره‌های مدل تقویت‌کنندهٔ تعریف‌شده در
.B Hamlib
و خروج.
.IP
این فهرست بر اساس شماره مدل مرتب شده است.
.IP
.BR نکته :
در لینوکس می‌توان با استفاده از
.BR Shift-PageUp / Shift-PageDown
یا با استفاده از نوارهای پیمایش یک ترمینال مجازی در X یا پنجره cmd در ویندوز، فهرست را به عقب پیمایش کرد. خروجی را می‌توان به
.BR more (1)
یا
.BR less (1)
نیز هدایت (pipe) کرد؛ مانند \(lqampctl -l | more\(rq.
.
.TP
.BR \-v ", " \-\-verbose
تنظیم حالت پرگو (verbose)، به‌صورت تجمعی (بخش
.B "خطاها (DIAGNOSTICS)"
در زیر را ببینید).
.
.TP
.BR \-Z ", " \-\-debug\-time\-stamps
فعال کردن برچسب‌های زمانی برای پیام‌های اشکال‌زدایی (debug).
.IP
تنها در ترکیب با گزینهٔ
.B \-v
استفاده شود، زیرا به‌تنهایی خروجی تولید نمی‌کند.
.
.TP
.BR \-h ", " \-\-help
نمایش خلاصه‌ای از این گزینه‌ها و خروج.
.
.TP
.BR \-V ", " \-\-version
نمایش نسخهٔ
.B ampctl
و خروج.
.
.PP
.BR نکته :
برخی از گزینه‌ها ممکن است توسط یک باک‌اند خاص پیاده‌سازی نشده باشند و خطایی بازگردانند. این مورد بیشتر برای گزینه‌های
.B \-\-set\-conf
و
.B \-\-show\-conf
رخ می‌دهد.
.
.PP
لطفاً توجه داشته باشید که باک‌اند مربوط به تقویت‌کنندهٔ تحت کنترل، یا خودِ تقویت‌کننده ممکن است از برخی دستورها پشتیبانی نکنند. در این صورت، عملیات با یک کد خطای
.B Hamlib
شکست خواهد خورد.
..SH "دستورها (COMMANDS)"
.
دستورها می‌توانند از طریق سوکت TCP به صورت یک تک‌نویسه، یا به صورت نام بلند دستور به‌همراه مقدارهای جداشده با فاصله در یک خط که به \(oq\\n\(cq ختم می‌شود، ارسال شوند. بخش
.BR PROTOCOL
را ببینید.
.
.PP
از آن‌جا که بیشتر عملیات‌های
.B Hamlib
دارای یک متد
.B set
و یک متد
.B get
هستند، یک حرف بزرگ انگلیسی برای متدهای
.B set
به‌کار می‌رود در حالی که حرف کوچک متناظر با آن به متد
.B get
اشاره دارد. هر عملیات همچنین یک نام بلند دارد؛ برای ارسال نام بلند دستور، یک بک‌اسلش، \(oq\\\(cq، را به ابتدای آن اضافه کنید.
.
.PP
مثال (Perl): \(lqprint $socket "\\\\dump_caps\\n";\(rq برای دیدن کارهایی که بک‌اند تقویت‌کننده (amplifier) می‌تواند انجام دهد
.RB ( "نکته" :
در Perl و بسیاری از زبان‌های دیگر یک \(oq\\\(cq باید با یک \(oq\\\(cq قبل از خود گریز (escape) داده شود، بنابراین حتی اگر دو نویسه بک‌اسلش در کد دیده شود، تنها یک نویسه به
.BR ampctld
ارسال خواهد شد. این ممکن است خطاساز باشد، مراقب باشید!).
.
.PP
.BR "نکته" :
بک‌اند مربوط به تقویت‌کننده‌ای که قرار است کنترل شود، یا خود تقویت‌کننده، ممکن است از برخی دستورها پشتیبانی نکنند. در این صورت، عملیات با یک پیام خطای
.B Hamlib
شکست می‌خورد.
.
.PP
در ادامه خلاصه‌ای از دستورهای پشتیبانی‌شده آمده است (در مورد دستورهای
.B set
رشته کج (italic) داخل گیومه با مقدار موجود در توضیحات جایگزین می‌شود. در مورد دستورهای
.B get
رشته کج داخل گیومه نام کلید مقدار بازگردانده‌شده است):
.
.TP
.BR F ", " set_freq " \(aq" \fIFrequency\fP \(aq
تنظیم
.RI \(aq Frequency \(aq
(فرکانس) به هرتز (Hz).
.IP
فرکانس می‌تواند یک مقدار عدد ممیز شناور یا عدد صحیح باشد.
.
.TP
.BR f ", " get_freq
دریافت
.RI \(aq Frequency \(aq
به هرتز (Hz).
.IP
یک مقدار عدد صحیح را بازمی‌گرداند.
.
.TP
.BR l ", " get_level " \(aq" \fILevel\fP \(aq
دریافت
.RI \(aq "Level Value" \(aq
(مقدار سطح).
.IP
مقدار سطح (Level Value) را به صورت عدد اعشاری یا عدد صحیح برای توکن Level داده‌شده بازمی‌گرداند.
.IP
.BR "نکته" :
ارسال \(oq?\(cq (پرس‌وجو) به عنوان آرگومان نخست به جای توکن Level، فهرستی جداشده با فاصله از توکن‌های get level پشتیبانی‌شده توسط بک‌اند تقویت‌کننده را برمی‌گرداند. از این مورد برای تشخیص سطوح پشتیبانی‌شده توسط یک بک‌اند تقویت‌کننده مشخص استفاده کنید.
.
.TP
.B dump_state
بازگرداندن اطلاعات وضعیت مشخصی درباره بک‌اند تقویت‌کننده.
.
.TP
.BR 1 ", " dump_caps
این یک دستور راه دور (remote) واقعی تقویت‌کننده نیست، صرفاً قابلیت‌ها را تخلیه (dump) می‌کند، یعنی آنچه بک‌اند درباره این مدل می‌داند و کارهایی که می‌تواند انجام دهد.
.IP
TODO: اطمینان حاصل شود که این خروجی ساختار ثابتی دارد تا بتوان آن را در یک hash، دیکشنری یا موارد مشابه خواند. لطفاً گزارش‌های اشکال را ارسال کنید.
.IP
.BR "نکته" :
این دستور خطوط خروجی زیادی تولید خواهد کرد، بنابراین اگر از آرایه‌ای با طول ثابت استفاده می‌کنید بسیار مراقب باشید! به عنوان مثال، اجرای این دستور در برابر بک‌اند Dummy خطوط متعددی از خروجی متنی تولید می‌کند.
.
.TP
.BR _ ", " get_info
بازگرداندن اطلاعات از بک‌اند تقویت‌کننده.
.
.TP
.BR R ", " reset " \(aq" \fIReset\fP \(aq
انجام
.RI \(aq Reset \(aq
تقویت‌کننده.
.IP
مقدار Reset یک عدد صحیح است: \(oq0\(cq = هیچ‌کدام (None)، \(oq1\(cq = بازنشانی حافظه (Memory reset)،
\(oq2\(cq = بازنشانی خطا (Fault reset)، \(oq3\(cq = بازنشانی تقویت‌کننده (Amplifier reset).
.
.TP
.BR set_powerstat " \(aq" "\fIPower Status\fP" \(aq
تنظیم
.RI \(aq "Power Status" \(aq
(وضعیت توان/برق).
.IP
مقدار Power Status یک عدد صحیح است: \(oq0\(cq = خاموش (Power Off)، \(oq1\(cq = روشن (Power On)،
\(oq2\(cq = آماده‌به‌کار (Power Standby - ورود به وضعیت standby)، \(oq4\(cq = عملیاتی (Power Operate - خروج از وضعیت standby).
.
.TP
.B get_powerstat
دریافت
.RI \(aq "Power Status" \(aq
همانند
.B set_powerstat
در بالا.
..SH "پروتکل (PROTOCOL)"
.
دو پروتکل توسط
.B ampctld
مورد استفاده قرار می‌گیرند:
.B پروتکل پیش‌فرض
و
.BR "پروتکل پاسخ گسترده (Extended Response Protocol)" .
.
.PP
.B پروتکل پیش‌فرض
در درجه اول برای برقراری ارتباط میان توابع کتابخانه
.B Hamlib
و
.B ampctld
(\(lqNET ampctl\(rq، در دسترس با استفاده از مدل تقویت‌کننده \(oq2\(cq) در نظر گرفته شده است.
.
.PP
.B پروتکل پاسخ گسترده
برای استفاده در اسکریپت‌ها یا سایر برنامه‌هایی که مستقیماً با
.B ampctld
در تعامل هستند در نظر گرفته شده است، چرا که بازخورد یکپارچه و پایداری ارائه می‌دهد.
.
.
.SS "پروتکل پیش‌فرض (Default Protocol)"
.
.B پروتکل پیش‌فرض
عمداً ساده طراحی شده است. دستورها به همراه هر مقدار مورد نیاز در یک خط وارد می‌شوند. در عمل، با پایان دادن به هر رشته دستور با یک نویسه خط‌جدید، یعنی \(oq\\n\(cq، نتایج قابل اطمینانی به دست می‌آید.
.
.PP
مثال دستورهای تنظیم فرکانس و حالت (کد Perl (متن تایپ‌شده به‌صورت پررنگ نشان داده شده است)):
.
.PP
.in +4n
.EX
\fBprint $socket "F 14250000\\n";\fP
\fBprint $socket "\\\\set_powerstat 1\\n";\fP # escape leading '\\'
.EE
.in
.
.PP
یک پاسخ تک‌خطی در جواب دستورهای
.B set
ارسال خواهد شد: \(lqRPRT \fIx\fP\\n\(rq که در آن
.I x
کد خطای Hamlib است و \(oq0\(cq نشان‌دهنده موفقیت دستور است.
.
.PP
پاسخ‌ها از دستورهای
.B get
در
.B ampctld
مقادیر متنی هستند و با همان نشانه‌های استفاده‌شده در دستورهای
.B set
مطابقت دارند. هر مقدار در یک خط جداگانه بازگردانده می‌شود. در صورت بروز خطا، رشته \(lqRPRT \fIx\fP\\n\(rq بازگردانده می‌شود که در آن
.I x
کد خطای Hamlib است.
.
.PP
مثال دریافت فرکانس (کد Perl):
.
.PP
.in +4n
.EX
\fBprint $socket "f\\n";\fP
"14250000\\n"
.EE
.in
.
.PP
بیشتر توابع
.B get
یک تا سه مقدار را بازمی‌گردانند. یک استثنای قابل توجه دستور
.B dump_caps
است که خطوط متعددی از جفت‌های
\fBkey\fR:\fIvalue\fR
را بازمی‌گرداند.
.
.PP
این پروتکل عمدتاً توسط بک‌اند \(lqNET ampctl\(rq (مدل ۲ ampctl) استفاده می‌شود که به برنامه‌هایی که پیش‌تر برای C API مربوط به Hamlib نوشته شده‌اند امکان می‌دهد بدون نیاز به بازنویسی کد برنامه، از
.B ampctld
بهره ببرند. کاربر برنامه می‌تواند مدل تقویت‌کننده ۲ (\(lqNET ampctl\(rq) را انتخاب کرده و سپس
.B amp_pathname
را روی \(lqlocalhost:4531\(rq یا سایر
.IR host : port
های شبکه (که به ترتیب با گزینه‌های
.BR \-T / \-t
در بالا تنظیم می‌شوند) قرار دهد.
.
..SS پروتکل پاسخ گسترش‌یافته (Extended Response Protocol)
.
پروتکل پاسخ گسترش‌یافته چندین قاعده به رشته‌های بازگردانده شده توسط
.B ampctld
و یک قاعده به نحو دستورات اضافه می‌کند.
.
.PP
۱. دستوری که توسط
.B ampctld
دریافت می‌شود، با نام طولانی دستور و به دنبال آن مقدار(ها)یی (در صورت وجود)
که از کلاینت دریافت شده و با جداکننده پاسخ مشخص‌شده پایان می‌یابد، به عنوان
نخستین رکوردِ پاسخ بازتاب داده می‌شود (echo).
.
.PP
۲. آخرین رکورد هر بلوک رشته‌ی \(lqRPRT \fIx\fP\\n\(rq است که در آن
.I x
مقدار بازگشتی عددی از تابع بک‌اند Hamlib است که توسط دستور فراخوانی شده است.
.
.PP
۳. هر رکوردی شامل مقادیر داده که توسط بک‌اند تقویت‌کننده (amplifier) بازگردانده
می‌شود، با یک رشته آغاز شده و بلافاصله پس از آن دو‌نقطه و سپس یک فاصله و در
نهایت مقدارِ پایان‌یافته با جداکننده پاسخ قرار می‌گیرد. مانند \(lqFrequency:
14250000\\n\(rq هنگامی که در ابتدای دستور \(oq+\(cq قرار گرفته باشد.
.
.PP
۴. تمامی دستورهای دریافت شده توسط
.B ampctld
با رکوردهای حاصل از قوانین ۱ و ۲ تأیید (acknowledge) خواهند شد. رکوردهای
حاصل از قانون ۳ تنها زمانی بازگردانده می‌شوند که لازم باشد مقادیر داده به
کلاینت بازگردانده شوند.
.
.PP
یک نمونه پاسخ به دستور
.B set_frequency
ارسال‌شده از خط فرمان شل (به \(oq+\(cq ابتدایی دقت کنید):
.
.PP
.in +4n
.EX
$ \fBecho "+F 14250000" | nc -w 1 localhost 4531\fP
set_freq: 14250000
RPRT 0
.EE
.in
.
.PP
در این حالت، نام طولانی دستور و مقادیر در خط نخست بازگردانده می‌شوند و خط دوم
شامل نشانگر پایان بلوک و مقدار بازگشتی عددی بک‌اند تقویت‌کننده است که نشان‌دهنده
موفقیت‌آمیز بودن است.
.
.PP
یک نمونه پاسخ به پرسمان
.BR get_freq :
.
.PP
.in +4n
.EX
$ \fBecho "+\\get_freq" | nc -w 1 localhost 4531\fP
get_freq:
Frequency(Hz): 14250000
RPRT 0
.EE
.in
.
.IP
.BR نکته :
نویسه \(oq\\\(cq حتی همراه با نویسه ERP همچنان برای نام طولانی دستور الزامی است.
.
.PP
در این حالت، چون مقداری به
.B ampctld
ارسال نشده است، خط نخست تنها شامل نام طولانی دستور است. خط پایانی نشان می‌دهد که
دستور با موفقیت توسط بک‌اند تقویت‌کننده پردازش شده است.
.
.PP
فراخوانی پروتکل پاسخ گسترش‌یافته مستلزم قرار دادن یک نویسه نشانه‌گذاری (punctuation)
در ابتدای دستور است. همان‌طور که در مثال‌های بالا نشان داده شد، قرار دادن نویسه
\(oq+\(cq در ابتدای دستور باعث می‌شود پاسخ‌ها با یک نویسه خط جدید (\(oq\\n\(cq)
از هم جدا شوند. هر نویسه نشانه‌گذاری دیگری که توسط تابع
.BR ispunct ()
در زبان C شناخته شود به جز \(oq\\\(cq، \(oq?\(cq یا \(oq_\(cq، باعث می‌شود
آن نویسه به عنوان جداکننده پاسخ در نظر گرفته شده و تمام پاسخ در یک خط قرار گیرد.
.
.PP
خلاصه نویسه‌های جداکننده:
.TP
.RB \(oq + \(cq
به هر رکورد از پاسخ یک خط جدید (\(oq\\n\(cq) افزوده می‌شود.
.
.TP
.RB \(oq ; "\(cq، \(oq" | "\(cq یا \(oq" , \(cq
به هر رکورد پاسخ نویسه مشخص‌شده افزوده می‌شود که منجر به قرار گرفتن کل پاسخ در یک خط می‌گردد.
.IP
این‌ها جداکننده‌های رایج رکورد برای نمایش متنی داده‌های صفحات گسترده (spreadsheet) و غیره هستند.
.
.TP
.RB \(oq ? \(cq
برای راهنما در
.B ampctl
رزرو شده است.
.
.TP
.RB \(oq _ \(cq
برای دستور کوتاه
.B get_info
رزرو شده است.
.
.TP
.RB \(oq # \(cq
برای توضیحات (کامنت‌ها) هنگام خواندن اسکریپت فایل دستور رزرو شده است.
.IP
.BR نکته :
سایر نویسه‌های نشانه‌گذاری آزمایش نشده‌اند! استفاده از آن‌ها با مسئولیت خودتان است.
.
.PP
برای نمونه، فراخوانی یک پرسمان
.B get_freq
با یک \(oq;\(cq در ابتدا بازمی‌گرداند:
.
.PP
.in +4n
.EX
get_freq:;Frequency(Hz): 14250000;RPRT 0
.EE
.in
.
.PP
یا با استفاده از نویسه خط لوله (pipe) \(oq|\(cq بازمی‌گرداند:
.
.PP
.in +4n
.EX
get_freq:|Frequency(Hz): 14250000|RPRT 0
.EE
.in
.
.PP
و یک دستور
.B set_freq
که با \(oq|\(cq آغاز شده باشد بازمی‌گرداند:
.
.PP
.in +4n
.EX
set_freq: 14250000|RPRT 0
.EE
.in
.
.PP
چنین قالبی امکان خواندن یک پاسخ را به عنوان یک رویداد واحد با استفاده از جداکننده پاسخ دلخواه فراهم می‌آورد. سایر نویسه‌های نشانه‌گذاری آزمایش نشده‌اند!
..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 "مثال‌ها (EXAMPLES)"
.
راه‌اندازی
.B ampctld
برای یک Elecraft KPA-1500 با استفاده از مبدل USB به سریال و اجرای آن در پس‌زمینه:
.
.PP
.in +4n
.EX
.RB $ " ampctld -m 201 -r /dev/ttyUSB1 &"
.EE
.in
.
.PP
راه‌اندازی
.B ampctld
برای یک Elecraft KPA-1500 با استفاده از COM2 در MS Windows:
.
.PP
.in +4n
.EX
.RB $ " ampctld -m 201 -r COM2"
.EE
.in
.
.PP
اتصال به
.B ampctld
در حال اجرا و تنظیم فرکانس روی 14.266 MHz با مهلت زمانی خواندن ۱ ثانیه، با استفاده از پروتکل پیش‌فرض از اعلان پوسته:
.
.PP
.in +4n
.EX
$ \fBecho "\\set_freq 14266000" | nc -w 1 localhost 4531\fP
.EE
.in
.
.PP
اتصال به یک
.B ampctld
در حال اجرا با
.B ampctl
روی میزبان محلی:
.
.PP
.in +4n
.EX
.RB $ " ampctl -m2"
.EE
.in
.
.
.SH "امنیت (SECURITY)"
.
هیچ‌گونه احراز هویتی وجود ندارد؛ هرگز این درگاه TCP را بدون محافظت بر روی اینترنت باز نگذارید. لطفاً در صورت نیاز به امنیت قوی‌تر درخواست دهید یا استفاده از تونل Secure Shell
.RB ( ssh (1))
را در نظر بگیرید.
.
.PP
از آنجا که
.B ampctld
به مجوزهایی بیشتر از
.BR ampctl
نیاز ندارد، توصیه می‌شود برای محدود کردن هرگونه آسیب‌پذیری،
.B ampctld
با کاربر \(lqroot\(rq یا حساب کاربری سیستمی دیگری اجرا نشود.
.
..SH "گزارش باگ‌ها (BUGS)"
.
این دیمن خود را از پایانه جدا نکرده و به پس‌زمینه منتقل نمی‌شود.
.PP
هیچ روشی برای خروج از دیمن وجود ندارد، بنابراین برای خاتمه دادن به آن باید از دستور
.BR kill (1)
استفاده شود.
.
.PP
چندین کلاینت که از این دیمن استفاده می‌کنند ممکن است در دسترسی به تقویت‌کنندهٔ متصل دچار رقابت و تداخل شوند.
.
.PP
گزارش باگ‌ها به:
.IP
.nf
.MT hamlib\-developer@lists.sourceforge.net
فهرست پستی توسعه‌دهندگان Hamlib
.ME
.fi
.
.
.SH "کپی‌رایت و تکثیر (COPYING)"
.
این فایل بخشی از Hamlib است؛ پروژه‌ای برای توسعه کتابخانه‌ای که توابع کنترلی رادیو، چرخاننده و تقویت‌کننده را برای توسعه‌دهندگان نرم‌افزارهایی که عمدتاً مورد توجه آماتورهای رادیویی و علاقه‌مندان به ارتباطات رادیویی هستند، ساده‌سازی می‌کند.
.
.PP
حق نشر \(co 2000-2010 Stephane Fillod
.br
حق نشر \(co 2000-2018 گروه Hamlib (مشارکت‌کنندگان گوناگون)
.br
حق نشر \(co 2011-2020 Nate Bargmann
.
.PP
این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر، فایل COPYING را ببینید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.
.
.SH "همچنین ببینید (SEE ALSO)"
.
.BR kill (1),
.BR ampctl (1),
.BR ssh (1),
.BR hamlib (7)
.
.
.SH "شناسنامه (COLOPHON)"
.
پیوندها به ویکی Hamlib، مخزن Git، بایگانی‌های انتشار و بایگانی‌های تصویر روزانه (daily snapshot) از طریق نشانی زیر در دسترس هستند:
.
.UR http://www.hamlib.org
hamlib.org
.UE .