refactor(编号·批次二): 文档侧 194 处保护功能号改成功能名，定义表 7 张首格改语义标识
批次二文档半（道 gate-docs 执行）。先纠三个数的口径账，别再拿任何旧数当准：**234 处是准数** —— 卡片写 52（Lead 用了门禁 Checker 的引用集合，它**刻意排除属主文档内部的定义位**）、道里先报 265（裸正则把 `SDL2-2.32.10` 里的 `L2-2` 当成功能号，误报 10 处）。最终边界口径 = 带左边界 + 跳过反引号代码段。 · 19 只文件 HEAD 共 234 处 → 现 40 处，**40 处 100% 落在变更记录行**（冻结历史，按 Q3 一条没动）， 非变更记录残留 **0**；改写 163 行 / 16 只文档。站点最多：规划文档 110→37、相量层单测说明 25→1、 采集与数据处理短板评测 21→0、App/algo/README 26→0。 （`App/algo/README.md` 由上一笔代码提交带上车，路径归属已在该笔正文注明，内容是本批改写） · **定义表首列由编号改成语义标识**（编号规范 §3.3「表首格就是短语」的完全形态）：首列原为编号的表 共 **7 张**（不是 5 张），删掉与之重复的「语义名」列；表头标签按域词区分——三张 L3 保护**元件**表 保留 `| 元件 |`，四张 L1/L2 表用 `| 功能名 |`（把「元件」统一洗成功能名会丢掉领域信息）。 七张表逐张核：表头竖线数 == 分隔行 == 首条数据行 == 列数+1；与 HEAD 逐块对拍**净新增不一致块 0**， 并且正是这个对拍抓到第一版「三张表数据行已删列、表头没删」的破表。 · 7 处删号留下的残词/重复解释括号人工收口（如「L1-5（通道标定）」→「通道标定（一次系数 + 零漂）」）， 复扫待收口站点 0；措辞逐字取自映射表，无第二种说法。 · tools/arch_diagram 三只生成器 4 处（3 处 docstring + 1 处图形文案）与产物同批：重跑后**只有位图那张 变 2 个 text 节点的换行位置**，画布 1580x740 与总行数不变，另两张逐字节未变；改前先干跑对照证明三张 svg 原本与生成器一致（不在 stale 基线里）——`check_generated_fresh --only docs-svg` PASS。 本笔另含 **F-* 半批的文档面**（同一轮 `git add docs tools/arch_diagram AGENTS.md` 一并收进 ，非误伤）：BSD 函数调用关系里 9 处反引号紧邻指针、属主文档 §7 的停发句与导读行（**12 条定义行原样保留、不删登记族**）、 以及 `gen_net_instability_svg.py` 与它的产物 `网络不稳根因总览.svg`（「唯一读者红线」那条的框宽自适应 526 → 551，右缘 1411 未越界，画布 1560x1468 不变）——该半批的**代码注释面**在下一笔。 ⚠ 因 `docs/任务规划/登记簿.md` 与 `docs/任务规划/UI补齐.md` 正被另一张卡（UI 叶数复核）改动，本笔**不含 那两只文件**，批次二的 §9 存量收尾与它们同批提交。
This commit is contained in:
@@ -76,7 +76,7 @@ flowchart TD
|
||||
|---|---|
|
||||
| `app_main_init()`（内核启动前） | `adc_input_init()`（映射自检 + 挂 DMA 缓冲）→ `phasor_init()`（内部连带 `sample_ring_init()`）→ `freq_init()` → `prot_set_init()` → `prot_elm_init()` |
|
||||
| `adcTask`（每拍） | `adc_input_poll()` → `adc_input_raw()` ×9 → `sample_ring_push_frame()` → `phasor_run()` → `freq_run()` → 心跳与健康判定 `adc_health_check()` |
|
||||
| `protectTask`（20 ms） | 取 `phasor_get()` rms 与 `freq_get()` → `prot_elm_run()`；L5-4 采样故障闭锁、L5-1 定值校验和巡检 |
|
||||
| `protectTask`（20 ms） | 取 `phasor_get()` rms 与 `freq_get()` → `prot_elm_run()`；「自检失败闭锁」采样故障闭锁、 定值校验和巡检 |
|
||||
|
||||
`prot_elm_init()` 须在 `phasor_init()` **之后**（它按名前缀解析相量实例索引）；`prot_set` 独立
|
||||
（只依赖 `stdint.h`），可在任意点初始化。
|
||||
@@ -122,7 +122,7 @@ flowchart TD
|
||||
|---|---|
|
||||
| `adc_health_init()` | 清状态；**首拍 `check()` 只建基线、不判定** |
|
||||
| `adc_health_check(&in, &out)` | 吃"计数快照"做一次判定（每拍调，常数次整数运算）；差值法 `(int32_t)(now - prev)` → 计数与 tick 回绕都安全 |
|
||||
| `adc_health_flags()` | **电平**故障位：`TPAFE_STALL` / `STM32_STALL`（≥100 ms 无前进，可自愈）/ `SEQ_BACKWARD`（锁存）——为 L5-4 闭锁供数 |
|
||||
| `adc_health_flags()` | **电平**故障位：`TPAFE_STALL` / `STM32_STALL`（≥100 ms 无前进，可自愈）/ `SEQ_BACKWARD`（锁存）——为「自检失败闭锁」闭锁供数 |
|
||||
| `adc_health_sticky()` | **锁存**位：`FRSTDATA` / `STM32_ERR` / `HW_ERR` 的增量痕迹，自愈后仍留痕 |
|
||||
| `adc_health_tpafe_gaps()` | TPAFE 累计丢帧点数（序号前进 >1 的超出部分），与 STM32 侧 `adc_input_stm32_gaps()` **同单位**（心跳字段 `tgap` / `adc1_gap` 可直接对比） |
|
||||
|
||||
@@ -195,12 +195,12 @@ flowchart TD
|
||||
"部分新部分旧"的混合结果。
|
||||
- **每拍 20 点全部重算**（暴力法）。不用"加尾项去头项"的增量式：增量递推会累积误差，
|
||||
暴力法每次都是干净的一周波。代价 = 每拍 20 × 实例数次乘加，相量刷新周期 1 ms。
|
||||
- **相位（L2-4）不常驻结构体**：需要时自行 `atan2f(fIm, fRe)`（`φ` 约定 = 窗首初相，见 §7）。
|
||||
- **相位（「相位输出」）不常驻结构体**：需要时自行 `atan2f(fIm, fRe)`（`φ` 约定 = 窗首初相，见 §7）。
|
||||
|
||||
---
|
||||
## 7. L2 派生量：频率测量 `freq.c`
|
||||
|
||||
**解决的问题**：过频 / 低频（`docs/算法/继电保护功能复现规划.md` §3.3 L3-5）需要系统频率读数，
|
||||
**解决的问题**：过频 / 低频（`docs/算法/继电保护功能复现规划.md` §3.3 「过频 / 低频」）需要系统频率读数，
|
||||
而 L2 只出相量。本层把"相邻两拍基波相量的相位差"变成"频率"，并解决**非整周波窗长的 DFT 泄漏纹波**
|
||||
——这是决定精度的关键问题。
|
||||
|
||||
@@ -271,7 +271,7 @@ UA 无幅值落 IA → 0.0020 Hz。
|
||||
| `prot_set_dirty_peek()` / `_take()` / `_mark()` | 脏标志三件套（落盘握手） | peek = 通知 iec104Task；take = 属主落盘前消费；mark = 写失败回置重试 |
|
||||
| `prot_set_store_serialize()` / `_parse()` | 持久化 blob：`PSET` + 版本 + 值区 + sum32 正 / 反码对 | parse **整表原子**：magic / 版本 / 长度 / 校验对 / 范围任一失败 = **一字不动** |
|
||||
| `prot_set_get_f()` / `get_ctl()` | 工程量浮点 / 投退读取 | 单字读原子 |
|
||||
| `prot_set_selfcheck()` | 重算 sum32 与封存正 / 反码比对，失配 → 闭锁（L5-1） | seqlock 式复核：提交时撞见改写 = 本轮跳过而**不误锁**；`prot_set_seal()` 是解锁的**唯一**合法路径 |
|
||||
| `prot_set_selfcheck()` | 重算 sum32 与封存正 / 反码比对，失配 → 闭锁（「定值校验和」） | seqlock 式复核：提交时撞见改写 = 本轮跳过而**不误锁**；`prot_set_seal()` 是解锁的**唯一**合法路径 |
|
||||
|
||||
**要点**
|
||||
|
||||
@@ -316,7 +316,7 @@ UA 无幅值落 IA → 0.0020 Hz。
|
||||
`over` 位统一处理（`UV` / `UF` 是欠量实例）。
|
||||
- **定时限**用差值法 `(uint32_t)(int32_t)(now - t0) >= dly` → tick 回绕安全；`dly = 0` =
|
||||
启动同拍即动作。**返回是即时的**（参考系统带 10 ms 返回延时，接出口硬件时再补）。
|
||||
- **闭锁联动**：`prot_set_locked()`（L5-1）或该元件投退 = 0 → 状态整体复位、不再判据。
|
||||
- **闭锁联动**：`prot_set_locked()`（「定值校验和」）或该元件投退 = 0 → 状态整体复位、不再判据。
|
||||
- **数据缺失时的两种处理刻意不同**（这是本层最容易改错的一处）：
|
||||
- 相量类**任一未就绪 → 整拍跳过**（不给判据喂陈旧值）；
|
||||
- 频率类**无有效读数 → 按方向填"必不启动"值**（过量填 `0`、欠量填 `1e30` → 滞回比较恒假 →
|
||||
@@ -329,7 +329,7 @@ UA 无幅值落 IA → 0.0020 Hz。
|
||||
（`iec104_pts` 的 fault-total 掩码含 OC / 3U0；OF / UF 置总位但无独立分点）。
|
||||
**文档与代码都必须按此口径，勿写"独立遥信"。**
|
||||
- **板端接线**：`App/task/protect_task.c`（protectTask，20 ms）消费 `prot_elm_run()` +
|
||||
L5-4 采样故障闭锁 + L5-1 校验和巡检；判据结果经 104 遥信上送（`iec104_pts` YX15~23 / 31）
|
||||
自检失败闭锁 + 定值校验和巡检；判据结果经 104 遥信上送（`iec104_pts` YX15~23 / 31）
|
||||
→ `docs/算法/继电保护功能复现规划.md` §7。实例数变化会同时改变启动锚点 `elm=` 数字与
|
||||
`prot_elm_active_mask()` 位宽（B8：7 → 9 实例），串口锚点表若含该数字须同步核对。
|
||||
|
||||
@@ -412,7 +412,7 @@ adcTask 静态最坏链与余量的**台账在** `docs/内存管理/RAM使用分
|
||||
## 13. 相关文档
|
||||
|
||||
- 目录索引与构建 / 测试入口：`App/algo/README.md`
|
||||
- L1-6 判定层深设计（判据推导 / 盲区 / 验证分工）：`docs/算法/采样有效性校验设计说明.md`
|
||||
- 「采样有效性校验」判定层深设计（判据推导 / 盲区 / 验证分工）：`docs/算法/采样有效性校验设计说明.md`
|
||||
- 分层与功能项清单（L1~L5 的属主登记处）：`docs/算法/继电保护功能复现规划.md`
|
||||
- 通道映射权威口径：`docs/硬件平台/ADC通道映射说明.md`
|
||||
- 采样节拍与 DMA 搬运：`docs/子系统设计/ADC采样节拍设计说明.md`
|
||||
|
||||
Reference in New Issue
Block a user