نام (NAME)

usrpctl - ابزار پیکربندی افزاره‌های جانبی درایور سخت‌افزار USRP

توضیحات (DESCRIPTION)

اطلاعات دقیق درباره افزاره‌های جانبی رادیوی نرم‌افزاری (SDR) پشتیبانی‌شده توسط UHD را که از طریق USB، شبکه یا پیکربندی توکار متصل شده‌اند گزارش می‌دهد. این ابزار امکان به‌روزرسانی و پیکربندی دستگاه‌های متصل را فراهم می‌کند.

بسته UHD یک درایور سخت‌افزاری همه‌منظوره برای محصولات Ettus Research است. هدف آن ارائه یک درایور میزبان و رابط برنامه‌نویسی کاربردی (API) برای محصولات فعلی و آینده Ettus Research است. کاربران قادر خواهند بود از درایور UHD به‌صورت مستقل یا به همراه برنامه‌های شخص ثالث استفاده کنند.

جزئیات شامل نام واحدها، شماره‌های بازنگری، و حسگرهای موجود روی تمامی بردهای اصلی و بردهای دختر (daughterboard) متصل به USRP است.

خلاصه دستور (SYNOPSIS)

usrpctl [ID] COMMAND [OPTIONS]

شناسه (ID)

آرگومان اختیاری افزاره است. از آن برای تعیین مجموعه‌ای از افزاره‌های USRP که COMMAND باید روی آن‌ها اعمال شود استفاده می‌شود. اگر ID مشخص نشود، COMMAND روی تمام افزاره‌های دردسترس اعمال خواهد شد.

دستور usrpctl آرگومان شناسه‌های افزاره (device args) را که توسط سایر ابزارهای UHD مانند uhd_find_devices به کار می‌رود، تشخیص می‌دهد.

دستور (COMMAND)

عملیاتی است که این ابزار باید انجام دهد. هر دستور می‌تواند روی یک افزاره منفرد یا گروهی از افزاره‌ها اعمال شود. دستوراتی که روی گروهی از افزاره‌ها اجرا می‌شوند، دستور را برای تک‌تک افزاره‌ها تکرار می‌کنند.

دستورات تک‌افزاره‌ای:

دستورات چندافزاره‌ای:

گزینه‌ها (OPTIONS)

گزینه‌ها همیشه اجباری نیستند؛ استفاده از آن‌ها به COMMAND مشخص‌شده بستگی دارد.

دستور find (find command)

دستور find هیچ گزینه دیگری نمی‌پذیرد. اگر ID مشخص نشود، سیستم را برای یافتن افزاره‌های دردسترس و پشتیبانی‌شده پویش کرده و فهرستی از افزاره‌های کشف‌شده را چاپ می‌کند. خروجی چاپ‌شده با uhd_find_devices سازگار است. می‌توان از ID برای محدود کردن فهرست افزاره‌های کشف‌شده استفاده کرد.

دستور probe (probe command)

دستور probe تنها می‌تواند روی یک افزاره منفرد اعمال شود، بنابراین اطمینان حاصل کنید که ID دقیقاً یک افزاره را مشخص می‌کند. این دستور بدون آرگومان، اطلاعات مفصلی درباره افزاره مانند نام، شماره سریال، شماره‌های بازنگری، نسخه سفت‌افزار (firmware) و اطلاعات حسگرهای موجود روی مادربرد و بردهای دختر متصل را نمایش می‌دهد.

گزینه‌ها:

-tree

چاپ درخت کامل ویژگی‌ها (property tree).

دستور reset (reset command)

دستور reset زیربخش‌های مشخص‌شده یک افزاره را بازنشانی می‌کند. اگر ID مشخص نشود، سیستم را برای یافتن افزاره‌های دردسترس و پشتیبانی‌شده پویش کرده و زیربخش مشخص‌شده تمامی افزاره‌های کشف‌شده را بازنشانی می‌کند.

گزینه‌ها:

-mpm

بازنشانی MPM (مدیر ماژول پردازنده).

مثال‌ها (EXAMPLES)

usrpctl find

یافتن تمام افزاره‌های پشتیبانی‌شده

usrpctl type=x300,product=X310 find

یافتن تمام افزاره‌های x310

usrpctl name=my_usrp find

یافتن افزاره‌ای با نام my_usrp

usrpctl addr=192.168.10.2 find

یافتن افزاره‌ای با نشانی IP داده‌شده.

usrpctl addr=192.168.10.2 probe

نمایش اطلاعات افزاره برای USRP با شناسه داده‌شده

usrpctl name=my_usrp probe -tree

نمایش درخت ویژگی‌های افزاره با نام my_usrp

usrpctl addr=192.168.10.2 reset -mpm

بازنشانی MPM روی افزاره با نشانی IP داده‌شده.

همچنین ببینید (SEE ALSO)

مستندات UHD: http://files.ettus.com/manual

حق نشر (COPYRIGHT)

حق نشر © 2022 متعلق به Ettus Research، یک برند National Instruments است.

این برنامه یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط «اجازه‌نامه عمومی همگانی گنو» (GNU GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد، نگارش ۳ یا (به انتخاب خودتان) هر نگارش جدیدتری بازتوزیع کرده و/یا تغییر دهید.

این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «اجازه‌نامه عمومی همگانی گنو» مراجعه کنید.