bladeRF-cli - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

bladeRF-cli - інтерфейс командного рядка та тестова утиліта

СИНТАКСИС

bladeRF-cli

ОПИС

Команда bladeRF-cli утиліта використовується для прошивання файлів мікропрограми, завантаження бітових потоків FPGA та виконання
інші завдання на програмно визначеній радіосистемі nuand bladeRF.

Для отримання додаткової інформації щодо отримання або створення файлів мікропрограми та бітових потоків FPGA, будь ласка
візит http://nuand.com/.

Інтерфейс командного рядка bladeRF і тестова утиліта (1.3.1-0.2016.01~rc1-3)

ВАРІАНТИ

-d, --пристрій
Використовуйте вказаний пристрій bladeRF.

-f, --флеш-прошивка
Запишіть наданий файл мікропрограми FX3 для флешування.

-l, --load-fpga
Завантажте наданий бітовий потік FPGA.

-L, --flash-fpga
Запишіть надане зображення FPGA для флешування для автоматичного завантаження. Використовуйте -L X або --flash-fpga X
щоб вимкнути автозавантаження FPGA.

-p, -- зонд
Перевірте пристрої, роздрукуйте результати, а потім вийдіть. Буде ненульовий статус повернення
повертається, якщо немає доступних пристроїв.

-e, --викон
Виконайте вказану команду інтерактивного режиму. Кілька -e прапори можуть бути
вказано. Команди будуть виконуватися в зазначеному порядку.

-s, -- сценарій
Запустіть наданий сценарій.

-i, --інтерактивні
Увійдіть в інтерактивний режим.

--lib-версія
Роздрукуйте версію libbladeRF і вийдіть.

-v, -- багатослівність
Встановіть рівень детальності libbladeRF. Рівні, перераховані в зростаючому дослівності:

критично, помилка, попередження,
інформація, налагодження, докладний

-- версія
Роздрукуйте версію CLI і вийдіть.

-h, --допомога
Покажіть цей текст довідки.

--інтерактивна допомога
Роздрукуйте довідкову інформацію для всіх інтерактивних команд.

Примітки:
Команда -d Параметр приймає рядок специфікатора пристрою. Дивіться документацію bladerf_open().
для отримання додаткової інформації про формат цього рядка.

Якщо -d не вказано, буде використовуватися перший доступний пристрій
надану команду, або буде відкрито до переходу в інтерактивний режим.

Команди виконуються в такому порядку:

Параметри командного рядка, -e , команди сценарію, команди інтерактивного режиму.

При запуску 'rx/tx start' зі скрипту або через -e, переконайтеся, що ці команди будуть пізніше
за яким слід «rx/tx wait [тайм-аут]», щоб переконатися, що програма не намагатиметься вийти
до завершення прийому/передачі.

ІНТЕРАКТИВНИЙ КОМАНДИ

bladeRF-cli підтримує інтерактивний режим зі сценарієм. Біжи bladeRF-cli --інтерактивні до
увійти в цей режим. Введіть "допомога" для переліку всіх команд, або "допомога " для більш
інформація про .

калібрувати
Використання: калібрувати [параметри]

Виконайте вказану операцію калібрування трансивера.

Доступні операції:

· Автокалібрування внутрішнього зміщення постійного струму LMS

· калібрувати lms [показати]

· відкалібрувати налаштування lms [значення]

· калібрувати lms txlpf [ ]

· калібрувати lms rxlpf [ ]

· калібрувати lms rxvga2 [ ]

Виконайте вказане автокалібрування або всі з них, якщо жодного не передбачено. Коли
надаються значення, вони використовуються замість результатів автоматичного калібрування
процедури. Використовуйте lms show, щоб прочитати та надрукувати поточні значення калібрування LMS.

Для rxvga2 I1 і Q1 є компонентами I і Q етапу 1 відповідно, а I2 і Q2 є
компоненти I і Q стадії 2.

· Калібрування параметрів корекції зсуву RX та TX I/Q DC

· калібрування постійного струму [ ]

· калібрування постійного струму

Відкалібруйте параметри корекції зсуву постійного струму для поточної частоти та посилення
налаштування. Якщо надано значення I/Q, вони застосовуються безпосередньо. cal rxtx є
скорочення для cal rx, а потім cal tx.

· Калібрування параметрів корекції балансу RX і TX I/Q

· калібрувати iq

Встановіть задані параметри посилення IQ або балансу фаз.

· Створення таблиць параметрів корекції DC I/Q RX або TX

· калібрувальний стіл dc [ [f_inc]]

Згенеруйте та запишіть таблицю параметрів корекції I/Q в поточний робочий каталог,
у файлі з іменем _dc_ .tbl. f_min і f_max – це мінімальна та максимальна частоти до
включити в таблицю. f_inc – приріст частоти.

За замовчуванням таблиці генеруються у всьому діапазоні частот з кроком 2 МГц.

ясно
Використання: прозорий

Очищає екран.

нудьгувати
Використання: echo [arg 1] [arg 2] ... [arg n]

Повторюйте кожен аргумент у новому рядку.

Прати
Використання: стерти

Стерти вказані блоки стирання SPI flash.

· - Стерти зміщення блоку

· - Кількість блоків стирання для стирання

flash_backup
Використання: flash_backup ( | )

Створіть резервну копію флеш-даних у вказаний файл. Ця команда займає дві або чотири
аргументи. Викликання з двома аргументами зазвичай рекомендується для використання без розробки.

Параметри:

· - Тип резервного копіювання.

Це вибирає відповідні значення адреси та довжини на основі вибраного типу.

Допустимі параметри:

Опція Опис
─────────────────────────────────────────────────── ────────────────────
cal Дані калібрування
fw Прошивка
fpga40 Метадані та бітовий потік для FPGA 40 kLE
fpga115 Метадані та бітовий потік для FPGA 115 kLE

· - Адреса даних для резервного копіювання. Потрібно стерти з вирівнюванням по блоку.

· - Довжина регіону для резервного копіювання. Потрібно стерти з вирівнюванням по блоку.

Примітка. Якщо вказано адресу та довжину, тип зображення за замовчуванням буде необроблений.

Приклади:

· flash_backup cal.bin cal

Створює резервну копію області даних калібрування.

· flash_backup cal_raw.bin 0x30000 0x10000

Створює резервну копію області калібрування як зображення необроблених даних.

flash_image
Використання: flash_image [параметри виведення]

Роздрукуйте метадані Flash-зображення або створіть нове Flash-зображення. Коли вказано ім’я
файлу флеш-зображення як єдиного аргументу, ця команда надрукує вміст метаданих
зображення.

Для створення нового флеш-зображення можна використовувати наступні параметри.

· дані=

Файл, який містить дані для збереження в зображенні.

· адреса=

Флеш-адреса. Значення за замовчуванням залежить від параметра типу.

· тип=

Тип флеш-зображення. За замовчуванням необроблений.

Допустимі параметри:

Опція Опис
─────────────────────────────────────────────────── ────────────────────
cal Дані калібрування
fw Прошивка
fpga40 Метадані та бітовий потік для FPGA 40 kLE
fpga115 Метадані та бітовий потік для FPGA 115 kLE
необроблені вихідні дані. Параметри адреси та довжини мають бути
надається, якщо вибрано цей тип.

· серійний=

Серійний номер для збереження в зображенні. За замовчуванням нулі.

flash_init_cal
Використання: flash_init_cal [ ]

Створіть і запишіть нову область даних калібрування на поточний відкритий пристрій або в a
файл. Перед виконанням цієї команди обов’язково створіть резервну копію даних калібрування. (Див
команда flash_backup.)

·

40 або 115, залежно від моделі пристрою.

·

Значення налаштування VCTCXO/DAC (0x0-0xffff)

·

Файл для запису даних калібрування. Якщо надано цей аргумент, даних не буде
записується на флеш пристрою.

flash_restore
Використання: flash_restore [ ]

Відновлення флеш-даних із файлу, за бажанням перевизначивши значення в метаданих зображення.

·

За замовчуванням використовується адреса, зазначена у наданому файлі флеш-зображення.

·

За замовчуванням довжина даних у наданому файлі зображення.

fw_log
Використання: fw_log [ім'я файлу]

Прочитайте вміст журналу прошивки пристрою та запишіть його у вказаний файл. Якщо ні
вказано ім'я файлу, вміст журналу записується до стандартного виведення.

допомога
Використання: help [ ]

Надає розширену довідку, як це, для будь-якої команди.

інформація
Використання: інформація

Друкує таку інформацію про відкритий пристрій:

· Серійний номер

· Значення калібрування ЦАП VCTCXO

· Розмір FPGA

· Завантажено чи ні FPGA

· Шина USB, адреса та швидкість

· Backend (позначає, який код інтерфейсу пристрою використовується.)

· Номер екземпляра

jump_to_boot
Використання: jump_to_boot

Очистіть слово-підпис FW у flash і перейдіть до завантажувача FX3.

Пристрій продовжуватиме завантажуватися в завантажувач FX3 через цикли живлення, поки не буде створено
прошивка записується на пристрій.

загрузка
Використання: навантаження

Завантажте бітовий потік FPGA або запрограмуйте флеш SPI FX3.

xb
Використання: xb [параметри]

Увімкнути або налаштувати плату розширення.

Допустимі значення для board_model:

· 100

Плата розширення XB-100 GPIO

· 200

Плата розширення трансвертера XB-200 LF/MF/HF/VHF

Поширені підкоманди:

· увімкнути

Увімкніть плату розширення XB-100 або XB-200.

Підкоманди XB-200:

· фільтр [rx|tx] [50|144|222|custom|auto_1db|auto_3db]

Вибирає вказаний фільтр RX або TX на платі XB-200. Нижче наведено описи
кожен із параметрів фільтра.

· 50

Виберіть фільтр 50-54 МГц (діапазон 6 метрів).

· 144

Виберіть фільтр 144-148 МГц (діапазон 2 метрів).

· 222

Виберіть фільтр 222-225 МГц (діапазон 1.25 метра). Реально,
цей варіант фільтра насправді трохи ширший, охоплюючий
206 МГц - 235 МГц.

· звичай

Вибирає шлях спеціального фільтра. Користувач повинен підключити фільтр
уздовж відповідних з’єднань FILT та FILT-ANT під час використання
цей варіант. В якості альтернативи можна перемикати FILT і FILT-ANT
з'єднання для досягнення "без фільтра" для прийому. (Однак це
_дуже_ не рекомендується для передачі.)

· auto_1db

Автоматично вибирає один із наведених вище варіантів на основі частоти
і бали 1 дБ фільтрів. Спеціальний шлях використовується для випадків
які не пов'язані з вбудованими фільтрами.

· auto_3db

Автоматично вибирає один із наведених вище варіантів на основі частоти
і бали 3 дБ фільтрів. Спеціальний шлях використовується для випадків
які не пов'язані з вбудованими фільтрами.

Приклади:

· xb 200 увімкнути

Вмикає та налаштовує плату розширення трансвертера XB-200.

· xb 200 фільтр rx 144

Вибирає фільтр прийому 144-148 МГц на платі розширення трансвертера XB-200.

MIMO
Використання: mimo [майстер | раб]

Змінити роботу пристрою MIMO.

відкрити
Використання: відкрити [ідентифікатори пристроїв]

Відкрийте вказаний пристрій для використання послідовними командами. Будь-який раніше відкритий пристрій
буде закрито.

Загальна форма рядка ідентифікатора пристрою:

:[пристрій= : ] [екземпляр= ] [серійний= ]

Перегляньте документацію bladerf_open() у libbladeRF для повного опису пристрою
Формат.

заглядати
Використання: заглянути [кількість_адрес]

Команда peek може зчитувати будь-який з пристроїв, що висять на FPGA, включаючи
Приймач LMS6002D, ЦАП підстроювання VCTCXO або чіп тактового генератора Si5338.

Якщо вказано num_addresses, адреса збільшується на 1, а інший перегляд буде
виконано для такої кількості адрес.

Діапазон дійсних адрес:

Діапазон адрес пристрою
─────────────────────────
dac від 0 до 255

lms від 0 до 127
si від 0 до 255

приклад:

· подивитись...

пхати
Використання: ткнути

Команда poke може записати будь-який з пристроїв, що висять на FPGA, включаючи
Приймач LMS6002D, ЦАП підстроювання VCTCXO або чіп тактового генератора Si5338.

Діапазон дійсних адрес:

Діапазон адрес пристрою
─────────────────────────
dac від 0 до 255
lms від 0 до 127
si від 0 до 255

приклад:

· тикати lms ...

друк
Використання: print [параметр]

Команда print приймає параметр для друку. Доступні параметри наведені нижче. Якщо
параметр не вказано, усі параметри друкуються.

Опис параметра
─────────────────────────────────────────────────── ────────────────────────
пропускна здатність Налаштування пропускної здатності
частота Налаштування частоти
gpio FX3 <-> FPGA GPIO стан
loopback Налаштування loopback
lnagain Установка посилення RX LNA, в дБ
rx_mux FPGA RX Налаштування вхідного мультиплексора FIFO
rxvga1 Установка підсилення RXVGA1, дБ
rxvga2 Установка підсилення RXVGA2, дБ
txvga1 Установка підсилення TXVGA1, дБ
txvga2 Установка підсилення TXVGA2, дБ
вибірка Зовнішній або внутрішній режим вибірки
частота дискретизації Налаштування вибірки
trimdac VCTCXO Обрізати налаштування ЦАП
vctcxo_tamer Поточний режим приборкання VCTCXO.
xb_gpio Значення GPIO плати розширення
xb_gpio_dir Напрямок GPIO плати розширення (1=вихід, 0=вхід)

зонд
Використання: зонд [строгий]

Знайдіть підключений пристрій bladeRF і роздрукуйте список результатів.

Без вказівки strict, відсутність будь-яких доступних пристроїв не вважається помилкою.

Якщо надано необов’язковий аргумент strict, ця команда розглядатиме ситуацію, коли немає
пристрої виявляються як помилка, що викликає сценарії або списки команд, які надаються через -e
аргумент командного рядка для негайного завершення.

вихід
Використання: вийти

Вийдіть із CLI.

оговтуватися
Використання: recover [ ]

Завантажте мікропрограму на пристрій, що працює в режимі завантажувача, або введіть список усіх пристроїв, які зараз працюють
режим завантажувача.

Без аргументів ця команда перераховує шину USB та адресу для пристроїв на базі FX3
працює в режимі завантажувача.

Якщо вказано шину, адресу та шлях до файлу мікропрограми, вказаний пристрій буде
завантажте і почніть виконувати надану мікропрограму.

У більшості випадків після успішного завантаження мікропрограми в оперативну пам’ять пристрою користувачі повинні
відкрийте пристрій командою «open» і запишіть прошивку для прошивки через
"завантажити fx3 "

пробіг
Використання: бігати

Запустіть наданий скрипт.

rx
Використання: rx

Отримайте зразки IQ і запишіть їх у вказаний файл. Прийом контролюється і
налаштовано одним із наступних параметрів:

Опис команди
─────────────────────────────────────────────────── ────────────────────────
почати Почати отримувати зразки
stop Припинення отримання зразків
зачекайте Дочекайтеся завершення передачі зразка або доки a
визначений проміжок часу
config Налаштувати прийом зразка. Якщо параметрів немає
за умови, роздруковуються поточні параметри.

Запуск rx без будь-яких додаткових команд є дійсним скороченням для rx config.

Команда очікування приймає додатковий параметр тайм-ауту. Цей параметр за замовчуванням дорівнює одиницям
мілісекунди (мс). Одиницю тайм-ауту можна вказати за допомогою суфіксів ms або s. Якщо це
Параметр не вказано, команда буде чекати до завершення прийому або Ctrl-C
натискається.

Параметри конфігурації мають вигляд param=value і можуть бути вказані в одному або
кілька викликів конфігурації rx. Нижче наведено список доступних параметрів.

Опис параметра
─────────────────────────────────────────────────── ────────────────────────
n Кількість зразків для отримання. 0 = інф.
файл Ім'я файлу для запису отриманих зразків
format Формат вихідного файлу. Один із наступних:
csv: CSV зразків SC16 Q11
кошик: необроблені зразки ЦАП SC16 Q11
зразки Кількість зразків на буфер для використання в
асинхронний потік. Повинно ділитися на 1024 і
>= 1024.
buffers Кількість буферів вибірки для використання в асинхронному
потік. Мінімальне значення 4.
xfers Кількість одночасних передач, які дозволять
асинхронний потік для використання. Це має бути менше
ніж параметр buffers.
тайм-аут Тайм-аут потоку даних. Без суфікса, за замовчуванням
одиниця – мс. Значення за замовчуванням — 1000 мс (1 с).
Допустимі суфікси ms і s.

приклад:

· файл конфігурації rx=/tmp/data.bin format=bin n=10K

Отримуйте (10240 = 10 * 1024) зразки, записуючи їх у /tmp/data.bin у двійковому ЦАП
Формат.

Примітки:

· Параметри n, samples, buffers і xfers підтримують суфікси K, M і G, які
кратні 1024.

· Зупинка rx, а потім початок rx призведе до скорочення файлу зразків. Якщо
це не бажано, обов’язково запустіть rx config, щоб встановити інший файл перед перезапуском
потік прийому.

· Для більш високої частоти дискретизації рекомендується використовувати двійковий вихідний формат, а також
вихідний файл записати в оперативну пам'ять (наприклад / Tmp, / dev / shm), якщо дозволяє місце. Для більших
записує з більш високою частотою дискретизації, подумайте про використання SSD замість HDD.

tx
Використання: tx

Прочитайте зразки IQ із зазначеного файлу та передайте їх. Трансмісія керована і
налаштовано одним із наступних параметрів:

Опис команди
─────────────────────────────────────────────────── ────────────────────────
start Почати передачу зразків
stop Припинення передачі зразків
зачекайте Дочекайтеся завершення передачі зразка або доки a
визначений проміжок часу
config Налаштувати передачу зразка. Якщо параметрів немає
за умови, роздруковуються поточні параметри.

Запуск tx без будь-яких додаткових команд є дійсним скороченням для конфігурації tx.

Команда очікування приймає додатковий параметр тайм-ауту. Цей параметр за замовчуванням дорівнює одиницям
мілісекунди (мс). Одиницю тайм-ауту можна вказати за допомогою суфіксів ms або s. Якщо це
Параметр не вказано, команда буде чекати до завершення передачі або
Ctrl-C натиснуто.

Параметри конфігурації мають вигляд param=value і можуть бути вказані в одному або
кілька викликів конфігурації tx. Нижче наведено список доступних параметрів.

Опис параметра
─────────────────────────────────────────────────── ────────────────────────
файл Ім'я файлу для читання зразків
формат Формат вхідного файлу. Один із наступних:
csv: CSV зразків SC16 Q11 ([-2048, 2047])
кошик: необроблені зразки ЦАП SC16 Q11 ([-2048, 2047])
повторити Кількість разів, коли вміст файлу має бути
передається. 0 означає повторювати до зупинки.
delay Кількість мікросекунд між затримкою
повторна передача вмісту файлу. 0 означає відсутність затримки.
зразки Кількість зразків на буфер для використання в
асинхронний потік. Повинно ділитися на 1024 і
>= 1024.
buffers Кількість буферів вибірки для використання в асинхронному
потік. Мінімальне значення 4.
xfers Кількість одночасних передач, які дозволять
асинхронний потік для використання. Це має бути <
параметр буферів.
тайм-аут Тайм-аут потоку даних. Без суфікса, за замовчуванням
одиниця – мс. Значення за замовчуванням — 1000 мс (1 с).
Дійсними суфіксами є 'ms' і 's'.

приклад:

· файл конфігурації tx=format data.bin=bin repeat=2 затримка=250000

Передача вмісту data.bin двічі з затримкою ~250 мс
передач.

Примітки:

· Параметри n, samples, buffers і xfers підтримують суфікси K, M і G, які
кратні 1024.

· Для більш високої частоти дискретизації вхідний файл рекомендується зберігати в RAM (наприклад / Tmp,
/ dev / shm) або на SSD, а не на HDD.

· При наданні даних CSV ця команда спочатку конвертує їх у двійковий формат, який зберігається
у файлі в поточному робочому каталозі. Під час цього процесу значення виходять за межі діапазону
буде затиснутий.

· При використанні двійкового формату користувач несе відповідальність за забезпечення належності наданих даних
значення знаходяться в межах дозволеного діапазону. Ця передумова полегшує потребу в цьому
програма для виконання перевірок діапазону в чутливих до часу зворотних викликів.

комплект
Використання: комплект

Команда set приймає параметр і довільну кількість аргументів для цього конкретного
параметр. Параметр є одним із:

Опис параметра
─────────────────────────────────────────────────── ────────────────────────
пропускна здатність Налаштування пропускної здатності
частота Налаштування частоти
gpio FX3 <-> FPGA GPIO стан
loopback Налаштування loopback. Запустіть 'set loopback' до режимів списку.
lnagain Установка посилення RX LNA, в дБ. Значення: 0, 3, 6
rxvga1 Установка підсилення RXVGA1, дБ. Діапазон: [5, 30]
rx_mux FPGA RX FIFO вхідний режим мультиплексування. Варіанти:
BASEBAND_LMS, 12BIT_COUNTER, 32BIT_COUNTER,
DIGITAL_LOOPBACK
rxvga1 Установка підсилення RXVGA1, дБ. Діапазон: [5, 30]
rxvga2 Установка підсилення RXVGA2, дБ. Діапазон: [0, 30]
txvga1 Установка підсилення TXVGA1, дБ. Діапазон: [-35, -4]
txvga2 Установка підсилення TXVGA2, дБ. Діапазон: [0, 25]
вибірка Зовнішній або внутрішній режим вибірки
частота дискретизації Налаштування частоти дискретизації
trimdac VCTCXO trim DAC настройки
vctcxo_tamer Режим приборкування VCTCXO. Параметри: Вимкнено, 1PPS, 10MHz
xb_gpio Значення GPIO плати розширення
xb_gpio_dir Напрямок GPIO плати розширення (1=вихід, 0=вхід)

версія
Використання: версія

Друкує інформацію про версію для основного програмного забезпечення та поточного пристрою.

ПРИКЛАДИ

$ bladeRF-cli -l hostedx40.rbf

Завантажує зображення FPGA з назвою hostedx40.rbf на FPGA bladeRF.

примітки: Зображення FPGA, завантажене з --load-fpga, буде втрачено при вимкненні живлення.

$ bladeRF-cli -f firmware.img

Мигає файл firmware.img на мікропрограму bladeRF.

$ bladeRF-cli -L hostedx40.rbf

Мигає зображення FPGA з назвою hostedx40.rbf на bladeRF, де воно буде
автоматично завантажується під час увімкнення живлення.

Використовуйте bladeRF-cli онлайн за допомогою служб onworks.net