# 软硬件架构总述（4.2寸墨水屏设备）

> 证据：docs/protocol.md、analysis/web/protocol-raw.md、analysis/apk/apk-analysis.md、docs/firmware-analysis.md（固件部分）

## 1. 系统全景

```
┌──────────────┐   BLE GATT   ┌──────────────────────┐   SPI   ┌─────────────┐
│ 上位机        │ ◄──────────► │ DA14585 (Cortex-M0)   │ ──────► │ 4.2" 墨水屏  │
│ Web/App/CLI  │              │ 固件 PP_da14585_4.2   │         │ 400x300 BWR │
└──────────────┘              └──────────────────────┘         └─────────────┘
```

- **SoC**：Dialog DA14585（ARM Cortex-M0，96KB SysRAM @0x07FC0000，外置 SPI Flash 存固件与图片）
- **屏**：4.2" 400×300 黑/白/红三色电子纸（1bpp 双平面：bw + red）
- **广播名**：`NRF-XXXXXX`（固件内模板字符串，地址后缀填充）

## 2. 软件生态（厂商）

| 组件 | 技术 | 云依赖 |
|---|---|---|
| Web 上位机 mspppclock.tech | Web Bluetooth JS | 激活 key_generator.php、固件 file_down.php（qicp.vip:8889） |
| Android App client-qbsg | Kotlin Compose Multiplatform + Rust native | qbsg.top 全家桶（激活/固件/字体/图库/社区/账号） |
| 固件 PP_da14585_4.2 | Dialog SDK（ble_app_profile 衍生） | 无（WiFi 天气功能经手机中继） |

两代协议并存：本设备固件属"平平"家族（Web 协议）；APK 另支持"扫地/轻舞/时光"家族（帧格式分叉，见 apk-analysis §g）。

## 3. BLE 协议架构（本设备）

双通道：
- **EPD 通道**（service 13187b10…/char 4b646063…）：图像块（`03|04`+`ff|00`+2B偏移+240B）、刷屏 `00xx/01`、小图结束 `AA`
- **RXTX 通道**（service 00001f10/char 00001f1f）：全部控制命令（dd 时间、e1xx 模式、EF 族、FB/e901/EA0x、倒计时族、E2 提交）+ notify（设备 ID 应答）
- **SUOTA**（service 0000fef5 + 5 自定义 UUID）：固件升级（protocol.md §9）

## 4. 图像数据流

图片 → 调整（亮度/对比度/饱和度）→ 抖动量化（6 算法 × 黑白/三色）→
1bpp MSB-first 行主序双平面（各 15000B）→ 240B 块 ×63×2 → `01` 刷新上屏。

## 5. 本项目交付物在架构中的位置

| 交付物 | 替代的厂商组件 | 去云效果 |
|---|---|---|
| `src/ppclock` CLI | Web 上位机 + App 全部设备功能 | 零网络（仅 BLE） |
| `tools/fw*.py` | file_down.php 固件分发 | 本地解析/修改/重打包 |
| `ppclock ota` | App 的 SUOTA 客户端 | 本地固件升级 |

详见 docs/protocol.md（协议规范）与 docs/firmware-analysis.md（固件 internals）。