bladeRF-cli - giao diện dòng lệnh và tiện ích kiểm tra
bladeRF-cli <options>
Tiện ích bladeRF-cli được sử dụng để flash các tệp chương trình cơ sở, tải các luồng bit FPGA và thực hiện các tác vụ khác trên hệ thống radio do phần mềm xác định bằng phần mềm bladeRF.
Để biết thêm thông tin về việc lấy hoặc xây dựng các tệp chương trình cơ sở và dòng bit FPGA, vui lòng truy cập http://nuand.com/.
tiện ích thử nghiệm và giao diện dòng lệnh bladeRF (1.8.0-git)
Sử dụng thiết bị bladeRF được chỉ định.
Viết tập tin chương trình cơ sở FX3 được cung cấp để flash.
Tải dòng bit FPGA được cung cấp.
Ghi hình ảnh FPGA được cung cấp vào flash để tự động tải. Sử dụng -L X hoặc --flash-fpga X để tắt tự động tải FPGA.
Thăm dò thiết bị, in kết quả, sau đó thoát. Trạng thái trả về khác không sẽ được trả về nếu không có thiết bị nào.
Thực hiện lệnh chế độ tương tác được chỉ định. Có thể chỉ định nhiều cờ -e. Các lệnh sẽ được thực hiện theo thứ tự được cung cấp.
Chạy tập lệnh được cung cấp.
Vào chế độ tương tác.
In phiên bản libbladeRF và thoát.
Đặt mức độ chi tiết của libbladeRF. Các cấp độ, được liệt kê theo mức độ chi tiết tăng dần, là:
thông tin, gỡ lỗi, dài dòng
In phiên bản CLI và thoát.
Hiển thị văn bản trợ giúp này.
In thông tin trợ giúp cho tất cả các lệnh tương tác.
Tùy chọn -d nhận một chuỗi xác định thiết bị. Xem tài liệu bladerf_open() để biết thêm thông tin về định dạng của chuỗi này.
Nếu tham số -d không được cung cấp, thiết bị khả dụng đầu tiên sẽ được sử dụng cho lệnh được cung cấp hoặc sẽ được mở trước khi vào chế độ tương tác.
Các lệnh được thực hiện theo thứ tự sau:
Tùy chọn dòng lệnh, -e
, lệnh tập lệnh, lệnh chế độ tương tác. Khi chạy 'rx/tx start' từ tập lệnh hoặc qua -e, hãy đảm bảo các lệnh này sau đó được theo sau bởi 'rx/tx wait [timeout]' để đảm bảo chương trình sẽ không tìm cách thoát ra trước khi tiếp nhận /truyền hoàn tất.
bladeRF-cli hỗ trợ chế độ tương tác có thể viết được. Chạy bladeRF-cli --interactive để vào chế độ này. Nhập "help" để biết danh sách tất cả các lệnh hoặc "help
Cách sử dụng:
calibrate <operation> [options]Thực hiện thao tác hiệu chuẩn bộ thu phát được chỉ định.
Các hoạt động có sẵn:
Tự động hiệu chuẩn bù DC bên trong LMS
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>]Thực hiện hiệu chuẩn tự động được chỉ định hoặc tất cả chúng nếu không được cung cấp. Khi các giá trị được cung cấp, chúng sẽ được sử dụng thay cho kết quả của quy trình tự động hiệu chỉnh. Sử dụng lms show để đọc và in các giá trị hiệu chuẩn LMS hiện tại.
Đối với rxvga2, I1 và Q1 lần lượt là các thành phần I và Q của Giai đoạn 1, còn I2 và Q2 là các thành phần I và Q của Giai đoạn 2.
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.
Cách sử dụng:
clearXóa màn hình.
Cách sử dụng:
echo [arg 1] [arg 2] ... [arg n]Lặp lại từng đối số trên một dòng mới.
Cách sử dụng:
erase <offset> <count>Xóa các khối xóa SPI đã chỉ định.
<offset>Xóa phần bù khối
<count>Số khối xóa để xóa
Cách sử dụng:
flash_backup <file> (<type> | <address> <length>)Sao lưu dữ liệu flash vào tệp được chỉ định. Lệnh này có hai hoặc bốn đối số. Việc gọi hai đối số thường được khuyến nghị cho việc sử dụng không phát triển.
Thông số:
<type>Loại dự phòng.
Thao tác này chọn giá trị độ dài và địa chỉ phù hợp dựa trên loại đã chọn.
Các tùy chọn hợp lệ là:
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 chỉ của dữ liệu để sao lưu. Phải được xóa theo khối.
<len>Độ dài của vùng để sao lưu. Phải được xóa theo khối.
Lưu ý: Khi địa chỉ và độ dài được cung cấp, loại hình ảnh sẽ mặc định là raw.
Ví dụ:
Sao lưu vùng dữ liệu hiệu chuẩn:
flash_backup cal.bin calSao lưu vùng hiệu chuẩn dưới dạng ảnh dữ liệu thô:
flash_backup cal_raw.bin 0x30000 0x10000Cách sử dụng:
flash_image <image> [output options]In siêu dữ liệu của ảnh flash hoặc tạo ảnh flash mới. Khi được cung cấp tên của tệp hình ảnh flash làm đối số duy nhất, lệnh này sẽ in nội dung siêu dữ liệu của hình ảnh.
Các tùy chọn sau đây có thể được sử dụng để tạo một hình ảnh flash mới.
data=<file>Tệp để chứa dữ liệu cần lưu trữ trong ảnh.
address=<addr>Địa chỉ nhấp nháy. Giá trị mặc định phụ thuộc vào tham số type.
type=<type>Loại hình ảnh flash. Mặc định là raw.
Các tùy chọn hợp lệ là:
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>Số sê-ri để lưu trữ trong hình ảnh. Mặc định là số không.
Cách sử dụng:
flash_init_cal <fpga_size> <vctcxo_trim> [<output_file>]Tạo và ghi vùng dữ liệu hiệu chuẩn mới vào thiết bị hiện đang mở hoặc vào một tệp. Đảm bảo sao lưu dữ liệu hiệu chuẩn trước khi chạy lệnh này. (Xem lệnh flash_backup.)
<fpga_size>40 hoặc 115, tùy thuộc vào kiểu thiết bị.
<vctcxo_trim>Giá trị cắt VCTCXO/DAC (0x0-0xffff)
<output_file>Tệp để ghi dữ liệu hiệu chuẩn vào. Khi đối số này được cung cấp, sẽ không có dữ liệu nào được ghi vào đèn flash của thiết bị.
Cách sử dụng:
flash_restore <file> [<address> <length>]Khôi phục dữ liệu flash từ một tệp, tùy chọn ghi đè các giá trị trong siêu dữ liệu hình ảnh.
<address>Mặc định là địa chỉ được chỉ định trong tệp hình ảnh flash được cung cấp.
<length>Mặc định độ dài của dữ liệu trong tệp hình ảnh được cung cấp.
Cách sử dụng:
fw_log [filename]Đọc nội dung nhật ký chương trình cơ sở của thiết bị và ghi vào tệp được chỉ định. Nếu không có tên tệp nào được chỉ định, nội dung nhật ký được ghi vào thiết bị xuất chuẩn.
Cách sử dụng:
help [<command>]Cung cấp trợ giúp mở rộng, như thế này, trên bất kỳ lệnh nào.
Cách sử dụng:
infoIn thông tin sau về thiết bị đã mở:
Số seri
Giá trị hiệu chuẩn VCTCXO DAC
kích thước FPGA
FPGA có được tải hay không
Bus USB, địa chỉ và tốc độ
Phụ trợ (Biểu thị mã giao diện thiết bị nào đang được sử dụng.)
số phiên bản
Cách sử dụng:
jump_to_bootXóa một từ chữ ký FW trong flash và chuyển sang bộ tải khởi động FX3.
Thiết bị sẽ tiếp tục khởi động vào bộ tải khởi động FX3 qua các chu kỳ cấp nguồn cho đến khi chương trình cơ sở mới được ghi vào thiết bị.
Cách sử dụng:
load <fpga|fx3> <filename>Tải dòng bit FPGA hoặc lập trình flash SPI của FX3.
Cách sử dụng:
xb <board_model> <subcommand> [parameters]Bật hoặc định cấu hình bảng mở rộng.
Các giá trị hợp lệ cho board_model:
100Bo mạch mở rộng GPIO XB-100
200Bảng mở rộng bộ chuyển đổi XB-200 LF/MF/HF/VHF
300bo mạch khuếch đại XB-300
Các lệnh con phổ biến:
enableKích hoạt bo mạch mở rộng XB-100, XB-200 hoặc XB-300.
Các tiểu ban của XB-200:
filter [rx|tx] [50|144|222|custom|auto_1db|auto_3db]Chọn bộ lọc RX hoặc TX được chỉ định trên bo mạch XB-200. Dưới đây là mô tả của từng tùy chọn bộ lọc:
Chọn bộ lọc 50-54 MHz (băng tần 6 mét).
Chọn bộ lọc 144-148 MHz (băng tần 2 mét).
Chọn bộ lọc 222-225 MHz (băng tần 1,25 mét). Thực tế, tùy chọn bộ lọc này thực sự rộng hơn một chút, bao gồm 206 MHz - 235 MHz.
Chọn đường dẫn bộ lọc tùy chỉnh. Người dùng nên kết nối bộ lọc dọc theo các kết nối FILT và FILT-ANT tương ứng khi sử dụng tùy chọn này. Ngoài ra, người ta có thể nhảy các kết nối FILT và FILT-ANT để đạt được "không có bộ lọc" để tiếp nhận. (Tuy nhiên, đây là _rất_ không khuyến khích việc truyền tải.)
Tự động chọn một trong các lựa chọn trên dựa trên tần số và điểm 1dB của bộ lọc. Đường dẫn tùy chỉnh được sử dụng cho các trường hợp không được liên kết với các bộ lọc tích hợp.
Tự động chọn một trong các lựa chọn trên dựa trên tần số và điểm 3dB của bộ lọc. Đường dẫn tùy chỉnh được sử dụng cho các trường hợp không được liên kết với các bộ lọc tích hợp.
Các tiểu ban của XB-300:
<pa|lna|aux> [on|off]Bật hoặc tắt bộ khuếch đại công suất (PA), bộ khuếch đại tạp âm thấp (lna) hoặc LNA phụ trợ (aux). Trạng thái hiện tại nếu thiết bị được chỉ định được in nếu [bật|tắt] không được chỉ định.
Lưu ý: Theo mặc định, đường dẫn phụ trên XB-300 không được điền các thành phần; điều khiển aux sẽ không ảnh hưởng đến tín hiệu RX. Tùy chọn này có sẵn để người dùng sửa đổi bo mạch của họ bằng phần cứng tùy chỉnh.
<pwr>Đọc điện áp Phát hiện Nguồn (PDET) hiện tại và tính toán công suất đầu ra.
trx <rx|tx>Cấu hình phần cứng mặc định của XB-300 bao gồm các đường dẫn RX và TX riêng biệt. Tuy nhiên, người dùng chỉ muốn sử dụng một ăng-ten duy nhất cho TRX có thể làm như vậy thông qua sửa đổi tùy chọn mật độ điện trở trên XB-300 và sử dụng lệnh này để chuyển đổi giữa hoạt động của RX và TX. (Xem R8, R10 và R23 trên sơ đồ.)
Ví dụ:
Bật và định cấu hình bo mạch mở rộng bộ chuyển đổi XB-200:
xb 200 enableChọn bộ lọc nhận 144-148 MHz trên bo mạch mở rộng bộ chuyển đổi XB-200:
xb 200 filter rx 144Bật và định cấu hình việc sử dụng GPIO để tương tác với XB-300. PA và LNA sẽ bị tắt theo mặc định:
xb 300 enableBật RX LNA trên XB-300. LED D1 (màu xanh lục) sáng khi bật LNA và tắt khi tắt:
xb 300 lna onTắt TX PA trên XB-300. LED D2 (màu xanh lam) sáng khi PA được bật và tắt khi PA bị tắt:
xb 300 pa offCách sử dụng:
mimo [master | slave]Sửa đổi hoạt động MIMO của thiết bị.
QUAN TRỌNG: Lệnh này không được dùng nữa và đã được thay thế bằng "print/set smb_mode". Đối với văn bản sử dụng, hãy chạy: "set smb_mode"
Cách sử dụng:
open [device identifiers]Mở thiết bị được chỉ định để sử dụng bằng các lệnh liên tiếp. Mọi thiết bị đã mở trước đó sẽ bị đóng.
Dạng chung của chuỗi định danh thiết bị là:
<backend>:[device=<bus>:<addr>] [instance=<n>] [serial=<serial>]Xem tài liệu bladerf_open() trong libbladeRF để biết định dạng chỉ định thiết bị hoàn chỉnh.
Cách sử dụng:
peek <rfic|pll|dac|lms|si> <address> [num_addresses]Lệnh peek có thể đọc bất kỳ thiết bị nào treo ngoài FPGA. Điều này bao gồm:
bladeRF 1: Bộ thu phát LMS6002D, DAC cắt VCTCXO, bộ tạo xung nhịp Si5338
bladeRF 2: Bộ thu phát AD9361, DAC cắt VCTCXO, bộ tổng hợp tần số ADF4002
Nếu num_addresses được cung cấp, địa chỉ sẽ tăng thêm 1 và một lần xem trước khác được thực hiện cho nhiều địa chỉ đó.
Phạm vi địa chỉ hợp lệ:
Device Address Range
───────────────────────────
rfic 0 to 0x3F7 (1015)
pll 0 to 3
dac 0 to 255
lms 0 to 127
si 0 to 255Ví dụ:
peek si ...Cách sử dụng:
poke <rfic|pll|dac|lms|si> <address> <data>Lệnh poke có thể ghi bất kỳ thiết bị nào treo ngoài FPGA. Điều này bao gồm:
bladeRF 1: Bộ thu phát LMS6002D, DAC cắt VCTCXO, bộ tạo xung nhịp Si5338
bladeRF 2: Bộ thu phát AD9361, DAC cắt VCTCXO, bộ tổng hợp tần số ADF4002
Phạm vi địa chỉ hợp lệ:
Device Address Range
───────────────────────────
rfic 0 to 0x3F7 (1015)
pll 0 to 3
dac 0 to 255
lms 0 to 127
si 0 to 255Ví dụ:
poke lms ...Cách sử dụng:
print [parameter]Lệnh print lấy tham số để in. Các thông số có sẵn được liệt kê dưới đây. Nếu không có tham số nào được chỉ định, tất cả các tham số sẽ được in.
Các thông số phổ biến:
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 statusThông số chỉ dành cho BladeRF1:
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)Thông số chỉ dành cho BladeRF2:
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 selectionCách sử dụng:
probe [strict]Tìm kiếm thiết bị bladeRF được đính kèm và in danh sách kết quả.
Nếu không chỉ định strict, việc thiếu bất kỳ thiết bị khả dụng nào không được coi là lỗi.
Khi được cung cấp đối số strict tùy chọn, lệnh này sẽ xử lý tình huống không tìm thấy thiết bị nào là lỗi, khiến các tập lệnh hoặc danh sách lệnh được cung cấp qua đối số dòng lệnh -e chấm dứt ngay lập tức.
Cách sử dụng:
quitThoát CLI.
Cách sử dụng:
recover [<bus> <address> <firmware file>]Tải chương trình cơ sở vào thiết bị đang chạy ở chế độ bộ nạp khởi động hoặc liệt kê tất cả các thiết bị hiện đang ở chế độ bộ nạp khởi động.
Không có đối số, lệnh này liệt kê bus USB và địa chỉ cho các thiết bị dựa trên FX3 đang chạy ở chế độ bộ nạp khởi động.
Khi được cung cấp bus, địa chỉ và đường dẫn đến tệp chương trình cơ sở, thiết bị được chỉ định sẽ được tải và bắt đầu thực thi chương trình cơ sở được cung cấp.
Trong hầu hết các trường hợp, sau khi nạp thành công firmware vào RAM của thiết bị, người dùng nên mở thiết bị bằng lệnh "open" và ghi firmware vào flash qua "load fx3 "
Cách sử dụng:
run <script>Chạy tập lệnh được cung cấp.
Cách sử dụng:
rx <start | stop | wait | config [param=val [param=val [...]]>Nhận mẫu IQ và ghi vào file quy định. Tiếp nhận được kiểm soát và cấu hình bởi một trong những điều sau đây:
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.Chạy rx mà không có bất kỳ lệnh bổ sung nào là tốc ký hợp lệ cho rx config.
Lệnh wait nhận tham số timeout tùy chọn. Tham số này mặc định là đơn vị mili giây (ms). Đơn vị thời gian chờ có thể được chỉ định bằng các hậu tố ms hoặc s. Nếu tham số này không được cung cấp, lệnh sẽ đợi cho đến khi quá trình tiếp nhận hoàn tất hoặc Ctrl-C được nhấn.
Các tham số cấu hình có dạng param=value và có thể được chỉ định trong một hoặc nhiều lệnh gọi rx config. Dưới đây là danh sách các tham số có sẵn.
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 useVí dụ:
Nhận (10240=10 * 1024) mẫu, ghi chúng vào /tmp/data.bin ở định dạng DAC nhị phân.
rx config file=/tmp/data.bin format=bin n=10KNhận 32768 mẫu từ RX1 và RX2, xuất chúng thành tệp có tên mimo.csv, với bốn cột (RX1 I, RX1 Q, RX2 I, RX2 Q).
rx config file=mimo.csv format=csv n=32768 channel=1,2Ghi chú:
Các tham số n, samples, buffers và xfers hỗ trợ các hậu tố K, M và G, là bội số của 1024.
rx stop theo sau là rx start sẽ dẫn đến tệp mẫu bị cắt bớt. Nếu điều này không được mong muốn, hãy nhớ chạy rx config để đặt một tệp khác trước khi khởi động lại luồng rx.
Để có tỷ lệ mẫu cao hơn, bạn nên sử dụng định dạng đầu ra binary và tệp đầu ra được ghi vào RAM (ví dụ: /tmp, /dev/ shm), nếu không gian cho phép. Để chụp ảnh lớn hơn ở tốc độ lấy mẫu cao hơn, hãy cân nhắc sử dụng SSD thay vì HDD.
Định dạng CSV tạo ra hai cột trên mỗi kênh, với hai cột đầu tiên tương ứng với cặp I,Q cho kênh đầu tiên được định cấu hình bằng thông số channel; hai cột tiếp theo tương ứng với I,Q của kênh thứ hai, v.v.
Cách sử dụng:
trigger [<trigger> <tx | rx> [<off slave master fire>]]Nếu được sử dụng mà không có tham số, lệnh này sẽ in trạng thái của tất cả các trình kích hoạt. Khi và và được cung cấp, trình kích hoạt được chỉ định sẽ được in.
Dưới đây là các tùy chọn có sẵn cho:
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-independentLưu ý rằng cả ba tùy chọn trên ánh xạ tới cùng một cổng logic trên tất cả các thiết bị (mini_exp[1]). Nhiều tùy chọn được cung cấp để tương thích ngược và rõ ràng.
Trình kích hoạt được kiểm soát và định cấu hình bằng cách cung cấp đối số cuối cùng, có thể là một trong các đối số sau:
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.Chuỗi kích hoạt bao gồm một hoặc nhiều đơn vị bladeRF và có thể chứa các mô-đun TX và RX. Nếu sử dụng nhiều thiết bị bladeRF, chúng cần được kết nối thông qua tín hiệu được chỉ định bởi và một điểm chung.
Trình tự các lệnh sau đây nên được sử dụng để đảm bảo đồng bộ hóa phù hợp. Người ta cho rằng ban đầu tất cả các trình kích hoạt đều tắt.
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.
Định cấu hình tất cả các thiết bị khác làm nô lệ kích hoạt
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.
Kết thúc các tác vụ truyền và nhận như bình thường
Re-configure the master and slaves to clear fire requests and re-arm.
Steps 1 through 5 may be repeated as neccessary.
Vô hiệu hóa kích hoạt trên tất cả các nô lệ
Vô hiệu hóa kích hoạt trên master
Ghi chú:
Việc đồng bộ hóa máy phát và máy thu trên một chuỗi sẽ gây ra độ lệch 11 mẫu giữa TX và RX; những mẫu này nên được loại bỏ. Điều này là do độ dài đường ống xử lý khác nhau của TX và RX. Giá trị này có thể thay đổi nếu mã FPGA được cập nhật trong tương lai.
Cách sử dụng:
tx <start | stop | wait | config [parameters]>Đọc các mẫu IQ từ tệp được chỉ định và truyền chúng. Quá trình truyền được điều khiển và cấu hình bởi một trong những điều sau đây:
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.Chạy tx mà không có bất kỳ lệnh bổ sung nào là tốc ký hợp lệ cho tx config.
Lệnh wait nhận tham số timeout tùy chọn. Tham số này mặc định là đơn vị mili giây (ms). Đơn vị thời gian chờ có thể được chỉ định bằng các hậu tố ms hoặc s. Nếu tham số này không được cung cấp, lệnh sẽ đợi cho đến khi quá trình truyền hoàn tất hoặc Ctrl-C được nhấn.
Tham số cấu hình có dạng param=value và có thể được chỉ định trong một hoặc nhiều lệnh gọi tx config. Dưới đây là danh sách các thông số có sẵn.
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 useVí dụ:
Truyền nội dung của data.bin hai lần, với độ trễ ~250 mili giây giữa các lần truyền:
tx config file=data.bin format=bin repeat=2 delay=250000Truyền liên tục nội dung của mimo.csv, với kênh đầu tiên trong tệp được ánh xạ tới kênh TX1 và kênh thứ hai được ánh xạ tới TX2:
tx config file=mimo.csv format=csv repeat=0 channel=1,2Ghi chú:
Các tham số n, samples, buffers và xfers hỗ trợ các hậu tố K, M và G, là bội số của 1024.
Để có tốc độ lấy mẫu cao hơn, bạn nên lưu trữ tệp đầu vào trong RAM (ví dụ: /tmp, /dev/shm) hoặc trên SSD thay vì HDD.
Định dạng CSV yêu cầu hai cột trên mỗi kênh, với hai cột đầu tiên tương ứng với cặp I,Q cho kênh đầu tiên được định cấu hình bằng thông số channel; hai cột tiếp theo tương ứng với I,Q của kênh thứ hai, v.v. Ví dụ: trong ví dụ mimo.csv ở trên, -128,128,-256,256 sẽ truyền (-128,128) trên TX1 và (-256,256) trên TX2.
Khi cung cấp dữ liệu CSV, lệnh này trước tiên sẽ chuyển đổi nó sang định dạng nhị phân, được lưu trữ trong một tệp trong thư mục làm việc hiện tại. Trong quá trình này, các giá trị nằm ngoài phạm vi sẽ được kẹp lại.
Khi sử dụng định dạng nhị phân, người dùng chịu trách nhiệm đảm bảo rằng các giá trị dữ liệu được cung cấp nằm trong phạm vi cho phép. Điều kiện tiên quyết này làm giảm bớt sự cần thiết của chương trình này để thực hiện kiểm tra phạm vi trong các cuộc gọi lại nhạy cảm với thời gian.
Cách sử dụng:
set <parameter> <arguments>Lệnh set nhận một tham số và một số đối số tùy ý cho tham số cụ thể đó. Nói chung, set sẽ hiển thị thêm trợ giúp cho tham số đó.
Các thông số phổ biến:
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 settingsThông số chỉ dành cho BladeRF1:
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)Thông số chỉ dành cho BladeRF2:
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 selectionCách sử dụng:
versionIn thông tin phiên bản cho phần mềm máy chủ và thiết bị hiện tại.
Tải một hình ảnh FPGA có tên hostsx40.rbf lên FPGA của bladeRF:
bladeRF-cli -l hostedx40.rbf
Lưu ý: Hình ảnh FPGA được tải bằng --load-fpga sẽ bị mất khi tắt nguồn.
Flash firmware.img vào firmware của bladeRF:
bladeRF-cli -f firmware.img
Nhấp nháy hình ảnh FPGA có tên hostsx40.rbf lên bladeRF, nơi nó sẽ tự động được tải khi bật nguồn:
bladeRF-cli -L hostedx40.rbf
Tiện ích này được viết bởi những người đóng góp cho Dự án bladeRF. Xem tệp CONTRIBUTORS để biết thêm thông tin.
Lỗi có thể được báo cáo thông qua trình theo dõi vấn đề tại https://github.com/nuand/bladerf.
Bản quyền © 2013-2015 Nuand LLC.
Chương trình này là phần mềm miễn phí; bạn có thể phân phối lại và/hoặc sửa đổi nó theo các điều khoản của Giấy phép Công cộng GNU do Tổ chức Phần mềm Tự do xuất bản; phiên bản 2 của Giấy phép hoặc (tùy chọn của bạn) bất kỳ phiên bản nào mới hơn.
Chương trình này được phân phối với hy vọng rằng nó sẽ hữu ích, nhưng KHÔNG CÓ BẤT KỲ BẢO HÀNH NÀO; thậm chí không có bảo hành ngụ ý về KHẢ NĂNG BÁN ĐƯỢC hoặc SỰ PHÙ HỢP CHO MỘT MỤC ĐÍCH CỤ THỂ. Xem Giấy phép Công cộng GNU để biết thêm chi tiết.
Bạn đã nhận được một bản sao Giấy phép Công cộng GNU cùng với chương trình này; nếu không, hãy viết thư cho Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
More documentation is available at http://nuand.com/ and https://github.com/nuand/bladerf.