125 lines
4.1 KiB
Markdown
125 lines
4.1 KiB
Markdown
# 统一 BLE 连接与控制流程（ED713 / ED719）
|
||
|
||
## 1. 标准连接流程图（文字版）
|
||
1. 初始化阶段
|
||
- `openBluetoothAdapter`
|
||
- 注册监听：`onBluetoothAdapterStateChange`、`onBLEConnectionStateChange`、`onBLECharacteristicValueChange`
|
||
|
||
2. 搜索阶段
|
||
- 优先过滤扫描：`startBluetoothDevicesDiscovery({ services:[0x00F4] })`
|
||
- 超时无结果则无过滤兜底扫描
|
||
- 选择目标设备 `deviceId`
|
||
|
||
3. 连接与发现阶段
|
||
- `createBLEConnection(deviceId)`
|
||
- `getBLEDeviceServices`，定位服务 `0x00F4`
|
||
- `getBLEDeviceCharacteristics`，识别 `F401/F402/F403/F501/F301/F302`
|
||
- 订阅通知：`notify(F301)=true`、`notify(F302)=true`
|
||
|
||
4. 标准业务阶段
|
||
- 读取设备信息：`read(F501)`
|
||
- 鉴权：`write(F402, A7分包key)`，监听 `F301` 状态码
|
||
- 鉴权成功后进行功能操作：
|
||
- WiFi 配网：`write(F401, A7分包ssid|pass)`
|
||
- 控制命令：`write(F403, [cmd])`
|
||
- 雷达数据：`cmd=0xA1` 开始、`cmd=0xA2` 停止，解析 `F302`
|
||
|
||
5. 收尾阶段
|
||
- 停止扫描 / 断开连接 / 关闭适配器
|
||
- 清理监听器与状态
|
||
|
||
## 2. 目录结构
|
||
```text
|
||
utils/ble/
|
||
core/
|
||
bleCore.js # 蓝牙核心能力（连接/发现/读写/订阅/重连）
|
||
controller.js # 标准流程编排（scan->connect->discover->auth）
|
||
errors.js # 统一异常
|
||
eventBus.js # 回调分发
|
||
packet.js # A7 分包工具
|
||
retry.js # 重试工具
|
||
state.js # 状态模型
|
||
modules/
|
||
auth.js # 鉴权流程（读MSG + 写KEY）
|
||
wifi.js # WiFi配置流程
|
||
radar.js # 雷达控制流程
|
||
parsers/
|
||
commonParser.js # MSG/STATE/雷达通用解析
|
||
index.js # 解析聚合出口
|
||
protocols/
|
||
profiles.js # ED713/ED719/UNKNOWN profile 差异配置
|
||
utils/
|
||
bytes.js # 字节/高低位工具
|
||
hex.js # hex/utf8 转换
|
||
uuid.js # UUID 标准化与比较
|
||
index.js # 统一出口
|
||
```
|
||
|
||
## 3. 公共方法列表
|
||
- 蓝牙核心
|
||
- `createBleCore(options)`
|
||
- `openAdapter/getAdapterState/closeAdapter`
|
||
- `startDiscovery/stopDiscovery`
|
||
- `connect/disconnect`
|
||
- `discoverServices/discoverCharacteristics`
|
||
- `readCharacteristic/writeCharacteristic/notifyCharacteristic`
|
||
- 流程编排
|
||
- `createUnifiedBleController(options)`
|
||
- `standardConnectFlow({ deviceId, key })`
|
||
- `scanAndPickDevice/connectAndDiscover/cleanup`
|
||
- 业务模块
|
||
- `createAuthModule(ble).ensureAuthorized(key)`
|
||
- `createWifiModule(ble).configureWifi(ssid, password)`
|
||
- `createRadarModule(ble).startRadarStream()/stopRadarStream()/writeFallParams()`
|
||
- 工具
|
||
- `buildA7Packets(payload, packetConfig)`
|
||
- `bytesToHex/hexToBytes/utf8ToBytes/bytesToUtf8`
|
||
- `splitToLowHigh/joinLowHigh/readUint16LE/readUint32LE`
|
||
- `normalizeUuid/toFullUuid/uuidEquals`
|
||
|
||
## 4. 核心流程代码示例
|
||
```js
|
||
import {
|
||
createUnifiedBleController,
|
||
DEVICE_PROFILE
|
||
} from '@/utils/ble'
|
||
|
||
const bleController = createUnifiedBleController({
|
||
profileId: DEVICE_PROFILE.UNKNOWN,
|
||
reconnect: { enabled: true, retries: 2, delay: 1000 }
|
||
})
|
||
|
||
async function runStandardFlow({ key, ssid, password }) {
|
||
try {
|
||
// 1) 连接 + 服务发现 + 自动订阅F301/F302 + 鉴权
|
||
const session = await bleController.standardConnectFlow({ key })
|
||
|
||
// 2) 读取设备信息（如需要可再次读取）
|
||
const info = await bleController.auth.readDeviceInfo()
|
||
|
||
// 3) WiFi 配置
|
||
const wifiResult = await bleController.wifi.configureWifi(ssid, password)
|
||
|
||
// 4) 雷达控制
|
||
await bleController.radar.startRadarStream()
|
||
|
||
return {
|
||
session,
|
||
info,
|
||
wifiResult
|
||
}
|
||
} finally {
|
||
// 页面退出或流程结束时清理
|
||
await bleController.cleanup()
|
||
}
|
||
}
|
||
```
|
||
|
||
## 5. ED713/ED719 兼容策略
|
||
- 相同 UUID 与鉴权主流程统一抽象。
|
||
- 差异通过 `profiles.js` 配置：
|
||
- `radar.notifySignature`: ED713=`0x7c`，ED719=`0x67`
|
||
- `cmd.supportsNarrowMode`: ED713=true
|
||
- `cmd.supportsFallParam67`: ED719=true
|
||
- 未知设备先用 `UNKNOWN`，收到 `F302` 数据后按签名字节自动识别 profile。
|