bladeRF-cli - справочное руководство, опции, примеры команд


ИМЯ

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

СИНТАКСИС

bladeRF-cli <options>

ОПИСАНИЕ

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

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

Интерфейс командной строки bladeRF и тестовая утилита (1.8.0-git)

ПАРАМЕТРЫ

-d, --device <device>

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

-f, --flash-firmware <file>

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

-l, --load-fpga <file>

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

-L, --flash-fpga <file>

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

-p, --probe

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

-e, --exec <command>

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

-s, --script <file>

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

-i, --interactive

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

--lib-version

Распечатайте версию libbladeRF и выйдите.

-v, --verbosity <level>

Установите уровень детализации libbladeRF. Уровни, перечисленные в порядке возрастания детализации:

critical, error, warning,

информация, отладка, подробный

--version

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

-h, --help

Показать этот текст справки.

--help-interactive

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

Примечания:

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

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

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

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

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

ИНТЕРАКТИВНЫЕ КОМАНДЫ

bladeRF-cli поддерживает интерактивный режим с поддержкой сценариев. Запустите bladeRF-cli --interactive, чтобы войти в этот режим. Введите "help", чтобы получить список всех команд, или "help ", чтобы получить дополнительную информацию о .

калибровать

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

calibrate <operation> [options]

Выполните указанную операцию калибровки приемопередатчика.

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

  • Автоматическая калибровка внутреннего смещения постоянного тока LMS

  • calibrate lms [show]
    calibrate lms tuning [value]
    calibrate lms txlpf [<I filter> <Q filter>]
    calibrate lms rxlpf [<I filter> <Q filter>]
    calibrate lms rxvga2 [<DC ref> <I1> <Q1> <I2> <Q2>]

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

    Для rxvga2 I1 и Q1 являются компонентами I и Q этапа 1 соответственно, а I2 и Q2 — это компоненты I и Q этапа 2.

  • RX and TX I/Q DC offset correction parameter calibration

    calibrate dc <rx|tx> [<I> <Q>]
    calibrate dc <rxtx>

    Calibrate the DC offset correction parameters for the current frequency and gain settings. If a I/Q values are provided, they are applied directly. cal rxtx is shorthand for cal rx followed by cal tx.

  • RX and TX I/Q balance correction parameter calibration

    calibrate iq <rx|tx> <gain|phase> <value>

    Set the specified IQ gain or phase balance parameters.

  • Generate RX or TX I/Q DC correction parameter tables

    calibrate table dc <rx|tx> [<f_min> <f_max> [f_inc]]

    Generate and write an I/Q correction parameter table to the current working directory, in a file named <serial>_dc_<rx|tx>.tbl. f_min and f_max are min and max frequencies to include in the table. f_inc is the frequency increment.

    By default, tables are generated over the entire frequency range, in 10 MHz steps.

  • Generate RX or TX I/Q DC correction parameter tables for AGC Look Up Table

    calibrate table agc <rx|tx> [<f_min> <f_max> [f_inc]]

    Similar usage as calibrate table dc except the call will set gains to the AGC's base gain value before running calibrate table dc.

прозрачный

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

clear

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

эхо

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

echo [arg 1] [arg 2] ... [arg n]

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

стереть

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

erase <offset> <count>

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

<offset>

Стереть смещение блока

<count>

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

flash_backup

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

flash_backup <file> (<type> | <address> <length>)

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

Параметры:

<type>

Тип резервной копии.

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

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

               Option   Description
         ────────────────────────────────────────────────────────────────────
                  cal   Calibration data
                   fw   Firmware
               fpga40   Metadata and bitstream for 40 kLE FPGA
              fpga115   Metadata and bitstream for 115 kLE FPGA
               fpgaA4   Metadata and bitstream for 49 kLE (A4) FPGA
               fpgaA5   Metadata and bitstream for 77 kLE (A5) FPGA
               fpgaA9   Metadata and bitstream for 301 kLE (A9) FPGA
<address>

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

<len>

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

Примечание. Когда указаны адрес и длина, тип изображения по умолчанию будет raw.

Примеры:

Резервирует область данных калибровки:

flash_backup cal.bin cal

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

flash_backup cal_raw.bin 0x30000 0x10000

flash_image

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

flash_image <image> [output options]

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

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

data=<file>

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

address=<addr>

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

type=<type>

Тип флэш-изображения. По умолчанию используется raw.

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

               Option   Description
         ────────────────────────────────────────────────────────────────────
                  cal   Calibration data
                   fw   Firmware
               fpga40   Metadata and bitstream for 40 kLE FPGA
              fpga115   Metadata and bitstream for 115 kLE FPGA
               fpgaA4   Metadata and bitstream for 49 kLE (A4) FPGA
               fpgaA5   Metadata and bitstream for 77 kLE (A5) FPGA
               fpgaA9   Metadata and bitstream for 301 kLE (A9) FPGA
                  raw   Raw data. The address and length parameters must be
                        provided if this type is selected.
serial=<serial>

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

flash_init_cal

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

flash_init_cal <fpga_size> <vctcxo_trim> [<output_file>]

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

<fpga_size>

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

<vctcxo_trim>

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

<output_file>

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

flash_restore

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

flash_restore <file> [<address> <length>]

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

<address>

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

<length>

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

fw_log

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

fw_log [filename]

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

помощь

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

help [<command>]

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

Информация

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

info

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

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

  • Значение калибровки ЦАП VCTCXO

  • Размер ПЛИС

  • Загружена ли FPGA

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

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

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

jump_to_boot

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

jump_to_boot

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

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

нагрузка

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

load <fpga|fx3> <filename>

Загрузите битовый поток FPGA или запрограммируйте флэш-память SPI FX3.

хб

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

xb <board_model> <subcommand> [parameters]

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

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

100

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

200

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

300

Плата усилителя XB-300

Общие подкоманды:

enable

Включите плату расширения XB-100, XB-200 или XB-300.

Подкоманды XB-200:

filter [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 МГц.

custom

Выбирает путь пользовательского фильтра. При использовании этой опции пользователь должен подключить фильтр к соответствующим соединениям FILT и FILT-ANT. В качестве альтернативы можно переключить соединения FILT и FILT-ANT, чтобы получить «отсутствие фильтра» для приема. (Однако это _крайне_ не рекомендуется для передач.)

auto_1db

Автоматически выбирает один из вышеперечисленных вариантов на основе частоты и точек фильтра 1 дБ. Пользовательский путь используется для случаев, не связанных со встроенными фильтрами.

auto_3db

Автоматически выбирает один из вышеперечисленных вариантов на основе частоты и точек фильтра 3 дБ. Пользовательский путь используется для случаев, не связанных со встроенными фильтрами.

Подкоманды XB-300:

<pa|lna|aux> [on|off]

Включить или отключить усилитель мощности (PA), малошумящий усилитель (lna) или вспомогательный LNA (aux). Текущее состояние, если указанное устройство печатается, если не указано [on|off].

Примечание. Дополнительный путь на XB-300 по умолчанию не заполнен компонентами; элемент управления aux не повлияет на сигнал RX. Эта опция доступна для пользователей, чтобы модифицировать свою плату с помощью специального оборудования.

<pwr>

Считайте текущее напряжение обнаружения мощности (PDET) и вычислите выходную мощность.

trx <rx|tx>

Аппаратная конфигурация XB-300 по умолчанию включает отдельные пути RX и TX. Тем не менее, пользователи, желающие использовать только одну антенну для TRX, могут сделать это, изменив параметры заполнения резисторов на XB-300, и использовать эту команду для переключения между операциями RX и TX. (См. R8, R10 и R23 на схеме.)

Примеры:

Включает и настраивает плату расширения трансвертера XB-200:

xb 200 enable

Выбирает приемный фильтр 144–148 МГц на плате расширения трансвертера XB-200:

xb 200 filter rx 144

Включает и настраивает использование GPIO для взаимодействия с XB-300. PA и LNA будут отключены по умолчанию:

xb 300 enable

Включает RX LNA на XB-300. Светодиод D1 (зеленый) горит, когда МШУ включен, и гаснет, когда он отключен:

xb 300 lna on

Отключает TX PA на XB-300. Светодиод D2 (синий) горит, когда УМ включен, и гаснет, когда он отключен:

xb 300 pa off

мимо

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

mimo [master | slave]

Изменить работу устройства MIMO.

ВАЖНО: эта команда устарела и заменена "print/set smb_mode". Чтобы получить текст использования, запустите: "set smb_mode"

открыть

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

open [device identifiers]

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

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

<backend>:[device=<bus>:<addr>] [instance=<n>] [serial=<serial>]

Полный формат спецификатора устройства см. в документации bladerf_open() в libbladeRF.

подглядывать

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

peek <rfic|pll|dac|lms|si> <address> [num_addresses]

Команда peek может прочитать любое из устройств, подвешенных к FPGA. Это включает в себя:

  • BladeRF 1: трансивер LMS6002D, ЦАП VCTCXO, тактовый генератор Si5338

  • bladeRF 2: приемопередатчик AD9361, ЦАП с подстроечным преобразователем VCTCXO, синтезатор частот ADF4002

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

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

       Device   Address Range
       ───────────────────────────
         rfic   0 to 0x3F7 (1015)
          pll   0 to 3
          dac   0 to 255
          lms   0 to 127
           si   0 to 255

Пример:

peek si ...

тыкать

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

poke <rfic|pll|dac|lms|si> <address> <data>

Команда poke может записать любое из устройств, висящих на ПЛИС. Это включает в себя:

  • BladeRF 1: трансивер LMS6002D, ЦАП VCTCXO, тактовый генератор Si5338

  • bladeRF 2: приемопередатчик AD9361, ЦАП с подстроечным преобразователем VCTCXO, синтезатор частот ADF4002

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

       Device   Address Range
       ───────────────────────────
         rfic   0 to 0x3F7 (1015)
          pll   0 to 3
          dac   0 to 255
          lms   0 to 127
           si   0 to 255

Пример:

poke lms ...

Распечатать

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

print [parameter]

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

Общие параметры:

            Parameter   Description
       ────────────────────────────────────────────────────────────────────────
            bandwidth   Bandwidth settings
            frequency   Frequency settings
                  agc   Automatic gain control
             loopback   Loopback settings
               rx_mux   FPGA RX FIFO input mux setting
                 gain   Gain settings
           samplerate   Samplerate settings
              trimdac   VCTCXO Trim DAC settings
          tuning_mode   Tuning mode settings
             hardware   Low-level hardware status

Параметры только для BladeRF1:

            Parameter   Description
       ────────────────────────────────────────────────────────────────────────
                 gpio   FX3 <-> FPGA GPIO state
              lnagain   RX LNA gain, in dB (deprecated)
               rxvga1   RXVGA1 gain, in dB (deprecated)
               rxvga2   RXVGA2 gain, in dB (deprecated)
               txvga1   TXVGA1 gain, in dB (deprecated)
               txvga2   TXVGA2 gain, in dB (deprecated)
             sampling   External or internal sampling mode
             smb_mode   SMB clock port mode of operation
         vctcxo_tamer   Current VCTCXO tamer mode
              xb_gpio   Expansion board GPIO values
          xb_gpio_dir   Expansion board GPIO direction (1=output, 0=input)

Параметры только для BladeRF2:

            Parameter   Description
       ────────────────────────────────────────────────────────────────────────
            clock_sel   System clock selection
            clock_out   Clock output selection
                 rssi   Received signal strength indication
            clock_ref   ADF4002 chip status
           refin_freq   ADF4002 reference clock frequency
              biastee   Current bias-tee status
               filter   RFIC FIR filter selection

зонд

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

probe [strict]

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

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

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

покидать

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

quit

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

восстанавливаться

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

recover [<bus> <address> <firmware file>]

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

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

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

В большинстве случаев, после успешной загрузки прошивки в оперативную память устройства, пользователям следует открыть устройство с помощью команды «open» и записать прошивку на flash через «load fx3 <файл прошивки>"

бегать

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

run <script>

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

прием

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

rx <start | stop | wait | config [param=val [param=val [...]]>

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

            Command   Description
       ────────────────────────────────────────────────────────────────────────
              start   Start receiving samples
               stop   Stop receiving samples
               wait   Wait for sample transmission to complete, or until a
                      specified amount of time elapses
             config   Configure sample reception. If no parameters are
                      provided, the current parameters are printed.

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

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

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

              Parameter   Description
       ────────────────────────────────────────────────────────────────────────
                      n   Number of samples to receive. 0 = inf.
                   file   Filename to write received samples to
                 format   Output file format. One of the following:
                          csv: CSV of SC16 Q11 samples
                          bin: Raw SC16 Q11 DAC samples
                samples   Number of samples per buffer to use in the
                          asynchronous stream. Must be divisible by 1024 and
                          >= 1024.
                buffers   Number of sample buffers to use in the asynchronous
                          stream. The min value is 4.
                  xfers   Number of simultaneous transfers to allow the
                          asynchronous stream to use. This should be less than
                          the buffers parameter.
                timeout   Data stream timeout. With no suffix, the default
                          unit is ms. The default value is 1000 ms (1 s).
                          Valid suffixes are ms and s.
                channel   Comma-delimited list of physical RF channels to use

Пример:

Получите (10240=10 * 1024) выборок, записав их в /tmp/data.bin в двоичном формате DAC.

rx config file=/tmp/data.bin format=bin n=10K

Получите 32768 образцов от RX1 и RX2, выведя их в файл с именем mimo.csv с четырьмя столбцами (RX1 I, RX1 Q, RX2 I, RX2 Q).

rx config file=mimo.csv format=csv n=32768 channel=1,2

Примечания:

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

  • rx stop, за которым следует rx start, приведет к усечению файла примеров. Если это нежелательно, обязательно запустите rx config, чтобы установить другой файл перед перезапуском потока rx.

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

  • Формат CSV создает два столбца на канал, причем первые два столбца соответствуют паре I, Q для первого канала, настроенного с помощью параметра channel; следующие два столбца соответствуют I,Q второго канала и так далее.

курок

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

trigger [<trigger> <tx | rx> [<off slave master fire>]]

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

Ниже приведены доступные варианты для:

             Trigger   Description
       ────────────────────────────────────────────────────────────────────────
               J71-4   Trigger signal is on mini_exp1 (bladeRF x40/x115, J71,
                       pin 4).
               J51-1   Trigger signal is on mini_exp1 (bladeRF xA4/xA5/xA9,
                       J51, pin 1).
           Miniexp-1   Trigger signal is on mini_exp1, hardware-independent

Обратите внимание, что все три вышеуказанных параметра сопоставляются с одним и тем же логическим портом на всех устройствах (mini_exp[1]). Для обратной совместимости и ясности предусмотрено несколько вариантов.

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

            Command   Description
       ────────────────────────────────────────────────────────────────────────
                off   Clears fire request and disables trigger functionality.
              slave   Configures trigger as slave, clears fire request, and
                      arms the device.
             master   Configures trigger as master, clears fire request, and
                      arms the device.
               fire   Sets fire request. Only applicable to the master.

Цепочка запуска состоит из одного или нескольких блоков bladeRF и может содержать модули TX и RX. Если используется несколько блоков bladeRF, их необходимо подключить с помощью сигнала, указанного параметром, и общей земли.

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

  1. Configure designated trigger master

    IMPORTANT: Never configure two devices as trigger masters on a single chain. Contention on the same signal could damage the devices.

  2. Настройте все остальные устройства как ведомые триггеры.

  3. Configure and start transmit or receive streams.

    The operation will stall until the triggers fire. As such, sufficiently large timeouts should be used to allow the trigger signal to be emitted by the master and received by the slaves prior to libbladeRF returning BLADERF_ERR_TIMEOUT.

  4. Set fire-request on master trigger

    All devices will synchronously start transmitting or receiving data.

  5. Завершите передачу и получение задач, как обычно

  6. Re-configure the master and slaves to clear fire requests and re-arm.

    Steps 1 through 5 may be repeated as neccessary.

  7. Отключить запуск на всех ведомых устройствах

  8. Отключить запуск на мастере

Примечания:

  • Синхронизация передатчиков и приемников в одной цепочке приведет к смещению на 11 отсчетов между TX и RX; эти образцы следует выбросить. Это вызвано разной длиной конвейера обработки TX и RX. Это значение может измениться, если код FPGA будет обновлен в будущем.

TX

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

tx <start | stop | wait | config [parameters]>

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

            Command   Description
       ────────────────────────────────────────────────────────────────────────
              start   Start transmitting samples
               stop   Stop transmitting samples
               wait   Wait for sample transmission to complete, or until a
                      specified amount of time elapses
             config   Configure sample transmission. If no parameters are
                      provided, the current parameters are printed.

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

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

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

              Parameter   Description
       ────────────────────────────────────────────────────────────────────────
                   file   Filename to read samples from
                 format   Input file format. One of the following:
                          csv: CSV of SC16 Q11 samples ([-2048, 2047])
                          bin: Raw SC16 Q11 DAC samples ([-2048, 2047])
                 repeat   The number of times the file contents should be
                          transmitted. 0 implies repeat until stopped.
                  delay   The number of microseconds to delay between
                          retransmitting file contents. 0 implies no delay.
                samples   Number of samples per buffer to use in the
                          asynchronous stream. Must be divisible by 1024 and
                          >= 1024.
                buffers   Number of sample buffers to use in the asynchronous
                          stream. The min value is 4.
                  xfers   Number of simultaneous transfers to allow the
                          asynchronous stream to use. This should be < the
                          buffers parameter.
                timeout   Data stream timeout. With no suffix, the default
                          unit is ms. The default value is 1000 ms (1 s).
                          Valid suffixes are 'ms' and 's'.
                channel   Comma-delimited list of physical RF channels to use

Пример:

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

tx config file=data.bin format=bin repeat=2 delay=250000

Многократная передача содержимого mimo.csv, при этом первый канал в файле сопоставляется с каналом TX1, а второй канал сопоставляется с TX2:

tx config file=mimo.csv format=csv repeat=0 channel=1,2

Примечания:

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

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

  • Формат CSV предполагает два столбца на канал, причем первые два столбца соответствуют паре I,Q для первого канала, настроенного с помощью параметра channel; следующие два столбца соответствуют I,Q второго канала и так далее. Например, в приведенном выше примере mimo.csv -128,128,-256,256 будет передавать (-128,128) по TX1 и (-256,256) по TX2.

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

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

набор

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

set <parameter> <arguments>

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

Общие параметры:

            Parameter   Description
       ────────────────────────────────────────────────────────────────────────
            bandwidth   Bandwidth settings
            frequency   Frequency settings
                  agc   Automatic gain control
             loopback   Loopback settings
               rx_mux   FPGA RX FIFO input mux mode
                 gain   Gain settings
           samplerate   Samplerate settings
              trimdac   VCTCXO Trim DAC settings
          tuning_mode   Tuning mode settings

Параметры только для BladeRF1:

            Parameter   Description
       ────────────────────────────────────────────────────────────────────────
                 gpio   FX3 <-> FPGA GPIO state
              lnagain   RX LNA gain, in dB. Values: 0, 3, 6 (deprecated)
               rxvga1   RXVGA1 gain, in dB. Range: [5, 30] (deprecated)
               rxvga2   RXVGA2 gain, in dB. Range: [0, 30] (deprecated)
               txvga1   TXVGA1 gain, in dB. Range: [-35, -4] (deprecated)
               txvga2   TXVGA2 gain, in dB. Range: [0, 25] (deprecated)
             sampling   External or internal sampling mode
             smb_mode   SMB clock port mode of operation
         vctcxo_tamer   VCTCXO tamer mode. Options: Disabled, 1PPS, 10MHz
              xb_gpio   Expansion board GPIO values
          xb_gpio_dir   Expansion board GPIO direction (1=output, 0=input)

Параметры только для BladeRF2:

            Parameter   Description
       ────────────────────────────────────────────────────────────────────────
            clock_sel   System clock selection
            clock_out   Clock output selection
                 rssi   Received signal strength indication
            clock_ref   Enables (1) or disables (0) the ADF4002 chip
           refin_freq   ADF4002 reference clock frequency
              biastee   Enables or disables the bias tee on a given channel
               filter   RFIC FIR filter selection

версия

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

version

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

ПРИМЕРЫ

Загружает образ FPGA с именем hostedx40.rbf в FPGA bladeRF:

bladeRF-cli -l hostedx40.rbf

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

Прошиваем файл firmware.img на прошивку bladeRF:

bladeRF-cli -f firmware.img

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

bladeRF-cli -L hostedx40.rbf

АВТОР

Эта утилита была написана участниками проекта bladeRF. Дополнительную информацию см. в файле CONTRIBUTORS.

СООБЩЕНИЕ ОБ ОШИБКАХ

Об ошибках можно сообщать через средство отслеживания проблем по адресу https://github.com/nuand/bladerf.

АВТОРСКИЕ ПРАВА

Copyright © 2013-2015 ООО «Нуанд».

Эта программа является бесплатным программным обеспечением; вы можете распространять его и/или изменять в соответствии с условиями Стандартной общественной лицензии GNU, опубликованной Free Software Foundation; либо версия 2 Лицензии, либо (по вашему выбору) любая более поздняя версия.

Эта программа распространяется в надежде, что она будет полезна, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ. Дополнительные сведения см. в Стандартной общественной лицензии GNU.

Вы должны были получить копию Стандартной общественной лицензии GNU вместе с этой программой; если нет, напишите в Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

СМОТРИТЕ ТАКЖЕ

More documentation is available at http://nuand.com/ and https://github.com/nuand/bladerf.