docs(plan): 采集链与上送链台架联调分工
新增 docs/任务规划/分工说明-20261028-采集链与上送链联调.md(45 行):
只分工不改行为。A 线走采集链 L1→L2→L2.5,B 线走上送链 L2.5→104/UI,
两条线各自验收后合并,不交叉编辑对方文件。
- A 线交付:App/algo/README.md 补「快照时序」一节;adc_input 主机单测
增帧序号回绕与双缓冲半帧两个用例;ADC采样节拍说明 §5 按实测节拍回填。
- B 线交付:meas 双区快照的单写者与多读者一致性说明;ui_data 补陈旧
代次(generation)用例;新增 .c 时双端注册 Keil 工程与 CMakeLists。
- 禁区写进正文:CODE-RULE-20 禁 C 库堆分配、V0.1 禁跨转换器做相位与
功率运算、layer-deps 不许 BSP 反依赖 App、UI 源文件带 BOM 须原样补回。
- 验收表:台架一次烧录须 -Rst -Run 并回读校验(No difference found),
串口日志不得出现 [ERR]——四个 Fault 的崩溃日志都以它开头。
随笔修一处:正文第 31 行举例引用的 §4.2 在目标文档里已不存在,改指现有
小节 §10.1,否则 doc-links 门禁拦提交(编码 BOM、LF 与乱码均无变化)。
本笔只动这一份文档,代码与门禁配置零改动;上一笔 94b0d790 的页面接线与
任务卡号清退不在本笔内,其未做的六页真机判据已登记在登记簿 §7。
另记一笔待办:文中写的 MDK-ARM/STM32F4-Base.uvprojx 与实际工程文件名
(STM32F407-Demo.uvprojx)不符,留给该线负责人校正,本笔不代改。
This commit is contained in:
@@ -0,0 +1,44 @@
|
||||
# 分工说明:采集链与上送链台架联调(2026-10-28)
|
||||
|
||||
**目标**:把 **L1→L2→L2.5** 取数链与 **L2.5→104/UI** 上送链在同一次台架烧录里对齐,提交门禁 **0 错误 0 警告**。
|
||||
**口径**:本文件只分工,不改行为;任何一条线单独验收通过后合并,**不交叉编辑**对方文件。
|
||||
|
||||
## A 线 · 采集链(负责人 A)
|
||||
|
||||
- **涉及文件**:`App/algo/adc_input.c`、`App/algo/adc_health.c`、`App/algo/sample_ring.c`、`App/algo/phasor.c`、`Src/freertos.c`(**只写 `USER CODE` 区**)
|
||||
- **交付物**:
|
||||
1. `App/algo/README.md` 补 **「快照时序」** 一节:`tpafe5160_snapshot()` 临界区原子性、`adc_tick_irq_notify()` 的「消费者就绪」门(TIM3 比调度器早 ≈100 ms);
|
||||
2. `test/host/adc_input/run_unit_test.py` 增加 **帧序号回绕** 与 **双缓冲半帧** 两个用例;
|
||||
3. `docs/子系统设计/ADC采样节拍设计说明.md` §5 表格与代码实际节拍(**TIM3 PSC 83 / ARR 999 → 1 kHz + TRGO_UPDATE**)核对后回填差异。
|
||||
- **禁止**:`malloc/calloc/realloc/strdup/free`(门禁 CODE-RULE-20);跨转换器做 **相位/功率/功率因数** 运算(V0.1 硬件缺陷);`Drivers/BSP/` 里 include `App/` 的头(`layer-deps`)。
|
||||
- **取数只用** `adc_input_poll()` / `adc_input_raw()` **按语义**取值,**不写死下标**(`buf[2]=IA`、`buf[5]=UN`、`buf[6]=UA` 见 `docs/硬件平台/ADC通道映射说明.md`)。
|
||||
|
||||
## B 线 · 上送链(负责人 B)
|
||||
|
||||
- **涉及文件**:`App/algo/meas.c`、`App/task/iec104_task.c`、`Drivers/BSP/UI/ui_data.c`(**带 UTF-8 BOM:改完核对 `EF BB BF`**)、`test/host/meas/run_unit_test.py`
|
||||
- **交付物**:
|
||||
1. `App/algo/meas.c` 的 **200 ms 双区快照** 写一个 **单写者/多读者** 一致性说明,落到 `docs/架构设计/项目架构总览.md` 的跨层依赖表;
|
||||
2. `Drivers/BSP/UI/ui_data.c` 与 104 上送 **共用同一份上游**:补 `test/host/ui_data/run_unit_test.py` 的 **陈旧代次(generation)** 用例;
|
||||
3. 若新增 `.c`:`MDK-ARM/STM32F4-Base.uvprojx` + `simulator/CMakeLists.txt` **双端注册**(`new-source-file`)。
|
||||
- **禁止**:直接编辑 `Drivers/BSP/UI/` 之外的 `Src/`、`Inc/` 标记区外内容;把 `*.uvprojx` 的 UV4 抖动改动入库;改 `Lib/lv_conf.h` 不同步 `simulator/` 那份(`lv-conf-sync`)。
|
||||
- **UI 侧铁律**:字符串字面量 **纯 ASCII**,中文只进注释;注释里写路径 **不要出现星号形态**(`nested-comment` 9-D),写目录或用尖括号。
|
||||
|
||||
## 共用约束(A/B 都要守)
|
||||
|
||||
- 改代码/改文档 **只用 Edit 精确替换**;**绝不**用 `Get-Content`/`Set-Content`/`cmd` 重写含中文的文件(`U+FFFD` 不可逆)。
|
||||
- 行尾 **LF**(`.gitattributes` 已写死 `* text=auto eol=lf`);怀疑乱码先数 `EF BF BD` 字节,**不要 `git checkout`**。
|
||||
- 门禁只在 **提交时** 统一跑:`@build` + `& '.venv\Scripts\python.exe' scripts/ci_local.py` + `check_doc_links.py --all`;**不要中途反复跑**。
|
||||
- 文档引用章节 **紧邻写法**:`docs/算法/采集与算法层设计说明.md` §10.1;改名/挪目录走 `scripts/rename_ref.py`(先 dry-run)。
|
||||
- `git commit` / `git push` / 烧录 / `CubeMX` 重生成 / 抬栈 —— **须用户明确指示**(抬栈前后各跑 `scripts/stack_report.py`)。
|
||||
|
||||
## 验收(合并前)
|
||||
|
||||
| 线 | 判据 | 证据 |
|
||||
|---|---|---|
|
||||
| A | L1 有效性→L2 相量 与 1 kHz 节拍一致,无半帧 | `test/host/adc_input` 全绿 + `docs/子系统设计/ADC采样节拍设计说明.md` |
|
||||
| B | `meas` 双区 **104 与 UI 同源**,无撕裂 | `test/host/meas`、`test/host/ui_data` 全绿 + `docs/编号规范.md` 无新撞号 |
|
||||
| A+B | 台架一次烧录 **`-Rst -Run` + 回读校验**(`No difference found`),串口日志无 `[ERR]` | `@test` 报告 + `MDK-ARM/build_log.txt` |
|
||||
|
||||
## 交接
|
||||
|
||||
- 两条线各自 **只回报:改了哪些文件、跑了哪些自检、剩余风险**;跨线接口(`meas` 快照字段)变更 **先在本文件登记**再动手。
|
||||
Reference in New Issue
Block a user