Skip to main content
通过 Lager CLI 扫描低功耗蓝牙（BLE）设备并与之交互。

​
语法

​
命令

​
命令参考

​
scan

扫描附近的 BLE 设备。
选项：
  • --box BOX - Lager Box 名称或 IP 地址
  • --timeout FLOAT - 扫描时长，单位秒（默认 5.0）
  • --name-contains STRING - 按名称过滤设备（部分匹配）
  • --name-exact STRING - 按名称精确匹配过滤设备
  • --verbose - 在输出中包含 UUID
示例：

​
info

获取某台 BLE 设备的详细信息。
参数：
  • ADDRESS - BLE 设备地址（例如 AA:BB:CC:DD:EE:FF）
返回的设备信息包括：
  • 设备名称
  • 服务和特征
  • 厂商数据

​
connect

连接一台 BLE 设备。
参数：
  • ADDRESS - 要连接的 BLE 设备地址

​
disconnect

断开与一台 BLE 设备的连接。
参数：
  • ADDRESS - 要断开的 BLE 设备地址

​
示例

​
输出格式

​
扫描结果

scan 命令返回一个表格，包含：
  • 设备地址（MAC 地址格式）
  • 设备名称（如果设备广播了名称）
  • RSSI（信号强度，单位 dBm）
  • 厂商数据（如果有）

​
设备信息

info 命令显示：
  • 完整的设备名称
  • 广播的全部服务（UUID）
  • 每个服务的特征
  • 读/写/通知属性

​
使用场景

​
设备发现

用 BLE 扫描发现被测设备：

​
自动化测试

把 BLE 操作集成到测试脚本中：

​
说明

  • BLE 扫描需要 Box 上有蓝牙硬件
  • 地址格式为 XX:XX:XX:XX:XX:XX（用冒号分隔的十六进制）
  • 扫描超时时间决定 Box 搜索设备的时长
  • 有些设备在连接之前不广播自己的名称