bladeRF-cli - parancssori felület és teszt segédprogram
bladeRF-cli <options>
A bladeRF-cli segédprogram a firmware-fájlok flashelésére, FPGA-bitfolyamok betöltésére és egyéb feladatok végrehajtására szolgál a nuand bladeRF szoftver által definiált rádiórendszeren.
A firmware fájlok és FPGA bitfolyamok beszerzésével vagy létrehozásával kapcsolatos további információkért látogasson el a http://nuand.com/ oldalra.
bladeRF parancssori interfész és teszt segédprogram (1.8.0-git)
Használja a megadott bladeRF eszközt.
Írja be a mellékelt FX3 firmware fájlt a flash-hez.
Töltse be a mellékelt FPGA bitfolyamot.
Írja be a mellékelt FPGA képet flash-re az automatikus betöltéshez. Használja a -L X vagy --flash-fpga X parancsot az FPGA automatikus betöltés letiltásához.
Keresse meg az eszközöket, nyomtassa ki az eredményeket, majd lépjen ki. Nem nulla visszatérési állapot jelenik meg, ha nem állnak rendelkezésre eszközök.
Hajtsa végre a megadott interaktív mód parancsot. Több -e jelző is megadható. A parancsok a megadott sorrendben kerülnek végrehajtásra.
Futtassa a megadott szkriptet.
Lépjen be az interaktív módba.
Nyomtassa ki a libbladeRF verziót és lépjen ki.
Állítsa be a libbladeRF bőbeszédűségi szintjét. A növekvő bőbeszédűséggel felsorolt szintek a következők:
info, hibakeresés, bőbeszédű
Nyomtassa ki a CLI verziót és lépjen ki.
Mutassa meg ezt a súgószöveget.
Nyomtassa ki az összes interaktív parancs súgóinformációit.
A -d opció egy eszközspecifikációs karakterláncot vesz fel. A karakterlánc formátumával kapcsolatos további információkért tekintse meg a bladerf_open() dokumentációt.
Ha a -d paraméter nincs megadva, akkor a rendszer az első elérhető eszközt használja a megadott parancshoz, vagy megnyitja az interaktív módba lépés előtt.
A parancsok végrehajtása a következő sorrendben történik:
Parancssori opciók, -e
, script parancsok, interaktív mód parancsok. Ha az „rx/tx start” parancsfájlt vagy a -e-n keresztül futtatja, győződjön meg arról, hogy ezeket a parancsokat később az „rx/tx wait [timeout]” követi, hogy a program ne próbáljon kilépni a vétel előtt. /Az átvitel befejeződött.
A bladeRF-cli támogatja a szkriptelhető interaktív módot. Futtassa a bladeRF-cli --interactive parancsot, hogy belépjen ebbe a módba. Írja be a „help” parancsot az összes parancs listájához, vagy a „help
Használat:
calibrate <operation> [options]Hajtsa végre a megadott adó-vevő kalibrálási műveletet.
Elérhető műveletek:
LMS belső DC offset automatikus kalibrálások
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>]Hajtsa végre a megadott automatikus kalibrálást, vagy ha nincs, akkor mindegyiket. Ha értékeket ad meg, akkor ezeket használja az automatikus kalibrálási eljárás eredményei helyett. Az lms show használatával beolvashatja és kinyomtathatja az aktuális LMS-kalibrációs értékeket.
Az rxvga2 esetén az I1 és a Q1 az 1. szakasz I és Q komponensei, az I2 és pedig A Q2 a 2. szakasz I és Q komponensei.
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.
Használat:
clearTörli a képernyőt.
Használat:
echo [arg 1] [arg 2] ... [arg n]Minden argumentumot egy új sorban visszhangozzon.
Használat:
erase <offset> <count>A megadott törlési blokkok törlése SPI flash.
<offset>Blokkeltolás törlése
<count>A törölni kívánt törlési blokkok száma
Használat:
flash_backup <file> (<type> | <address> <length>)A flash adatok biztonsági mentése a megadott fájlba. Ez a parancs két vagy négy argumentumot tartalmaz. A két-argumentumú meghívás általában nem fejlesztési célokra javasolt.
Paraméterek:
<type>A biztonsági mentés típusa.
Ez kiválasztja a megfelelő cím- és hosszértékeket a kiválasztott típus alapján.
Az érvényes lehetőségek a következők:
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>A biztonsági mentéshez szükséges adatok címe. Törlési blokkhoz igazítva kell lennie.
<len>A biztonsági mentéshez szükséges régió hossza. Törlési blokkhoz igazítva kell lennie.
Megjegyzés: Cím és hossz megadása esetén a képtípus alapértelmezés szerint raw lesz.
Példák:
Biztonsági másolatot készít a kalibrációs adatok régiójáról:
flash_backup cal.bin calBiztonsági másolatot készít a kalibrációs régióról nyers adatképként:
flash_backup cal_raw.bin 0x30000 0x10000Használat:
flash_image <image> [output options]Nyomtasson ki egy flash kép metaadatait, vagy hozzon létre egy új flash képet. Ha egyetlen argumentumként egy flash képfájl nevét adjuk meg, ez a parancs kinyomtatja a kép metaadat-tartalmát.
A következő opciók használhatók új flash kép létrehozásához.
data=<file>A képen tárolandó adatokat tartalmazó fájl.
address=<addr>Flash cím. Az alapértelmezett érték a type paramétertől függ.
type=<type>Flash-kép típusa. Alapértelmezés szerint raw.
Az érvényes lehetőségek a következők:
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>Sorozatszám a képen tárolandó. Alapértelmezésben nullák.
Használat:
flash_init_cal <fpga_size> <vctcxo_trim> [<output_file>]Hozzon létre és írjon egy új kalibrációs adatrégiót az éppen megnyitott eszközre vagy egy fájlba. A parancs futtatása előtt mindenképpen készítsen biztonsági másolatot a kalibrációs adatokról. (Lásd a flash_backup parancsot.)
<fpga_size>A készülék típusától függően 40 vagy 115.
<vctcxo_trim>VCTCXO/DAC trimmérték (0x0-0xffff)
<output_file>Fájl a kalibrációs adatok írásához. Ha megadja ezt az argumentumot, a rendszer nem ír adatokat az eszköz flash-jére.
Használat:
flash_restore <file> [<address> <length>]Flash-adatok visszaállítása fájlból, opcionálisan felülírva az értékeket a kép metaadataiban.
<address>Alapértelmezés szerint a mellékelt flash képfájlban megadott cím.
<length>Alapértelmezés szerint a megadott képfájlban lévő adatok hossza.
Használat:
fw_log [filename]Olvassa el az eszköz firmware naplójának tartalmát, és írja be a megadott fájlba. Ha nincs megadva fájlnév, a naplótartalom az stdout-ba kerül.
Használat:
help [<command>]Kibővített segítséget nyújt, mint ez, bármilyen parancsra.
Használat:
infoA következő információkat nyomtatja ki egy megnyitott eszközről:
Sorozatszám
VCTCXO DAC kalibrációs érték
FPGA méret
Függetlenül attól, hogy az FPGA betöltve van-e vagy sem
USB-busz, cím és sebesség
Backend (Azt jelöli, hogy melyik eszköz interfész kódja van használatban.)
Példányszám
Használat:
jump_to_bootTöröljön ki egy FW aláírási szót flash-ben, és ugorjon az FX3 rendszerbetöltőre.
Az eszköz továbbra is az FX3 rendszertöltőbe tölti be az energiaellátási ciklusokon keresztül, amíg új firmware-t nem írnak az eszközre.
Használat:
load <fpga|fx3> <filename>Töltsön be egy FPGA bitfolyamot, vagy programozza be az FX3 SPI flashjét.
Használat:
xb <board_model> <subcommand> [parameters]Bővítőkártya engedélyezése vagy konfigurálása.
A board_model érvényes értékei:
100XB-100 GPIO bővítőkártya
200XB-200 LF/MF/HF/VHF transzverteres bővítőkártya
300XB-300 erősítő kártya
Gyakori alparancsok:
enableEngedélyezze az XB-100, XB-200 vagy XB-300 bővítőkártyát.
XB-200 alparancsok:
filter [rx|tx] [50|144|222|custom|auto_1db|auto_3db]Kiválasztja a megadott RX vagy TX szűrőt az XB-200 kártyán. Az alábbiakban az egyes szűrőbeállítások leírása található:
Válassza ki az 50-54 MHz (6 méteres sáv) szűrőt.
Válassza ki a 144-148 MHz (2 méteres sáv) szűrőt.
Válassza ki a 222-225 MHz (1,25 méteres sáv) szűrőt. Reálisan, ez a szűrő opció valójában valamivel szélesebb, fedő 206 MHz - 235 MHz.
Kiválasztja az egyéni szűrőútvonalat. A felhasználónak szűrőt kell csatlakoztatnia a megfelelő FILT és FILT-ANT csatlakozásokhoz, ha ezt az opciót használja. Alternatív megoldásként áthidalhatja a FILT és FILT-ANT csatlakozásokat, hogy "nincs szűrő" a vételhez. (Ez azonban _nagyon_ nem támogatja az adásokat.)
Automatikusan kiválaszt egyet a fenti lehetőségek közül a frekvencia és a szűrők 1dB pontja alapján. Az egyéni elérési út olyan eseteknél használatos, amelyek nincsenek társítva a beépített szűrőkkel.
Automatikusan kiválaszt egyet a fenti lehetőségek közül a frekvencia és a szűrők 3dB-es pontjai alapján. Az egyéni elérési út olyan eseteknél használatos, amelyek nincsenek társítva a beépített szűrőkkel.
XB-300 alparancsok:
<pa|lna|aux> [on|off]Engedélyezze vagy tiltsa le a teljesítményerősítőt (PA), az alacsony zajszintű erősítőt (lna) vagy a kiegészítő LNA-t (aux). Az aktuális állapot, ha a megadott eszköz ki van nyomtatva, ha az [on|off] nincs megadva.
Megjegyzés: Az XB-300 kiegészítő útvonala alapértelmezés szerint nincs feltöltve komponensekkel; az aux vezérlőnek nincs hatása az RX jelre. Ez az opció a felhasználók számára elérhető, hogy egyéni hardverrel módosítsák kártyájukat.
<pwr>Olvassa le az aktuális Power Detect (PDET) feszültséget, és számítsa ki a kimeneti teljesítményt.
trx <rx|tx>Az alapértelmezett XB-300 hardverkonfiguráció külön RX és TX útvonalakat tartalmaz. Azonban a felhasználók, akik csak egyetlen antennát szeretnének használni a TRX-hez, megtehetik ezt az XB-300 ellenálláspopuláció-opcióinak módosításával, és ezzel a paranccsal válthatnak az RX és a TX műveletek között. (Lásd R8, R10 és R23 a kapcsolási rajzon.)
Példák:
Engedélyezi és konfigurálja az XB-200 transzverter bővítőkártyát:
xb 200 enableKiválasztja a 144-148 MHz-es vételszűrőt az XB-200 transzverter bővítőkártyán:
xb 200 filter rx 144Engedélyezi és konfigurálja a GPIO-k használatát az XB-300-zal való interakcióhoz. A PA és az LNA alapértelmezés szerint le van tiltva:
xb 300 enableEngedélyezi az RX LNA-t az XB-300-on. A D1 LED (zöld) világít, ha az LNA be van kapcsolva, és nem világít, ha le van tiltva:
xb 300 lna onLetiltja a TX PA-t az XB-300-on. A D2 LED (kék) világít, ha a PA be van kapcsolva, és nem világít, ha le van tiltva:
xb 300 pa offHasználat:
mimo [master | slave]Az eszköz MIMO működésének módosítása.
FONTOS: Ez a parancs elavult, és a "print/set smb_mode" váltotta fel. A használati szöveghez futtassa: "set smb_mode"
Használat:
open [device identifiers]Nyissa meg a megadott eszközt az egymást követő parancsok használatához. Minden korábban megnyitott eszköz bezárul.
Az eszközazonosító karakterlánc általános formája a következő:
<backend>:[device=<bus>:<addr>] [instance=<n>] [serial=<serial>]Tekintse meg a bladerf_open() dokumentációt a libbladeRF-ben a teljes eszközspecifikációs formátumért.
Használat:
peek <rfic|pll|dac|lms|si> <address> [num_addresses]A peek parancs képes olvasni az FPGA-ról lelógó bármely eszközt. Ez magában foglalja a következőket:
bladeRF 1: LMS6002D adó-vevő, VCTCXO trim DAC, Si5338 óragenerátor
bladeRF 2: AD9361 adó-vevő, VCTCXO trim DAC, ADF4002 frekvenciaszintetizátor
Ha a num_addresses meg van adva, akkor a cím 1-gyel növekszik, és újabb betekintés történik ennyi címre.
Érvényes címtartományok:
Device Address Range
───────────────────────────
rfic 0 to 0x3F7 (1015)
pll 0 to 3
dac 0 to 255
lms 0 to 127
si 0 to 255Példa:
peek si ...Használat:
poke <rfic|pll|dac|lms|si> <address> <data>A poke parancs bármelyik FPGA-ról lelógó eszközt írhat. Ez magában foglalja a következőket:
bladeRF 1: LMS6002D adó-vevő, VCTCXO trim DAC, Si5338 óragenerátor
bladeRF 2: AD9361 adó-vevő, VCTCXO trim DAC, ADF4002 frekvenciaszintetizátor
Érvényes címtartományok:
Device Address Range
───────────────────────────
rfic 0 to 0x3F7 (1015)
pll 0 to 3
dac 0 to 255
lms 0 to 127
si 0 to 255Példa:
poke lms ...Használat:
print [parameter]A print parancs egy paramétert kér a nyomtatáshoz. Az elérhető paraméterek az alábbiakban találhatók. Ha nincs paraméter megadva, az összes paraméter kinyomtatásra kerül.
Általános paraméterek:
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 statusCsak a BladeRF1 paraméterei:
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)Csak a BladeRF2 paraméterei:
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 selectionHasználat:
probe [strict]Keresse meg a csatlakoztatott bladeRF eszközt, és nyomtassa ki az eredmények listáját.
A strict megadása nélkül az elérhető eszközök hiánya nem minősül hibának.
Ha megadja az opcionális strict argumentumot, ez a parancs hibaként kezeli azt a helyzetet, amikor a rendszer nem talál eszközt, így a -e parancssori argumentumban megadott parancsfájlok vagy parancslisták azonnal leállnak.
Használat:
quitLépjen ki a CLI-ből.
Használat:
recover [<bus> <address> <firmware file>]Töltsön be firmware-t egy rendszerbetöltő módban futó eszközre, vagy sorolja fel az összes rendszerbetöltő módban lévő eszközt.
Ez a parancs argumentumok nélkül felsorolja az USB buszt és a címet a rendszerbetöltő módban futó FX3 alapú eszközökhöz.
Amikor megadja a buszt, a címet és a firmware-fájl elérési útját, a megadott eszköz betöltődik a megadott firmware-rel, és megkezdi annak végrehajtását.
A legtöbb esetben, miután sikeresen betöltették a firmware-t az eszköz RAM-jába, a felhasználóknak meg kell nyitniuk az eszközt az "open" paranccsal, és a "load fx3
Használat:
run <script>Futtassa a megadott szkriptet.
Használat:
rx <start | stop | wait | config [param=val [param=val [...]]>Fogadjon IQ-mintákat, és írja be azokat a megadott fájlba. A vételt a következők egyike vezérli és konfigurálja:
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.Az rx további parancsok nélküli futtatása az rx config érvényes rövidítése.
A wait parancs egy opcionális timeout paramétert vesz igénybe. Ennek a paraméternek az alapértelmezett értéke ezredmásodperc (ms). Az időtúllépés mértékegysége az ms vagy az s utótagok használatával adható meg. Ha ez a paraméter nincs megadva, a parancs vár, amíg a vétel befejeződik vagy a Ctrl-C billentyűkombinációt lenyomja.
A konfigurációs paraméterek param=value formátumúak, és egyetlen vagy több rx config meghívással is megadhatók. Az alábbiakban az elérhető paraméterek listája található.
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 usePélda:
Minták fogadása (10240=10 * 1024), bináris DAC formátumban írva azokat a /tmp/data.bin fájlba.
rx config file=/tmp/data.bin format=bin n=10K32768 minta fogadása az RX1-től és RX2-től, és kiírja őket egy mimo.csv nevű fájlba, négy oszloppal (RX1 I, RX1 Q, RX2 I, RX2 Q).
rx config file=mimo.csv format=csv n=32768 channel=1,2Megjegyzések:
Az n, samples, buffers és xfers paraméterek támogatják a K, M és G utótagokat, amelyek 1024 többszörösei.
Az rx stop és az rx start után a mintafájl csonkolását eredményezi. Ha ez nem kívánatos, futtassa az rx config parancsot egy másik fájl beállításához, mielőtt újraindítaná az rx adatfolyamot.
Nagyobb mintavételezési sebesség esetén ajánlatos a binary kimeneti formátumot használni, és a kimeneti fájlt a RAM-ba írni (pl. /tmp, /dev/ shm), ha a hely engedi. Nagyobb, nagyobb mintavételezési sebességű rögzítéshez fontolja meg az SSD használatát HDD helyett.
A CSV formátum csatornánként két oszlopot állít elő, az első két oszlop a channel paraméterrel konfigurált első csatorna I,Q párjának felel meg; a következő két oszlop a második csatorna I,Q-jának felel meg, és így tovább.
Használat:
trigger [<trigger> <tx | rx> [<off slave master fire>]]Ha paraméterek nélkül használja, ez a parancs kiírja az összes trigger állapotát. Amikor és és szállítják, a megadott trigger kinyomtatásra kerül.
Az alábbiakban felsoroljuk a rendelkezésre álló lehetőségeket:
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-independentNe feledje, hogy mindhárom fenti beállítás ugyanarra a logikai portra van leképezve minden eszközön (mini_exp[1]). A fordított kompatibilitás és az egyértelműség érdekében többféle lehetőség áll rendelkezésre.
A trigger vezérlése és konfigurálása az utolsó argumentum megadásával történik, amely a következők egyike lehet:
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.A triggerlánc egy vagy több bladeRF egységből áll, és tartalmazhat TX és RX modulokat. Ha több bladeRF egységet használnak, azokat a által meghatározott jellel és közös földeléssel kell csatlakoztatni.
A megfelelő szinkronizálás érdekében a következő parancssorokat kell használni. Feltételezzük, hogy kezdetben minden trigger ki van kapcsolva.
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.
Konfigurálja az összes többi eszközt trigger slaveként
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.
Fejezze be az adási és fogadási feladatokat a szokásos módon
Re-configure the master and slaves to clear fire requests and re-arm.
Steps 1 through 5 may be repeated as neccessary.
Tiltsa le a triggerelést az összes slave-en
Az aktiválás letiltása a mesteren
Megjegyzések:
Az adók és vevők egyetlen láncon történő szinkronizálása 11 minta eltolást okoz a TX és az RX között; ezeket a mintákat el kell dobni. Ennek oka a TX és RX eltérő feldolgozási folyamathossza. Ez az érték változhat, ha az FPGA kódot a jövőben frissítik.
Használat:
tx <start | stop | wait | config [parameters]>Olvassa el az IQ-mintákat a megadott fájlból, és továbbítsa azokat. Az átvitelt a következők egyike vezérli és konfigurálja:
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.A tx további parancsok nélküli futtatása a tx config érvényes rövidítése.
A wait parancs egy opcionális timeout paramétert vesz igénybe. Ennek a paraméternek az alapértelmezett értéke ezredmásodperc (ms). Az időtúllépés mértékegysége az ms vagy az s utótagok használatával adható meg. Ha ez a paraméter nincs megadva, a parancs megvárja az átvitel befejezését vagy a Ctrl-C billentyűkombinációt.
A konfigurációs paraméterek param=value formátumúak, és egyetlen vagy több tx config meghívással is megadhatók. Az alábbiakban az elérhető paraméterek listája található.
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 usePélda:
A data.bin tartalmának továbbítása kétszer, az átvitelek közötti ~250 ms-os késleltetéssel:
tx config file=data.bin format=bin repeat=2 delay=250000A mimo.csv tartalmának ismételt továbbítása úgy, hogy a fájl első csatornája a TX1 csatornára, a második csatorna pedig a TX2 csatornára van leképezve:
tx config file=mimo.csv format=csv repeat=0 channel=1,2Megjegyzések:
Az n, samples, buffers és xfers paraméterek támogatják a K utótagokat, M és G, amelyek 1024 többszörösei.
Nagyobb mintavételezési sebesség esetén javasoljuk, hogy a bemeneti fájlt a RAM-ban (pl. /tmp, /dev/shm) vagy SSD-n tárolja a HDD helyett.
A CSV formátum csatornánként két oszlopot vár el, az első két oszlop a channel paraméterrel konfigurált első csatorna I,Q párjának felel meg; a következő két oszlop a második csatorna I,Q-jának felel meg, és így tovább. Például a fenti mimo.csv példában a -128,128,-256,256 TX1-en (-128,128) és TX2-n (-256,256) továbbít.
A CSV-adatok megadásakor ez a parancs először bináris formátumba konvertálja azokat, az aktuális munkakönyvtárban lévő fájlban tárolva. A folyamat során a tartományon kívüli értékek rögzítésre kerülnek.
Bináris formátum használata esetén a felhasználó felelős azért, hogy a megadott adatértékek a megengedett tartományon belül legyenek. Ez az előfeltétel csökkenti annak szükségességét, hogy ez a program tartományellenőrzést végezzen az időérzékeny visszahívásoknál.
Használat:
set <parameter> <arguments>A set parancs egy paramétert és tetszőleges számú argumentumot vesz fel az adott paraméterhez. Általában a set további segítséget jelenít meg az adott paraméterhez.
Általános paraméterek:
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 settingsCsak a BladeRF1 paraméterei:
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)Csak a BladeRF2 paraméterei:
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 selectionHasználat:
versionKinyomtatja a gazdagép szoftver és az aktuális eszköz verziószámát.
Betölt egy hostedx40.rbf nevű FPGA képet a bladeRF FPGA-jára:
bladeRF-cli -l hostedx40.rbf
Megjegyzés: A --load-fpga paraméterrel betöltött FPGA-kép kikapcsoláskor elveszik.
Felvillantja a firmware.img fájlt a bladeRF firmware-ére:
bladeRF-cli -f firmware.img
Felvillantja a hostedx40.rbf nevű FPGA-képet a bladeRF-re, ahol az automatikusan betöltődik bekapcsoláskor:
bladeRF-cli -L hostedx40.rbf
Ezt a segédprogramot a bladeRF Project közreműködői írták. További információért tekintse meg a CONTRIBUTORS fájlt.
A hibákat a https://github.com/nuand/bladerf címen található problémakövetőn keresztül lehet jelenteni.
Copyright © 2013-2015 Nuand LLC.
Ez a program ingyenes szoftver; tovább terjesztheti és/vagy módosíthatja a Free Software Foundation által közzétett GNU General Public License feltételei szerint; vagy a Licenc 2-es verzióját, vagy (az Ön választása szerint) bármely későbbi verziót.
Ezt a programot abban a reményben terjesztjük, hogy hasznos lesz, de MINDEN GARANCIA NÉLKÜL; még az ELADHATÓSÁGRA vagy A MEGHATÁROZOTT CÉLRA VALÓ ALKALMASSÁGRA vonatkozó vélelmezett garancia nélkül. További részletekért lásd a GNU General Public License-t.
Meg kellett volna kapnia a GNU General Public License egy példányát ezzel a programmal együtt; ha nem, írjon a Free Software Foundation, Inc.-nek, 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
More documentation is available at http://nuand.com/ and https://github.com/nuand/bladerf.