bladeRF-cli - Online în cloud

PROGRAM:

NUME

bladeRF-cli - interfață de linie de comandă și utilitar de testare

REZUMAT

bladeRF-cli

DESCRIERE

bladeRF-cli utilitarul este folosit pentru a flash fișiere firmware, a încărca fluxuri de biți FPGA și a performa
alte sarcini pe sistemul radio definit de software nuand bladeRF.

Pentru mai multe informații despre obținerea sau construirea fișierelor firmware și a fluxurilor de biți FPGA, vă rugăm
vizita http://nuand.com/.

interfață de linie de comandă bladeRF și utilitar de testare (1.3.1-0.2016.01~rc1-3)

OPŢIUNI

-d, --dispozitiv
Utilizați dispozitivul bladeRF specificat.

-f, --flash-firmware
Scrieți fișierul firmware FX3 furnizat pe flash.

-l, --load-fpga
Încărcați fluxul de biți FPGA furnizat.

-L, --flash-fpga
Scrieți imaginea FPGA furnizată pe flash pentru încărcare automată. Utilizare -L X sau --flash-fpga X
pentru a dezactiva încărcarea automată FPGA.

-p, --sondă
Sondați dispozitivele, imprimați rezultatele, apoi ieșiți. O stare de returnare diferită de zero va fi
returnat dacă nu există dispozitive disponibile.

-e, --executiv
Executați comanda pentru modul interactiv specificat. Multiplu -e steaguri pot fi
specificat. Comenzile vor fi executate în ordinea furnizată.

-s, --script
Rulați scriptul furnizat.

-i, --interactiv
Intrați în modul interactiv.

--lib-version
Imprimați versiunea libbladeRF și ieșiți.

-v, --verbositate
Setați nivelul de verbozitate libbladeRF. Nivelurile, enumerate în grad de verbozitate crescândă, sunt:

critic, eroare, avertizare,
info, depanare, verbose

--versiune
Imprimați versiunea CLI și ieșiți.

-h, --Ajutor
Afișați acest text de ajutor.

--ajutor-interactiv
Tipăriți informații de ajutor pentru toate comenzile interactive.

note:
-d opțiunea ia un șir de specificator de dispozitiv. Consultați documentația bladerf_open().
pentru mai multe informații despre formatul acestui șir.

În cazul în care -d parametrul nu este furnizat, primul dispozitiv disponibil va fi folosit pentru
comanda furnizată sau va fi deschis înainte de a intra în modul interactiv.

Comenzile sunt executate în următoarea ordine:

Opțiuni de linie de comandă, -e , comenzi script, comenzi în mod interactiv.

Când rulați „rx/tx start” dintr-un script sau prin -e, asigurați-vă că aceste comenzi sunt ulterioare
urmat de „rx/tx wait [timeout]” pentru a se asigura că programul nu va încerca să iasă
înainte ca recepția/transmisia să fie finalizată.

INTERACTIVE COMANDE

bladeRF-cli acceptă un mod interactiv scriptabil. Alerga bladeRF-cli --interactiv la
intra in acest mod. Tip "ajutor" pentru o listă a tuturor comenzilor sau "ajutor " pentru mai mult
informatii despre .

calibra
Utilizare: calibrare [Opțiuni]

Efectuați operația de calibrare a transceiver-ului specificată.

Operațiuni disponibile:

· Autocalibrări interne LMS DC offset

· calibrare lms [arată]

· calibrați reglajul lms [valoare]

· calibrați lms txlpf [ ]

· calibrați lms rxlpf [ ]

· calibrați lms rxvga2 [ ]

Efectuați autocalibrarea specificată sau pe toate dacă nu sunt furnizate. Cand
sunt furnizate valori, acestea sunt folosite în locul rezultatelor autocalibrării
procedură. Utilizați lms show pentru a citi și imprima valorile actuale de calibrare LMS.

Pentru rxvga2, I1 și Q1 sunt componentele I și, respectiv, Q, iar I1 și Q2 sunt
componentele Etapei 2 I și Q.

· Calibrarea parametrilor de corecție a offsetului RX și TX I/Q DC

· calibrare dc [ ]

· calibrare dc

Calibrați parametrii de corecție a offset-ului DC pentru frecvența curentă și câștig
setări. Dacă sunt furnizate valori I/Q, acestea sunt aplicate direct. cal rxtx este
prescurtare pentru cal rx urmată de cal tx.

· Calibrarea parametrilor de corecție a echilibrului RX și TX I/Q

· calibra iq

Setați amplificarea IQ sau parametrii de echilibrare de fază specificați.

· Generați tabele cu parametrii de corecție RX sau TX I/Q DC

· tabel de calibrare dc [ [f_inc]]

Generați și scrieți un tabel cu parametrii de corecție I/Q în directorul de lucru curent,
într-un fișier numit _DC_ .tbl. f_min și f_max sunt frecvențele min și max
includeți în tabel. f_inc este incrementul de frecvență.

În mod implicit, tabelele sunt generate pe întreaga gamă de frecvență, în pași de 2 MHz.

clar
Utilizare: clar

Șterge ecranul.

ecou
Utilizare: ecou [arg 1] [arg 2] ... [arg n]

Ecou fiecare argument pe o nouă linie.

şterge
Utilizare: șterge

Ștergeți blocurile de ștergere specificate SPI flash.

· - Ștergeți decalajul blocului

· - Numărul de blocuri de ștergere de șters

flash_backup
Utilizare: flash_backup ( | )

Faceți o copie de rezervă a datelor flash în fișierul specificat. Această comandă necesită fie două, fie patru
argumente. Invocarea cu două argumente este, în general, recomandată pentru utilizarea non-dezvoltare.

parametri:

· - Tipul de backup.

Aceasta selectează adresa adecvată și valorile de lungime în funcție de tipul selectat.

Opțiunile valide sunt:

Descrierea opțiunii
────────────────────────────────────────────────── ──────────────────
cal Date de calibrare
fw Firmware
fpga40 Metadate și flux de biți pentru FPGA de 40 kLE
fpga115 Metadate și flux de biți pentru FPGA de 115 kLE

· - Adresa datelor de care să faceți backup. Trebuie să fie șters bloc-aliniat.

· - Lungimea regiunii de care trebuie să faceți backup. Trebuie să fie șters bloc-aliniat.

Notă: Când sunt furnizate o adresă și o lungime, tipul de imagine va fi implicit brut.

Exemple:

· flash_backup cal.bin cal

Face backup pentru regiunea datelor de calibrare.

· flash_backup cal_raw.bin 0x30000 0x10000

Face backup pentru regiunea de calibrare ca imagine cu date brute.

flash_image
Utilizare: flash_image [opțiuni de ieșire]

Imprimați metadatele unei imagini flash sau creați o nouă imagine flash. Când este furnizat cu numele
a unui fișier imagine flash ca singur argument, această comandă va imprima conținutul metadatelor
a imaginii.

Următoarele opțiuni pot fi utilizate pentru a crea o nouă imagine flash.

· date=

Fișier în datele care conțin pentru a stoca în imagine.

· adresa=

Adresă flash. Valoarea implicită depinde de parametrul tip.

· tip=

Tip de imagine flash. Implicit la brut.

Opțiunile valide sunt:

Descrierea opțiunii
────────────────────────────────────────────────── ──────────────────
cal Date de calibrare
fw Firmware
fpga40 Metadate și flux de biți pentru FPGA de 40 kLE
fpga115 Metadate și flux de biți pentru FPGA de 115 kLE
Date brute. Parametrii adresa și lungimea trebuie să fie
furnizat dacă este selectat acest tip.

· serial=

Numărul de serie de stocat în imagine. Implicit la zerouri.

flash_init_cal
Utilizare: flash_init_cal [ ]

Creați și scrieți o nouă regiune de date de calibrare pe dispozitivul deschis curent sau pe a
fişier. Asigurați-vă că ați făcut o copie de rezervă a datelor de calibrare înainte de a rula această comandă. (Vezi
comanda flash_backup.)

·

Fie 40, fie 115, în funcție de modelul dispozitivului.

·

Valoarea de ajustare VCTCXO/DAC (0x0-0xffff)

·

Fișier în care să scrieți datele de calibrare. Când acest argument este furnizat, nu vor fi date
scris pe blițul dispozitivului.

flash_restore
Utilizare: flash_restore [ ]

Restaurați datele flash dintr-un fișier, opțional suprascriind valorile din metadatele imaginii.

·

Setarea implicită la adresa specificată în fișierul imagine flash furnizat.

·

Implicit, lungimea datelor din fișierul imagine furnizat.

fw_log
Utilizare: fw_log [nume fișier]

Citiți conținutul jurnalului de firmware al dispozitivului și scrieți-l în fișierul specificat. Daca nu
numele fișierului este specificat, conținutul jurnalului este scris în stdout.

ajutor
Utilizare: ajutor [ ]

Oferă ajutor extins, ca acesta, pentru orice comandă.

info
Utilizare: info

Tipărește următoarele informații despre un dispozitiv deschis:

· Număr de serie

· Valoarea de calibrare VCTCXO DAC

· Dimensiunea FPGA

· Dacă FPGA este încărcat sau nu

· Bus USB, adresa și viteza

· Backend (indică ce cod de interfață a dispozitivului este utilizat.)

· Numărul de instanță

sari_la_pornire
Utilizare: jump_to_boot

Ștergeți un cuvânt de semnătură FW în flash și treceți la bootloader-ul FX3.

Dispozitivul va continua să pornească în bootloader-ul FX3 de-a lungul ciclurilor de pornire până la nou
firmware-ul este scris pe dispozitiv.

încărca
Utilizare: încărcare

Încărcați un flux de biți FPGA sau programați blițul SPI al FX3.

xb
Utilizare: xb [parametri]

Activați sau configurați o placă de expansiune.

Valori valide pentru board_model:

· 100

Placă de extensie XB-100 GPIO

· 200

Placă de expansiune transvertor XB-200 LF/MF/HF/VHF

Subcomenzi comune:

· permite

Activați placa de extensie XB-100 sau XB-200.

Subcomenzi XB-200:

· filtru [rx|tx] [50|144|222|personalizat|auto_1db|auto_3db]

Selectează filtrul RX sau TX specificat pe placa XB-200. Mai jos sunt descrieri ale
fiecare dintre opțiunile de filtrare.

· 50

Selectați filtrul 50-54 MHz (bandă de 6 metri).

· 144

Selectați filtrul 144-148 MHz (bandă de 2 metri).

· 222

Selectați filtrul 222-225 MHz (bandă de 1.25 metri). Realist,
această opțiune de filtru este de fapt puțin mai largă, acoperind
206 MHz - 235 MHz.

· personalizat

Selectează calea filtrului personalizat. Utilizatorul trebuie să conecteze un filtru
de-a lungul conexiunilor FILT și FILT-ANT corespunzătoare atunci când utilizați
această opțiune. Alternativ, se poate sări FILT și FILT-ANT
conexiuni pentru a obține „fără filtru” pentru recepție. (Totuși, acesta este
_foarte_ descurajat pentru transmisii.)

· auto_1db

Selectează automat una dintre opțiunile de mai sus în funcție de frecvență
și punctele de 1dB ale filtrelor. Calea personalizată este utilizată pentru cazuri
care nu sunt asociate cu filtrele de la bord.

· auto_3db

Selectează automat una dintre opțiunile de mai sus în funcție de frecvență
și punctele de 3dB ale filtrelor. Calea personalizată este utilizată pentru cazuri
care nu sunt asociate cu filtrele de la bord.

Exemple:

· activare xb 200

Activează și configurează placa de extensie a transvertorului XB-200.

· xb 200 filtru rx 144

Selectează filtrul de recepție 144-148 MHz pe placa de extensie a transvertorului XB-200.

mimo
Utilizare: mimo [master | sclav]

Modificați funcționarea MIMO a dispozitivului.

deschide
Utilizare: deschideți [identificatori de dispozitiv]

Deschideți dispozitivul specificat pentru utilizare cu comenzi succesive. Orice dispozitiv deschis anterior
va fi închis.

Forma generală a șirului de identificare a dispozitivului este:

:[dispozitiv= : ] [instanță= ] [serial= ]

Consultați documentația bladerf_open() din libbladeRF pentru specificatorul complet al dispozitivului
format.

arunca o privire
Utilizare: peek [num_addresses]

Comanda peek poate citi oricare dintre dispozitivele suspendate de FPGA, care include
Transceiver LMS6002D, DAC trim VCTCXO sau cipul generator de ceas Si5338.

Dacă este furnizat num_addresses, adresa este incrementată cu 1 și o altă privire
efectuate pentru atâtea adrese.

Domenii de adrese valide:

Interval de adrese dispozitiv
───────────────────────
dac de la 0 la 255

lms de la 0 la 127
de la 0 la 255

Exemplu:

· peek si...

împungere
Utilizare: poke

Comanda poke poate scrie oricare dintre dispozitivele agățate de FPGA, care include
Transceiver LMS6002D, DAC trim VCTCXO sau cipul generator de ceas Si5338.

Domenii de adrese valide:

Interval de adrese dispozitiv
───────────────────────
dac de la 0 la 255
lms de la 0 la 127
de la 0 la 255

Exemplu:

· poke lms...

imprima
Utilizare: imprimare [parametru]

Comanda print ia un parametru pentru a imprima. Parametrii disponibili sunt enumerați mai jos. Dacă
nu este specificat nici un parametru, toți parametrii sunt imprimați.

Descrierea parametrilor
────────────────────────────────────────────────── ──────────────────────
lățimea de bandă setările lățimii de bandă
frecvență Setări de frecvență
gpio FX3 <-> FPGA Stare GPIO
loopback Setări de loopback
Din nou setarea câștigului RX LNA, în dB
rx_mux Setarea mux de intrare FPGA RX FIFO
rxvga1 Setarea câștigului RXVGA1, în dB
rxvga2 Setarea câștigului RXVGA2, în dB
txvga1 Setarea câștigului TXVGA1, în dB
txvga2 Setarea câștigului TXVGA2, în dB
eșantionare Mod de eșantionare extern sau intern
samplerate Setări Samplerate
trimdac VCTCXO Trim setările DAC
vctcxo_tamer Mod curent de îmblânzire VCTCXO.
xb_gpio Valorile GPIO ale plăcii de expansiune
xb_gpio_dir Placă de expansiune Direcția GPIO (1=ieșire, 0=intrare)

sondă
Utilizare: sondă [strict]

Căutați dispozitivul bladeRF atașat și imprimați o listă de rezultate.

Fără a specifica strict, lipsa oricăror dispozitive disponibile nu este considerată o eroare.

Când este furnizat argumentul strict opțional, această comandă va trata situația în care nu
dispozitivele sunt găsite ca o eroare, provocând scripturi sau liste de comenzi furnizate prin intermediul -e
argument din linia de comandă pentru a se termina imediat.

părăsi
Utilizare: renunță

Ieșiți din CLI.

recupera
Utilizare: recuperare [ ]

Încărcați firmware-ul pe un dispozitiv care rulează în modul bootloader sau enumerați toate dispozitivele aflate în prezent
modul bootloader.

Fără argumente, această comandă listează magistrala USB și adresa pentru dispozitivele bazate pe FX3
rulează în modul bootloader.

Când sunt furnizate o magistrală, o adresă și o cale către un fișier firmware, dispozitivul specificat va fi
încărcat cu și începeți să executați firmware-ul furnizat.

În cele mai multe cazuri, după încărcarea cu succes a firmware-ului în memoria RAM a dispozitivului, utilizatorii ar trebui
deschideți dispozitivul cu comanda „deschidere” și scrieți firmware-ul pentru a flash prin
"încărcați fx3 "

alerga
Utilizare: alerga

Rulați scriptul furnizat.

rx
Utilizare: rx

Primiți mostre IQ și scrieți-le în fișierul specificat. Recepția este controlată și
configurat de unul dintre următoarele:

Descrierea comenzii
────────────────────────────────────────────────── ──────────────────────
începe Începeți să primiți mostre
opriți Nu mai primiți mostre
așteptați Așteptați finalizarea transmiterii probei sau până când a
se scurge o anumită perioadă de timp
config Configurați recepția probei. Dacă nu există parametri
cu condiția, parametrii actuali sunt imprimați.

Rularea rx fără comenzi suplimentare este prescurtare validă pentru rx config.

Comanda wait acceptă un parametru opțional de expirare. Acest parametru este implicit la unități de
milisecunde (ms). Unitatea de timeout poate fi specificată folosind sufixele ms sau s. Dacă aceasta
parametrul nu este furnizat, comanda va aștepta până la finalizarea recepției sau Ctrl-C
este apăsat.

Parametrii de configurare iau forma param=valoare și pot fi specificați într-un singur sau
invocari multiple de configurare rx. Mai jos este o listă de parametri disponibili.

Descrierea parametrilor
────────────────────────────────────────────────── ──────────────────────
n Numărul de mostre de primit. 0 = inf.
fișier Nume fișier în care să scrieți mostrele primite
format Format de fișier de ieșire. Una dintre următoarele:
csv: CSV a mostrelor SC16 Q11
bin: mostre brute SC16 Q11 DAC
eșantioane Numărul de probe per tampon de utilizat în
flux asincron. Trebuie să fie divizibil cu 1024 și
>= 1024.
tampoane Numărul de tampon-eșantion de utilizat în asincron
curent. Valoarea minimă este 4.
xfers Numărul de transferuri simultane pentru a permite
flux asincron de utilizat. Acest lucru ar trebui să fie mai puțin
decât parametrul tampon.
timeout Timeout pentru fluxul de date. Fără sufix, implicit
unitatea este ms. Valoarea implicită este 1000 ms (1 s).
Sufixele valide sunt ms și s.

Exemplu:

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

Primiți (10240 = 10 * 1024) mostre, scriindu-le în /tmp/data.bin în DAC-ul binar
format.

note:

· Parametrii n, samples, buffers și xfers acceptă sufixele K, M și G, care
sunt multipli ai lui 1024.

· O oprire rx urmată de o pornire rx va duce la trunchierea fișierului de mostre. Dacă
acest lucru nu este de dorit, asigurați-vă că rulați rx config pentru a seta un alt fișier înainte de a reporni
flux rx.

· Pentru rate de eșantionare mai mari, se recomandă utilizarea formatului de ieșire binar și
fișierul de ieșire să fie scris pe RAM (de ex / tmp, /dev/shm), dacă spațiul permite. Pentru mai mare
captează la rate de eșantionare mai mari, luați în considerare utilizarea unui SSD în loc de un HDD.

tx
Utilizare: tx

Citiți mostre IQ din fișierul specificat și transmiteți-le. Transmisia este controlată și
configurat de unul dintre următoarele:

Descrierea comenzii
────────────────────────────────────────────────── ──────────────────────
start Începeți să transmiteți mostre
opriți Opriți transmiterea probelor
așteptați Așteptați finalizarea transmiterii probei sau până când a
se scurge o anumită perioadă de timp
config Configurați transmisia eșantionului. Dacă nu există parametri
cu condiția, parametrii actuali sunt imprimați.

Rularea tx fără comenzi suplimentare este prescurtarea validă pentru tx config.

Comanda wait acceptă un parametru opțional de expirare. Acest parametru este implicit la unități de
milisecunde (ms). Unitatea de timeout poate fi specificată folosind sufixele ms sau s. Dacă aceasta
parametrul nu este furnizat, comanda va aștepta până la finalizarea transmisiei sau
Este apăsat Ctrl-C.

Parametrii de configurare iau forma param=valoare și pot fi specificați într-un singur sau
invocari multiple de configurare tx. Mai jos este o listă de parametri disponibili.

Descrierea parametrilor
────────────────────────────────────────────────── ──────────────────────
fișier Nume fișier din care să citiți mostre
format Formatul fișierului de intrare. Una dintre următoarele:
csv: CSV de mostre SC16 Q11 ([-2048, 2047])
bin: mostre brute SC16 Q11 DAC ([-2048, 2047])
repetare De câte ori ar trebui să fie conținutul fișierului
transmis. 0 implică repetarea până la oprire.
întârziere Numărul de microsecunde de întârziere între
retransmiterea conținutului fișierului. 0 implică nicio întârziere.
eșantioane Numărul de probe per tampon de utilizat în
flux asincron. Trebuie să fie divizibil cu 1024 și
>= 1024.
tampoane Numărul de tampon-eșantion de utilizat în asincron
curent. Valoarea minimă este 4.
xfers Numărul de transferuri simultane pentru a permite
flux asincron de utilizat. Acesta ar trebui să fie < the
parametrul tampon.
timeout Timeout pentru fluxul de date. Fără sufix, implicit
unitatea este ms. Valoarea implicită este 1000 ms (1 s).
Sufixele valide sunt „ms” și „s”.

Exemplu:

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

Transmiterea conținutului data.bin de două ori, cu o întârziere de ~250 ms între ele
transmisii.

note:

· Parametrii n, samples, buffers și xfers acceptă sufixele K, M și G, care
sunt multipli ai lui 1024.

· Pentru rate de eșantionare mai mari, se recomandă ca fișierul de intrare să fie stocat în RAM (de ex / tmp,
/dev/shm) sau pe un SSD, mai degrabă decât pe un HDD.

· Când furnizați date CSV, această comandă le va converti mai întâi într-un format binar, stocat
într-un fișier din directorul de lucru curent. În timpul acestui proces, valorile în afara intervalului
va fi prinsă.

· Când se utilizează un format binar, utilizatorul este responsabil pentru asigurarea faptului că datele furnizate
valorile sunt în intervalul permis. Această condiție prealabilă ușurează necesitatea acestui lucru
program pentru a efectua verificări ale intervalului în apeluri sensibile la timp.

set
Utilizare: set

Comanda set ia un parametru și un număr arbitrar de argumente pentru acel anume
parametru. Parametrul este unul dintre:

Descrierea parametrilor
────────────────────────────────────────────────── ──────────────────────
lățimea de bandă setările lățimii de bandă
frecvență Setări de frecvență
gpio FX3 <-> FPGA Stare GPIO
loopback Setări de loopback. Rulați „set loopback” la modurile listă.
Din nou setarea câștigului RX LNA, în dB. Valori: 0, 3, 6
rxvga1 Setarea câștigului RXVGA1, în dB. Interval: [5, 30]
rx_mux FPGA RX FIFO modul mux de intrare. Opțiunile sunt:
BASEBAND_LMS, 12BIT_COUNTER, 32BIT_COUNTER,
DIGITAL_LOOPBACK
rxvga1 Setarea câștigului RXVGA1, în dB. Interval: [5, 30]
rxvga2 Setarea câștigului RXVGA2, în dB. Interval: [0, 30]
txvga1 Setarea câștigului TXVGA1, în dB. Interval: [-35, -4]
txvga2 Setarea câștigului TXVGA2, în dB. Interval: [0, 25]
eșantionare Mod de eșantionare extern sau intern
samplerate Setări ale ratei de eșantionare
setări trimdac VCTCXO trim DAC
vctcxo_tamer Mod de îmblânzire VCTCXO. Opțiuni: Dezactivat, 1PPS, 10MHz
xb_gpio Valorile GPIO ale plăcii de expansiune
xb_gpio_dir Placă de expansiune Direcția GPIO (1=ieșire, 0=intrare)

versiune
Utilizare: versiune

Imprimă informații despre versiune pentru software-ul gazdă și dispozitivul curent.

EXEMPLE

$ bladeRF-cli -l hostedx40.rbf

Încarcă o imagine FPGA numită hostedx40.rbf pe FPGA-ul bladeRF.

notițe: Imaginea FPGA încărcată cu --load-fpga se va pierde la oprire.

$ bladeRF-cli -f firmware.img

Afișează firmware.img pe firmware-ul bladeRF.

$ bladeRF-cli -L hostedx40.rbf

Afișează imaginea FPGA numită hostedx40.rbf pe bladeRF, unde va fi
se încarcă automat la pornire.

Utilizați bladeRF-cli online folosind serviciile onworks.net