Sylphy
/
SEC_Warehouse
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
SEC_Warehouse/docs/unified-ble-flow.md

4.1 KiB
Raw Blame History

统一 BLE 连接与控制流程（ED713 / ED719）

1. 标准连接流程图（文字版）

  1. 初始化阶段
  • openBluetoothAdapter
  • 注册监听：onBluetoothAdapterStateChange、onBLEConnectionStateChange、onBLECharacteristicValueChange
  1. 搜索阶段
  • 优先过滤扫描：startBluetoothDevicesDiscovery({ services:[0x00F4] })
  • 超时无结果则无过滤兜底扫描
  • 选择目标设备 deviceId
  1. 连接与发现阶段
  • createBLEConnection(deviceId)
  • getBLEDeviceServices，定位服务 0x00F4
  • getBLEDeviceCharacteristics，识别 F401/F402/F403/F501/F301/F302
  • 订阅通知：notify(F301)=true、notify(F302)=true
  1. 标准业务阶段
  • 读取设备信息：read(F501)
  • 鉴权：write(F402, A7分包key)，监听 F301 状态码
  • 鉴权成功后进行功能操作：
    • WiFi 配网：write(F401, A7分包ssid|pass)
    • 控制命令：write(F403, [cmd])
    • 雷达数据：cmd=0xA1 开始、cmd=0xA2 停止，解析 F302
  1. 收尾阶段
  • 停止扫描 / 断开连接 / 关闭适配器
  • 清理监听器与状态

2. 目录结构

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. 核心流程代码示例

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。