bladeRF-cli - Online na nuvem

PROGRAMA:

NOME

bladeRF-cli - interface de linha de comando e utilitário de teste

SINOPSE

lâminaRF-cli

DESCRIÇÃO

A lâminaRF-cli utilitário é usado para atualizar arquivos de firmware, carregar fluxos de bits FPGA e executar
outras tarefas no sistema de rádio definido por software nuand bladeRF.

Para obter mais informações sobre como obter ou construir arquivos de firmware e bitstreams FPGA, por favor
visita http://nuand.com/.

Interface de linha de comando bladeRF e utilitário de teste (1.3.1-0.2016.01 ~ rc1-3)

OPÇÕES

-d, --dispositivo
Use o dispositivo bladeRF especificado.

-f, --flash-firmware
Grave o arquivo de firmware FX3 fornecido no flash.

-l, --load-fpga
Carregue o fluxo de bits FPGA fornecido.

-L, --flash-fpga
Grave a imagem FPGA fornecida em flash para carregamento automático. Usar -L X ou --flash-fpga X
para desativar o carregamento automático do FPGA.

-p, --sonda
Procure dispositivos, imprima os resultados e saia. Um status de retorno diferente de zero será
retornado se nenhum dispositivo estiver disponível.

-e, --exec
Execute o comando do modo interativo especificado. Múltiplo -e bandeiras podem ser
Especificadas. Os comandos serão executados na ordem fornecida.

-s, --roteiro
Execute o script fornecido.

-i, --interativo
Entre no modo interativo.

--lib-versão
Imprime a versão da libbladeRF e sai.

-v, --verbosidade
Defina o nível de verbosidade libbladeRF. Os níveis, listados em verbosidade crescente, são:

crítico, erro, aviso,
informações, depuração, verbose

--versão
Imprima a versão CLI e saia.

-h, --Socorro
Mostre este texto de ajuda.

--help-interativo
Imprima informações de ajuda para todos os comandos interativos.

Observações:
A -d opção leva uma string de especificador de dispositivo. Veja a documentação bladerf_open ()
para obter mais informações sobre o formato desta string.

Se o -d parâmetro não for fornecido, o primeiro dispositivo disponível será usado para
o comando fornecido ou será aberto antes de entrar no modo interativo.

Os comandos são executados na seguinte ordem:

Opções de linha de comando, -e , comandos de script, comandos de modo interativo.

Ao executar 'rx / tx start' a partir de um script ou via -e, certifique-se de que esses comandos sejam posteriores
seguido por 'rx / tx wait [tempo limite]' para garantir que o programa não tentará sair
antes que a recepção / transmissão seja concluída.

INTERATIVO COMANDOS

bladeRF-cli suporta um modo interativo programável. Corre lâminaRF-cli --interativo para
entrar neste modo. Modelo "ajudar"para uma lista de todos os comandos, ou"ajudar " para mais
informação sobre .

calibrar
Uso: calibrar [opções]

Execute a operação de calibração do transceptor especificada.

Operações disponíveis:

· Calibrações automáticas de deslocamento DC interno do LMS

· Calibrar lms [mostrar]

· Calibrar ajuste de lms [valor]

· Calibrar lms txlpf [ ]

· Calibrar lms rxlpf [ ]

· Calibrar lms rxvga2 [ ]

Execute a calibração automática especificada ou todas elas, se nenhuma for fornecida. Quando
valores são fornecidos, eles são usados ​​em vez dos resultados da calibração automática
procedimento. Use lms show para ler e imprimir os valores de calibração LMS atuais.

Para rxvga2, I1 e Q1 são os componentes I e Q do Estágio 1, respectivamente, e I2 e Q2 são
os componentes I e Q do Estágio 2.

· Calibração do parâmetro de correção de deslocamento RX e TX I / Q DC

· Calibrar dc [ ]

· Calibrar dc

Calibre os parâmetros de correção de deslocamento DC para a frequência e ganho atuais
definições. Se forem fornecidos valores I / Q, eles serão aplicados diretamente. cal rxtx é
abreviação para cal rx seguida por cal tx.

· Calibração do parâmetro de correção de equilíbrio RX e TX I / Q

· Calibrar iq

Defina o ganho de IQ especificado ou os parâmetros de equilíbrio de fase.

· Gerar tabelas de parâmetros de correção RX ou TX I / Q DC

· Calibrar mesa dc [ [f_inc]]

Gerar e gravar uma tabela de parâmetros de correção I / Q no diretório de trabalho atual,
em um arquivo chamado _dc_ .tbl. f_min e f_max são frequências mínimas e máximas para
incluir na tabela. f_inc é o incremento de frequência.

Por padrão, as tabelas são geradas em toda a faixa de frequência, em etapas de 2 MHz.

remover filtragem
Uso: claro

Limpa a tela.

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

Faça eco de cada argumento em uma nova linha.

apagar
Uso: apagar

Apaga os blocos de apagamento especificados flash SPI.

· - Apagar deslocamento de bloco

· - Número de blocos de apagar para apagar

flash_backup
Uso: flash_backup ( | )

Faça backup dos dados flash para o arquivo especificado. Este comando leva dois ou quatro
argumentos. A chamada de dois argumentos é geralmente recomendada para uso sem desenvolvimento.

parâmetros:

· - Tipo de backup.

Isso seleciona o endereço apropriado e os valores de comprimento com base no tipo selecionado.

As opções válidas são:

Descrição da Opção
────────────────────────────────────────────────────────────────────────────────────────────────────────────── ─────────────────────
Cal Calibration data
FW Firmware
Metadados fpga40 e bitstream para FPGA de 40 kLE
Metadados fpga115 e bitstream para FPGA de 115 kLE

· - Endereço de dados para backup. Deve ser apagado alinhado ao bloco.

· - Comprimento da região para backup. Deve ser apagado alinhado ao bloco.

Nota: Quando um endereço e comprimento são fornecidos, o tipo de imagem será padronizado como bruto.

Exemplos:

· Flash_backup cal.bin cal

Faz backup da região de dados de calibração.

· Flash_backup cal_raw.bin 0x30000 0x10000

Faz backup da região de calibração como uma imagem de dados brutos.

imagem_flash
Uso: flash_image [opções de saída]

Imprima os metadados de uma imagem flash ou crie uma nova imagem flash. Quando fornecido com o nome
de um arquivo de imagem flash como o único argumento, este comando irá imprimir o conteúdo dos metadados
da imagem.

As seguintes opções podem ser usadas para criar uma nova imagem flash.

· Dados =

Arquivo para conter dados a serem armazenados na imagem.

· Endereço =

Endereço Flash. O padrão depende do parâmetro de tipo.

· Tipo =

Tipo de imagem flash. O padrão é bruto.

As opções válidas são:

Descrição da Opção
────────────────────────────────────────────────────────────────────────────────────────────────────────────── ─────────────────────
Cal Calibration data
FW Firmware
Metadados fpga40 e bitstream para FPGA de 40 kLE
Metadados fpga115 e bitstream para FPGA de 115 kLE
Dados brutos brutos. Os parâmetros de endereço e comprimento devem ser
fornecido se este tipo for selecionado.

· Serial =

Número de série para armazenar na imagem. O padrão é zeros.

flash_init_cal
Uso: flash_init_cal [ ]

Crie e escreva uma nova região de dados de calibração para o dispositivo atualmente aberto, ou para um
Arquivo. Certifique-se de fazer backup dos dados de calibração antes de executar este comando. (Veja o
comando flash_backup.)

·

40 ou 115, dependendo do modelo do dispositivo.

·

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

·

Arquivo para gravar os dados de calibração. Quando este argumento é fornecido, nenhum dado será
escrito no flash do dispositivo.

flash_restore
Uso: flash_restore [ ]

Restaura os dados flash de um arquivo, substituindo opcionalmente os valores nos metadados da imagem.

·

O padrão é o endereço especificado no arquivo de imagem flash fornecido.

·

O padrão é o comprimento dos dados no arquivo de imagem fornecido.

fw_log
Uso: fw_log [nome do arquivo]

Leia o conteúdo do log de firmware do dispositivo e grave-o no arquivo especificado. Se não
o nome do arquivo é especificado, o conteúdo do log é gravado em stdout.

ajudar
Uso: ajuda [ ]

Fornece ajuda estendida, como este, em qualquer comando.

info
Uso: informação

Imprime as seguintes informações sobre um dispositivo aberto:

· Número de série

· Valor de calibração VCTCXO DAC

· Tamanho FPGA

· Se o FPGA está ou não carregado

· Barramento USB, endereço e velocidade

· Back-end (indica qual código de interface do dispositivo está sendo usado.)

· Número da instância

pular_para_boot
Uso: jump_to_boot

Limpe uma palavra de assinatura FW no flash e vá para o bootloader FX3.

O dispositivo continuará a inicializar no carregador de inicialização FX3 em ciclos de energia até novo
o firmware é gravado no dispositivo.

carregar
Uso: carregar

Carregue um bitstream FPGA ou programe o flash SPI do FX3.

xb
Uso: xb [parâmetros]

Habilite ou configure uma placa de expansão.

Valores válidos para board_model:

· NUNCA

Placa de expansão XB-100 GPIO

· NUNCA

Placa de expansão do transverter XB-200 LF / MF / HF / VHF

Subcomandos comuns:

· permitir

Ative a placa de expansão XB-100 ou XB-200.

Subcomandos XB-200:

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

Seleciona o filtro RX ou TX especificado na placa XB-200. Abaixo estão as descrições de
cada uma das opções de filtro.

· NUNCA

Selecione o filtro de 50-54 MHz (banda de 6 metros).

· NUNCA

Selecione o filtro de 144-148 MHz (banda de 2 metros).

· NUNCA

Selecione o filtro 222-225 MHz (banda de 1.25 metros). Realisticamente,
esta opção de filtro é um pouco mais larga, cobrindo
206 MHz - 235 MHz.

· personalizadas

Seleciona o caminho do filtro personalizado. O usuário deve conectar um filtro
ao longo das conexões FILT e FILT-ANT correspondentes ao usar
esta opção. Alternativamente, pode-se ligar o FILT e o FILT-ANT
conexões para obter "nenhum filtro" para recepção. (No entanto, este é
_altamente_ desencorajado para transmissões.)

· Auto_1db

Seleciona automaticamente uma das opções acima com base na frequência
e os pontos de 1dB dos filtros. O caminho personalizado é usado para casos
que não estão associados aos filtros integrados.

· Auto_3db

Seleciona automaticamente uma das opções acima com base na frequência
e os pontos de 3dB dos filtros. O caminho personalizado é usado para casos
que não estão associados aos filtros integrados.

Exemplos:

· Habilitar xb 200

Habilita e configura a placa de expansão do transverter XB-200.

· Filtro xb 200 rx 144

Seleciona o filtro de recepção 144-148 MHz na placa de expansão do transverter XB-200.

mimo
Uso: mimo [master | escravo]

Modifique a operação MIMO do dispositivo.

aberto
Uso: aberto [identificadores de dispositivo]

Abra o dispositivo especificado para uso com comandos sucessivos. Qualquer dispositivo aberto anteriormente
Será fechado.

A forma geral da string do identificador do dispositivo é:

: [dispositivo = : ] [instância = ] [serial = ]

Veja a documentação bladerf_open () em libbladeRF para o especificador de dispositivo completo
formato.

espreitar
Uso: espreitar [num_addresses]

O comando peek pode ler qualquer um dos dispositivos pendurados no FPGA, que inclui o
Transceptor LMS6002D, DAC de ajuste VCTCXO ou chip gerador de clock Si5338.

Se num_addresses for fornecido, o endereço é incrementado em 1 e outra espiada é
executado para tantos endereços.

Intervalos de endereços válidos:

Faixa de endereço do dispositivo
─────────────────────────
dac 0 a 255

lms 0 a 127
si 0 a 255

Exemplo:

· Espiar ...

cotovelada
Uso: cutucar

O comando poke pode escrever qualquer um dos dispositivos pendurados no FPGA, que inclui o
Transceptor LMS6002D, DAC de ajuste VCTCXO ou chip gerador de clock Si5338.

Intervalos de endereços válidos:

Faixa de endereço do dispositivo
─────────────────────────
dac 0 a 255
lms 0 a 127
si 0 a 255

Exemplo:

· Cutucar filmes ...

impressão
Uso: imprimir [parâmetro]

O comando de impressão usa um parâmetro para imprimir. Os parâmetros disponíveis estão listados abaixo. Se
nenhum parâmetro é especificado, todos os parâmetros são impressos.

Parâmetro Descrição
────────────────────────────────────────────────────────────────────────────────────────────────────────────── ─────────────────────────
largura de banda Configurações de largura de banda
Frequência Configurações de frequência
gpio FX3 <-> estado FPGA GPIO
configurações de loopback de loopback
Mais uma vez, configuração de ganho do RX LNA, em dB
Configuração mux de entrada rx_mux FPGA RX FIFO
Configuração de ganho rxvga1 de RXVGA1, em dB
Configuração de ganho rxvga2 de RXVGA2, em dB
Configuração de ganho txvga1 de TXVGA1, em dB
Configuração de ganho txvga2 de TXVGA2, em dB
amostragem Modo de amostragem externo ou interno
Samplerate configurações Samplerate
Configurações trimdac VCTCXO Trim DAC
vctcxo_tamer Modo atual do domador VCTCXO.
Valores GPIO da placa de expansão xb_gpio
xb_gpio_dir Direção GPIO da placa de expansão (1 = saída, 0 = entrada)

sonda
Uso: probe [estrito]

Pesquise o dispositivo bladeRF conectado e imprima uma lista de resultados.

Sem especificar estrito, a falta de qualquer dispositivo disponível não é considerada um erro.

Quando fornecido o argumento estrito opcional, este comando tratará a situação em que nenhum
dispositivos são encontrados como um erro, causando scripts ou listas de comandos fornecidos por meio do -e
argumento da linha de comando para terminar imediatamente.

desistir
Uso: sair

Saia da CLI.

recuperar
Uso: recuperar [ ]

Carregue o firmware em um dispositivo em execução no modo bootloader ou liste todos os dispositivos atualmente em
modo bootloader.

Sem argumentos, este comando lista o barramento USB e o endereço para dispositivos baseados em FX3
rodando no modo bootloader.

Quando fornecido um barramento, endereço e caminho para um arquivo de firmware, o dispositivo especificado será
carregado com e começar a executar o firmware fornecido.

Na maioria dos casos, depois de carregar o firmware com sucesso na RAM do dispositivo, os usuários devem
abra o dispositivo com o comando "abrir" e escreva o firmware para o flash via
"carregar fx3 "

corrida
Uso: run

Execute o script fornecido.

rx
Uso: rx

Receba amostras de IQ e grave-as no arquivo especificado. A recepção é controlada e
configurado por um dos seguintes:

Descrição do Comando
────────────────────────────────────────────────────────────────────────────────────────────────────────────── ─────────────────────────
começar começar a receber amostras
parar de receber amostras
aguarde Aguarde a conclusão da transmissão da amostra ou até que um
quantidade especificada de tempo decorrido
config Configure a recepção de amostra. Se nenhum parâmetro for
fornecido, os parâmetros atuais são impressos.

A execução de rx sem nenhum comando adicional é uma abreviação válida para configuração de rx.

O comando wait tem um parâmetro opcional de tempo limite. Este parâmetro é padronizado para unidades de
milissegundos (ms). A unidade de tempo limite pode ser especificada usando os sufixos ms ou s. Se este
parâmetro não for fornecido, o comando irá esperar até que a recepção seja concluída ou Ctrl-C
é pressionado.

Os parâmetros de configuração assumem a forma param = value e podem ser especificados em um único ou
múltiplas invocações de configuração rx. Abaixo está uma lista de parâmetros disponíveis.

Parâmetro Descrição
────────────────────────────────────────────────────────────────────────────────────────────────────────────── ─────────────────────────
n Número de amostras a receber. 0 = inf.
arquivo Nome do arquivo para gravar amostras recebidas para
formato Formato do arquivo de saída. Um dos seguintes:
csv: CSV de amostras SC16 Q11
bin: Amostras SC16 Q11 DAC brutas
samples Número de amostras por buffer para usar no
fluxo assíncrono. Deve ser divisível por 1024 e
> = 1024.
buffers Número de buffers de amostra para usar no modo assíncrono
Stream. O valor mínimo é 4.
xfers Número de transferências simultâneas para permitir o
fluxo assíncrono para usar. Isso deve ser menos
do que o parâmetro buffers.
tempo limite Tempo limite do fluxo de dados. Sem sufixo, o padrão
unidade é ms. O valor padrão é 1000 ms (1 s).
Os sufixos válidos são ms e s.

Exemplo:

· Arquivo de configuração rx = / tmp / formato data.bin = bin n = 10K

Receber (10240 = 10 * 1024) amostras, gravando-as em /tmp/data.bin no DAC binário
formato.

Observações:

· Os parâmetros n, samples, buffers e xfers suportam os sufixos K, M e G, que
são múltiplos de 1024.

· Uma parada rx seguida por um início rx resultará no arquivo de amostras sendo truncado. Se
isso não é desejado, certifique-se de executar rx config para definir outro arquivo antes de reiniciar o
fluxo rx.

· Para taxas de amostragem mais altas, é aconselhável que o formato de saída binário seja usado, e o
arquivo de saída ser gravado na RAM (por exemplo / Tmp, / dev / shm), se o espaço permitir. Para maior
captura em taxas de amostragem mais altas, considere usar um SSD em vez de um HDD.

tx
Uso: tx

Leia amostras de IQ do arquivo especificado e transmita-as. A transmissão é controlada e
configurado por um dos seguintes:

Descrição do Comando
────────────────────────────────────────────────────────────────────────────────────────────────────────────── ─────────────────────────
começar Comece a transmitir amostras
parar de transmitir amostras
aguarde Aguarde a conclusão da transmissão da amostra ou até que um
quantidade especificada de tempo decorrido
config Configure a transmissão de amostra. Se nenhum parâmetro for
fornecido, os parâmetros atuais são impressos.

Executar tx sem nenhum comando adicional é uma abreviação válida para tx config.

O comando wait tem um parâmetro opcional de tempo limite. Este parâmetro é padronizado para unidades de
milissegundos (ms). A unidade de tempo limite pode ser especificada usando os sufixos ms ou s. Se este
parâmetro não for fornecido, o comando irá esperar até que a transmissão seja concluída ou
Ctrl-C é pressionado.

Os parâmetros de configuração assumem a forma param = value e podem ser especificados em um único ou
múltiplas invocações de configuração tx. Abaixo está uma lista de parâmetros disponíveis.

Parâmetro Descrição
────────────────────────────────────────────────────────────────────────────────────────────────────────────── ─────────────────────────
arquivo Nome do arquivo para ler amostras de
format Formato do arquivo de entrada. Um dos seguintes:
csv: CSV de amostras SC16 Q11 ([-2048, 2047])
bin: Amostras SC16 Q11 DAC brutas ([-2048, 2047])
repetir O número de vezes que o conteúdo do arquivo deve ser
transmitido. 0 implica repetir até ser interrompido.
atraso O número de microssegundos para atrasar entre
retransmitindo o conteúdo do arquivo. 0 significa nenhum atraso.
samples Número de amostras por buffer para usar no
fluxo assíncrono. Deve ser divisível por 1024 e
> = 1024.
buffers Número de buffers de amostra para usar no modo assíncrono
Stream. O valor mínimo é 4.
xfers Número de transferências simultâneas para permitir o
fluxo assíncrono para usar. Isso deve ser <o
parâmetro de buffers.
tempo limite Tempo limite do fluxo de dados. Sem sufixo, o padrão
unidade é ms. O valor padrão é 1000 ms (1 s).
Os sufixos válidos são 'ms' e 's'.

Exemplo:

· Arquivo de configuração tx = formato data.bin = repetição bin = 2 atraso = 250000

Transmitindo o conteúdo de data.bin duas vezes, com um atraso de ~ 250ms entre
transmissões.

Observações:

· Os parâmetros n, samples, buffers e xfers suportam os sufixos K, M e G, que
são múltiplos de 1024.

· Para taxas de amostragem mais altas, é aconselhável que o arquivo de entrada seja armazenado na RAM (por exemplo / Tmp,
/ dev / shm) ou em um SSD, em vez de um HDD.

· Ao fornecer dados CSV, este comando irá primeiro convertê-los em um formato binário, armazenado
em um arquivo no diretório de trabalho atual. Durante este processo, valores fora do intervalo
será preso.

· Ao usar um formato binário, o usuário é responsável por garantir que os dados fornecidos
os valores estão dentro do intervalo permitido. Este pré-requisito alivia a necessidade deste
programa para realizar verificações de intervalo em retornos de chamada sensíveis ao tempo.

conjunto
Uso: conjunto

O comando set leva um parâmetro e um número arbitrário de argumentos para aquele
parâmetro. O parâmetro é um dos seguintes:

Parâmetro Descrição
────────────────────────────────────────────────────────────────────────────────────────────────────────────── ─────────────────────────
largura de banda Configurações de largura de banda
Frequência Configurações de frequência
gpio FX3 <-> estado FPGA GPIO
loopback Configurações de loopback. Execute 'set loopback' para listar os modos.
Mais uma vez, configuração de Ganho do RX LNA, em dB. Valores: 0, 3, 6
rxvga1 Configuração de ganho de RXVGA1, em dB. Faixa: [5, 30]
rx_mux FPGA RX FIFO input mux mode. As opções são:
BASEBAND_LMS, 12BIT_COUNTER, 32BIT_COUNTER,
DIGITAL_LOOPBACK
rxvga1 Configuração de ganho de RXVGA1, em dB. Faixa: [5, 30]
rxvga2 Configuração de ganho de RXVGA2, em dB. Faixa: [0, 30]
txvga1 Configuração de ganho de TXVGA1, em dB. Intervalo: [-35, -4]
Configuração de ganho txvga2 de TXVGA2, em dB. Faixa: [0, 25]
amostragem Modo de amostragem externo ou interno
samplerate configurações de taxa de amostragem
Configurações trimdac VCTCXO trim DAC
vctcxo_tamer Modo domador VCTCXO. Opções: Desativado, 1PPS, 10MHz
Valores GPIO da placa de expansão xb_gpio
xb_gpio_dir Direção GPIO da placa de expansão (1 = saída, 0 = entrada)

versão
Uso: versão

Imprime informações sobre a versão do software host e do dispositivo atual.

EXEMPLOS

$ bladeRF-cli -l installedx40.rbf

Carrega uma imagem FPGA denominada hostingx40.rbf no FPGA do bladeRF.

Note: A imagem FPGA carregada com --load-fpga será perdida ao desligar.

$ bladeRF-cli -f firmware.img

Flashes firmware.img no firmware do bladeRF.

$ bladeRF-cli -L installedx40.rbf

Pisca a imagem FPGA chamada Hostx40.rbf no bladeRF, onde estará
carregado automaticamente na inicialização.

Use o bladeRF-cli online usando os serviços onworks.net