用途:在 macOS 终端中对蓝牙低功耗设备执行扫描、连接、配对、读写特征与描述符、查看 GATT 数据库、打开 L2CAP 通道等操作。
安装:brew install kylebrowning/tap/ble;或 mint install kylebrowning/BLESwiftCLI;或从源码 swift build -c release 后复制 .build/release/ble 到 /usr/local/bin/。首次运行需在系统设置→隐私与安全性→蓝牙中为终端授予权限。
主要能力:ble scan 扫描设备,支持 -s 按服务过滤、--timeout、--allow-duplicates、--min-rssi、--json;ble connect 按 UUID 或名称子串连接,支持 --reconnect;ble pair 通过访问需加密的特征触发配对;ble inspect 枚举服务、特征与描述符,可加 --read、--json;ble read 读取特征或描述符,--notify 订阅通知,--count 限制条数;ble write 支持 --hex、--string、-p 载荷文件、--expect-reply-on、--dry-run;ble l2cap 打开面向连接的 L2CAP 通道,支持 --psm、--send-hex、--raw。载荷文件为 YAML/JSON,字段按顺序编码,支持 u8/u16/u32/u64、i8/i16/i32/i64、大小端、string、hex、pad 等类型。
使用方式:连接仅在进程运行期间保持,Ctrl-C 或进程退出即断开;数据输出到 stdout,状态与进度输出到 stderr;管道输出自动禁用颜色并切换为逐行输出;NO_COLOR 可禁用彩色;扫描默认超时 10 秒,连接默认 30 秒,可用 --timeout 覆盖。
限制:CoreBluetooth 无显式配对 API,配对需访问受保护特征触发;写入超过 MTU 时工具仅警告不会自动拆分;取消配对需在系统设置中“忽略此设备”;部分设备一次只与一个主机绑定。
适用场景:BLE 设备调试、GATT 探索、自动化脚本与测试。测试可使用 swift test,无需硬件。