.TH "uhd_image_loader" 1 "3.9.0" UHD "User Commands"
.SH "نام (NAME)"
uhd_image_loader \- فلش‌کردن و بارگذاری ایمیج‌های FPGA/فریم‌ور روی سخت‌افزارهای USRP/UHD

.SH "خلاصه دستور (SYNOPSIS)"
.B uhd_image_loader
[\fIگزینه‌ها\fR]

.SH "توضیحات (DESCRIPTION)"
رایت و فلش‌کردن فریم‌ور (میان‌افزار) و ایمیج‌های FPGA روی دستگاه‌های متصل Ettus Research.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-help
نمایش فهرست گزینه‌های راهنما.
.TP
.BI \-\-args= ""
آرگومان‌های دستگاه و بارگذارنده.
.TP
.BI \-\-fw\-path= ""
مسیر فایل فریم‌ور سفارشی.
.TP
.BI \-\-fpga\-path= ""
مسیر فایل FPGA سفارشی.
.TP
.B \-\-no\-fw
عدم رایت فریم‌ور.
.TP
.B \-\-no\-fpga
عدم رایت FPGA.

.SH "مشخص کردن دستگاه خاص (SPECIFYING A PARTICULAR DEVICE)"
.PP
بدون ارائه هرگونه آرگومان از طریق گزینه
.BR \-\-args="" ,
این ابزار نشستی را با اولین دستگاه Ettus Research که شناسایی کند آغاز خواهد کرد. آرگومان‌های زیر جستجوی ابزار را برای یک دستگاه مشخص محدود می‌کنند:

.SS "همه دستگاه‌ها (All devices)"
.PP
آرگومان‌های
.I name=
و
.I serial=
می‌توانند برای مشخص کردن هر دستگاهی به جز دستگاه USB مقداردهی‌نشده یا بوت‌لودر OctoClock استفاده شوند. آرگومان
.I type=
می‌تواند برای تعیین نوع دستگاه به شرح زیر استفاده شود:

.PP
.nf
"type=" argument

Argument       |     Device

type=usrp2     |     USRP N200, USRP N210

type=b200      |     USRP B200, USRP B210

type=e3x0      |     USRP E310

type=octoclock |     OctoClock
.fi

.PP
\fBنکته:\fR دستگاه‌های USRP1، USRP2 و USRP B100 پشتیبانی نمی‌شوند.

.SS "دستگاه‌های تحت شبکه (Network devices)"
.PP
به‌طور پیش‌فرض، این ابزار تمام رابط‌های شبکه را برای یافتن دستگاه‌های مبتنی بر شبکه بررسی می‌کند، اما یک آدرس IP مشخص را می‌توان با آرگومان
.I addr=
تعیین کرد.

.SS "دستگاه‌های NI-RIO (NI-RIO devices)"
.PP
دستگاه‌های سری X متصل‌شده از طریق PCIe را می‌توان با شناسه منبع NI-RIO از طریق آرگومان
.I resource=
مشخص کرد، و پورت RPC برای برقراری ارتباط با آن را می‌توان با آرگومان
.I rpc-port=
تعیین نمود. استفاده از این گزینه‌ها توصیه نمی‌شود، زیرا مقادیر پیش‌فرض آن‌ها تقریباً همیشه استفاده می‌شوند.

.SS "دستگاه‌های OctoClock (OctoClock devices)"
.PP
نام و شماره سریال دستگاه OctoClock فقط زمانی نمایش داده می‌شوند که فریم‌ور بارگذاری شده باشد؛ بنابراین اگر دستگاه فقط دارای بوت‌لودر باشد، تنها آرگومان
.I addr=
می‌تواند برای یافتن آن استفاده شود.

.SH "گزینه‌های بارگذار ویژه دستگاه (DEVICE-SPECIFIC LOADER OPTIONS)"
.PP
برخی از دستگاه‌ها گزینه‌های خاصی برای سفارشی‌سازی فرایند بارگذاری ایمیج خود دارند که می‌توان آن‌ها را از طریق گزینه
.B \-\-args=""
ارسال کرد. این آرگومان‌ها در زیر مشخص شده‌اند:

.SS "دستگاه‌های USRP N200 و USRP N210"
.PP
گزینه
.I overwrite-safe
ایمیج‌های FPGA و فریم‌ور حالت امن (safe-mode) دستگاه را بازنویسی می‌کند. این کار
\fBتوصیه نمی‌شود\fR،
زیرا این ایمیج‌ها به عنوان نسخه پشتیبان در صورت خرابی ایمیج‌های اصلی دستگاه عمل می‌کنند.

.PP
گزینه
.I reset
دستگاه را پس از پایان فرایند بارگذاری به‌طور خودکار بازنشانی (Reset) می‌کند. هنگامی که دستگاه بازنشانی می‌شود، ایمیج‌های جدید آن بارگذاری خواهند شد.

.SS "دستگاه‌های USRP X300 و USRP X310 (فقط اترنت)"
.PP
گزینه
.I configure
دستگاه را پس از پایان فرایند بارگذاری به‌طور خودکار بازنشانی می‌کند. هنگامی که دستگاه بازنشانی می‌شود، ایمیج FPGA جدید آن بارگذاری خواهد شد.

.PP
گزینه
.I verify
به دستگاه اعلام می‌کند که در حین بارگذاری، صحت و سلامت ایمیج را به‌صورت داخلی بررسی و اعتبارسنجی کند. این کار زمان بارگذاری را به میزان چشمگیری افزایش می‌دهد.

.SH "مثال‌ها (EXAMPLES)"

.SS "بارگذاری فقط ایمیج پیش‌فرض FPGA روی دستگاه مشخص N2x0 و راه‌اندازی مجدد"
.PP
.nf
uhd_image_loader --args="type=usrp2,addr=192.168.10.2,reset" --no-fw
.fi

.SS "بارگذاری ایمیج سفارشی FPGA روی دستگاه مشخص X3x0"
.PP
.nf
uhd_image_loader --args="type=x300,addr=192.168.40.2" --fpga-path="/home/user/my_x300_fpga_image.bit"
.fi

.SH "همچنین ببینید (SEE ALSO)"
مستندات UHD:
.B http://files.ettus.com/manual
.LP
مستندات GR-UHD:
.B http://gnuradio.org/doc/doxygen/page_uhd.html
.LP
سایر برنامه‌های UHD:
.PP
.BR uhd_images_downloader (1),
.BR usrp2_card_burner (1)

.SH "نویسنده (AUTHOR)"
این صفحه راهنما توسط Nicholas Corgan برای پروژه دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).

.SH "حق نشر (COPYRIGHT)"
حق نشر (c) 2015-2022 Ettus Research, A National Instruments Brand
.LP
این برنامه یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط پروانه عمومی همگانی گنو (GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۳ پروانه و چه (به انتخاب خودتان) هر نسخه بالاتر دیگری، مجدداً توزیع کرده و/یا تغییر دهید.
.LP
این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو مراجعه کنید.