bladeRF-cli - Интернет в облаке

ПРОГРАММА:

ИМЯ

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

СИНТАКСИС

лезвие RF-cli

ОПИСАНИЕ

Ассоциация лезвие RF-cli Утилита используется для прошивки файлов прошивки, загрузки битовых потоков FPGA и выполнения
другие задачи на программно-конфигурируемой радиосистеме nuand bladeRF.

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

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

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-d, --устройство
Используйте указанное устройство bladeRF.

-f, --flash-прошивка
Запишите предоставленный файл прошивки FX3 для прошивки.

-l, --load-fpga
Загрузите предоставленный битовый поток FPGA.

-L, --flash-fpga
Запишите предоставленный образ FPGA во флэш-память для автозагрузки. Использовать -L X или --flash-fpga X
для отключения автозагрузки ПЛИС.

-p, - зонд
Проверьте устройства, распечатайте результаты и выйдите. Ненулевой статус возврата будет
возвращается, если нет доступных устройств.

-e, --exec
Выполнить указанную команду интерактивного режима. Несколько -e флаги могут быть
указано. Команды будут выполняться в указанном порядке.

-s, --скрипт
Запустите предоставленный сценарий.

-i, - интерактивный
Войдите в интерактивный режим.

--lib-версия
Напечатайте версию libbladeRF и выйдите.

-v, - многословие
Установите уровень детализации libbladeRF. Уровни, перечисленные по возрастающей подробности:

критическое, ошибка, предупреждение,
информация, отладка, подробный

--версия
Распечатайте версию CLI и выйдите.

-h, --Помогите
Показать этот справочный текст.

--help-интерактивный
Распечатать справочную информацию для всех интерактивных команд.

Ноты:
Ассоциация -d option принимает строку спецификатора устройства. См. Документацию bladerf_open ()
для получения дополнительной информации о формате этой строки.

Если же линия индикатора -d не указан, первое доступное устройство будет использоваться для
предоставленная команда или будет открыта перед переходом в интерактивный режим.

Команды выполняются в следующем порядке:

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

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

INTERACTIVE КОМАНДЫ

bladeRF-cli поддерживает интерактивный режим с поддержкой сценариев. Запустить лезвие RF-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

· Откалибровать постоянный ток [ ]

· Откалибровать постоянный ток

Откалибруйте параметры коррекции смещения постоянного тока для текущей частоты и усиления.
настройки. Если указаны значения I / Q, они применяются напрямую. cal rxtx - это
сокращение для cal rx, за которым следует cal tx.

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

· Откалибровать iq

Установите указанные параметры усиления IQ или фазового баланса.

· Создание таблиц параметров коррекции постоянного тока RX или TX I / Q

· Калибровочный стол постоянного тока [ [f_inc]]

Сгенерировать и записать таблицу параметров коррекции I / Q в текущий рабочий каталог,
в файле с именем _Округ Колумбия_ .tbl. f_min и f_max - минимальная и максимальная частоты для
включить в таблицу. f_inc - приращение частоты.

По умолчанию таблицы создаются для всего диапазона частот с шагом 2 МГц.

Очистить
Использование: ясно

Очищает экран.

эхо
Использование: echo [аргумент 1] [аргумент 2] ... [аргумент n]

Выводите каждый аргумент на новую строку.

Стирать
Использование: стереть

Стереть указанные блоки стирания SPI flash.

· - Смещение блока стирания

· - Количество стираемых блоков для стирания

flash_backup
Использование: flash_backup ( | )

Выполните резервное копирование флеш-данных в указанный файл. Эта команда занимает два или четыре
аргументы. Вызов с двумя аргументами обычно рекомендуется не для разработки.

Параметры:

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

Это выбирает соответствующие значения адреса и длины в зависимости от выбранного типа.

Допустимые варианты:

Вариант Описание
───────────────────────────────────────────────────── ──────────────────
калибровка Данные калибровки
прошивка fw
fpga40 Метаданные и битовый поток для ПЛИС 40 kLE
fpga115 Метаданные и битовый поток для ПЛИС 115 kLE

· - Адрес данных для резервного копирования. Должен быть выровнен по блоку стирания.

· - Длина области для резервного копирования. Должен быть выровнен по блоку стирания.

Примечание. Если указаны адрес и длина, по умолчанию будет использоваться необработанный тип изображения.

Примеры:

· Flash_backup cal.bin cal

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

· Flash_backup cal_raw.bin 0x30000 0x10000

Резервное копирование области калибровки в виде изображения необработанных данных.

flash_image
Использование: flash_image [параметры вывода]

Распечатайте метаданные флэш-изображения или создайте новое флэш-изображение. Если указано имя
файла флеш-изображения в качестве единственного аргумента, эта команда распечатает содержимое метаданных
изображения.

Следующие параметры можно использовать для создания нового флеш-образа.

· Данные =

Файл, содержащий данные для хранения в изображении.

· Адрес =

Флэш-адрес. Значение по умолчанию зависит от параметра типа.

· Type =

Тип флеш-образа. По умолчанию необработанный.

Допустимые варианты:

Вариант Описание
───────────────────────────────────────────────────── ──────────────────
калибровка Данные калибровки
прошивка fw
fpga40 Метаданные и битовый поток для ПЛИС 40 kLE
fpga115 Метаданные и битовый поток для ПЛИС 115 kLE
необработанные сырые данные. Параметры адреса и длины должны быть
предоставляется, если выбран этот тип.

· Серийный =

Серийный номер для сохранения в изображении. По умолчанию нули.

flash_init_cal
Использование: flash_init_cal [ ]

Создайте и запишите новую область данных калибровки в текущее открытое устройство или в
файл. Обязательно сделайте резервную копию данных калибровки перед запуском этой команды. (См.
flash_backup команда.)

·

Либо 40, либо 115, в зависимости от модели устройства.

·

Значение подстройки VCTCXO / DAC (0x0-0xffff)

·

Файл, в который записываются данные калибровки. Если указан этот аргумент, данные не будут
записано на флешку устройства.

flash_restore
Использование: flash_restore [ ]

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

·

По умолчанию используется адрес, указанный в предоставленном файле флэш-образа.

·

По умолчанию используется длина данных в предоставленном файле изображения.

fw_log
Использование: fw_log [имя файла]

Прочтите содержимое журнала прошивки устройства и запишите его в указанный файл. Если нет
указано имя файла, содержимое журнала записывается в стандартный вывод.

помощь
Использование: help [ ]

Предоставляет расширенную помощь по любой команде.

info
Использование: информация

Печатает следующую информацию об открытом устройстве:

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

· Калибровочное значение VCTCXO DAC

· Размер ПЛИС

· Независимо от того, загружена ли ПЛИС

· Шина USB, адрес и скорость

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

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

jump_to_boot
Использование: jump_to_boot

Удалите слово подписи FW во флеш-памяти и перейдите к загрузчику FX3.

Устройство будет продолжать загружаться в загрузчик FX3 при выключении питания до тех пор, пока не появится новый
прошивка записана в устройство.

загрузка
Использование: загрузка

Загрузите поток битов FPGA или запрограммируйте SPI flash FX3.

xb
Использование: xb [параметры]

Включите или настройте плату расширения.

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

· НИКОГДА

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

· НИКОГДА

Плата расширения трансвертера 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–54 МГц (полоса 6 метров).

· НИКОГДА

Выберите фильтр 144–148 МГц (полоса 2 метров).

· НИКОГДА

Выберите фильтр 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 устройства.

открытый
Использование: открыть [идентификаторы устройства]

Откройте указанное устройство для использования с последовательными командами. Любое ранее открытое устройство
будет закрыто.

Общая форма строки идентификатора устройства:

: [устройство = : ] [instance = ] [серийный = ]

См. Документацию bladerf_open () в libbladeRF для полного описания устройства.
формат.

заглядывать
Использование: peek [num_addresses]

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

Если указано num_addresses, адрес увеличивается на 1 и выполняется еще один просмотр.
выполнено по такому количеству адресов.

Допустимые диапазоны адресов:

Диапазон адресов устройства
────────────────────────
ЦАП от 0 до 255

lms от 0 до 127
si от 0 до 255

Пример:

· Подглядывать си ...

совать
Использование: тыкать

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

Допустимые диапазоны адресов:

Диапазон адресов устройства
────────────────────────
ЦАП от 0 до 255
lms от 0 до 127
si от 0 до 255

Пример:

· Тыкай лмс ...

Распечатать
Использование: print [параметр]

Команда печати принимает параметр для печати. Доступные параметры перечислены ниже. Если
параметр не указан, выводятся все параметры.

Параметр Описание
───────────────────────────────────────────────────── ───────────────────────
пропускная способность Настройки пропускной способности
частота Настройки частоты
gpio FX3 <-> FPGA GPIO состояние
loopback Настройки петли
lnagain Настройка усиления RX LNA, в дБ
rx_mux FPGA RX FIFO настройка мультиплексора ввода
rxvga1 Настройка усиления RXVGA1, в дБ
rxvga2 Настройка усиления RXVGA2, в дБ
txvga1 Настройка усиления TXVGA1, в дБ
txvga2 Настройка усиления TXVGA2, в дБ
отбор проб Внешний или внутренний режим отбора проб
samplerate Настройки Samplerate
настройки тримдака VTCXO Trim DAC
vctcxo_tamer Текущий режим укротителя VCTCXO.
xb_gpio Значения GPIO платы расширения
xb_gpio_dir Направление GPIO платы расширения (1 = выход, 0 = вход)

зонд
Использование: зонд [строгий]

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

Без указания strict отсутствие каких-либо доступных устройств не считается ошибкой.

Если указан необязательный аргумент strict, эта команда будет обрабатывать ситуацию, когда нет
устройства обнаруживаются как ошибка, вызывая скрипты или списки команд, предоставленные через -e
аргумент командной строки для немедленного завершения.

выход
Использование: выйти

Выйдите из интерфейса командной строки.

оправляться
Использование: восстановление [ ]

Загрузите микропрограмму на устройство, работающее в режиме загрузчика, или перечислите все устройства, находящиеся в данный момент.
режим загрузчика.

Без аргументов эта команда выводит список USB-шины и адреса для устройств на базе FX3.
работает в режиме загрузчика.

Если предоставлены шина, адрес и путь к файлу прошивки, указанное устройство будет
загружается и запускается предоставленная прошивка.

В большинстве случаев после успешной загрузки прошивки в оперативную память устройства пользователям следует
открыть устройство командой "open", и записать прошивку в прошивку через
"загрузить fx3 "

пробег
Использование: запустить

Запустите предоставленный сценарий.

rx
Использование: rx

Получите образцы IQ и запишите их в указанный файл. Прием контролируется и
настраивается одним из следующих способов:

Описание команды
───────────────────────────────────────────────────── ───────────────────────
начать Начать прием образцов
стоп Прекратить прием образцов
wait Подождите, пока завершится передача образца, или пока
указанное количество времени истекает
config Настроить прием образца. Если параметры не указаны
при условии, текущие параметры распечатываются.

Запуск rx без каких-либо дополнительных команд является допустимым сокращением для конфигурации rx.

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

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

Параметр Описание
───────────────────────────────────────────────────── ───────────────────────
n Количество образцов для получения. 0 = инф.
файл Имя файла для записи полученных образцов в
формат Формат выходного файла. Одно из следующих:
csv: CSV образцов SC16 Q11
bin: необработанные образцы ЦАП SC16 Q11
выборки Количество выборок в буфере для использования в
асинхронный поток. Должно делиться на 1024 и
> = 1024.
буферы Количество буферов выборки для использования в асинхронном
транслировать. Минимальное значение - 4.
xfers Количество одновременных переводов, позволяющее
асинхронный поток для использования. Это должно быть меньше
чем параметр буферов.
timeout Тайм-аут потока данных. Без суффикса по умолчанию
единица - мс. Значение по умолчанию - 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, чтобы установить другой файл перед перезапуском
rx поток.

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

tx
Использование: TX

Прочтите образцы IQ из указанного файла и передайте их. Трансмиссия контролируется и
настраивается одним из следующих способов:

Описание команды
───────────────────────────────────────────────────── ───────────────────────
start Начать передачу образцов
стоп Прекратить передачу образцов
wait Подождите, пока завершится передача образца, или пока
указанное количество времени истекает
config Настроить передачу образца. Если параметры не указаны
при условии, текущие параметры распечатываются.

Запуск tx без каких-либо дополнительных команд является допустимым сокращением для tx config.

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

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

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

Пример:

· Tx config file = data.bin format = bin repeat = 2 delay = 250000

Передача содержимого data.bin два раза с задержкой ~ 250 мс между
передач.

Ноты:

· Параметры n, samples, buffers и xfers поддерживают суффиксы K, M и G, которые
кратны 1024.

· Для более высоких частот дискретизации рекомендуется хранить входной файл в ОЗУ (например, / Tmp,
/ dev / shm) или на SSD, а не на HDD.

· При предоставлении данных CSV эта команда сначала преобразует их в двоичный формат, сохраненный
в файле в текущем рабочем каталоге. Во время этого процесса значения вне допустимого диапазона
будет зажат.

· При использовании двоичного формата пользователь несет ответственность за то, чтобы предоставленные данные
значения находятся в допустимом диапазоне. Это предварительное условие устраняет необходимость в этом
программа для выполнения проверки диапазона в обратных вызовах с учетом времени.

набор
Использование: набор

Команда set принимает параметр и произвольное количество аргументов для этого конкретного
параметр. Параметр может быть одним из:

Параметр Описание
───────────────────────────────────────────────────── ───────────────────────
пропускная способность Настройки пропускной способности
частота Настройки частоты
gpio FX3 <-> FPGA GPIO состояние
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
vctcxo_tamer Режим укротителя VCTCXO. Варианты: Disabled, 1PPS, 10MHz.
xb_gpio Значения GPIO платы расширения
xb_gpio_dir Направление GPIO платы расширения (1 = выход, 0 = вход)

версия
Использование: версия

Печатает информацию о версии программного обеспечения хоста и текущего устройства.

ПРИМЕРЫ

$bladeRF-cli -l hostedx40.rbf

Загружает образ ПЛИС с именем hostedx40.rbf в ПЛИС bladeRF.

Внимание: Образ FPGA, загруженный с параметром --load-fpga, будет утерян при выключении питания.

$ bladeRF-cli -f прошивка.img

Прошивает firmware.img на прошивку bladeRF.

$bladeRF-cli -L hostedx40.rbf

Записывает образ ПЛИС с именем hostedx40.rbf на bladeRF, где он будет
автоматически загружается при включении питания.

Используйте bladeRF-cli онлайн с помощью сервисов onworks.net