bladeRF-cli: en línea en la nube

PROGRAMA:

NOMBRE

bladeRF-cli: interfaz de línea de comandos y utilidad de prueba

SINOPSIS

hojaRF-cli

DESCRIPCIÓN

El hojaRF-cli La utilidad se utiliza para actualizar archivos de firmware, cargar flujos de bits FPGA y realizar
otras tareas en el sistema de radio definido por software nuand bladeRF.

Para obtener más información sobre cómo obtener o crear archivos de firmware y flujos de bits FPGA,
visite http://nuand.com/.

interfaz de línea de comando bladeRF y utilidad de prueba (1.3.1-0.2016.01 ~ rc1-3)

CAMPUS

-d, --dispositivo
Utilice el dispositivo bladeRF especificado.

-f, --firmware-flash
Escriba en flash el archivo de firmware FX3 proporcionado.

-l, --load-FPGA
Cargue el flujo de bits FPGA proporcionado.

-L, --flash-fpga
Escriba la imagen FPGA proporcionada en flash para carga automática. Usar -L X o --flash-fpga X
para deshabilitar la carga automática FPGA.

-p, --Investigacion
Explore los dispositivos, imprima los resultados y salga. Un estado de devolución distinto de cero será
devuelto si no hay dispositivos disponibles.

-e, --ejecutivo
Ejecute el comando de modo interactivo especificado. Múltiple -e banderas pueden ser
especificado. Los comandos se ejecutarán en el orden proporcionado.

-s, --guión
Ejecute el script proporcionado.

-i, --interactivo
Ingrese al modo interactivo.

--lib-versión
Imprime la versión de libbladeRF y sal.

-v, --verbosidad
Establece el nivel de verbosidad de libbladeRF. Los niveles, enumerados en mayor cantidad de verbosidad, son:

crítico, error, advertencia,
info, depuración, detallado

--versión
Imprima la versión CLI y salga.

-h, --ayuda
Muestre este texto de ayuda.

--help-interactivo
Imprime información de ayuda para todos los comandos interactivos.

Notas:
El -d La opción toma una cadena de especificación de dispositivo. Consulte la documentación de bladerf_open ()
para obtener más información sobre el formato de esta cadena.

Si -d no se proporciona el parámetro, el primer dispositivo disponible se utilizará para
el comando proporcionado, o se abrirá antes de ingresar al modo interactivo.

Los comandos se ejecutan en el siguiente orden:

Opciones de línea de comando, -e , comandos de secuencia de comandos, comandos de modo interactivo.

Al ejecutar 'rx / tx start' desde un script o mediante -e, asegúrese de que estos comandos sean posteriores
seguido de 'rx / tx wait [timeout]' para garantizar que el programa no intente salir
antes de que se complete la recepción / transmisión.

INTERACTIVO COMANDOS

bladeRF-cli admite un modo interactivo programable. Correr hojaRF-cli --interactivo a
entrar en este modo. Escribe "ayuda"para obtener una lista de todos los comandos, o"ayuda " para más
Información sobre .

calibrar
Uso: calibrar [opciones]

Realice la operación de calibración del transceptor especificada.

Operaciones disponibles:

· Calibraciones automáticas de compensación de CC internas del LMS

· Calibrar lms [mostrar]

· Calibrar la sintonización de lms [valor]

· Calibrar lms txlpf [ ]

· Calibrar lms rxlpf [ ]

· Calibrar lms rxvga2 [ ]

Realice la autocalibración especificada, o todas si no se proporciona ninguna. Cuando
Se proporcionan valores, estos se utilizan en lugar de los resultados de la autocalibración.
procedimiento. Utilice lms show para leer e imprimir los valores de calibración actuales del LMS.

Para rxvga2, I1 y Q1 son los componentes I y Q de la Etapa 1 respectivamente, e I2 y Q2 son
los componentes I y Q de la Etapa 2.

· Calibración del parámetro de corrección de compensación RX y TX I / Q DC

· Calibrar dc [ ]

· Calibrar dc

Calibre los parámetros de corrección de compensación de CC para la frecuencia y ganancia actuales
ajustes. Si se proporcionan valores de I / Q, se aplican directamente. cal rxtx es
abreviatura de cal rx seguido de cal tx.

· Calibración de parámetros de corrección de balance RX y TX I / Q

· Calibrar el coeficiente intelectual

Establezca la ganancia de IQ o los parámetros de equilibrio de fase especificados.

· Generar tablas de parámetros de corrección RX o TX I / Q DC

· Calibrar la mesa dc [ [f_inc]]

Genere y escriba una tabla de parámetros de corrección de I / Q en el directorio de trabajo actual,
en un archivo llamado _corriente continua_ .tbl. f_min y f_max son frecuencias mínimas y máximas para
incluir en la tabla. f_inc es el incremento de frecuencia.

De forma predeterminada, las tablas se generan en todo el rango de frecuencias, en pasos de 2 MHz.

limpiar
Uso: claro

Limpia la pantalla.

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

Repite cada argumento en una nueva línea.

Borrar
Uso: borrar

Borrar bloques de borrado especificados SPI flash.

· - Borrar desplazamiento de bloque

· - Número de bloques de borrado para borrar

copia de seguridad_flash
Uso: flash_backup ( | )

Realice una copia de seguridad de los datos flash en el archivo especificado. Este comando toma dos o cuatro
argumentos. La invocación de dos argumentos generalmente se recomienda para uso que no sea de desarrollo.

parámetros:

· - Tipo de respaldo.

Esto selecciona la dirección apropiada y los valores de longitud según el tipo seleccionado.

Las opciones válidas son:

Opción Descripción
────────────────────────────────────────────────── ──────────────────
cal Datos de calibración
firmware del fw
fpga40 Metadatos y flujo de bits para FPGA de 40 kLE
fpga115 Metadatos y flujo de bits para FPGA de 115 kLE

· - Dirección de datos a respaldar. Debe estar alineado en bloque de borrado.

· - Longitud de la región para respaldar. Debe estar alineado en bloque de borrado.

Nota: Cuando se proporcionan una dirección y una longitud, el tipo de imagen se establecerá por defecto en raw.

Ejemplos:

· Flash_backup cal.bin cal

Realiza una copia de seguridad de la región de datos de calibración.

· Flash_backup cal_raw.bin 0x30000 0x10000

Realiza una copia de seguridad de la región de calibración como una imagen de datos sin procesar.

imagen_flash
Uso: flash_image [opciones de salida]

Imprima los metadatos de una imagen flash o cree una nueva imagen flash. Cuando se le proporciona el nombre
de un archivo de imagen flash como único argumento, este comando imprimirá el contenido de los metadatos
de la imagen.

Las siguientes opciones se pueden utilizar para crear una nueva imagen flash.

· Datos =

Archivo que contiene datos para almacenar en la imagen.

· Dirección =

Dirección flash. El valor predeterminado depende del parámetro de tipo.

· Tipo =

Tipo de imagen flash. El valor predeterminado es crudo.

Las opciones válidas son:

Opción Descripción
────────────────────────────────────────────────── ──────────────────
cal Datos de calibración
firmware del fw
fpga40 Metadatos y flujo de bits para FPGA de 40 kLE
fpga115 Metadatos y flujo de bits para FPGA de 115 kLE
datos brutos sin procesar. Los parámetros de dirección y longitud deben ser
siempre que se seleccione este tipo.

· Serial =

Número de serie para almacenar en imagen. Los valores predeterminados son ceros.

flash_init_cal
Uso: flash_init_cal [ ]

Cree y escriba una nueva región de datos de calibración en el dispositivo abierto actualmente o en un
expediente. Asegúrese de hacer una copia de seguridad de los datos de calibración antes de ejecutar este comando. (Ver el
comando flash_backup.)

·

40 o 115, según el modelo del dispositivo.

·

Valor de ajuste de VCTCXO / DAC (0x0-0xffff)

·

Archivo para escribir datos de calibración. Cuando se proporciona este argumento, no se
escrito en el flash del dispositivo.

restaurar_flash
Uso: flash_restore [ ]

Restaure los datos flash de un archivo, anulando opcionalmente los valores en los metadatos de la imagen.

·

Por defecto, la dirección especificada en el archivo de imagen flash proporcionado.

·

El valor predeterminado es la longitud de los datos en el archivo de imagen proporcionado.

fw_log
Uso: fw_log [nombre de archivo]

Lea el contenido del registro de firmware del dispositivo y escríbalo en el archivo especificado. Si no
se especifica el nombre de archivo, el contenido del registro se escribe en stdout.

ayuda
Uso: ayuda [ ]

Proporciona ayuda extendida, como esta, en cualquier comando.

info
Uso: información

Imprime la siguiente información sobre un dispositivo abierto:

· Número de serie

· Valor de calibración VCTCXO DAC

· Tamaño FPGA

· Si la FPGA está cargada o no

· Bus USB, dirección y velocidad

· Backend (indica qué código de interfaz de dispositivo se está utilizando).

· Número de instancia

saltar_al_arranque
Uso: jump_to_boot

Borre una palabra de firma de FW en flash y salte al gestor de arranque FX3.

El dispositivo continuará arrancando en el cargador de arranque FX3 a través de los ciclos de energía hasta que se
el firmware se escribe en el dispositivo.

carga
Uso: carga

Cargue un flujo de bits FPGA o programe el flash SPI del FX3.

xb
Uso: xb [parámetros]

Habilite o configure una placa de expansión.

Valores válidos para board_model:

· 100

Tarjeta de expansión GPIO XB-100

· 200

Tarjeta de expansión de transversor XB-200 LF / MF / HF / VHF

Subcomandos comunes:

· habilitar

Habilite la placa de expansión XB-100 o XB-200.

Subcomandos XB-200:

· Filtro [rx | tx] [50 | 144 | 222 | personalizado | auto_1db | auto_3db]

Selecciona el filtro RX o TX especificado en la placa XB-200. A continuación se muestran descripciones de
cada una de las opciones de filtro.

· 50

Seleccione el filtro de 50-54 MHz (banda de 6 metros).

· 144

Seleccione el filtro de 144-148 MHz (banda de 2 metros).

· 222

Seleccione el filtro 222-225 MHz (banda de 1.25 metros). De modo realista,
esta opción de filtro es en realidad un poco más ancha, cubriendo
206 MHz - 235 MHz.

· personalizado

Selecciona la ruta del filtro personalizado. El usuario debe conectar un filtro
a lo largo de las conexiones FILT y FILT-ANT correspondientes cuando se utiliza
esta opción. Alternativamente, uno puede saltar el FILT y el FILT-ANT
conexiones para lograr "sin filtro" para la recepción. (Sin embargo, esto es
_muy_ desaconsejado para las transmisiones).

· Auto_1db

Selecciona automáticamente una de las opciones anteriores según la frecuencia
y los puntos de 1dB de los filtros. La ruta personalizada se usa para casos
que no están asociados con los filtros integrados.

· Auto_3db

Selecciona automáticamente una de las opciones anteriores según la frecuencia
y los puntos de 3dB de los filtros. La ruta personalizada se usa para casos
que no están asociados con los filtros integrados.

Ejemplos:

· Xb 200 habilitar

Habilita y configura la placa de expansión del transvertidor XB-200.

· Filtro xb 200 rx 144

Selecciona el filtro de recepción de 144-148 MHz en la placa de expansión del transvertidor XB-200.

mimo
Uso: mimo [maestro | esclavo]

Modificar el funcionamiento del dispositivo MIMO.

habiertos
Uso: abrir [identificadores de dispositivo]

Abra el dispositivo especificado para usarlo con comandos sucesivos. Cualquier dispositivo abierto previamente
estara cerrado.

La forma general de la cadena de identificación del dispositivo es:

: [dispositivo = : ] [instancia = ] [serial = ]

Consulte la documentación de bladerf_open () en libbladeRF para obtener el especificador de dispositivo completo
formato.

ojeada
Uso: mirada [num_addresses]

El comando peek puede leer cualquiera de los dispositivos que cuelgan del FPGA que incluye el
Transceptor LMS6002D, VCTCXO trim DAC o chip generador de reloj Si5338.

Si se proporciona num_addresses, la dirección se incrementa en 1 y otro vistazo es
realizado para tantas direcciones.

Rangos de direcciones válidos:

Rango de direcciones del dispositivo
───────────────────────
dac 0 a 255

lms 0 a 127
si 0 a 255

Ejemplo:

· Peek si ...

meter
Uso: empujar

El comando poke puede escribir cualquiera de los dispositivos que cuelgan del FPGA que incluye el
Transceptor LMS6002D, VCTCXO trim DAC o chip generador de reloj Si5338.

Rangos de direcciones válidos:

Rango de direcciones del dispositivo
───────────────────────
dac 0 a 255
lms 0 a 127
si 0 a 255

Ejemplo:

· Empujar lms ...

Imprimir
Uso: imprimir [parámetro]

El comando de impresión toma un parámetro para imprimir. Los parámetros disponibles se enumeran a continuación. Si
no se especifica ningún parámetro, se imprimen todos los parámetros.

Descripción de parámetros
────────────────────────────────────────────────── ──────────────────────
ancho de banda Configuración de ancho de banda
frecuencia Ajustes de frecuencia
gpio FX3 <-> estado FPGA GPIO
loopback Configuración de loopback
De nuevo Ajuste de ganancia del RX LNA, en dB
rx_mux Configuración de mux de entrada FPGA RX FIFO
rxvga1 Ajuste de ganancia de RXVGA1, en dB
rxvga2 Ajuste de ganancia de RXVGA2, en dB
txvga1 Ajuste de ganancia de TXVGA1, en dB
txvga2 Ajuste de ganancia de TXVGA2, en dB
muestreo Modo de muestreo externo o interno
Samplerate Ajustes de Samplerate
trimdac VCTCXO Trim DAC ajustes
vctcxo_tamer Modo domador VCTCXO actual.
Valores GPIO de la placa de expansión xb_gpio
xb_gpio_dir Placa de expansión Dirección GPIO (1 = salida, 0 = entrada)

sonda
Uso: sonda [estricta]

Busque el dispositivo bladeRF adjunto e imprima una lista de resultados.

Sin especificar estrictamente, la falta de dispositivos disponibles no se considera un error.

Cuando se proporciona el argumento estricto opcional, este comando tratará la situación en la que no
los dispositivos se encuentran como un error, lo que provoca scripts o listas de comandos proporcionados a través de -e
argumento de línea de comando para terminar inmediatamente.

renuncia
Uso: salir

Salga de la CLI.

recuperar
Uso: recuperar [ ]

Cargue firmware en un dispositivo que se ejecute en modo de cargador de arranque o enumere todos los dispositivos actualmente en
modo de cargador de arranque.

Sin argumentos, este comando enumera el bus USB y la dirección para dispositivos basados ​​en FX3
ejecutándose en modo de cargador de arranque.

Cuando se proporciona un bus, una dirección y una ruta a un archivo de firmware, el dispositivo especificado se
cargado y comience a ejecutar el firmware proporcionado.

En la mayoría de los casos, después de cargar con éxito el firmware en la RAM del dispositivo, los usuarios deben
abra el dispositivo con el comando "abrir" y escriba el firmware para flashear a través de
"cargar fx3 "

corrida
Uso: ejecutar

Ejecute la secuencia de comandos proporcionada.

rx
Uso: rx

Reciba muestras de IQ y escríbalas en el archivo especificado. La recepción está controlada y
configurado por uno de los siguientes:

Descripción del comando
────────────────────────────────────────────────── ──────────────────────
empezar Empiece a recibir muestras
detener Dejar de recibir muestras
Espere Espere a que se complete la transmisión de la muestra, o hasta que
transcurre la cantidad de tiempo especificada
config Configure la recepción de la muestra. Si no hay parámetros
siempre que se impriman los parámetros actuales.

Ejecutar rx sin ningún comando adicional es una abreviatura válida para rx config.

El comando de espera toma un parámetro de tiempo de espera opcional. Este parámetro tiene por defecto unidades de
milisegundos (ms). La unidad de tiempo de espera se puede especificar utilizando los sufijos ms o s. Si esto
no se proporciona el parámetro, el comando esperará hasta que se complete la recepción o Ctrl-C
se presiona.

Los parámetros de configuración toman la forma param = valor, y pueden especificarse en una
múltiples invocaciones de configuración rx. A continuación se muestra una lista de parámetros disponibles.

Descripción de parámetros
────────────────────────────────────────────────── ──────────────────────
n Número de muestras a recibir. 0 = inf.
archivo Nombre de archivo para escribir las muestras recibidas
formato Formato de archivo de salida. Uno de los siguientes:
csv: CSV de muestras de SC16 Q11
bin: Muestras de DAC SC16 Q11 sin procesar
samples Número de muestras por tampón a utilizar en el
flujo asincrónico. Debe ser divisible por 1024 y
> = 1024.
búferes Número de búferes de muestra que se utilizarán en el proceso asíncrono.
Arroyo. El valor mínimo es 4.
xfers Número de transferencias simultáneas para permitir
flujo asincrónico para usar. Esto debería ser menos
que el parámetro búferes.
timeout Tiempo de espera del flujo de datos. Sin sufijo, el predeterminado
la unidad es ms. El valor predeterminado es 1000 ms (1 s).
Los sufijos válidos son ms y s.

Ejemplo:

· Archivo de configuración rx = / tmp / data.bin formato = bin n = 10K

Reciba (10240 = 10 * 1024) muestras y escríbalas en /tmp/data.bin en el DAC binario
formato.

Notas:

· Los parámetros n, samples, buffers y xfers admiten los sufijos K, M y G, que
son múltiplos de 1024.

· Una parada de rx seguida de un inicio de rx dará como resultado que el archivo de muestras se trunque. Si
esto no es lo deseado, asegúrese de ejecutar rx config para configurar otro archivo antes de reiniciar el
corriente rx.

· Para frecuencias de muestreo más altas, se recomienda utilizar el formato de salida binaria y
El archivo de salida se escribe en la RAM (p. ej. / Tmp, / dev / shm), si el espacio lo permite. Para mayor
capturas a frecuencias de muestreo más altas, considere usar un SSD en lugar de un HDD.

tx
Uso: tx

Leer muestras de IQ del archivo especificado y transmitirlas. La transmisión está controlada y
configurado por uno de los siguientes:

Descripción del comando
────────────────────────────────────────────────── ──────────────────────
empezar Empieza a transmitir muestras
detener Dejar de transmitir muestras
Espere Espere a que se complete la transmisión de la muestra, o hasta que
transcurre la cantidad de tiempo especificada
config Configure la transmisión de la muestra. Si no hay parámetros
siempre que se impriman los parámetros actuales.

Ejecutar tx sin ningún comando adicional es una abreviatura válida para tx config.

El comando de espera toma un parámetro de tiempo de espera opcional. Este parámetro tiene por defecto unidades de
milisegundos (ms). La unidad de tiempo de espera se puede especificar utilizando los sufijos ms o s. Si esto
no se proporciona el parámetro, el comando esperará hasta que la transmisión se complete o
Se presiona Ctrl-C.

Los parámetros de configuración toman la forma param = valor, y pueden especificarse en una
múltiples invocaciones de configuración tx. A continuación se muestra una lista de parámetros disponibles.

Descripción de parámetros
────────────────────────────────────────────────── ──────────────────────
archivo Nombre de archivo para leer las muestras
formato Formato de archivo de entrada. Uno de los siguientes:
csv: CSV de muestras de SC16 Q11 ([-2048, 2047])
bin: Muestras de DAC SC16 Q11 sin procesar ([-2048, 2047])
repetir El número de veces que el contenido del archivo debe ser
transmitido. 0 implica repetir hasta que se detenga.
delay El número de microsegundos para retrasar entre
retransmitir el contenido del archivo. 0 implica que no hay demora.
samples Número de muestras por tampón a utilizar en el
flujo asincrónico. Debe ser divisible por 1024 y
> = 1024.
búferes Número de búferes de muestra que se utilizarán en el proceso asíncrono.
Arroyo. El valor mínimo es 4.
xfers Número de transferencias simultáneas para permitir
flujo asincrónico para usar. Este debe ser <el
parámetro de búfer.
timeout Tiempo de espera del flujo de datos. Sin sufijo, el predeterminado
la unidad es ms. El valor predeterminado es 1000 ms (1 s).
Los sufijos válidos son 'ms' y 's'.

Ejemplo:

· Archivo de configuración tx = formato data.bin = repetición bin = 2 retraso = 250000

Transmitiendo el contenido de data.bin dos veces, con un retraso de ~ 250ms entre
transmisiones.

Notas:

· Los parámetros n, samples, buffers y xfers admiten los sufijos K, M y G, que
son múltiplos de 1024.

· Para frecuencias de muestreo más altas, se recomienda que el archivo de entrada se almacene en la RAM (p. Ej. / Tmp,
/ dev / shm) o en un SSD, en lugar de un HDD.

· Al proporcionar datos CSV, este comando primero los convertirá a un formato binario, almacenado
en un archivo en el directorio de trabajo actual. Durante este proceso, los valores fuera de rango
será sujetado.

· Cuando se utiliza un formato binario, el usuario es responsable de asegurarse de que los datos proporcionados
los valores están dentro del rango permitido. Este prerrequisito alivia la necesidad de este
programa para realizar comprobaciones de rango en devoluciones de llamada urgentes.

set
Uso: conjunto

El comando set toma un parámetro y un número arbitrario de argumentos para ese
parámetro. El parámetro es uno de:

Descripción de parámetros
────────────────────────────────────────────────── ──────────────────────
ancho de banda Configuración de ancho de banda
frecuencia Ajustes de frecuencia
gpio FX3 <-> estado FPGA GPIO
loopback Configuración de loopback. Ejecute 'set loopback' para listar modos.
De nuevo Ajuste de ganancia del RX LNA, en dB. Valores: 0, 3, 6
rxvga1 Ajuste de ganancia de RXVGA1, en dB. Rango: [5, 30]
rx_mux Modo mux de entrada FPGA RX FIFO. Las opciones son:
BASEBAND_LMS, 12BIT_COUNTER, 32BIT_COUNTER,
LOOPBACK DIGITAL
rxvga1 Ajuste de ganancia de RXVGA1, en dB. Rango: [5, 30]
rxvga2 Ajuste de ganancia de RXVGA2, en dB. Rango: [0, 30]
txvga1 Ajuste de ganancia de TXVGA1, en dB. Rango: [-35, -4]
txvga2 Ajuste de ganancia de TXVGA2, en dB. Rango: [0, 25]
muestreo Modo de muestreo externo o interno
samplerate Ajustes de frecuencia de muestreo
Trimdac VCTCXO Trim DAC ajustes
vctcxo_tamer Modo domador VCTCXO. Opciones: Desactivado, 1PPS, 10MHz
Valores GPIO de la placa de expansión xb_gpio
xb_gpio_dir Placa de expansión Dirección GPIO (1 = salida, 0 = entrada)

versión
Uso: versión

Imprime información sobre la versión del software del host y del dispositivo actual.

EJEMPLOS

$ bladeRF-cli -l alojadox40.rbf

Carga una imagen FPGA denominada hostsx40.rbf en la FPGA del bladeRF.

Note: La imagen FPGA cargada con --load-fpga se perderá al apagar.

$ bladeRF-cli -f firmware.img

Actualiza firmware.img en el firmware del bladeRF.

$ bladeRF-cli -L alojado x40.rbf

Destella la imagen FPGA denominada hostsx40.rbf en el bladeRF, donde estará
se carga automáticamente en el encendido.

Utilice bladeRF-cli en línea utilizando los servicios de onworks.net