bladeRF-cli - Online di Cloud

PROGRAM:

NAMA

bladeRF-cli - antarmuka baris perintah dan utilitas pengujian

RINGKASAN

bladeRF-cli

DESKRIPSI

Grafik bladeRF-cli utilitas digunakan untuk mem-flash file firmware, memuat bitstream FPGA, dan melakukan
tugas lain pada sistem radio yang ditentukan perangkat lunak nuand bladeRF.

Untuk informasi lebih lanjut tentang mendapatkan atau membuat file firmware dan bitstream FPGA, silakan
mengunjungi http://nuand.com/.

antarmuka baris perintah bladeRF dan utilitas uji (1.3.1-0.2016.01~rc1-3)

PILIHAN

-d, --perangkat
Gunakan perangkat bladeRF yang ditentukan.

-f, --flash-firmware
Tulis file firmware FX3 yang disediakan ke flash.

-l, --muat-fpga
Muat bitstream FPGA yang disediakan.

-L, --flash-fpga
Tulis gambar FPGA yang disediakan ke flash untuk autoloading. Menggunakan -L X atau --flash-fpga X
untuk menonaktifkan pemuatan otomatis FPGA.

-p, --menguji
Periksa perangkat, cetak hasil, lalu keluar. Status pengembalian bukan nol adalah
dikembalikan jika tidak ada perangkat yang tersedia.

-e, --eksekutif
Jalankan perintah mode interaktif yang ditentukan. beberapa -e bendera mungkin
ditentukan. Perintah akan dieksekusi dalam urutan yang disediakan.

-s, --naskah
Jalankan skrip yang disediakan.

-i, --interaktif
Masuk ke mode interaktif.

--lib-versi
Cetak versi libbladeRF dan keluar.

-v, --verbositas
Atur tingkat verbositas libbladeRF. Level, tercantum dalam peningkatan verbositas, adalah:

kritis, kesalahan, peringatan,
info, debug, bertele-tele

--Versi: kapan
Cetak versi CLI dan keluar.

-h, --membantu
Tampilkan teks bantuan ini.

--help-interaktif
Cetak informasi bantuan untuk semua perintah interaktif.

Catatan:
Grafik -d opsi mengambil string penentu perangkat. Lihat dokumentasi bladerf_open()
untuk informasi lebih lanjut tentang format string ini.

Jika -d parameter tidak disediakan, perangkat pertama yang tersedia akan digunakan untuk
perintah yang disediakan, atau akan dibuka sebelum memasuki mode interaktif.

Perintah dijalankan dalam urutan berikut:

Opsi baris perintah, -e , perintah skrip, perintah mode interaktif.

Saat menjalankan 'rx/tx start' dari skrip atau melalui -e, pastikan perintah ini nanti
diikuti oleh 'rx/tx wait [timeout]' untuk memastikan program tidak akan mencoba keluar
sebelum penerimaan/transmisi selesai.

INTERAKTIF PERINTAH

bladeRF-cli mendukung mode interaktif skrip. Lari bladeRF-cli --interaktif untuk
masuk ke mode ini. Jenis "membantu" untuk daftar semua perintah, atau "membantu " untuk lebih
informasi tentang .

menyesuaikan
penggunaan: kalibrasi [pilihan]

Lakukan operasi kalibrasi transceiver yang ditentukan.

Operasi yang tersedia:

· Kalibrasi otomatis offset DC internal LMS

· mengkalibrasi lms [tampilkan]

· mengkalibrasi penyetelan lms [nilai]

· kalibrasi lms txlpf [ ]

· kalibrasi lms rxlpf [ ]

· kalibrasi lms rxvga2 [ ]

Lakukan kalibrasi otomatis yang ditentukan, atau semuanya jika tidak ada yang disediakan. Kapan
nilai disediakan, ini digunakan sebagai ganti hasil kalibrasi otomatis
prosedur. Gunakan lms show untuk membaca dan mencetak nilai kalibrasi LMS saat ini.

Untuk rxvga2, I1 dan Q1 masing-masing adalah komponen Tahap 1 I dan Q, dan I2 dan Q2 adalah
komponen Tahap 2 I dan Q.

· Kalibrasi parameter koreksi offset RX dan TX I/Q DC

· kalibrasi dc [ ]

· kalibrasi dc

Kalibrasi parameter koreksi offset DC untuk frekuensi dan penguatan saat ini
pengaturan. Jika nilai I/Q diberikan, nilai tersebut diterapkan secara langsung. kal rxtx adalah
singkatan untuk cal rx diikuti oleh cal tx.

· Kalibrasi parameter koreksi keseimbangan RX dan TX I/Q

· kalibrasi iq

Atur penguatan IQ atau parameter keseimbangan fase yang ditentukan.

· Hasilkan tabel parameter koreksi RX atau TX I/Q DC

· kalibrasi tabel dc [ [f_inc]]

Buat dan tulis tabel parameter koreksi I/Q ke direktori kerja saat ini,
dalam file bernama _dc_ .tbl. f_min dan f_max adalah frekuensi min dan maks untuk
termasuk dalam tabel. f_inc adalah peningkatan frekuensi.

Secara default, tabel dihasilkan di seluruh rentang frekuensi, dalam langkah 2 MHz.

jelas
penggunaan: jelas

Membersihkan layar.

gema
Penggunaan: echo [arg 1] [arg 2] ... [arg n]

Gema setiap argumen pada baris baru.

Menghapus
penggunaan: hapus

Hapus yang ditentukan, hapus blok SPI flash.

· - Hapus blok offset

· - Jumlah blok hapus untuk dihapus

flash_backup
Penggunaan: flash_backup ( | )

Cadangkan data flash ke file yang ditentukan. Perintah ini membutuhkan dua atau empat
argumen. Doa dua argumen umumnya direkomendasikan untuk penggunaan non-pengembangan.

Parameter:

· - Jenis cadangan.

Ini memilih alamat yang sesuai dan nilai panjang berdasarkan jenis yang dipilih.

Opsi yang valid adalah:

Deskripsi Opsi
────────────────────────────────────────────────── ──────────────────
data Kalibrasi kal
Firmware fw
FPGA40 Metadata dan bitstream untuk 40 kLE FPGA
FPGA115 Metadata dan bitstream untuk 115 kLE FPGA

· - Alamat data yang akan dibackup. Harus menghapus blok-aligned.

· - Panjang wilayah yang akan dicadangkan. Harus menghapus blok-aligned.

Catatan: Jika alamat dan panjangnya diberikan, jenis gambar akan default ke mentah.

contoh:

· flash_backup kal.bin kal

Mencadangkan wilayah data kalibrasi.

· flash_backup cal_raw.bin 0x30000 0x10000

Mencadangkan wilayah kalibrasi sebagai gambar data mentah.

flash_image
Penggunaan: flash_image [opsi keluaran]

Cetak metadata gambar flash atau buat gambar flash baru. Ketika diberikan dengan nama
dari file gambar flash sebagai satu-satunya argumen, perintah ini akan mencetak konten metadata
dari gambar.

Opsi berikut dapat digunakan untuk membuat gambar flash baru.

· data=

File untuk berisi data untuk disimpan dalam gambar.

· alamat=

Alamat kilat. Standarnya tergantung pada parameter tipe.

· jenis =

Jenis gambar flash. Default untuk mentah.

Opsi yang valid adalah:

Deskripsi Opsi
────────────────────────────────────────────────── ──────────────────
data Kalibrasi kal
Firmware fw
FPGA40 Metadata dan bitstream untuk 40 kLE FPGA
FPGA115 Metadata dan bitstream untuk 115 kLE FPGA
data mentah mentah. Parameter alamat dan panjang harus
disediakan jika jenis ini dipilih.

· seri=

Serial # untuk disimpan dalam gambar. Default ke nol.

flash_init_cal
Penggunaan: flash_init_cal [ ]

Buat dan tulis wilayah data kalibrasi baru ke perangkat yang sedang dibuka, atau ke a
mengajukan. Pastikan untuk mencadangkan data kalibrasi sebelum menjalankan perintah ini. (Lihat
perintah flash_backup.)

·

Baik 40 atau 115, tergantung pada model perangkat.

·

Nilai trim VCTCXO/DAC (0x0-0xffff)

·

File untuk menulis data kalibrasi. Ketika argumen ini diberikan, tidak akan ada data
ditulis ke flash perangkat.

flash_restore
Penggunaan: flash_restore [ ]

Pulihkan data flash dari file, secara opsional mengesampingkan nilai dalam metadata gambar.

·

Default ke alamat yang ditentukan dalam file gambar flash yang disediakan.

·

Default untuk panjang data dalam file gambar yang disediakan.

fw_log
Penggunaan: fw_log [nama file]

Baca konten log firmware perangkat dan tulis ke file yang ditentukan. Jika tidak
nama file ditentukan, konten log ditulis ke stdout.

membantu
penggunaan: bantuan [ ]

Memberikan bantuan tambahan, seperti ini, pada perintah apa pun.

Info
penggunaan: info

Mencetak informasi berikut tentang perangkat yang dibuka:

· Nomor seri

· Nilai kalibrasi VCTCXO DAC

· Ukuran FPGA

· Apakah FPGA dimuat atau tidak

· Bus USB, alamat, dan kecepatan

· Backend (Menunjukkan kode antarmuka perangkat mana yang digunakan.)

· Nomor Instance

lompat_ke_boot
Penggunaan: jump_to_boot

Hapus kata tanda tangan FW dalam sekejap dan lompat ke bootloader FX3.

Perangkat akan terus boot ke bootloader FX3 di seluruh siklus daya hingga baru
firmware ditulis ke perangkat.

memuat
penggunaan: beban

Muat bitstream FPGA atau program flash SPI FX3.

xb
penggunaan: xb [parameter]

Mengaktifkan atau mengonfigurasi papan ekspansi.

Nilai yang valid untuk board_model:

100

Papan ekspansi GPIO XB-100

200

Papan ekspansi transverter XB-200 LF/MF/HF/VHF

Sub-perintah umum:

· memungkinkan

Aktifkan papan ekspansi XB-100 atau XB-200.

Sub-perintah XB-200:

· filter [rx|tx] [50|144|222|kustom|auto_1db|auto_3db]

Memilih filter RX atau TX yang ditentukan pada papan XB-200. Di bawah ini adalah deskripsi dari
masing-masing opsi filter.

50

Pilih filter 50-54 MHz (6 meter band).

144

Pilih filter 144-148 MHz (2 meter band).

222

Pilih filter 222-225 MHz (pita 1.25 meter). Secara realistis,
opsi filter ini sebenarnya sedikit lebih lebar, meliputi
206MHz - 235MHz.

· kebiasaan

Memilih jalur filter khusus. Pengguna harus menghubungkan filter
sepanjang koneksi FILT dan FILT-ANT yang sesuai saat menggunakan
pilihan ini. Sebagai alternatif, seseorang dapat melakukan jumper pada FILT dan FILT-ANT
koneksi untuk mencapai "tanpa filter" untuk penerimaan. (Namun, ini adalah
_sangat_ tidak disarankan untuk transmisi.)

· otomatis_1dB

Secara otomatis memilih salah satu pilihan di atas berdasarkan frekuensi
dan poin 1dB filter. Jalur khusus digunakan untuk kasus
yang tidak terkait dengan filter terpasang.

· otomatis_3dB

Secara otomatis memilih salah satu pilihan di atas berdasarkan frekuensi
dan poin 3dB filter. Jalur khusus digunakan untuk kasus
yang tidak terkait dengan filter terpasang.

contoh:

· xb 200 aktifkan

Mengaktifkan dan mengonfigurasi papan ekspansi transverter XB-200.

· xb 200 menyaring rx 144

Memilih filter penerimaan 144-148 MHz pada papan ekspansi transverter XB-200.

mimo
Penggunaan: mimo [master | budak]

Ubah operasi MIMO perangkat.

Buka
Penggunaan: buka [pengidentifikasi perangkat]

Buka perangkat yang ditentukan untuk digunakan dengan perintah yang berurutan. Perangkat apa pun yang dibuka sebelumnya
akan ditutup.

Bentuk umum dari device identifier string adalah:

:[perangkat= : ] [contoh= ] [serial= ]

Lihat dokumentasi bladerf_open() di libbladeRF untuk specifier perangkat lengkap
Format.

mengintip
penggunaan: mengintip [jumlah_alamat]

Perintah mengintip dapat membaca salah satu perangkat yang menggantung dari FPGA yang mencakup
Transceiver LMS6002D, VCTCXO trim DAC atau chip generator jam Si5338.

Jika num_addresses diberikan, alamat bertambah 1 dan mengintip lainnya adalah
dilakukan untuk banyak alamat.

Rentang Alamat yang Valid:

Rentang Alamat Perangkat
───────────────────
dac 0 hingga 255

lms 0 hingga 127
dari 0 hingga 255

Contoh:

· mengintip si ...

menyodok
penggunaan: menyodok

Perintah poke dapat menulis perangkat apa pun yang menggantung dari FPGA yang mencakup
Transceiver LMS6002D, VCTCXO trim DAC atau chip generator jam Si5338.

Rentang Alamat yang Valid:

Rentang Alamat Perangkat
───────────────────
dac 0 hingga 255
lms 0 hingga 127
dari 0 hingga 255

Contoh:

· menyodok lms ...

mencetak
Penggunaan: cetak [parameter]

Perintah print mengambil parameter untuk dicetak. Parameter yang tersedia tercantum di bawah ini. Jika
tidak ada paremeter yang ditentukan, semua parameter dicetak.

Deskripsi Parameter
────────────────────────────────────────────────── ──────────────────────
bandwidth Pengaturan bandwidth
pengaturan frekuensi frekuensi
gpio FX3 <-> Status FPGA GPIO
loopback Pengaturan loopback
Lagi-lagi pengaturan penguatan RX LNA, dalam dB
rx_mux FPGA RX FIFO masukan pengaturan mux
rxvga1 Pengaturan penguatan RXVGA1, dalam dB
rxvga2 Pengaturan penguatan RXVGA2, dalam dB
txvga1 Mendapatkan pengaturan TXVGA1, dalam dB
txvga2 Mendapatkan pengaturan TXVGA2, dalam dB
pengambilan sampel Mode pengambilan sampel eksternal atau internal
samplerate pengaturan samplerate
trimdac VCTCXO Pangkas pengaturan DAC
vctcxo_tamer Mode penjinak VCTCXO saat ini.
Nilai GPIO papan ekspansi xb_gpio
xb_gpio_dir Papan ekspansi arah GPIO (1=output, 0=input)

penyelidikan
penggunaan: probe [ketat]

Cari perangkat bladeRF yang terpasang dan cetak daftar hasil.

Tanpa menentukan ketat, kurangnya perangkat yang tersedia tidak dianggap sebagai kesalahan.

Ketika diberikan argumen ketat opsional, perintah ini akan menangani situasi di mana tidak ada
perangkat ditemukan sebagai kesalahan, menyebabkan skrip atau daftar perintah yang disediakan melalui -e
argumen baris perintah untuk segera dihentikan.

berhenti
penggunaan: berhenti

Keluar dari CLI.

memulihkan
penggunaan: pulihkan [ ]

Muat firmware ke perangkat yang berjalan dalam mode bootloader, atau daftarkan semua perangkat yang saat ini digunakan
mode bootloader.

Tanpa argumen, perintah ini mencantumkan bus USB dan alamat untuk perangkat berbasis FX3
berjalan dalam mode bootloader.

Saat menyediakan bus, alamat, dan jalur ke file firmware, perangkat yang ditentukan akan menjadi
dimuat dengan dan mulai menjalankan firmware yang disediakan.

Dalam kebanyakan kasus, setelah berhasil memuat firmware ke dalam RAM perangkat, pengguna harus
buka perangkat dengan perintah "buka", dan tulis firmware untuk di-flash melalui
"muat fx3 "

menjalankan
penggunaan: lari

Jalankan skrip yang disediakan.

rx
penggunaan: rx

Terima sampel IQ dan tuliskan ke file yang ditentukan. Penerimaan dikendalikan dan
dikonfigurasi oleh salah satu dari berikut ini:

Deskripsi Perintah
────────────────────────────────────────────────── ──────────────────────
mulai Mulai menerima sampel
berhenti Berhenti menerima sampel
tunggu Tunggu pengiriman sampel selesai, atau sampai a
jumlah waktu berlalu yang ditentukan
config Mengonfigurasi penerimaan sampel. Jika tidak ada parameter
disediakan, parameter saat ini dicetak.

Menjalankan rx tanpa perintah tambahan adalah singkatan yang valid untuk konfigurasi rx.

Perintah wait mengambil parameter batas waktu opsional. Parameter ini default ke unit
milidetik (ms). Unit batas waktu dapat ditentukan menggunakan akhiran ms atau s. Jika ini
parameter tidak disediakan, perintah akan menunggu hingga penerimaan selesai atau Ctrl-C
ditekan.

Parameter konfigurasi mengambil bentuk param=value, dan dapat ditentukan dalam satu atau
beberapa permintaan konfigurasi rx. Di bawah ini adalah daftar parameter yang tersedia.

Deskripsi Parameter
────────────────────────────────────────────────── ──────────────────────
n Jumlah sampel yang akan diterima. 0 = inf.
file Nama file untuk menulis sampel yang diterima ke
format Keluaran format file. Satu dari berikut:
csv: CSV dari sampel SC16 Q11
bin: Sampel mentah SC16 Q11 DAC
sampel Jumlah sampel per buffer yang akan digunakan dalam
aliran asinkron. Harus habis dibagi 1024 dan
>= 1024.
buffers Jumlah buffer sampel yang akan digunakan dalam asynchronous
sungai kecil. Nilai minimalnya adalah 4.
xfers Jumlah transfer simultan untuk memungkinkan
aliran asinkron untuk digunakan. Ini harus lebih sedikit
daripada parameter buffer.
waktu habis Waktu aliran data habis. Tanpa akhiran, default
satuannya ms. Nilai default adalah 1000 mdtk (1 dtk).
Sufiks yang valid adalah ms dan s.

Contoh:

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

Terima (10240 = 10 * 1024) sampel, tulis ke /tmp/data.bin dalam DAC biner
Format.

Catatan:

· Parameter n, sampel, buffer, dan xfers mendukung sufiks K, M, dan G, yang
adalah kelipatan 1024.

· rx stop diikuti oleh rx start akan mengakibatkan file sampel terpotong. Jika
ini tidak diinginkan, pastikan untuk menjalankan rx config untuk mengatur file lain sebelum memulai ulang
aliran rx.

· Untuk laju sampel yang lebih tinggi, disarankan agar format keluaran biner digunakan, dan
file output ditulis ke RAM (mis / Tmp, /dev/shm), jika ruang memungkinkan. Untuk lebih besar
menangkap pada tingkat sampel yang lebih tinggi, pertimbangkan untuk menggunakan SSD, bukan HDD.

tx
penggunaan: tx

Baca sampel IQ dari file yang ditentukan dan kirimkan. Transmisi dikendalikan dan
dikonfigurasi oleh salah satu dari berikut ini:

Deskripsi Perintah
────────────────────────────────────────────────── ──────────────────────
mulai Mulai mengirimkan sampel
berhenti Berhenti mengirimkan sampel
tunggu Tunggu pengiriman sampel selesai, atau sampai a
jumlah waktu berlalu yang ditentukan
config Mengkonfigurasi transmisi sampel. Jika tidak ada parameter
disediakan, parameter saat ini dicetak.

Menjalankan tx tanpa perintah tambahan adalah singkatan yang valid untuk konfigurasi tx.

Perintah wait mengambil parameter batas waktu opsional. Parameter ini default ke unit
milidetik (ms). Unit batas waktu dapat ditentukan menggunakan akhiran ms atau s. Jika ini
parameter tidak disediakan, perintah akan menunggu sampai transmisi selesai atau
Ctrl-C ditekan.

Parameter konfigurasi mengambil bentuk param=value, dan dapat ditentukan dalam satu atau
beberapa permintaan konfigurasi tx. Di bawah ini adalah daftar parameter yang tersedia.

Deskripsi Parameter
────────────────────────────────────────────────── ──────────────────────
file Nama file untuk membaca sampel dari
format Format file masukan. Satu dari berikut:
csv: CSV dari sampel SC16 Q11 ([-2048, 2047])
bin: Sampel mentah SC16 Q11 DAC ([-2048, 2047])
ulangi Berapa kali konten file seharusnya
ditularkan. 0 menyiratkan pengulangan sampai berhenti.
delay Jumlah mikrodetik untuk menunda antara
mentransmisi ulang isi file. 0 berarti tidak ada penundaan.
sampel Jumlah sampel per buffer yang akan digunakan dalam
aliran asinkron. Harus habis dibagi 1024 dan
>= 1024.
buffers Jumlah buffer sampel yang akan digunakan dalam asynchronous
sungai kecil. Nilai minimalnya adalah 4.
xfers Jumlah transfer simultan untuk memungkinkan
aliran asinkron untuk digunakan. Ini harus < the
parameter buffer.
waktu habis Waktu aliran data habis. Tanpa akhiran, default
satuannya ms. Nilai default adalah 1000 mdtk (1 dtk).
Sufiks yang valid adalah 'ms' dan 's'.

Contoh:

· tx file konfigurasi=data.bin format=bin ulangi=2 penundaan=250000

Mengirimkan konten data.bin dua kali, dengan penundaan ~250ms antara
transmisi.

Catatan:

· Parameter n, sampel, buffer, dan xfers mendukung sufiks K, M, dan G, yang
adalah kelipatan 1024.

· Untuk laju sampel yang lebih tinggi, disarankan agar file input disimpan dalam RAM (mis / Tmp,
/dev/shm) atau pada SSD, bukan HDD.

· Saat memberikan data CSV, perintah ini pertama-tama akan mengubahnya menjadi format biner, disimpan
dalam file di direktori kerja saat ini. Selama proses ini, nilai di luar jangkauan
akan dijepit.

· Saat menggunakan format biner, pengguna bertanggung jawab untuk memastikan bahwa data yang diberikan
nilai berada dalam rentang yang diizinkan. Prasyarat ini mengurangi kebutuhan untuk ini
program untuk melakukan pemeriksaan jangkauan dalam panggilan balik yang sensitif terhadap waktu.

set
penggunaan: set

Perintah set mengambil parameter dan sejumlah argumen yang berubah-ubah untuk itu
parameter. Parameternya adalah salah satu dari:

Deskripsi Parameter
────────────────────────────────────────────────── ──────────────────────
bandwidth Pengaturan bandwidth
pengaturan frekuensi frekuensi
gpio FX3 <-> Status FPGA GPIO
pengaturan putaran balik. Jalankan 'set loopback' ke mode daftar.
Lagi-lagi pengaturan penguatan RX LNA, dalam dB. Nilai: 0, 3, 6
rxvga1 Dapatkan pengaturan RXVGA1, dalam dB. Rentang: [5, 30]
rx_mux FPGA RX FIFO masukan mode mux. Pilihannya adalah:
BASEBAND_LMS, 12BIT_COUNTER, 32BIT_COUNTER,
DIGITAL_LOOPBACK
rxvga1 Dapatkan pengaturan RXVGA1, dalam dB. Rentang: [5, 30]
rxvga2 Dapatkan pengaturan RXVGA2, dalam dB. Rentang: [0, 30]
txvga1 Dapatkan pengaturan TXVGA1, dalam dB. Rentang: [-35, -4]
txvga2 Dapatkan pengaturan TXVGA2, dalam dB. Rentang: [0, 25]
pengambilan sampel Mode pengambilan sampel eksternal atau internal
samplerate Pengaturan tingkat sampel
trimdac VCTCXO trim pengaturan DAC
vctcxo_tamer Mode penjinak VCTCXO. Opsi: Dinonaktifkan, 1PPS, 10MHz
Nilai GPIO papan ekspansi xb_gpio
xb_gpio_dir Papan ekspansi arah GPIO (1=output, 0=input)

versi
penggunaan: versi

Mencetak informasi versi untuk perangkat lunak host dan perangkat saat ini.

CONTOH

$ bladeRF-cli -l hostx40.rbf

Memuat gambar FPGA bernama hostx40.rbf ke FPGA bladeRF.

Note: Gambar FPGA yang dimuat dengan --load-fpga akan hilang saat dimatikan.

$ bladeRF-cli -f firmware.img

Mem-flash firmware.img ke firmware bladeRF.

$ bladeRF-cli -L hostx40.rbf

Mem-flash gambar FPGA bernama hostsx40.rbf ke bladeRF, di mana ia akan berada
otomatis dimuat pada power-up.

Gunakan bladeRF-cli online menggunakan layanan onworks.net