From 058e7c061cc62f60472917a36db876dbf2e76500 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Fri, 30 Oct 2026 00:18:53 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E6=95=B0=E6=8D=AE=E5=8F=AF=E4=BF=A1):=20?= =?UTF-8?q?=C2=A78=20=E9=A3=8E=E9=99=A9=E8=A1=A8=E6=94=B9=E6=8C=89?= =?UTF-8?q?=E8=A1=8C=E5=90=8D=E5=BC=95=E7=94=A8=EF=BC=8C=E4=BF=AE=E6=8E=89?= =?UTF-8?q?=E4=B8=A4=E5=A4=84=E6=8C=87=E9=94=99=E8=A1=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - IEC104上行设计说明.md 与 iec104_pts.c 的 s_q_map 注释原写「§8 风险 表末行」，末行其实是「加压烧板」；含单测要求的是「削顶通道被当成可 测」行。两处都改成行名，行名完整落在一行内 - ADC前端注入验证流程.md 同源错引用改成「削顶负向用例被当成固件 bug」行 - 数据可信.md §8 表头加一条引用规矩：写行名，别写「末行 / 第 N 行」， 本表会插行 - doc-links 只校验章节编号存在性，看不见「末行」这类行内指向，也从不扫 .c/.h —— 这两处此前没有门能拦 @build 0 errors 0 warnings（只改注释，Program Size 未变） --- App/protocol/iec104/iec104_pts.c | 4 ++-- docs/任务规划/数据可信.md | 2 ++ docs/子系统设计/IEC104上行设计说明.md | 2 +- docs/测试说明/ADC前端注入验证流程.md | 2 +- 4 files changed, 6 insertions(+), 4 deletions(-) diff --git a/App/protocol/iec104/iec104_pts.c b/App/protocol/iec104/iec104_pts.c index 0f4f42af..c3e092e7 100644 --- a/App/protocol/iec104/iec104_pts.c +++ b/App/protocol/iec104/iec104_pts.c @@ -176,8 +176,8 @@ uint32_t iec104_pts_yc_ioa(uint8_t idx) { * 入口参数：q16 - 源侧品质（低字节与线上同值；高字节为 MEAS_QDS_CLIPPED 域内位） * 返 回 值：线上 QDS 字节 uint8_t * 函数说明：CLIPPED（硬件削顶，104 无对应位）映射为 IV——「削顶通道 104 恒 - * IV」口径（docs/任务规划/数据可信.md §8 风险表末行）改由快照品质 - * 驱动，不再靠点表绑死 -1；OV/NT/IV 透传，其余高位丢弃。 + * IV」口径（docs/任务规划/数据可信.md §8 风险表「削顶通道被当成可测」 + * 行）改由快照品质驱动，不再靠点表绑死 -1；OV/NT/IV 透传，其余高位丢弃。 */ static uint8_t s_q_map(uint16_t q16) { uint8_t w = (uint8_t)(q16 & (uint16_t)(IEC104_QDS_OV | IEC104_QDS_NT diff --git a/docs/任务规划/数据可信.md b/docs/任务规划/数据可信.md index 2d3499bf..55678c76 100644 --- a/docs/任务规划/数据可信.md +++ b/docs/任务规划/数据可信.md @@ -425,6 +425,8 @@ flowchart TD ## 8. 风险 +> 引用本表某一行时**写行名**（例：「削顶通道被当成可测」行），别写「末行 / 第 N 行」——本表会插行。 + | 风险 | 触发条件 | 缓解 | |---|---|---| | **削顶负向用例被当成固件 bug** | 做 D5 时 STM32 那五路必然钉下轨 → `rail: edge=…` 是 `[ERR]` 行，而 `@test` 的 forbidden 标记含 `[ERR]` → 整轮被判 FAIL | 判读规则写进流程文档："做 D5 的这一轮 `[ERR] rail:` 属预期，只人工判读、不计入 `@test` 结论"，或把这五路排在最后单独一轮并事先声明。同时别忘 `cl=0xE6` 是**来源派生**（§2.6），不是本轮新削出来的 | diff --git a/docs/子系统设计/IEC104上行设计说明.md b/docs/子系统设计/IEC104上行设计说明.md index 38866e9b..9132ac49 100644 --- a/docs/子系统设计/IEC104上行设计说明.md +++ b/docs/子系统设计/IEC104上行设计说明.md @@ -49,7 +49,7 @@ 折算层 2026-10-25 落地；二次值等两点标定置 VALID）。槽位值/品质整体透传，本层 **不再自行判新旧**（快照 `seq` 仅供 COV 去重）。 - 品质映射：快照 `MEAS_QDS_*` 低字节与线上 QDS 同值直传；**CLIPPED → IV**（「削顶通道 - 恒 IV」口径不变、改由品质驱动，docs/任务规划/数据可信.md §8 风险表末行的单测要求）； + 恒 IV」口径不变、改由品质驱动，docs/任务规划/数据可信.md §8 风险表「削顶通道被当成可测」行的单测要求）； 快照从未发布（开机 <200 ms）→ IV|NT；判定顺序 IV 优先于 NT。 - 死区（104 改读快照）：从「越死区即报」改为**连续 2 个新测量点越限才确认**——板端测量点 = 快照换帧（100 ms 轮询 vs 200 ms 快照按 `seq` 去重，防同一帧把单点噪声重复计满 2 点； diff --git a/docs/测试说明/ADC前端注入验证流程.md b/docs/测试说明/ADC前端注入验证流程.md index 4ab45e93..8efda66d 100644 --- a/docs/测试说明/ADC前端注入验证流程.md +++ b/docs/测试说明/ADC前端注入验证流程.md @@ -587,7 +587,7 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性， - D5 会**故意造出** `[ERR] rail: edge=… sticky=… (code-domain, 20-run+release)`，而 `@test` 的 forbidden 标记含 `[ERR]`（AGENTS.md「构建与验证」）→ **这一轮不要把 `@test` 的标记校验当结论**：改人工判读，并在归档文件名与 - 抬头里写明「预期 [ERR]：贴轨锁存负向用例」；§8.6 已把它排在最后单独一轮（`docs/任务规划/数据可信.md` §8 风险表第一行同一条）。 + 抬头里写明「预期 [ERR]：贴轨锁存负向用例」；§8.6 已把它排在最后单独一轮（`docs/任务规划/数据可信.md` §8 风险表「削顶负向用例被当成固件 bug」行同一条）。 - 除这一条 `[ERR] rail:` 之外，**任何 `[ERR]` 都是不通过**；四个 Fault 的崩溃日志也以 `[ERR]` 开头 → 出现 Fault 立即停线取现场（`docs/子系统设计/看门狗设计说明.md` §10），别再继续注。 - 每次开机 `rail:` 边沿只打一条、`SYSLOG` 也只留痕一次（"adc code rail fault" 进 `selftest.log`）——这是设计不是漏报；