不被阻塞的开发计划¶

原则： 硬件还没到不代表无事可做。以下是所有**现在就能启动**的工作。

🔑 依赖分析总图¶

硬件到货（1-2周）          硬件验证（2-4周）
    │                          │
    ▼                          ▼
┌─────────┐              ┌──────────┐
│ 实物开发 │◄────阻塞──── │ 硬件采购 │
│ (Day1-28)│              │ (到货前)  │
└─────────┘              └──────────┘
    ▲                          │
    │                          │ 不被阻塞 ↓
    │                    ┌──────────────┐
    └────不依赖硬件────── │ 现在就能做的工作 │
                         └──────────────┘

1️⃣ Phase 1 — 现在能做的固件工作（¥0 成本）¶

硬件到货前，先把代码框架搭好，到货直接烧录验证

1.1 搭建固件工程骨架 ✅ 立即执行¶

步骤	产出	预计工时	依赖
1. 创建 firmware/ 目录结构	完整的 .c/.h 骨架	2h	无
2. 创建 CMakeLists.txt + west.yml	可编译的构建系统	1h	无
3. 创建 prj.conf + 设备树覆盖	芯片引脚配置	1h	芯片数据手册
4. 各模块函数声明 + 注释	5 个模块的 API 接口定义	2h	无
5. 验证编译环境	确认工具链可工作	1h	无

具体模块骨架： - main.c — 主入口、模块初始化流程 - ble.c/h — BLE 广播、配对回调、特征值声明 - audio.c/h — I2S 配置、音量控制接口 - touch.c/h — GPIO 中断、消抖逻辑 - battery.c/h — ADC 读取、百分比映射

关键： 不需要硬件，代码就能写 + 编译。

1.2 创建 BLE 协议文档 ✅ 立即执行¶

步骤	产出	预计工时
1. 定义 BLE Service UUID 表	完整的协议表格	1h
2. 定义每个 Characteristic 的用途/格式	通信协议规范	1h
3. 写入 `docs/ble-protocol.md`	可执行的协议文档	1h

BLE Service 规划草案： | Service | UUID | 用途 | |---------|------|------| | 设备信息 | 0x180A | 设备名称、版本 | | 电池服务 | 0x180F | 电量通知 | | 自定义控制 | 0xFEE0 | 触控命令、音量、EQ | | OTA 服务 | 0xFEE1 | 固件升级（阶段 3） |

1.3 创建固件编译 Skill ✅ 立即执行¶

等编译环境第一次成功运行后，创建 tws-firmware-build skill：

把编译流程保存为 skill:
- 工具链路径
- 编译命令
- 常见错误处理
- 烧录命令

4️⃣ Phase 4 — 现在能做的产线+认证准备（¥0 成本）¶

认证文档和产测脚本不需要硬件，现在就可以准备

4.1 认证文档准备 ✅ 立即执行¶

文档	优先级	预计工时	说明
BQB 认证资料清单	⭐⭐⭐	1h	联系杰理代理确认 QDID 继承
SRRC 认证资料清单	⭐⭐⭐	1h	中国强制认证，提前准备节省时间
CE/FCC 资料模板	⭐⭐	2h	欧洲/美国市场需要
质检报告资料清单	⭐⭐	1h	电商上架需要

立即可以打一个电话/发一个消息的事：

联系杰理代理 → 确认 AC7002 是否有现成 BQB → 能否走 Listing 继承 → 能省多少钱

4.2 产线工具脚本 ✅ 立即执行¶

以下产测工具**不需要硬件**就能写框架和测试逻辑

工具	语言	现在能写什么	预计工时
`ble-rf-tester`	Python (bleak)	BLE 扫描、连接、RSSI 读取的基类	3h
`sn-burner`	Python + FTDI	SN 编码规则、SQLite 数据库、API 接口	3h
`pairing-station`	Python	配对逻辑框架、SQLite 记录	2h
`func-tester`	Python	测试用例框架、PASS/FAIL 逻辑	2h

产线工具目录结构：

factory-tools/
├── ble-rf-tester/          # BLE 射频测试
│   ├── README.md
│   ├── requirements.txt
│   └── main.py              # BLE 扫描/连接/测试类
├── sn-burner/               # SN 管理系统
│   ├── README.md
│   ├── server/
│   │   ├── app.py           # FastAPI 服务
│   │   ├── models.py        # SN 数据库模型
│   │   └── sn_schema.sql    # 数据库表
│   └── client/
│       └── burner.py        # 烧录客户端
├── pairing-station/         # 左右耳配对
│   ├── README.md
│   └── main.py
└── func-tester/             # 整机测试
    ├── README.md
    └── main.py

4.3 SN 管理系统设计 ✅ 立即执行¶

任务	产出
1. 定义 SN 编码规则	`TWS-2026-XXXXX-ABCD`
2. 设计数据库表	SN 分配/绑定/追溯
3. 后端 API 骨架	分配/绑定/查询 API
4. 产线烧录客户端骨架	串口通信 + 烧录逻辑

4.4 CI/CD 基础设置 ✅ 立即执行¶

这其实是 Phase 5 的内容，但现在是建立的好时机

任务	产出
1. 初始化 git 仓库	所有代码入仓
2. 设置 Git Workflow	main/develop/feature 分支策略
3. 设置固件每日编译	最早发现问题
4. 创建 release 标签策略	v0.x 标签规范

📅 时间线（硬件到货前 1-2 周）¶

第1天 ── 搭建固件骨架 + BLE 协议文档
         （代码框架、编译验证）

第2天 ── 认证文档准备 + 联系杰理代理
         （BQB 继承确认 + 资料清单）

第3-4天 ── 产测工具骨架
           （ble-rf-tester、sn-burner 框架）

第5天 ── SN 管理系统
         （数据库 + API + 烧录客户端）

第6-7天 ── CI/CD + 文档收尾
           （git 工作流、编译 cronjob）

     ↓  硬件到货（预计 1-2 周后）

第8天起 ── 实物开发：烧录例程 → 点灯 → BLE → 音频...

✅ 执行跟踪¶

Phase 1 不被阻塞项¶

创建 firmware/ 工程骨架（main.c + 各模块 .c/.h）
创建 CMakeLists.txt + west.yml（可编译）
创建 BLE 协议文档 docs/ble-protocol.md
创建固件编译 Skill tws-firmware-build
验证编译环境可用

Phase 4 不被阻塞项¶

联系杰理代理确认 BQB 继承
创建认证文档清单（docs/certification/）
创建 factory-tools/ 目录结构
编写 ble-rf-tester 基类框架
编写 sn-burner 完整系统（数据库+API+客户端）
编写 pairing-station 逻辑框架
初始化 git + 设置分支策略
设置固件每日编译 cronjob

生成：2026-05-17 | 基于 Phase 1 + Phase 4 不被阻塞工作的并行执行计划