.TH "usrpctl" 1 "4.0.0" UHD "User Commands"
.SH "نام (NAME)"
usrpctl \- ابزار پیکربندی افزاره‌های جانبی درایور سخت‌افزار USRP
.SH "توضیحات (DESCRIPTION)"
اطلاعات دقیق درباره افزاره‌های جانبی رادیوی نرم‌افزاری (SDR) پشتیبانی‌شده توسط UHD را که از طریق USB، شبکه یا پیکربندی توکار متصل شده‌اند گزارش می‌دهد.
این ابزار امکان به‌روزرسانی و پیکربندی دستگاه‌های متصل را فراهم می‌کند.
.PP
بسته UHD یک درایور سخت‌افزاری همه‌منظوره برای محصولات Ettus Research است. هدف آن ارائه یک درایور میزبان و رابط برنامه‌نویسی کاربردی (API) برای محصولات فعلی و آینده Ettus Research است.
کاربران قادر خواهند بود از درایور UHD به‌صورت مستقل یا به همراه برنامه‌های شخص ثالث استفاده کنند.
.PP
جزئیات شامل نام واحدها، شماره‌های بازنگری، و حسگرهای موجود روی تمامی بردهای اصلی و بردهای دختر (daughterboard) متصل به USRP است.
.SH "خلاصه دستور (SYNOPSIS)"
.B usrpctl
[\fIID\fR] \fICOMMAND\fR [\fIOPTIONS\fR]
.SH "شناسه (ID)"
آرگومان اختیاری افزاره است. از آن برای تعیین مجموعه‌ای
از افزاره‌های USRP که
.I COMMAND
باید روی آن‌ها اعمال شود استفاده می‌شود. اگر
.I ID
مشخص نشود،
.I COMMAND
روی تمام افزاره‌های دردسترس اعمال خواهد شد.
.PP
دستور
.B usrpctl
آرگومان شناسه‌های افزاره (device args) را که توسط سایر ابزارهای UHD
مانند
.B uhd_find_devices
به کار می‌رود، تشخیص می‌دهد.
.SH "دستور (COMMAND)"
عملیاتی است که این ابزار باید انجام دهد. هر دستور می‌تواند روی یک
افزاره منفرد یا گروهی از افزاره‌ها اعمال شود. دستوراتی که روی گروهی از
افزاره‌ها اجرا می‌شوند، دستور را برای تک‌تک افزاره‌ها تکرار می‌کنند.
.PP
دستورات تک‌افزاره‌ای:
.RS
.IP "\(bu" 2
.BR config :
خواندن/نوشتن متغیرهای پیکربندی (مانند نشانی IP)
.IP "\(bu" 2
.BR probe :
خواندن اطلاعات تکمیلی درباره USRP
.RE
.PP
دستورات چندافزاره‌ای:
.RS
.IP "\(bu" 2
.BR update :
به‌روزرسانی فایل‌های باینری (مانند ایمیج FPGA)
.IP "\(bu" 2
.BR reset :
بازنشانی زیربخش(های) مشخص‌شده از USRP
.IP "\(bu" 2
.BR find :
یافتن تمام افزاره‌های USRP موجود در این شبکه
.RE
.SH "گزینه‌ها (OPTIONS)"
گزینه‌ها همیشه اجباری نیستند؛ استفاده از آن‌ها به
.I COMMAND
مشخص‌شده بستگی دارد.
.SH "دستور find (find command)"
دستور
.B find
هیچ گزینه دیگری نمی‌پذیرد. اگر
.I ID
مشخص نشود، سیستم را برای یافتن افزاره‌های دردسترس و پشتیبانی‌شده پویش کرده و فهرستی از افزاره‌های کشف‌شده را چاپ می‌کند.
خروجی چاپ‌شده با
.B uhd_find_devices
سازگار است.
می‌توان از
.I ID
برای محدود کردن فهرست افزاره‌های کشف‌شده استفاده کرد.
.SH "دستور probe (probe command)"
دستور
.B probe
تنها می‌تواند روی یک افزاره منفرد اعمال شود، بنابراین اطمینان حاصل کنید که
.I ID
دقیقاً یک افزاره را مشخص می‌کند. این دستور بدون آرگومان، اطلاعات مفصلی درباره افزاره مانند نام، شماره سریال، شماره‌های بازنگری، نسخه سفت‌افزار (firmware) و اطلاعات حسگرهای موجود روی مادربرد و بردهای دختر متصل را نمایش می‌دهد.
.PP
گزینه‌ها:
.TP
.B \-tree
چاپ درخت کامل ویژگی‌ها (property tree).
.SH "دستور reset (reset command)"
دستور
.B reset
زیربخش‌های مشخص‌شده یک افزاره را بازنشانی می‌کند. اگر
.I ID
مشخص نشود، سیستم را برای یافتن افزاره‌های دردسترس و پشتیبانی‌شده پویش کرده و زیربخش مشخص‌شده تمامی افزاره‌های کشف‌شده را بازنشانی می‌کند.
.PP
گزینه‌ها:
.TP
.B \-mpm
بازنشانی MPM (مدیر ماژول پردازنده).
.SH "مثال‌ها (EXAMPLES)"
.TP \w'usrpctl\ 'u
.BI usrpctl\ find
یافتن تمام افزاره‌های پشتیبانی‌شده
.TP
.BI usrpctl\ type=x300,product=X310\ find
یافتن تمام افزاره‌های x310
.TP
.BI usrpctl\ name=my_usrp\ find
یافتن افزاره‌ای با نام my_usrp
.TP
.BI usrpctl\ addr=192.168.10.2\ find
یافتن افزاره‌ای با نشانی IP داده‌شده.
.TP
.BI usrpctl\ addr=192.168.10.2\ probe
نمایش اطلاعات افزاره برای USRP با شناسه داده‌شده
.TP
.BI usrpctl\ name=my_usrp\ probe\ \-tree
نمایش درخت ویژگی‌های افزاره با نام my_usrp
.TP
.BI usrpctl\ addr=192.168.10.2\ reset\ \-mpm
بازنشانی MPM روی افزاره با نشانی IP داده‌شده.
.SH "همچنین ببینید (SEE ALSO)"
مستندات UHD:
.B http://files.ettus.com/manual
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2022 متعلق به Ettus Research، یک برند National Instruments است.
.PP
این برنامه یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط «اجازه‌نامه عمومی همگانی گنو» (GNU GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد، نگارش ۳ یا (به انتخاب خودتان) هر نگارش جدیدتری بازتوزیع کرده و/یا تغییر دهید.
.PP
این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «اجازه‌نامه عمومی همگانی گنو» مراجعه کنید.