wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity

docs(产品需求): 需求基线拆薄为三档（大厂标准），doc-links 增别名解析

Browse Source 
产品需求设计文档.md v1.9 → v2.0（2691 → 1816 行）：
- 新增 §2 背景·目标用户·典型场景·成功指标，§3.2 产品级非目标表，
  §4 P0/P1/P2 需求总览（19 行）；§9 收窄为缺口清单与推进顺序。
- 拆出 docs/产品需求/参考产品复刻明细.md（803 行）：复刻基线 +
  定值/遥测/开入开出/事件/元件/录波/记录/规约逐项差额与完成判据。
- 拆出 docs/架构设计/系统架构与硬件规格.md（215 行）：运行时架构
  （就绪位表/机制表/启动时序）+ V0.1 硬件规格；与项目架构总览
  定分工——位表/机制表/时序图/引脚表以新档为准。

引用同步：AGENTS.md 引脚表指针改指系统架构与硬件规格 §2.2；
docs/README.md 目录树与索引四处重写；故障录波三处「录波采样率」
行指针改指复刻明细 §7；PRD §11 补两新档指针。

门禁工具：check_doc_links.py 裸名解析增别名后缀匹配（「见需求档
§5.16」形态），§ 链遇紧邻已登记别名换目标；section_aliases.json
登记 需求档 / 架构硬件档 / 复刻明细(档) / 产品需求设计文档 /
系统架构与硬件规格。

终验：doc --all rc=0（3038 处 / 可判定 80%）；mermaid --all 64 围栏
0 命中；改动文件字节卫生全过；新旧逐行差集审计无丢行。
This commit is contained in:
Wanderingss
2026-10-30 12:36:31 +08:00
parent 6ffbb7d5b5
commit dc964090ea
9 changed files with 1203 additions and 1030 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+1 -1
View File
@@ -137,7 +137,7 @@
## 硬件引脚
- **完整引脚表（含 SD2506 I2C1、SWD、调试口）→ `docs/产品需求/产品需求设计文档.md` §4.2**（权威，V0.1 口径；勿在本文重复抄表）
- **完整引脚表（含 SD2506 I2C1、SWD、调试口）→ `docs/架构设计/系统架构与硬件规格.md` §2.2**（权威，V0.1 口径；勿在本文重复抄表）
- ⚠ **网名 `AINn` ≠ 板级 `ADCn` ≠ 转换器通道号**（17 路里 13 路置换）→ 取数**必须查** `docs/硬件平台/ADC通道映射说明.md`（TPAFE `buf[2]=IA`/`buf[5]=UN`/`buf[6]=UA`；网名 ADC17=PC4 用 `ADC_CHANNEL_14`，**不是** `ADC_CHANNEL_12`）
- ⚠ **8 路电气量被分给两片转换器是 V0.1 硬件缺陷，不是有意分配**（跨转换器无共同采样触发 → 无同一时刻性、相位不确定）→ V0.1 上**禁止**跨转换器做相位/功率/功率因数/矢量运算；**V0.2 须把 8 路全接 TPAFE**（登记簿条目「双转换器无共同采样触发」）
docs/README.md
+6 -4
View File
@@ -12,8 +12,8 @@
docs/
├── README.md 本索引（阅读顺序 + 全量清单）
├── 任务规划/ 统一待办（README 单一入口 + 6 个职责文件）
├── 产品需求/ 产品需求设计文档（面向产品的需求基线）
├── 架构设计/ 全局架构与设计方法论
├── 产品需求/ 产品需求设计文档（需求基线）+ 参考产品复刻明细（逐项差额）
├── 架构设计/ 全局架构与设计方法论（含 系统架构与硬件规格：位表/引脚权威）
├── 子系统设计/ 各功能子系统的设计说明
├── 算法/ 傅氏算法与继电保护算法专题
├── 网络/ BSD Socket API 使用与内部实现
@@ -41,7 +41,7 @@ docs/
| 顺序 | 文档 | 读它能得到什么 |
|:---:|---|---|
| 1 | [`产品需求设计文档.md`](产品需求/产品需求设计文档.md) | 产品定位、功能/非功能需求、接口规范、UI 规格、路线图与验收判据 |
| 1 | [`产品需求设计文档.md`](产品需求/产品需求设计文档.md) | 产品定位·用户·场景、优先级总览、功能/非功能需求、接口规范、UI 规格、路线图与验收判据（架构与硬件规格见 [`系统架构与硬件规格.md`](架构设计/系统架构与硬件规格.md)，复刻逐项差额见 [`参考产品复刻明细.md`](产品需求/参考产品复刻明细.md)） |
| 2 | [`项目架构总览.md`](架构设计/项目架构总览.md) | 六层分层、启动时序、存储/网络/UI 三栈、目录组织 |
| 3 | [`项目启动顺序管理.md`](架构设计/项目启动顺序管理.md) | Event Flags 就绪屏障（取代魔法延时）的任务启动模型 |
| 4 | [`项目部署环境要求.md`](环境与部署/项目部署环境要求.md) | 开发机/目标板/现场部署的完整环境核对清单 |
@@ -62,7 +62,8 @@ docs/
| 文档 | 内容 |
|---|---|
| [`产品需求设计文档.md`](产品需求/产品需求设计文档.md) | **面向产品的需求基线**：产品定位与形态、六层架构与任务模型、V0.1 硬件规格、功能需求（网络/存储/时间/配置/日志/UI/看门狗/LED + 待实现的 ADC/RS-485）、接口规范（RemoDispBus / 对时 / FTP / 配置 / 串口）、非功能需求（可靠性/性能/内存/门禁/双端）、UI 规格、待实现项与路线图、验收判据 |
| [`产品需求设计文档.md`](产品需求/产品需求设计文档.md) | **面向产品的需求基线**：背景·目标用户·典型场景、范围与产品级非目标、需求总览（P0/P1/P2）、功能需求（网络/存储/时间/配置/日志/UI/看门狗/LED/ADC/RS-485/测频/保护/定值/SOE/104/屏板链路）、接口规范（RemoDispBus / 对时 / FTP / 配置 / 串口）、非功能需求（可靠性/性能/内存/门禁/双端）、UI 规格、缺口清单与推进顺序、验收判据 |
| [`参考产品复刻明细.md`](产品需求/参考产品复刻明细.md) | **1:1 复刻的逐项差额权威**：参考源码能力清单（复刻基线）、104 地址空间、定值 249 项、遥测/开入开出/动作事件/元件/录波/记录/规约逐项明细、复刻完成判据、屏板链路复刻任务规划 |
---
@@ -71,6 +72,7 @@ docs/
| 文档 | 内容 |
|---|---|
| [`项目架构总览.md`](架构设计/项目架构总览.md) | 系统全景：六层分层、启动时序、存储·网络·UI 栈、目录组织 |
| [`系统架构与硬件规格.md`](架构设计/系统架构与硬件规格.md) | 就绪位表 / 线程通信机制表 / 启动时序图 / V0.1 引脚表与硬件未确认项（H1~H3）——**位表、机制表、时序图、引脚表以本档为准**（自产品需求档拆出） |
| [`STM32F4-Base存储架构说明.md`](架构设计/STM32F4-Base存储架构说明.md) | GD5F2GQ5UE SPI NAND 之上的三层存储软件栈（FTL / dhara / FatFs） |
| [`项目启动顺序管理.md`](架构设计/项目启动顺序管理.md) | CMSIS-RTOS v2 Event Flags 就绪屏障（`SYS_EVT_NET_READY` 等） |
| [`图形绘制流程.md`](架构设计/图形绘制流程.md) | 文档配图规范：SVG 生成器 / Mermaid 选型与检查清单 |
docs/产品需求/产品需求设计文档.md
+144 -1019
View File
File diff suppressed because it is too large Load Diff
docs/产品需求/参考产品复刻明细.md
+803
View File
@@ -0,0 +1,803 @@
# STM32F4-Base 参考产品复刻明细（CLS100）
> **文档定位**：1:1 复刻口径下**「参考有什么 / 我们有什么 / 差额在哪 / 怎么算做完」**的
> 逐项明细权威——自 `docs/产品需求/产品需求设计文档.md` v1.9 的「复刻基线」章与
> 原「复刻缺口明细」各节（v1.9 编号 2.5 与 9.4~9.13）拆出：本文 §1 = 复刻基线，
> 本文 §2~§11 = 各专题逐项明细。
> **范围口径、缺口清单与排期（需求档 §3 / 需求档 §9.1~需求档 §9.3）仍在需求档**；本档只放明细。
> 本档「**需求档**」= [`产品需求设计文档.md`](产品需求设计文档.md)；「架构硬件档」=
> [`../架构设计/系统架构与硬件规格.md`](../架构设计/系统架构与硬件规格.md)。
> 判定纪律：所有参考能力数字一律从参考工程源码常量表实测
> （`Scatter_P_HV03.01_SV01.01`），不做估计。
## 1. 复刻基线（参考源码能力清单）
**判定口径**：本节所有"参考能力"的数字，**一律从参考工程源
（实测已发现"89 个元件模块"实为 45 个、定值"约 260 项"实为 249 项两处偏差）。
### 1.1 复刻基线三要素
1. **点表即契约**：参考源码用常量表（`g_t*Tab[]`）定义点表、定值、事件、压板。
这些表就是"要复刻什么"的**唯一清单**——表有几行，目标就有几个点。
2. **地址即接口**：104 的 IOA 由 `Rly_IEC104.h` 的基址宏划分段，**段基址必须逐字对齐**（需求档 §1.3）。
3. **模块即元件**：`RelayUnit/` 下一个 `.c` 对应一个保护元件，元件数 = 文件数（本文 §1.5）。
### 1.2 能力清单与复刻进度（源码实测）
| # | 能力 | 参考源码出处 | 参考数量 | 本产品现状 | 状态 |
|---|---|---|---|---|---|
| 1 | 定值项 | `APP/EquipCfg/Const_Set.c` `g_tSetModelTab` | **249 项** | 40 项（`PS_ID_COUNT`） | 🔶 |
| 2 | 定值单元 | `APP/EquipCfg/Const_Set.h` `EN_SET_CELL_*` | **23 个有项**（枚举 28） | 5 组（短路/接地/过负荷/电压/频率） | 🔶 |
| 3 | 104 定值映射 | `Comm/Pub/Const_CommSetPara.c` `g_tCommSetParaTab` | **107 项**，`0x8820~0x8891` | 40 项（`0x8820~0x8890` 局部） | 🔶 |
| 4 | 遥测 YC | `APP/EquipCfg/Const_Ana.c` `g_tYcIndexTab` | **31 点** | 9 点（`0x4011~0x4018` + `0x401D`） | 🔶 |
| 5 | 遥测模型 | 同上 `g_tAnaModelTab` | 35 行 | 0 | ⬜ |
| 6 | 电度 YM | 同上 `g_tYmIndexTab` | **8 种** | 0 | ⬜ |
| 7 | 开入 KI | `APP/EquipCfg/Const_IO.c` `g_tInputModelTab` | **138 点** | 0（无硬件，X3） | ⬜ |
| 8 | 开出 KO | 同上 `g_tOutputModelTab` | **31 点** | 0（无硬件，X3） | ⬜ |
| 9 | 动作事件 | `APP/EquipCfg/Const_Rec.c` `g_tActRecTab` | **33 条**（421~453） | 7 类记录（`App/log/sys_log.h`） | 🔶 |
| 10 | 录波测量通道 | 同上 `g_tMeasureModelTab` | **65 通道** | 8（本波口径，2026-10-29 代码面已交付；65 通道仍为 0，参考机口径未改）| 🔶 |
| 11 | 软压板 | `APP/EquipCfg/Const_Soft.c` `g_tSoftTab` | **9 面**（表容量 32） | 1 面（`PS_GLOBAL_EN`） | 🔶 |
| 12 | 保护元件 | `RelayUnit/*.c` | **45 个模块** | 9 个实例 | 🔶 |
| 13 | 记录队列 | `RecUnit/RecFile.c` + `GlobalDef/Const_Sys.h` | **13 类**（128/256 条） | 8 通道（7 文本 + SOE） | 🔶 |
| 14 | 自检类型 | `GlobalUnit/SelfChk.c` | **3 类型 + 2 闭锁** | 3 类 | ✅ |
| 15 | 故障录波 | `APP/EquipCfg/Const_Wave.h` | **3 类型 / 6 段 / RAM 16 个** | 0 | ⬜ |
| 16 | 采样节拍 | `APP/EquipCfg/Const_VisEquip.h` | **20 点/周波**（50 Hz） | 20 点/周波（1000 Hz） | ✅ |
| 17 | 上行规约 | `Comm/Pub/`、`Comm/Mon/` | **12 种** | 1 种（104） | 🔶 |
| 18 | 加密算法 | `Comm/Ecc/` | SM2 / SM3 / ECDSA | 0 | ⬜ |
| 19 | 双核分工 | `CLS100_Arm/`、`CLS100_Dsp/` | ARM + DSP | 单核（X1） | — |
| 20 | 远端屏与按键链路 | `HMI/RemoeDisp/RemoDispBus.c`、`HMI/Dsp/Key.c`、`HMI/Dsp/Disp_Pub.c`；屏板侧 `DTU-LCD` | **串口屏板通道**（显存 3200 B + **状态灯 4 B 位掩码**下行 / 键号上行）+ **TCP 7003 镜像** | 7003 四命令已通；**串口屏板通道整条缺失**（协议已按屏板源码定版，见需求档 §5.16.2）；INIT 应答 8 B（参考 29 B，其中 13 B 颜色信息**不对齐**）、无断点续传、无链路监视、缺 F1/F2 | 🔶 |
> **读法**：🔶 / ⬜ 行**全部是待办**，逐条对应 需求档 §9.1；`—` 只出现在 X1~X4 不可移植项上。
> 本表是范围判定的唯一出处，需求档 §9 不再重复解释"为什么缺"。
### 1.3 104 地址空间（段基址逐字对齐）
| 段 | 基址 | 范围 | 容量 | 本产品使用 |
|---|---|---|---|---|
| 遥信 YX | `0x0001` | `0x0001~0x1000` | 4096 | 定义 1~31，有效 6（YX15~18/23/31） |
| 保护 BH | `0x1001` | `0x1001~0x4000` | 12288 | 0 |
| 遥测 YC | `0x4001` | `0x4001~0x5000` | 4096 | `0x4011~0x4018`、`0x401D` |
| 参数 PM | `0x5001` | `0x5001~0x6000` | 4096 | 0 |
| 遥控 YK | `0x6001` | `0x6001~0x6200` | 512 | `0x600A`（信号复归）、`0x600B`（全局压板） |
| 设定 YS | `0x6201` | `0x6201~0x6400` | 512 | 0 |
| 电能 YM | `0x6401` | `0x6401~0x6600` | 512 | 0 |
| 步位置 STEP | `0x6601` | `0x6601~0x6700` | 256 | 0 |
> ⚠ **段基址是 `0x4001` / `0x6001`，不是 `0x4000` / `0x6000`**。参考源码
> `Comm/Pub/Rly_IEC104.h` 的 `CONST_104_BASEADDR_YC` / `_YK` 明确 1 起编
> （注释即写 `4001-5000H`、`6001-6200H`）。本仓 v1.1 及更早文档按 `4000H+` / `6000H+` 描述
> 属笔误，以本表为准；需求档 §5.15、需求档 §6.8 已同步更正。
### 1.4 定值单元（23 个有项单元，合计 249 项）
| 单元 | 语义 | 项数 | 本产品 |
|---|---|---|---|
| `EN_SET_CELL_WatchDog` | 看门狗功能 | 63 | ⬜ |
| `EN_SET_CELL_SYS3` | 系统参数 | 45 | 🔶 |
| `EN_SET_CELL_VolTimeRecv` | 电压时间型自愈 | 17 | ⬜ |
| `EN_SET_CELL_AutoReCls` | 重合闸 | 16 | ⬜ |
| `EN_SET_CELL_SYN` | 同期元件（FTU 型） | 13 | ⬜ |
| `EN_SET_CELL_OverCurI0` | 接地告警 | 13 | 🔶 |
| `EN_SET_CELL_VolPro` | 电压保护 | 13 | 🔶 |
| `EN_SET_CELL_WAVESTART` | 录波启动 | 12 | ⬜ |
| `EN_SET_CELL_MeaLimit` | 遥测越限 | 10 | ⬜ |
| `EN_SET_CELL_OverCurSpeed` | 过流加速 | 8 | ⬜ |
| `EN_SET_CELL_SYS1` | PT 参数 | 6 | 🔶 |
| `EN_SET_CELL_SYS2` | CT 参数 | 4 | 🔶 |
| `EN_SET_CELL_Auto_FG` | 自动分闸 | 4 | ⬜ |
| `EN_SET_CELL_Auto_HH` | 自动合闸 | 4 | ⬜ |
| `EN_SET_CELL_InRush` | 励磁涌流闭锁 | 3 | ⬜ |
| `EN_SET_CELL_OverCur` | 短路告警 | 3 | 🔶 |
| `EN_SET_CELL_VolQuaRate` | 电压合格率 | 3 | ⬜ |
| `EN_SET_CELL_FZDDL` | 非遮断电流闭锁 | 3 | ⬜ |
| `EN_SET_CELL_BHKO` | 保护出口展宽 | 2 | ⬜ |
| `EN_SET_CELL_MeaRecord` | 遥测记录 | 2 | ⬜ |
| `EN_SET_CELL_PowerSet` | 功率电压设置 | 2 | ⬜ |
| `EN_SET_CELL_PTBreak` | PT 断线告警 | 2 | ⬜ |
| `EN_SET_CELL_AutoCtrl` | 自动控制（活化/复归） | 1 | ⬜ |
> 枚举中另有 4 个单元在参考源码表内**无项**（`EN_SET_CELL_YB_TY` 功能软压板、`OnceCch`
> 一次重合闸、`TwiceCch` 二次重合闸、`OverLoad` 过负荷保护）——已被条件编译或注释掉，
> 因此 249 项分布在 **23** 个单元而非枚举的 28 个。另有 3 个单元（`SYN` / `OverCurSpeed` /
> `VolTimeRecv`）受 `CN_DEV_TYPE_FTU` 宏控制，属 FTU 型专属。
>
> **104 定值地址编排**：107 项占 `0x8820~0x8891` 连续段中的 107 个地址，**8 个空洞**
> （`0x8822`、`0x8823`、`0x883E`、`0x883F`、`0x8842`、`0x8851`、`0x8852`、`0x8853`）
> 对应参考源码中被注释掉的 4 条映射（`ULTV_PARA_2`、`ULTV_Phase` 等）。
### 1.5 保护元件（45 个模块 → 覆盖 8 个模块 / 9 个实例）
按功能归类（`RelayUnit/` 文件名去 `PRS_` 前缀）：
| 类别 | 元件模块 | 个数 | 本产品 |
|---|---|---|---|
| 过流类 | `OverCurrent`、`OverCurrent_I0`、`OverCurrent_SpeedUp`、`OverCurrentI0_SpeedUp`、`FZDOverCur`、`OverCurWarn`、`OverCurWarn_I0`、`OverLoad` | 8 | 🔶 过流 Ⅰ/Ⅱ/Ⅲ + 过负荷（4） |
| 电压类 | `OverVol`、`OverVol_U0`、`LackVol`、`LineHaveVol`、`HaveVolCls`、`NoVolTrip`、`PTBreak`、`CTBreak` | 8 | 🔶 过压 / 欠压 / 零序过压（3） |
| 频率类 | `OverFr`、`LackFr` | 2 | ✅ 过频 / 低频（2） |
| 重合闸 | `AutoReCls`、`AutoReCls_JD`、`OnceCch`、`TwiceCch`、`ConnectBrkCls` | 5 | ⬜ |
| 方向 / 功率 | `DirCell`、`PowDirJudge`、`PowerSet`、`YcOverLimit` | 4 | ⬜ |
| 涌流 / 故障 | `InRushCur`、`FaultIsola`、`FaultRecov`、`BusEarthAlm`、`SgzAlarm` | 5 | ⬜ |
| 自动控制 | `AutoCtrlTrip`、`ManualTrip`、`MusterRecov`、`ExvRec`、`ExvRecGW` | 5 | ⬜ |
| 记录类 | `SOERecord`、`CORecord`、`FrzRecord`、`YcMeaRecord`、`YcMeaLimitRec`、`YcVolQuaRate` | 6 | 🔶 SOE 落盘（1，非判据元件） |
| 录波 / 采样 | `WaveQdCell`、`RlyCommSam` | 2 | ⬜ |
**判据结构对齐**（以 `PRS_OverCurrent.c` 为样板，三段过流共用一个核）：
```
M_GRly_OverRelay(&bRelay, fAmp, fSetStart, fSetRet) 越限 + 返回系数滞回
∧ bFyOpen ∧ bDirOpenX ∧ bNOVOpen 复压 / 方向 / 低压闭锁
GRly_TimeRelay(&bRelay, &tTimer, dwSetDelay, CN_T10MS) 定时限（10 ms 基准）
tTimer_KeepKI 电流保持（返回后仍延时保持）
tTimer_NoUI 无压无流判据（CN_T20MS / CN_T200MS）
```
> 本产品 `prot_elm.c` 的"越限 + 返回系数滞回 + 定时限"三元核与上述结构**同构**；
> 差异在于本产品用**每元件独立实例表**替代参考的全局定时器数组——这是单核移植的必要调整，
> 不改变判据语义。逐元件复刻计划见
> [`docs/算法/继电保护功能复现规划.md`](../算法/继电保护功能复现规划.md)。
### 1.6 上行规约全集（12 种 → 已复刻 1 种；加密算法另计）
| 方向 | 规约 | 参考源码 | 本产品 |
|---|---|---|---|
| 主站侧（对上） | IEC 60870-5-101 | `Comm/Pub/Rly_IEC101.c`、`Rly_IEC101_B.c` | ⬜ |
| | IEC 60870-5-102（电度） | `Comm/Pub/Rly_IEC102.c` | ⬜ |
| | IEC 60870-5-103 | `Comm/Pub/RLY_IEC103.c`、`RLY_IEC103-tcp.c`、`Rly_IEC103T.c` | ⬜ |
| | **IEC 60870-5-104** | `Comm/Pub/Rly_IEC104.c` | ✅ |
| | ModBus | `Comm/Pub/Rly_ModBus.c` | ⬜ |
| | CDT | `Comm/Pub/Rly_Cdt.c` | ⬜ |
| | 国标电度 `Whm_GB` | `Comm/Pub/Whm_GB.c` | ⬜ |
| | IEC 61850（MMS / GOOSE / SV） | `Comm/Pub/struct61850.h`、`GlobalUnit/SttnLvlGoose.c` | ⬜ |
| | CAN | `Comm/Pub/Rly_Can.h` | ⬜ |
| 子站侧（对下） | IEC 101（含 ABB / 西门子 / 无优先级变体） | `Comm/Mon/Rtu_IEC101*.c` | ⬜ |
| | IEC 104（含调试 / RIS 变体） | `Comm/Mon/Rtu_IEC104.c`、`Rtu_Dbg104.c`、`Rtu_RIS104.c` | ⬜ |
| | BALA101 / ModBus | `Comm/Mon/Rtu_BALA101*.c`、`Rtu_ModBus.c` | ⬜ |
| 加密 | SM2 / SM3 / ECDSA | `Comm/Ecc/` | ⬜ |
> **排期判断**：104 已对齐；**对下 ModBus RTU 与 101 是"配网终端"的必要项**（接一次开关 / FTU），
> 与 RS-485 簇同批解冻；61850 依赖以太网多播与 MMS 栈，单核 M4 资源上需单独评估，属最末批。
### 1.7 差异归因与结论
| 归因 | 涉及条目 | 解除方式 |
|---|---|---|
| **外部资源**（标准源、端子变比） | 定值标定、保护判据解卡 | 两点标定（需求档 §9.2 第 4 步） |
| **硬件缺失**（X3 / X4） | 开入 138、开出 31、电度 8、同期、三相通道 | V0.2 硬件 |
| **立项未排** | 多规约、SNTP、定值铺开 | 按需求档 §9.2 顺序。**录波最小闭环已交付代码面**（2026-10-29，卡片 `docs/任务规划/故障录波.md`、设计 `docs/子系统设计/故障录波设计说明.md`；1 kHz 起步与本文 80 点/周波口径的偏离在该设计文档 §2 显式登记）；**4 kHz 全速、多段、COMTRADE、104 文件传输仍未排**，属二期范围 |
| **算力 / 形态**（X1 / X2） | 双核分工、VxWorks | 不解除。**屏板链路已从范围外项移入范围内**（规格见需求档 §5.16，主机侧实现 `docs/子系统设计/屏板链路设计说明.md`；串口通道已实现，网络通道未做）：主机侧链路与参考 1:1 同构，不属"替代方案" |
> **结论**：本产品与参考产品的差距**全部是"进度"而非"范围"**——没有一项是"参考有而我们不做"。
> 已对齐的是**软件骨架**（采样节拍、相量算法、定值模型、104 上行、SOE 落盘、自检闭锁）；
> 未对齐的是**点表规模**（249 / 31 / 138 / 31 / 33 / 65 vs 40 / 9 / 0 / 0 / 7 / 0）
> 与**独立子系统**（录波、电度、多规约）。因此需求档 §9 统一表述为"复刻进度"，不再出现"不做"。
---
## 2. 定值复刻明细（参考 249 项 → 本产品 40 项）
参考定值表的每一行固定 **21 个字段**：标识 ×2 / 类型（数值 | 枚举）/ 所属单元 / 单位组 / 值类型 /
最小值 / 最大值 / 步长 / 两个标志 / 上下限原始值 ×3（`0xAA` / `0xAAAA` / `0xFF`）/ 104 地址 /
单位 ×2 / 小数位 / 长度 / 显示名 / 结束标记。
本产品对应物是 `App/algo/prot_set.h` 的 `PS_*` 枚举（`PS_ID_COUNT = 40`）。
**40 项的去向必须能对上账**，否则"还差多少"无从谈起：
| 去向 | 项数 |
|---|---|
| 覆盖参考定值项 | **35** |
| 本产品本地扩展项（参考无对应行） | **5**（`PS_RET_OVER` / `PS_RET_UNDER` 返回系数，`PS_RET_OF` / `PS_RET_UF` 频率返回系数，`PS_GLOBAL_EN` 全局软压板） |
| **合计** | **40** |
因此**定值差额 = 249 − 35 = 214 项**。
### 2.1 23 个定值单元逐单元差额
| 单元 | 语义 | 参考项数 | 本产品覆盖 | 差额 |
|---|---|---|---|---|
| `WatchDog` | 过流三段 / 零序三段 / 过负荷 / 重载 / 过载 / 过频 / 低频 | 63 | 22 | **41** |
| `SYS3` | 系统参数（零飘、死区、变比、防抖、脉宽、FA 模式…） | 45 | 0 | **45** |
| `VolTimeRecv` | 电压时间型馈线自动化（失电分闸 / 得电合闸 / 联络） | 17 | 0 | **17** |
| `AutoReCls` | 重合闸 | 16 | 0 | **16** |
| `SYN` | 同期（FTU 型） | 13 | 0 | **13** |
| `OverCurI0` | 接地告警（小电流接地选线） | 13 | 0 | **13** |
| `VolPro` | 电压保护（失压 / 过压 / 零序过压） | 13 | 9 | 4 |
| `WAVESTART` | 录波启动 | 12 | 0 | **12** |
| `MeaLimit` | 遥测越限 | 10 | 0 | **10** |
| `OverCurSpeed` | 过流 / 零序后加速 | 8 | 0 | **8** |
| `SYS1` | PT 参数 | 6 | 2 | 4 |
| `SYS2` | CT 参数 | 4 | 2 | 2 |
| `Auto_FG` | 延时自动分闸 | 4 | 0 | 4 |
| `Auto_HH` | 延时自动合闸（电池活化） | 4 | 0 | 4 |
| `InRush` | 励磁涌流闭锁 | 3 | 0 | 3 |
| `OverCur` | 短路告警 | 3 | 0 | 3 |
| `VolQuaRate` | 电压合格率 | 3 | 0 | 3 |
| `FZDDL` | 非遮断电流闭锁 | 3 | 0 | 3 |
| `BHKO` | 保护出口展宽 | 2 | 0 | 2 |
| `MeaRecord` | 遥测记录周期 | 2 | 0 | 2 |
| `PowerSet` | 功率电压组 | 2 | 0 | 2 |
| `PTBreak` | PT / 控回断线告警 | 2 | 0 | 2 |
| `AutoCtrl` | 自动复归 | 1 | 0 | 1 |
| **合计** | | **249** | **35** | **214** |
> 单元名 `WatchDog` 有误导性：它装的是**全部保护元件的动作定值**（过流 / 零序 / 负荷 / 频率），
> 不是看门狗参数。移植时不要按名字去找"看门狗定值"。
### 2.2 已覆盖单元的逐项对照（35 项）
**过流三段：参考 24 项，本产品 12 项**（每段缺 4 项，共缺 12）
| 参考项（Ⅰ/Ⅱ/Ⅲ 段各一份） | 本产品 | 说明 |
|---|---|---|
| 过流 n 段投入 | `PS_OCn_EN` | ✅ |
| 过流 n 段跳闸投入 | `PS_OCn_TRIP` | ✅ 语义 = 0 告警 / 1 跳闸 |
| 过流 n 段定值 | `PS_OCn_CUR` | ✅ 二次值 A |
| 过流 n 段延时 | `PS_OCn_DLY` | ✅ ms（参考为 S，换算在整定入口） |
| 过流 n 段方向投入 | — | ❌ 无方向元件（`DirCell` / `PowDirJudge` 未复刻） |
| 过流 n 段低压投入 | — | ❌ 无复压闭锁（`bNOVOpen` 无来源） |
| 过流 n 段告警投入 | — | ❌ 参考把"告警投退"与"跳闸投退"拆成两项，本产品只有一项 |
| 过流 n 段低压定值 | — | ❌ 同上 |
> **这一处差额最容易被低估**：本产品的三段过流是"简化版三段"，参考的三段每段还带
> **方向 / 低压 / 告警** 三个独立开关和一个低压定值。缺这四项时，三段过流只能做无方向、
> 无复压闭锁的纯过流保护——在环网或双电源线路上会误动。
**零序过流三段：参考 18 项，本产品 0 项**
参考在 `WatchDog` 内另有完整的零序三段（每段 6 项：投退 / 方向 / 告警投入 / 跳闸 / 定值 / 时限）。
本产品 `PS_3U0_*` 三项是**零序过压**（属 `VolPro`），**不是零序过流**——两者不可混为一谈：
零序过流看 `3I0` 幅值，零序过压看 `3U0` 幅值。因此零序过流保护目前**完全没有定值载体**，
`OverCurrent_I0` 元件也无从判据。
**过负荷 / 重载 / 过载：参考 12 项，本产品 4 项**
| 参考项组 | 本产品 | 差额 |
|---|---|---|
| 过负荷报警（投退 / 跳闸 / 定值 / 时限） | `PS_OL_*` 4 项 | ✅ 齐 |
| 重载报警（同上 4 项） | — | ❌ 缺 4 |
| 过载报警（同上 4 项） | — | ❌ 缺 4 |
> 参考把"过负荷 / 重载 / 过载"分成三级（默认 150 A / 70 A / 100 A 步长，时限 9000 s / 0 / 0），
> 对应事件 435 / 436 / 437。本产品只有一级过负荷。三级是**同一判据不同门槛**，
> 复刻成本低（元件框架已具备），但需先补 `OverLoad` 的三个实例与三条事件映射。
**过频 / 低频：参考 8 项，本产品 6 项 + 2 本地项**
| 参考项 | 本产品 | 说明 |
|---|---|---|
| 过频 / 低频 保护投退 | `PS_OF_EN` / `PS_UF_EN` | ✅ |
| 过频 / 低频 保护定值 | `PS_OF_HZ` / `PS_UF_HZ` | ✅ 参考单位 HZ 存 5000~5500（0.01 Hz），本产品存 Hz 浮点 |
| 过频 / 低频 保护时限 | `PS_OF_DLY` / `PS_UF_DLY` | ✅ |
| 过频 / 低频 **跳闸**投退 | — | ❌ 缺 2：参考区分"保护投入"与"跳闸投入"，本产品只有前者 |
**电压保护：参考 13 项，本产品 9 项**
| 参考项 | 本产品 | 说明 |
|---|---|---|
| 失压保护投退 / 定值 / 时限 | `PS_UV_EN` / `PS_UV_VOL` / `PS_UV_DLY` | ✅ |
| 过压保护投退 / 定值 / 时限 | `PS_OV_EN` / `PS_OV_VOL` / `PS_OV_DLY` | ✅ |
| 零序过压投退 / 定值 / 时限 | `PS_3U0_EN` / `PS_3U0_VOL` / `PS_3U0_DLY` | ✅ |
| 失压 / 过压 / 零压 **跳闸**投退（3 项） | — | ❌ 缺 3 |
| 零压 **告警**投退（1 项） | — | ❌ 缺 1 |
**PT / CT 参数：参考 10 项，本产品 4 项**
| 参考项 | 本产品 | 说明 |
|---|---|---|
| 母线一次额定（kV） | `PS_PT_PRI` | ✅ 本产品存 V |
| 母线二次额定（线）（V） | `PS_PT_SEC` | ✅ |
| 额定 TA 一次值（A） | `PS_CT_PRI` | ✅ |
| 额定 TA 二次值（A） | `PS_CT_SEC` | ✅ |
| 母线二次额定（相）（V） | — | ❌ 缺：线 / 相两种二次额定的换算关系需显式给出 |
| 零序一次额定（kV） | — | ❌ 缺 |
| 零序二次额定（V） | — | ❌ 缺 |
| 零序一次额定（A） | — | ❌ 缺 |
| 零序二次额定（A） | — | ❌ 缺 |
| PT 接入数目（1~3） | — | ❌ 缺：决定用线电压还是相电压作判据源 |
### 2.3 完全未覆盖单元逐项清单（163 项）
214 项差额中，**51 项**落在 需求档 §2.2 已部分覆盖的四个单元里（过流 12 / 零序 18 / 重载与过载 8 /
频率 2 / 电压 4 / PT·CT 6 / 备用控制字 1），余下 **163 项**落在下面这些**一项都没有**的单元里。
逐项列出以便排期时按"整单元"认领，不要拆散。
**系统参数 `SYS3`（45 项）**——零飘门槛 10 项：额定电压零飘门槛、额定电流零飘门槛、直流电压零飘、
功率零飘、频率零飘、功率因数零飘、相角零飘门槛、备用 ×4；死区 7 项：电流死区、电压死区、
直流电压死区、功率死区、频率死区、功率因数死区、相角死区；开入开出 4 项：开入防抖（10~60000 ms）、
分闸脉宽、合闸脉宽、开入手动分合；变比 5 项：PT 变比、相 CT 变比、零序 CT 变比、功率变比、电量变比；
其余 19 项：开关类型、故障遥信保持时间、功率置负、单项接地选线投入、单相接地跳闸时间、FA 模式、
对时切换长延时、断线告警确认时间、事故总判小电流接地告警、加速段保护开放时间、
重合闸检有压等待时间、连续分闸时间、分闸次数、备用参数 01~08。
> 本产品的死区落在**运行参数段**（`0x8030~0x8038` 九点，RAM 副本 + 104 可写），
> 变比落在 `prot_set` 的 PT/CT 四项。**语义已覆盖、载体不同**——复刻 `SYS3` 时是把这
> 两类合并进定值表，不是重新实现。
**电压时间型自愈 `VolTimeRecv`（17 项）**：就地 FA 模式、LS（0/1，1 = 联络）、
失电分闸投退、失电分闸时限（0~100000 s）、得电合闸投退、X 时间（1~100 s，默认 7）、
故障电流检测、故障电流定值（1~10000 A）、Y 时间（1~100 s，默认 5）、联络开关合闸、
联络充电时限（0~1800 s）、联络合闸时限（0~300 s）、正方向选择、残压定值（0~300 V）、
残压判定时限、停电时间（1~10 s）、人工闭锁。
> 这是**馈线自动化（FA）的核心**：失电分闸 → 得电合闸 → 联络转供。对应元件
> `NoVolTrip` / `HaveVolCls` / `ConnectBrkCls` / `FaultIsola` / `FaultRecov` 五个模块。
> 无开入（开关位置）与出口（分合闸）时**无法闭环**，属 X3 依赖项。
**重合闸 `AutoReCls`（16 项）**：重合闸投退、充电时间（0~100000 s）、重合闸次数（0~3）、
一次 / 二次 / 三次重合闸时间（0~60000 s）、重合闸闭锁时间（0~9900 s）、整组复归时间、
大电流闭锁投退、大电流闭锁定值、重合闸检同期、重合闸检无压、同期检无压定值（0~15000 V）、
同期检角差定值（1~30°）、过流禁止重合闸、零序禁止重合闸。
> 参考支持**三次重合**且每次时间独立可整定，充电时间与整组复归时间分离——这三项
> 是"重合闸能不能用"的关键（无充电时间 = 每次跳闸都立即重合，会连击）。
> 依赖出口（合闸）与开入（开关位置），属 X3 依赖项。
**同期 `SYN`（13 项，FTU 型专属）**：检无压投退、检同期投退、频差 / 角差 / 压差 / 滑差闭锁投退
（4 项）、检无压定值（1000~9999 V）、检频差定值（0~200，0.01 Hz）、检角差定值（1~180°）、
检压差定值（0~9999 V）、检频率滑差值（0~200 Hz/s）、开关合闸时限（0~200 s）、整组复归时间。
> 需**两路电压同刻**（母线侧 + 线路侧）才能算角差与频差——本产品 V0.1 只有一个转换器的
> 电压通道，属 X3 / H1 依赖项。
**录波启动 `WAVESTART`（12 项）**：电流启动投退 / 定值（0~10000 A）、低压启动投退 / 定值
（0~10000 V）、零压启动投退 / 定值（0~30000 V）、零流启动投退 / 定值（0~1000 A）、
零流突变投退 / 定值（0~1000 A）、录波启动延时、保护启动录波。
> 录波启动是**独立于保护判据的触发源**：即使保护不动作，只要越启动值也要录波。
> 本产品无录波子系统，这 12 项无处落地（见 需求档 §7）。
**遥测越限 `MeaLimit`（10 项）**：有压鉴别投退 / 线路有压定值（0~300 V）、无压鉴别投退 /
线路无压定值（0~300 V）、线路有压时限（2~100000 s）、电压越上限 / 越下限（0~100000 V）、
电流越上限（0~10000 A）、越上限延时 / 越下限延时。
> 越限记录（`OVER` 队列，128 条）的判据来源。本产品无越限记录类，故这 10 项也无载体。
**过流后加速 `OverCurSpeed`（8 项）**：后加速投退、线路 1 前加速投退、过流后加速电流值
（1~10000 A）、过流后加速时限（0~10000 s）、零序后加速投退、线路 1 前加速投退（重复项，
参考源码如此）、零序后加速电流值（1~1000 A）、零序后加速时限。
**接地告警 `OverCurI0`（13 项）**：线路接地告警投退、零序电流反极性、零序电压反极性、
接地备用 02、接地告警投退、接地跳闸投退、接地方向投退、接地定值（0~10000 A）、接地时限、
接地跳闸时限（0~600 s）、零压启动定值（1~10000 V）、接地重合投退、接地后加速投退。
> **反极性**两项是现场接线纠错开关（CT / PT 装反时不必改线，改定值即可），
> 属"现场可维护性"需求，不是可选项。
**其余小单元（合计 29 项）**：励磁涌流闭锁 3（闭锁投退、涌流制动系数 1~100、闭锁复归时间）；
短路告警 3（投退 / 时限 / 线路 01 短路电流定值）；电压合格率 3（上限 / 下限定值 0~200 %、周期类型 0~4）；
非遮断电流闭锁 3（电流闭锁投退、停电跳闸投退、非遮断电流值 1~10000 A）；
出口展宽 2（跳闸出口时间、合闸出口时间，1~100000 ms）；
遥测记录 2（遥测记录周期 0~2880、极值记录周期 0~360）；
功率电压组 2（1~4 组）；PT 断线 2（断线告警、控回断线告警）；自动复归 1（自动复归投退）；
延时自动分闸 4（延时复归投退、2:时 1:分 0:秒、延时复归时限 ×2）；
延时自动合闸 4（自动活化投退、2:分 1:时 0:日、自动活化周期 0~360、自动活化时限 0~23000 s）。
---
---
## 3. 遥测复刻明细（参考 31 点 → 本产品 9 点）
参考 `g_tYcIndexTab` 的 31 点是**按"两回线 × 三相 + 线电压 + 零序 + 功率"组织的完整电气量集**。
本产品 9 点（`0x4011~0x4018`、`0x401D`）只覆盖第一回线的相量与频率。
| # | 参考遥测 | 参考枚举 | 本产品 | 差额原因 |
|---|---|---|---|---|
| 1 | 1 回 A 相电流 | `EN_YCMEA_IA01` | `0x4015` ✅ | |
| 2 | 1 回 B 相电流 | `EN_YCMEA_IB01` | `0x4016` ✅ | 削顶 → 恒 IV |
| 3 | 1 回 C 相电流 | `EN_YCMEA_IC01` | `0x4017` ✅ | 削顶 → 恒 IV |
| 4 | 2 回 A 相电流 | `EN_YCMEA_IA02` | — | ❌ 无第二回线 |
| 5 | 2 回 B 相电流 | `EN_YCMEA_IB02` | — | ❌ |
| 6 | 2 回 C 相电流 | `EN_YCMEA_IC02` | — | ❌ |
| 7 | 1 回 A 相电压 | `EN_YCMEA_UA1` | `0x4011` ✅ | |
| 8 | 1 回 B 相电压 | `EN_YCMEA_UB1` | `0x4012` ✅ | 削顶 → 恒 IV |
| 9 | 1 回 C 相电压 | `EN_YCMEA_UC1` | `0x4013` ✅ | 削顶 → 恒 IV |
| 10 | 2 回 A 相电压 | `EN_YCMEA_UA2` | — | ❌ |
| 11 | 2 回 B 相电压 | `EN_YCMEA_UB2` | — | ❌ |
| 12 | 2 回 C 相电压 | `EN_YCMEA_UC2` | — | ❌ |
| 13 | 1 回 AB 线电压 | `EN_YCMEA_UAB1` | — | ❌ 需两相相量之差 |
| 14 | 1 回 BC 线电压 | `EN_YCMEA_UBC1` | — | ❌ |
| 15 | 1 回 CA 线电压 | `EN_YCMEA_UCA1` | — | ❌ |
| 16 | 2 回 AB 线电压 | `EN_YCMEA_UAB2` | — | ❌ |
| 17 | 2 回 BC 线电压 | `EN_YCMEA_UBC2` | — | ❌ |
| 18 | 2 回 CA 线电压 | `EN_YCMEA_UCA2` | — | ❌ |
| 19 | 1 回零序电流 | `EN_YCMEA_3I01` | `0x4018` ✅ | 近似对齐（本产品为外部零序通道） |
| 20 | 1 回零序电压 | `EN_YCMEA_3U01` | `0x4014` ✅ | 近似对齐 |
| 21 | 2 回零序电压 | `EN_YCMEA_3U02` | — | ❌ |
| 22 | 频率 | `EN_YCMEA_FR1` | `0x401D` ✅ | |
| 23 | 直流 1 | `EN_YCMEA_DC_01` | — | ❌ 无直流采样通道 |
| 24 | 直流 2 | `EN_YCMEA_DC_02` | — | ❌ |
| 25 | A 相有功 | `EN_YCMEA_PA_1` | — | ❌ 需跨转换器同刻（H1） |
| 26 | B 相有功 | `EN_YCMEA_PB_1` | — | ❌ |
| 27 | C 相有功 | `EN_YCMEA_PC_1` | — | ❌ |
| 28 | 总有功 | `EN_YCMEA_P_1` | — | ❌ |
| 29 | 总无功 | `EN_YCMEA_Q_1` | — | ❌ |
| 30 | 总视在 | `EN_YCMEA_S_1` | — | ❌ |
| 31 | 功率因数 | `EN_YCMEA_COS_1` | — | ❌ |
**缺的 22 点按依赖分三批**：
| 批次 | 点数 | 内容 | 依赖 |
|---|---|---|---|
| 线电压与功率 | 13 | 6 线电压 + 7 功率/功率因数 | **H1**：电压在 TPAFE、电流在 STM32 ADC1，无共同触发，功率的 `U×I` 需同刻 |
| 第二回线 | 7 | 2 回 6 相量 + `3U02` | 采样通道数（V0.2 硬件） |
| 直流 | 2 | `DC_01` / `DC_02` | 无直流采样通道 |
> 线电压本身**不一定要等 H1**：`Uab = Ua − Ub` 只需同一转换器内的两相相量，
> 若两相都落在 TPAFE 侧即可算。当前 `Ub`/`Uc` 削顶（在 STM32 侧），所以连带算不出。
> **先解决"三相电压全落 TPAFE"这一件事，能一次解锁 6 个线电压点**。
**遥测模型 `g_tAnaModelTab`（35 行）**：参考为每个遥测点定义死区、变比、系数、越限档等属性行，
是"点表 + 整定"的合体。本产品的对应物拆成了三处：`iec104_pts.c` 的 YC 表（地址 + 死区系数）、
`run_par.c` 的死区九点、`adc_cal.c` 的 k/b。复刻模型表 = 把这三处收敛成一张可整定的表。
**电度 `g_tYmIndexTab`（8 种，本产品 0）**：正向有功 `Pt1`、正向无功 `Qt1`、Q1 象限、Q4 象限、
反向有功 `Pt0`、反向无功 `Qt0`、Q2 象限、Q3 象限。地址段 `0x6401~0x6600`。
电度 = 功率对时间积分，**与功率同批解锁**（同一 H1 依赖）。
---
---
## 4. 开入 / 开出复刻明细（138 + 31 → 本产品 0）
参考把"开入"分成四类，本产品**一个都没有**（无硬件，不可移植项 X3）。
**开入 138 点的构成**：
| 类别 | 点数 | 含义 |
|---|---|---|
| 软遥信 `EN_KI_SOFTYX_*` | **104** | 由保护元件/逻辑产生的内部状态，不占物理端子（如"过流Ⅰ段动作""重合闸充电完成""FA 投入"） |
| 硬件开入 `EN_KI_*` / `EN_KIA_*` | **27** | 物理端子：开关合位 / 分位 / 未储能 / 就地远方 / 接地位置 / 隔离位置 / 停用重合闸 / 保护投入 / 检修压板 / 远方信号 / 就地 FTU 手合手分 / 电源输入 / 活化状态 / 电池欠压 / 活化投入 |
| 双点遥信 `EN_KI_TWIN_YX_*` | **6** | 开关位置用双点表达（00 中间态 / 01 分 / 10 合 / 11 无效） |
| 多态遥信 `EN_KI_INT8U_*` | **1** | 8 位状态量（如"设备状态"枚举） |
> **104 点 ≠ 104 个端子**。真正要接线的是 27 个硬件开入；104 个软遥信是**元件输出**，
> 只要元件复刻出来就自然存在。这个区分决定了工作量估算：不是"买 138 路开入板"，
> 而是"27 路端子 + 104 个元件状态映射"。
**开出 31 点的构成**：
| 类别 | 点数 | 明细 |
|---|---|---|
| 出口类 | **11** | 保跳 1（`BH_TZ1`）、保合 1（`BH_HZ1`）、遥分 1（`YT01`）、遥合 1（`YH01`）、遥分 2（`YT02`）、遥合 2（`YH02`）、电池活化（`DCHH`）、活化退出（`DCHH_Esc`）、信号复归（`FG`）、开入变位（`KICHANGE`）、录波启动（`WAVE_START`） |
| 信号类 | **20** | 事故信号 `SignTV`、运行 `SignRun`、通信中断 `SignCOMM`、硬件故障 `SignHW`、储能 `SignCN`、电池欠压 `SignBatQY`、失电 `SignSD`、过负荷 `SignGL`、接地 `SignJD`、闭锁 `SignBM`、备用 `SignBS`、自检 `SignCHK`、重合 `SignCH`、备用 3 个 `SignBAK1~3`、告警 `SignALM`、保护动作 `SignPro`、就地 FA `SignJDFA`、集中 FA `SignJZFA` |
> 本产品当前**保护动作只体现为遥信 + SOE**，没有任何物理出口。这在"保护测控装置"的
> 定义里是硬缺口：保护判据做得再准，不跳闸就等于没保护。X3 解除前，`YX` 里的
> 动作类遥信必须**如实标 IV**，不能让主站误以为已跳闸。
---
---
## 5. 动作事件复刻明细（参考 33 条 → 本产品 9 条）
参考 `g_tActRecTab` 的 33 条动作事件编号 **421~453**，是"保护动作 → 事件码 → 记录 → 上送"的
中间层。本产品用 `App/log/sys_log.h` 的七类记录 + SOE，**没有事件码表**。
| 事件码 | 参考事件 | 本产品 | 说明 |
|---|---|---|---|
| 421 | 线路励磁涌流闭锁 | ❌ | `InRushCur` 未复刻 |
| 422 | 线路Ⅰ段过流保护动作 | ✅ | `PS_OC1_*` |
| 423 | 线路Ⅱ段过流保护动作 | ✅ | `PS_OC2_*` |
| 424 | 线路Ⅲ段过流保护动作 | ✅ | `PS_OC3_*` |
| 425 | 线路零序Ⅰ段过流保护动作 | ❌ | 无零序过流定值载体 |
| 426 | 线路零序Ⅱ段过流保护动作 | ❌ | 同上 |
| 427 | 线路零序Ⅲ段过流保护动作 | ❌ | 同上 |
| 428 | 线路后加速保护动作（过流） | ❌ | `OverCurrent_SpeedUp` 未复刻 |
| 429 | 线路后加速保护动作（零序） | ❌ | `OverCurrentI0_SpeedUp` 未复刻 |
| 430 | 零序过压保护动作 | ✅ | `PS_3U0_*` |
| 431 | 线路欠压保护动作 | ✅ | `PS_UV_*` |
| 432 | 线路过压保护动作 | ✅ | `PS_OV_*` |
| 433 | 高频保护动作（过频） | ✅ | `PS_OF_*` |
| 434 | 低频保护动作 | ✅ | `PS_UF_*` |
| 435 | 线路过负荷保护动作 | ✅ | `PS_OL_*` |
| 436 | 线路重载保护动作 | ❌ | 三级负荷只做了一级 |
| 437 | 线路过载保护动作 | ❌ | 同上 |
| 438 | 线路接地保护动作 | ❌ | `OverCurI0` 未复刻 |
| 439 | 一次重合动作 | ❌ | 重合闸未复刻 |
| 440 | 二次重合动作 | ❌ | 同上 |
| 441 | 三次重合动作 | ❌ | 同上 |
| 442 | 接地重合动作 | ❌ | 同上 |
| 443 | 接地后加速动作 | ❌ | 同上 |
| 444 | 失电分闸动作 | ❌ | `NoVolTrip` 未复刻 |
| 445 | 得电合闸动作 | ❌ | `HaveVolCls` 未复刻 |
| 446 | 闭锁合闸动作 | ❌ | 需开入（闭锁压板） |
| 447 | 闭锁分闸动作 | ❌ | 同上 |
| 448 | 联络开关合闸动作 | ❌ | `ConnectBrkCls` 未复刻 |
| 449 | 联络开关分闸动作 | ❌ | 同上 |
| 450 | 保护动作备用 02 | — | 参考即备用 |
| 451 | A 相故障 | ❌ | 需分相判别（三相全接） |
| 452 | B 相故障 | ❌ | 同上 |
| 453 | C 相故障 | ❌ | 同上 |
> **本产品覆盖 9 / 33 条**。注意 428 与 429 在参考源码里**同名**（都叫"线路后加速保护动作"），
> 靠事件码区分过流与零序——移植时不能按名字去重。
>
> 事件码缺失的连带后果：**事故报告（`CN_NUM_QUE_REC_RPT` 队列）无法生成**。
> 参考的事故报告是按事件码索引动作时序的，没有事件码表就没有"保护动作报告"这一页。
---
---
## 6. 保护元件复刻明细（参考 45 个模块 → 本产品 8 个）
**模块级口径**：参考 `RelayUnit/` 45 个 `.c` 文件 = 45 个元件模块。本产品覆盖 **8 个模块**
（7 个判据模块 + 1 个记录模块），以 **9 个实例**落地（`OverCurrent` 一个模块出三段实例）。
| 类别 | 参考模块 | 本产品 | 缺 |
|---|---|---|---|
| 过流类 | 8 | 2（`OverCurrent`、`OverLoad`） | **6** |
| 电压类 | 8 | 3（`OverVol`、`OverVol_U0`、`LackVol`） | **5** |
| 频率类 | 2 | 2（`OverFr`、`LackFr`） | 0 |
| 重合闸 | 5 | 0 | **5** |
| 方向 / 功率 | 4 | 0 | **4** |
| 涌流 / 故障 | 5 | 0 | **5** |
| 自动控制 | 5 | 0 | **5** |
| 记录类 | 6 | 1（`SOERecord`） | **5** |
| 录波 / 采样 | 2 | 0 | **2** |
| **合计** | **45** | **8** | **37** |
**缺的 37 个模块，逐个给出"缺它意味着什么"**：
| 模块 | 类别 | 判据要点 | 缺它的后果 | 依赖 |
|---|---|---|---|---|
| `OverCurrent_I0` | 过流 | 零序电流三段 + 方向 | 接地故障无保护 | 定值载体（零序 18 项） |
| `OverCurrent_SpeedUp` | 过流 | 后加速：重合后短延时无选择跳闸 | 重合于故障时靠 Ⅰ 段延时切除，慢一拍 | 重合闸 |
| `OverCurrentI0_SpeedUp` | 过流 | 零序后加速 | 同上（接地） | 重合闸 |
| `FZDOverCur` | 过流 | 非遮断电流闭锁（负荷电流以下不允许跳闸） | 小电流跳闸可能拉弧不熄 | 定值 3 项 |
| `OverCurWarn` | 过流 | 过流告警（只告警不跳闸） | 过流只能跳不能告警 | 定值（告警投入） |
| `OverCurWarn_I0` | 过流 | 零序过流告警 | 同上 | 定值 |
| `LineHaveVol` | 电压 | 线路有压鉴别 | 无法区分"有压合闸"与"无压合闸" | 定值（MeaLimit 有压鉴别） |
| `HaveVolCls` | 电压 | 得电合闸 | FA 的"来电自动合闸"缺失 | 开入 + 出口 |
| `NoVolTrip` | 电压 | 失电分闸 | FA 的"失电自动分闸"缺失 | 开入 + 出口 |
| `PTBreak` | 电压 | PT 断线（电压消失但电流正常） | 断线时电压类保护可能误动/拒动 | 定值 2 项 |
| `CTBreak` | 电压 | CT 断线 | 同上（电流侧） | 定值 |
| `AutoReCls` | 重合闸 | 充电 → 跳闸 → 延时重合 → 整组复归 | 瞬时故障必须人工合闸 | 开入 + 出口 + 16 项定值 |
| `AutoReCls_JD` | 重合闸 | 接地故障重合 | 同上（接地） | 同上 |
| `OnceCch` | 重合闸 | 一次重合（表内无定值，条件编译） | — | 同上 |
| `TwiceCch` | 重合闸 | 二次重合（表内无定值，条件编译） | — | 同上 |
| `ConnectBrkCls` | 重合闸 | 联络开关合闸（转供） | 环网无法转供 | 开入 + 出口 + 17 项定值 |
| `DirCell` | 方向 / 功率 | 方向元件（功率方向判别） | 双电源/环网会反送电误动 | 三相电压 + 三相电流同刻（H1） |
| `PowDirJudge` | 方向 / 功率 | 功率方向（有功/无功象限） | 同上 | 同上 |
| `PowerSet` | 方向 / 功率 | 功率电压组切换（1~4 组） | 多组 PT/CT 变比无法切换 | 定值 2 项 |
| `YcOverLimit` | 方向 / 功率 | 遥测越限判据 | 越限记录无来源 | 定值（MeaLimit 10 项） |
| `InRushCur` | 涌流 / 故障 | 二次谐波制动（励磁涌流闭锁） | 变压器空投时过流误动 | 谐波算法（见需求档 §9.1.2「遥测增强」） |
| `FaultIsola` | 涌流 / 故障 | 故障隔离 | FA 无法定位故障区段 | 开入 + 出口 |
| `FaultRecov` | 涌流 / 故障 | 故障恢复供电 | 同上 | 同上 |
| `BusEarthAlm` | 涌流 / 故障 | 母线接地告警 | 母线接地无告警 | 零序电压 |
| `SgzAlarm` | 涌流 / 故障 | 事故总告警 | 事故总信号缺失 | 事件码表 |
| `AutoCtrlTrip` | 自动控制 | 自动控制跳闸（电池活化等） | 活化流程无法跳闸 | 出口 |
| `ManualTrip` | 自动控制 | 手动跳闸 | 就地手动分闸缺失 | 开入 + 出口 |
| `MusterRecov` | 自动控制 | 总复归（复归所有保持态） | 动作态只能靠重启清 | 无（**可先做**） |
| `ExvRec` | 自动控制 | 事故记录 | 事故报告缺失 | 事件码表 |
| `ExvRecGW` | 自动控制 | 事故记录（网关侧） | 同上 | 同上 |
| `CORecord` | 记录 | COS 变位记录 | 开入变位无记录 | 开入 |
| `FrzRecord` | 记录 | 冻结记录（整点冻结电量） | 电度无冻结 | 电度 |
| `YcMeaRecord` | 记录 | 遥测定时记录 | 无遥测历史 | 定值 2 项 |
| `YcMeaLimitRec` | 记录 | 遥测越限记录 | 无越限记录 | 越限判据 |
| `YcVolQuaRate` | 记录 | 电压合格率统计 | 无合格率 | 定值 3 项 |
| `WaveQdCell` | 录波 / 采样 | 录波启动判据 | 录波无触发源 | 录波子系统 |
| `RlyCommSam` | 录波 / 采样 | 保护通信采样（跨装置采样同步） | 多装置差动类保护不可能 | 通信 + 对时 |
> **唯一"现在就能做"的是 `MusterRecov`（总复归）**：它不依赖任何硬件，只把各元件的
> 保持态与出口标志清一遍。本产品已有 `prot_elm_request_reset` 单字请求标志（架构硬件档 §1.5），
> 接上即可。其余 36 个模块都至少依赖定值载体、开入、出口、事件码四者之一。
---
---
## 7. 故障录波子系统规格（本产品 0）
录波是**唯一一个"完全独立的子系统"级缺口**：它不在保护链路上，但有独立的采样率、
独立的存储格式、独立的文件传输通道。参考实现的硬指标如下，可直接作为复刻验收判据。
| 指标 | 参考值（`APP/EquipCfg/Const_Wave.h`） | 说明 |
|---|---|---|
| 录波采样率 | `CN_SAM_RATE × CN_WAVE_RATIO` = 20 × 4 = **80 点/周波**（50 Hz 下 4000 Hz） | 保护计算用 20 点/周波，录波要 4 倍过采样才能看清波形。**偏离登记**：本装置先按 1 kHz（20 点/周波）立项，理由与二期不返工的结构约束见 `docs/子系统设计/故障录波设计说明.md` §2 与 §2.1 |
| 录波段数 | `CN_WAVE_SECT_NUM` = **6 段** | 每段独立缓冲，支持连续多次录波 |
| 启动前缓冲 | `CN_WAVE_CYCLE_SUM_REFRE_BUF` = **5 周波**（100 ms） | 循环刷新，保证故障前有数据 |
| 动作后 | `CN_WAVE_CYCLE_SUM_ACTED` = **10 周波**（200 ms） | |
| 返回段 | `CN_WAVE_CYCLE_SUM_RET` = **2 周波** | 返回过程也要录 |
| 手动录波 | `CN_WAVE_CYCLE_SUM_HAND` = **6 周波** | |
| 单次最长 | `CN_WAVE_MAX_TIME` = **9000 ms** | 超长故障（如持续性接地）按此截断 |
| RAM 录波个数 | `CN_WAVE_RAM_NUM` = **16** | RAM 里最多同时存 16 份，满了转存文件 |
| COMTRADE 保存数 | 动作 **64** / 启动 **64** / 手动 **16** | 三类独立配额，满了循环覆盖 |
| 单份最大开关变位 | `CN_WAVE_MAX_RECSWI` = **64** | |
| 布尔量通道 | `CN_WAVE_NUM_BOOLFLG` = **320** | 全局布尔变量按位录波 |
| 模拟量通道 | 原始 + 计算 = `CN_WAVE_ALL_ANA_NUM` | 本产品对应 **65 通道**（`g_tMeasureModelTab`） |
| 录波类型 | 动作 `TYPE_ACT`=1 / 启动 `TYPE_START`=2 / 手动 `TYPE_HAND`=3 | |
| 文件格式 | COMTRADE（`.cfg` + `.dat`） | 主站侧通用格式，非私有 |
| 上送方式 | 104 文件传输（`F_FR_NA_1` 目录 / `F_SR_NA_1` 读文件） | 本产品 104 未实现文件传输 |
**复刻所需的四件东西**（缺一不可）：
1. **4 倍过采样缓冲**：当前 `adcTask` 以 1000 Hz 出样本，录波要 4000 Hz。要么提高采样率
再抽取给保护（改变整条链节拍），要么在 TPAFE 侧单独开一条 4 倍速通路（改驱动）。
2. **环形缓冲 + 触发点定位**：5 周波前缓冲 + 10 周波后缓冲，触发时刻要能反算出缓冲内偏移。
3. **COMTRADE 编码器**：`.cfg`（通道定义、采样率、时标）+ `.dat`（二进制采样值）+ `.hdr`。
4. **文件存储与配额管理**：SPI NAND 上按 64/64/16 配额循环覆盖，需与现有 FatFs + dhara 层对接。
> **排期判断**：录波不是"加个功能"，是**新增一条 4 倍速采样通路 + 一套文件格式 + 一个配额管理器**。
> 它排在定值/元件铺开之后，因为录波通道表（65 路）本身依赖元件输出。
---
---
## 8. 记录体系复刻明细（参考 13 类 → 本产品 8 类）
参考用 13 个定长队列分类存记录，容量按类分配（`GlobalDef/Const_Sys.h`）：
| 参考队列 | 容量 | 语义 | 本产品 |
|---|---|---|---|
| `REC_ACT` | 128 | 动作记录（保护动作） | ✅ 事故记录 `/log/accid.log` |
| `REC_ALM` | 128 | 告警记录 | ✅ 保护告警 `/log/alarm.log` |
| `REC_OVER` | 128 | 越限记录 | ❌ |
| `REC_START` | 128 | 启动记录（元件启动但未动作） | ✅ 保护启动 `/log/start.log` |
| `REC_LOCK` | 128 | 闭锁记录（保护被闭锁） | ❌ |
| `REC_SOE` | **256** | SOE（带时标的开入变位） | ✅ `soe_store`（SPSC 深度 8 → 落盘） |
| `REC_COS` | **256** | COS（无时标的状态变位） | ❌ |
| `REC_CHK` | 128 | 自检记录 | ✅ `/log/selftest.log` |
| `REC_RUN` | 128 | 运行记录（上电/重启） | ✅ `/log/run.log` |
| `REC_OPT` | 128 | 操作记录（复归/对时/定值保存） | ✅ `/log/oper.log` |
| `REC_YK` | 128 | 遥控记录 | ✅ `/log/yk.log` |
| `REC_SC` | 128 | 顺控记录 | ❌ |
| `REC_SCSTEPINFO` | 128 | 顺控执行明细 | ❌ |
**缺的 5 类及其依赖**：
| 缺的队列 | 依赖 | 能否先做 |
|---|---|---|
| 越限记录 | 越限判据（`MeaLimit` 10 项定值 + `YcOverLimit` 元件） | 可先做判据、后做记录 |
| 闭锁记录 | 闭锁源已具备（四源闭锁，需求档 §5.12），**只缺记录落点** | ✅ **最该先补**——现在闭锁发生了但无记录，现场排障靠猜 |
| COS 记录 | 开入（X3） | ❌ |
| 顺控记录 / 顺控执行明细 | 顺控功能（参考 `YKRly.c` 63 KB 的顺控执行引擎） | ❌ 整功能未立项 |
> **闭锁记录是本表里性价比最高的一项**：闭锁源（未标定 / 采样故障 / 定值校验和 / 软压板退出）
> 已经全部实现，但闭锁的**发生与解除都没有留痕**。加一个 `REC_LOCK` 等价队列，
> 只需在 `protect_task` 的闭锁判定处加一条写入，不依赖任何硬件。
**格式差异**：参考是**二进制定长记录 + 独立队列 + 循环覆盖**；本产品是**文本行（64 B 定长）+ 文件**。
文本行的优点是 FTP 直接可读、现场排障友好；缺点是容量利用率低、无结构化解码。
复刻时建议**保留文本格式**（本产品优势），只补队列分类与配额。
---
---
## 9. 规约栈复刻明细（参考 12 种 → 本产品 1 种）
| 规约 | 参考源码 | 链路 | 用途 | 工作量特征 |
|---|---|---|---|---|
| **IEC 60870-5-104** | `Comm/Pub/Rly_IEC104.c` | TCP | 主站接入（本产品已实现） | ✅ 已完成 |
| IEC 60870-5-101 | `Rly_IEC101.c`、`Rly_IEC101_B.c` | 串口 | 主站接入（老站） | 与 104 共享 ASDU 层，**只换链路层**（平衡/非平衡链路、可变帧长） |
| IEC 60870-5-102 | `Rly_IEC102.c` | 串口 | 电度采集 | 独立 ASDU（电度专用类型），依赖电度 |
| IEC 60870-5-103 | `RLY_IEC103.c`、`RLY_IEC103-tcp.c`、`Rly_IEC103T.c` | 串口 / TCP | 保护装置信息接口 | 三种变体（串口 / TCP / T 型），ASDU 与 101/104 不同族 |
| ModBus | `Rly_ModBus.c` | 串口 / TCP | 通用工业设备 | 简单，**对下采集首选** |
| CDT | `Rly_Cdt.c` | 串口 | 循环式远动（老国标） | 帧结构简单，无确认机制 |
| `Whm_GB` | `Whm_GB.c` | 串口 | 国标电度 | 依赖电度 |
| IEC 61850 | `struct61850.h`、`GlobalUnit/SttnLvlGoose.c` | 以太网多播 | MMS / GOOSE / SV | **最大工作量**：需 MMS 栈 + ASN.1 + 多播组管理 |
| CAN | `Rly_Can.h` | CAN 总线 | 内部总线 | 依赖 CAN 硬件 |
| 子站 IEC 101 | `Comm/Mon/Rtu_IEC101*.c`（含 ABB / 西门子 / 无优先级变体） | 串口 | 对下接 FTU / 开关 | **对下主站侧**，与对上从站侧是不同角色 |
| 子站 IEC 104 | `Rtu_IEC104.c`、`Rtu_Dbg104.c`、`Rtu_RIS104.c` | TCP | 对下 | 含调试与 RIS 变体 |
| BALA101 / ModBus | `Rtu_BALA101*.c`、`Rtu_ModBus.c` | 串口 | 对下 | 与 RS-485 簇同批 |
| 加密 | `Comm/Ecc/`（SM2 / SM3 / ECDSA） | — | 安全加固 | 国密算法库，纯软件可移植 |
**排期分层**：
| 层 | 规约 | 理由 |
|---|---|---|
| 先做 | ModBus（对上 + 对下）、IEC 101 | 与 104 共享 ASDU 或结构简单；对下采集是配网终端必备 |
| 次做 | IEC 103、CDT、BALA101 | 老设备兼容，结构清晰 |
| 后做 | IEC 102、`Whm_GB` | 依赖电度（H1） |
| 末做 | IEC 61850 | 需 MMS/ASN.1/多播，单核 M4 资源需专项评估 |
| 并行 | SM2 / SM3 / ECDSA | 纯软件，无硬件依赖，可随时插入 |
> **一个容易漏的点**：参考同时有**对上（`Comm/Pub`，本机作从站）**与**对下（`Comm/Mon`，本机作主站）**
> 两套规约。本产品只有对上 104。做"配网终端"时对下那套（101/104/ModBus 主站侧）
> 是**必须**的——否则接不了一次开关。
---
---
## 10. 复刻完成判据（逐缺口可验证）
每一条缺口给出"怎么算做完了"，避免"实现了但没验收"。
| 缺口 | 完成判据 |
|---|---|
| 定值铺开 | `PS_ID_COUNT = 249`（或按单元分批：每批新增项在 104 上可读写、跨复位保持、校验和正确）；`check` 脚本比对参考表逐项一致 |
| 104 定值映射 | 107 个地址（`0x8820~0x8891` 含 8 空洞）全部可读可写；空洞地址返回"未知信息体地址" |
| 元件铺开 | 45 个模块对应 45 个实例；每个实例有：定值项齐全、启动/动作/返回三态可观测、事件码正确、单测覆盖判据边界 |
| 遥测铺开 | 31 点全部非 IV（除物理不可达点明确标 IV）；线电压与相量满足 `Uab = Ua − Ub` 误差 ≤ 0.5 % |
| 开入开出 | 27 路硬件开入可读、31 路开出可驱动；开入防抖可整定；双点遥信四态正确（00/01/10/11） |
| 录波 | **（二期口径；本波按 1 kHz / 8 路 / 单段 / 无 COMTRADE，对照表见 需求档 §9.1 第 10 行）**4000 Hz 采样；三类录波各生成一份 COMTRADE 且被第三方工具打开；配额 64/64/16 循环覆盖正确 |
| 记录体系 | 13 类队列各有落点；每类容量达标；断电不丢已确认记录 |
| 多规约 | 每种规约与对应主站/子站工具完成一次完整交互（连接 / 总召 / 变位 / 遥控 / 断链重连） |
| 国密 | SM2 签名验签、SM3 摘要与标准测试向量一致 |
| 软压板 | 9 面全部可投退且行为可观测（投退后对应功能确实停走/恢复） |
| 出口与开入 | 保护动作 → 出口继电器动作 → 开入回读确认，全链路 ≤ 120 ms |
| 标定解卡 | 8 通道两点标定后 `ADC_CAL_F_VALID` 全置位；注入标准源，保护动作值与定值误差 ≤ 3 % |
| 屏板链路 | **串口通道**：屏板 280 ms 召唤、主机 ≤200 ms 内**发完** **4208 B**（整帧无 2 个字符时间以上的间隙），连续 10 min **主机侧**零超时、零 CRC 错帧；显存 3200 B 与 `g_ui_fbuf` 逐字节一致；7 个物理键（`1/2/3/4/7/8/9`）动作正确；**状态灯位掩码逐位一致、LED 0 恒亮**；屏板 ≈5000 s 自复位不误判离线；LOGO 下发出局（不实现）；**网络通道**：INIT 应答 **16 B** 逐字段一致且无颜色字段、`LCDMEM` 偏移 0 得 3204 B、重复召唤无应答、偏移 ≥3200 无应答、`KEEPLIVE` 无应答且 1 分钟不掉链、8 键（含 `F1\|ENT` 组合）动作正确（需求档 §5.16.10 十四条，第 15 条 LOGO 出局） |
---
---
## 11. 屏板链路复刻任务规划
> **口径**：条目一律用**语义短语**（编号规范 P-8），执行序即表序。
> 改动范围只含本产品固件与 `DTU-RemoteLCD` 客户端；**屏板固件不在本仓库**，
> 其行为以需求档 §5.16 为契约做黑盒验收。
>
> **两种部署形态，两条通道都要**：① **串口直连屏板**（参考的形态，第 10~15 条）——屏板直接挂在设备
> 串口上，无需任何网络设备；② **串口服务器透传 / 网络镜像**（第 2~9 条）——屏板或调试软件经以太网连 7003。
> 现场用串口服务器把屏板接到网上时，两种形态等价，但**固件侧不能只实现后者**：
> 只有 7003 时，设备离开网络就没有任何本地显示，与参考产品不等价。
>
> **方向相反，别写错**：网络通道是"**客户端召唤、设备应答**"；串口通道是"**屏板召唤、设备应答**"。
> 两条通道共用同一份显存快照，但**帧格式、校验、时序完全不同**（网络用 `0xAA/0xBB` + XOR，
> 串口用裸二进制 + CRC-16/MODBUS），不能共用组帧代码。
>
> **实现事实另立**：主机侧的接线、串口配置、协议实现口径、验证状态与未闭环项在
> `docs/子系统设计/屏板链路设计说明.md`；本节只保留**需求视角**的缺口与顺序，不复制实现细节。
| 序 | 任务 | 改动点 | 判据 | 跨端 |
|---|---|---|---|---|
| 1 | **报文口径定版** | 本节 + 需求档 §5.16 + 需求档 §6.2 按参考源码成文 | 文档门禁全绿（已完成） | — |
| 2 | **INIT 应答补足 16 字节** | `ui_net_sink.c` 的 `remo_send_init()` 组帧由 8 B 扩到 **16 B**：补 8 B 键值表；**不加颜色位与 RGB**（单色屏不对齐多色协议，需求档 §5.16.5） | 16 B 逐字节比对通过，且报文内**无颜色字段** | **是** |
| 3 | **键值表补 F1 / F2** | `ui_net_sink.h` 键值宏补 `0x04` / `0x80`；`ui_net_sink_inject_key()` 映射；UI 键处理接受组合键 | 下发 `0x04` / `0x80` / `0x24` 界面响应正确 | 否 |
| 4 | **显存断点续传** | `CMD_LCDMEM` 分支去掉"仅偏移 0"限制：按偏移取 `g_ui_fbuf + off`，长度 `min(9800, 3200 − off)` | `off=1600` 得 `4+1600` B，内容与整帧尾部逐字节一致 | 否 |
| 5 | **召唤拒绝握手** | 新增"帧代次 + 已上送"等价状态：新图未就绪时重复召唤**不应答**；偏移 ≥3200 不应答 | 需求档 §5.16.10 第 2、3 条通过 | **是** |
| 6 | **链路监视** | 1 分钟通信中断计时（收到帧 / 发送成功即重置）；超时置状态位并落一行日志 | 断链 60 s 有明确日志与状态；重连后自动恢复推流 | 否 |
| 7 | **KEEPLIVE 静默** | 去掉空帧回显，改为仅重置计时 | 需求档 §5.16.10 第 4 条通过 | **是** |
| 8 | **发送重试评估** | 对比参考"BUSY + 200 ms 放弃"与现有 `net_send` 阻塞模型，出结论并回填需求档 §5.16.9 第 7 行 | 结论有实测数据支撑（实现 / 明确不实现） | 否 |
| 9 | **客户端一致性回归** | `DTU-RemoteLCD` 按 **16 B** 解析；把需求档 §5.16.10 第 1~7 条做成自动化用例 | 七条判据全 PASS | **是** |
| 10 | **串口物理层落地** | 按需求档 §5.16.2 定版：**700000 8N1、`BRR = 0x0078`**（USART1，APB2 84 MHz）、**无 DE**（TTL 直连，不走收发器）、RX 缓冲 16 B + 空闲中断断帧、发送走 **DMA 一次性发完**（禁逐块阻塞；主机侧 TX 用 `DMA2_Stream7`，RX 走 IDLE 中断、不用 RX DMA） | 环回 + 示波器实测 700 kbaud 分频零误差；屏板能收到帧 A 并回帧 B | 否 |
| 11 | **帧 A 解析 / 帧 B 组帧** | 新增屏板通道模块：识别 6 B 请求（`01 03 type key CRC_L CRC_H`）、校验 CRC-16/MODBUS（**低字节在前**，口径见需求档 §5.16.2）；组 **4208 B** 帧 B（3200 显存 + 4 B LED + 4 B info 保留 + 998 B 填充 + 2 B CRC） | 屏板出图与 `g_ui_fbuf` 逐字节一致；`info[0..3]` 与下发的 LED 掩码一致 | 否 |
| 12 | **状态灯位映射表** | 定义"**业务状态 → 屏板 LED 位**"映射（参考源码**无此表**，须自定）；`info[0..3]` 按 **32 位小端**填，bit0 恒 0、bit20~31 恒 0 | 需求档 §5.16.10 第 11 条通过 | 否 |
| 13 | **串口上行按键** | 帧 A 的 `key` 字节按**屏板 `KEY_TYPE`** 解释——实际可达值只有 **`1/2/3/4/7/8/9`**（`5`/`6`/`10` 无物理入口）；映射为逻辑键值后与 7003 注入**同一入口**合并 | 需求档 §5.16.10 第 10 条通过；`9`/`10` 语义按需求档 §5.16.3 ② 处置 | 否 |
| 14 | **双通道并发 + 自复位容忍** | 两出口各自独立发送上下文；串口 4208 B 阻塞不拖 7003；链路监视按"**连续 ≥10 s 无应答**"判离线，**忽略屏板 ≈5000 s 周期自复位** | 需求档 §5.16.10 第 12、13、14 条通过 | 否 |
| 15 | **LOGO 下发流程（出局，不实现）** | 主机不提供 LOGO 帧，总线上不会出现 `info[4..5] = 0x89 0x45` | —（不参与验收） | 否 |
| 16 | **日志口迁移（USART1 → RS-232 通道）** | ① `console_log.c` 的 `huart1`、`USART1_IRQn`、`__HAL_RCC_USART1_CLK_*`、`MX_USART1_UART_Init()` 收口成**一处端口宏**，指向 RS232#1（`huart5` / UART5）；② **不动** UART4 的 `g_rs485` 绑定 | 日志在 RS-232 侧（CN1）可读且内容与迁移前一致；USART1 **完全空出**；连续 10 分钟无 `[ERR]` | 否 |
**批次划分**：
| 批 | 任务 | 理由 |
|---|---|---|
| 第一批（无跨端风险，可独立发版） | 3、6、8 | 只动本端，旧客户端不受影响 |
| 第二批（跨端，须与客户端同步发版） | 2、4、5、7、9 | 报文口径变更，两端必须同版本 |
| 第三批（**独立立项**，不随 RS-485 冻结） | **16**、10、11、12、13、14 | 屏板串口通道是**独立需求**，与 需求档 §5.10 冻结的"对下采集簇"不是一回事。**第 16 条排在 10 之前**：日志先腾出 USART1，屏板链路才能独占这条通道 |
> ⚠ **唯一破坏性变更**：第 2 条把 INIT 应答从 8 B 改成 **16 B**。**旧客户端会把 16 B 的前 8 B 当全部、
> 把后 8 B 当作下一帧的 TAG 去找**，解析状态机会被这 8 B 拖住直到超时——表现为"连上了但不出图"。
> 因此第 2、5、7、9 条必须**同批发布**，且发版说明中明确"客户端需升级"。
>
> ⚠ **16 B 与参考的 29 B 不可互换**：删掉 13 B 颜色字段后，偏移 4 之后全部前移——
> 参考的"显存大小在偏移 5、键值表在偏移 21"在本产品变成"偏移 4、偏移 8"。
> 客户端**不得**复用参考的 29 B 解析器再截前 16 B（会读出颜色位当显存高位）。
>
> **屏板固件边界**：本表不覆盖屏板侧固件（帧解析 / 显存写入 / 按键扫描 / 状态灯驱动）。
> 屏板固件工程在 `D:\Code\DTU Code\DTU-LCD`，**不在本仓库**，其契约已按源码逐字节成文（需求档 §5.16.2 / 需求档 §5.16.3）。
> 本产品只要满足 需求档 §5.16.10 的十四条判据即为兼容（第 15 条 LOGO 出局）。
>
> **第三批状态**：串口通道（第 10~14、16 条）主机侧已实现并经台架与真屏板验收，屏板实物已上台架；
> 帧长**已固化 4208 B**（代码实参为准，屏板 readme 的 3208 B 不作数——真屏板出图为端到端证据）。
> 未闭环项（2 h 长稳、仪器项等）见 `docs/子系统设计/屏板链路设计说明.md` §9.2；**网络通道（第 2~9 条）未开工**。
>
> **一条物理前置（已完成 2026-10-29）+ 一条实现纪律**：
> ① **台架串口线已挪位**——日志口迁到 RS-232 侧后，台架那根线改接 CN1 的 RS232#1 端子
> （`CN1.10` 接适配器 TXD、`CN1.12` 接适配器 RXD、`CN1.7` 或 `CN1.8` 接 GND），台架日志口
> 因此由 `COM6` 变为 **`COM3`**，`.serialtest/config.json` 的 `portName` 已同步，`@test` 与
> `serial-assistant` 不必再手工指端口。这些端子是 **RS-232 电平**，TTL 的 CH340 直连不了，
> 用的是 USB 转 RS-232 适配器；接法与端子出处见 `docs/子系统设计/屏板链路设计说明.md` §3.2。
> **这条要在第 16 条动代码之前完成。**
> ② **RX 要真的读、ORE 要真的清**——PA10 一直是接线的（需求档 §5.16.2），
> 但"RX 使能却不读 `DR`"本身就足以让 ORE 永久锁存。第 11 条实现时必须在
> `HAL_UART_ErrorCallback` 里清 ORE 并重挂接收，否则一次噪声就永久静默。
---
docs/任务规划/故障录波.md
+1 -1
View File
@@ -78,4 +78,4 @@ flowchart TD
| `docs/任务规划/登记簿.md` | 原「故障录波与 104 文件传输」暂缓行已随本波立项销项（104 文件传输仍留二期） |
| `docs/任务规划/UI补齐.md`、`docs/UI设计/页面补齐规划.md` | 「手动录波」叶子旧状态是「不做（录波模块不存在）」，重开条件正是本波；上线后两处的叶数闭合要一起改 |
| `docs/问题记录/采集与数据处理短板评测.md` | 记录链缺口的登记处；本波落地后该行改指设计文档 |
| `docs/产品需求/产品需求设计文档.md` | 「录波采样率」行是本波偏离的对照基准；「立项未排」行与「文件传输（录波）」行按本波状态更新 |
| `docs/产品需求/参考产品复刻明细.md` | 复刻明细 §7「录波采样率」行是本波偏离的对照基准；复刻明细 §1.2「立项未排」行与 §8「文件传输（录波）」行按本波状态更新 |
docs/子系统设计/故障录波设计说明.md
+2 -2
View File
@@ -50,7 +50,7 @@
## 2. 与产品需求口径的偏离（显式登记，不许静默降级）
产品需求 `docs/产品需求/产品需求设计文档.md` 的「录波采样率」行写着：录波 = 20 × 4 = **80 点/周波（50 Hz 下 4 kHz）**，理由也写在那一行——「保护计算用 20 点/周波，录波要 4 倍过采样才能看清波形」。本波只做 20 点/周波，是**明知故犯的偏离**，把理由与代价写在明处：
`docs/产品需求/参考产品复刻明细.md` §7 的「录波采样率」行写着：录波 = 20 × 4 = **80 点/周波（50 Hz 下 4 kHz）**，理由也写在那一行——「保护计算用 20 点/周波，录波要 4 倍过采样才能看清波形」。本波只做 20 点/周波，是**明知故犯的偏离**，把理由与代价写在明处：
| 项 | 内容 |
|---|---|
@@ -383,5 +383,5 @@ flowchart TD
| `docs/架构设计/STM32F4-Base存储架构说明.md` §10.1 | FatFs 陷阱与 8.3 短名的属主；本文 §5.2 只是消费者 |
| `docs/UI设计/页面补齐规划.md`、`docs/任务规划/UI补齐.md` | 「手动录波」叶子旧状态是「不做（无录波模块）」；P2 与 P3 落地时两处的叶数闭合与重开条件要同步 |
| `docs/问题记录/采集与数据处理短板评测.md` | 记录链缺口（波形数据面 / COMTRADE / 104 文件服务）的登记处；P1 落地后该行改指本文 |
| `docs/产品需求/产品需求设计文档.md` | 「录波采样率」行是本文 §2 偏离的对照基准 |
| `docs/产品需求/参考产品复刻明细.md` | §7「录波采样率」行是本文 §2 偏离的对照基准 |
| `docs/硬件平台/ADC通道映射说明.md` | 通道归属与注入点清单的属主；回放页「削」徽标的判据出处 |
docs/架构设计/系统架构与硬件规格.md
+215
View File
@@ -0,0 +1,215 @@
# STM32F4-Base 系统架构与硬件规格
> **文档定位**：全仓**系统运行时架构**与**硬件规格（V0.1）**的权威表档——自
> `docs/产品需求/产品需求设计文档.md` v1.9 的原 §3/§4 拆出（需求与验收口径仍在需求档）。
> 与 [`docs/架构设计/项目架构总览.md`](项目架构总览.md) 的分工：总览是**叙述性全景**，
> 本档是**完整口径表**——就绪屏障位表（bit0~8）、线程间通信机制表、启动时序图、
> 引脚分配表、硬件能力边界表以**本档为准**，两处冲突以本档为准并回改总览。
> **硬件口径**：V0.1（`docs/硬件平台/V0.1_网表详细分析报告.md` + `Inc/main.h`）。
## 1. 系统运行时架构
### 1.1 六层分层架构
![STM32F4-Base 项目分层架构](../images/项目架构总览.svg)
> 上图由 `tools/arch_diagram/gen_arch_svg.py` 生成（手绘 SVG，零连线交叉）；改架构后编辑脚本顶部
> `ROWS` 数据重跑即可，源数据与下表一致。
分层原则：**上层只依赖相邻下层（单向）**；**① 业务层为顶层**（仅 `net_cfg`，被 UI 与基础服务共用），
**② UI 层与 ③ 基础服务层同级并列**。
| 层 | 目录 | 职责 | 关键模块 |
|---|---|---|---|
| ① 业务层 | `Drivers/BSP/NETCFG/` | 顶层共享配置（被 UI 与基础服务共用） | `net_cfg` |
| ② UI 层 | `Drivers/BSP/UI/` | LVGL 界面（与 PC 模拟器共用源码） | `ui_port` `ui_menu` `ui_menu_view` `ui_menu_tab` `ui_content_page` `ui_page_*` `ui_net_sink` `ui_font_cn_12` `ui_deco` |
| ③ 基础服务层 | `App/`、`Drivers/BSP/NET/lftpd/` | 应用侧服务、采集算法与协议编排 | `app_main` `sys_events` `app_cfg` `task/*` `algo/*`（语义取数与有效性~保护判据）`protocol/iec104/*` `log/soe_store` `lftpd` `time_sync` |
| ④ 中间件层 | `Drivers/BSP/NET/`、`Lib/`、`App/util/` | 通用库 / 协议栈 | `net_socket` `net_select` `FatFs` `nand_ftl`(dhara) `LVGL` `sys_clock` |
| ⑤ 驱动层 | `Drivers/BSP/{CH395F,GD5F2GQ5UE,TPAFE5160,SD2506,RS485}/` | 芯片寄存器 / 时序 / 中断 | `ch395f` `gd5f2gq5ue` `tpafe5160` `sd2506` `rs485` |
| ⑥ 内核 / HAL | `Middlewares/`、`Drivers/STM32F4xx_HAL_Driver/`、`Drivers/CMSIS/` | 任务调度、外设 HAL、启动 | FreeRTOS V10.3.1 · STM32 HAL · CMSIS |
| ⑦ 硬件 | — | STM32F407ZGTx @168MHz | SPI1 / SPI2 / I2C1 / UART4 / USART1 / DMA / GPIO / TIM7 |
### 1.2 运行时任务模型
**九个** FreeRTOS 任务（`Src/freertos.c` 创建，任务体在 `App/task/`、`App/sync/`）：
| 任务 | 栈（words / B） | 优先级 | 职责 |
|---|---|---|---|
| `defaultTask` | 1280 / 5120 | Normal | FatFS 挂载（无卷 `f_mkfs`）→ 卷健康探针/自愈 → `net_cfg_load` + 定值/运行参数/通讯参数装载（**配置引擎属主**）→ 置 `STORAGE_READY` → 日志落盘（唯一写者）+ 2 s 配置轮询 + 各模块脏位落盘（`prot_set` / `run_par` / `comm`）+ SOE 排空 + LED 闪烁 + 栈水位观测 + **看门狗唯一喂狗者** |
| `netTask` | 960 / 3840 | Normal | 等存储 → `net_stack_bring_up()` → 置 `NET_READY` → `net_poll` 轮询 + CH395F 操作串行化（消息队列执行者） |
| `ftpTask` | 1024 / 4096 | Normal | 等网络**且**存储（`WaitAll`）→ `lftpd_start("/", 21)` → 单客户端会话循环 |
| `testTask` | 2048 / 8192 | BelowNormal | 测试套件入口（`test/board/test_config.h` 选择）。**产品构建不创建**（未选套件时立即 `vTaskDelete` 回收其 8 KB CCM 栈） |
| `uiTask` | 4096 / 16384 | BelowNormal | 等网络 → `ui_port_init`/`ui_menu_init`/`ui_standby_init`（空闲 60 s 切待机屏）/`ui_net_sink` → 10 ms 刷新 + 数据注入 |
| `timeSyncTask` | 640 / 2560 | Normal | 等网络 → TCP :8888 收 PC 推送时间 → 写 RTC |
| `adcTask` | 640 / 2560 | AboveNormal | **采集主线唯一消费者**：每拍 `adc_input_poll()`（TPAFE 快照 + ADC1 DMA 帧）→ `adc_health` 有效性 → `phasor_run()` 相量 → `freq_run()` 测频 → 每 200 ms `meas_tick()` 发布遥测快照 |
| `iec104Task` | 640 / 2560 | Normal | 等网络 → TCP :2404 监听 → 104 链路状态机（总召/变位/周期/遥控/定值/对时）+ 断链重听 + 网络代次自愈 |
| `protectTask` | 512 / 2048 | Normal | **20 ms 判据节拍**：采样故障闭锁判定 → 定值校验和巡检 → `prot_elm_run()` 元件判据 → 动作边沿投递 SOE（**不做 NAND I/O**） |
> `idle`（128 words）/ `timer`（256 words）由 FreeRTOS 内核创建。所有任务栈从 **56 KB** `heap_4` 堆
> （CCM）分配；CCM 水位 87.9%（<92% 门禁）。
> 任务表与 `Src/freertos.c` 的 `osThreadAttr_t` 一致，由 `scripts/gen_task_table.py` 生成并门禁校验；
> **栈配置与实测余量**见 `../产品需求/产品需求设计文档.md` §7.3，改栈前后必须重跑 `scripts/stack_report.py`。
>
> ⚠ **节拍同源**：TIM3 更新事件（1 kHz）同时触发 TPAFE `CONVST` 与（经 TRGO）ADC1 一轮 9 通道扫描，
> 并在 ISR 内唤醒 `adcTask`——采集节拍与任务唤醒**不允许**各自计时。
> ⚠ **ADC1 必须在挂 DMA 的瞬间处于关闭态**：`app_main_init()` 步骤 4b-pre 的 `adc1_disable()` 不可删、不可后移，
> 否则 DMA 乒乓缓冲整体旋转 2 格（表象与"映射表写错"一致）。证据见
> [`docs/子系统设计/ADC采样节拍设计说明.md`](../子系统设计/ADC采样节拍设计说明.md) §4.5。
### 1.3 就绪屏障（Event Flags）
![就绪屏障（Event Flags）](../images/就绪屏障.svg)
用 CMSIS-RTOS2 Event Flags（`sys_evtHandle`）表达"子系统就绪"，取代魔法延时与全局标志轮询。
生产者与消费者互不知晓，只经事件组解耦；新增子系统只需定义新 bit + 各自 wait/set。
| 位 | 名称 | 类型 | 语义 |
|---|---|---|---|
| bit0 | `SYS_EVT_NET_READY` | 状态位 | netTask：`net_init` + PHY 稳定完成 |
| bit1 | `SYS_EVT_STORAGE_READY` | 状态位 | defaultTask：FTL/FatFS 挂载 + 配置就绪 |
| bit2 | `SYS_EVT_FTP_READY` | 状态位 | ftpTask：`lftpd_start` 完成 |
| bit3 | `SYS_EVT_TIMESYNC_READY` | 状态位 | timeSyncTask：首次时间同步完成 |
| bit4 | `SYS_EVT_NET_RECONFIG` | 命令位 | UI：请求立即应用新网口配置 |
| bit5 | `SYS_EVT_CFG_SAVE` | 命令位 | UI：网口配置保存请求（defaultTask 消费并写盘） |
| bit6 | `SYS_EVT_CONSOLE_TX` | 命令位 | 控制台单写者：生产者入环形缓冲后置位 |
| bit7 | `SYS_EVT_PROT_SET_SAVE` | 命令位 | 保护定值落盘请求：104 检测到定值脏后置位，defaultTask 原子写 `/prot_set.bin` |
| bit8 | `SYS_EVT_RUN_PAR_SAVE` | 命令位 | 运行参数段落盘请求：104 写运行参数后置位，defaultTask 整档外科保存 |
> ⚠️ **铁律**：状态位（bit0~3）表达**持久状态**，任何消费者都**不许消费**——必须
> `osFlagsWaitAny|osFlagsNoClear`。命令位（bit4~8）表达"请做一件事"，必须**恰好被消费一次**（消费型等待）。
> 历史事故：就绪位被先到的等待者消费，导致 `ftpTask` 的 `WaitAll(bit0|bit1)` 永不成立、21 端口从未监听（静默）。
### 1.4 启动时序
```mermaid
sequenceDiagram
autonumber
participant M as main
participant A as app_main_init
participant K as osKernelStart
participant D as defaultTask
participant N as netTask
participant S as adcTask / protectTask
participant F as ftpTask
participant U as uiTask
participant I as iec104Task / timeSyncTask
M->>M: HAL_Init + CubeMX 外设初始化<br/>(SPI1/SPI2/I2C1/UART4/USART1/DMA/GPIO/TIM3/TIM7)
M->>A: app_main_init()
Note over A: 时间子系统优先，使后续日志带时间戳
A->>A: sd2506_init() → sys_clock_init()（墙钟基准）
A->>A: rs485_init() → gd5f2gq5ue_init()（BBT 扫描）
A->>A: tpafe5160_init() → adc_input_init()（语义映射自检）
A->>A: 配置段注册（adc_cal / run_par / prot_set / comm）→ 定值/元件初始化
A->>A: adc1_disable() → ADC1 挂 DMA（4b-pre，顺序不可变）→ 启动 TIM3 1 kHz 节拍
A-->>M: "App init OK"
M->>K: osKernelStart()
K->>D: 调度
D->>D: f_mount（无卷则 f_mkfs FAT32）→ 卷探针/自愈 → 配置装载<br/>→ 定值整表原子装载（损坏则保出厂默认 + 自检留痕）
D-->>N: set SYS_EVT_STORAGE_READY
S->>S: adcTask：等 TIM3 节拍 → 采集 → 相量/测频 → 200 ms 遥测快照
S->>S: protectTask：20 ms 判据（未标定/采样故障则停走）
N->>N: wait STORAGE_READY（Any|NoClear）→ net_init(ip,mask,gw,mac)<br/>→ PHY 强制 100M 全双工 → 等链路 ≤3s
N-->>F: set SYS_EVT_NET_READY
F->>F: wait NET_READY|STORAGE_READY（All|NoClear）→ lftpd_start("/", 21)
U->>U: wait NET_READY（Any|NoClear）→ ui_port_init → ui_menu_init → ui_net_sink_start(7003)
I->>I: wait NET_READY（Any|NoClear）→ TCP listen :2404 / :8888
```
> **顺序铁律**：① 配置段注册必须**先于** `cfg_file_load`（否则 FTP 上传的段不生效）；
> ② `adc1_disable()` 必须在挂 DMA 之前；③ `osKernelStart` 之前禁调任何内核 API（含 `osDelay` / 队列）。
### 1.5 线程间通信
| 机制 | 对象 | 用途 |
|---|---|---|
| Event Flags | `sys_evtHandle` | 启动就绪屏障 + 命令位（§1.3） |
| Message Queue | `netMsgQueue`（深度 8，`net_msg_t`） | 所有 CH395F 操作经队列**串行化**到 netTask 执行，保证 SPI 单线程访问 |
| 双区 + 序号（无锁） | `phasor` 相量区、`meas` 遥测快照 | 写侧填满计算区后单字节翻转活跃索引；读者先取索引再整份拷贝，`seq` 判"是否换帧" |
| SPSC 环（无锁） | `soe_store`（深度 8） | protectTask 只投递动作边沿，defaultTask 排空落盘——**保护路径零 NAND I/O** |
| 脏位 + 事件位 | `prot_set` / `run_par` / `comm` | 写入方置脏；104 侧 peek 后投递事件位，配置属主（defaultTask）落盘，失败保留脏位下轮重试 |
| 单字请求标志 | `prot_elm_request_reset()` | 跨上下文复归请求（104 遥控 YK11 在 iec104Task 落请求，protectTask 下一拍消费） |
---
## 2. 硬件规格
### 2.1 主控与内存
| 项 | 值 | 说明 |
|---|---|---|
| MCU | STM32F407ZGTx | Cortex-M4（FPU），LQFP144 |
| 主频 | 168 MHz | HSE 8 MHz → PLL M=4 / N=168 / P=2 |
| Flash | 1 MB（0x08000000） | 片内 |
| SRAM | 192 KB（128 KB 主 SRAM1+SRAM2 + 64 KB CCM） | 链接器映射 128 KB 主 SRAM；CCM 用于 FreeRTOS 堆（任务栈） |
| RTOS | FreeRTOS V10.3.1（CMSIS-RTOS2） | HAL 时基 TIM7，tick = 1 ms；NVIC 4 位抢占，外设中断优先级 ≥5 |
| 工具链 | Keil MDK-ARM v5（ARMCC v5） | 工程锁 `uAC6=0`，**不支持 armclang** |
| CubeMX | 6.17.0 + STM32Cube FW_F4 V1.28.3 | 与 `.ioc` 记录一致，再生成须用此组合 |
### 2.2 外设与引脚分配
> **权威来源**：V0.1 网表分析报告 + `Inc/main.h`（代码已迁移至 V0.1）。下表为 **V0.1 硬件**的引脚。
| 外设 | 接口 | 引脚 | 说明 |
|---|---|---|---|
| **CH395F 以太网** | SPI2 | PB12 CS / PB13 SCK / PB14 SDO / PB15 SDI | 10/100M 以太网控制器；PHY 强制 100M 全双工；**SPI 分频系数必须为 8**（PCB 设计约束） |
| **GD5F2GQ5UE NAND** | SPI1 | PE0 CS / PB3 SCK / PB4 MISO / PB5 MOSI / PB8 WP / PE1 HOLD | 256 MB SPI NAND（2 Gbit） |
| **TPAFE5160 ADC** | 并行 16 位 | PG0~PG15 数据 / **PC6 FRSTDATA** / **PC7 BUSY**(EXTI) / **PC8 RD** / **PC9 CONVST** / **PA8 OS2** / **PA11 OS1** / **PA12 OS0** | 高精度多通道 ADC |
| **SD2506 RTC** | I2C1 | PB6 SCL / PB7 SDA | 提供墙钟基准与日志时间戳 |
| **USART1（U5 直连 TTL）** | UART | PA9 TX / PA10 RX | **700000 8N1 → 屏板链路**（TTL 直连、无 DE，`../产品需求/产品需求设计文档.md` §5.16.2）；PA10 双向均已接线；日志已迁 UART5 |
| **UART4（RS-485）** | UART | PC10 TX / PC11 RX / **PA15 DE** | 半双工通信（V0.1 轮换后 RS485#4 = UART4，`../硬件平台/V0.1_网表详细分析报告.md` §4.2） |
| **USART2（RS-232 #3）** | UART | PD5 TX / PD6 RX | 经 U10 隔离 → U13 TPT3232E → CN1；固件目前未占用（日志实际走 UART5/RS232#1） |
| **UART5（RS-232 #1）** | UART | PC12 TX / PD2 RX | 经 U9 隔离 → U13 → CN1；**日志口**（115200，`@test` 采集通道；台架端子 `../子系统设计/屏板链路设计说明.md` §3.2） |
| **状态 LED ×6** | GPIO | PC5 / PB0 / PB1 / PB2 / PF11 / PF12 | **低电平点亮** |
| SWD | — | PA13 SWDIO / PA14 SWCLK | V0.1 已修复 V0.0 的 SWCLK 引脚缺陷 |
| 调试口 | — | CN2（XH-3A，1=SWDIO/2=SWCLK/3=GND） | V0.1 由 H2 排针改为 XH 端子 |
> ⚠️ **V0.0 / V0.1 差异**：V0.1 相比 V0.0 做了**接口裁剪（删 8080 LCD 与 8 键）+ U17 大面积引脚重排 +
> ADC 前端通道置换（17 路中 13 路变化）+ 调试口改型**。固件 BSP 与 ADC 通道映射表**必须按 V0.1 重映射**；
> 详见 `docs/硬件平台/V0.1_网表详细分析报告.md`。
### 2.3 存储器件
| 器件 | 容量 | 组织 | 软件栈 |
|---|---|---|---|
| GD5F2GQ5UE | 2 Gbit（256 MB） | 2048 块 × 64 页 × 2048 B | FatFS（FAT32）→ dhara FTL（磨损均衡 / 坏块管理 / GC）→ NAND 驱动 |
| SD2506 | — | I2C1 | RTC（时间/温度/电池诊断） |
- **BBT 持久化**：坏块表存于保留块池（顶部 4 块），不交给 dhara 管理。
- **单写者纪律**：`defaultTask` 拥有存储；`netTask` 只读 RAM 配置副本，不触卷。
- **FatFs 约束**：`FF_USE_LFN=0`（严格 8.3 文件名）；`FF_FS_REENTRANT=1` + `ffsystem.c` 互斥钩子（超时 1 s）；`FF_FS_NORTC=0`（`get_fattime` 直引用墙钟）。
### 2.4 硬件版本与兼容性
| 版本 | 状态 | 说明 |
|---|---|---|
| V0.0 | 历史 | 含 8080 LCD、8 按键；存在 2 处设计缺陷（SWCLK 引脚错误致 SWD 不通、ADC17 落在非 ADC 引脚） |
| **V0.1** | **当前** | 架构与 V0.0 一致；裁剪 LCD/按键、U17 引脚重排、修复上述 2 处缺陷；固件已迁移 |
| V0.2 | 规划关注 | 新增关注项：VCAP 电容值未标注、PC13/14/15 子板 LED 3 mA 限流、SPI1 无法双落点 |
### 2.5 平台约束
| 约束 | 内容 |
|---|---|
| **CubeMX 生成文件** | `Inc/`、`Src/` 中带 `USER CODE BEGIN/END` 标记；自定义代码**只能**写标记区内 |
| **生成区外的定制** | 仅限 `Src/iwdg.c` 延后启动、4 个 Fault Handler 实体（`scripts/check_cubemx_survival.py` 审计兜底） |
| **`osKernelStart` 前** | 禁止任何 FreeRTOS / CMSIS-RTOS API 调用 |
| **BOM / 编码** | 部分源文件带 BOM（`Drivers/BSP/UI/*`、`App/task/ui_task.c`、`App/cfg/cfg_file.c`、`Lib/lv_conf.h`），被工具改写丢 BOM 会导致 ARMCC 按 CP936 解码、中文字面量编译失败 |
| **SDIO** | V0.1 主板 SDIO 固定引脚组被 TPAFE/UART 全部占用 → **无 SDIO 能力**（当前设计不受影响，FatFs 卷在 SPI NAND 上） |
| **新源文件** | 必须双端注册（Keil `.uvprojx` + `simulator/CMakeLists.txt`），否则不参与编译 |
### 2.6 V0.1 硬件能力边界（对产品的硬约束）
下列五条是**硬件事实**，不是软件缺陷；需求档 §5 的功能范围与 需求档 §9 的"等条件"项均由它们推导：
| # | 约束 | 具体内容 | 产品影响 | 解除条件 |
|---|---|---|---|---|
| H1 | **双转换器无共同采样触发** | 8 路电气量分属 TPAFE5160（16 位、8 通道同步、±5 V 双极性）与 STM32 ADC1（12 位、顺序扫描、0~3.3 V 单极性）两片；两片无共同触发，STM32 侧 9 通道一轮约 67 µs | 跨转换器的**相位 / 功率 / 功率因数 / 对称分量 / 三相同时刻判据**一律不成立 → 方向元件、PT/CT 断线、三相过流、零序过流延后 | **V0.2 硬件**：8 路电气量全部接 TPAFE（与备用路对调串联电阻，料号不变，走线级改动）；固件只改映射表内容 |
| H2 | **STM32 侧无中点偏置** | 单极性 0~3.3 V，交流量负半周削顶 | `UB/UC/IB/IC/IN` 无有效值/相量，只能读码值**监视**；104 对应点恒置 IV | V0.2 补偏置 |
| H3 | **无出口继电器与开入回路** | 无跳闸/告警出口、无硬压板与开入遥信 | 保护动作只体现为**遥信 + 日志 + SOE**；104 遥控 `YK1~4/13/14` 否定确认 | 开入开出独立立项 + 硬件 |
| H4 | **无本地屏与按键** | 160×160 单色屏仅存在于远端客户端 | UI 以 TCP :7003 推流 + 远端按键回注（`../产品需求/产品需求设计文档.md` §8） | 产品形态即如此，不解除 |
| H5 | **无 SDIO** | SDIO 固定引脚组被 TPAFE/UART 占用 | FatFs 卷只能落 SPI NAND（当前设计不受影响） | 不解除 |
> **量纲口径**（由 H1/H2 派生）：在端子/子板变比确认与两点标定完成前，遥测与保护读数的单位是
> **ADC 引脚电压**（`eng=0`），不是二次值；此时 `ADC_CAL_F_VALID` 未置位，
> **保护判据整体停走**（`../产品需求/产品需求设计文档.md` §5.12）。这是刻意设计，不是"保护不动作"的缺陷。
scripts/check_doc_links.py
+25 -3
View File
@@ -300,6 +300,15 @@ def resolve_name(name: str, by_stem):
apath = (REPO_ROOT / alias) if alias else None
if apath is not None and apath.exists():
return apath, "alias"
# 别名后缀匹配：STEM_RE 贪心会把挂在前面的动词/修饰词一并吃进 name
# （「规格见需求档」「其行为以需求档」），精确查表落空后按**最长别名**做 endswith。
# 只放宽「此前判不了」的 token（原来进 skip），不改变已能判定的目标。
if not cand:
for key in sorted(load_aliases(), key=len, reverse=True):
if key != name and name.endswith(key):
apath = REPO_ROOT / load_aliases()[key]
if apath.exists():
return apath, "alias"
return None, None
@@ -431,9 +440,22 @@ def check_section_refs(path: pathlib.Path, lines, errors, warns):
continue
if tgt is None and prev_tgt is not None:
between = line[prev_end:m.start()]
if not chain_blocked(between, by_stem):
# 继承前一个 § 的目标**与它的判定档位**（自引用链仍按自引用处理）
tgt, kind = prev_tgt, prev_kind
# 中间挂着的词若是已登记别名且**紧邻** §（间隔 ≤ SEC_MAX_GAP 字符），
# 视为换目标，不许链着继承前一个 § 的文档；远处的词不算
gap_txt = between
am = STEM_RE.search(line[max(0, m.start() - 120):m.start()])
if am and not any(c in SEC_TERMINATORS for c in gap_txt):
# § 前紧邻的裸名（STEM_RE 锚定在窗口尾）若能解析成**另一篇**文档
# （「…§2.6 的 H1/H2，属需求档 §9.1.1」），链在此换目标；
# 「本文 §3 / §4」的「本文」解析不出文档 → 仍走原继承。
atgt, _akind = resolve_name(am.group(1), by_stem)
if atgt is not None and atgt != prev_tgt:
prev_end, prev_tgt, prev_kind = None, None, None
tgt = None
if tgt is None and prev_tgt is not None:
if not chain_blocked(between, by_stem):
# 继承前一个 § 的目标**与它的判定档位**（自引用链仍按自引用处理）
tgt, kind = prev_tgt, prev_kind
if tgt is None:
sm = STEM_RE.search(window)
if sm:
scripts/section_aliases.json
+6
View File
@@ -2,5 +2,11 @@
"内存方案": "docs/内存管理/RAM使用分析与优化方案.md",
"架构总览": "docs/架构设计/项目架构总览.md",
"规划": "docs/算法/继电保护功能复现规划.md",
"需求档": "docs/产品需求/产品需求设计文档.md",
"产品需求设计文档": "docs/产品需求/产品需求设计文档.md",
"架构硬件档": "docs/架构设计/系统架构与硬件规格.md",
"系统架构与硬件规格": "docs/架构设计/系统架构与硬件规格.md",
"复刻明细档": "docs/产品需求/参考产品复刻明细.md",
"复刻明细": "docs/产品需求/参考产品复刻明细.md",
"V0.0": "docs/硬件平台/V0.0_网表详细分析报告.md"
}