diff --git a/docs/README.md b/docs/README.md index cb9e0584..a0ff3b20 100644 --- a/docs/README.md +++ b/docs/README.md @@ -158,7 +158,7 @@ docs/ |---|---| | [`ADC前端注入验证流程.md`](测试说明/专项验证/ADC前端注入验证流程.md) | **ADC 前端与两片转换器的台架注入验证**（已知电压注入验证的执行侧，实测证据 → `docs/硬件平台/ADC通道映射说明.md` §8.1）：注入点清单 / 期望码值表 / 零点·线性·映射·极性·节奏五步（每步自带现场记录表，边做边填）；**不需示波器与信号源**，一块万用表即可 | | [`启动日志原子性复验流程.md`](测试说明/专项验证/启动日志原子性复验流程.md) | **控制台整行独占 / 崩溃遗言原子性**这类**行级完整性**判据的固定动作与口径（`docs/子系统设计/控制台单写者日志设计说明.md` 的验收侧：那边讲怎么修，这边讲怎么证明修好了、以及为什么"标记全中"不等于"日志没坏"） | -| [`故障录波板级到场轮执行手册.md`](测试说明/专项验证/故障录波板级到场轮执行手册.md) | **录波剩余台架判据的执行手册**（判据属主是 `docs/子系统设计/故障录波设计说明.md` §10，这里只写"人做什么、说哪句话、会看到什么"）：四幕（枚举埋点修复 / 注量对表 / P 触发对时刻含两个用户决定 / bench 自抓占卷）各自标清到场与否，配到场检查清单、现场记录表与收工还原清单 | +| [`故障录波板级到场轮执行手册.md`](测试说明/专项验证/故障录波板级到场轮执行手册.md) | **录波剩余台架判据的执行手册**（判据属主是 `docs/子系统设计/故障录波设计说明.md` §10，这里只写"人做什么、说哪句话、会看到什么"）：四幕（枚举埋点修复 / 注量对表 / 保护触发对时刻（src=P）含两个用户决定 / bench 自抓占卷）各自标清到场与否，配到场检查清单、现场记录表与收工还原清单 | | [`链路延迟测试说明.md`](测试说明/专项验证/链路延迟测试说明.md) | 网络链路时延分段定义、判定基线、执行流程 | | [`模拟器差距清单.md`](测试说明/专项验证/模拟器差距清单.md) | **PC 模拟器 vs 真机差距登记册**（保护判据门禁可信度依据；改动涉及网络/日志/硬件层前必查 §3 决策规则） | | [`存储维护与容量恢复.md`](测试说明/专项验证/存储维护与容量恢复.md) | 全片擦除恢复 dhara 坏块记账 / 容量恢复 | diff --git a/docs/任务规划/README.md b/docs/任务规划/README.md index b59e27d0..f9b8f79f 100644 --- a/docs/任务规划/README.md +++ b/docs/任务规划/README.md @@ -66,7 +66,7 @@ | **6** | 保护元件与采集增强 | 等待标准源或硬件改版 | 保护先解除未标定闭锁；三相同时刻类功能等 V0.2 硬件 | | **7** | 验证窗口事项 | 逢条件顺带 | CI runner、PC peer、CH340、负向故障注入条件到位时执行 | | **8** | 独立模块与暂缓项 | 当前不排 | 开入开出、104 文件传输单独立项（SNTP 已单独立项并于 2026-11-04 落地 #73，:8888 随 #78 退役）；RS-485 与内存优化按各自重启条件 | -| **独立** | **故障录波（1 kHz · 8 路原始码值 · 单通道回放）** | **代码面已交付；2026-10-31 远程半轮过六项、2026-11-02 回放页枚举缺陷已修复闭环、2026-11-04 注量对表闭环（#40 §8 交流轮）、2026-11-06 第二幕尾步坏段/空态画面台架远程轮拍毕——回放页三态板级判据全部实证；余 P 触发（需标定解锁决定）、bench T 源与卷占用、`task_prof` 耗时峰值等到场/裁定项** | 用户裁定 2026-10-29 **录波先行**：数据面最小闭环 → 手动与保护启动触发 → 回放页。三块的**代码侧判据已收口**（主机单测 113 / 170 / 110 全 rc=0、双端编译 0 错误 0 警告、板端编码器与 PC 侧解码器字节级互验、手动录波与录波回放两叶已绑页、内容页黄金参考扩至 66 张）；**2026-10-31 远程半轮已过六项**（真 FAT 落盘、触发→落盘全部落在 2 s 封存超时窗内、冷却恢复、轮转、PC 侧坏段拒收、冻结窗内 104 并发）；同轮发现的缺陷「回放页段表枚举恒空」**已于 2026-11-02 远程修复并板级闭环**（根因 = 读侧 `wave_store_seg_path()` 返回值判错，顺带修键处理缺失效；回放页真段/切段/切道已实测，登记簿条目已销项，证据见设计说明 §10「回放页枚举恒空缺陷修复记录」）；**注量对表半轮已于 2026-11-04 由 #40 §8 交流轮闭环**（幅值 / 相位 / 削顶三项实测，`meas:` 行与板上读数逐项核对，104 浮点遥测按用户裁定不作对照证据；`docs/测试说明/测试数据/boot_log_data/20261104_ac_*`）；**回放页放坏段与空态画面已于 2026-11-06 台架远程轮拍毕闭环**（同号翻位覆盖→「该段不可读」零波形元素绝不平线；全删→「无录波段」+ 串口 `open fail fr=4` 互证；证据 `docs/测试说明/测试数据/wave_shot_20261106/`，记录见设计说明 §10「回放页坏段/空态画面闭环记录」）；**没跑的只剩** P 触发对时刻（先要标定解锁决定）/ bench T 源与卷占用（需 bench 构建）/ `task_prof` 读路径耗时峰值，全部结果与清单见 `docs/子系统设计/故障录波设计说明.md` §10「板级远程半轮记录」。**板级判据、留痕名清单与执行顺序图的属主 = docs/子系统设计/故障录波设计说明.md §9 与 §10**（原卡片登记簿 2026-10-30 随销项并入后删除）；**与 UI 道互斥**（菜单树与中文字库是整文件生成物，同刻只允许一条道写）——本波按此串行执行：UI 道在数据面与接线冻结之后才动生成物 | +| **独立** | **故障录波（1 kHz · 8 路原始码值 · 单通道回放）** | **代码面已交付；2026-10-31 远程半轮过六项、2026-11-02 回放页枚举缺陷已修复闭环、2026-11-04 注量对表闭环（#40 §8 交流轮）、2026-11-06 第二幕尾步坏段/空态画面台架远程轮拍毕——回放页三态板级判据全部实证；余保护触发（P，需标定解锁决定）、bench 定时自抓（T）与卷占用、`task_prof` 耗时峰值等到场/裁定项** | 用户裁定 2026-10-29 **录波先行**：数据面最小闭环 → 手动与保护启动触发 → 回放页。三块的**代码侧判据已收口**（主机单测 113 / 170 / 110 全 rc=0、双端编译 0 错误 0 警告、板端编码器与 PC 侧解码器字节级互验、手动录波与录波回放两叶已绑页、内容页黄金参考扩至 66 张）；**2026-10-31 远程半轮已过六项**（真 FAT 落盘、触发→落盘全部落在 2 s 封存超时窗内、冷却恢复、轮转、PC 侧坏段拒收、冻结窗内 104 并发）；同轮发现的缺陷「回放页段表枚举恒空」**已于 2026-11-02 远程修复并板级闭环**（根因 = 读侧 `wave_store_seg_path()` 返回值判错，顺带修键处理缺失效；回放页真段/切段/切道已实测，登记簿条目已销项，证据见设计说明 §10「回放页枚举恒空缺陷修复记录」）；**注量对表半轮已于 2026-11-04 由 #40 §8 交流轮闭环**（幅值 / 相位 / 削顶三项实测，`meas:` 行与板上读数逐项核对，104 浮点遥测按用户裁定不作对照证据；`docs/测试说明/测试数据/boot_log_data/20261104_ac_*`）；**回放页放坏段与空态画面已于 2026-11-06 台架远程轮拍毕闭环**（同号翻位覆盖→「该段不可读」零波形元素绝不平线；全删→「无录波段」+ 串口 `open fail fr=4` 互证；证据 `docs/测试说明/测试数据/wave_shot_20261106/`，记录见设计说明 §10「回放页坏段/空态画面闭环记录」）；**没跑的只剩** 保护触发对时刻（src=P，先要标定解锁决定）/ bench 定时自抓与卷占用（需 bench 构建）/ `task_prof` 读路径耗时峰值，全部结果与清单见 `docs/子系统设计/故障录波设计说明.md` §10「板级远程半轮记录」。**板级判据、留痕名清单与执行顺序图的属主 = docs/子系统设计/故障录波设计说明.md §9 与 §10**（原卡片登记簿 2026-10-30 随销项并入后删除）；**与 UI 道互斥**（菜单树与中文字库是整文件生成物，同刻只允许一条道写）——本波按此串行执行：UI 道在数据面与接线冻结之后才动生成物 | ### 2.1 关键依赖 diff --git a/docs/测试说明/专项验证/故障录波板级到场轮执行手册.md b/docs/测试说明/专项验证/故障录波板级到场轮执行手册.md index 9b7423ff..d36ad541 100644 --- a/docs/测试说明/专项验证/故障录波板级到场轮执行手册.md +++ b/docs/测试说明/专项验证/故障录波板级到场轮执行手册.md @@ -3,6 +3,7 @@ > **这份手册解决什么**：录波的判据里剩下的那半轮——需要**有人的手和信号发生器**的验证——把它拆成"你做什么、说哪句话、会看到什么"。 > **它不是判据属主**：判据、留痕名清单、执行顺序图全在 `docs/子系统设计/故障录波设计说明.md` §9 与 §10；本文只写**执行动作**。已完成部分（2026-10-31 远程半轮六项 PASS + 2026-11-02 缺陷「回放页段表枚举恒空」修复闭环 + 2026-11-04 第二幕注量对表闭环（#40 交流轮）+ 2026-11-06 坏段/空态两画面台架远程轮拍毕）见 §10「板级远程半轮记录」与 §10「回放页枚举恒空缺陷修复记录」「回放页坏段/空态画面闭环记录」。 > **一句话预算**：你到场约 1.5~2 小时；其中真正动手的只有**接三次线、按不超过六次键、拍两个决定**——其余全部由会话里的 agent 跑脚本。 +> **触发源字母速查**（串口 `wave:` 心跳与回放页顶部的 `src` 字段，四个取值一次记全；契约定义属主 = `docs/子系统设计/故障录波设计说明.md` §9）：**M＝手动录波**（面板「装置维护 → 手动录波」按出来的）· **P＝保护启动触发**（保护元件动作那一拍自动录的，本手册第三幕验的就是这条来路）· **T＝定时自抓**（只在 bench 构建里周期自录，第四幕）· **`-`＝本次上电还没触发过**。这四个字母是串口与台架脚本的 grep 契约、不会改成汉字；人读文案一律写「保护触发（P）」这类汉字在前的形式。 --- @@ -12,7 +13,7 @@ |---|---|---|---|---|---| | 第一幕 | 枚举埋点与修复上板 | **已完成（2026-11-02，远程）** | 无 | 改码加埋点 → 构建 → 烧录回读 → 远程开回放页 → 读 FR 码定性 → 修复重烧 | `docs/子系统设计/故障录波设计说明.md` §10「回放页枚举恒空缺陷修复记录」 | | 第二幕 | 注量对表 | **已闭环（2026-11-06）**——注量对表 2026-11-04 由 #40 交流轮跑完；坏段/空态画面 2026-11-06 台架远程轮拍毕，本幕现场无需重做 | ~~接 UA 发生器线 1 次、拔 1 次；面板按 2 次键（或让 agent 远程注键）~~ 已由远程轮与 #40 消化 | 记心跳基准 → FTP 拉段 → `wave_read` 量四样 → `meas:`/104 YC 对表 → 削顶注大一遍 → 坏段上板看回放页绝不平线 | `docs/子系统设计/故障录波设计说明.md` §10「板级」行 +「板级·回放页」行后半 +「回放页坏段/空态画面闭环记录」 | -| 第三幕 | P 触发对时刻 | **要到场**,还含**两个由你拍板的决定** | IA 两点标定各接一次线 + 过流加大到 UI 见数值过 2 A | 读码算 k/b → 写配置生效 → 验证解锁 → 触发后对 start.log 时刻/段号/src=P | `docs/子系统设计/故障录波设计说明.md` §10「板级·触发来路」行 | +| 第三幕 | 保护触发对时刻（src=P） | **要到场**,还含**两个由你拍板的决定** | IA 两点标定各接一次线 + 过流加大到 UI 见数值过 2 A | 读码算 k/b → 写配置生效 → 验证解锁 → 触发后对 start.log 时刻/段号/src=P | `docs/子系统设计/故障录波设计说明.md` §10「板级·触发来路」行 | | 第四幕 | bench 自抓与卷占用 | **可远程**（烧录同上；占卷用 FTP 造） | 无 | 烧 bench 构建 → 造占卷 ≥2 s → 看 `err`+1、**一条** `ring abandoned`、同号重写 → 还原产品构建 | `docs/子系统设计/故障录波设计说明.md` §10 板级行的 `ring abandoned` 观察项 | 幕间依赖：**第二幕的"坏段上板看回放页"一步已不再被阻塞**（第一幕 2026-11-02 已修好并板级闭环）；其余各幕互相独立，可以先做不用等的。 @@ -21,7 +22,7 @@ flowchart LR A[第一幕: 枚举埋点修复 可远程] -->|修好才有测试面| B2[第二幕尾: 坏段与空态画面] B[第二幕: 注量对表 到场接线] --> B2 - C[第三幕: P触发 到场+两个决定] + C[第三幕: 保护触发 到场+两个决定] D[第四幕: bench占卷 可远程] ``` @@ -91,11 +92,11 @@ flowchart LR --- -## 5. 第三幕「P 触发对时刻」——含两个只能你拍板的决定 +## 5. 第三幕「保护触发对时刻」（src=P）——含两个只能你拍板的决定 **先讲人话**：过流启动录波的代码路已接在 `protect_task.c` 的启动边沿上（判据一 picked,录波同拍请求）,但**保护判据现在整机闭锁**——`adc_cal_flags()` 的 VALID 位对 UA/UN/IA 三路都没置位,`protect_task` 直接停走判据。要让保护真出口,**必须先把这三路标定**;这正是 2026-10-25 你裁定"保持闭锁、不用万用表走捷径"守着的那道门。 -- **决定一（解锁）**：这一幕要不要用**发生器为参考**给 UA/UN/IA 做两点标定换 P 路验证?它**不是送检级标定**（端子变比还挂着 `docs/任务规划/数据可信.md` §5 的原理图确认）,做出来的工程量是"发生器刻度下的近似值"。**点头 → 往下走;摇头 → 第三幕整体顺延到标准源轮,本文其余各幕照做。** +- **决定一（解锁）**：这一幕要不要用**发生器为参考**给 UA/UN/IA 做两点标定换保护触发路（src=P）验证?它**不是送检级标定**（端子变比还挂着 `docs/任务规划/数据可信.md` §5 的原理图确认）,做出来的工程量是"发生器刻度下的近似值"。**点头 → 往下走;摇头 → 第三幕整体顺延到标准源轮,本文其余各幕照做。** - **决定二（还锁）**：这一幕验完,把标定清回闭锁（还原出厂系数）还是**留着 valid** 让保护继续在线（此后 UI 显示与 104 遥测的二次值都按这份近似标定出数——**留着就要在台账注明非送检级**）。 步骤（决定一通过后）： @@ -140,7 +141,7 @@ flowchart LR |---|---|---|---| | 先 | 第一幕（埋点→定性→修复） | 30~45 min | 否（远程可跑,烧录要口头确认） | | 中 | 第二幕（注量对表） | 40~60 min | **是**（接拔线 + 一次按键） | -| 中 | 第三幕（P 触发） | 30~60 min（含两个决定） | **是**（多点注入接线 + 加流） | +| 中 | 第三幕（保护触发） | 30~60 min（含两个决定） | **是**（多点注入接线 + 加流） | | 后 | 第四幕（bench 占卷） | 20~30 min | 否 | 第二、三幕共用同一次到场（都在 UA/IA 端子上做文章）;第一、四幕可以排在任意工作日远程做。**四幕全过 = 录波本波收口**——`docs/任务规划/README.md` §2.0「独立」行的"一轮未跑"字样就可以清了。