78 lines
5.5 KiB
Markdown
78 lines
5.5 KiB
Markdown
# 修改记录 2026-09-02：母乳杯（CAIIC-MCM）蓝牙改造
|
||
|
||
将原充电桩 App 改造为母乳杯设备 App：通过蓝牙显示设备参数（温度、风扇转速）、
|
||
查询设备系统运行状态、本地固件文件经 BLE OTA 升级设备。
|
||
设备协议依据 `D:\caic-workspace\mothercup\mcm-ddc-04\docs\ble_protocol.md`（CAIIC BLE 通信协议 V1.0）。
|
||
|
||
## 协议要点（设备侧已实现）
|
||
|
||
- GATT：Service `0000CA10-CA11-4B11-8000-CA11CA11CA11`，下行写特征 `...CA11...`
|
||
（**仅 Write Without Response**），上行 notify `...CA12...`；广播名 `CAIIC-MCM`；建议 MTU=247。
|
||
- 二进制帧（小端）：`[0xCA, TYPE, SEQ, LEN(u16), PAYLOAD, CRC16-CCITT(0x1021/初值0xFFFF)]`，
|
||
开销 7 字节，payload ≤480；一帧可跨多次 BLE 写入，设备按字节流重组。
|
||
- 帧类型：0x01 CLI_REQ / 0x02 CLI_RSP / 0x03 CLI_RSP_END；0x10 OTA_BEGIN /
|
||
0x11 OTA_DATA / 0x12 OTA_END / 0x1F OTA_RSP。
|
||
- OTA：双 bank 直写，设备 4KB 扇区缓冲，满扇区回 OTA_RSP(0x11) 作流控；status=2 按应答
|
||
offset 重发重同步；OTA_END 整镜像 CRC32（zlib/IEEE）校验通过后设备 200ms 自动复位切 bank。
|
||
|
||
## 新增文件
|
||
|
||
- `src/mcm/Crc.uts` — CRC16-CCITT 与 CRC32-IEEE（zlib）实现。注意 uts number 位运算按
|
||
32 位有符号处理，CRC32 中间值保持在 Int 范围、无符号右移用 `(x>>1)&0x7FFFFFFF`，
|
||
多项式用补码字面量 `-306674912`（0xEDB88320）。
|
||
- `src/mcm/FrameCodec.uts` — 帧常量、`encodeFrame` 组帧、`FrameDecoder` 字节流重组
|
||
（找 SOF → 头 → payload+CRC，错帧静默丢弃重找）、`pushU32LE/readU32LE`（纯算术实现，
|
||
避免大数值位运算符号问题）。
|
||
- `src/mcm/McmChannel.uts` — 连接级单例通道：`attach()` 挂全局 `bleData/bleState` 事件；
|
||
`sendFrame` 写队列串行化、整帧按 (att_mtu-3) 切片、写类型 WRITE_NO_RESPONSE；
|
||
`sendCli` CLI 命令透传串行执行（聚合 CLI_RSP 至 CLI_RSP_END，超时/断开兜底）；
|
||
OTA_RSP 转发给 OtaManager。所有 Promise 只 resolve 不 reject。
|
||
- `src/mcm/McmCommands.uts` — 业务命令：version/sysinfo/bankinfo/temp/fan，
|
||
命令名集中在顶部常量。**温度/风扇命令（默认 temp/fan）固件尚未实现，解析失败页面显示 `--`**。
|
||
- `src/mcm/OtaManager.uts` — OTA 状态机：BEGIN→按 4KB 扇区发 DATA 等 ack（流控/重同步）→END；
|
||
断连或 `abort()` 协作式中止；进度/状态回调。
|
||
- `pages/tabbar/sysStatus.uvue` — 系统状态页：version/bankinfo 概要 + sysinfo 原文控制台
|
||
（运行时间/任务数/heap/任务表），下拉刷新。
|
||
- `pages/tabbar/ota.uvue` — 固件升级页：手动输入本地 bin 路径（默认
|
||
`/sdcard/Download/embeddedSrc.bin`），UTS 直调 Android `java.io.File/FileInputStream`
|
||
读文件（`#ifdef APP-ANDROID`）；显示大小与 CRC32；输入目标版本号（如 1.00.02→0x010002）；
|
||
进度条 + 日志；升级期间禁止断连/退出，离开页面自动中止。
|
||
|
||
## 修改文件
|
||
|
||
- `src/BluetoothManager.uts` — 新增 `sendDataBytes(data, writeType, cb)`（显式写类型，
|
||
设备下行特征必须 writeType=1）与 `selectService(uuidPrefix)`（按服务 UUID 前缀
|
||
`0000CA10` 选择 service+notify+write 组合，规避自动识别选错）。
|
||
- `App.uvue` — `ConnectBle()` 在 scanServices 后先 `selectService("0000CA10")` 再订阅 notify；
|
||
`onLaunch` 调 `McmChannel.attach()`。
|
||
- `pages/tabbar/home.uvue` — 重写为设备主页：扫描（过滤 CAIIC-MCM）/连接/断开；
|
||
连接后温度、风扇转速每 2s 轮询显示，固件版本与运行 Bank 展示；notify 订阅成功
|
||
（bleData type=1000）后协商 MTU=247。
|
||
- `pages/tabbar/my.uvue` — 删除充电/离线行为入口（原已注释），启用"CLI 调试终端"入口。
|
||
- `pages/bleTest/bluetoothOperation.uvue` — 重写为 CLI 调试终端：inline 命令输入 +
|
||
应答文本流展示，复用全局 ConnectBle 连接流程。
|
||
- `pages.json` — tabbar 改为 设备/状态/升级/my 四 tab（图标复用 static/tabbar 现有资源）；
|
||
移除 charge/order 及全部充电页面注册。
|
||
- `manifest.json` — 应用名改为"母乳杯助手"；iOS 蓝牙用途文案改为母乳杯描述。
|
||
- `api/requestApi.uts` — 仅保留用户类接口（登录/注册/pinCode/修改资料），删除全部
|
||
OCPP 充电与蓝牙绑定分享接口。
|
||
- `api/responseData.uts` — 仅保留用户类响应类型。
|
||
|
||
## 删除
|
||
|
||
- 目录：`pages/startCharge/`、`pages/stopCharge/`、`pages/orderDetails/`、
|
||
`pages/offlineBehavior/`、`pages/tabbar/charge.uvue`、`pages/tabbar/order.uvue`、
|
||
`src/espBlufi/`（充电桩 JSON 分片协议，与 CAIIC 二进制帧协议不兼容）。
|
||
|
||
## 遗留事项
|
||
|
||
- **固件需新增温度/风扇 CLI 命令**（设备仓库 `D:\caic-workspace\mothercup`，
|
||
在 `cli_core.c` 命令表注册；当前 APP 侧默认命令名 `temp`/`fan`，定名不同改
|
||
`McmCommands.uts` 顶部常量即可）。
|
||
- **云端固件接口未接入**：本期为本地 bin 文件升级；`api/httpInstance.uts`（$http/token/
|
||
服务器切换）保留，后续按约定接口（查询最新版本 + 下载 URL）接入 ota 页。
|
||
- uni-app x 无 CLI 构建手段，需在 HBuilderX 编译并真机（Android）验证：
|
||
version/sysinfo/bankinfo 显示、temp/fan（待固件）、本地 bin OTA 后 bankinfo 确认切 bank。
|
||
- OTA 大数据量发送走 Write Without Response + 扇区级 ack 流控，若实测丢包导致
|
||
status=2 重同步频繁，可在 OtaManager 扇区内加小窗口节流。
|