BladeRF-cli - 云端在线

程序：

您的姓名

BladeRF-cli - 命令行界面和测试实用程序

概要

刀片RF-cli

商品描述

刀片RF-cli 实用程序用于刷新固件文件、加载 FPGA 比特流和执行
nuand BladeRF 软件定义无线电系统上的其他任务。

有关获取或构建固件文件和 FPGA 比特流的更多信息，请
访问 http://nuand.com/.

BladeRF 命令行界面和测试实用程序 (1.3.1-0.2016.01~rc1-3)

配置

-d, - 设备
使用指定的bladeRF 设备。

-f, --flash-固件
将提供的 FX3 固件文件写入闪存。

-l, --加载fpga
加载提供的 FPGA 比特流。

-L, --flash-fpga
将提供的 FPGA 映像写入闪存以进行自动加载。 用 -L X或 --flash-fpga X
禁用 FPGA 自动加载。

-p, - 探测
探测设备，打印结果，然后退出。 非零返回状态将是
如果没有设备可用，则返回。

-e, --执行
执行指定的交互模式命令。 多种的 -e 标志可能是
指定的。 命令将按照提供的顺序执行。

-s, - 脚本
运行提供的脚本。

-i, - 交互的
进入交互模式。

--lib-版本
打印 libbladeRF 版本并退出。

-v, --冗长
设置 libbladeRF 详细级别。 级别，以递增的详细程度列出，是：

严重、错误、警告、
信息，调试，详细

- 版
打印 CLI 版本并退出。

-h, - 帮帮我
显示此帮助文本。

--help-交互式
打印所有交互式命令的帮助信息。

笔记：
-d 选项采用设备说明符字符串。 请参阅bladerf_open() 文档
有关此字符串格式的更多信息。

如果 -d 未提供参数，第一个可用设备将用于
提供的命令，或者将在进入交互模式之前打开。

命令按以下顺序执行：

命令行选项， -e 、脚本命令、交互模式命令。

从脚本或通过运行“rx/tx start”时 -e, 确保这些命令在以后
后跟 'rx/tx wait [timeout]' 以确保程序不会尝试退出
在接收/发送完成之前。

互动 指令

BladeRF-cli 支持可编写脚本的交互模式。 跑 刀片RF-cli - 交互的 至
进入这个模式。 类型 ”帮助" 获取所有命令的列表，或 "帮助 “更多
相关信息.

校准
用途：校准[选项]

执行指定的收发器校准操作。

可用操作：

· LMS 内部直流偏移自动校准

· 校准 lms [显示]

·校准lms调谐[值]

·校准lms txlpf [ ]

·校准lms rxlpf [ ]

·校准lms rxvga2 [ ]

执行指定的自动校准，如果没有提供，则执行所有自动校准。 什么时候
提供了值，这些值用于代替自动校准的结果
程序。 使用 lms show 读取和打印当前的 LMS 校准值。

对于 rxvga2，I1 和 Q1 分别是第 1 阶段的 I 和 Q 分量，I2 和 Q2 是
阶段 2 I 和 Q 组件。

· RX 和 TX I/Q 直流偏移校正参数校准

· 校准直流 [ ]

· 校准直流

校准当前频率和增益的 DC 偏移校正参数
设置。 如果提供了 I/Q 值，则直接应用它们。 cal rxtx 是
cal rx 后跟 cal tx 的简写。

· RX和TX I/Q平衡校正参数校准

·校准智商

设置指定的 IQ 增益或相位平衡参数。

· 生成RX或TX I/Q DC校正参数表

· 校准表直流[ [f_inc]]

生成 I/Q 校正参数表并写入当前工作目录，
在一个名为_直流_ .tbl。 f_min 和 f_max 是最小和最大频率
包括在表中。 f_inc 是频率增量。

默认情况下，表格是在整个频率范围内生成的，步长为 2 MHz。

清除
用法：清除

清除屏幕。

回音
用法：echo [arg 1] [arg 2] ... [arg n]

在新行上回显每个参数。

抹去
用法：擦除

擦除指定的擦除块 SPI 闪存。

· - 擦除块偏移

· - 要擦除的擦除块数

闪存备份
用法：flash_backup ( | )

将闪存数据备份到指定文件。 此命令需要两个或四个
论据。 通常建议将两个参数调用用于非开发用途。

参数：

· - 备份类型。

这将根据所选类型选择适当的地址和长度值。

有效的选项是：

选项说明
────────────────────────────────────────────────────── ────────────────────
cal 校准数据
固件
40 kLE FPGA 的 fpga40 元数据和比特流
115 kLE FPGA 的 fpga115 元数据和比特流

· - 要备份的数据地址。 必须擦除块对齐。

· - 要备份的区域长度。 必须擦除块对齐。

注意：当提供地址和长度时，图像类型将默认为原始。

例子：

· flash_backup cal.bin cal

备份校准数据区域。

· flash_backup cal_raw.bin 0x30000 0x10000

将校准区域备份为原始数据图像。

闪存图像
用法：flash_image [输出选项]

打印 Flash 图像的元数据或创建新的 Flash 图像。 当提供名称时
Flash 图像文件的唯一参数，此命令将打印元数据内容
图片。

以下选项可用于创建新的 Flash 映像。

· 数据=

包含要存储在图像中的数据的文件。

· 地址=

闪存地址。 默认值取决于类型参数。

· 类型=

Flash 图像的类型。 默认为原始。

有效的选项是：

选项说明
────────────────────────────────────────────────────── ────────────────────
cal 校准数据
固件
40 kLE FPGA 的 fpga40 元数据和比特流
115 kLE FPGA 的 fpga115 元数据和比特流
原始原始数据。 地址和长度参数必须是
如果选择此类型，则提供。

· 系列=

序列号存储在图像中。 默认为零。

闪存初始化校准
用法：flash_init_cal [ ]

创建一个新的校准数据区域并将其写入当前打开的设备，或写入
文件。 请务必在运行此命令之前备份校准数据。 （见
flash_backup 命令。）

·

40 或 115，具体取决于设备型号。

·

VCTCXO/DAC 调整值 (0x0-0xffff)

·

要写入校准数据的文件。 提供此参数时，将不会有任何数据
写入设备的闪存。

闪存恢复
用法：flash_restore [ ]

从文件恢复闪存数据，可选择覆盖图像元数据中的值。

·

默认为提供的闪存映像文件中指定的地址。

·

默认为提供的图像文件中的数据长度。

固件日志
用法：fw_log [文件名]

读取设备固件日志的内容并将其写入指定文件。 如果不
指定文件名，日志内容写入标准输出。

帮助
用法：帮助 [ ]

为任何命令提供扩展帮助，像这样。

info
用法：信息

打印有关打开的设备的以下信息：

· 序列号

· VCTCXO DAC校准值

· FPGA尺寸

· FPGA是否加载

· USB 总线、地址和速度

· 后端（表示正在使用哪个设备接口代码。）

· 实例编号

跳转到引导
用法：jump_to_boot

清除闪存中的固件签名并跳转到 FX3 引导加载程序。

设备将在电源循环后继续引导至 FX3 引导加载程序，直到新的
固件被写入设备。

加载
用法：加载

加载 FPGA 比特流或对 FX3 的 SPI 闪存进行编程。

xb
用法：xb [参数]

启用或配置扩展板。

board_model 的有效值：

·100

XB-100 GPIO 扩展板

·200

XB-200 LF/MF/HF/VHF 变频扩展板

常用子命令：

· 使能够

启用 XB-100 或 XB-200 扩展板。

XB-200 子命令：

· 过滤器 [rx|tx] [50|144|222|custom|auto_1db|auto_3db]

选择 XB-200 板上指定的 RX 或 TX 滤波器。 以下是对
每个过滤器选项。

·50

选择 50-54 MHz（6 米波段）滤波器。

·144

选择 144-148 MHz（2 米波段）滤波器。

·222

选择 222-225 MHz（1.25 米波段）滤波器。 实际上，
这个过滤器选项实际上稍宽，覆盖
206 MHz - 235 MHz。

· 风俗

选择自定义过滤器路径。 用户应连接过滤器
使用时沿相应的 FILT 和 FILT-ANT 连接
这个选项。 或者，可以跨接 FILT 和 FILT-ANT
连接以实现接收的“无过滤器”。 （然而，这是
_高度_不鼓励传输。）

· auto_1db

根据频率自动选择上述选项之一
和滤波器的 1dB 点。 自定义路径用于案例
与板载过滤器无关。

· auto_3db

根据频率自动选择上述选项之一
和滤波器的 3dB 点。 自定义路径用于案例
与板载过滤器无关。

例子：

· xb 200 启用

启用和配置 XB-200 转换器扩展板。

· xb 200 过滤器 RX 144

选择 XB-144 转换器扩展板上的 148-200 MHz 接收滤波器。

MIMO
用法：mimo [大师| 奴隶]

修改设备 MIMO 操作。

打开
用法：打开[设备标识符]

打开指定的设备以使用连续命令。 任何以前打开的设备
将被关闭。

设备标识符字符串的一般形式是：

:[设备= ： ] [实例= ] [序列= ]

有关完整的设备说明符，请参阅 libbladeRF 中的bladerf_open() 文档
格式。

窥视
用法：偷看[num_addresses]

peek 命令可以读取挂在 FPGA 上的任何设备，包括
LMS6002D 收发器、VCTCXO 微调 DAC 或 Si5338 时钟发生器芯片。

如果提供了 num_addresses，则地址加 1，然后再查看一次
对那么多地址执行。

有效地址范围：

设备地址范围
──────────────────────────
DAC 0 到 255

lms 0 到 127
0 到 255

示例：

·偷看...

戳
用法：戳

poke 命令可以写入挂在 FPGA 上的任何设备，包括
LMS6002D 收发器、VCTCXO 微调 DAC 或 Si5338 时钟发生器芯片。

有效地址范围：

设备地址范围
──────────────────────────
DAC 0 到 255
lms 0 到 127
0 到 255

示例：

·戳lms...

打印
用法：打印[参数]

打印命令需要一个参数来打印。 下面列出了可用的参数。 如果
未指定参数，打印所有参数。

参数说明
────────────────────────────────────────────────────── ────────────────────────
带宽 带宽设置
频率 频率设置
gpio FX3 <-> FPGA GPIO 状态
环回环回设置
lnagain RX LNA 的增益设置，单位为 dB
rx_mux FPGA RX FIFO 输入多路复用器设置
rxVGA1 RXVGA1 的增益设置，单位为 dB
rxVGA2 RXVGA2 的增益设置，单位为 dB
txvga1 TXVGA1 的增益设置，单位为 dB
txvga2 TXVGA2 的增益设置，单位为 dB
采样 外部或内部采样模式
采样率 采样率设置
trimdac VCTCXO 微调 DAC 设置
vctcxo_tamer 当前 VCTCXO 驯服模式。
xb_gpio 扩展板 GPIO 值
xb_gpio_dir 扩展板GPIO方向（1=输出，0=输入）

探测器
用法：探测 [严格]

搜索连接的bladeRF 设备并打印结果列表。

没有指定strict，缺少任何可用设备不被视为错误。

当提供可选的严格参数时，此命令将处理没有的情况
设备被发现为错误，导致通过 -e 提供的脚本或命令列表
立即终止的命令行参数。

退出
用法：退出

退出 CLI。

恢复
用法：恢复[ ]

将固件加载到以引导加载程序模式运行的设备上，或列出当前处于
引导加载程序模式。

此命令不带参数，列出基于 FX3 的设备的 USB 总线和地址
在引导加载程序模式下运行。

当提供总线、地址和固件文件的路径时，指定的设备将被
加载并开始执行提供的固件。

在大多数情况下，在成功将固件加载到设备的 RAM 后，用户应该
使用“open”命令打开设备，并通过以下方式将固件写入闪存
"加载 fx3 ”

运行
用法：运行

运行提供的脚本。

rx
用法：rx

接收 IQ 样本并将它们写入指定的文件。 接收被控制和
由以下之一配置：

命令说明
────────────────────────────────────────────────────── ────────────────────────
start 开始接收样品
停止 停止接收样品
wait 等待样品传输完成，或直到
经过指定的时间量
config 配置样本接收。 如果没有参数
提供，打印当前参数。

在没有任何附加命令的情况下运行 rx 是 rx 配置的有效简写。

wait 命令采用可选的超时参数。 此参数默认为单位
毫秒 (ms)。 超时单位可以使用 ms 或 s 后缀指定。 如果这
未提供参数，命令将等待接收完成或 Ctrl-C
被按下。

配置参数采用 param=value 形式，可以在单个或
多个 rx 配置调用。 下面是可用参数的列表。

参数说明
────────────────────────────────────────────────────── ────────────────────────
n 要接收的样本数。 0 = 信息。
文件 将接收到的样本写入的文件名
格式 输出文件格式。 以下之一：
csv：SC16 Q11 样品的 CSV
bin：原始 SC16 Q11 DAC 样本
samples 每个缓冲区中使用的样本数
异步流。 必须能被 1024 整除，并且
>= 1024。
buffers 在异步中使用的样本缓冲区数
溪流。 最小值为 4。
xfers 允许同时传输的数量
要使用的异步流。 这个应该少
比缓冲区参数。
timeout 数据流超时。 无后缀，默认
单位是毫秒。 默认值为 1000 毫秒（1 秒）。
有效的后缀是 ms 和 s。

示例：

· rx 配置文件=/tmp/data.bin 格式=bin n=10K

接收 (10240 = 10 * 1024) 个样本，将它们写入二进制 DAC 中的 /tmp/data.bin
格式。

笔记：

· n、samples、buffers和xfers参数支持后缀K、M和G，
是 1024 的倍数。

· rx 停止和rx 启动将导致样本文件被截断。 如果
这是不需要的，请确保在重新启动之前运行 rx config 以设置另一个文件
接收流。

· 对于更高的采样率，建议使用二进制输出格式，并且
将输出文件写入 RAM（例如 / tmp目录, /开发/shm)，如果空间允许。 对于更大的
以更高的采样率捕获，请考虑使用 SSD 而不是 HDD。

tx
用法：tx

从指定文件中读取 IQ 样本并传输它们。 传输被控制和
由以下之一配置：

命令说明
────────────────────────────────────────────────────── ────────────────────────
start 开始传输样本
停止 停止传输样本
wait 等待样品传输完成，或直到
经过指定的时间量
config 配置样本传输。 如果没有参数
提供，打印当前参数。

在没有任何附加命令的情况下运行 tx 是 tx 配置的有效简写。

wait 命令采用可选的超时参数。 此参数默认为单位
毫秒 (ms)。 超时单位可以使用 ms 或 s 后缀指定。 如果这
未提供参数，命令将等待传输完成或
按下 Ctrl-C。

配置参数采用 param=value 形式，可以在单个或
多个 tx 配置调用。 下面是可用参数的列表。

参数说明
────────────────────────────────────────────────────── ────────────────────────
文件 从中读取样本的文件名
format 输入文件格式。 以下之一：
csv：SC16 Q11 样本的 CSV ([-2048, 2047])
bin：原始 SC16 Q11 DAC 样本 ([-2048, 2047])
重复文件内容应该重复的次数
传送。 0 表示重复直到停止。
delay 之间延迟的微秒数
重传文件内容。 0 表示没有延迟。
samples 每个缓冲区中使用的样本数
异步流。 必须能被 1024 整除，并且
>= 1024。
buffers 在异步中使用的样本缓冲区数
溪流。 最小值为 4。
xfers 允许同时传输的数量
要使用的异步流。 这应该是 <
缓冲区参数。
timeout 数据流超时。 无后缀，默认
单位是毫秒。 默认值为 1000 毫秒（1 秒）。
有效的后缀是“ms”和“s”。

示例：

· tx 配置文件=data.bin 格式=bin 重复=2 延迟=250000

两次传输 data.bin 的内容，中间有约 250 毫秒的延迟
传输。

笔记：

· n、samples、buffers和xfers参数支持后缀K、M和G，
是 1024 的倍数。

· 对于更高的采样率，建议将输入文件存储在 RAM 中（例如 / tmp目录,
/开发/shm) 或在 SSD 上，而不是在 HDD 上。

· 当提供CSV数据时，该命令会先将其转换为二进制格式，存储
在当前工作目录的一个文件中。 在此过程中，超出范围的值
会被夹住。

· 当使用二进制格式时，用户有责任确保提供的数据
值在允许范围内。 这个先决条件减轻了对这个的需要
在时间敏感的回调中执行范围检查的程序。

集
用法：设置

set 命令接受一个参数和该特定参数的任意数量的参数
范围。 该参数是以下之一：

参数说明
────────────────────────────────────────────────────── ────────────────────────
带宽 带宽设置
频率 频率设置
gpio FX3 <-> FPGA GPIO 状态
环回 环回设置。 运行“set loopback”以列出模式。
lnagain RX LNA 的增益设置，单位为 dB。 值：0、3、6
rxVGA1 RXVGA1 的增益设置，单位为 dB。 范围：[5, 30]
rx_mux FPGA RX FIFO 输入复用模式。 选项是：
基带_LMS、12BIT_COUNTER、32BIT_COUNTER、
数字环回
rxVGA1 RXVGA1 的增益设置，单位为 dB。 范围：[5, 30]
rxVGA2 RXVGA2 的增益设置，单位为 dB。 范围：[0, 30]
txvga1 TXVGA1 的增益设置，单位为 dB。 范围：[-35, -4]
txvga2 TXVGA2 的增益设置，单位为 dB。 范围：[0, 25]
采样 外部或内部采样模式
采样率 采样率设置
trimdac VCTCXO 微调 DAC 设置
vctcxo_tamer VCTCXO 驯服模式。 选项：禁用、1PPS、10MHz
xb_gpio 扩展板 GPIO 值
xb_gpio_dir 扩展板GPIO方向（1=输出，0=输入）

版本
用法：版本

打印主机软件和当前设备的版本信息。

示例

$ BladeRF-cli -l hostsx40.rbf

将名为hostedx40.rbf 的FPGA 映像加载到bladeRF 的FPGA 上。

备注: 使用 --load-fpga 加载的 FPGA 映像将在断电时丢失。

$ BladeRF-cli -f 固件.img

将firmware.img 刷写到bladeRF 的固件上。

$刀片RF-cli -L托管x40.rbf

将名为 hostsx40.rbf 的 FPGA 映像刷写到 BladeRF 上
上电时自动加载。

使用 onworks.net 服务在线使用 BladeRF-cli