.TH UHD "1" "December 2024" "UHD 4" "User Commands"
.SH "نام (NAME)"
rfnoc_image_builder \- ساخت ایمیج UHD با استفاده از بلوک‌های RFNoC
.SH "خلاصه دستور (SYNOPSIS)"
rfnoc_image_builder [\-h] (\fB\-y\fR YAML_CONFIG | \fB\-r\fR GRC_CONFIG)
[\-C BASE_DIR] [\-F FPGA_DIR] [\-B BUILD_DIR] [\-O BUILD_OUTPUT_DIR]
[\-E BUILD_IP_DIR] [\-o IMAGE_CORE_OUTPUT] [\-I INCLUDE_DIR] [\-b GRC_BLOCKS]
[\-l LOG_LEVEL] [\-R] [\-G] [\-W] [\-S SECURE_CORE] [\-K SECURE_KEY]
[\-d DEVICE] [\-n IMAGE_CORE_NAME] [\-t TARGET] [\-g] [\-Y] [\-\-CHECK] [\-s]
[\-P] [\-j JOBS] [\-c] [\-p VIVADO_PATH] [\-H] [\-D]
[\-\-color {never,auto,always}]
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های اختیاری (optional arguments):"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج
.TP
\fB\-y\fR YAML_CONFIG, \fB\-\-yaml\-config\fR YAML_CONFIG
مسیر فایل پیکربندی YAML (فایل هسته ایمیج). مشخص کردن این گزینه یا گزینه \fB\-\-grc\-config\fR الزامی است.
.TP
\fB\-r\fR GRC_CONFIG, \fB\-\-grc\-config\fR GRC_CONFIG
مسیر فایل .grc برای تولید پیکربندی از روی آن
.TP
\fB\-C\fR BASE_DIR, \fC\-\-base\-dir\fR BASE_DIR
مسیر دایرکتوری پایه. مقدار پیش‌فرض دایرکتوری جاری است.
.TP
\fB\-F\fR FPGA_DIR, \fB\-\-fpga\-dir\fR FPGA_DIR
مسیر دایرکتوری درخت منبع FPGA. مقدار پیش‌فرض درخت منبع FPGA در مخزن جاری است.
.TP
\fB\-B\fR BUILD_DIR, \fB\-\-build\-dir\fR BUILD_DIR
مسیر دایرکتوری که هسته ایمیج و مصنوعات ساخت در آن تولید خواهند شد. مقدار پیش‌فرض "build-<image-core-name>" در دایرکتوری پایه است.
.TP
\fB\-O\fR BUILD_OUTPUT_DIR, \fB\-\-build\-output\-dir\fR BUILD_OUTPUT_DIR
مسیر دایرکتوری برای خروجی‌های نهایی ساخت FPGA. مقدار پیش‌فرض "build" در دایرکتوری پایه است.
.TP
\fB\-E\fR BUILD_IP_DIR, \fB\-\-build\-ip\-dir\fR BUILD_IP_DIR
مسیر دایرکتوری برای مصنوعات ساخت IP. مقدار پیش‌فرض "build-ip" در دایرکتوری پایه است.
.TP
\fB\-o\fR IMAGE_CORE_OUTPUT, \fB\-\-image\-core\-output\fR IMAGE_CORE_OUTPUT
منسوخ شده! این گزینه با \fB\-\-build\-dir\fR جایگزین شده است.
.TP
\fB\-x\fR ROUTER_HEX_OUTPUT, \fB\-\-router\-hex\-output\fR ROUTER_HEX_OUTPUT
منسوخ شده! این گزینه نادیده گرفته خواهد شد.
.TP
\fB\-I\fR INCLUDE_DIR, \fB\-\-include\-dir\fR INCLUDE_DIR
مسیر دایرکتوری ماژول Out-of-Tree مربوط به RFNoC
.TP
\fB\-b\fR GRC_BLOCKS, \fB\-\-grc\-blocks\fR GRC_BLOCKS
مسیر دایرکتوری توصیفات بلوک GRC (تنها برای \fB\-\-grc\-config\fR لازم است)
.TP
\fB\-l\fR LOG_LEVEL, \fB\-\-log\-level\fR LOG_LEVEL
تنظیم سطح گزارش‌گیری
.TP
\fB\-R\fR, \fB\-\-reuse\fR
استفاده مجدد از فایل‌های موجود (عدم تولید مجدد هسته ایمیج).
.TP
\fB\-G\fR, \fB\-\-generate\-only\fR
فقط تولید فایل‌ها بدون ساخت FPGA
.TP
\fB\-W\fR, \fB\-\-ignore\-warnings\fR
اجرای فرآیند ساخت حتی در صورت وجود هشدارها در فرآیند ساخت.
.TP
\fB\-S\fR SECURE_CORE, \fB\-\-secure\-core\fR SECURE_CORE
ساخت یک هسته ایمیج امن به جای bitfile. این آرگومان نام فایل YAML تولیدی را مشخص می‌کند.
.TP
\fB\-K\fR SECURE_KEY, \fB\-\-secure\-key\fR SECURE_KEY
مسیر فایل کلید رمزنگاری برای استفاده در هسته امن.
.TP
\fB\-d\fR DEVICE, \fB\-\-device\fR DEVICE
دستگاهی که باید برنامه‌ریزی شود [x300, x310, e310, e320, n300, n310, n320, x410, x440]. باید یا در اینجا و یا در فایل پیکربندی مشخص شود.
.TP
\fB\-n\fR IMAGE_CORE_NAME, \fB\-\-image\-core\-name\fR IMAGE_CORE_NAME, \fB\-\-image_core_name\fR IMAGE_CORE_NAME
نام مورد استفاده برای هسته ایمیج RFNoC. مقدار پیش‌فرض، نام فایل YML هسته ایمیج بدون پسوند آن است.
.TP
\fB\-t\fR TARGET, \fB\-\-target\fR TARGET
هدف ساخت (مانند X310_HG, N320_XG, ...). باید یا در اینجا و یا در فایل پیکربندی مشخص شود.
.TP
\fB\-g\fR, \fB\-\-GUI\fR
باز کردن رابط کاربری گرافیکی Vivado در طول فرآیند ساخت FPGA.
.TP
\fB\-Y\fR, \fB\-\-SYNTH\fR
توقف فرآیند ساخت FPGA پس از مرحله سنتز (Synthesis).
.TP
\fB\-C\fR, \fB\-\-CHECK\fR
فقط اجرای مرحله elaboration برای بررسی نحو HDL.
.TP
\fB\-s\fR, \fB\-\-save\-project\fR
ذخیره پروژه Vivado روی دیسک.
.TP
\fB\-P\fR, \fB\-\-ip\-only\fR
فقط ساخت IPهای مورد نیاز.
.TP
\fB\-j\fR JOBS, \fB\-\-jobs\fR JOBS
تعداد پردازش‌های موازی برای استفاده در make.
.TP
\fB\-c\fR, \fB\-\-clean\-all\fR
پاک‌سازی IP پیش از ساخت جدید.
.TP
\fB\-p\fR VIVADO_PATH, \fB\-\-vivado\-path\fR VIVADO_PATH
مسیر پایه نصب Xilinx Vivado در صورتی که در مسیر پیش‌فرض نباشد (برای نمونه /tools/Xilinx/Vivado).
.TP
\fB\-H\fR, \fB\-\-no\-hash\fR
عدم درج هش فایل مبدا YAML در کد منبع تولیدشده.
.TP
\fB\-D\fR, \fB\-\-no\-date\fR
عدم درج تاریخ یا زمان در کد منبع تولیدشده.
.TP
\fB\-\-color\fR {never,auto,always}
فعال‌سازی خروجی رنگی. در صورت تنظیم روی 'auto'، خروجی رنگی تنها در محیط‌های TTY (مانند شل‌های تعاملی) نمایش داده می‌شود.
.SH "توضیحات (DESCRIPTION)"
این ابزار یک فایل پیکربندی YAML را دریافت کرده و یک بیت‌فایل (bitfile) برای FPGA تولید می‌کند که می‌تواند در یک دستگاه UHD با قابلیت RFNoC به کار رود. فایل پیکربندی YAML بلوک‌های RFNoC را که باید در ایمیج FPGA گنجانده شوند، به همراه اتصالات میان بلوک‌ها و هرگونه پیکربندی اضافی مورد نیاز برای بلوک‌ها توصیف می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
مستندات UHD:
.B https://uhd.readthedocs.io
.LP
سایر برنامه‌های UHD:
.sp
uhd_cal_tx_dc_offset(1) uhd_cal_rx_iq_balance(1) uhd_images_downloader(1)
uhd_config_info(1) uhd_find_devices(1)
.SH "نویسنده (AUTHOR)"
این صفحه راهنما توسط Maitland Bottoms برای پروژه دبیان نوشته شده است (اما می‌تواند توسط دیگران نیز استفاده شود).
.SH "حق نشر (COPYRIGHT)"
Copyright (c) 2020 Ettus Research LLC
.LP
این برنامه یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۳ پروانه و یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده یا تغییر دهید.
.LP
این برنامه به این امید توزیع می‌شود که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو مراجعه کنید.