统信uos使用ble外设需先确认硬件支持ble 4.0+、服务启用且hci就绪，再用bluetoothctl扫描连接及gatt交互；控制中心不支持ble底层操作，跳过基础检查会导致“no controller available”错误。
统信UOS系统使用蓝牙BLE低功耗外设需先确认硬件支持BLE 4.0+、服务已启用且HCI控制器就绪，再通过bluetoothctl命令行完成扫描、连接与GATT交互；控制中心图形界面不支持BLE设备的底层属性读写操作。
确认BLE硬件与服务基础就绪
这一步跳过会导致后续所有扫描命令返回“no controller available”或直接报错退出。UOS默认不自动加载BLE专用模块，必须验证hci0是否具备LE能力。
按Ctrl+Alt+T打开终端，执行：【hciconfig -a | grep -A 10 hci0】，观察输出中是否含“LE: Yes”字样；若无，说明当前蓝牙芯片不支持BLE或驱动未启用。
执行sudo systemctl status bluetooth，确认状态为active (running)；若非运行态，依次执行sudo systemctl enable bluetooth→sudo systemctl start bluetooth。
执行rfkill list，检查Bluetooth条目下Soft blocked是否为no；若是yes，运行sudo rfkill unblock bluetooth并重启服务。
使用bluetoothctl扫描并连接BLE设备
统信UOS控制中心无法识别BLE广播包，必须用命令行工具直连BlueZ协议栈。此方法适用于心率带、温湿度传感器、智能锁等仅支持BLE的外围设备。
在终端输入bluetoothctl进入交互环境。
依次执行以下指令（每行回车一次）：
power on
agent on
default-agent
scan on
一款AI开发辅助工具，主要用于从 AI 编程会话日志（Clawdbot、Claude Code、Codex）中提取对话记录。该功能用于在用户要求导出提示词历史、会话日志或 `.jsonl` 格式的会话文件时使用，适合需要提升相关任务效率的用户。
等待约10秒，观察输出中是否出现目标设备名称及MAC地址（如XX:XX:XX:XX:XX:XX），且类型标注为[LE]；若长时间无响应，可尝试执行pairable on后再scan on。
看到目标设备后，输入connect XX:XX:XX:XX:XX:XX建立连接；若提示“Connection refused”，说明设备未处于可连接广播态，请按说明书长按配对键重置广播模式。
通过gatttool读取BLE服务与特征值（可选）
该步骤用于调试传感器类BLE外设，例如读取温度计当前数值或手环电池电量。注意：gatttool已在新版BlueZ中弃用，但UOS 2023/2024版本仍预装可用。
连接成功后，另开一个终端窗口，执行gatttool -b XX:XX:XX:XX:XX:XX -I进入交互模式。
输入connect回车，确认连接状态为“Connection successful”。
输入primary回车，列出所有GATT服务UUID；常见健康设备服务UUID为0000180d-0000-1000-8000-00805f9b34fb（Heart Rate Service）。
输入characteristics回车，查看该服务下所有可读/可写特征值；若某特征值属性含“read”，则输入char-read-hnd 0x000f（句柄号以实际输出为准）尝试读取原始数据。
读出的十六进制值需按设备规范解析——例如心率服务中，首字节为标志位，第二字节即为当前心率数值（十进制）。
