bladeRF-cli - Online nel cloud

PROGRAMMA:

NOME

bladeRF-cli - interfaccia a riga di comando e utilità di test

SINOSSI

lamaRF-cli

DESCRIZIONE

I lamaRF-cli l'utility viene utilizzata per eseguire il flashing dei file del firmware, caricare flussi di bit FPGA ed eseguire
altre attività sul sistema radio definito dal software nuand bladeRF.

Per ulteriori informazioni su come ottenere o creare file del firmware e flussi di bit FPGA, per favore
visita http://nuand.com/.

Interfaccia a riga di comando bladeRF e utilità di test (1.3.1-0.2016.01~rc1-3)

VERSIONI

-d, --dispositivo
Utilizzare il dispositivo bladeRF specificato.

-f, --flash-firmware
Scrivi il file del firmware FX3 fornito su flash.

-l, --load-fpga
Carica il bitstream FPGA fornito.

-L, --flash-fpga
Scrivi l'immagine FPGA fornita su flash per il caricamento automatico. Utilizzo -L X o --flash-fpga X
per disabilitare il caricamento automatico dell'FPGA.

-p, --sonda
Cerca i dispositivi, stampa i risultati, quindi esci. Uno stato di ritorno diverso da zero sarà
restituito se non sono disponibili dispositivi.

-e, --esecuz
Eseguire il comando della modalità interattiva specificato. multiplo -e le bandiere potrebbero essere
specificato. I comandi verranno eseguiti nell'ordine fornito.

-s, - script
Esegui lo script fornito.

-i, --interattivo
Entra in modalità interattiva.

--versione-lib
Stampa la versione di libbladeRF ed esci.

-v, --verbosità
Imposta il livello di verbosità di libbladeRF. I livelli, elencati con verbosità crescente, sono:

critico, errore, avviso,
informazioni, debug, verbose

--versione
Stampa la versione CLI ed esci.

-h, --Aiuto
Mostra questo testo di aiuto.

--aiuto-interattivo
Stampa le informazioni della guida per tutti i comandi interattivi.

Note:
I -d l'opzione accetta una stringa di identificazione del dispositivo. Vedi la documentazione di bladerf_open()
per ulteriori informazioni sul formato di questa stringa.

Se l' -d parametro non è fornito, verrà utilizzato il primo dispositivo disponibile per
il comando fornito, o verrà aperto prima di entrare in modalità interattiva.

I comandi vengono eseguiti nel seguente ordine:

Opzioni della riga di comando, -e , comandi di script, comandi in modalità interattiva.

Quando si esegue 'rx/tx start' da uno script o tramite -e, assicurati che questi comandi siano successivi
seguito da "rx/tx wait [timeout]" per garantire che il programma non tenti di uscire
prima che la ricezione/trasmissione sia completata.

INTERACTIVE COMANDI

bladeRF-cli supporta una modalità interattiva con script. Correre lamaRF-cli --interattivo a
entrare in questa modalità. Tipo "Aiuto" per un elenco di tutti i comandi, o "Aiuto " per più
informazioni su .

calibrare
Utilizzo: calibrare [opzioni]

Eseguire l'operazione di calibrazione del ricetrasmettitore specificata.

Operazioni disponibili:

· Auto-calibrazioni dell'offset CC interno LMS

· calibrare lms [mostra]

· calibrazione lms tuning [valore]

· calibra lms txlpf [ ]

· calibra lms rxlpf [ ]

· calibra lms rxvga2 [ ]

Eseguire l'autocalibrazione specificata o tutte se non ne sono fornite. quando
vengono forniti i valori, questi vengono utilizzati al posto dei risultati dell'autocalibrazione
procedura. Utilizzare lms show per leggere e stampare i valori di calibrazione LMS correnti.

Per rxvga2, I1 e Q1 sono rispettivamente i componenti Stage 1 I e Q, e I2 e Q2 sono
i componenti della Fase 2 I e Q.

· Calibrazione dei parametri di correzione offset DC RX e TX I/Q

· calibrare dc [ ]

· calibrare dc

Calibrare i parametri di correzione dell'offset CC per la frequenza e il guadagno correnti
impostazioni. Se vengono forniti valori I/Q, vengono applicati direttamente. cal rxtx è
scorciatoia per cal rx seguito da cal tx.

· Calibrazione dei parametri di correzione del bilanciamento I/Q RX e TX

· calibrare iq

Impostare il guadagno IQ specificato o i parametri di bilanciamento di fase.

· Genera tabelle dei parametri di correzione DC RX o TX I/Q

· calibrare la tabella dc [ [f_inc]]

Generare e scrivere una tabella dei parametri di correzione I/Q nella directory di lavoro corrente,
in un file chiamato _dc_ .tbl. f_min e f_max sono le frequenze minima e massima a
includere nella tabella. f_inc è l'incremento di frequenza.

Per impostazione predefinita, le tabelle vengono generate sull'intera gamma di frequenze, a passi di 2 MHz.

pulire campo
Utilizzo: chiaro

Cancella lo schermo.

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

Echo ogni argomento su una nuova riga.

cancellare
Utilizzo: cancellare

Cancella i blocchi di cancellazione specificati SPI flash.

· - Cancella offset blocco

· - Numero di blocchi cancellabili da cancellare

flash_backup
Utilizzo: flash_backup ( | )

Eseguire il backup dei dati flash nel file specificato. Questo comando ne richiede due o quattro
argomenti. L'invocazione a due argomenti è generalmente consigliata per l'uso non di sviluppo.

parametri:

· - Tipo di backup.

Questo seleziona l'indirizzo appropriato e i valori di lunghezza in base al tipo selezionato.

Le opzioni valide sono:

Opzione Descrizione
? ?
cal Dati di calibrazione
Firmware fw
fpga40 Metadati e bitstream per 40 kLE FPGA
fpga115 Metadati e bitstream per 115 kLE FPGA

· - Indirizzo dei dati di cui eseguire il backup. Deve essere cancellato allineato al blocco.

· - Lunghezza della regione di cui eseguire il backup. Deve essere cancellato allineato al blocco.

Nota: quando vengono forniti un indirizzo e una lunghezza, il tipo di immagine verrà impostato automaticamente su raw.

Consigli d'uso:

· flash_backup cal.bin cal

Esegue il backup della regione dei dati di calibrazione.

· flash_backup cal_raw.bin 0x30000 0x10000

Esegue il backup della regione di calibrazione come immagine di dati grezzi.

immagine_flash
Utilizzo: flash_image [opzioni di uscita]

Stampa i metadati di un'immagine flash o crea una nuova immagine flash. Quando fornito con il nome
di un file immagine flash come unico argomento, questo comando stamperà il contenuto dei metadati
dell'immagine.

Le seguenti opzioni possono essere utilizzate per creare una nuova immagine flash.

· dati=

File contenente i dati da memorizzare nell'immagine.

· indirizzo=

Indirizzo flash. L'impostazione predefinita dipende dal parametro di tipo.

· tipo=

Tipo di immagine flash. Il valore predefinito è grezzo.

Le opzioni valide sono:

Opzione Descrizione
? ?
cal Dati di calibrazione
Firmware fw
fpga40 Metadati e bitstream per 40 kLE FPGA
fpga115 Metadati e bitstream per 115 kLE FPGA
Dati grezzi grezzi. I parametri di indirizzo e lunghezza devono essere
fornito se questo tipo è selezionato.

· seriale=

Seriale # da memorizzare nell'immagine. Il valore predefinito è zero.

flash_init_cal
Utilizzo: flash_init_cal [ ]

Crea e scrivi una nuova area dati di calibrazione sul dispositivo attualmente aperto o su a
file. Assicurarsi di eseguire il backup dei dati di calibrazione prima di eseguire questo comando. (Vedi il
comando flash_backup.)

·

40 o 115, a seconda del modello del dispositivo.

·

Valore di trim VCTCXO/DAC (0x0-0xffff)

·

File in cui scrivere i dati di calibrazione. Quando viene fornito questo argomento, nessun dato sarà
scritto nella flash del dispositivo.

flash_restore
Utilizzo: flash_restore [ ]

Ripristina i dati flash da un file, sovrascrivendo facoltativamente i valori nei metadati dell'immagine.

·

L'impostazione predefinita è l'indirizzo specificato nel file di immagine flash fornito.

·

Il valore predefinito è la lunghezza dei dati nel file di immagine fornito.

fw_log
Utilizzo: fw_log [nome file]

Leggere il contenuto del registro del firmware del dispositivo e scriverlo nel file specificato. se no
viene specificato il nome del file, il contenuto del registro viene scritto su stdout.

Aiuto
Uso: aiuto [ ]

Fornisce un aiuto esteso, come questo, su qualsiasi comando.

info
Utilizzo: informazioni

Stampa le seguenti informazioni su un dispositivo aperto:

· Numero di serie

· Valore di calibrazione DAC VCTCXO

· Dimensione FPGA

· Se l'FPGA è caricato o meno

· Bus USB, indirizzo e velocità

· Backend (indica quale codice di interfaccia del dispositivo viene utilizzato).

· Numero di istanza

salta_all'avvio
Utilizzo: jump_to_boot

Cancella una parola chiave FW in flash e passa al bootloader FX3.

Il dispositivo continuerà ad avviarsi nel bootloader FX3 attraverso i cicli di alimentazione fino a nuovo
il firmware viene scritto sul dispositivo.

caricare
Utilizzo: carico

Carica un bitstream FPGA o programma il flash SPI dell'FX3.

xb
Utilizzo: xb [parametri]

Abilitare o configurare una scheda di espansione.

Valori validi per board_model:

· MAI

Scheda di espansione GPIO XB-100

· MAI

Scheda di espansione transverter XB-200 LF/MF/HF/VHF

Sottocomandi comuni:

· abilitare

Abilitare la scheda di espansione XB-100 o XB-200.

Sottocomandi XB-200:

· filtro [rx|tx] [50|144|222|personalizzato|auto_1db|auto_3db]

Seleziona il filtro RX o TX specificato sulla scheda XB-200. Di seguito sono riportate le descrizioni di
ciascuna delle opzioni di filtro.

· MAI

Selezionare il filtro 50-54 MHz (banda 6 metri).

· MAI

Selezionare il filtro 144-148 MHz (banda 2 metri).

· MAI

Selezionare il filtro 222-225 MHz (banda 1.25 metri). realisticamente,
questa opzione di filtro è in realtà leggermente più ampia, coprente
206MHz - 235MHz.

· costume

Seleziona il percorso del filtro personalizzato. L'utente deve collegare un filtro
lungo le corrispondenti connessioni FILT e FILT-ANT quando si utilizza
questa opzione. In alternativa si possono ponticellare FILT e FILT-ANT
connessioni per ottenere "nessun filtro" per la ricezione. (Tuttavia, questo è
_altamente_ sconsigliato per le trasmissioni.)

· auto_1db

Seleziona automaticamente una delle scelte sopra in base alla frequenza
e i punti da 1dB dei filtri. Il percorso personalizzato viene utilizzato per i casi
che non sono associati ai filtri di bordo.

· auto_3db

Seleziona automaticamente una delle scelte sopra in base alla frequenza
e i punti da 3dB dei filtri. Il percorso personalizzato viene utilizzato per i casi
che non sono associati ai filtri di bordo.

Consigli d'uso:

· xb 200 abilita

Abilita e configura la scheda di espansione transverter XB-200.

· filtro xb 200 rx 144

Seleziona il filtro di ricezione 144-148 MHz sulla scheda di espansione transverter XB-200.

mimo
Uso: mimo [master | Schiavo]

Modificare l'operazione MIMO del dispositivo.

aprire
Utilizzo: aperto [identificatori del dispositivo]

Aprire il dispositivo specificato per utilizzarlo con i comandi successivi. Qualsiasi dispositivo precedentemente aperto
sarà chiusa.

La forma generale della stringa di identificazione del dispositivo è:

:[dispositivo= : ] [istanza= ] [seriale= ]

Vedere la documentazione bladerf_open() in libbladeRF per l'identificatore completo del dispositivo
formato.

sbirciare
Uso: sbirciare [num_indirizzi]

Il comando peek può leggere qualsiasi dispositivo appeso all'FPGA che include il
Ricetrasmettitore LMS6002D, DAC trim VCTCXO o chip generatore di clock Si5338.

Se viene fornito num_addresses, l'indirizzo viene incrementato di 1 e un'altra occhiata è
eseguita per così tanti indirizzi.

Intervalli di indirizzi validi:

Intervallo di indirizzi del dispositivo
?
dac 0 a 255

lms da 0 a 127
si da 0 a 255

Esempio:

· sbirciare si...

ficcare
Uso: poke

Il comando poke può scrivere qualsiasi dispositivo appeso all'FPGA che include il
Ricetrasmettitore LMS6002D, DAC trim VCTCXO o chip generatore di clock Si5338.

Intervalli di indirizzi validi:

Intervallo di indirizzi del dispositivo
?
dac 0 a 255
lms da 0 a 127
si da 0 a 255

Esempio:

· poke lm...

stampare
Uso: stampa [parametro]

Il comando print accetta un parametro per stampare. I parametri disponibili sono elencati di seguito. Se
nessun parametro è specificato, tutti i parametri vengono stampati.

Parametro Descrizione
? ?
larghezza di banda Impostazioni della larghezza di banda
frequenza Impostazioni di frequenza
gpio FX3 <-> stato GPIO FPGA
loopback Impostazioni loopback
lnagain Impostazione del guadagno dell'LNA RX, in dB
rx_mux FPGA RX impostazione mux ingresso FIFO
rxvga1 Impostazione del guadagno di RXVGA1, in dB
rxvga2 Impostazione del guadagno di RXVGA2, in dB
txvga1 Impostazione del guadagno di TXVGA1, in dB
txvga2 Impostazione del guadagno di TXVGA2, in dB
campionamento Modalità di campionamento esterno o interno
frequenza di campionamento Impostazioni della frequenza di campionamento
trimdac VCTCXO Regola le impostazioni DAC
vctcxo_tamer Modalità domatore VCTCXO corrente.
xb_gpio Valori GPIO della scheda di espansione
xb_gpio_dir Direzione GPIO della scheda di espansione (1=uscita, 0=ingresso)

sonda
Uso: sonda [rigoroso]

Cerca il dispositivo bladeRF collegato e stampa un elenco di risultati.

Senza specificare il rigore, la mancanza di dispositivi disponibili non è considerata un errore.

Quando viene fornito l'argomento strict opzionale, questo comando tratterà la situazione in cui no
i dispositivi vengono rilevati come un errore, causando script o elenchi di comandi forniti tramite -e
argomento della riga di comando per terminare immediatamente.

smettere
Utilizzo: esci

Uscire dalla CLI.

recuperare
Utilizzo: recuperare [ ]

Carica il firmware su un dispositivo in esecuzione in modalità bootloader o elenca tutti i dispositivi attualmente in
modalità bootloader.

Senza argomenti, questo comando elenca il bus USB e l'indirizzo per i dispositivi basati su FX3
in esecuzione in modalità bootloader.

Quando vengono forniti un bus, un indirizzo e un percorso a un file del firmware, il dispositivo specificato sarà
caricato e iniziare l'esecuzione del firmware fornito.

Nella maggior parte dei casi, dopo aver caricato con successo il firmware nella RAM del dispositivo, gli utenti dovrebbero
apri il dispositivo con il comando "apri" e scrivi il firmware su flash tramite
"carica fx3 "

eseguire il
Uso: correre

Esegui lo script fornito.

rx
Utilizzo: rx

Ricevi campioni IQ e scrivili nel file specificato. La ricezione è controllata e
configurato da uno dei seguenti:

Comando Descrizione
? ?
inizia Inizia a ricevere campioni
stop Interrompi ricezione campioni
wait Attendi il completamento della trasmissione del campione, o fino a quando a
la quantità di tempo specificata trascorre
config Configura la ricezione del campione. Se nessun parametro è
fornito, vengono stampati i parametri correnti.

L'esecuzione di rx senza comandi aggiuntivi è una scorciatoia valida per rx config.

Il comando wait richiede un parametro di timeout facoltativo. Il valore predefinito di questo parametro è unità di
millisecondi (ms). L'unità di timeout può essere specificata utilizzando i suffissi ms o s. Se questo
parametro non è fornito, il comando attenderà il completamento della ricezione o Ctrl-C
è premuto.

I parametri di configurazione assumono la forma param=value e possono essere specificati in un singolo or
più chiamate di configurazione rx. Di seguito è riportato un elenco dei parametri disponibili.

Parametro Descrizione
? ?
n Numero di campioni da ricevere. 0 = inf.
file Nome file in cui scrivere i campioni ricevuti
formato Formato del file di output. Uno dei seguenti:
csv: CSV di campioni SC16 Q11
bin: campioni DAC SC16 Q11 grezzi
campioni Numero di campioni per tampone da utilizzare nel
flusso asincrono. Deve essere divisibile per 1024 e
>= 1024.
tamponi Numero di tamponi campione da utilizzare nell'asincrono
flusso. Il valore minimo è 4.
xfers Numero di trasferimenti simultanei per consentire il
flusso asincrono da utilizzare. Questo dovrebbe essere meno
rispetto al parametro buffer.
timeout Timeout del flusso di dati. Senza suffisso, l'impostazione predefinita
l'unità è ms. Il valore predefinito è 1000 ms (1 s).
I suffissi validi sono ms e s.

Esempio:

· file di configurazione rx=/tmp/data.bin formato=bin n=10K

Ricevi (10240 = 10 * 1024) campioni, scrivendoli su /tmp/data.bin nel DAC binario
formato.

Note:

· I parametri n, campioni, buffer e xfers supportano i suffissi K, M e G, che
sono multipli di 1024.

· Un arresto rx seguito da un inizio rx provocherà il troncamento del file di esempio. Se
questo non è desiderato, assicurati di eseguire rx config per impostare un altro file prima di riavviare il
flusso rx.

· Per frequenze di campionamento più elevate, si consiglia di utilizzare il formato di output binario e il
file di output essere scritto nella RAM (es / Tmp, /dev/shm), se lo spazio lo consente. Per più grandi
acquisisce a frequenze di campionamento più elevate, considerare l'utilizzo di un SSD invece di un HDD.

tx
Utilizzo: tx

Leggere i campioni IQ dal file specificato e trasmetterli. La trasmissione è controllata e
configurato da uno dei seguenti:

Comando Descrizione
? ?
inizia Avvia la trasmissione dei campioni
stop Interrompe la trasmissione dei campioni
wait Attendi il completamento della trasmissione del campione, o fino a quando a
la quantità di tempo specificata trascorre
config Configura la trasmissione del campione. Se nessun parametro è
fornito, vengono stampati i parametri correnti.

L'esecuzione di tx senza comandi aggiuntivi è una scorciatoia valida per tx config.

Il comando wait richiede un parametro di timeout facoltativo. Il valore predefinito di questo parametro è unità di
millisecondi (ms). L'unità di timeout può essere specificata utilizzando i suffissi ms o s. Se questo
parametro non è fornito, il comando attenderà il completamento della trasmissione oppure
Ctrl-C è premuto.

I parametri di configurazione assumono la forma param=value e possono essere specificati in un singolo or
più chiamate di configurazione tx. Di seguito è riportato un elenco dei parametri disponibili.

Parametro Descrizione
? ?
file Nome file da cui leggere i campioni
formato Formato del file di input. Uno dei seguenti:
csv: CSV di campioni SC16 Q11 ([-2048, 2047])
bin: campioni DAC SC16 Q11 grezzi ([-2048, 2047])
ripeti Il numero di volte in cui il contenuto del file dovrebbe essere
trasmesso. 0 implica la ripetizione fino all'arresto.
ritardo Il numero di microsecondi tra cui ritardare
ritrasmettere il contenuto del file. 0 non implica alcun ritardo.
campioni Numero di campioni per tampone da utilizzare nel
flusso asincrono. Deve essere divisibile per 1024 e
>= 1024.
tamponi Numero di tamponi campione da utilizzare nell'asincrono
flusso. Il valore minimo è 4.
xfers Numero di trasferimenti simultanei per consentire il
flusso asincrono da utilizzare. Questo dovrebbe essere < the
parametro buffer.
timeout Timeout del flusso di dati. Senza suffisso, l'impostazione predefinita
l'unità è ms. Il valore predefinito è 1000 ms (1 s).
I suffissi validi sono "ms" e "s".

Esempio:

· file di configurazione tx=data.bin format=bin repeat=2 delay=250000

Trasmissione del contenuto di data.bin due volte, con un ritardo di ~250 ms tra
trasmissioni.

Note:

· I parametri n, campioni, buffer e xfers supportano i suffissi K, M e G, che
sono multipli di 1024.

· Per frequenze di campionamento più elevate, si consiglia di memorizzare il file di input nella RAM (ad es / Tmp,
/dev/shm) o su un SSD, anziché su un HDD.

· Quando si forniscono dati CSV, questo comando li converte prima in un formato binario, memorizzato
in un file nella directory di lavoro corrente. Durante questo processo, valori fuori range
sarà bloccato.

· Quando si utilizza un formato binario, l'utente è responsabile di garantire che i dati forniti
i valori rientrano nell'intervallo consentito. Questo prerequisito allevia la necessità di questo
programma per eseguire controlli di intervallo in callback sensibili al tempo.

set
Utilizzo: set

Il comando set accetta un parametro e un numero arbitrario di argomenti per quel particolare
parametro. Il parametro è uno tra:

Parametro Descrizione
? ?
larghezza di banda Impostazioni della larghezza di banda
frequenza Impostazioni di frequenza
gpio FX3 <-> stato GPIO FPGA
loopback Impostazioni di loopback. Esegui 'set loopback' per elencare le modalità.
lnagain Impostazione del guadagno dell'LNA RX, in dB. Valori: 0, 3, 6
rxvga1 Impostazione del guadagno di RXVGA1, in dB. Gamma: [5, 30]
rx_mux Modalità mux ingresso FIFO FPGA RX. Le opzioni sono:
BANDA BASE_LMS, 12BIT_COUNTER, 32BIT_COUNTER,
DIGITAL_LOOPBACK
rxvga1 Impostazione del guadagno di RXVGA1, in dB. Gamma: [5, 30]
rxvga2 Impostazione del guadagno di RXVGA2, in dB. Gamma: [0, 30]
txvga1 Impostazione del guadagno di TXVGA1, in dB. Intervallo: [-35, -4]
txvga2 Impostazione del guadagno di TXVGA2, in dB. Intervallo: [0, 25]
campionamento Modalità di campionamento esterno o interno
frequenza di campionamento Impostazioni della frequenza di campionamento
trimdac VCTCXO trim impostazioni DAC
vctcxo_tamer Modalità domatore VCTCXO. Opzioni: Disabilitato, 1PPS, 10MHz
xb_gpio Valori GPIO della scheda di espansione
xb_gpio_dir Direzione GPIO della scheda di espansione (1=uscita, 0=ingresso)

versione
Utilizzo: versione

Stampa le informazioni sulla versione per il software host e il dispositivo corrente.

ESEMPI

$ bladeRF-cli -l ospitatox40.rbf

Carica un'immagine FPGA denominata hostedx40.rbf sull'FPGA del bladeRF.

Note:: L'immagine FPGA caricata con --load-fpga andrà persa allo spegnimento.

$ bladeRF-cli -f firmware.img

Fa lampeggiare firmware.img sul firmware del bladeRF.

$ bladeRF-cli -L ospitatox40.rbf

Lampeggia l'immagine FPGA denominata hostedx40.rbf sul bladeRF, dove sarà
caricato automaticamente all'accensione.

Usa bladeRF-cli online utilizzando i servizi onworks.net