bladeRF-cli - интерфейс командной строки и тестовая утилита
bladeRF-cli <options>
Утилита bladeRF-cli используется для прошивки файлов прошивки, загрузки битовых потоков FPGA и выполнения других задач в программно-определяемой радиосистеме nuand bladeRF.
Для получения дополнительной информации о получении или сборке файлов прошивки и битовых потоков FPGA посетите веб-сайт http://nuand.com/.
Интерфейс командной строки bladeRF и тестовая утилита (1.8.0-git)
Используйте указанное устройство bladeRF.
Запишите предоставленный файл прошивки FX3 для прошивки.
Загрузите предоставленный битовый поток FPGA.
Запишите предоставленный образ FPGA во флэш-память для автозагрузки. Используйте -L X или --flash-fpga X, чтобы отключить автозагрузку FPGA.
Выполните поиск устройств, распечатайте результаты и выйдите. Ненулевой статус возврата будет возвращен, если нет доступных устройств.
Выполнить указанную команду интерактивного режима. Можно указать несколько флагов -e. Команды будут выполняться в указанном порядке.
Запустите предоставленный скрипт.
Войдите в интерактивный режим.
Распечатайте версию libbladeRF и выйдите.
Установите уровень детализации libbladeRF. Уровни, перечисленные в порядке возрастания детализации:
информация, отладка, подробный
Распечатайте версию CLI и выйдите.
Показать этот текст справки.
Печатать справочную информацию для всех интерактивных команд.
Опция -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 <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 <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 <fpga_size> <vctcxo_trim> [<output_file>]
Создайте и запишите новую область данных калибровки на открытое в данный момент устройство или в файл. Перед выполнением этой команды обязательно сделайте резервную копию данных калибровки. (См. команду flash_backup
.)
<fpga_size>
Либо 40, либо 115, в зависимости от модели устройства.
<vctcxo_trim>
Значение подстройки VCTCXO/DAC (0x0
-0xffff
)
<output_file>
Файл для записи данных калибровки. Если указан этот аргумент, никакие данные не будут записаны во флэш-память устройства.
Использование:
flash_restore <file> [<address> <length>]
Восстановите данные флэш-памяти из файла, при необходимости переопределив значения в метаданных изображения.
<address>
По умолчанию используется адрес, указанный в предоставленном файле флэш-образа.
<length>
По умолчанию длина данных в предоставленном файле изображения.
Использование:
fw_log
[filename]
Прочитайте содержимое журнала прошивки устройства и запишите его в указанный файл. Если имя файла не указано, содержимое журнала записывается в стандартный вывод.
Использование:
help [<command>]
Предоставляет расширенную справку, подобную этой, по любой команде.
Использование:
info
Выводит следующую информацию об открытом устройстве:
Серийный номер
Значение калибровки ЦАП VCTCXO
Размер ПЛИС
Загружена ли FPGA
Шина USB, адрес и скорость
Backend (Обозначает, какой код интерфейса устройства используется.)
Номер экземпляра
Использование:
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-54 МГц (диапазон 6 метров).
Выберите фильтр 144–148 МГц (2-метровый диапазон).
Выберите фильтр 222-225 МГц (диапазон 1,25 метра). Реально, этот параметр фильтра на самом деле немного шире, охватывая 206 МГц - 235 МГц.
Выбирает путь пользовательского фильтра. При использовании этой опции пользователь должен подключить фильтр к соответствующим соединениям FILT и FILT-ANT. В качестве альтернативы можно переключить соединения FILT и FILT-ANT, чтобы получить «отсутствие фильтра» для приема. (Однако это _крайне_ не рекомендуется для передач.)
Автоматически выбирает один из вышеперечисленных вариантов на основе частоты и точек фильтра 1 дБ. Пользовательский путь используется для случаев, не связанных со встроенными фильтрами.
Автоматически выбирает один из вышеперечисленных вариантов на основе частоты и точек фильтра 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.
Для более высоких частот дискретизации рекомендуется использовать выходной формат bin
ary, а выходной файл записывать в ОЗУ (например, /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, их необходимо подключить с помощью сигнала, указанного параметром, и общей земли.
Для обеспечения правильной синхронизации следует использовать следующую последовательность команд. Предполагается, что изначально все триггеры выключены.
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.
Настройте все остальные устройства как ведомые триггеры.
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.
Set fire-request on master trigger
All devices will synchronously start transmitting or receiving data.
Завершите передачу и получение задач, как обычно
Re-configure the master and slaves to clear fire requests and re-arm.
Steps 1 through 5 may be repeated as neccessary.
Отключить запуск на всех ведомых устройствах
Отключить запуск на мастере
Примечания:
Синхронизация передатчиков и приемников в одной цепочке приведет к смещению на 11 отсчетов между TX и RX; эти образцы следует выбросить. Это вызвано разной длиной конвейера обработки TX и RX. Это значение может измениться, если код FPGA будет обновлен в будущем.
Использование:
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.