.\" 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, ampctl.c .\" .TH AMPCTL "1" "2020-09-08" "Hamlib" "Hamlib Utilities" . . .SH "نام (NAME)" . ampctl \- کنترل تقویت‌کننده‌های رادیویی . .SH "خلاصه دستور (SYNOPSIS)" . . .SY ampctl .OP \-hiIlLuV .OP \-m id .OP \-r device .OP \-s baud .OP \-t char .OP \-C parm=val .RB [ \-v [ \-Z ]] .RB [ command | \- ] .YS . .SH "توضیحات (DESCRIPTION)" کنترل تقویت‌کننده‌های رادیویی (آمپلی‌فایرها). برنامه .B ampctl .B دستورات را از خط فرمان و همچنین در صورت عدم ارائه در خط فرمان، در حالت تعاملی دریافت می‌کند. . .PP توجه داشته باشید که Hamlib نرم‌افزاری در سطح بتا (BETA) است. در حالی که بسیاری از کتابخانه‌های بک‌اند فاقد پشتیبانی کامل از تقویت‌کننده هستند، توابع پایه معمولاً به خوبی پشتیبانی می‌شوند. . .PP لطفاً اشکالات را گزارش داده و بازخورد خود را به آدرس ایمیل ارائه‌شده در بخش .B اشکالات در ادامه ارسال فرمایید. وصله‌ها و بهبودهای کد ارسالی به همین آدرس نیز مورد استقبال است. . . .SH "گزینه‌ها (OPTIONS)" . این برنامه از سینتکس معمول خط فرمان گنو پیروی می‌کند. گزینه‌های کوتاهی که آرگومان می‌پذیرند می‌توانند مقدار را بلافاصله پس از خود داشته باشند یا با یک فاصله جدا شوند. گزینه‌های بلندی که با دو خط‌تیره (\(oq\-\(cq) آغاز می‌شوند، به علامت \(oq=\(cq میان گزینه و آرگومان نیاز دارند. . .PP خلاصه‌ای از گزینه‌های پشتیبانی‌شده در ادامه آمده است: . .TP .BR \-m ", " \-\-model = \fIid\fP انتخاب شماره مدل تقویت‌کننده. .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 و غیره در ویندوز. توزیع‌های BSD و Mac OS/X نام‌گذاری‌های اختصاصی خود را دارند. به مستندات سیستم خود مراجعه فرمایید. . .TP .BR \-s ", " \-\-serial\-speed = \fIbaud\fP تنظیم سرعت سریال بر حسب .I baud (نرخ باود). .IP به‌طور پیش‌فرض از حداکثر سرعت پورت سریال بر اساس قابلیت‌های بک‌اند تقویت‌کننده (تنظیم‌شده با .B -m در بالا) استفاده می‌کند. . .TP .BR \-t ", " \-\-send\-cmd\-term = \fIchar\fP تغییر نویسه پایانه‌ساز (termination .IR char ) برای پروتکل متنی در هنگام استفاده از دستور .BR send_cmd . .IP مقدار پیش‌فرض CR اسکی (\(oq0x0D\(cq) است. نویسه‌های غیرقابل چاپ اسکی را می‌توان به‌صورت عدد اسکی در مبنای ۱۶ با پیشوند \(lq0x\(rq مشخص کرد. می‌توانید یک رشته خالی برای عدم استفاده از نویسه پایانه‌ساز ارسال کنید. ارسال رشته \(lq\-1\(rq به .B ampctl می‌گوید که به پروتکل دودویی (باینری) تغییر وضعیت دهد. .IP برای مثال، جهت تعیین پایانه‌ساز برای دستورات متنی به سبک Kenwood، مقدار \(lq-t ';'\(rq را به ampctl ارسال کنید. بخش .B مثال‌ها در ادامه را ببینید. . .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 استخراج قابلیت‌های تقویت‌کننده تعریف‌شده با .B -m در بالا و سپس خروج. . .TP .BR \-l ", " \-\-list فهرست کردن تمام شماره مدل‌های تقویت‌کننده تعریف‌شده در .B Hamlib و سپس خروج. .IP فهرست بر اساس شماره مدل مرتب شده است. .IP .BR توجه : در لینوکس می‌توان فهرست را با استفاده از .BR Shift-PageUp / Shift-PageDown یا نوار پیمایش ترمینال مجازی در X یا پنجره cmd در ویندوز به بالا و پایین پیمایش کرد. خروجی را می‌توان به .BR more (1) یا .BR less (1) هدایت نمود (پایپ کرد)، مانند \(lqampctl -l | more\(rq. . .TP .BR \-i ", " \-\-read\-history خواندن تاریخچه دستورات و آرگومان‌های ذخیره‌شده قبلی از یک فایل (پیش‌فرض .IR $HOME/.ampctl_history ) برای نشست جاری. .IP در صورتی در دسترس است که .B ampctl با پشتیبانی از Readline کامپایل شده باشد (بخش ریدلاین را در ادامه ببینید). .IP .BR توجه : برای خواندن فایل تاریخچه ذخیره‌شده در یک دایرکتوری دیگر، متغیر محیطی .B AMPCTL_HIST_DIR را تنظیم کنید؛ برای مثال \(lqAMPCTL_HIST_DIR=~/tmp ampctl -i\(rq. در صورت عدم تنظیم AMPCTL_HIST_DIR، مقدار متغیر .B HOME استفاده می‌شود. . .TP .BR \-I ", " \-\-save\-history نوشتن تاریخچه دستورات و آرگومان‌های نشست جاری (و نشست(های) قبلی، در صورتی که گزینه .B -i داده شده باشد) در یک فایل (پیش‌فرض .IR $HOME/.ampctl_history ) در پایان نشست جاری. .IP دستورات کامل به همراه آرگومان‌ها در یک خط ذخیره می‌شوند تا مجدداً فراخوانی، استفاده یا ویرایش شوند. در صورتی فعال است که .B ampctl با پشتیبانی از Readline کامپایل شده باشد (بخش .B ریدلاین در ادامه را ببینید). .IP .BR توجه : برای نوشتن فایل تاریخچه در دایرکتوری دیگر، متغیر محیطی .B AMPCTL_HIST_DIR را تنظیم کنید، مانند \(lqAMPCTL_HIST_DIR=~/tmp ampctl -I\(rq. در صورت عدم تنظیم AMPCTL_HIST_DIR، مقدار .B HOME استفاده می‌شود. . .TP .BR \-v ", " \-\-verbose تنظیم حالت پرگویی (verbose) به‌صورت تجمعی (بخش .B عیب‌یابی در ادامه را ببینید). . .TP .BR \-Z ", " \-\-debug\-time\-stamps فعال کردن برچسب زمانی برای پیام‌های اشکال‌زدایی. .IP تنها در ترکیب با گزینه .B -v استفاده شود، زیرا به‌تنهایی خروجی تولید نمی‌کند. . .TP .BR \-h ", " \-\-help نمایش خلاصه‌ای از این گزینه‌ها و سپس خروج. . .TP .BR \-V ", " \-\-version نمایش نسخه .B ampctl و سپس خروج. . .TP .B \- توقف پردازش گزینه‌ها و خواندن دستورات از ورودی استاندارد. .IP بخش .B ورودی استاندارد در ادامه را ببینید. . .PP .BR توجه : برخی از گزینه‌ها ممکن است توسط بک‌اند خاصی پیاده‌سازی نشده باشند و خطایی بازگردانند. این موضوع بیشتر در مورد گزینه‌های .B \-\-set\-conf و .B \-\-show\-conf رخ می‌دهد. . .PP لطفاً توجه داشته باشید که بک‌اند تقویت‌کننده مورد نظر یا خود تقویت‌کننده ممکن است از برخی دستورات پشتیبانی نکنند. در این صورت، عملیات با یک کد خطای .B Hamlib با شکست مواجه خواهد شد. . . .SH "دستورات (COMMANDS)" . دستورات را می‌توان به صورت یک نویسه تک‌حرفی یا نام کامل دستور وارد کرد. دستورات بر خلاف گزینه‌ها با خط تیره آغاز نمی‌شوند. می‌توان آن‌ها را در حالت تعاملی تایپ کرد یا به‌عنوان آرگومان در حالت رابط خط فرمان ارسال نمود. در حالت تعاملی، دستورات و آرگومان‌های آن‌ها می‌توانند در یک خط وارد شوند: . .PP .in +4n .EX .B F 14250000 .EE .in . .PP از آنجا که بیشتر عملیات .B Hamlib دارای یک متد .B set و یک متد .B get هستند، اغلب از یک حرف بزرگ انگلیسی برای متد .B set استفاده می‌شود، در حالی که حرف کوچک متناظر آن به متد .B get اشاره دارد. هر عملیات یک نام طولانی نیز دارد؛ در حالت تعاملی، با افزودن یک بک‌اسلش \(oq\\\(cq در ابتدا، می‌توان نام بلند دستور را وارد کرد. . .PP مثال: برای مشاهده قابلیت‌های پشتیبانی‌شده توسط تقویت‌کننده و بک‌اند، دستور \(lq\\dump_caps\(rq را وارد کنید. . .IP .BR توجه : بک‌اند تقویت‌کننده یا خود دستگاه ممکن است از برخی دستورات پشتیبانی نکنند. در این حالت، عملیات با یک پیام خطای .B Hamlib ناموفق خواهد بود. . . .PP یک مثال ساده با استفاده از دستورات ذخیره‌شده در یک فایل (متن تایپ‌شده به‌صورت توپر نمایش داده شده است): . .PP .in +4n .EX .RB $ " cat <<.EOF. >cmds.txt" .RB > " # File of commands" .RB > " F 14250000" .RB > " f" .RB > " l PWRINPUT" .RB > " l PWRFORWARD" .RB > " l SWR" > \fB\\dump_caps\fP .RB > " .EOF." .RB $ " ampctl -m1 - " ampctl -m 201 -r COM1 -vvvvv" .EE .in . .PP اتصال به یک نسخه در حال اجرای .B ampctld با مدل ۲ تقویت‌کننده (\(lqNET ampctl\(rq) روی میزبان محلی (localhost) و تعیین پورت TCP، تنظیم فرکانس و حالت: . .PP .in +4n .EX .RB $ " ampctl -m 2 -r localhost:4531 F 7253500" .EE .in . . .SH "اشکالات (BUGS)" . گزارش اشکالات به: .IP .nf .MT hamlib\-developer@lists.sourceforge.net Hamlib Developer mailing list .ME .fi . . .SH "کپی‌رایت و تکثیر (COPYING)" . این فایل بخشی از Hamlib است، پروژه‌ای برای توسعه کتابخانه‌ای که توابع کنترل رادیو، روتاتور و تقویت‌کننده را برای توسعه‌دهندگان نرم‌افزار، عمدتاً رادیوآماتورها و علاقه‌مندان به ارتباطات رادیویی، ساده می‌کند. . .PP Copyright \(co 2000-2011 Stephane Fillod .br Copyright \(co 2000-2018 the Hamlib Group (various contributors) .br Copyright \(co 2010-2020 Nate Bargmann . .PP این نرم‌افزار آزاد است؛ برای آگاهی از شرایط تکثیر فایل COPYING را ببینید. هیچ ضمانتی وجود ندارد؛ حتی برای بازاریابی تجاری یا تناسب برای یک هدف مشخص. . . .SH "همچنین ببینید (SEE ALSO)" . .BR less (1), .BR more (1), .BR ampctld (1), .BR hamlib (7) . . .SH "شناسنامه (COLOPHON)" . پیوندها به ویکی Hamlib، مخزن Git، بایگانی‌های نسخه‌های عرضه‌شده و اسنپ‌شات‌های روزانه از طریق نشانی زیر در دسترس است: . .UR http://www.hamlib.org hamlib.org .UE .