.\" 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, rotctl.c .\" .TH ROTCTL "1" "2025-09-01" "Hamlib" "ابزارهای Hamlib" . . .SH "نام (NAME)" . rotctl \- کنترل و مدیریت روتاتور آنتن رادیویی . . .SH "خلاصه دستور (SYNOPSIS)" . .SY rotctl .OP \-hiIlLuV .OP \-m id .OP \-r device .OP \-R device2 .OP \-s baud .OP \-t char .OP \-C parm=val .OP \-o azoffset .OP \-O eloffset .RB [ \-v [ \-Z ]] .RB [ command | \- ] .YS . . .SH "توضیحات (DESCRIPTION)" . کنترل روتاتورهای آنتن رادیویی. . .PP برنامه .B rotctl می‌تواند .I دستورها را از خط فرمان یا در حالت تعاملی (در صورتی که دستوری در خط فرمان داده نشود) دریافت و اجرا کند. . .PP به یاد داشته باشید که Hamlib نرم‌افزاری در سطح بتا (BETA) است. اگرچه برخی از کتابخانه‌های بک‌اند فاقد پشتیبانی کامل از همه روتاتورها هستند، اما عملکردهای اساسی معمولاً به خوبی پشتیبانی می‌شوند. . .PP لطفاً اشکالات و بازخوردهای خود را به نشانی ایمیل ذکر شده در بخش .B اشکالات در ادامه ارسال فرمایید. وصله‌ها و بهبودهای کدی که به همین نشانی ارسال شوند مورد استقبال قرار می‌گیرند. . . .SH "گزینه‌ها (OPTIONS)" . این برنامه از شیوه‌نگارش معمول خط فرمان گنو پیروی می‌کند. در گزینه‌های کوتاهی که آرگومان می‌پذیرند، مقدار می‌تواند بلافاصله بعد از گزینه یا با فاصله بیاید. گزینه‌های طولانی که با دو خط تیره (\(oq\-\(cq) آغاز می‌شوند نیاز به علامت \(oq=\(cq میان گزینه و آرگومان دارند. . .PP خلاصه‌ای از گزینه‌های پشتیبانی‌شده در زیر آمده است: . .TP .BR \-m ", " \-\-model = \fIid\fP انتخاب شماره مدل روتاتور. .IP مشاهده فهرست مدل‌ها (با دستور \(lqrotctl -l\(rq). .IP .BR نکته : برنامه .B rotctl (یا نرم‌افزارهای شخص ثالثی که از C API استفاده می‌کنند) از مدل روتاتور ۲ برای .B NET rotctl (ارتباط با .BR rotctld ) استفاده می‌کند. . .TP .BR \-r ", " \-\-rot\-file = \fIdevice\fP استفاده از .I device به عنوان نام فایل درگاه متصل به روتاتور. .IP معمولاً یک پورت سریال یا مبدل USB به سریال است. به‌طور نمونه .IR /dev/ttyS0 ", " /dev/ttyS1 ", " /dev/ttyUSB0 و غیره در لینوکس، و .IR COM1 ", " COM2 و غیره در ویندوز. نسخه‌های BSD و Mac OS/X نام‌گذاری‌های خاص خود را دارند. به مستندات سیستم خود مراجعه کنید. . .TP .BR \-R ", " \-\-rot\-file2 = \fIdevice\fP استفاده از .I device به عنوان نام فایل درگاه متصل به روتاتور دوم. مثلاً روتاتور دوم برای تنظیم ارتفاع (Elevation). .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 به‌طور پیش‌فرض از بیشینه سرعت سریال بر اساس قابلیت‌های بک‌اند روتاتور استفاده می‌شود. . .TP .BR \-t ", " \-\-send\-cmd\-term = \fIchar\fP تغییر نویسه پایانی .I char برای پروتکل‌های متنی هنگام استفاده از دستور .BR send_cmd . .IP مقدار پیش‌فرض نویسه CR در اسکی (\(oq0x0D\(cq) است. نویسه‌های غیرقابل‌چاپ اسکی را می‌توان به‌صورت عدد هگزادسیمال همراه با پیشوند \(lq0x\(rq مشخص کرد. برای نداشتن نویسه پایانی می‌توانید یک رشته خالی ارسال کنید. رشته \(lq\-1\(rq به .B rotctl می‌گوید که به پروتکل دودویی (باینری) تغییر وضعیت دهد. برای توضیحات بیشتر دستور .B send_cmd را ببینید. .IP .BR نکته : نقطه ویرگول (\(oq;\(cq) نویسه پایانی متداولی برای روتاتورهایی است که رشته‌های اسکی می‌پذیرند. . .TP .BR \-o ", " \-\-set\-azoffset مقدار تصحیح زاویه سمتی (Azimuth) به‌صورت عدد اعشاری -- در زمان تنظیم (set) این مقدار اضافه شده و در زمان خواندن (get) این مقدار کسر می‌شود. . .TP .BR \-O ", " \-\-set\-eloffset مقدار تصحیح زاویه ارتفاع (Elevation) به‌صورت عدد اعشاری -- در زمان تنظیم (set) این مقدار اضافه شده و در زمان خواندن (get) این مقدار کسر می‌شود. . . .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 یا نوار پیمایش ترمینال در محیط گرافیکی یا پنجره cmd در ویندوز به بالا و پایین پیمایش کرد. خروجی را می‌توان به .BR more (1) یا .BR less (1) لوله (pipe) کرد، مانند: \(lqrotctl -l | more\(rq. . .TP .BR \-i ", " \-\-read\-history خواندن تاریخچه دستورها و آرگومان‌های ذخیره‌شده پیشین از یک فایل (به‌طور پیش‌فرض .IR $HOME/.rotctl_history ) برای نشست جاری. .IP تنها در صورتی در دسترس است که .B rotctl با پشتیبانی از کتابخانه Readline کامپایل شده باشد (بخش .B ردلاین در ادامه را ببینید). .IP .BR نکته : برای خواندن فایل تاریخچه ذخیره‌شده در پوشه‌ای دیگر، متغیر محیطی .B ROTCTL_HIST_DIR را تنظیم کنید، مثلاً: \(lqROTCTL_HIST_DIR=$HOME/tmp rotctl -i\(rq. در صورت عدم تنظیم ROTCTL_HIST_DIR، از مقدار .B HOME استفاده می‌شود. . .TP .BR \-I ", " \-\-save\-history نوشتن تاریخچه دستورها و آرگومان‌های نشست جاری (و نشست‌های پیشین، در صورتی که گزینه .B \-i نیز داده شده باشد) در یک فایل (به‌طور پیش‌فرض .IR $HOME/.rotctl_history ) در پایان نشست کاری. .IP دستورهای کامل به همراه آرگومان‌هایشان در یک خط ذخیره می‌شوند تا بتوان بعداً آن‌ها را فراخوانی، استفاده یا ویرایش کرد. تنها در صورتی فعال است که .B rotctl همراه با پشتیبانی از Readline کامپایل شده باشد (بخش .B ردلاین را ببینید). .IP .BR نکته : برای ذخیره فایل تاریخچه در پوشه‌ای دیگر، متغیر محیطی .B ROTCTL_HIST_DIR را تنظیم کنید، مثلاً: \(lqROTCTL_HIST_DIR=$HOME/tmp rotctl -I\(rq. در صورت عدم تنظیم ROTCTL_HIST_DIR، از مقدار متغیر .B HOME استفاده می‌شود. . .TP .BR \-v ", " \-\-verbose تنظیم حالت با جزئیات بیشتر، به صورت انباشته (بخش .B عیب‌یابی در ادامه را ببینید). . .TP .BR \-Z ", " \-\-debug\-time\-stamps فعال‌سازی برچسب زمانی (Timestamp) برای پیام‌های رفع اشکال. .IP تنها در ترکیب با گزینه .B \-v استفاده شود زیرا به تنهایی خروجی تولید نمی‌کند. . .TP .BR \-h ", " \-\-help نمایش خلاصه‌ای از این گزینه‌ها و سپس خروج. . .TP .BR \-V ", " \-\-version نمایش نسخه برنامه .B rotctl و سپس خروج. . .TP .B \- توقف پردازش گزینه‌ها و خواندن دستورها از ورودی استاندارد. .IP بخش .B ورودی استاندارد در ادامه را ببینید. . .PP .BR نکته : برخی از گزینه‌ها ممکن است توسط یک بک‌اند خاص پیاده‌سازی نشده باشند و خطایی بازگردانند. این حالت معمولاً برای گزینه‌های .B \-\-set\-conf و .B \-\-show\-conf رخ می‌دهد. . .PP توجه داشته باشید که بک‌اند روتاتور تحت کنترل یا خود دستگاه روتاتور ممکن است از برخی دستورها پشتیبانی نکنند. در این صورت، عملیات با یک کد خطای .B Hamlib با شکست مواجه خواهد شد. . . .SH "دستورها (COMMANDS)" . دستورها را می‌توان به‌صورت یک نویسه تکی یا نام کامل دستور وارد کرد. برخلاف گزینه‌ها، دستورها با خط تیره شروع نمی‌شوند. آن‌ها را می‌توان در حالت تعاملی تایپ کرد یا در حالت خط فرمان به‌صورت آرگومان به برنامه داد. در حالت تعاملی، دستورها و آرگومان‌هایشان را می‌توان در یک خط وارد کرد (متن تایپ‌شده با قلم پررنگ نشان داده شده است): . .PP .in +4n .EX .B P 123 45 .EE .in . .PP از آنجا که بیشتر عملیات‌های .B Hamlib دارای دو متد .BR set " و " get هستند، معمولاً یک حرف بزرگ انگلیسی برای متد .B set (تنظیم) و حرف کوچک متناظر آن برای متد .B get (دریافت/خواندن) به کار می‌رود. هر عملیات یک نام طولانی نیز دارد؛ در حالت تعاملی، برای وارد کردن نام طولانی دستور یک علامت بک‌اسلش \(oq\\\(cq در ابتدای آن بگذارید. . .PP مثال: برای مشاهده اطلاعات روتاتور در حالت تعاملی از \(lq\\get_info\(rq استفاده کنید. . .IP .BR نکته : بک‌اند روتاتور تحت کنترل یا خود دستگاه ممکن است از برخی دستورها پشتیبانی نکنند. در این حالت عملیات با یک پیام خطای .B Hamlib ناموفق خواهد بود. . . .SS "ورودی استاندارد (Standard Input)" . به‌عنوان جایگزینی برای ورود تعاملی دستورها از طریق .B READLINE یا اجرای تک‌دستور در هر بار اجرا، برنامه .B rotctl قابلیت ویژه‌ای دارد که در آن یک خط تیره منفرد (\(oq\-\(cq) می‌تواند برای خواندن دستورها از ورودی استاندارد .RB ( stdin ) استفاده شود. دستورها باید با فاصله یا خط جدید از هم جدا شوند، مشابه نحوه ارسال دستورها در خط فرمان. با استفاده از نویسه \(oq#\(cq می‌توان کامنت اضافه کرد؛ تمامی متن‌ها تا انتهای خط جاری پس از نویسه \(oq#\(cq نادیده گرفته می‌شوند. . .PP یک مثال ساده: . .PP .in +4n .EX .RB $ " cat <<.EOF. >cmds.txt" .RB > " # File of commands" .RB > " set_pos 180.0 10.0 # rotate" .RB > " pause 30 # wait for action to complete" .RB > " get_pos # query rotator" .RB > .EOF. .RB $ " rotctl -m 1 - " rotctl -m 401 -r COM2" .EE .in . .PP اتصال به سرویس در حال اجرای .B rotctld با مدل روتاتور ۲ (\(lqNET rotctl\(rq) روی هاست محلی و تعیین درگاه TCP، و سپس استعلام موقعیت: . .PP .in +4n .EX .RB $ " rotctl -m 2 -r localhost:4533 \\get_pos" .EE .in . .PP راه‌اندازی .B rotctl برای INDI با استفاده از نشانی دیگری غیر از پیش‌فرض \fIlocalhost:5764\fP: . .PP .in +4n .EX .RB $ " rotctl -m 2001 -r example.com:12345" .EE .in . .PP راه‌اندازی .B rotctl برای INDI با استفاده از دامنه محلی در لینوکس: . .PP .in +4n .EX .RB $ " rotctl -m 2001 -r @/tmp/indiserver" .EE .in .PP پروژه INDI (رابط توزیع‌شده بی‌طرف از دستگاه) یک نرم‌افزار با مجوز LGPLv2 برای کنترل تجهیزات نجومی، از جمله پایه‌های تلسکوپ است که می‌توان از آن‌ها برای چرخاندن آنتن‌ها نیز استفاده کرد. .PP برای اطلاعات بیشتر ببینید: .UR https://indilib.org indilib.org .UE . .SH "اشکالات (BUGS)" . گزارش اشکالات به: .IP .nf .MT hamlib\-developer@lists.sourceforge.net Hamlib Developer mailing list .ME .fi . . .SH "کپی‌رایت و تکثیر (COPYING)" . این فایل بخشی از Hamlib است؛ پروژه‌ای برای توسعه کتابخانه‌ای که عملکردهای کنترل رادیو، روتاتور و تقویت‌کننده را برای توسعه‌دهندگان نرم‌افزارهای مرتبط با رادیو آماتوری و علاقه‌مندان به ارتباطات رادیویی ساده می‌کند. . .PP حق کپی‌رایت \(co 2001-2011 Stephane Fillod .br حق کپی‌رایت \(co 2002-2017 the Hamlib Group (مشارکت‌کنندگان گوناگون) .br حق کپی‌رایت \(co 2003-2020 Nate Bargmann . .PP این نرم‌افزار آزاد است؛ برای شرایط تکثیر فایل COPYING را ببینید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص. . . .SH "همچنین ببینید (SEE ALSO)" . .BR less (1), .BR more (1), .BR rotctld (1), .BR hamlib (7) . . .SH "شناسنامه (COLOPHON)" . پیوندها به ویکی Hamlib، مخزن Git، بایگانی‌های انتشار و بایگانی‌های نسخه‌های آزمایشی روزانه از طریق نشانی زیر در دسترس هستند: . .UR http://www.hamlib.org hamlib.org .UE .