feat(ioboard): 开入开出板驱动、去抖快照与主机侧单测接入

74HC165 开入 + 光耦继电器开出的完整硬件抽象层,接进 defaultTask
的 50ms 节拍。开入 8 路(第二块 165 数据线板上未接,故只有 8 位),
开出 4 路(高电平吸合)。

驱动 BSP drivers:
- IOBOARD/ioboard.c 装载与移位时序,每步注明数据手册依据;
  SH/LD 拉高前先拉低 CLK,否则装载瞬间多移一位;
  单次读取上界 26us(延时按最慢列 VCC 2V 全温区取值)。
- IOBOARD/ioboard_bits.c 位序组装纯函数,只依赖 stdint.h,
  主机侧可直接 include 做单测:读 8 次为 H,G,F,E,D,C,B,A,
  A 放 bit0(bit(7-i) = reads[i])。
- 极性集中在 IOBOARD_DO_LEVEL_ACTIVE 一处,接口语义统一为
  mask 的 1 = 吸合。

业务接线:
- App/util/ioboard_di.c 通道去抖与双区快照,纯逻辑;
  刻意不 include ioboard.h(其引脚宏会牵入 main.h),
  两处路数常量由测试的编译期静态断言钉住。
- default_task.c 的 default_task_di_poll():读失败不喂去抖、
  不写发布值,只把上一有效值加 valid=0 发布出去,
  避免"全 0"被现场读成开入全部复归。
- 去抖实际粒度 50ms(每个轮询周期喂一拍),最坏上报约 100ms;
  想要真 20ms 需另建定时器,本次不做。
- Src/main.c 在 app_main_init 之前调 ioboard_init(),
  上电即把 4 路出口钉在全释放并确认 165 静止态。

测试:
- test/host/ioboard/ 100 条断言。位序主判据为单比特两端
  (只有 A 得 0x01、只有 H 得 0x80)加八点双射穷举;
  混合图样降级为辅助,因该图样曾先后被算成 0xA5、0x5A、0xAA。
- 去抖覆盖 20ms 边界、抖动不翻、跨 49.7 天回绕。
- 失败语义覆盖"失败保留上次有效值"与"失败窗口内的真实变位不丢"。

文档:
- 新增 docs/硬件平台/开入开出实施说明.md。
- 硬件规格与能力边界 §5 的能力边界现状改写:出口继电器与
  开入回路已具备、业务层未接入;4 路开出只可台架验证,
  不得用于真实跳闸。
- 修正 docs/文档规范.md §3.1:原文要求所有互链用仓库根相对,
  与 check_doc_links.py 的实际解析基准矛盾(markdown 链接按
  当前文档目录解析,反引号路径才按仓库根)。改为区分两类,
  并补 §3.1b 写明对应校验器。
- 清理 docs/任务规划/登记簿.md 改名为硬件改版登记.md 后
  遗留的 9 处旧名引用。

门禁: keil-build 0 Error 0 Warning;主机侧单测 ioboard 100/100、
sb_proto 45/45;pre-commit 48 根钩子全通过。
This commit is contained in:
2026-11-16 18:30:31 +08:00
parent d9f8dbfd90
commit fd767d1dcd
35 changed files with 3646 additions and 249 deletions
+3 -3
View File
@@ -25,7 +25,7 @@ docs/
├── 环境与部署/ 环境搭建与部署核对清单
├── CI/ 远程 CI(Gitea Actions)唯一入口 —— **只涉及本机一台 runner,日常开发不必读**
├── UI设计/ UI 架构、页面设计、字体与模拟器
├── 硬件平台/ 网表分析报告与语义图
├── 硬件平台/ 网表分析报告与语义图 + ADC 通道映射 + 开入开出实施说明
├── 芯片手册/ 外部芯片数据手册转录(只读资料)
└── images/ 文档技术配图(SVG 产物,由脚本生成)
```
@@ -73,7 +73,7 @@ docs/
|---|---|
| [`项目架构总览.md`](架构设计/项目架构总览.md) | 系统全景:六层分层、启动时序、存储·网络·UI 栈、目录组织 |
| [`软件架构与运行时规格.md`](架构设计/软件架构与运行时规格.md) | 六层分层表 / 任务模型 / 就绪位表 / 启动时序图 / 线程通信机制表 / 工具链与工程约束——**位表、机制表、时序图以本档为准**(自产品需求档拆出,2026-10-30 再按软/硬拆分) |
| [`硬件规格与能力边界.md`](架构设计/硬件规格与能力边界.md) | 主控与内存 / V0.1 引脚分配表 / 存储器件 / 硬件版本兼容 / 能力边界 H1~H3——**引脚表与能力边界表以本档为准** |
| [`硬件规格与能力边界.md`](架构设计/硬件规格与能力边界.md) | 主控与内存 / V0.1 引脚分配表 / 存储器件 / 硬件版本兼容 / 能力边界 H1~H3——**引脚表与能力边界表以本档为准**;开入开出的实施细节见 [`硬件平台/开入开出实施说明.md`](硬件平台/开入开出实施说明.md) |
| [`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 选型与检查清单 |
@@ -266,7 +266,7 @@ docs/
| 位置 | 内容 |
|---|---|
| [`任务规划/`](任务规划/README.md) | **两个文件**:`README.md` = 全项目推进顺序(唯一权威);`登记簿.md` = V0.1 硬件缺陷 → V0.2 改版要求。其余待办跟着所属模块走(各文档「已知限制 / 重开条件」节):采集数据可信度 → `docs/算法/采集与算法层设计说明.md` §13、台阶图 → `docs/硬件平台/ADC通道映射说明.md` §9、RS-485 → `docs/产品需求/产品需求设计文档.md` §5.10 |
| `硬件平台/` | 网表详细分析报告与语义图(V0.0 / V0.1);**[`ADC通道映射说明.md`](硬件平台/ADC通道映射说明.md)——V0.1 十七路 ADC 语义/网名/通道号权威映射表(固件取数、UI 显示、自检注入以此为准),含 §7 链路四段口径、§8 注入实测记录与 §9 数据可信五级台阶/波次退出判据** |
| `硬件平台/` | 网表详细分析报告与语义图(V0.0 / V0.1);**[`ADC通道映射说明.md`](硬件平台/ADC通道映射说明.md)——V0.1 十七路 ADC 语义/网名/通道号权威映射表(固件取数、UI 显示、自检注入以此为准),含 §7 链路四段口径、§8 注入实测记录与 §9 数据可信五级台阶/波次退出判据**;**[`开入开出实施说明.md`](硬件平台/开入开出实施说明.md)——74HC165 开入(8 路)与 4 路光耦继电器开出的接线、时序原理、软件分层与接口、上板验证步骤与已知限制** |
| `芯片手册/` | 外部芯片数据手册转录(CH395F / GD5F2GQ5UE / SD2506 / TPAFE5160 / RTL8305NBI 等) |
| `images/` | 文档技术配图(`.svg` 产物,由 `tools/arch_diagram/`、`tools/refgraph/` 生成) |
+1 -1
View File
@@ -44,7 +44,7 @@
| **1** | **端子 / 子板变比确认 → 多点标定** | 变比已按参数算定;标定未开工 | 缺标准源。开工前必须先拍板四件事(精度目标、变比来源、`eng=0` 期测频门处置、标定点数与分布),见 `docs/算法/采集与算法层设计说明.md` §13.13 |
| **2** | 标准源送检与第三方 104 主站验收 | 等待标定 | UA/IA 标定已完成;UN(零序电压 U0)本台架未接线,保护仍闭锁;送检窗口前 2 日冻结特性 |
| **3** | 定值 / 映射 / 遥测 / 软压板铺开 | 等排期 | 必须晚于标定,否则铺出去的全是 IV 点(两条不可颠倒的顺序见 `docs/产品需求/产品需求设计文档.md` §9.2) |
| **4** | 保护元件与采集增强 | 等待标准源或硬件改版 | 先给 UN 接 UZ+UN 并标定以解除闭锁;跨转换器相位 / 功率 / 对称分量类功能等 V0.2 硬件(缺陷见 `docs/任务规划/登记簿.md` §1) |
| **4** | 保护元件与采集增强 | 等待标准源或硬件改版 | 先给 UN 接 UZ+UN 并标定以解除闭锁;跨转换器相位 / 功率 / 对称分量类功能等 V0.2 硬件(缺陷见 `docs/任务规划/硬件改版登记.md` §1) |
| **5** | 其余结构与可靠性评估 | 排队 | 观察项的归属是各模块文档的「已知限制」节,不为清清单强做 |
| **6** | 验证窗口事项 | 逢条件顺带 | CI runner、PC peer、CH340、负向故障注入条件到位即执行 |
| **7** | 独立模块与暂缓项 | 当前不排 | 开入开出、104 文件传输单独立项;RS-485 见 `docs/产品需求/产品需求设计文档.md` §5.10;内存优化按自身重开条件(`docs/内存管理/RAM使用分析与优化方案.md`) |
@@ -7,3 +7,4 @@
|---|---|---|---|---|
| 双转换器无共同采样触发 | **8 路电气量分属两片转换器(V0.1 硬件缺陷,需下一版硬件修改)**——UA/UN/IA 走 TPAFE5160(16 位、8 通道同步、±5 V 双极性),UB/UC/IB/IC/IN 走 STM32 ADC(12 位、顺序扫描、0~3.3 V 单极性):① 两片转换器无共同采样触发 + STM32 侧顺序扫描(9 通道一轮 ≈ 67 µs)→ 跨转换器通道**无同一时刻性、相位关系不确定**,主板侧功率/功率因数/相角/对称分量类运算不成立;② 同族电气量精度与量程不一致(LSB ≈ 152.6 µV vs ≈ 806 µV,且 STM32 侧前端无中点偏置、负半周削顶);③ 语义与硬件归属交叉,固件映射/UI 通道序/自检注入须逐通道查表绕开 | 2026-10-10 定性更正(**撤销** 2026-10-09 建档时"有意分配、不要修正"的说法) | **V0.2 改版要求**:8 路电气量 UA/UB/UC/UN/IA/IB/IC/IN **全部接 TPAFE5160**,与 TPAFE 上 5 路备用路(AIN5/13/7/15/12)对调串联电阻在转换器一侧的目的地——元件数量与料号不变,属走线级改动。**V0.1 现板软件口径**:主板侧只做逐通道独立监视,禁止跨转换器做相位/功率/功率因数/矢量类运算(此类量取子板计量模块结果)。固件侧消费者已落地(ADC 采集链路,2026-10-10,按语义映射表取数)→ V0.2 改版只改映射表内容,上层语义与代码不动 | `../硬件平台/ADC通道映射说明.md` §1/§7;`../硬件平台/V0.1_网表详细分析报告.md` §1.4 V10、§6-3 |
| IA 前端差分滤波限制谐波带宽 | **IA 通道差分滤波电容 C35 = 100 nF 构成一阶低通 fc ≈ 796 Hz,谐波产品路线的硬件前置未清**——250 Hz 注入读数 −4.4 % 即前端真实衰减(板端读数忠实;R19/R21 各 1 k `docs/硬件平台/V0.1.tel`:49 + C35 跨接差分对,拓扑 FR-ADC-5 `docs/产品需求/产品需求设计文档.md`);工频测量不受影响,外推 5 次 −4.6 %、9 次 −13 %、15 次 −27 %、21 次(1050 Hz)−39.6 % | 2026-11-04(模型与实测数据 `docs/测试说明/测试数据/boot_log_data/20261104_ac_ia_rc_model.txt`) | **改版/改板方向**:C35 换 10 nF(fc≈8 kHz、21 次仅 −0.9 %;改板优先于软件逐阶修正——容差与温漂使修正表不可信,理由详 `docs/硬件平台/ADC通道映射说明.md` §8.2)+ **清点其余各路差分滤波电容容值**(网表无容值标注,C35 = 100 nF 系用户口头确认,其余各路未定);将来有示波器可按预测复核(250 Hz 差分分量额外滞后 ≈17°)。详述 `docs/硬件平台/ADC通道映射说明.md` §8.2 | `docs/测试说明/专项验证/ADC前端注入验证流程.md` 谐波记录 B 行;`docs/硬件平台/ADC通道映射说明.md` §8.2 |
| 开入开出板接线错误 | 端子接线错误 + 第二块 74HC165 数据输出未接回 MCU | ① 端子接线错误:C1应该接GND C2应该接VDD50 C15:RUN_LED C16:EXTKI1;② 两块 74HC165 级联、共用时钟 `HC165_CLK`=PC3 与装载脚 `HC165_LD`=PC2,但**第二块的数据输出(QH)在板上没有连到 MCU**——MCU 侧只有一路串行数据 `HC165_IN2`=PE3,故**实际只能读一块芯片的 8 位开入**(设计 16 路);`PE2`(IN_D4)/`PE4`(IN_E4) 为旧命名残留、硬件上无信号(用户 2026-11-16 口径);开入 8 路与 4 路光耦继电器出口的驱动已落地,业务层未接入 | 实施口径 `docs/硬件平台/开入开出实施说明.md`;能力边界 H3 见 `docs/架构设计/硬件规格与能力边界.md` |
@@ -47,10 +47,10 @@ dhara 失败类 +84;RO 另 +208,全是该失败类名表)→ `ER_IROM1`
<!-- MEM_SNAPSHOT:BEGIN generated by scripts/check_mem_numbers.py -->
| 区域 | 用量 | 容量 | 占比 |
|---|---|---|---|
| ER_IROM1 | 288,628 B (281.86 KB) | 1,048,576 B (1024 KB) | 27.5% |
| RW_IRAM1 | 97,248 B (94.97 KB) | 131,072 B (128 KB) | 74.2% |
| ER_IROM1 | 289,800 B (283.01 KB) | 1,048,576 B (1024 KB) | 27.6% |
| RW_IRAM1 | 97,368 B (95.09 KB) | 131,072 B (128 KB) | 74.3% |
| RW_CCM | 57,376 B (56.03 KB) | 65,280 B (64 KB) | 87.9% |
| **Flash (ROM 合计)** | **290,716 B (283.9 KB)** | 1,048,576 B (1024 KB) | **27.7%** |
| **Flash (ROM 合计)** | **291,904 B (285.1 KB)** | 1,048,576 B (1024 KB) | **27.8%** |
<!-- MEM_SNAPSHOT:END -->
各区的容量与常量来源:
+21 -4
View File
@@ -68,11 +68,27 @@
## 3. 链接规范
### 3.1 文档间互链:仓库根相对路径
### 3.1 文档间互链:两种形态,各有归属
文档之间引用**一律使用仓库根相对路径**(形如 `` `docs/xxx/yyy.md` `` 或 `[文本](docs/xxx/yyy.md)`),**不使用** `../` 相对链接。
文档之间引用**按形态分两种写法**,不能混用——`check_doc_links.py` 对两者的解析基准不同(见 §3.1b):
> 理由:根相对路径对文档所在层级不敏感,迁移子目录时**零改动**;`../` 形态在目录调整时会成片失效。
| 形态 | 写法 | 解析基准 | 用途 |
|---|---|---|---|
| **反引号路径**(推荐,全仓主导) | `` `docs/xxx/yyy.md` `` | **仓库根** | 正文里"指路"式的文档引用,不加链接文字时 |
| **markdown 链接** | `[文本](../xxx/yyy.md)` | **当前文档所在目录**(故必须用 `../`) | 需要可点击跳转时 |
**为什么反引号形态推荐根相对**:它对文档所在层级不敏感,迁移子目录时零改动;`../` 形态在目录调整时会成片失效。全仓 37 份文档用 `../` 形态只为可点击,正文指路一律走反引号根相对。
**为什么 markdown 链接只能用 `../`**:`check_doc_links.py` 的 A 类校验按 `path.parent / raw_path` 解析(相对当前文档目录),写成 `[文本](docs/xxx.md)` 会被解析成 `docs/当前目录/docs/xxx.md` 而不存在 → 门禁必红。**不要**为了让"看起来是根相对"而把 markdown 链接改成 `[文本](docs/xxx.md)`,那一定通不过。
### 3.1b 门禁怎么判这两类
| 类 | 形态 | 基准 | 校验器实现 |
|---|---|---|---|
| A 类「markdown 链接」 | `[文本](目标)` | 当前文档目录 → **必须 `../`** | `check_md_links()` |
| B 类「路径引用」 | `` `docs/xxx.md` `` | 仓库根 → **必须 `docs/` 开头** | `check_backtick_paths()` |
改文档链接前先判断自己写的是哪一类,再决定前缀,否则门禁报的错会指向一个"文件明明存在"的路径。
### 3.2 图片链接:文档所在目录相对
@@ -360,7 +376,8 @@
- [ ] 放在正确的子目录(目录名无空格)
- [ ] 文件名符合命名约定(无空格 / 主题词+类型后缀)
- [ ] UTF-8 无 BOM、LF 换行
- [ ] 互链用仓库根相对路径;图片用当前目录相对路径
- [ ] 反引号指路引用用仓库根相对(`docs/xxx.md`);markdown 可点击链接用当前目录相对(`../xxx.md`)——两类基准不同,见 §3.1
- [ ] 图片用当前目录相对路径
- [ ] 尚未创建/已删除的引用加 `[计划]` 或状态词
- [ ] 已在 [`README.md`](README.md) 对应章节登记一行(**否则视为未完成**)
- [ ] 若涉及任务表/栈,跑 `gen_task_table.py --check`
@@ -8,7 +8,7 @@
> 本档是**完整口径表**——**引脚分配表**与**硬件能力边界表(H1~H3)**以**本档为准**,
> 两处冲突以本档为准并回改总览。
> **硬件口径**:V0.1(`docs/硬件平台/V0.1_网表详细分析报告.md` + `Inc/main.h`)。
> **版本**:v1.0 **日期**:2026-10-30
> **版本**:v1.1 **日期**:2026-11-16
## 1. 主控与内存
@@ -37,6 +37,8 @@
| **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,`/serial-boot-test` 采集通道) |
| **状态 LED ×6** | GPIO | PC5 / PB0 / PB1 / PB2 / PF11 / PF12 | **低电平点亮** |
| **74HC165 开入 ×8** | 串行移位 | **PC2 `SH/LD` / PC3 `CLK` / PE3 `QH`** | 两块级联、共用 PC2/PC3;**仅第一块的数据线接回 PE3**,故实际可读 8 路(第二块缺线,见 `../硬件平台/开入开出实施说明.md`)。PE2/PE4 为旧命名残留、硬件无信号 |
| **光耦继电器开出 ×4** | GPIO | **PC14 / PF0 / PF1 / PF6** | 每路驱动光耦二极管 → 继电器线圈;上电默认全释放 |
| SWD | — | PA13 SWDIO / PA14 SWCLK | V0.1 已修复 V0.0 的 SWCLK 引脚缺陷 |
| 调试口 | — | CN2(XH-3A,1=SWDIO/2=SWCLK/3=GND) | V0.1 由 H2 排针改为 XH 端子 |
@@ -66,10 +68,10 @@
## 5. V0.1 硬件能力边界(对产品的硬约束)
下列五条是**硬件事实**,不是软件缺陷;需求档 §5 的功能范围与 需求档 §9 的"等条件"项均由它们推导:
下列三条是**硬件事实**,不是软件缺陷;需求档 §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` 否定确认 | 开入开出独立立项 + 硬件 |
| H3 | **出口继电器与开入回路已具备,业务层未接入** | 板上已实装 4 路光耦驱动继电器出口与 74HC165 开入回路(引脚见 §2;实施口径见 `../硬件平台/开入开出实施说明.md`)。**开入实际只有 8 路**:两块 74HC165 级联,但第二块的数据输出未接到 MCU,只能读一块芯片。驱动层(`Drivers/BSP/IOBOARD/`)为纯硬件抽象,不含业务判断 | 保护动作**仍**只体现为**遥信 + 日志 + SOE**(保护判据处未标定闭锁,无逻辑驱动开出);104 遥控 `YK1~4/13/14` 仍否定确认;4 路开出当前只可用于台架验证,**不得用于真实跳闸** | 业务层接入:保护判据标定解除闭锁、104 遥信点表接入开入、继电器动作语义(跳闸/告警/闭锁)定义 |
@@ -408,7 +408,7 @@ TPAFE 双极性补码可注负压;STM32 单极性负半周测不了。UA/UN/IA
| 注入分量 | 发生器设定 | UI 读数 (V) | 期望 (V) | 偏差 % | `phasor` 旁证 | 结论 |
|---|---|---|---|---|---|---|
| A 只注二次 | 100.00 Hz / Vpp 0.453 V | `Ia=0` / `Ia2=0.158` / `Ia5=0` | 0.160 / ≈0 | **−1.25 %** | —(A/B 步落在 18:22–18:28 日志盲区,心跳旁证未留) | **过**(±2 % 内;选择性成立——100 Hz 没漏进基波 / 五次桶) |
| B 只注五次 | 250.00 Hz / Vpp 0.453 V | `Ia=0` / `Ia2=0` / `Ia5=0.153`(2026-11-04 复测;11-02 初读 0.152) | ≈0 / 0.160 | **−4.4 %**(超 ±2 %) | —(两轮均未留 250 Hz 心跳旁证——带外信号 `meas:` 判不了,见上卡旁证行) | **过——已按「板端真实衰减」关闭(2026-11-04)**:−4.4 % = IA 前端差分滤波(C35 = 100 nF + R19/R21 各 1 k,一阶低通 fc ≈ 796 Hz)在 250 Hz 的真实衰减,**板端读数忠实,量与算都没错**(模型与数据 `docs/硬件平台/ADC通道映射说明.md` §8.2);工频 50 Hz 仅 −0.2 %,不受影响;选择性成立(基波 / 二次桶 = 0);谐波功能要板改(C35 换 10 nF)——登记 `docs/任务规划/登记簿.md` §1 |
| B 只注五次 | 250.00 Hz / Vpp 0.453 V | `Ia=0` / `Ia2=0` / `Ia5=0.153`(2026-11-04 复测;11-02 初读 0.152) | ≈0 / 0.160 | **−4.4 %**(超 ±2 %) | —(两轮均未留 250 Hz 心跳旁证——带外信号 `meas:` 判不了,见上卡旁证行) | **过——已按「板端真实衰减」关闭(2026-11-04)**:−4.4 % = IA 前端差分滤波(C35 = 100 nF + R19/R21 各 1 k,一阶低通 fc ≈ 796 Hz)在 250 Hz 的真实衰减,**板端读数忠实,量与算都没错**(模型与数据 `docs/硬件平台/ADC通道映射说明.md` §8.2);工频 50 Hz 仅 −0.2 %,不受影响;选择性成立(基波 / 二次桶 = 0);谐波功能要板改(C35 换 10 nF)——登记 `docs/任务规划/硬件改版登记.md` §1 |
| C 纯基波 | 50.00 Hz / Vpp 0.453 V(实际按 0.453 注,Vpp 2.263 那档未做) | `Ia=0.160` / `Ia2=0` / `Ia5=0`(2026-11-04 复测;11-02 初读 0.159) | ≈0 / ≈0 | 基波 **0.0 %**(对 0.160 读数;11-02 为 −0.6 %) | **有**:18:33:43 起串口可见窗 `C01 rms=1 / C04 rms=0 / C05 rms=0`,与 C 步工况吻合;2026-11-04 复测窗串口 `ia_mv=159↔160` 同刻印证屏显 | **过**(两谐波轨零值经串口旁证补认;基波读数两轮 ≤0.6 %,与幅值轮同档一致) |
| 叠加(原行,**本轮不做**) | 基波 + 二次 + 五次同段 | — | — | — | — | 发生器无谐波叠加 / ARB 功能 → 本轮不做·设备缺口·TC-PHASOR-006 单测覆盖(`test/host/phasor/phasor_test.c`,3 条谱线各 ±1 %,实跑 57/57 PASSED) |
@@ -263,6 +263,6 @@ test/host/adc_input/adc_input_test.c
### 4.3 不覆盖 V0.1 的硬件缺陷(双转换器无共同采样触发)
V0.1 上 8 路电气量分属两片转换器且**无共同采样触发**(`docs/任务规划/登记簿.md` §1),本层只做**逐通道独立监视**。
V0.1 上 8 路电气量分属两片转换器且**无共同采样触发**(`docs/任务规划/硬件改版登记.md` §1),本层只做**逐通道独立监视**。
"跨转换器相量合成"(线 / 负序 / 零序)不得在本层或 全周傅氏相量上做——属「线/负序/零序合成」且 V0.1 受限
(见 `docs/算法/继电保护功能复现规划.md` §1.6)。
+1 -1
View File
@@ -397,7 +397,7 @@ Q16 后是 1.0e10,而 int32 上限只有 2.147e9;UB/UC 走 STM32 更到 5.28
**观察项(都判读过、非缺陷)**:TPAFE 输入浮空读数钉在 ≈1743/1747 mV 静态(撤线后 UA/IA 出现——读 `meas:` 时先确认接线);未接线的 STM32 侧引脚码值随环境缓漂(UC/IC/IN/T),不消费即可;录波触发后 `drop` 涨一截是 SEALED 窗口设计内(`App/algo/wave_ring.c:50`,涨完冻结,判失败只看 `err`/`ovf`);采集链全程 Δ9998/10 s、`idle=0`、`adc1_err=0`(前置门 8 条全过)。
**IA 前端差分滤波 = 低通 fc ≈ 796 Hz**:C35 = 100 nF 跨接差分对,与 R19/R21 各 1 k([`V0.1.tel`](V0.1.tel):49)构成一阶低通;拓扑为 1 k 串联 + 1 k 接差分负端、不分压(`docs/产品需求/产品需求设计文档.md` FR-ADC-5)。**250 Hz 的 −4.4 % 就是这颗电容在该频点的真实衰减,板端读数忠实**,工频 50 Hz 仅 −0.2 % 不受影响。谐波测量不够用——同拓扑外推:5 次 ≈ −4.6 %(出 ±2 % 判据)、7 次 −8.5 %、9 次 −13.0 %、11 次 −17.7 %、13 次 −22.6 %、15 次 −27.2 %、21 次(1050 Hz)−39.6 %;C35 改 10 nF 则 fc ≈ 8 kHz、21 次仅 −0.9 %。**谐波功能产品化的硬件前置 = 板改小 C35 + 清点其余各路差分滤波电容容值**(登记 `docs/任务规划/登记簿.md` §1)。**为什么改板而不是软件逐阶修正**:修正系数依赖这颗电容的实际容值,而它有容差、随温度漂,每块板、每个温度都不一样,修正表跟不上;二次谐波制动这类“拿某次谐波幅值与基波比值”的判据,比值被前端畸变后判定就不可信。换 10 nF 后测量带内是平的,板端读数直接可信。证伪条件(有示波器再复核):该低通预测 250 Hz 差分分量额外滞后 ≈17°;模型与三点拟合 `docs/测试说明/测试数据/boot_log_data/20261104_ac_ia_rc_model.txt`。
**IA 前端差分滤波 = 低通 fc ≈ 796 Hz**:C35 = 100 nF 跨接差分对,与 R19/R21 各 1 k([`V0.1.tel`](V0.1.tel):49)构成一阶低通;拓扑为 1 k 串联 + 1 k 接差分负端、不分压(`docs/产品需求/产品需求设计文档.md` FR-ADC-5)。**250 Hz 的 −4.4 % 就是这颗电容在该频点的真实衰减,板端读数忠实**,工频 50 Hz 仅 −0.2 % 不受影响。谐波测量不够用——同拓扑外推:5 次 ≈ −4.6 %(出 ±2 % 判据)、7 次 −8.5 %、9 次 −13.0 %、11 次 −17.7 %、13 次 −22.6 %、15 次 −27.2 %、21 次(1050 Hz)−39.6 %;C35 改 10 nF 则 fc ≈ 8 kHz、21 次仅 −0.9 %。**谐波功能产品化的硬件前置 = 板改小 C35 + 清点其余各路差分滤波电容容值**(登记 `docs/任务规划/硬件改版登记.md` §1)。**为什么改板而不是软件逐阶修正**:修正系数依赖这颗电容的实际容值,而它有容差、随温度漂,每块板、每个温度都不一样,修正表跟不上;二次谐波制动这类“拿某次谐波幅值与基波比值”的判据,比值被前端畸变后判定就不可信。换 10 nF 后测量带内是平的,板端读数直接可信。证伪条件(有示波器再复核):该低通预测 250 Hz 差分分量额外滞后 ≈17°;模型与三点拟合 `docs/测试说明/测试数据/boot_log_data/20261104_ac_ia_rc_model.txt`。
**边界**:本节不证端子二次值(④ 段变比已算定、标定未做,`eng` 仍为 0,见 §7.2)/ 精度等级(要标准源)/ 跨转换器相位(V0.1 硬件缺陷)/ THD。
@@ -63,7 +63,7 @@
| V7 | **VCAP1/VCAP2(U17.71/106)旁路电容 C94/C79 值未标注**:数据手册要求 VCAP1/VCAP2 各接 1~4.7µF 低 ESR 陶瓷电容至 VSS(内部 1.2V LDO 稳定裕量) | 实测 C94/C79 容值(若为 100nF 则低于手册建议,168MHz 满负荷下 1.2V 轨纹量/稳定性需留意);值补录 BOM |
| V8 | **V15/J3/F3 子板 LED 3 线落在 PC13/PC14/PC15**(脚 7/8/9):备份域电源开关供电,手册 Note 3 限**灌流 ≤3mA、≤2MHz、不可作电流源** | 核子板 LED 驱动电流需求;超 3mA 则 V0.2 移足驱力脚或子板加三极管扩展 |
| V9 | **V0.1 主板 SDIO 固定引脚组全被占用**:PC6/PC7/PC8/PC9/PA8(TPAFE 控制)+ PA9(USART1)+ PC10/PC11/PC12/PD2(UART4/UART5)= SDIO 全部 10 脚(F407 SDIO 无重映射) | 架构约束备案:V0.1 主板**无 SDIO 能力**;当前设计不受影响(代码未启用 SDIO,FatFs 卷在 SPI NAND 上) |
| **V10** | **8 路电气量分属两片转换器(V0.1 硬件缺陷,V0.2 改版项)**:UA/UN/IA 走 TPAFE5160(16 位、同步、±5 V 双极性),UB/UC/IB/IC/IN 走 STM32 ADC(12 位、顺序扫描、0~3.3 V 单极性)→ 跨转换器通道**无同一时刻性**(相位关系不确定)、精度与量程不一致。详见 §6-3 与 [`ADC通道映射说明.md`](ADC通道映射说明.md) §1(2026-10-10 定性更正;缺陷登记在 `docs/任务规划/登记簿.md` §1) | **V0.2 改版**:8 路电气量 UA/UB/UC/UN/IA/IB/IC/IN **全部接 TPAFE5160**,与 TPAFE 上 5 路备用路(AIN5/13/7/15/12)对调串联电阻在转换器一侧的目的地——元件数量与料号不变,属走线级改动。V0.1 现板:主板侧只做逐通道监视,**不做**跨转换器的相位/功率/功率因数/矢量运算 |
| **V10** | **8 路电气量分属两片转换器(V0.1 硬件缺陷,V0.2 改版项)**:UA/UN/IA 走 TPAFE5160(16 位、同步、±5 V 双极性),UB/UC/IB/IC/IN 走 STM32 ADC(12 位、顺序扫描、0~3.3 V 单极性)→ 跨转换器通道**无同一时刻性**(相位关系不确定)、精度与量程不一致。详见 §6-3 与 [`ADC通道映射说明.md`](ADC通道映射说明.md) §1(2026-10-10 定性更正;缺陷登记在 `docs/任务规划/硬件改版登记.md` §1) | **V0.2 改版**:8 路电气量 UA/UB/UC/UN/IA/IB/IC/IN **全部接 TPAFE5160**,与 TPAFE 上 5 路备用路(AIN5/13/7/15/12)对调串联电阻在转换器一侧的目的地——元件数量与料号不变,属走线级改动。V0.1 现板:主板侧只做逐通道监视,**不做**跨转换器的相位/功率/功率因数/矢量运算 |
## 2. 元件级变化
@@ -246,7 +246,7 @@ VDD50、5V、C3.3V、CGND、AVDDL(成员同,仅 C3 封装变)、STM_VDDA
3. **ADC 通道映射表重写**(§6):**已落地** → [`docs/硬件平台/ADC通道映射说明.md`](ADC通道映射说明.md)(语义 UA/UB/UC/UN、IA/IB/IC/IN、V_ZL2=温度检测,其余 8 路备用;含 TPAFE `buf[0..7]` 下标映射、STM32 通道宏、自检注入口径)。STM32 侧 9 路中 8 路在 PA0~PA7(IN0~IN7),**网名 ADC17(pin 44 = PC4)实现时用 `ADC_CHANNEL_14`**——原文写的 `ADC_CHANNEL_12` 与"第 17 路 = V_ZL2"均已勘误:V0.1 中 **ADC17 网名承载 AIN2 = UB**,**V_ZL2 走 ADC14 = PA5 = `ADC12_IN5`**。当前代码未启用 STM32 ADC(`HAL_ADC_MODULE_ENABLED` 注释状态),属实现时的注意事项。
4. **裁剪**:删除/停用 LCD(H1 8080)与 KEY1~8 相关代码(若有);面板按键功能如仍需要,需另立需求(V0.1 已无板上按键,仅 SW1 复位保留)。
5. **13 条悬空 GPIO 线配置安全默认电平**(B3①):U18 桥 11 线(PE6/PC13/PC14/PC15/PF0/PF1/PF4/PF5/PF6/PC2/PC3,LED 灭/继电器断/告警静默)+ SPI 镜像 2 线(PF1/PF2);其中 3 线在 PC13/14/15,**只能灌流 ≤3mA**(V8)。
6. **EXTKI×3 读取(如启用)必须配在 PE2/PE3/PE4(脚 1/2/3)**——V0.0 §5.2 写的"PC13/14/15"是引脚搞错(那三脚在 V0.1 已被 V15/J3/F3 占用,见 §11.2);硬件通路(U18 A 侧→PE2/3/4)V0.1 未变。
6. **EXTKI×3 读取(如启用)必须配在 PE2/PE3/PE4(脚 1/2/3)**——V0.0 §5.2 写的"PC13/14/15"是引脚搞错(那三脚在 V0.1 已被 V15/J3/F3 占用,见 §11.2);硬件通路(U18 A 侧→PE2/3/4)V0.1 未变。**2026-11-16 现状更正**:本条前半句已不适用于新板——PE3 现为 74HC165 开入的串行数据线 `HC165_IN2`,PE2(`IN_D4`)/PE4(`IN_E4`) 为旧命名残留、硬件上无信号;开入开出实施口径见 [`开入开出实施说明.md`](开入开出实施说明.md)。
7. V0.0 §5.2 功能级断言照做(ADC 注入读回、RS485 回环、CH395F PHY 寄存器读回)。
## 10. 上板验证补充(在 V0.0 §5.1 基础上追加)
@@ -335,7 +335,7 @@ VDD50、5V、C3.3V、CGND、AVDDL(成员同,仅 C3 封装变)、STM_VDDA
- **电源脚**:VDD×12(17/30/39/52/62/72/84/95/108/121/131/144)→3.3V ✓;VSS×9(16/38/51/61/83/94/107/120/130)→GND ✓;VBAT(6)→3.3V(1.65~3.6V 范围内)✓;PDR_ON(143)→3.3V(片内 LDO 开启配置 ✓);VSSA(31)→AGND ✓;VREF+(32)→3.3V ✓(VREF+=VDDA 为标准接法);VCAP1(71)/VCAP2(106)→C94/C79→GND ✓(**值未标注,手册要求 1~4.7µF 低 ESR**,V7)
- **BOOT0(138)→GND** ✓(复位默认从 Flash 启动,配置正确)
- HSE:PH0/PH1(23/24)+12pF×2 ✓;CH395F INT:PE5(4) GPIO ✓;EXTKI×3:PE2/PE3/PE4(1/2/3) GPIO ✓
- HSE:PH0/PH1(23/24)+12pF×2 ✓;CH395F INT:PE5(4) GPIO ✓;EXTKI×3:PE2/PE3/PE4(1/2/3) GPIO ✓(**2026-11-16**:V0.1 主板的 PE2/PE3/PE4 现由开入开出板占用,PE3 = 74HC165 串行数据,见 [`开入开出实施说明.md`](开入开出实施说明.md))
- TPAFE 并口 DB0~15 = PG0~PG15(56/57/87~94/124~129/132)FT I/O ✓
- SPI1(NAND):PB3/4/5(133~135)=SCK/MISO/MOSI(AF5)✓,CS/HOLD/WP=PE0(141)/PE1(142)/PB8(139) GPIO ✓
- SPI2(CH395F):PB13/14/15(74~76)=SCK/MISO/MOSI(AF5)✓,CS=PB12(73) GPIO ✓
@@ -349,7 +349,7 @@ VDD50、5V、C3.3V、CGND、AVDDL(成员同,仅 C3 封装变)、STM_VDDA
1. **V0.1 的 U17 连接经数据手册核对全部电气成立**(AF/GPIO/ADC/SWD/电源/BOOT0 逐项无误),未发现"不可能连接";
2. V0.1 **修复了 V0.0 的 2 处真实设计缺陷**(B4:SWCLK 104→109——V0.0 实板 SWD 不通,实测飞线调通;B5:ADC17 46→44)——除接口裁剪外,这是本次改版最有实质的硬件收益;
3. 新核出 3 项关注点:**V7**(VCAP 电容值未标注)、**V8**(PC13/14/15 的 3mA 驱动限制 vs 子板 LED)、**V9**(V0.1 主板 SDIO 能力被完全占用——当前无碍,架构约束备案);
4. 代码侧同步项收敛为 4 条:TPAFE 控制 7 线迁移(§9-1)、13 条悬空 GPIO 安全电平(§9-5)、网名 ADC17(PC4)用 `ADC_CHANNEL_14`(§9-3,原写 `ADC_CHANNEL_12` 已勘误)、EXTKI 读 PE2/3/4 而非 PC13/14/15(§9-6);
4. 代码侧同步项收敛为 4 条:TPAFE 控制 7 线迁移(§9-1)、13 条悬空 GPIO 安全电平(§9-5)、网名 ADC17(PC4)用 `ADC_CHANNEL_14`(§9-3,原写 `ADC_CHANNEL_12` 已勘误)、EXTKI 读 PE2/3/4 而非 PC13/14/15(§9-6,**其中 PE2/PE3/PE4 已被 2026-11-16 开入开出板改写**——PE3 = 74HC165 数据线,PE2/PE4 无信号,见 [`开入开出实施说明.md`](开入开出实施说明.md));
5. V0.0 报告"引脚编号与数据手册不符"结论**撤销**,实物抽查项关闭,5 处文字表述追溯更正(§11.2)。
## 附录 A:比对方法
@@ -0,0 +1,381 @@
# 开入开出板实施说明
> **文档定位**:V0.1 主板「开入开出板」的**实施口径**——硬件接线、时序原理、软件分层与接口、上板验证步骤、已知限制。
> **一句话结论**:板上**能读 8 路开入、能控 4 路开出**;第二块 74HC165 的数据输出线在板上没接到 MCU,所以**开入是 8 路而不是设计的 16 路**。
> **相关文档**:引脚总表与能力边界 [`硬件规格与能力边界.md`](../架构设计/硬件规格与能力边界.md);
> 硬件缺陷登记 [`硬件改版登记.md`](../任务规划/硬件改版登记.md);V0.1 网表逐脚核对的出处 [`V0.1_网表详细分析报告.md`](V0.1_网表详细分析报告.md)。
> **版本**:v1.1 **日期**:2026-11-16
---
## 1. 这板子是干什么的、现在能不能用
**读这一节是为了在动手接线或写上层代码之前,先知道自己拿到的到底是一个"能用"的功能,还是"只有底座"的半成品。** 答案分三层:硬件实装了、驱动写好了、业务层还没接入——三层不能混为一谈。
### 1.1 干什么用
开入开出板给 DTU 补两类**开关量**能力(开关量指只有"通/断"两种状态、不含连续数值的信号,区别于 ADC 采的电压电流这类模拟量):
- **开入**(数字输入,DI):把断路器位置、隔离刀闸位置、硬压板投退这类**外部触点的通断状态**读进 MCU,供遥信、告警、联动判断使用。
- **开出**(数字输出,DO):由 MCU 输出电平,经**光耦**(把 MCU 侧的 3.3 V 弱电与继电器侧的强电隔开的光电器件)驱动**继电器线圈**,继电器触点再去控制外部回路。
### 1.2 现在能不能用——分三层看
| 层次 | 状态 | 依据 |
|---|---|---|
| **硬件** | ✅ 已具备 | 4 路光耦继电器出口 + 74HC165 开入回路在板上实装;引脚已由 CubeMX 配好并重生成(`Inc/main.h` 有宏、`Src/gpio.c` 的 `MX_GPIO_Init` 有初值) |
| **驱动(BSP 硬件抽象层)** | ✅ 已实现 | `Drivers/BSP/IOBOARD/` 下的纯逻辑层与 GPIO/时序层,只做引脚操作与位序组装,见本文「软件结构」一节 |
| **业务层** | ❌ 未接入 | 保护判据仍处**未标定闭锁**态;104 规约的遥信点表未接开入;继电器动作语义(哪路是跳闸、哪路是告警、哪路是闭锁)**尚未定义** |
**因此当前能做的**:用调试口读回 8 路开入的真实状态、单独驱动某一路继电器观察动作。
**当前不能做的**:让保护逻辑自动跳闸、把开入量作为 104 遥信上送、在 UI 上配置遥信点表。**即便开出通道能驱动,也不允许用它做真实跳闸**——保护判据未标定,误动的代价是断开一次真实负荷。
### 1.3 开入为什么只有 8 路
设计意图是两块 74HC165 级联、共 16 路开入。但**第二块芯片的数据输出线(QH)在板上没有连到 MCU**,MCU 侧只有 PE3 这一路串行数据输入。一次读操作移出的 8 位只能来自第一块芯片,第二块的 8 位**物理上到不了 MCU**。
这不是软件能绕开的问题——没有回传通路,读什么都是第一块芯片的数据。修法见本文「已知限制与后续」一节。
---
## 2. 硬件接线
**读这一节是为了照着接线、排查接线,以及在 CubeMX 重生成后核对引脚没有被改动。** 先看 MCU 侧的 7 根线,再看 74HC165 这一侧的两块芯片怎么接。
### 2.1 MCU 侧引脚表
| 引脚 | `Inc/main.h` 宏名 | 方向 | CubeMX 初值 | 接到哪里 |
|---|---|---|---|---|
| PC2 | `HC165_LD_Pin` | 推挽输出 | 高(移位态) | 两块 74HC165 的 `SH/LD`(装载脚),并联 |
| PC3 | `HC165_CLK_Pin` | 推挽输出 | 低 | 两块 74HC165 的 CLK,并联 |
| PE3 | `HC165_IN2_Pin` | 输入(无上下拉) | — | 第一块 74HC165 的 QH(串行输出) |
| PC14 | `KO6_Pin` | 推挽输出 | 见「开出极性」 | 光耦 → 第 1 路继电器线圈 |
| PF0 | `TRIP_LED_Pin` | 推挽输出 | 见「开出极性」 | 光耦 → 第 2 路继电器线圈 |
| PF1 | `ERT_LED_Pin` | 推挽输出 | 见「开出极性」 | 光耦 → 第 3 路继电器线圈 |
| PF6 | `CLZ_LED_Pin` | 推挽输出 | 见「开出极性」 | 光耦 → 第 4 路继电器线圈 |
宏名里的 `_LED` 是**历史命名**(这 4 个脚早期用作指示灯),现在驱动的是继电器线圈;`KO6` 里的 "KO" 是"开出"的拼音首字母缩写。
### 2.2 74HC165 侧:两块芯片共用两根控制线,数据线只有一根
- 两块芯片的 **CLK(PC3)并联**、**`SH/LD`(PC2)并联**。这意味着每一次装载、每一个移位拍,两块芯片的动作是**同时**的——时钟会把两块一起往前推。
- 但**只有第一块的 QH 接到了 MCU 的 PE3**;第二块的 QH 在板上**没有走线**,处在悬空。
- 正确级联的做法是"第一块 QH → 第二块的串行输入,第二块 QH → MCU"。板上的现况是这条链只接了前半段的一半,所以移出的 8 位始终来自第一块。
结论就是一句话:**级联的硬件骨架在,回传通路断了一截**,因此实际可读 8 路。补线方案见本文「已知限制与后续」。
### 2.3 旧命名残留:PE2 与 PE4
`Inc/main.h` 里还有 `IN_D4_Pin`(PE2)与 `IN_E4_Pin`(PE4)两个宏,`Src/gpio.c` 的 `MX_GPIO_Init` 也仍然把它们初始化成输入。但**这两根脚在硬件上没有信号**——是 V0.0 时代"三路外部开入 EXTKI 读取"方案留下的命名残留。
因此:
- **不要**把 PE2/PE4 当成可用的开入通道,读到什么都无意义;
- `Drivers/BSP/IOBOARD/` 的驱动**完全不碰这两根脚**(只初始化并在读操作里使用 PC2/PC3/PE3 与 4 根开出);
- 这两根脚的初始化留在 CubeMX 生成代码里,是历史遗留,不影响功能,但清理需要动 `USER CODE` 区之外的配置,**留给硬件改版时一并定夺**。
---
## 3. 时序原理
**读这一节是为了在读数和算例对不上时,能自己从头推一遍——而不是只能怀疑驱动。** 三个信号各司其职,先后顺序不是随意定的,是数据手册规定的。
### 3.1 三个信号各自干什么
| 信号 | 作用 |
|---|---|
| `SH/LD`(装载/移位选择) | **低电平 = 装载**:把 8 路并行输入(通道 A 到 H)一次性抄进芯片内部的 8 个触发器。**高电平 = 移位**:不再看并行输入,只在时钟沿上把内部数据往 QH 推 |
| CLK(时钟) | 只在 `SH/LD` 为高时有效。**上升沿**触发,每来一个沿,内部数据往前移一位,最后一位从 QH 出去 |
| QH(串行输出) | 芯片唯一的输出脚。装载完成后 QH 上就已经是 H 通道的电平 |
### 3.2 为什么顺序必须是「先拉低 CLK → LD 拉低装载 → LD 拉高 → 逐拍移位」
数据手册对这一步有明确要求:**`SH/LD` 由低升到高之前,CLK 必须已经是低**(原文 "CLK and CLK INH should be LOW before the LOW-to-HIGH transition of SH/LD to prevent shifting the data")——否则那次低到高的跳变会被当成一个时钟沿,把刚装载进来的数据当场推走一位,读出来整体错位。
所以驱动里固定的动作序列是:
1. 先把 CLK **拉低**(哪怕它本来就是低,也要显式置一次,保证前置条件成立);
2. 把 `SH/LD` **拉低**——此时并行数据被抄进内部寄存器;
3. 保持一小段延时,等数据稳定;
4. 把 `SH/LD` **拉高**——进入移位模式,此刻 QH 上已经是 H 通道的电平;
5. 读 QH(第 1 次)→ 打一个 CLK 上升沿 → 延时 → CLK 拉低 → 延时,重复 8 次。
### 3.3 为什么读出来的顺序是 H,G,F,E,D,C,B,A
因为装载是**并行同时**抄进去的,而移出只能一位一位从 QH 走:
- 装载完成、第一个时钟沿**之前**,QH 上已经是 **H**;
- 第 1 个时钟沿把 H 推出去,QH 变成 G;
- 第 2 个沿出 G,……第 8 个沿出 A;
- 所以**8 次读到的顺序是 H、G、F、E、D、C、B、A**,**A 是最先被推出去的,也就是最低位(LSB)**。
接口约定是「**bit0 = A、bit7 = H**」,与"读到的先后顺序"正好相反,所以组装时要把第 i 次读到的比特放进第 (7 − i) 位。
### 3.4 算例:只有 A 与 H 两路有信号
这个算例是**人工核对的第一依据**——台架读数与它不一致时,第一件事是照着这张表重算一遍,而不是去怀疑驱动。之所以选它,是因为它只有两个 1、位置一前一后,人脑推的时候不容易错。
**前提**:假设 8 路开入里只有通道 A 与通道 H 为高电平,其余 6 路为低。
| 时刻 | 动作 | 此刻 QH 上是 | 读到的值 | 该值最终落在 |
|---|---|---|---|---|
| 装载完成 | `SH/LD` 已拉低再拉高 | H | 1 | bit7 |
| 第 1 个 CLK 沿前 | — | G | 0 | bit6 |
| 第 2 个沿前 | — | F | 0 | bit5 |
| 第 3 个沿前 | — | E | 0 | bit4 |
| 第 4 个沿前 | — | D | 0 | bit3 |
| 第 5 个沿前 | — | C | 0 | bit2 |
| 第 6 个沿前 | — | B | 0 | bit1 |
| 第 7 个沿前 | — | A | 1 | bit0 |
- 读序列 = `[1, 0, 0, 0, 0, 0, 0, 1]`
- 组装(第 1 个 → bit7,第 8 个 → bit0):bit7 = 1、bit0 = 1,其余为 0
- **结果 mask = 0x81**
**这个算例已与实现核对一致**:`Drivers/BSP/IOBOARD/ioboard_bits.c` 的 `ioboard_di_assemble()` 用 `mask |= 1 << (7 - i)` 逐位放入,`i=0`(H)进 bit7、`i=7`(A)进 bit0,与上表完全吻合。同一结论也写在 `Drivers/BSP/IOBOARD/ioboard_bits.h` 的函数注释里。
**报告里只会看到十进制**:`0x81` 是十六进制写法(八位二进制 `1000_0001`),十进制是 **129**。调试口打印的若是十进制,看到 129 就是算例命中。
### 3.5 混合算例:多路同时有信号时怎么核对
只有一个 1 的图案容易读,**多路同时为 1 才是台架上真正会遇到的情况**,也最容易人工推错。下面三组图样按"从易到难"排列,前三组都用工具确认过(见本节末的核对方式),第四组专门用来说明**为什么不要自己临时心算**。
**混合算例一:H、G、B、A 四路有信号(推荐用它与 0x81 配对做人工核对)**
- 读序列 = `[1, 1, 0, 0, 0, 0, 1, 1]`(第 1、2、7、8 拍)
- 逐位落位:第 1 拍→bit7、第 2 拍→bit6、第 7 拍→bit1、第 8 拍→bit0
- **结果 mask = 0xC3**(十进制 195,二进制 `1100_0011`)
选它的理由:**非回文、非交替、也不是整段连续的 1**。它的 1 集中在两端、中间留空,既不会像交替图样那样在"正序/反序"之间产生互补值的巧合,也不会像 `0xF0`/`0x0F` 那样在"整体移位一位"的错误下看起来还像那么回事。
**交替算例:H、F、D、B 四路有信号**
- 读序列 = `[1, 0, 1, 0, 1, 0, 1, 0]`(第 1、3、5、7 拍)
- 逐位落位:→ bit7、bit5、bit3、bit1
- **结果 mask = 0xAA**(十进制 170,二进制 `1010_1010`)
它的反相版本(G、E、C、A 有信号,读序列 `[0,1,0,1,0,1,0,1]`)→ **0x55**(十进制 85)。这两条互为镜像,是很好的"方向判据":**如果读交替图样得到 0x5A 或 0xA5,说明组装时既没有整段反序、也没有整段正序,而是发生了某种位移或串位——先查时序,别急着改代码。**
这条图样有个必须提醒的来历:**2026-11-16 它在项目里先后被三个人算出 0xA5、0x5A、0xAA 三个值**。前两个都不是任何实现的输出,是人工推导时的正反序混淆与漏位。所以它虽然正确值已确认为 0xAA,但**不适合当人工核对的第一依据**——人工核对的顺序应当是:先用「只有 A → 0x01」「只有 H → 0x80」两条单比特用例,再用本节的 0x81 与 0xC3,最后才轮到交替图样。
**边界算例:全 0 与全 1**
- 全低 → 读序列全 0 → **mask = 0x00**
- 全高 → 读序列全 1 → **mask = 0xFF**
这两条对位序不敏感(反序、移位、串位都无法被发现),**只能用来证明"线通、能读到电平",不能用来证明位序对**。上板验证时先做这两条排除接线问题,再进位序核对。
**核对方式(为什么这几个数可以直接信)**:以上期望值不是凭手推写进文档的,而是与 `test/host/ioboard/` 的**主机侧单测**逐条对齐——该套件实测 **100/100 PASSED**。位序的主判据不是任何单一混合图样,而是:
1. **单比特两端**:「只有 A → 0x01」「只有 H → 0x80」两条。A 是最后移出的一位,若实现忘了反序,A 会落到 bit7;只测其中一个端点仍可能被"整体反序再取反"之类的等价变形骗过,两端同时钉住才能把"反序"这个动作本身锁死。
2. **八点双射穷举**:8 个位置分别单独放一个 1,断言结果恰好是 8 个互不相同的单比特、恰好覆盖 bit0 到 bit7 全部,且能摸到 bit7。这条覆盖了**完整的定义域**,单靠 A/H 两端抓不到"中间某两位合流到同一位"这类错误。
混合图样(0x81 / 0xC3 / 0xAA / 0x55)是在这两条主判据之上补充的**组合形态证据**,给人工在台架上做"一眼看得出对错"的对照用。
### 3.6 数据手册出处
三家厂商(TI、ST、Nexperia)的 74HC165 功能表一致,本节引用的行为都出自其中的"功能模式"真值表:
- TI SN74HC165:[https://www.ti.com/tw/lit/gpn/sn74hc165-q1](https://www.ti.com/tw/lit/gpn/sn74hc165-q1)
- ST M74HC165:[https://docs.rs-online.com/27f1/0900766b80ede7fe.pdf](https://docs.rs-online.com/27f1/0900766b80ede7fe.pdf)
---
## 4. 软件结构
**读这一节是为了在上层写代码时知道该调谁、mask 里的 1 到底代表什么、出错该看哪里。** 核心原则是:**BSP 只管引脚与位序,任何"这一路是跳闸还是告警""要不要动作"的判断都不在这一层。**
> 本节内容已与 `Drivers/BSP/IOBOARD/` 下的实际代码逐项核对(2026-11-16):接口签名与 `ioboard.h` 一致,时序顺序与 `ioboard.c` 的 `ioboard_di_shift()` 一致,位序组装与 `ioboard_bits.c` 的 `ioboard_di_assemble()` 一致。
### 4.1 分层
| 层 | 位置 | 职责 | 不做的事 |
|---|---|---|---|
| 纯逻辑层 | `Drivers/BSP/IOBOARD/ioboard_bits.c` | 把 8 个读到的比特组装成开入 mask | 不碰任何寄存器,不 include HAL / CMSIS / FreeRTOS,主机侧可直接编译单测 |
| 硬件时序层 | `Drivers/BSP/IOBOARD/ioboard.c` | 引脚读写、装载与移位时序、临界区、开出极性转换 | 不判断业务语义 |
| 业务层 | 保护判据 / 104 遥信 / UI | 去抖、点表映射、动作逻辑 | 不直接碰 GPIO |
**为什么要把位序组装单独拆成一个不依赖硬件的纯函数**:位序错了不报错,只是数据差一位;而"位序错一位"和"线接错一位"在台架上完全同形、无法归因。拆成纯函数后可以在 PC 上用假数据把位序钉死,台架只剩接线问题要查。
### 4.2 接口
| 接口 | 职责 | 参数语义 |
|---|---|---|
| `ioboard_init()` | 初始化:确认静止态、把 4 路开出置为全释放、清影子寄存器 | 无。返回 `BSP_ERR_STATE` 表示静止态确认失败(引脚被别人动过) |
| `ioboard_di_read(uint8_t *out_mask)` | 读一次 8 路开入(完整装载 — 8 拍移位 — 到位序反转) | `out_mask` 输出 bit0 = 通道 A … bit7 = 通道 H。任意上下文可调,内部自动选临界区 |
| `ioboard_di_read_from_isr(uint8_t *out_mask)` | 同上,专供中断上下文 | 语义相同,临界区换成中断版本 |
| `ioboard_do_write(uint8_t mask)` | 写一次 4 路开出 | mask 的 bit0 到 bit3 分别对应 4 路;**1 = 继电器吸合**,与硬件电平高低无关 |
| `ioboard_do_get(uint8_t *out_mask)` | 取软件影子寄存器里的当前开出 mask | 读的是驱动认为的状态,不读引脚 |
| `ioboard_do_read_level(uint8_t *out_level)` | 直接读 4 根开出引脚的**实际电平** | 用于极性核对:与 `ioboard_do_get()` 对不上,说明有人在驱动之外动过这 4 根脚 |
**mask 里 1 的含义**:开入 mask 的 1 = 该路**有信号**(触点闭合 / 压板投入);开出 mask 的 1 = 该路**继电器吸合**。两个方向的 1 都代表"该通道处于激活态",与硬件电平的高低**无关**——电平极性的换算在驱动内部完成。
### 4.3 极性约定
软件约定只有一个:**mask 的 1 = 继电器吸合**。硬件上是高电平吸合还是低电平吸合,由驱动内部的一层转换决定,上层完全看不到。
- 转换点只有一处:`Drivers/BSP/IOBOARD/ioboard.h` 的宏 `IOBOARD_DO_LEVEL_ACTIVE`;
- **要改极性就只改这一个宏**,千万不要在上层逐路取反;
- 当前取值按"高电平吸合"配置,**尚未在台架上实测核对**——上板验证时若发现"写 1 反而不吸合",先改这个宏,再怀疑硬件。
### 4.4 上电默认态
`ioboard_init()` 会把 4 路开出置为**全释放**并清影子寄存器。这是安全设计:上电默认所有出口不动作。
但要注意**从上电到 `ioboard_init()` 执行之间**有一段窗口,这期间引脚电平由 CubeMX 生成的初值决定(见「硬件接线」的引脚表),驱动管不到。因此上板验证时**务必观察上电瞬间有没有误吸合**,这是「开出:逐路验证继电器动作」一节的第一条。
### 4.5 时序实现要点
驱动里所有延时都是用**忙等计数**实现的(按 168 MHz 主频换算的循环次数),不是硬件定时器。这样做换来的是时序最短、最可预期,代价是这几微秒内 CPU 被独占。
因此:**整个装载加 8 拍移位全程在临界区里完成**,不允许被中断打断——一旦被打断,中断里若有耗时操作,移位时序被拉长,虽然 74HC165 本身对时钟频率下限没有苛刻要求,但会拖长读一次开入的总时间。驱动声明的上界是 `IOBOARD_DI_READ_MAX_US`(26 µs),业务层若对周期有要求,按这个上界估算预算。
### 4.6 去抖
**当前驱动不含去抖**,它只负责把"此刻 8 路是什么状态"如实读出来。机械触点在闭合瞬间会抖动数毫秒、产生多次跳变,若直接把每次读数都当作变位上送,会刷出一串假事件。
去抖与变位检测属于**业务层**职责,与本板卡驱动无关;接入位置与现状见本文「已知限制与后续」的「尚未接入的部分」。
---
## 5. 上板验证步骤
**读这一节是为了在第一次上电时按顺序把"线通不通 → 电平对不对 → 位序对不对 → 时序稳不稳"四件事逐级排除,而不是一上来就怀疑代码。** 整节所有判据均为**待台架验证**——本机无硬件,以下步骤的描述基于代码与数据手册推导,尚无一手的台架实测记录。
### 5.1 开入:逐路验证通道对应关系
**目的**:确认"第几个 bit 对应板上第几个端子"。
操作步骤(一次只动一路,其余保持原状):
1. 让设备上电运行,打开调试口日志(日志走 UART5,115200)。
2. 读一次开入,记下 mask 作为基线。若所有通道都悬空,基线可能是全 0 也可能是全 1——**先记下来,不预设**。
3. 把**第 1 路**的开入端子短接到 GND(或按该板的输入极性接到 24 V,取决于端子设计),稳定保持 2 秒以上。
4. 再读一次 mask。**判据**:只有 1 个 bit 发生变化,其余 7 位与基线相同。
5. 记录这个变化落在哪一位,然后恢复端子、换下一路重复。
**通道与 bit 的约定**:通道 A 必须落在 **bit0**(最低位),通道 H 落在 bit7。做这一步之前,先回「时序原理」一节把三条基本判据走一遍——**只有 A 动作 → 0x01**、**只有 H 动作 → 0x80**、**A 与 H 同时动作 → 0x81**。这三条通了再逐路扫其余 6 路。
**这一步的预期耗时**:8 路各做一遍,路与路之间要等机械触点稳定,实际不会很快;不要因为前两路顺就省略后面几路的核对——中间某两位"合流到同一位"这类错误,只测端点抓不到。
**状态**:待台架验证。
### 5.2 开出:逐路验证继电器动作
**目的**:确认"置哪一位,动的是哪一路继电器",以及上电时确实全释放。
1. **上电瞬间**:听/看 4 路继电器,**都不应有吸合动作**。判据:全部处于释放态。
2. 用万用表(通断档或电阻档)接在某一路继电器的**触点两端**,先确认释放态读数是常开(断路)或常闭(导通),记下来。
3. 只置 **bit0**(mask = 0x01),观察:该路继电器**有吸合声**、触点状态翻转;**其余 3 路不动**。
4. 逐位重复:mask = 0x02 / 0x04 / 0x08,确认每一路都只对应一个 bit。
5. 写 **全 1**(mask = 0x0F),确认 4 路**同时**吸合——这一步是「4 路开出分属两个端口」那条限制的现场确认。
6. 最后写 mask = 0x00,确认 4 路全部回到释放态。
**注意极性**:软件 mask 的 1 = 吸合,与硬件电平的高低无关,由驱动内部转换。若发现"写 1 反而不吸合",改 `Drivers/BSP/IOBOARD/ioboard.h` 的 `IOBOARD_DO_LEVEL_ACTIVE` 这一个宏即可,**不要在上层逐路取反**。判断当前极性是否正确的快捷办法:调 `ioboard_do_read_level()` 读实际引脚电平,再和 `ioboard_do_get()` 的影子寄存器对照——两者对不上说明有人在驱动之外动过这 4 根脚。
**状态**:待台架验证。
### 5.3 时序:有示波器时看什么
**目的**:在读数不对但又查不出接线问题时,用波形判断是不是时序错位。
探头接三根线:**PC2(`SH/LD`)、PC3(CLK)、PE3(数据)**,触发源设在 PC2 的下降沿。期望看到的波形顺序:
| 阶段 | `SH/LD`(PC2) | `CLK`(PC3) | PE3(数据) |
|---|---|---|---|
| 静止 | 高 | 低 | 不定(上一轮的残留) |
| 装载 | **低脉冲**(宽度微秒级量级,远大于手册要求的十几纳秒) | **保持低** | 装载完成时立即变成通道 H 的电平 |
| 移位 | 高 | **8 个脉冲**,周期为微秒级(约百 kHz 量级) | 每个脉冲上升沿之后更新 |
| 结束 | 高 | 低 | 不定 |
**关键判据**:装载期间(`SH/LD` 为低的那段时间)**CLK 必须一直是低**。若看到装载脉冲期间 CLK 还有跳变,说明"先拉低 CLK"这一步没做到,读出的数据一定错位。
**状态**:待台架验证。表中"微秒级""约百 kHz"为量级描述,精确值以驱动里的延时宏为准:时钟高/低各 `IOBOARD_HC165_CLK_PHASE_US`(1 µs),所以一位周期约 2 µs 再叠加采样等待,整个 8 位读一遍约 26 µs(`IOBOARD_DI_READ_MAX_US`)。
### 5.4 无示波器时的替代判据
没有示波器时,用**图案循环法**判断时序与位序:
1. 准备三种输入图案:**全低**、**全高**、**单路 A 动作**。
2. 在全低 → 全高 → 单路 A → 全低之间循环至少 5 轮,每轮之间稳定 2 秒。
3. **判据**:
- 三种图案的读数分别是 `0x00`、`0xFF`、`0x01`(以 A 在 bit0 为前提);
- 同类图案在每一轮的读数**完全相同**(说明没有随机错位);
- 切换过程中**不会出现多个 bit 同时跳变**。
若出现"某一路跳变时相邻路也跟着跳",或"同一图案两次读数不同",优先怀疑:装载期间 CLK 不是低(时序)、或 PE3 接触不良(接线)。
**这个方法的边界要记住**:全 0 与全 1 对位序**完全不敏感**——反序、移位、串位在这两个图案下读数都一样。所以图案循环法只能证明"线通、读得到、不随机",**不能证明位序对**。要证明位序,必须回到「时序原理」一节的单比特与混合算例,以及「开入:逐路验证通道对应关系」一节的逐路核对。
**状态**:待台架验证。
---
## 6. 已知限制与后续
**读这一节是为了知道哪些是"现在就这样、别白费力气去查"的限制,以及将来要补的时候该从哪里下手。**
### 6.1 第二块 74HC165 读不到(硬件限制)
**现象**:设计 16 路开入,实际只有 8 路可用。
**根因**:第二块芯片的 QH 输出线在板上没有连到 MCU,MCU 侧只有 PE3 一路串行数据输入。两块芯片共用 CLK(PC3) 与 `SH/LD`(PC2),时钟会把两块同时往前推,但只有第一块的结果能被读到。
**两条修法**:
| 修法 | 做法 | 代价 |
|---|---|---|
| 飞线(验证阶段可用) | 把第二块的 QH 飞线接到 MCU 的一个空闲 GPIO,并把级联顺序改为"第一块 QH → 第二块串行输入、第二块 QH → MCU"——**顺序要对**,否则两块数据依然串不起来 | 一根线 + 软件改动;不美观、不适合交付 |
| 改板(正式修法) | 在下一版硬件上补这根走线,按级联正确顺序接 | 需改版 |
**改好后的软件适配点**(这里只定位,不写实现):位序组装在 `Drivers/BSP/IOBOARD/ioboard_bits.c` 的 `ioboard_di_assemble()`——级联后一次要读 16 个比特、把 `IOBOARD_DI_COUNT` 改成 16 并按「最后一块的数据在低 8 位、第一块在高 8 位」重新映射;时序层在 `Drivers/BSP/IOBOARD/ioboard.c` 的 `ioboard_di_shift()` 里把循环次数跟着 `IOBOARD_DI_COUNT` 走,并把新增的数据 GPIO 纳入同一个临界区与同一次静止态确认。
### 6.2 4 路开出分属两个端口(同步性限制)
4 路开出里 PC14 在 GPIOC、PF0/PF1/PF6 在 GPIOF,所以要写两次 `BSRR`(每个端口各一次)。两次写之间相隔几条指令(约 10 ns 量级),业务层面不可观测;但如果将来对 4 路的**严格同时性**有要求,得在硬件上把这 4 路挪到同一个端口,软件侧无法再压缩。
### 6.3 继电器动作语义属业务层,本文档不定义
4 路开出分别对应"跳闸""告警""闭锁"还是别的含义,**不在本文档定义**。这是保护逻辑层的职责,去向:
- 保护判据与动作逻辑 → `docs/算法/采集与算法层设计说明.md`、`docs/算法/继电保护功能复现规划.md`
- 104 规约的遥信/遥控点表 → `docs/子系统设计/IEC104上行设计说明.md`
在业务层把这些定义清楚之前,**4 路开出只能用于台架验证,不得用于真实跳闸**。
### 6.4 保护判据未标定闭锁(承重限制)
保护判据目前处于**未标定闭锁**态:`adc_cal_prot_blocked()` 要求 UA/UN/IA 三路有效值齐备,而 UN 通道在本台架永久无数据(台架无接线),因此保护永久闭锁、不允许伪造有效值。详见仓库根 `AGENTS.md`「项目概况」。
这意味着:**即使开出通道完全可用,也没有任何保护逻辑会去驱动它**——这是设计上的安全状态,不是缺陷。解除条件见 [`硬件规格与能力边界.md`](../架构设计/硬件规格与能力边界.md) 的 H3 行。
### 6.5 尚未接入的部分
| 未接入项 | 现状 | 去向 |
|---|---|---|
| 开入去抖 | 未实现 | 业务层接线任务,落点在 `App/task/default_task.c` |
| 开入 → 104 遥信点表 | 未接入 | `docs/子系统设计/IEC104上行设计说明.md` |
| UI 遥信配置页(遥信类型/防抖/双点遥信) | 三叶未绑,原因是**缺数据源**而非缺硬件 | `docs/UI设计/页面补齐规划.md` |
---
## 附录:术语表
| 术语 | 含义 |
|---|---|
| 开入(DI) | 数字输入:读外部触点的通断状态 |
| 开出(DO) | 数字输出:驱动继电器等执行元件 |
| 74HC165 | 8 位并行输入、串行输出的移位寄存器芯片,用 3 根线读出 8 个开关量 |
| `SH/LD` | 74HC165 的移位/装载控制脚:低 = 装载,高 = 移位 |
| QH | 74HC165 的串行输出脚,一次输出一位 |
| LSB | 最低有效位(Least Significant Bit),本文指 mask 的 bit0 |
| 掩码 / mask | 一个整数的各位分别代表一路通道的状态 |
| 光耦 | 把 MCU 侧弱电与继电器侧强电隔开的光电隔离器件 |
| 遥信 | 电力系统术语,指把现场开关状态(位置、告警等)上送给主站 |
| SOE | 事件顺序记录(Sequence of Events),带毫秒级时间戳的变位记录 |
| BSP | 板级支持包,本文指只做引脚与时序、不含业务判断的驱动层 |
| 级联 | 多片移位寄存器首尾相接,扩展成更多位 |
| 去抖 | 消除机械触点抖动造成的重复变位 |
| 双射 | 一一对应:8 个输入位置恰好对应 8 个互不相同的输出位,既不重复也不遗漏 |
| BSRR | STM32 的"位设置/复位寄存器",一次写入即可原子地把若干位置 1 或清 0 |
| 临界区 | 一段禁止中断打断的代码区间,用来保证时序或数据不被并发改写 |
@@ -39,7 +39,7 @@
| 采样硬件 | 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` **已实现真实消费者(ADC 采集链路,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) |
| 已知硬件缺陷 | `docs/任务规划/登记簿.md` §1:8 路电气量分属两片转换器 → V0.1 上禁止跨转换器做相位/功率/矢量运算 |
| 已知硬件缺陷 | `docs/任务规划/硬件改版登记.md` §1:8 路电气量分属两片转换器 → V0.1 上禁止跨转换器做相位/功率/矢量运算 |
### 1.3 复现范围界定
@@ -138,7 +138,7 @@
| # | 约束 | 出处 | 后果 |
| --- | --- | --- | --- |
| 双转换器无共同采样触发 | 8 路电气量分属 TPAFE5160 与 STM32 ADC1 **两片**,两片**无共同采样触发** | `ADC通道映射说明.md` §1、`docs/任务规划/登记簿.md` §1 | 跨转换器的相位 / 矢量 / 功率 / 功率因数 / 负序运算**不成立** |
| 双转换器无共同采样触发 | 8 路电气量分属 TPAFE5160 与 STM32 ADC1 **两片**,两片**无共同采样触发** | `ADC通道映射说明.md` §1、`docs/任务规划/硬件改版登记.md` §1 | 跨转换器的相位 / 矢量 / 功率 / 功率因数 / 负序运算**不成立** |
| R5 | STM32 侧**无中点偏置**(1k 串联 + 1k 到 `*_GND`),0~3.3 V 单极性 | `ADC通道映射说明.md` §1、§7 | STM32 侧交流量负半周**削顶** → 该侧**算不出有效值 / 相量** |
**(2)净效果:V0.1 只有 TPAFE 三路"测量有效"**
@@ -426,7 +426,7 @@
| --- | --- | --- | --- |
| AD 器件 | 专用同步采样 AD | TPAFE5160(16 位、8 通道同步、±5 V)+ STM32 ADC1(12 位、顺序、0~3.3 V) | 统一到"工程量"层,屏蔽码值差异 |
| 通道数 | 8 实通道(4U+4I,自产零序) | 8 路电气量(4U+4I)+ 温度 | 语义映射见 `docs/硬件平台/ADC通道映射说明.md` |
| 同一时刻性 | 单芯片同步 | **跨转换器无共同触发**(`docs/任务规划/登记簿.md` §1) | V0.1 只做逐通道独立监视 |
| 同一时刻性 | 单芯片同步 | **跨转换器无共同触发**(`docs/任务规划/硬件改版登记.md` §1) | V0.1 只做逐通道独立监视 |
| 量程/精度 | 一致 | TPAFE LSB ≈ 152.6 µV vs STM32 LSB ≈ 806 µV | 同族量不可统一算法处理 |
### 6.2 双转换器无共同采样触发:影响与降级口径