# 继电保护功能复现规划

> **定位**：把参考系统（CLS100 DTU 保护测控装置）的**继电保护链路**在本项目（STM32F4-Base DTU 平台）上分层复现的**总规划**——给出要实现的功能、性能指标、定值参数、平台适配口径与分阶段路线图。
> **参考来源**：`D:\Code\DTU\参考资料\huaiyuan\huaiyuan\Scatter_P_HV03.01_SV01.01\项目分析文档\04-算法与采样专题\ADC采集至数据使用全流程详解`（同专题另有《项目详细分析-交流采样与有效值计算》《傅氏算法详解》《项目详细分析-阶段6-继电器保护单元分析》）。
> **阅读前提**：先读 `docs/算法/傅氏算法详解.md`（算法原理）与 `docs/硬件平台/ADC通道映射说明.md`（采样通道权威口径）。
> **相关文档**：`docs/产品需求/产品需求设计文档.md`、`docs/任务规划/README.md`、`docs/内存管理/RAM使用分析与优化方案.md`。
> **状态**：**P0 采样与相量底座已台架闭环（2026-10-11）**——语义取数与有效性采集链路（B1，2026-10-10）、 采样有效性校验与 全周傅氏相量层（`sample_ring` + `phasor`，57 项主机单测 + 台架 `/serial-boot-test` 含 `phasor(first)/phasor(hb)` 标记闭环）均已落地；**P1/P2 保护元件与定值模型软件侧完成（2026-10-11，`prot_set` + `prot_elm`，57 项主机单测）**；**B5 板端接线完成（2026-10-12）**——`protectTask`（20 ms 判据节拍 + 「自检失败闭锁」采样故障闭锁 + 定值校验和巡检，IWDG `TASK_WD_PROTECT` bit8，栈 512 words 静态链 872 B / 余 57%），判据结果经 B4 IEC104 遥信（YX15~23/31）上送；**B7 定值持久化 + 全局软压板 + 竞态收口完成（2026-10-12，含台架腿验证）**；**出口记录（出口与记录）与标准源注入验收为下一步**（见 §7）。

---

## 1. 背景、目标与范围

### 1.1 参考系统（CLS100）保护实现概览

| 维度 | 参考实现 |
| --- | --- |
| 硬件平台 | TI OMAP-L138（ARM926EJ-S + C674x DSP **双核**），无 FPGA |
| 操作系统 | VxWorks |
| 核心分工 | **DSP 核**跑保护算法（1 ms 中断节拍），**ARM 核**跑管理 / 通信 / 人机 |
| 采样率 | 50 Hz 系统，每周波 **20 点** → 保护采样率 **1000 Hz**（`CN_SAM_HERTZ=50`、`CN_SAM_RATE=20`） |
| 内部总线节拍 | **4000 Hz**（80 点/周波，为保护采样率的 4 倍，`CN_WAVE_RATIO=4`），供录波/高频量使用 |
| 保护相量 | **全周傅氏**（全周 DFT），每次刷新 15 个基波相量 + 3 个二次谐波相量 + 1 个五次谐波相量，**每 1 ms 重算** |
| 遥测有效值 | 每 **200 ms** 对 k=1~9 次谐波做 DFT 再**方和根**（`CN_NUM_YCHUMWAVE=9`），得"真有效值"轨 |
| 保护元件 | **89 个模块**（`RelayUnit/PRS_*.c`），统一 `tagPRS_XXX` 接口（Init / Main / 执行函数） |
| 并发机制 | 采样**双缓冲**（2 周波 = 40 点）+ 相量**双区指针原子交换** + 遥测 **0x55/0xaa 计算/拷贝标志协议** |
| 调度 | **时间片表**（单点 / 2 点 / 4 点 / 8 点）按 `g_dwSchedulerCnt` 位掩码分发 |
| 定值 | EEPROM 存定值 + 折算系数（`wCoeEEP` / `wCoeCal` / `wCoeRet`），TLV 通道；遥测微调 TLV10（±10%，0.1% 步长） |
| 有效值口径 | 保护用**基波有效值**（`CN_ANA_VEC_SQRT=FALSE`），计量/遥测用**谐波方和根** |

> 数据全链路（采样 → 内部总线 → 缓冲 → 预处理 → 算法 → 存储 → 使用）见参考文档《ADC采集至数据使用全流程详解》§5~§7；傅氏原理与系数折算见 `docs/算法/傅氏算法详解.md`。

### 1.2 本项目现状

| 维度 | 现状 |
| --- | --- |
| 硬件平台 | STM32F407ZGTx（Cortex-M4F，168 MHz，**单核**，硬件 FPU） |
| 操作系统 | FreeRTOS V10.3.1（CMSIS-RTOS v2） |
| 已实现子系统 | 网络（CH395F）、存储（GD5F2GQ5UE SPI NAND + dhara FTL + FatFs）、时间（SD2506 RTC + `sys_clock`）、配置（cfg_file）、日志、UI（远端显示）、看门狗（IWDG）、FTP |
| 采样硬件 | TPAFE5160（16 位、8 通道**同步**、±5 V 双极性、并行 `GPIOG[15:0]`）+ STM32 内部 ADC1（12 位、9 通道**顺序**扫描、0~3.3 V 单极性） |
| 采样软件 | `Drivers/BSP/TPAFE5160/tpafe5160.h` 驱动就绪（原子快照 API）；`App/task/adc_task.c` **已实现真实消费者（B1，2026-10-10）**——`tpafe5160_snapshot()` 取数 + 帧统计；**采样节拍由 TIM3 更新事件（1 kHz）硬件触发**（2026-10-10；同一事件经 TRGO 触发 ADC1 + DMA）；STM32 侧 **`App/algo/adc_input.c` 已实现语义映射 + ADC1 DMA 乒乓帧消费（「STM32 ADC1 启动与扫描」，v2.0）**，`HAL_ADC_Start_DMA` 已出现 |
| 保护算法层 | **全周傅氏相量层已实现并台架闭环**（`App/algo/sample_ring.c` + `phasor.c`：全周傅氏 5 实例、双区交换、每 1 ms 刷新，2026-10-11 `/serial-boot-test`）；**保护判据元件框架 + 过流/过负荷/过压/欠压/零序过压 + 定值模型软件侧完成**（`prot_elm.c` + `prot_set.c`，2026-10-11，57 项主机单测）；**出口 / SOE 记录仍缺失**（P4） |
| 已知硬件缺陷 | 登记簿条目「双转换器无共同采样触发」：8 路电气量分属两片转换器 → V0.1 上禁止跨转换器做相位/功率/矢量运算 |

### 1.3 复现范围界定

**本期做（保护链路最小可用集）**

1. 采样与预处理：周期采样触发、通道语义映射、标定、有效性校验、等周波调频、零序通道接入。
2. 相量计算：全周傅氏基波/谐波相量、线/负序/零序合成、双区交换、每 1 ms 刷新。
3. 保护元件：**V0.1 测量有效子集**——过压/欠压（`UA`）、零序过压（`UN`）、过流（A 相，`IA`）、过负荷（A 相）、过频/低频；三相完整过流、零序过流、涌流制动、PT/CT 断线等**建接口不使能**，待 V0.2（见 §1.6）。
4. 出口与记录：跳闸/告警出口、SOE/动作记录、定值模型与 cfg_file 集成、自检闭锁。

> ⚠️ **V0.1 硬件裁剪**（2026-10-10 定性）：本清单受「双转换器无共同采样触发」（跨转换器无同一时刻性）与**"STM32 侧无中点偏置"**两条约束，实际可闭环的保护元件见 **§1.6**——V0.1 上只有 TPAFE 三路（`UA`/`UN`/`IA`）测量有效。

**本期不做（延后或依赖条件）**

- 方向元件 / 功率 / 功率因数 / 对称分量类运算——受「双转换器无共同采样触发」制约，V0.1 上取子板计量结果，或待 V0.2 硬件改版后实现。
- 三相完整过流、零序过流、依赖三相的 PT/CT 断线——需 V0.2 硬件（8 路电气量全上 TPAFE + 中点偏置）后启用。
- 重合闸、馈线自动化（FA）等 FTU 专有功能——视产品定义（B0）。
- 双核 / DSP 拆分、VxWorks 特有机制、IEC 61850、完整故障录波——与单核 FreeRTOS 平台不匹配。
- 参考系统 89 个模块的**全量**移植——按需裁剪，只复现本产品定义的元件集。

### 1.4 前置依赖与阻塞项

| 依赖 | 说明 | 状态 |
| --- | --- | --- |
| **B0 产品定义** | 采集是否持续 / 采样率与通道 / 转发目标 / 保护元件清单——决定 B1 与保护层的**规模** | ✅ 已确认（2026-10-10，见 §1.5） |
| **B1 ADC 采集链路** | 周期 CONVST + `adc_task` 消费 `tpafe5160_snapshot()` + 建任务 + 栈预算 | ✅ 已实现并 `/serial-boot-test` 实机闭环（2026-10-10；`adcTask` 512 words，台架 1000 Hz） |
| **双转换器无共同采样触发（硬件缺陷）** | V0.1 跨转换器无同一时刻性 → 限定 V0.1 可实现的保护范围 | ⚠️ 硬件改版项（V0.2） |
| **栈预算** | 保护任务栈需入 `Src/freertos.c` 并经 `scripts/stack_report.py` 核算 | ✅ 两任务均已核算：`adcTask`（**「采样有效性校验」后：栈抬至 640 words，静态 1080 B / 台架实测峰值 952/2560 / 余 57%**）；`protectTask`（B5，2026-10-12：**512 words，静态链 872 B / 余 1176 B / 57%**，台架水位待 `/serial-boot-test`） |

### 1.5 B0 产品定义（2026-10-10 确认）

> **来源**：两份合并——①《检测平台配电终端送检要求（点表）》（省电科院送检要求，**验收口径**）；② 参考项目 `APP/EquipCfg/Const_CommPara.c`（**DTU410 / F30(Z)** 的 IEC 104 信息体地址点表，**实现细节**）。
> **口径**：点表定"上送什么、什么格式、什么地址"；`Const_CommPara.c` 定"怎么编号、哪些定值"。

**（1）确认结论**

| 项 | 确认结论 |
| --- | --- |
| 定义基准 | 两份合并（点表为验收口径 + 参考项目 104 点表为实现细节） |
| 上行规约（转发目标） | **IEC 60870-5-104**（DL/T 634.5104-2009），以太网 TCP **2404**（**非** ModBus RTU 上行） |
| 主站 / 终端地址 | 主站 `192.168.1.199:2404`；终端 `192.168.1.101~106`（可设）；链路地址与 ASDU 公共体地址 2 字节、传送原因 2 字节、**IOA 3 字节**（101 为 2 字节） |
| 采集持续性 | **持续采集**（中断驱动 + 遥测周期上送 + 死区上送 + SOE） |
| 采样率 | **1000 Hz**（20 点/周波 @50 Hz），1 ms 保护节拍 |
| 遥测 | 上送**短浮点**，采集上传**系数 = 1**；点号 `4000H+` |
| 遥信 | 双位置遥信上**双点**，其余**单点**；点号 `0+` |
| 遥控 | **双点命令**，合闸选择 `82H`、执行 `02H`；点号 `6000H+` |
| **RS-485** | **对下 ModBus RTU 采集**（下行采集口，非上行口） |
| 对时 | 点表要求 **SNTP `192.168.1.121:5105`**；本项目**保留自定义 TCP 8888**，SNTP 本期不实现（B0-b） |
| 固有参数 | `8001H~800AH`：终端类型/操作系统/制造商/硬件版本/软件版本/校验码/规约类型/型号/ID/MAC |
| 运行参数 | `8020H~8058H`：死区（电流/交流电压/直流电压/功率/频率/功率因数）、PT/CT 变比、负荷越限/重载/过载报警、录波投退与定值、功率置负 |
| 定值 | `8820H~8882H`：过流 I/II/III 段、零序过流 I/II 段、重合闸、低压/低频、励磁涌流闭锁、小电流接地等 |

**（2）遥测点号 → 本项目通道映射**

| 点号 | 点表语义 | 本项目来源（V0.1） |
| --- | --- | --- |
| `4010` | UBA 后备电源电压 | ⚠️ 无对应硬件通道 → **本期不做**（B0-a） |
| `4011~4013` | `1Ua/Uab`、`1Ub/Uca`、`1Uc/Ubc` | `UA`/`UB`/`UC`（映射见 `docs/硬件平台/ADC通道映射说明.md`） |
| `4014` | `1U0` 零序电压 | `UN`（外部专用零序电压通道） |
| `4015~4017` | `1Ia`、`1Ib`、`1Ic` | `IA`/`IB`/`IC` |
| `4018` | `1I0` 零序电流 | `IN`（外部专用零序电流通道） |
| `4019~401c` | `1P`/`1Q`/`1S`/`1Pf` | 计算量（受「双转换器无共同采样触发」制约，V0.1 不可做） |
| `401d` | `1f` 频率 | 软件测频 |
| `401e/f` | `V1`/`V2` 直流量（点表注"FTU 无"） | ⚠️ 无对应硬件通道 → **本期不做**（B0-a） |

**（3）遥信 / 遥控点号**

- **遥信**（`0+`，33 点）：`YX15` 故障总、`YX16` 过流 I 段/短路、`YX17` 过流 II 段、`YX18` 过流 III 段、`YX19` 零序过流 I 段、`YX20` 零序过流 II 段、`YX21` 接地故障、`YX22` 重载、`YX23` 过载、`YX24~30` 外部遥信、`YX31~33` 闭锁状态。
- **遥控**（`6000H+`）：`YK1~YK4` 开关 1~4、`YK11` 信号复归、`YK12` 遥控软压板、`YK13` 电池活化、`YK14` 解除闭锁。

**（4）响应时间要求（点表推荐值）**

| 参数 | 推荐值 |
| --- | --- |
| 终端启动时间 | ≤ 100000 ms |
| 104 连接 / 总召 | ≤ 3000 ms / ≤ 8000 ms |
| 104 SOE 上送 | ≤ 5000 ms |
| 104 遥控选择/撤销/执行 | ≤ 5000 ms |
| 104 读定值 / 修改定值预置/执行 | ≤ 10000 ms / ≤ 5000 ms |
| 104 读文件目录/文件 | ≤ 30000 ms |
| 录波文件存储 | ≤ 15000 ms |

**（5）B0 残留项处置（2026-10-10 确认）**

| # | 事项 | 处置 |
| --- | --- | --- |
| B0-a | `UBA` 后备电源电压、`V1/V2` 直流量三路遥测的硬件来源 | **本期不做**——V0.1 无对应硬件通道，不加子板/通道；点表此三项本期空缺 |
| B0-b | 对时 | **保留自定义 TCP 8888**；点表要求的 **SNTP 5105 本期不实现** |
| B0-c | 保护/控制范围 | **本期 = 骨架全做 + 有效通道子集闭环**（2026-10-10 用户确认），评估见 §1.6 |

> **B0 至此全部闭环**：上行 IEC 60870-5-104 / 持续采集 / 1000 Hz 已定（§1.5 表 1~4）；B0-a / B0-b 本期不做或维持现状；B0-c 的范围裁剪见 §1.6。

### 1.6 B0-c 本期保护范围评估（2026-10-10 确认）

**（1）V0.1 硬件约束（两条叠加）**

| # | 约束 | 出处 | 后果 |
| --- | --- | --- | --- |
| 双转换器无共同采样触发 | 8 路电气量分属 TPAFE5160 与 STM32 ADC1 **两片**，两片**无共同采样触发** | `ADC通道映射说明.md` §1、登记簿条目「双转换器无共同采样触发」 | 跨转换器的相位 / 矢量 / 功率 / 功率因数 / 负序运算**不成立** |
| R5 | STM32 侧**无中点偏置**（1k 串联 + 1k 到 `*_GND`），0~3.3 V 单极性 | `ADC通道映射说明.md` §1、§7 | STM32 侧交流量负半周**削顶** → 该侧**算不出有效值 / 相量** |

**（2）净效果：V0.1 只有 TPAFE 三路"测量有效"**

| 通道 | 转换器 | 有效值 + 相位 |
| --- | --- | --- |
| `UA` / `UN` / `IA` | TPAFE5160（16 位、±5 V 双极性、同步） | ✅ **有效** |
| `UB` / `UC` / `IB` / `IC` / `IN` | STM32 ADC1（12 位、0~3.3 V 单极性、顺序） | ❌ 削顶 → 仅可读码值**监视** |

**（3）保护元件可行性（V0.1）**

| 元件 | 依赖通道 | 转换器 | V0.1 | 原因 |
| --- | --- | --- | --- | --- |
| 过压 / 欠压 | `UA` | TPAFE | ✅ | 测量有效 |
| 零序过压 | `UN` | TPAFE | ✅ | 测量有效 |
| 过流（A 相） | `IA` | TPAFE | ✅ | 测量有效 |
| 过负荷（A 相） | `IA` | TPAFE | ✅ | 测量有效 |
| 过频 / 低频 | `UA` / `IA` | TPAFE | ✅ | 单通道测频，有效 |
| 过流（B / C 相） | `IB` / `IC` | STM32 | ❌ | 削顶，无有效值 |
| 零序过流 | `IN`（外部）/ 自产 `Ia+Ib+Ic` | STM32 / 跨转换器 | ❌ | 削顶 / 跨转换器（双转换器无共同采样触发） |
| 方向 / 功率 / 功率因数 / 负序 | 多路 | 跨转换器 | ❌ | 双转换器无共同采样触发 |
| PT / CT 断线 | 三相判据 | 跨转换器 | ❌ | 需三相同时刻 |
| 母线接地告警 | `3U0`(UN) + `3I0`(IN) | UN 可 / IN 不可 | ⚠️ 部分 | 仅电压侧可判 |

**（4）本期范围（定论，2026-10-10）**

采用**"骨架全做 + 有效通道子集闭环"**：

- **与通道无关的骨架**（采集触发、`adcTask`、语义映射、标定、全周傅氏、双区交换、统一保护元件接口、定值模型 + cfg_file、出口驱动、SOE / 记录、自检闭锁）——**本期全做**；这是 V0.2 改版后**不需要重构**的核心资产（§6.2 的接口设计启示）。
- **保护元件**——本期只让**测量有效的通道**闭环动作：`UA`（过压/欠压、测频）、`UN`（零序过压）、`IA`（过流 A 相、过负荷）。其余元件**建接口 + 预置定值但不使能**，待 **V0.2**（修复「双转换器无共同采样触发」+ 补中点偏置，8 路电气量全上 TPAFE）。
- **控制类 / FTU 专有功能**（重合闸、小电流接地选线、后加速、检合环同期）：均依赖三相 / 零序测量或出口硬件，**本期不做**，随 V0.2。
- 即：**本期交付"整条保护链路的软件实现" + "单相/中性线保护闭环验证"**；三相完整过流、零序过流、方向/功率类随 V0.2 硬件启用。

---

## 2. 总体架构设计

### 2.1 数据全链路（分层）

复现后的保护链路分为 6 层，自下而上：

| 层 | 职责 | 参考对应 | 本项目落点（拟） |
| --- | --- | --- | --- |
| **采样驱动层** | 触发转换、读出原始码值 | AD 芯片 + 总线 | `Drivers/BSP/TPAFE5160/` + STM32 ADC1 HAL |
| **语义取数与预处理** | 快照取数、语义映射、标定、有效性校验、等周波调频、零序接入 | `DataPreRecv` / `RealDataMerge` / `CalSoftFr` / `GetZoreSamData` | `adc_task` + `App/algo/`（拟） |
| **全周傅氏相量计算** | 全周傅氏基波/谐波、线/负序/零序合成、双区交换 | `CalFFTVecFull` / `CalfLineVec` / `CalfNegVec` | `App/algo/`（拟） |
| **保护判据元件** | 各保护判据（过流/零序/过压/频率/…） | `RelayUnit/PRS_*.c` | `App/protect/`（拟） |
| **出口与记录与信号** | 跳闸/告警出口、信号灯 | `TripKO` / KO | `App/protect/` + BSP 出口驱动 |
| **动作留痕记录与上送** | SOE/动作记录、UI 显示、遥测上送 | 记录模块 + 通信 | `App/log/` + `Drivers/BSP/UI/` + `App/protocol/` |

> **分层原则**：语义取数与有效性只做"数"（码值→工程量），全周傅氏相量只做"相量"（工程量→复相量），保护判据只做"判据"（相量 + 定值→布尔），出口与记录/动作留痕只做"动作与留痕"。**算法与 I/O 分离**，使 全周傅氏相量/保护判据成为主机侧纯逻辑单测的天然适格对象（落实 `docs/任务规划/暂缓-RS485.md`「采集链路测试可验证性约束」）。

### 2.2 任务与中断模型（映射到 STM32F4 + FreeRTOS）

参考系统用 DSP 的 1 ms 中断串起整条保护链。本项目为单核 FreeRTOS，采用"**中断触发 + 任务计算**"模型：

| 角色 | 载体 | 周期 | 优先级（拟） | 说明 |
| --- | --- | --- | --- | --- |
| 采样节拍 | 定时器中断（TIMx） | **1 ms** | 最高（ISR） | 产生 CONVST 脉冲；ISR 内只置事件/计数，不做重运算 |
| 采集与预处理 | `adcTask` | 1 ms | 高 | `tpafe5160_snapshot()` 取数 → 标定 → 存入采样环 |
| 相量计算 | `adcTask` 内联 或 `algoTask` | 1 ms | 高 | 全周傅氏 → 相量双区交换 |
| 保护判据 | `protectTask` | 1 ms | 高 | 各保护元件 Init/Main → 出口。**✅ B5 已落地（2026-10-12）：V0.1 实为 20 ms / Normal**——元件吃 50 Hz 基波 rms（phasor 每工频周更新），延时精度由 `prot_elm` 的 now_ms 差值法保证、与节拍无关；1 ms/高是参考系统瞬时值元件口径，随 P2 瞬时值元件再评 |
| 遥测与显示 | 复用 `uiTask` / 新增 `measTask` | 200 ms | 中 | 谐波方和根、死区/平滑、UI 与上送 |
| 记录 | `defaultTask`（已有） | 事件驱动 | 低 | SOE/动作记录落 `sys_log` |

> **铁律**：`adcTask` / `protectTask` 的 FS 路径若触碰存储，必须沿用卷锁 try 语义（`vol_lock_wait(0)`），且每任务纳入看门狗 `required_mask` 心跳（见 `docs/子系统设计/看门狗设计说明.md`）。**保护节拍任务不得阻塞在存储 I/O 上**——记录走队列异步落盘。

### 2.3 并发与数据一致性

参考系统用三重机制保证"采样—相量—保护"三段并发无锁：**采样双缓冲 + 相量双区指针交换 + 遥测标志协议**。本项目沿用同一思想，并复用已有的原子快照范式：

| 机制 | 参考做法 | 本项目做法 |
| --- | --- | --- |
| 采样缓冲 | 双缓冲（2 周波 = 40 点），写/读分属两区 | 环形缓冲 + **序号**（`tpafe5160_frame_seq()` 已有）+ 临界区快照，防撕裂 |
| 相量区 | `tVectorRly[2][N]`，算完**原子交换**计算区/使用区指针 | 双区结构体 + 指针/索引原子切换（单核下用临界区或 `__atomic`） |
| 遥测拷贝 | 0x55/0xaa 计算/拷贝握手标志 | 快照 + 序号，或 FreeRTOS 事件标志握手 |
| 取数契约 | —— | **只能用 `tpafe5160_snapshot()`**（`AGENTS.md` 铁律），不用已删除的 `get_buf` / `data_ready` |

### 2.4 与现有子系统的接口

| 保护层需求 | 复用现有能力 | 落点 |
| --- | --- | --- |
| 定值存取 | **cfg_file 配置引擎**（替代参考的 EEPROM 定值文件） | `App/cfg/cfg_file.c` + 新增定值段 |
| 动作/SOE 记录 | `sys_log`（`/log/run.log`）与运行记录 | `App/log/` |
| 保护定值/测量显示 | 远端显示 UI（`ui_page_ac` 已有 24 行占位） | `Drivers/BSP/UI/ui_page_ac.h` |
| 遥测/事件上送 | 网络栈 + `App/protocol/`（协议预留） | `App/protocol/` + `Drivers/BSP/NET/` |
| 时间戳 | `sys_clock`（RTC 基准） | `App/util/sys_clock.c` |
| 自检留痕 | `selftest.log` / 自检框架 | `App/log/` |

---

## 3. 功能规划（分层清单）

> 每项给出：**功能点 / 关键参数 / 完成判据**。状态列 ⬜ 未实现。

### 3.1 语义取数与预处理

| 功能名 | 关键参数 | 完成判据 | 状态 |
| --- | --- | --- | --- |
| 周期 CONVST 重触发 | 1000 Hz（与保护节拍同源） | 示波器见 U3 `BUSY` 连续脉冲；`tpafe5160_frame_seq()` 持续递增 | ✅ 2026-10-10：**TIM3 更新事件（1 kHz）硬件触发**（ISR 内 `tpafe5160_start_conv_irq()`；方案 A，零引脚/零驱动改动。⚠ 节拍源**不能**是 TIM6/TIM7——F4 上 ADC1 收不到它们的 TRGO，见 `docs/子系统设计/ADC采样节拍设计说明.md` §3.2）；台架 `/serial-boot-test` PASS——`seq` 每 10 s 精确 +10000 = 1000.0 Hz、`frst_err=0`（早期证据 `docs/测试说明/测试数据/boot_log_data/20261010_prod_adc_tim6_boot_log.txt`，节拍源当时为 TIM6） |
| TPAFE 快照消费 | 8 通道 / 帧 | `adc_task` 每拍调 `tpafe5160_snapshot()`，返回 1/0/-1 有处理 | ✅ B1 已实现并 `/serial-boot-test` 闭环（`adc_task.c`；台架 `idle=0`、`frst_err=0`） |
| STM32 ADC1 启动与扫描 | 9 通道、144 cycles、**TIM3 TRGO 硬件触发 + DMA** | 全库出现 `HAL_ADC_Start_DMA`；9 通道码值随注入变化 | ✅ 2026-10-10（v2.0）：`App/algo/adc_input.c` 的 `stm32_take()`——ADC1 由 TIM3 更新事件经 TRGO 触发一轮 9 通道，`HAL_ADC_Start_DMA(&hadc1, buf, 18)` + DMA2_Stream4 循环模式把码值自动搬进**乒乓双缓冲**，任务侧只消费刚完成的半区（**零忙等**，实测单拍 `adcp` 122 µs → **8 µs**）；台架 `/serial-boot-test` PASS——`adc1_seq` 每拍 +1、`adc1_err=0`、`adc1_hw=0`。⚠ 「9 通道码值随注入变化」已由 2026-10-27 台架已知电压注入直接证实（六项判据全 PASS，实测记录 `docs/硬件平台/ADC通道映射说明.md` §8.1）；两点标定与端子/子板变比确认仍待做 |
| 通道语义映射 | 见 `docs/硬件平台/ADC通道映射说明.md`（**按语义取数，不写死下标**） | `UA→buf[6]`、`UN→buf[5]`、`IA→buf[2]`；STM32 侧 `UB→ADC_CHANNEL_14` | ✅ 2026-10-10：`App/algo/adc_input.c` 的 `k_adc_map[]` 语义表（`UA/UN/IA`→TPAFE `buf[6]/[5]/[2]`，`UB/UC/IB/IC/IN/TEMP`→ADC1 `CH14/3/6/1/2/5`）+ `adc_input_raw()` 按语义取数；开机**映射自检**（`adc_input_init()` 校验 STM32 映射通道必落在扫描序列内 → 挡住"映射到不扫描的通道"静默错）通过（`ADC input layer init: OK`）。台架首帧日志 8 路 + 温度全部读出：`UA=11429 UN=11454 IA=11452`（与 TIM3 轮次一致）、`UB=1018 UC=1044 IB=943 IC=1069 IN=1052 T=850`（互异、非饱和；**两次开机读数不同** → 确为实时转换而非常量） |
| 通道标定（一次系数 + 零漂） | 每通道 `k`、`b`；系数定点 `2^10` | 注入标准源，读数误差 ≤ 目标精度 | ⬜ |
| 采样有效性校验 | FRSTDATA 跳变、帧序号单调、丢帧计数 | 芯片静默/丢帧被检出并置告警 | ✅ 2026-10-11：新增 `App/algo/adc_health.c/h`（纯逻辑判定层：静默 100 ms 门限 / 丢帧边沿 / 序号倒退锁存 / FRSTDATA·HAL 错误·STM32 停摆计数增量）+ `adc_task.c` 告警编排（严重事件与故障上升沿 `DBG_ERROR` + 每类每次开机一次 `SYSLOG_SELFTEST`，恢复 `DBG_INFO`；gap 不告警只计数，心跳增 `tgap`）；主机单测 `test/host/adc_health/` **31 用例全绿**（`adc-health-unit-test` 钩子）；台架 `/serial-boot-test` PASS 零 `[ERR]`（健康不误报，`docs/测试说明/测试数据/boot_log_data/20261011_prod_adc_health_boot_log.txt`）。⚠ 抬栈：判定链 `adc_health_report`→`syslog_post` 回显尾使 adcTask 静态最坏链 832→**1080 B** → 栈 512→**640 words**（余 1480 B / 57%） |
| 等周波采样（软件测频 + 调频闭环） | 20 点/周波；测频范围建议 **45~55 Hz**（参考 40.5~60.5） | 频率偏移 ±2 Hz 时幅值误差 ≤ 1% | ⬜ |
| 零序通道接入（外部专用 / 自产切换） | 外部 `UN`/`IN`；自产 `3I0 = Ia+Ib+Ic`（V0.2 起） | 零序通道可切换来源，值正确 | ⬜ |
| 二次谐波/五次谐波提取入口 | k=2（涌流）、k=5（选线） | 相量层可产出对应谐波相量 | ✅ 2026-10-11：`phasor.c` 实例表 `C04-IA-F2`（k=2）/ `C05-IA-F5`（k=5）随每拍重算产出，台架心跳日志 `phasor(hb) C04/C05` 行可见（`docs/测试说明/测试数据/boot_log_data/20261011_prod_phasor_boot_log.txt`）；谐波**抑制/提取正确性**已由主机单测覆盖（`test/host/phasor/`） |

> ⚠️ **「双转换器无共同采样触发」约束**：「通道语义映射」中 `UA/UN/IA` 在 TPAFE、`UB/UC/IB/IC/IN` 在 STM32 ADC。V0.1 上 语义取数与有效性只做**逐通道独立监视**，不得假设同族量同刻（`UA` 与 `UB` 无共同采样触发）。

### 3.2 全周傅氏相量计算

| 功能名 | 关键参数 | 完成判据 | 状态 |
| --- | --- | --- | --- |
| 全周傅氏系数表 | `sin(2πk/N)·(√2/N)`、`cos(2πk/N)·(√2/N)`，N=20 | 系数表与 `docs/算法/傅氏算法详解.md` §2.3 一致 | ✅ 2026-10-11：`phasor.c` 离线系数表**预乘 √2/N**；主机单测逐项复核（`test/host/phasor/` 系数表用例） |
| 基波相量实例 | **5 个实例**（参考项目 4 个，见下方注）：`C01-IA-F1` / `C02-UA-F1` / `C03-UN-F1` / `C04-IA-F2` / `C05-IA-F5` | 每实例输出 `{fRe, fIm, fAm, fAmSQ}` | ✅ 2026-10-11：`k_inst[]` 数据驱动 5 实例；台架开机即产出 `phasor(first)` 5 行（`docs/测试说明/测试数据/boot_log_data/20261011_prod_phasor_boot_log.txt`） |
| 相量有效值输出 | `fAmSQ = √(fRe²+fIm²)` 直接为**有效值**（系数已折算） | 标准源读数 = 设定有效值 | ✅ 2026-10-11（链路级）：`fAmSQ` 口径实现 + 单测合成正弦幅值误差 ≤1%；**"标准源读数"判据在无信号源台架不可达**（同 §7.1），待「通道标定（一次系数 + 零漂）」标定后复核 |
| 相位输出 | `φ = atan2(fIm, fRe)` | 相位误差 ≤ 目标值 | ✅ 2026-10-11（链路级）：`fRe/fIm` 常驻双区、每拍产出，φ 由消费侧 `atan2f` 现算（不常驻结构体，见 `docs/算法/采集与算法层设计说明.md` §6）；单测覆盖相位；**目标值待产品定义 + 标准源复核** |
| 线/负序/零序合成 | 线电压 `Uab=Ua−Ub` 等；负序 `3U2`/`3I2`；零序 `3U0`/`3I0` | 合成相量可复用于保护元件（**V0.1 仅同转换器内可合成**，见 §1.6） | ⬜ **V0.1 不适用**：跨转换器合成被「双转换器无共同采样触发」禁止；零序走**外部专用通道** `UN`/`IN`（§6.4），无需自产 → 随 V0.2 启用 |
| 每 1 ms 滑动窗刷新 | 每来新点，窗滑动一格、20 点重算（暴力法） | 相量每拍更新 | ✅ 2026-10-11：`sample_ring` 40 点环 + `phasor_run()` 每拍整窗重算（仅 `r==1` 新帧压环，P0 修复）；台架 `ring` 随 `frames` 同步递增、`idle=0` |
| 双区指针原子交换 | 计算区/使用区切换 | 保护元件读使用区，无撕裂 | ✅ 2026-10-11：`s_zone[2][5]` + 单字节 `volatile` 切换（Cortex-M 原子）；单测覆盖双区交换；为独立 保护判据任务预留无锁读 |
| 遥测谐波轨（可选） | k=1~9，方和根 `√(ΣHk²)` | 与基波轨并行，供 UI/上送 | ⬜ |

> **双轨有效值**：保护要"基波有效值 + 相位"（抗衰减直流、抗谐波误动）；计量/遥测要"真有效值"（谐波方和根）。两者**不可混用**——这是参考系统 `CN_ANA_VEC_SQRT=FALSE` 与遥测谐波轨并存的根本原因。

> **「基波相量实例」实例数 4 → 5 的来历**：参考项目（`APP/CLS100_Dsp/InstCalCell.c`）为 **4 个实例**——C01 基波 I/U、C02 零序基波、C03 二次谐波、C04 五次谐波。本项目按 V0.1 **有效通道**（`UA`/`UN`/`IA`，见 §1.6：`UB/UC/IB/IC/IN` 无中点偏置 → 削顶不可用）展开：C01 的"I/U"拆为两行（`C01-IA-F1` 电流 / `C02-UA-F1` 电压），其余顺延为 `C03-UN-F1` 零序、`C04-IA-F2` 二次、`C05-IA-F5` 五次。实现见 `App/algo/phasor.c` 的 `k_inst[]`；判据按 **5** 个实例断言（见 `docs/测试说明/单元测试/相量层单元测试说明.md` §2.6）。

> **本表状态列口径**（2026-10-11 更新）：「全周傅氏系数表」~「相位输出」/「每 1 ms 滑动窗刷新」/「双区指针原子交换」已**实现 + 主机单测（57 用例）+ 台架 `/serial-boot-test` 闭环**——闭环命令 `run_boot_test.py --required "...;phasor(first);phasor(hb)" --require-order "App init OK>phasor(first)>phasor(hb)"`，证据 `docs/测试说明/测试数据/boot_log_data/20261011_prod_phasor_boot_log.txt`（`fw build` 身份戳匹配、回读一致、锚点 ×1、零 `[ERR]`）。⚠ **幅值/相位精度判据（标准源）在无信号源台架上不可达**（同 §7.1 无示波器口径），且「通道标定（一次系数 + 零漂）」标定未实现 → 现读数为**原始码值**，只证明链路通；精度复核排在标定之后。「线/负序/零序合成」随 V0.2（双转换器无共同采样触发），「遥测谐波轨（可选）」可选项未做。

### 3.3 保护判据元件

采用参考系统的**统一接口模式**：每元件一个 `tagPRS_XXX` 配置结构（定值号、模拟通道号、KI/KO、标志位、校验和）+ `Init` / `Main`（判据）/ 出口函数。

**核心集（P0/P1）**

| 元件 | 判据要点 | 关键定值 | 状态 |
| --- | --- | --- | --- |
| 三段式相间过流 | 相电流基波 > 定值，经延时出口；返回系数滞回 | Ⅰ/Ⅱ/Ⅲ 段电流 + 延时 | 🔶 2026-10-11 主机实现：`App/algo/prot_elm.c` 通用"滞回+定时限"核 + `prot_set.c` 定值（Ⅰ/Ⅱ/Ⅲ 段，A 相 `IA`），单测 27 用例含 1.01× 启动/100 ms 到点/滞回保持/返回释放；**板端接线已落地（B5，2026-10-12：protectTask 20 ms 节拍，动作经 104 YX16~18 上送）**；出口（出口与记录）待做 |
| 三段式零序过流 | 零序电流 > 定值，经延时出口 | Ⅰ/Ⅱ/Ⅲ 段零序电流 + 延时 | ⬜（双转换器无共同采样触发：`IN` 走 STM32，V0.2 使能；框架已就绪，加实例表一行即可） |
| 过负荷 | 相电流 > 定值，告警/跳闸可整定 | 过负荷电流 + 延时 | 🔶 同「三段式相间过流」（`OL-IA` 实例，默认告警不跳闸；板端接线随 B5 落地，YX23 上送） |
| 过压 / 欠压 | 相/线电压越限，经延时出口 | 过压定值、失压定值 + 延时 | 🔶 同「三段式相间过流」（`OV-UA`/`UV-UA`，欠量方向单测覆盖；沿用参考告警段 0x8027/0x8029） |
| 过频 / 低频 | 频率越限，经延时出口 | 过频、低频定值 + 延时 | ✅ 软件侧完成（B8，2026-10-12）：`freq` 层测频（自适应窗，45~55 Hz 扫频最坏 **0.0101 Hz** / 1% 噪声 0.0160 Hz）+ `OF/UF` 实例（51.0/49.0 Hz、dly 1000 ms、返回系数 0.99/1.01，本地定值 8 项）；OF/UF 暂无独立遥信点，动作仅经 YX15 总聚合可见（独立分点 + 注入验收 = B10） |
| 零序过压 | 零序电压 > 定值 | 零序过压定值 + 延时 | 🔶 同「三段式相间过流」（`3U0-UN` 实例，外部零序电压通道，不受双转换器无共同采样触发限制） |

**扩展集（P2/P3）**

| 元件 | 判据要点 | 状态 |
| --- | --- | --- |
| 涌流制动 | 二次谐波占比 > 制动系数，闭锁差动/过流 | ⬜ |
| PT 断线 | 电压突变/负序判据，闭锁电压类保护 | ⬜ |
| CT 断线 | 电流不平衡判据，闭锁 | ⬜ |
| 母线接地告警 | 零序电压 + 零序电流组合 | ⬜ |
| 故障启动（波形启动） | 突变量启动，触发录波/启动元件 | ⬜ |
| 无压/无流闭锁 | 低电压或低电流时闭锁过流 | ⬜ |

**延后集（受双转换器无共同采样触发 / 产品定义制约）**

| 元件 | 制约 |
| --- | --- |
| 方向元件 / 功率方向 | 需跨转换器相位一致 → V0.1 不可做 |
| 重合闸 | FTU 专有，视 B0 产品定义 |
| 手动跳闸 / 遥控 | 依赖出口硬件与协议定义 |

> **V0.1 可行性**：上表按元件类型分组，但**V0.1 上能否闭环**取决于通道（见 **§1.6**）——核心集中 `IA`/`UA`/`UN` 可做（A 相过流、过负荷、过压/欠压、零序过压），**三段式零序过流与 B/C 相过流本期不可做**（`IN`/`IB`/`IC` 削顶）；扩展集「涌流制动」~「无压/无流闭锁」多依赖三相，本期**建接口不使能**。

### 3.4 出口与记录

| 功能名 | 说明 | 状态 |
| --- | --- | --- |
| 跳闸出口（KO） | 判据满足 → 驱动出口继电器，带保持/脉冲 | ⬜ |
| 告警出口 / 信号 | 告警类动作驱动信号灯/继电器 | ⬜ |
| 出口自检 | 出口回路检测（若有回读） | ⬜ |
| SOE 记录 | 带时标的事件顺序记录 | ✅（B9，2026-10-12：`/log/soe.log` 64 B 定长记录 = 类型 + 元件号 + seq(u32) + CP56Time2a + epoch + 校验和；台架 FTP 下载解码 PASS，时标与 104 CP56 交叉一致） |
| 动作记录 | 保护动作/返回记录，落 `/log/soe.log` | ✅（B9，2026-10-12：六类边沿全覆盖——元件动作/复归、软压板投/退、采样数据块/恢复；protectTask 只投递（SPSC 环，post 禁 DBG），defaultTask `syslog_drain()` 落盘，动作路径无 NAND I/O） |
| 故障录波（可选） | 4000 Hz 内部节拍预留 | ⬜ |

### 3.5 动作留痕自检与闭锁

| 功能名 | 说明 | 状态 |
| --- | --- | --- |
| 定值校验和 | `tagPRS_XXX` 的 `dwTagSum` 自检，定值非法闭锁 | 🔶 2026-10-11：`prot_set.c` 已实现 sum32 正/反码封存 + selfcheck 失配置闭锁（参考 `dwTagSum/dwTagSumN` 模式）；**B7（2026-10-12）竞态收口**：104 定值写改 `prot_set_set_sealed`（影子区写+封存后单字交换）+ selfcheck seqlock 式复核（提交撞见 = 本轮跳过），B5 登记的 µs 级误锁窗口消除；定值持久化 `/prot_set.bin`（blob 带 sum32 正/反码对，整表原子装载）；元件级 tagPRS 常量表校验仍待补 |
| 采样通道自检 | 通道码值越界/静默检出 | 🔶 静默/丢帧/序号倒退/错误增量已由「采样有效性校验」 `adc_health` 检出（2026-10-11）；码值越界待做 |
| 硬件自检 | 出口回路、电源、时钟 | ⬜ |
| 自检失败闭锁 | 任一项失败 → 闭锁相关保护并告警 | 🔶 定值闭锁 → 全元件复位已联动（`prot_elm_eval` 读 `prot_set_locked()`，单测覆盖）；**采样故障闭锁已落地（B5，2026-10-12）**：protectTask 每拍读 `adc_health_flags()` 电平位（TPAFE/STM32 stall + 序号倒退）→ 命中即 `prot_elm_init()` 复位 + 本拍不判据，自愈后自动恢复；锁存类事件位（FRSTDATA/HW_ERR）不构成"当前测量不可信"→ 不闭锁，如实登记 |

---

## 4. 性能指标

### 4.1 实时性

| 指标 | 目标值 | 依据 |
| --- | --- | --- |
| 保护节拍 | **1 ms** | 参考 `CN_PROTECT_PERIOD=1000 µs` |
| 保护采样率 | **1000 Hz**（20 点/周波 @ 50 Hz） | 全周傅氏窗长 |
| 相量刷新周期 | **1 ms** | 每来一点重算 |
| 遥测刷新周期 | **200 ms** | 参考遥测链周期 |
| 出口动作时间 | ≥ 1 周波（20 ms）算法窗 + 定值延时 | 全周波算法固有延时 |
| 内部总线节拍 | 4000 Hz（80 点/周波） | 参考 `CN_WAVE_RATIO=4`（本项目按需裁剪） |

### 4.2 精度

| 指标 | 目标值 | 说明 |
| --- | --- | --- |
| 基波幅值误差 | ≤ 1%（频偏 ±2 Hz 内） | 依赖等周波采样 |
| 相位误差 | ≤ 目标角误差（依产品定义） | 依赖调频闭环 |
| 测频范围 | 建议 45~55 Hz（参考 40.5~60.5） | `CN_HERTZ_SOFTFR_MIN/MAX` |
| 定值折算 | 定点系数 `2^10` | 与参考一致 |
| 遥测微调 | ±10%，0.1% 步长（TLV10） | 参考口径 |

> **误差来源与预算**（参考《ADC采集至数据使用全流程详解》[计划] §12）：采样量化（TPAFE LSB ≈ 152.6 µV）、通道标定残差、窗长偏离整周波（频偏）、系数定点舍入。前三项决定可达精度，最后一项可忽略。

### 4.3 算力与内存预算

| 项 | 估算 | 说明 |
| --- | --- | --- |
| 傅氏乘加 | 20 点 × 2（sin/cos）× 相量数 / 拍 | 参考用暴力法（CPU 余量足够）；本项目 168 MHz + FPU 需实测 |
| 相量区 RAM | `tVectorRly[2][N] × sizeof(相量)` | 双区 + **5 实例**（本项目；参考项目 4 实例） |
| 采样缓冲 RAM | 40 点/通道 × 通道数 × 字宽 | 双缓冲 2 周波 |
| 定值区 RAM | 元件数 × 定值项 × 字宽 | 可由 cfg_file 载入 |
| 任务栈 | `adcTask` ✅ / `protectTask` ✅（B5：512 words，静态链 872 B / 余 57%） | 建任务前后各跑 `scripts/stack_report.py` |

> ⚠️ **改内存相关代码后必须刷新快照**：`/keil-build` 出 `.map` 后跑 `scripts/check_mem_numbers.py --write`，同步 `docs/内存管理/RAM使用分析与优化方案.md` §2.1（`mem-numbers` 钩子会因体积变化 FAIL）。

### 4.4 频率跟踪

- **原理**：软件测频（对电压/电流信号过零点或相角差测频）→ 调整采样定时器周期 → 使窗长恒等于实际周波（严格 20 点/周波）。
- **闭环**：测频 → 周期修正 → 采样 → 再测频；参考用片内 EHRPWM 调频，本项目用 TIM 重装载值调整。
- **必要性**：窗长偏离整周波会破坏正交性，直流与二次谐波漏入测量（见 `docs/算法/傅氏算法详解.md` §3）。

---

## 5. 定值参数模型

定值分三类：**固有参数**（只读）、**运行参数**（可整定）、**保护定值**（可整定）；地址口径来自 B0（§1.5 表 1，源参考项目 `APP/EquipCfg/Const_CommPara.c`）。

### 5.1 定值分类与地址

| 类 | 地址范围 | 内容 | 属性 |
| --- | --- | --- | --- |
| 固有参数 | `8001H~800AH` | 终端类型/操作系统/制造商/硬件版本/软件版本/校验码/规约类型/型号/ID/MAC | 只读 |
| 运行参数 | `8020H~8058H` | 死区（电流/交流电压/直流电压/功率/频率/功率因数）、PT/CT 变比、负荷越限/重载/过载报警、录波投退与定值、功率置负 | 可整定 |
| 保护定值 | `8820H~8882H` | 过流 I/II/III 段、零序过流 I/II 段、重合闸、低压/低频、励磁涌流闭锁、小电流接地等 | 可整定 |

### 5.2 定值项模型（`tagPRS_XXX`）

每元件一个配置结构：**定值号 / 模拟通道号 / KI·KO 标志 / 校验和** + `Init` / `Main` / 出口函数。定值项与元件一一绑定，便于逐元件自检（「定值校验和」）。

### 5.3 折算与存储

| 维度 | 参考 | 本项目 |
| --- | --- | --- |
| 折算 | `wCoeEEP` / `wCoeCal` / `wCoeRet`，定点系数 `2^10` | 同模型（工程量 ↔ 码值） |
| 载体 | EEPROM 定值文件 | cfg_file（`/config.ini`，NAND + FatFs），新增定值段 |
| 微调 | TLV10 ±10%，0.1% 步长 | cfg_file 微调段（按需） |

### 5.4 定值项清单（按元件）

| 元件 | 定值项（拟） | 单位 |
| --- | --- | --- |
| 过流（A 相） | I 段/II 段/III 段电流定值 + 各段延时 | A / s |
| 过负荷 | 过负荷电流定值 + 延时 + 投退 | A / s |
| 过压 / 欠压 | 过压定值、欠压定值 + 延时 | V / s |
| 零序过压 | 零序过压定值 + 延时 | V / s |
| 过频 / 低频 | 过频定值、低频定值 + 延时 | Hz / s |
| 公共 | 返回系数、PT/CT 变比、通道标定系数 | — |

> ⚠️ **待补**：逐项**取值范围 / 步长 / 默认值**取自参考项目 `APP/EquipCfg/Const_CommPara.c` 的 `CommPara_ConfigTable`（`0x8020~0x8882`）；本表在实现各保护元件时逐项落实（见 §10.3）。
>
> **2026-10-25 运行参数段落实进度**：这一项已落 `App/algo/run_par.c`——本仓自定逐项地址
> 0x8030~0x8038（死区 9 点）/ 0x8040~0x804F（k/b 覆盖直通 adc_cal），表与理由见
> `docs/子系统设计/IEC104上行设计说明.md` §3.4；**送检点表到位后以送检为准替换常量段**。
> 变比/报警/录波/功率置负等其余运行参数类项目前无消费者，留白不预埋。
>
> **2026-10-11 落实进度**：`App/algo/prot_set.c` 已建 RAM 模型（Q10 定点，31 项），**通讯地址逐项对照参考 `Comm/Pub/Const_CommSetPara.c` `g_tCommSetParaTab`**（基址 0x8820：过流 Ⅰ/Ⅱ/Ⅲ = 0x8856~0x8861、过负荷 = 0x8871~0x8874、零序过压 = 0x888E~0x8890；过压/欠压沿用告警段 0x8027~0x802A）。⚠ **默认值/范围为拟定值**（参考 EEPROM 出厂默认表不在本仓库，按 DTU 馈线典型量级拟定），待对照参考出厂表逐项修订。

---

## 6. 平台适配与差异处理

### 6.1 采样源差异

| 维度 | 参考系统 | 本项目 | 适配要点 |
| --- | --- | --- | --- |
| AD 器件 | 专用同步采样 AD | TPAFE5160（16 位、8 通道同步、±5 V）+ STM32 ADC1（12 位、顺序、0~3.3 V） | 统一到"工程量"层，屏蔽码值差异 |
| 通道数 | 8 实通道（4U+4I，自产零序） | 8 路电气量（4U+4I）+ 温度 | 语义映射见 `docs/硬件平台/ADC通道映射说明.md` |
| 同一时刻性 | 单芯片同步 | **跨转换器无共同触发**（登记簿条目「双转换器无共同采样触发」） | V0.1 只做逐通道独立监视 |
| 量程/精度 | 一致 | TPAFE LSB ≈ 152.6 µV vs STM32 LSB ≈ 806 µV | 同族量不可统一算法处理 |

### 6.2 双转换器无共同采样触发：影响与降级口径

- **V0.1 现板**：主板侧只做**逐通道独立监视**（有效值/越限/温度）；**禁止**跨转换器的同周期相位、功率、功率因数、矢量类运算。
- **受影响功能**：方向元件、功率方向、差动类——延后（「方向元件 / 功率方向」）。
- **V0.2 改版后**：8 路电气量全部接 TPAFE（与 5 路备用路对调串联电阻目的地，BOM 不变），上层语义与代码**不动**，只改映射表内容 → 保护层无需重构。
- **接口设计启示**：**按语义取数、不写死下标**，是 V0.2 平滑升级的前提。

### 6.3 单核 vs 双核

| 维度 | 参考（ARM+DSP） | 本项目（单核） | 适配 |
| --- | --- | --- | --- |
| 保护计算 | DSP 核独占 | 与 FreeRTOS 任务共享 CPU | 保护任务优先级最高；避免长临界区 |
| 管理/通信 | ARM 核 | 同核分任务 | 依赖现有任务优先级体系 |
| 隔离 | 核间隔离 | 无 | 靠任务优先级 + 栈预算 + 看门狗保证实时性 |

### 6.4 零序：外部专用通道 vs 自产

- 参考：TLV13 选择映射表——外部零序（专用通道）或**自产零序**（`3I0 = Ia+Ib+Ic`）。
- 本项目 V0.1 实况（**2026-10-10 更正**，此前"V0.1 无专用零序通道"的表述作废）：
  - **有外部零序专用通道**——`UN`（零序电压，TPAFE）与 `IN`（零序电流，STM32 ADC），对应点表 `4014` / `4018`；
  - **自产零序在 V0.1 不可行**：`Ia` 在 TPAFE、`Ib`/`Ic` 在 STM32，求和属**跨转换器**（双转换器无共同采样触发）。
- 于是本期：**零序过压**（`UN`，TPAFE，测量有效）可做；**零序过流**（`IN`，STM32 削顶 → 无有效值）不可做。
- V0.2（8 路电气量全上 TPAFE）后可自产，外部/自产可切换（恢复 TLV13 语义）。
- 落点：「零序通道接入（外部专用 / 自产切换）」。

### 6.5 定值存储

| 维度 | 参考 | 本项目 |
| --- | --- | --- |
| 载体 | EEPROM 定值文件 | cfg_file（`/config.ini`，NAND + FatFs） |
| 折算 | `wCoeEEP` 定点 | 同模型（工程量 ↔ 码值） |
| 微调 | TLV10 ±10% | cfg_file 微调段（按需） |

---

## 7. 分阶段实施路线图

### 7.1 阶段划分与里程碑

| 阶段 | 名称 | 内容 | 前置 | 里程碑 |
| --- | --- | --- | --- | --- |
| **P0** | 采样与相量底座 | B1（周期 CONVST + `adcTask` 消费 + 建任务 + 栈预算）+ 语义取数与有效性 + 全周傅氏相量 | B0 + B1 ✅ | 每 1 ms 产出正确的基波相量 —— **✅ 2026-10-11 台架闭环**（「采样有效性校验」同日落地 ✅；「通道标定（一次系数 + 零漂）」标定 / 「等周波采样（软件测频 + 调频闭环）」等周波为 P0 遗留项，精度复核依赖标准源） |
| **P1** | 基础保护元件 | **V0.1 有效子集**：过流（A 相，`IA`）、过负荷（A 相）+ 定值模型；B/C 相过流**建接口不使能** | P0 | 标准源注入 A 相可正确动作 —— 🔶 **软件侧 2026-10-11 完成**（`prot_set` 定值模型 30 用例 + `prot_elm` 元件框架/过流三段/过负荷 27 用例，主机全绿）；**板端接线已落地（B5，2026-10-12：protectTask + IWDG bit8 + 栈核算 + 104 YX 上送）**；标准源注入验收待做 |
| **P2** | 电压/频率类保护 | 过压/欠压（`UA`）、过频/低频、零序过压（`UN`） | P0 | 电压/频率越限正确动作 —— 🔶 过压/欠压/零序过压随 P1 同批主机完成（同框架实例）；过频/低频 ✅ **B8 已落地（2026-10-12）**：freq 层（自适应窗，扫频最坏 0.0101 Hz）+ OF/UF 实例；出口独立遥信点与注入验收归 B10 |
| **P3** | 异常检测与闭锁 | 动作留痕自检闭锁、采样通道自检；三相类（涌流/PT·CT 断线/母线接地）**建接口不使能** | P1/P2 | 自检失败闭锁；未使能元件不误动 |
| **P4** | 出口、记录与定值集成 | 出口与记录、§5 定值模型落 cfg_file、UI 显示、上送 | P1 | 动作出口 + SOE 记录 + UI 显示闭环（**定值持久化 + 软压板 + 竞态收口 = B7 完成 2026-10-12，台架腿已验 ✅**；**SOE/动作记录 = B9 完成 2026-10-12 ✅**：protectTask 边沿→SPSC 环→defaultTask 落盘 `/log/soe.log`，protectTask 静态链 872 B 不变，自发 YX 上送 M_SP_TB_1 带时标；出口继电器「跳闸出口（KO）」~「出口自检」仍 ⬜——V0.1 无出口硬件，跳闸维持否定确认 R7 口径） |
| **P5** | 方向/功率类（延后） | 「方向元件 / 功率方向」方向元件等 | V0.2 硬件 / 子板计量 | 跨转换器相位一致后实现 |

> ⚠️ **V0.1 硬件裁剪**（2026-10-10，详见 §1.6）：V0.1 上只有 TPAFE 三路（`UA`/`UN`/`IA`）测量有效。故 **P0 骨架全做**（与通道无关），**P1/P2 只做有效通道子集**——A 相过流、A 相过负荷、过压/欠压、零序过压、过频/低频；**三相过流（B/C 相）、零序过流、方向/功率类、PT/CT 断线**依赖 V0.2 硬件（修复「双转换器无共同采样触发」+ 中点偏置），本期**建接口不使能**。

### 7.2 每阶段交付物与验收判据

| 阶段 | 交付物 | 验收判据 |
| --- | --- | --- |
| P0 | `adcTask`/`algo` 模块（采集触发 + 语义映射 + 标定 + 全周傅氏 + 双区交换）+ 设计文档 + 主机侧纯逻辑单测 | TPAFE 三路（`UA`/`UN`/`IA`）标准源读数误差 ≤ 目标；相量每 1 ms 刷新；`/serial-boot-test` 通过 |
| P1 | A 相过流 + A 相过负荷元件 + 定值模型 | 注入 1.2×/0.9× 定值，A 相正确动作/返回；返回系数正确 |
| P2 | 过压/欠压 + 过频/低频 + 零序过压元件 | 越限动作时间符合定值延时 |
| P3 | 自检闭锁 + 采样通道自检；三相类元件建接口 | 自检失败闭锁；未使能元件不误动 |
| P4 | 出口 + 记录 + 定值 UI | 动作驱动出口；SOE 带正确时标；UI 显示实时值 |
| P5 | 方向元件 | 需 V0.2 前置条件满足 |

### 7.3 依赖关系图

```text
B0 产品定义 ✅（2026-10-10 已确认，见 §1.5）
   └─ B1 ADC 采集链路（周期 CONVST + adcTask + 建任务 + 栈预算）
          └─ P0 采样与相量底座
                ├─ P1 基础保护（A 相过流/过负荷）
                │      └─ P4 出口/记录/定值
                ├─ P2 电压/频率保护（UA/UN）
                └─ P3 异常检测与闭锁（自检；三相类不使能）
                       └─ P5 方向/功率类（依赖 V0.2 硬件 / 子板计量）
```

---

## 8. 测试与验证

### 8.1 测试分层

| 层 | 对象 | 方式 |
| --- | --- | --- |
| 静态门禁 | 代码规范、文档链接、体积 | pre-commit 钩子（`cppcheck` / `doc-links` / `mem-numbers`） |
| 主机侧纯逻辑单测 | 傅氏相量、定值解析、保护判据（**算法与 I/O 分离**后天然适格） | `test/host/<模块>/run_unit_test.py`（MSVC 离线编译真实源文件，参考 `test/host/cfg_file/run_unit_test.py`） |
| 语义取数与有效性板端套件 | 采样/相量/保护元件 | `test/run_all_suites.py` 板端套件 |
| 全周傅氏相量/保护判据台架 | 标准源注入、动作出口、时序 | 台架闭环（COM6 @115200） |

### 8.2 `docs/任务规划/暂缓-RS485.md`「采集链路测试可验证性约束」落实

`docs/任务规划/暂缓-RS485.md`「采集链路测试可验证性约束」对采集链路提出三条设计约束，保护层须一并满足：

1. **协议解析与硬件 I/O 分离**——保护判据函数只吃相量 + 定值，可单测；
2. **采集缓冲双缓冲 + 序号**——防撕裂（单测测不出时序撕裂，须设计上消除）；
3. **DE 收尾超时路径**（RS-485，若保护涉及 485 通信）。

### 8.3 验收判据（保护层）

- 标准源注入：幅值/相位/频率读数误差在目标内（**V0.1 限 TPAFE 三路**）；
- 定值动作：1.2× 定值可靠动作、0.9× 定值可靠返回，返回系数符合 `wCoeRet`；
- 时序：动作时间 = 算法窗（≥20 ms）+ 定值延时，误差在允许范围；
- 闭锁：自检失败工况下相关保护可靠闭锁（V0.1 的 PT/CT 断线、涌流闭锁待 V0.2）；
- 记录：SOE/动作记录时标正确（注意板载 RTC 比墙钟慢约 8 h）。

---

## 9. 风险与开放问题

| # | 风险 / 开放问题 | 影响 | 处置方向 |
| --- | --- | --- | --- |
| R1 | **V0.1 硬件裁剪保护范围**（双转换器无共同采样触发 + 无中点偏置 → 仅 TPAFE 三路 `UA`/`UN`/`IA` 测量有效） | 三相过流 / 零序过流 / 方向功率类本期无法闭环 | 本期做有效通道子集（§1.6）；其余随 V0.2 硬件启用 |
| R2 | **双转换器无共同采样触发（硬件缺陷）** | 方向/功率/矢量类无法在 V0.1 实现 | V0.2 硬件改版；V0.1 取子板计量 |
| R3 | **单核算力** | 1 ms 节拍内完成傅氏 + 全部保护元件 | 实测 CPU 余量；必要时裁剪遥测谐波轨或降低元件扫描频率 |
| R4 | **等周波调频实现** | 频偏时精度不达标 | TIM 重装载调频；先固定 1000 Hz 跑通再上闭环 |
| R5 | **STM32 侧无中点偏置** | 交流量负半周削顶，无法算 RMS | V0.1 只做监视；V0.2 补偏置 |
| R6 | **栈预算** | 新任务栈溢出 | 建任务前后跑 `scripts/stack_report.py`；纳入看门狗 |
| R7 | **出口硬件未确认** | 跳闸出口无法验证 | 确认出口继电器/回读电路；无硬件时先做逻辑级验证 |

---

## 10. 附录

### 10.1 参考系统关键常量

| 常量 | 值 | 含义 |
| --- | --- | --- |
| `CN_PROTECT_PERIOD` | 1000 µs | 保护中断周期 |
| `CN_SAM_HERTZ` | 50 | 系统频率（Hz） |
| `CN_SAM_RATE` | 20 | 每周波采样点数 |
| `CN_SAM_RATIO` | 1 | 保护采样倍率 |
| `CN_YCSAM_RATIO` | 2 | 遥测采样倍率 |
| `CN_WAVE_RATIO` | 4 | 录波倍率（4000 Hz） |
| `CN_BUFSAM_CYCLE` | 2 | 采样缓冲周波数 |
| `CN_BUFSAM_LEN` | 40 | 采样缓冲长度（点） |
| `CN_ANA_VEC_SQRT` | FALSE | 保护用基波有效值（非方和根） |
| `CN_ANA_DIF` | FALSE | 半周波/差分组件关闭 |
| `CN_HERTZ_SOFTFR_MIN/MAX` | 40.5 / 60.5 Hz | 软测频范围 |
| `CN_NUM_YCHUMWAVE` | 9 | 遥测谐波次数上限（`(20>>1)−1`） |
| `CN_NUM_YCAVER` | 4 | 遥测平均点数 |
| 系数定点 | `2^10` | 标定系数定标 |

### 10.2 术语表

| 术语 | 含义 |
| --- | --- |
| 全周傅氏 | 全周波傅里叶算法，单频 DFT，得基波相量 |
| 相量 | `{fRe, fIm, fAm, fAmSQ}`，实部/虚部/幅值/有效值 |
| 等周波采样 | 软件测频 + 调频，保持严格 20 点/周波 |
| 外部零序 | 专用 `UN`/`IN` 通道直接取零序量 |
| 自产零序 | `3I0 = Ia+Ib+Ic` 软件合成（V0.2 起可用） |
| 双区交换 | 相量计算区/使用区指针原子切换 |
| 时间片表 | 单点/2点/4点/8点调度表 |
| TLV | 参考系统的参数通道（定值/微调/映射） |
| 返回系数 | 动作值/返回值之比（滞回） |

### 10.3 待确认清单

1. 定值逐项取值范围/步长/单位/默认值——源参考项目 `Const_CommPara.c`，实现各元件时落实（见 §5.4）。
2. 出口硬件形态（继电器/回读）——依硬件（R7）。
3. 等周波调频范围与精度目标——依产品定义（R4）。
4. 是否保留遥测谐波轨（k=1~9）——依 UI/上送需求。