.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. .TH BLADERF-CLI "1" "December 2025" "bladeRF-cli 1.10.0-git-fcf94233-dirty" "User Commands" .SH "نام (NAME)" bladeRF-cli \- رابط خط فرمان و کنترل رادیویی نرم‌افزاری ابزار bladeRF .SH "خلاصه دستور (SYNOPSIS)" .B bladeRF-cli \fI\,<گزینه‌ها>\/\fR .SH "توضیحات (DESCRIPTION)" ابزار \fBbladeRF-cli\fP برای نوشتن فایل‌های سفت‌افزار روی فلش، بارگذاری بیت‌استریم‌های FPGA و انجام سایر وظایف روی سامانه رادیویی نرم‌افزاری nuand bladeRF استفاده می‌شود\&. برای کسب اطلاعات بیشتر درباره دریافت یا ساخت فایل‌های سفت‌افزار و بیت‌استریم‌های FPGA، لطفاً به نشانی http://nuand.com مراجعه کنید\&. .PP رابط خط فرمان و ابزار آزمایش bladeRF (نسخه 1.10.0\-git\-fcf94233\-dirty) .SH "گزینه‌ها (OPTIONS)" .TP \fB\-d\fR, \fB\-\-device\fR <دستگاه> استفاده از دستگاه مشخص‌شده bladeRF. .TP \fB\-f\fR, \fB\-\-flash\-firmware\fR <فایل> نوشتن فایل سفت‌افزار FX3 ارائه‌شده روی حافظه فلش. .TP \fB\-l\fR, \fB\-\-load\-fpga\fR <فایل> بارگذاری بیت‌استریم FPGA ارائه‌شده. .TP \fB\-L\fR, \fB\-\-flash\-fpga\fR <فایل> نوشتن تصویر FPGA ارائه‌شده روی حافظه فلش برای بارگذاری خودکار. از \fB\-L\fR X یا \fB\-\-flash\-fpga\fR X برای غیرفعال کردن بارگذاری خودکار FPGA استفاده کنید. .TP \fB\-p\fR, \fB\-\-probe\fR کاوش برای یافتن دستگاه‌ها، چاپ نتایج و سپس خروج. در صورتی که هیچ دستگاهی در دسترس نباشد، وضعیت خروجی غیرصفر بازگردانده می‌شود. .TP \fB\-e\fR, \fB\-\-exec\fR <دستور> اجرای دستور مشخص‌شده در حالت تعاملی. می‌توان چندین پرچم \fB\-e\fR را مشخص کرد. دستورات به همان ترتیب ارائه‌شده اجرا خواهند شد. .TP \fB\-s\fR, \fB\-\-script\fR <فایل> اجرای اسکریپت ارائه‌شده. .TP \fB\-i\fR, \fB\-\-interactive\fR ورود به حالت تعاملی. .TP \fB\-\-lib\-version\fR چاپ نسخه libbladeRF و خروج. .TP \fB\-v\fR, \fB\-\-verbosity\fR <سطح> تنظیم سطح پرگویی libbladeRF. سطوح به ترتیب افزایش پرگویی عبارتند از: .TP critical, error, warning, info, debug, verbose .TP \fB\-\-version\fR چاپ نسخه CLI و خروج. .TP \fB\-h\fR, \fB\-\-help\fR نمایش این متن راهنما. .TP \fB\-\-help\-interactive\fR چاپ اطلاعات راهنما برای تمام دستورات تعاملی. .SS "نکات (Notes):" .IP گزینه \fB\-d\fR یک رشته مشخص‌کننده دستگاه را دریافت می‌کند. برای اطلاعات بیشتر پیرامون قالب این رشته، مستندات ()bladerf_open را ببینید. .IP اگر پارامتر \fB\-d\fR ارائه نشود، اولین دستگاه در دسترس برای دستور ارائه‌شده استفاده می‌شود، یا پیش از ورود به حالت تعاملی باز خواهد شد. .IP دستورات به ترتیب زیر اجرا می‌شوند: .IP گزینه‌های خط فرمان، \fB\-e\fR <دستور>، دستورات اسکریپت، دستورات حالت تعاملی. .IP هنگام اجرای 'rx/tx start' از یک اسکریپت یا از طریق \fB\-e\fR، اطمینان حاصل کنید که این دستورات در ادامه با 'rx/tx wait [timeout]' دنبال شوند تا تضمین گردد برنامه پیش از تکمیل دریافت/ارسال اقدام به خروج نمی‌کند. .SH "دستورات تعاملی (INTERACTIVE COMMANDS)" ابزار bladeRF-cli از یک حالت تعاملی با قابلیت اسکریپت‌نویسی پشتیبانی می‌کند. برای ورود به این حالت \fBbladeRF-cli --interactive\fP را اجرا کنید. برای مشاهده فهرست تمام دستورات عبارت "\fBhelp\fP" یا برای دریافت اطلاعات بیشتر درباره <دستور>، عبارت "\fBhelp \fP" را تایپ کنید. .SS calibrate .PP نحوه استفاده: \f[C]calibrate\ \ [options]\f[] .PP انجام عملیات کالیبراسیون مشخص‌شده برای فرستنده-گیرنده (ترنسیور). .PP عملیات‌های در دسترس: .IP \[bu] 2 خود-کالیبراسیون‌های آفست DC داخلی LMS .RS 2 .IP \[bu] 2 \f[C]calibrate\ lms\ [show]\f[] .IP \[bu] 2 \f[C]calibrate\ lms\ tuning\ [value]\f[] .IP \[bu] 2 \f[C]calibrate\ lms\ txlpf\ [\ ]\f[] .IP \[bu] 2 \f[C]calibrate\ lms\ rxlpf\ [\ ]\f[] .IP \[bu] 2 \f[C]calibrate\ lms\ rxvga2\ [\ \ \ \ ]\f[] .PP انجام خود-کالیبراسیون مشخص‌شده، یا تمام آن‌ها در صورت مشخص نشدن هیچ مقداری. هنگامی که مقادیر ارائه شوند، این مقادیر به‌جای نتایج فرایند خود-کالیبراسیون استفاده می‌شوند. از \f[C]lms\ show\f[] برای خواندن و چاپ مقادیر فعلی کالیبراسیون LMS استفاده کنید. .PP برای \f[C]rxvga2\f[]، شناسه‌های \f[C]I1\f[] و \f[C]Q1\f[] به ترتیب مؤلفه‌های I و Q مرحله ۱ هستند، و \f[C]I2\f[] و \f[C]Q2\f[] مؤلفه‌های I و Q مرحله ۲ می‌باشند. .RE .IP \[bu] 2 کالیبراسیون پارامتر تصحیح آفست DC برای RX و TX I/Q .RS 2 .IP \[bu] 2 \f[C]calibrate\ dc\ \ [\ ]\f[] .IP \[bu] 2 \f[C]calibrate\ dc\ \f[] .PP کالیبره کردن پارامترهای تصحیح آفست DC برای تنظیمات فرکانس و بهره فعلی. اگر مقادیر I/Q ارائه شوند، مستقیماً اعمال خواهند شد. دستور \f[C]cal\ rxtx\f[] شکل خلاصه \f[C]cal\ rx\f[] و سپس \f[C]cal\ tx\f[] است. .RE .IP \[bu] 2 کالیبراسیون پارامتر تصحیح تعادل I/Q برای RX و TX .RS 2 .IP \[bu] 2 \f[C]calibrate\ iq\ \ \ \f[] .PP تنظیم پارامترهای مشخص‌شده تعادل فاز یا بهره IQ. .RE .IP \[bu] 2 تولید جدول‌های پارامتر تصحیح DC برای RX یا TX I/Q .RS 2 .IP \[bu] 2 \f[C]calibrate\ table\ dc\ \ [\ \ [f_inc]]\f[] .PP تولید و نوشتن یک جدول پارامتر تصحیح I/Q در دایرکتوری کاری فعلی، در فایلی با نام \f[C]_dc_.tbl\f[]. شناسه‌های \f[C]f_min\f[] و \f[C]f_max\f[] حداقل و حداکثر فرکانس‌ها برای گنجاندن در جدول هستند. شناسه \f[C]f_inc\f[] گام افزایش فرکانس است. .PP به‌طور پیش‌فرض، جدول‌ها در کل محدوده فرکانسی و با گام‌های ۱۰ مگاهرتز تولید می‌شوند. .RE .IP \[bu] 2 تولید جدول‌های پارامتر تصحیح DC برای RX یا TX I/Q جهت جدول جستجوی AGC (AGC Look Up Table) .RS 2 .IP \[bu] 2 \f[C]calibrate\ table\ agc\ \ [\ \ [f_inc]]\f[] .PP کاربرد مشابه با \f[C]calibrate\ table\ dc\f[] با این تفاوت که این فراخوانی پیش از اجرای \f[C]calibrate\ table\ dc\f[]، بهره‌ها را روی مقدار بهره پایه AGC تنظیم می‌کند. .RE .SS clear .PP نحوه استفاده: \f[C]clear\f[] .PP صفحه نمایش را پاک می‌کند. .SS echo .PP نحوه استفاده: \f[C]echo\ [arg\ 1]\ [arg\ 2]\ ...\ [arg\ n]\f[] .PP چاپ هر آرگومان در یک خط جدید. .SS erase .PP نحوه استفاده: \f[C]erase\ \ \f[] .PP پاک کردن بلوک‌های پاک‌سازی (erase blocks) مشخص‌شده در حافظه فلش SPI. .IP \[bu] 2 \f[C]\f[] \- آفست بلوک پاک‌سازی .IP \[bu] 2 \f[C]\f[] \- تعداد بلوک‌های پاک‌سازی برای پاک شدن .SS flash_backup .PP نحوه استفاده: \f[C]flash_backup\ \ (\ |\
\ )\f[] .PP پشتیبان‌گیری از داده‌های حافظه فلش در فایل مشخص‌شده. این دستور دو یا چهار آرگومان دریافت می‌کند. فراخوانی با دو آرگومان معمولاً برای استفاده‌های غیرتوسعه‌ای توصیه می‌شود. .PP پارامترها: .IP \[bu] 2 \f[C]\f[] \- نوع پشتیبان‌گیری. .RS 2 .PP این گزینه مقادیر آدرس و طول مناسب را بر اساس نوع انتخاب‌شده تعیین می‌کند. .PP گزینه‌های معتبر عبارتند از: .PP .TS tab(@); rw(11.7n) lw(52.5n). T{ گزینه T}@T{ توضیحات T} _ T{ \f[C]cal\f[] T}@T{ داده‌های کالیبراسیون T} T{ \f[C]fw\f[] T}@T{ سفت‌افزار (فریم‌ور) T} T{ \f[C]fpga40\f[] T}@T{ متادیتا و بیت‌استریم برای 40 kLE FPGA T} T{ \f[C]fpga115\f[] T}@T{ متادیتا و بیت‌استریم برای 115 kLE FPGA T} T{ \f[C]fpgaA4\f[] T}@T{ متادیتا و بیت‌استریم برای 49 kLE (A4) FPGA T} T{ \f[C]fpgaA5\f[] T}@T{ متادیتا و بیت‌استریم برای 77 kLE (A5) FPGA T} T{ \f[C]fpgaA9\f[] T}@T{ متادیتا و بیت‌استریم برای 301 kLE (A9) FPGA T} .TE .RE .IP \[bu] 2 \f[C]
\f[] \- آدرس داده‌ها برای پشتیبان‌گیری. باید با مرز بلوک پاک‌سازی هم‌تراز باشد. .IP \[bu] 2 \f[C]\f[] \- طول ناحیه برای پشتیبان‌گیری. باید با مرز بلوک پاک‌سازی هم‌تراز باشد. .PP نکته: هنگامی که آدرس و طول ارائه شوند، نوع تصویر به‌طور پیش‌فرض \f[C]raw\f[] خواهد بود. .PP مثال‌ها: .IP \[bu] 2 \f[C]flash_backup\ cal.bin\ cal\f[] .RS 2 .PP از ناحیه داده‌های کالیبراسیون نسخه پشتیبان تهیه می‌کند. .RE .IP \[bu] 2 \f[C]flash_backup\ cal_raw.bin\ 0x30000\ 0x10000\f[] .RS 2 .PP از ناحیه کالیبراسیون به‌عنوان یک تصویر داده خام (raw) نسخه پشتیبان تهیه می‌کند. .RE .SS flash_image .PP نحوه استفاده: \f[C]flash_image\ \ [output\ options]\f[] .PP چاپ متادیتای تصویر فلش یا ساخت یک تصویر فلش جدید. هنگامی که فقط با نام یک فایل تصویر فلش به عنوان آرگومان فراخوانی شود، این دستور محتوای متادیتای تصویر را چاپ می‌کند. .PP گزینه‌های زیر می‌توانند برای ایجاد یک تصویر فلش جدید استفاده شوند: .IP \[bu] 2 \f[C]data=\f[] .RS 2 .PP فایل حاوی داده‌هایی که باید در تصویر ذخیره شوند. .RE .IP \[bu] 2 \f[C]address=\f[] .RS 2 .PP آدرس حافظه فلش. مقدار پیش‌فرض به پارامتر \f[C]type\f[] بستگی دارد. .RE .IP \[bu] 2 \f[C]type=\f[] .RS 2 .PP نوع تصویر فلش. پیش‌فرض \f[C]raw\f[] است. .PP گزینه‌های معتبر عبارتند از: .PP .TS tab(@); rw(11.7n) lw(52.5n). T{ گزینه T}@T{ توضیحات T} _ T{ \f[C]cal\f[] T}@T{ داده‌های کالیبراسیون T} T{ \f[C]fw\f[] T}@T{ سفت‌افزار (فریم‌ور) T} T{ \f[C]fpga40\f[] T}@T{ متادیتا و بیت‌استریم برای 40 kLE FPGA T} T{ \f[C]fpga115\f[] T}@T{ متادیتا و بیت‌استریم برای 115 kLE FPGA T} T{ \f[C]fpgaA4\f[] T}@T{ متادیتا و بیت‌استریم برای 49 kLE (A4) FPGA T} T{ \f[C]fpgaA5\f[] T}@T{ متادیتا و بیت‌استریم برای 77 kLE (A5) FPGA T} T{ \f[C]fpgaA9\f[] T}@T{ متادیتا و بیت‌استریم برای 301 kLE (A9) FPGA T} T{ \f[C]raw\f[] T}@T{ داده خام. در صورت انتخاب این نوع، پارامترهای آدرس و طول باید ارائه شوند. T} .TE .RE .IP \[bu] 2 \f[C]serial=\f[] .RS 2 .PP شماره سریال برای ذخیره در تصویر. پیش‌فرض صفر است. .RE .SS flash_init_cal .PP نحوه استفاده: \f[C]flash_init_cal\ \ \ []\f[] .PP ایجاد و نوشتن یک ناحیه جدید از داده‌های کالیبراسیون روی دستگاهی که در حال حاضر باز است، یا در یک فایل. پیش از اجرای این دستور حتماً از داده‌های کالیبراسیون نسخه پشتیبان تهیه کنید. (دستور \f[C]flash_backup\f[] را ببینید.) .IP \[bu] 2 \f[C]\f[] .RS 2 .PP بسته به مدل دستگاه، 40 یا 115. .RE .IP \[bu] 2 \f[C]\f[] .RS 2 .PP مقدار تریم VCTCXO/DAC (\f[C]0x0\f[]\-\f[C]0xffff\f[]) .RE .IP \[bu] 2 \f[C]\f[] .RS 2 .PP فایل جهت نوشتن داده‌های کالیبراسیون در آن. هنگامی که این آرگومان ارائه شود، هیچ داده‌ای در فلش دستگاه نوشته نخواهد شد. .RE .SS flash_restore .PP نحوه استفاده: \f[C]flash_restore\ \ [
\ ]\f[] .PP بازیابی داده‌های فلش از یک فایل، با امکان بازنویسی اختیاری مقادیر در متادیتای تصویر. .IP \[bu] 2 \f[C]
\f[] .RS 2 .PP پیش‌فرض آدرس مشخص‌شده در فایل تصویر فلش ارائه‌شده است. .RE .IP \[bu] 2 \f[C]\f[] .RS 2 .PP پیش‌فرض طول داده‌ها در فایل تصویر ارائه‌شده است. .RE .SS fw_log .PP نحوه استفاده: \f[C]fw_log\f[] [filename] .PP خواندن محتوای گزارش لاگ سفت‌افزار دستگاه و نوشتن آن در فایل مشخص‌شده. اگر نام فایلی مشخص نشود، محتوای لاگ در خروجی استاندارد نوشته می‌شود. .SS help .PP نحوه استفاده: \f[C]help\ []\f[] .PP ارائه راهنمای گسترده (مانند این متن) برای هر دستور. .SS info .PP نحوه استفاده: \f[C]info\f[] .PP چاپ اطلاعات زیر درباره دستگاه بازشده: .IP \[bu] 2 شماره سریال .IP \[bu] 2 مقدار کالیبراسیون DAC مربوط به VCTCXO .IP \[bu] 2 اندازه FPGA .IP \[bu] 2 آیا FPGA بارگذاری شده است یا خیر .IP \[bu] 2 گذرگاه USB، آدرس و سرعت .IP \[bu] 2 بک‌اند (مشخص‌کننده کد رابط دستگاهی که استفاده می‌شود.) .IP \[bu] 2 شماره نمونه .SS jump_to_boot .PP نحوه استفاده: \f[C]jump_to_boot\f[] .PP پاک کردن کلمه امضای سفت‌افزار (FW signature word) در فلش و پرش به بوت‌لودر FX3. .PP دستگاه تا زمانی که سفت‌افزار جدید روی آن نوشته نشود، در تمامی چرخه‌های راه‌اندازی و روشن/خاموش شدن به بوت‌لودر FX3 بوت خواهد شد. .SS load .PP نحوه استفاده: \f[C]load\ \ \f[] .PP بارگذاری یک بیت‌استریم FPGA یا برنامه‌ریزی حافظه فلش SPI مربوط به FX3. .SS xb .PP نحوه استفاده: \f[C]xb\ \ \ [parameters]\f[] .PP فعال‌سازی یا پیکربندی یک برد توسعه. .PP مقادیر معتبر برای \f[C]board_model\f[]: .IP \[bu] 2 \f[C]100\f[] .RS 2 .PP برد توسعه GPIO مدل XB\-100 .RE .IP \[bu] 2 \f[C]200\f[] .RS 2 .PP برد توسعه ترنسورتر LF/MF/HF/VHF مدل XB\-200 .RE .IP \[bu] 2 \f[C]300\f[] .RS 2 .PP برد تقویت‌کننده مدل XB\-300 .RE .PP زیردستورات مشترک: .IP \[bu] 2 \f[C]enable\f[] .RS 2 .PP فعال‌سازی برد توسعه XB\-100، XB\-200 یا XB\-300. .RE .PP زیردستورات XB-200: .IP \[bu] 2 \f[C]filter\ [rx|tx]\ [50|144|222|custom|auto_1db|auto_3db]\f[] .RS 2 .PP فیلتر RX یا TX مشخص‌شده روی برد XB\-200 را انتخاب می‌کند. در ادامه توضیحات هر یک از گزینه‌های فیلتر آمده است. .IP \[bu] 2 50 .RS 2 .IP .nf \f[C] انتخاب فیلتر 50\-54 مگاهرتز (باند ۶ متری). \f[] .fi .RE .IP \[bu] 2 144 .RS 2 .IP .nf \f[C] انتخاب فیلتر 144\-148 مگاهرتز (باند ۲ متری). \f[] .fi .RE .IP \[bu] 2 222 .RS 2 .IP .nf \f[C] انتخاب فیلتر 222\-225 مگاهرتز (باند ۱.۲۵ متری). در واقع، این گزینه فیلتر کمی عریض‌تر است و محدوده 206 مگاهرتز تا 235 مگاهرتز را پوشش می‌دهد. \f[] .fi .RE .IP \[bu] 2 custom .RS 2 .IP .nf \f[C] مسیر فیلتر سفارشی را انتخاب می‌کند. هنگام استفاده از این گزینه، کاربر باید یک فیلتر را در امتداد اتصالات متناظر FILT و FILT\-ANT وصل کند. همچنین می‌توان اتصالات FILT و FILT\-ANT را با جامپر متصل کرد تا برای دریافت حالت "بدون فیلتر" حاصل شود. (هرچند این کار برای ارسال _اکیداً_ منع می‌شود.) \f[] .fi .RE .IP \[bu] 2 auto_1db .RS 2 .IP .nf \f[C] به‌طور خودکار یکی از گزینه‌های بالا را بر اساس فرکانس و نقاط 1dB فیلترها انتخاب می‌کند. مسیر سفارشی برای حالت‌هایی که به فیلترهای روی برد مرتبط نیستند استفاده می‌شود. \f[] .fi .RE .IP \[bu] 2 auto_3db .RS 2 .IP .nf \f[C] به‌طور خودکار یکی از گزینه‌های بالا را بر اساس فرکانس و نقاط 3dB فیلترها انتخاب می‌کند. مسیر سفارشی برای حالت‌هایی که به فیلترهای روی برد مرتبط نیستند استفاده می‌شود. \f[] .fi .RE .RE .PP زیردستورات XB-300: .IP \[bu] 2 \f[C]\ [on|off]\f[] .RS 2 .PP فعال یا غیرفعال کردن تقویت‌کننده توان (PA)، تقویت‌کننده کم‌نویز (LNA) یا LNA کمکی (aux). در صورتی که [on|off] مشخص نشود، وضعیت فعلی دستگاه مشخص‌شده چاپ می‌شود. .PP نکته: مسیر کمکی روی برد XB\-300 به‌طور پیش‌فرض با قطعات سوار نمی‌شود؛ کنترل \f[C]aux\f[] هیچ اثری روی سیگنال RX نخواهد داشت. این گزینه برای کاربرانی در نظر گرفته شده که قصد دارند برد خود را با سخت‌افزار سفارشی اصلاح کنند. .RE .IP \[bu] 2 \f[C]\f[] .RS 2 .PP خواندن ولتاژ فعلی آشکارساز توان (PDET) و محاسبه توان خروجی. .RE .IP \[bu] 2 \f[C]trx\ \f[] .RS 2 .PP پیکربندی سخت‌افزاری پیش‌فرض XB\-300 شامل مسیرهای مجزای RX و TX است. با این حال، کاربرانی که مایلند تنها از یک آنتن تکی برای TRX استفاده کنند، می‌توانند با اصلاح گزینه‌های نصب مقاومت روی XB\-300 این کار را انجام داده و از این دستور برای جابه‌جایی بین عملیات RX و TX استفاده کنند. (R8، R10 و R23 را روی نقشه شماتیک ببینید.) .RE .PP مثال‌ها: .IP \[bu] 2 \f[C]xb\ 200\ enable\f[] .RS 2 .PP برد توسعه ترنسورتر XB\-200 را فعال و پیکربندی می‌کند. .RE .IP \[bu] 2 \f[C]xb\ 200\ filter\ rx\ 144\f[] .RS 2 .PP فیلتر دریافت 144\-148 مگاهرتز را روی برد توسعه ترنسورتر XB\-200 انتخاب می‌کند. .RE .IP \[bu] 2 \f[C]xb\ 300\ enable\f[] .RS 2 .PP استفاده از GPIOها را برای تعامل با XB\-300 فعال و پیکربندی می‌کند. تقویت‌کننده‌های PA و LNA به‌طور پیش‌فرض غیرفعال خواهند بود. .RE .IP \[bu] 2 \f[C]xb\ 300\ lna\ on\f[] .RS 2 .PP تقویت‌کننده LNA مربوط به RX را روی XB\-300 فعال می‌کند. ال‌ای‌دی D1 (سبز) با فعال شدن LNA روشن می‌شود و هنگام غیرفعال بودن خاموش خواهد بود. .RE .IP \[bu] 2 \f[C]xb\ 300\ pa\ off\f[] .RS 2 .PP تقویت‌کننده PA مربوط به TX را روی XB\-300 غیرفعال می‌کند. ال‌ای‌دی D2 (آبی) با فعال شدن PA روشن می‌شود و هنگام غیرفعال بودن خاموش خواهد بود. .RE .SS mimo .PP نحوه استفاده: \f[C]mimo\ [master\ |\ slave]\f[] .PP تغییر عملکرد MIMO دستگاه. .PP مهم: این دستور منسوخ شده و با \f[C]"print/set\ smb_mode"\f[] جایگزین شده است. برای متن راهنمای استفاده، اجرا کنید: "\f[C]set\ smb_mode\f[]" .SS open .PP نحوه استفاده: \f[C]open\ [device\ identifiers]\f[] .PP باز کردن دستگاه مشخص‌شده برای استفاده در دستورات بعدی. هر دستگاهی که پیش‌تر باز شده باشد بسته خواهد شد. .PP شکل کلی رشته شناسه دستگاه به صورت زیر است: .PP \f[C]:[device=:]\ [instance=]\ [serial=]\f[] .PP برای قالب کامل مشخص‌کننده دستگاه، مستندات \f[C]bladerf_open()\f[] را در libbladeRF بررسی کنید. .SS peek .PP نحوه استفاده: \f[C]peek\ \
\ [num_addresses]\f[] .PP دستور peek می‌تواند هر یک از قطعات متصل به FPGA را بخواند. این قطعات عبارتند از: .IP \[bu] 2 bladeRF 1: فرستنده-گیرنده LMS6002D، مبدل DAC تنظیم دقیق VCTCXO، مولد پالس ساعت Si5338 .IP \[bu] 2 bladeRF 2: فرستنده-گیرنده AD9361، مبدل DAC تنظیم دقیق VCTCXO، ترکیب‌کننده فرکانس ADF4002 .PP در صورت مشخص شدن \f[C]num_addresses\f[]، آدرس یکی‌یکی افزایش یافته و عملیات خواندن به همان تعداد آدرس تکرار می‌شود. .PP محدوده‌های معتبر آدرس: .PP .TS tab(@); r l. T{ دستگاه T}@T{ محدوده آدرس T} _ T{ \f[C]rfic\f[] T}@T{ 0 تا 0x3F7 (1015) T} T{ \f[C]pll\f[] T}@T{ 0 تا 3 T} T{ \f[C]dac\f[] T}@T{ 0 تا 255 T} T{ \f[C]lms\f[] T}@T{ 0 تا 127 T} T{ \f[C]si\f[] T}@T{ 0 تا 255 T} .TE .PP مثال: .IP \[bu] 2 \f[C]peek\ si\ ...\f[] .SS poke .PP نحوه استفاده: \f[C]poke\ \
\ \f[] .PP دستور poke می‌تواند روی هر یک از قطعات متصل به FPGA بنویسد. این قطعات عبارتند از: .IP \[bu] 2 bladeRF 1: فرستنده-گیرنده LMS6002D، مبدل DAC تنظیم دقیق VCTCXO، مولد پالس ساعت Si5338 .IP \[bu] 2 bladeRF 2: فرستنده-گیرنده AD9361، مبدل DAC تنظیم دقیق VCTCXO، ترکیب‌کننده فرکانس ADF4002 .PP محدوده‌های معتبر آدرس: .PP .TS tab(@); r l. T{ دستگاه T}@T{ محدوده آدرس T} _ T{ \f[C]rfic\f[] T}@T{ 0 تا 0x3F7 (1015) T} T{ \f[C]pll\f[] T}@T{ 0 تا 3 T} T{ \f[C]dac\f[] T}@T{ 0 تا 255 T} T{ \f[C]lms\f[] T}@T{ 0 تا 127 T} T{ \f[C]si\f[] T}@T{ 0 تا 255 T} .TE .PP مثال: .IP \[bu] 2 \f[C]poke\ lms\ ...\f[] .SS print .PP نحوه استفاده: \f[C]print\ [parameter]\f[] .PP دستور \f[C]print\f[] یک پارامتر برای چاپ دریافت می‌کند. پارامترهای موجود در زیر فهرست شده‌اند. اگر پارامتری مشخص نشود، تمام پارامترها چاپ خواهند شد. .PP پارامترهای عمومی: .PP .TS tab(@); rw(13.6n) lw(54.4n). T{ پارامتر T}@T{ توضیحات T} _ T{ \f[C]bandwidth\f[] T}@T{ تنظیمات پهنای باند T} T{ \f[C]frequency\f[] T}@T{ تنظیمات فرکانس T} T{ \f[C]agc\f[] T}@T{ کنترل خودکار بهره (AGC) T} T{ \f[C]loopback\f[] T}@T{ تنظیمات لوپ‌بک (حلقه برگشتی) T} T{ \f[C]rx_mux\f[] T}@T{ تنظیم مالتی‌پلکسر ورودی FIFO دریافت (RX) در FPGA T} T{ \f[C]gain\f[] T}@T{ تنظیمات بهره T} T{ \f[C]samplerate\f[] T}@T{ تنظیمات نرخ نمونه‌برداری T} T{ \f[C]trimdac\f[] T}@T{ تنظیمات DAC تنظیم دقیق VCTCXO T} T{ \f[C]tuning_mode\f[] T}@T{ تنظیمات حالت تنظیم (Tuning mode) T} T{ \f[C]hardware\f[] T}@T{ وضعیت سخت‌افزاری سطح پایین T} .TE .PP پارامترهای اختصاصی BladeRF1: .PP .TS tab(@); rw(13.6n) lw(54.4n). T{ پارامتر T}@T{ توضیحات T} _ T{ \f[C]gpio\f[] T}@T{ وضعیت GPIO بین FX3 <\-> FPGA T} T{ \f[C]lnagain\f[] T}@T{ بهره LNA دریافت (RX)، بر حسب dB (منسوخ‌شده) T} T{ \f[C]rxvga1\f[] T}@T{ بهره RXVGA1، بر حسب dB (منسوخ‌شده) T} T{ \f[C]rxvga2\f[] T}@T{ بهره RXVGA2، بر حسب dB (منسوخ‌شده) T} T{ \f[C]txvga1\f[] T}@T{ بهره TXVGA1، بر حسب dB (منسوخ‌شده) T} T{ \f[C]txvga2\f[] T}@T{ بهره TXVGA2، بر حسب dB (منسوخ‌شده) T} T{ \f[C]sampling\f[] T}@T{ حالت نمونه‌برداری خارجی یا داخلی T} T{ \f[C]smb_mode\f[] T}@T{ حالت عملکرد درگاه پالس ساعت SMB T} T{ \f[C]vctcxo_tamer\f[] T}@T{ حالت کنونی مهارکننده VCTCXO T} T{ \f[C]xb_gpio\f[] T}@T{ مقادیر GPIO برد توسعه T} T{ \f[C]xb_gpio_dir\f[] T}@T{ جهت GPIO برد توسعه (1=خروجی، 0=ورودی) T} .TE .PP پارامترهای اختصاصی BladeRF2: .PP .TS tab(@); rw(13.6n) lw(54.4n). T{ پارامتر T}@T{ توضیحات T} _ T{ \f[C]clock_sel\f[] T}@T{ انتخاب پالس ساعت سیستم T} T{ \f[C]clock_out\f[] T}@T{ انتخاب خروجی پالس ساعت T} T{ \f[C]rssi\f[] T}@T{ نشانگر قدرت سیگنال دریافتی (RSSI) T} T{ \f[C]clock_ref\f[] T}@T{ وضعیت تراشه ADF4002 T} T{ \f[C]refin_freq\f[] T}@T{ فرکانس ساعت مرجع ADF4002 T} T{ \f[C]biastee\f[] T}@T{ وضعیت کنونی بایاس-تی (bias\-tee) T} T{ \f[C]filter\f[] T}@T{ انتخاب فیلتر FIR تراشه RFIC T} .TE .SS probe .PP نحوه استفاده: \f[C]probe\ [strict]\f[] .PP جستجو برای یافتن دستگاه bladeRF متصل و چاپ فهرست نتایج. .PP بدون مشخص کردن \f[C]strict\f[]، در دسترس نبودن دستگاه‌ها به عنوان خطا در نظر گرفته نمی‌شود. .PP هنگامی که آرگومان اختیاری \f[C]strict\f[] مشخص شود، این دستور وضعیت عدم وجود دستگاه را به عنوان خطا در نظر گرفته و باعث می‌شود اسکریپت‌ها یا فهرست دستورات ارائه‌شده از طریق آرگومان خط فرمان \f[C]\-e\f[] بلافاصله متوقف شوند. .SS quit .PP نحوه استفاده: \f[C]quit\f[] .PP خروج از خط فرمان تعاملی (CLI). .SS recover .PP نحوه استفاده: \f[C]recover\ [\
\ ]\f[] .PP بارگذاری سفت‌افزار روی دستگاهی که در حالت بوت‌لودر اجرا می‌شود، یا فهرست کردن تمام دستگاه‌هایی که در حال حاضر در حالت بوت‌لودر هستند. .PP بدون آرگومان، این دستور گذرگاه و آدرس USB را برای دستگاه‌های مبتنی بر FX3 که در حالت بوت‌لودر اجرا می‌شوند فهرست می‌کند. .PP در صورت ارائه گذرگاه، آدرس و مسیر فایل سفت‌افزار، سفت‌افزار ارائه‌شده روی دستگاه مشخص‌شده بارگذاری شده و اجرای آن آغاز می‌شود. .PP در بیشتر موارد، پس از بارگذاری موفق سفت‌افزار در RAM دستگاه، کاربران باید دستگاه را با دستور "\f[C]open\f[]" باز کرده و سفت‌افزار را از طریق دستور "\f[C]load\ fx3\ \f[]" روی حافظه فلش بنویسند. .SS run .PP نحوه استفاده: \f[C]run\