docs: sync 6 new KO pin macros from CubeMX regen into ioboard doc

CubeMX regen on 2026-11-18 added six GPIO_Output macros (KO5=PC15,
KO4=PF5, KO_LED1=PF2, KO_LED2=PF3, KO_LED3=PE6, KO_24V=PF4) to
Inc/main.h and Src/gpio.c. The BSP driver has not taken them over:
IOBOARD_DO_COUNT is still 4 and ioboard_do_write() keeps only the
low 4 mask bits, so the drivable DO count is unchanged.

Docs:
- 开入开出实施说明.md: rebuild the §2.1 pin table with exact macro
  names and port macros (fixes the nonexistent KO6_24V, adds KO5 and
  KO4), mark driver takeover per pin, add §2.1.1 change log, state
  the backup-domain +-3mA / 2MHz limit on PC14/PC15, and describe
  KO_24V as the coil supply that must be set before any relay closes.
  The destination column says "not in netlist / pending HW confirm"
  because V0.1.tel has no such net names.
- 待处理疑问.md: append one open question on where these six pins go,
  whether to plan for 10 DO channels, and how to handle the PC15
  backup-domain current limit.
This commit is contained in:
2026-11-18 11:57:46 +08:00
parent df92e826bb
commit 795ce970a2
2 changed files with 92 additions and 18 deletions
+15
View File
@@ -0,0 +1,15 @@
* IEC104 协议,增加了很多 netsocket 函数,这些函数是必须要有的嘛?是通用的网络函数嘛?这些函数不能通过已经有的 netsocket 中的函数得到嘛?增加的函数别的地方也调用嘛?如果别的地方不用,为什么非要单独增加到公共的网络协议栈中呢?
* 对任务分工角色,增加 测试驱动的编程思想,要是增加内容,先写对应的单元测试代码,然后再实现。或者同时进行。
* 我觉得时间同步任务,IEC104协议任务,还有保护任务都可以放到同一个freeRTOS 线程中。这样可以节约内存。而且他们的任务放在一起也没有什么问题,这些都不是什么基础设施。
* 单元测试文件,我见增加了假netsocket,我们有好多网络测试,能不能统一出来大家共用的假网络测试底层,而不是每个模型创建各自的。
* 为了提交代码,IEC 进入了代码规划豁免,仔细查看豁免的内容,能不豁免的就不要豁免
* 板端 104 连不上的真因已钉死:App/sync/time_sntp.c 的静态 s_ctx.fd 零初始化是 0(不是 -1),而 s_socket_close() 判据是 if (s_ctx.fd >= 0)。如何系统性的解决这个问题,而不是遇见一个修一个。
* 把临时的探针,测试IEC104协议正确性的脚本都保存下来,有组织的进行存储和管理。下次可以重复利用测试。
* 2026-11-18 CubeMX 新增的 6 根开出脚(PC15=`KO5`、PF5=`KO4`、PF2=`KO_LED1`、PF3=`KO_LED2`、PE6=`KO_LED3`、PF4=`KO_24V`)现在只有宏和初始化、驱动没接管,有三件事要确认:①这 6 脚真实接到哪里——`docs/硬件平台/V0.1.tel` 里查不到这些网络名,网表分析报告显示它们在 V0.1 上是 U18 桥 A 侧的悬空线;②是否打算按 10 路开出规划(若按 10 路,驱动要从 `IOBOARD_DO_COUNT`=4 扩到 10、mask 位宽跟着改);③PC15 在备份域、限 ±3 mA,若当真开出用是外接三极管驱动还是换脚。(同步记录见 `docs/硬件平台/开入开出实施说明.md` §2.1)
+77 -18
View File
@@ -1,10 +1,10 @@
# 开入开出板实施说明 # 开入开出板实施说明
> **文档定位**:V0.1 主板「开入开出板」的**实施口径**——硬件接线、时序原理、软件分层与接口、上板验证步骤、已知限制。 > **文档定位**:V0.1 主板「开入开出板」的**实施口径**——硬件接线、时序原理、软件分层与接口、上板验证步骤、已知限制。
> **一句话结论**:板上**能读 8 路开入、能控 4 路开出**;第二块 74HC165 的数据输出线在板上没接到 MCU,所以**开入是 8 路而不是设计的 16 路**。 > **一句话结论**:板上**能读 8 路开入、能控 4 路开出**;第二块 74HC165 的数据输出线在板上没接到 MCU,所以**开入是 8 路而不是设计的 16 路**。2026-11-18 的 CubeMX 重生成另外定义了 6 个开出引脚(PC15/PE6/PF2/PF3/PF4/PF5),**但驱动没有接管这 6 脚**,它们不在 `ioboard_do_write()` 的 4 位 mask 内——**可驱动的开出仍是 4 路**。
> **相关文档**:引脚总表与能力边界 [`硬件规格与能力边界.md`](../架构设计/硬件规格与能力边界.md); > **相关文档**:引脚总表与能力边界 [`硬件规格与能力边界.md`](../架构设计/硬件规格与能力边界.md);
> 硬件缺陷登记 [`硬件改版登记.md`](../任务规划/硬件改版登记.md);V0.1 网表逐脚核对的出处 [`V0.1_网表详细分析报告.md`](V0.1_网表详细分析报告.md)。 > 硬件缺陷登记 [`硬件改版登记.md`](../任务规划/硬件改版登记.md);V0.1 网表逐脚核对的出处 [`V0.1_网表详细分析报告.md`](V0.1_网表详细分析报告.md)。
> **版本**:v1.1 **日期**:2026-11-16 > **版本**:v1.2 **日期**:2026-11-18(本次:同步 CubeMX 新增的 6 个开出引脚宏,其中 PC14/PC15 在备份域)
--- ---
@@ -23,8 +23,8 @@
| 层次 | 状态 | 依据 | | 层次 | 状态 | 依据 |
|---|---|---| |---|---|---|
| **硬件** | ✅ 已具备 | 4 路光耦继电器出口 + 74HC165 开入回路在板上实装;引脚已由 CubeMX 配好并重生成(`Inc/main.h` 有宏、`Src/gpio.c` 的 `MX_GPIO_Init` 有初值) | | **硬件** | ✅ 已具备 | 4 路光耦继电器出口 + 74HC165 开入回路在板上实装;引脚已由 CubeMX 配好并重生成(`Inc/main.h` 有宏、`Src/gpio.c` 的 `MX_GPIO_Init` 有初值)。2026-11-18 重生成另外定义了 6 个开出引脚宏,见「MCU 侧引脚表」的注释 |
| **驱动(BSP 硬件抽象层)** | ✅ 已实现 | `Drivers/BSP/IOBOARD/` 下的纯逻辑层与 GPIO/时序层,只做引脚操作与位序组装,见本文「软件结构」一节 | | **驱动(BSP 硬件抽象层)** | ✅ 已实现(**只覆盖 4 路开出**) | `Drivers/BSP/IOBOARD/` 下的纯逻辑层与 GPIO/时序层,只做引脚操作与位序组装,见本文「软件结构」一节;`IOBOARD_DO_COUNT` 仍为 4,新增的 6 脚不在驱动映射表里 |
| **业务层** | ❌ 未接入 | 保护判据仍处**未标定闭锁**态;104 规约的遥信点表未接开入;继电器动作语义(哪路是跳闸、哪路是告警、哪路是闭锁)**尚未定义** | | **业务层** | ❌ 未接入 | 保护判据仍处**未标定闭锁**态;104 规约的遥信点表未接开入;继电器动作语义(哪路是跳闸、哪路是告警、哪路是闭锁)**尚未定义** |
**因此当前能做的**:用调试口读回 8 路开入的真实状态、单独驱动某一路继电器观察动作。 **因此当前能做的**:用调试口读回 8 路开入的真实状态、单独驱动某一路继电器观察动作。
@@ -44,19 +44,69 @@
### 2.1 MCU 侧引脚表 ### 2.1 MCU 侧引脚表
| 引脚 | `Inc/main.h` 宏名 | 方向 | CubeMX 初值 | 接到哪里 | **这一节是接线与排查的对照表:每根脚叫什么宏、由谁初始化、初始电平是什么、驱动管不管它。** 表里每一行都对应 `Inc/main.h` 里的一组 `*_Pin` / `*_GPIO_Port` 宏;端口与脚号据 **2026-11-18 CubeMX 重生成**的 `STM32F407-Demo.ioc` 与 `Inc/main.h` 核对,六根新增开出的去向需硬件确认(见本节末的说明)。
|---|---|---|---|---|
| PC2 | `HC165_LD_Pin` | 推挽输出 | 高(移位态) | 两块 74HC165 的 `SH/LD`(装载脚),并联 | | 引脚 | `Inc/main.h` 宏名 | 方向 | CubeMX 初值 | 驱动是否接管 | 接到哪里 |
| PC3 | `HC165_CLK_Pin` | 推挽输出 | 低 | 两块 74HC165 的 CLK,并联 | |---|---|---|---|---|---|
| PE3 | `HC165_IN2_Pin` | 输入(无上下拉) | — | 第一块 74HC165 的 QH(串行输出) | | PC2 | `HC165_LD_Pin` | 推挽输出 | 高(移位态) | 是(`ioboard_di_shift()`) | 两块 74HC165 的 `SH/LD`(装载脚),并联 |
| PC14 | `KO6_Pin` | 推挽输出 | 见「开出极性」 | 光耦 → 第 1 路继电器线圈 | | PC3 | `HC165_CLK_Pin` | 推挽输出 | 低 | 是(`ioboard_di_shift()`) | 两块 74HC165 的 CLK,并联 |
| PF0 | `TRIP_LED_Pin` | 推挽输出 | 见「开出极性」 | 光耦 → 第 2 路继电器线圈 | | PE3 | `HC165_IN2_Pin` | 输入(无上下拉) | — | 是(`ioboard_di_read()`) | 第一块 74HC165 的 QH(串行输出) |
| PF1 | `ERT_LED_Pin` | 推挽输出 | 见「开出极性」 | 光耦 → 第 3 路继电器线圈 | | PC14 | `KO6_Pin`(端口宏 `KO6_GPIO_Port` = `GPIOC`) | 推挽输出 | 低(`GPIO_PIN_RESET`,释放) | 是(开出通道 0) | 光耦 → 第 1 路继电器线圈;**本脚在备份域**,限流见本节末 |
| PF6 | `CLZ_LED_Pin` | 推挽输出 | 见「开出极性」 | 光耦 → 第 4 路继电器线圈 | | PF0 | `TRIP_LED_Pin`(端口宏 `TRIP_LED_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(释放) | 是(开出通道 1) | 光耦 → 第 2 路继电器线圈 |
| PF4 | `KO6_24V` | 推挽输出 | 见「开出极性」 | 三极管Base极 → 24V继电器线圈 → 1 2 3 4 路继电器线圈供电24V,不然继电器没有电无法吸合| | PF1 | `ERT_LED_Pin`(端口宏 `ERT_LED_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(释放) | 是(开出通道 2) | 光耦 → 第 3 路继电器线圈 |
| PF2 | `KO_LED1` | 推挽输出 | 见「开出极性」 | 光耦 → 外接引脚,光耦导通,拉低电平| | PF6 | `CLZ_LED_Pin`(端口宏 `CLZ_LED_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(释放) | 是(开出通道 3) | 光耦 → 第 4 路继电器线圈 |
| PF3 | `KO_LED2` | 推挽输出 | 见「开出极性」 | 光耦 → 外接引脚,光耦导通,拉低电平| | PC15 | `KO5_Pin`(端口宏 `KO5_GPIO_Port` = `GPIOC`) | 推挽输出 | 低(`GPIO_PIN_RESET`) | **否** | 网表未标 / 待硬件确认;**本脚在备份域**,限流见本节末 |
| PE6 | `KO_LED3` | 推挽输出 | 见「开出极性」 | 光耦 → 外接引脚,光耦导通,拉低电平| | PE6 | `KO_LED3_Pin`(端口宏 `KO_LED3_GPIO_Port` = `GPIOE`) | 推挽输出 | 低 | **否** | 网表未标 / 待硬件确认 |
| PF2 | `KO_LED1_Pin`(端口宏 `KO_LED1_GPIO_Port` = `GPIOF`) | 推挽输出 | 低 | **否** | 网表未标 / 待硬件确认 |
| PF3 | `KO_LED2_Pin`(端口宏 `KO_LED2_GPIO_Port` = `GPIOF`) | 推挽输出 | 低 | **否** | 网表未标 / 待硬件确认 |
| PF4 | `KO_24V_Pin`(端口宏 `KO_24V_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(`GPIO_PIN_RESET`,即**继电器线圈无电**) | **否** | 网表未标 / 待硬件确认;用途见下方「`KO_24V` 与继电器线圈供电」 |
| PF5 | `KO4_Pin`(端口宏 `KO4_GPIO_Port` = `GPIOF`) | 推挽输出 | 低 | **否** | 网表未标 / 待硬件确认 |
**表怎么看**:「驱动是否接管」一列是这一节最要紧的信息。`Drivers/BSP/IOBOARD/ioboard.c` 里只定义 `IOBOARD_DO_CH_GPIO_0..3_*` 四组端口/脚号映射(分别指向 PC14、PF0、PF1、PF6),`IOBOARD_DO_COUNT`(定义在 `Drivers/BSP/IOBOARD/ioboard_bits.h`)仍为 4;`ioboard_do_write()` 的 mask 只有 bit0~bit3 四位。表里标「**否**」的 6 根脚,是 CubeMX 侧已定义宏、`Src/gpio.c` 的 `MX_GPIO_Init` 已把它们配成推挽输出并赋低电平初值,**但 BSP 驱动既不会去写它们,也不会读回它们**——它们不是「已实现的第 5~10 路开出」。
**这 6 根脚目前的状态,一句话说清**:
- **已做**:CubeMX 定义了宏(`Inc/main.h`),生成了推挽输出 + 无上下拉 + 低速的初始化,初值一律 `GPIO_PIN_RESET`;
- **未做**:没有进 `ioboard_do_write()` 的 4 位 mask、没有进 `ioboard_do_get()` / `ioboard_do_read_level()` 的影子与回读逻辑,也没有纳入 `ioboard_init()` 的静止态确认;
- **因此在接入驱动之前,任何业务代码都不应直接对这几根脚 `HAL_GPIO_WritePin`**——绕过驱动写引脚会让影子寄存器与实际电平脱节,`ioboard_do_read_level()` 的极性核对就失去意义。
**`KO_24V` 与继电器线圈供电**:按命名,`KO_24V`(PF4)应是 4 路继电器线圈的 **24 V 供电使能**——**线圈没有 24 V 就不会吸合**,所以任何使某路继电器吸合的动作,都必须**先**把 `KO_24V` 置为有效电平、再写对应开出路。上电时 CubeMX 把它初始化为低电平,即**默认线圈无电、不会误吸合**,这与 §4.4「上电默认态」的安全目标一致。但要注意三条边界:
1. PF4 的实际走线在现有网表里查不到网络名(见下段),「24 V 使能」目前只是**引脚命名与用户口述**的口径,未经网表或台架证实;
2. 驱动没有接管 PF4,`ioboard_do_write()` 也**不会**自动置它——将来把开出扩到更多路时,必须把「先给线圈供电、再吸合」的顺序写进驱动,不能留给上层每处自己记得;
3. 由于驱动不碰 PF4,目前它始终保持上电初值(低),所以**即使有人手工驱动了某一根开出脚,继电器也不会吸合**——这是当前状态的安全侧。
**为什么这 6 根脚的「接到哪里」不能写成光耦或继电器**:`docs/硬件平台/V0.1_网表详细分析报告.md` §4.5 显示,V0.1 板上 PE6、PC15、PF4、PF5(以及 PC14、PF0、PF1、PF6、PC2、PC3)都是 U18 桥 A 侧的 11 根悬空线(V15/J3/F3/H16/R16/K3/DQM0/WAIT1/DQM1/RAS/SDCKE),`docs/硬件平台/V0.1.tel` 里也查不到 `KO_24V` / `KO4` / `KO5` / `KO_LED1~3` 这些网络名。也就是说:**新引脚真实接去哪里,现有网表没有依据**,本表只能写「待硬件确认」,不许按命名猜成光耦或继电器路数。待用户确认的问题已登记在 `docs/任务规划/待处理疑问.md`。
**PC14 与 PC15 在备份域(硬限制)**:这两根脚由备份域电源开关供电,STM32F407 数据手册(本仓存档 `docs/芯片手册/stm32f405rg.md`)规定 PC13~PC15 **灌流或拉流都不超过 ±3 mA,输出模式下速度不超过 2 MHz、负载不超过 30 pF**;网表报告的 V8 行把这条记为「不可当电流源」。因此:
- 它们**不能**直接驱动光耦或继电器的线圈电流,只能作为控制信号去带外部三极管/MOS 管;
- CubeMX 给这两根脚配的是普通推挽输出、无上下拉、低速(`GPIO_SPEED_FREQ_LOW`)——速度约束满足,但**电流约束 CubeMX 管不了,要由外部电路保证**;
- 对 PC14(`KO6_Pin`,第 1 路继电器)来说,这条限制**已经存在**:驱动把它当普通推挽输出写,一旦光耦输入侧的负载超过 ±3 mA,出口可靠性就没有保证;
- 对 PC15(`KO5_Pin`)来说,这是它**能不能当开出用**的前提条件——接线与选型确认之前不要把它规划成一路继电器出口。
### 2.1.1 本次同步的变更记录与未完成项
**读这一小节是为了分清「哪些已由 CubeMX 落地、哪些还欠驱动」**,免得把引脚定义当成功能完成。
2026-11-18 的 CubeMX 重生成相对上一版**新增了 6 组宏**,全部为 `GPIO_Output` + `Locked=true`(锁定,防止后续重生成被改回默认网络):
| 宏名 | 端口宏 | 脚 |
|---|---|---|
| `KO5_Pin` | `KO5_GPIO_Port` = `GPIOC` | PC15 |
| `KO4_Pin` | `KO4_GPIO_Port` = `GPIOF` | PF5 |
| `KO_LED1_Pin` | `KO_LED1_GPIO_Port` = `GPIOF` | PF2 |
| `KO_LED2_Pin` | `KO_LED2_GPIO_Port` = `GPIOF` | PF3 |
| `KO_LED3_Pin` | `KO_LED3_GPIO_Port` = `GPIOE` | PE6 |
| `KO_24V_Pin` | `KO_24V_GPIO_Port` = `GPIOF` | PF4 |
**未完成项**(不在本次同步范围内,留给后续任务):
| 未完成项 | 现状 | 缺口 |
|---|---|---|
| 6 根新脚纳入 BSP 驱动 | `ioboard.c` 的 `IOBOARD_DO_CH_GPIO_0..3_*` 仍只有 4 路,`IOBOARD_DO_COUNT` = 4 | 需先由硬件确认去向与驱动级(是否经光耦/三极管),再扩 `IOBOARD_DO_COUNT`、扩展 mask 位数、把 PC15 的 3 mA 约束写进驱动注释 |
| PC15 备份域限流 | CubeMX 已按普通推挽输出配置 | 硬件选型确认前不能规划为继电器出口 |
| `KO_24V` 供电时序 | 仅引脚定义存在 | 驱动接管后需保证「先供电后吸合」 |
### 2.2 74HC165 侧:两块芯片共用两根控制线,数据线只有一根 ### 2.2 74HC165 侧:两块芯片共用两根控制线,数据线只有一根
@@ -206,7 +256,7 @@
| `ioboard_init()` | 初始化:确认静止态、把 4 路开出置为全释放、清影子寄存器 | 无。返回 `BSP_ERR_STATE` 表示静止态确认失败(引脚被别人动过) | | `ioboard_init()` | 初始化:确认静止态、把 4 路开出置为全释放、清影子寄存器 | 无。返回 `BSP_ERR_STATE` 表示静止态确认失败(引脚被别人动过) |
| `ioboard_di_read(uint8_t *out_mask)` | 读一次 8 路开入(完整装载 — 8 拍移位 — 到位序反转) | `out_mask` 输出 bit0 = 通道 A … bit7 = 通道 H。任意上下文可调,内部自动选临界区 | | `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_di_read_from_isr(uint8_t *out_mask)` | 同上,专供中断上下文 | 语义相同,临界区换成中断版本 |
| `ioboard_do_write(uint8_t mask)` | 写一次 4 路开出 | mask 的 bit0 到 bit3 分别对应 4 路;**1 = 继电器吸合**,与硬件电平高低无关 | | `ioboard_do_write(uint8_t mask)` | 写一次 4 路开出 | mask 的 bit0 到 bit3 分别对应 4 路;**1 = 继电器吸合**,与硬件电平高低无关。高 4 位会被静默丢弃(函数体内 `mask & IOBOARD_DO_MASK_ALL` 只留低 4 位),即 **bit4 及以上写什么都不会作用到任何引脚**——2026-11-18 新增的 6 根开出脚(PC15/PE6/PF2/PF3/PF4/PF5)不在这个 mask 里 |
| `ioboard_do_get(uint8_t *out_mask)` | 取软件影子寄存器里的当前开出 mask | 读的是驱动认为的状态,不读引脚 | | `ioboard_do_get(uint8_t *out_mask)` | 取软件影子寄存器里的当前开出 mask | 读的是驱动认为的状态,不读引脚 |
| `ioboard_do_read_level(uint8_t *out_level)` | 直接读 4 根开出引脚的**实际电平** | 用于极性核对:与 `ioboard_do_get()` 对不上,说明有人在驱动之外动过这 4 根脚 | | `ioboard_do_read_level(uint8_t *out_level)` | 直接读 4 根开出引脚的**实际电平** | 用于极性核对:与 `ioboard_do_get()` 对不上,说明有人在驱动之外动过这 4 根脚 |
@@ -226,6 +276,8 @@
但要注意**从上电到 `ioboard_init()` 执行之间**有一段窗口,这期间引脚电平由 CubeMX 生成的初值决定(见「硬件接线」的引脚表),驱动管不到。因此上板验证时**务必观察上电瞬间有没有误吸合**,这是「开出:逐路验证继电器动作」一节的第一条。 但要注意**从上电到 `ioboard_init()` 执行之间**有一段窗口,这期间引脚电平由 CubeMX 生成的初值决定(见「硬件接线」的引脚表),驱动管不到。因此上板验证时**务必观察上电瞬间有没有误吸合**,这是「开出:逐路验证继电器动作」一节的第一条。
2026-11-18 新增的 6 根开出脚**不在 `ioboard_init()` 的静止态确认与全释放范围内**:它们的电平从复位起就由 `Src/gpio.c` 的 `MX_GPIO_Init` 写死的低电平决定,驱动既不清也不查。`KO_24V`(PF4)因此在整机运行期间始终为低,按「24 V 线圈供电使能」的口径即**线圈无电**,继电器不会吸合。
### 4.5 时序实现要点 ### 4.5 时序实现要点
驱动里所有延时都是用**忙等计数**实现的(按 168 MHz 主频换算的循环次数),不是硬件定时器。这样做换来的是时序最短、最可预期,代价是这几微秒内 CPU 被独占。 驱动里所有延时都是用**忙等计数**实现的(按 168 MHz 主频换算的循环次数),不是硬件定时器。这样做换来的是时序最短、最可预期,代价是这几微秒内 CPU 被独占。
@@ -273,6 +325,8 @@
5. 写 **全 1**(mask = 0x0F),确认 4 路**同时**吸合——这一步是「4 路开出分属两个端口」那条限制的现场确认。 5. 写 **全 1**(mask = 0x0F),确认 4 路**同时**吸合——这一步是「4 路开出分属两个端口」那条限制的现场确认。
6. 最后写 mask = 0x00,确认 4 路全部回到释放态。 6. 最后写 mask = 0x00,确认 4 路全部回到释放态。
**注意:本轮只验 4 路,别顺手去点新加的那 6 根脚。** 2026-11-18 新增的 PC15/PE6/PF2/PF3/PF4/PF5 虽然已由 CubeMX 配成推挽输出,但去向在网表里查不到(§2.1),PC15 还受备份域 ±3 mA 限制。要单独观察其中某根脚的电平,只允许用调试器或万用表**读**;**不要**在业务代码里 `HAL_GPIO_WritePin` 写它们——绕开驱动写引脚会让 `ioboard_do_get()` 的影子寄存器与实际电平脱节。将来给 `KO_24V` 通电做继电器测试时,必须**先**置 PF4 使线圈有 24 V、再写开出路,顺序反了只会看到「写了但不吸合」。
**注意极性**:软件 mask 的 1 = 吸合,与硬件电平的高低无关,由驱动内部转换。若发现"写 1 反而不吸合",改 `Drivers/BSP/IOBOARD/ioboard.h` 的 `IOBOARD_DO_LEVEL_ACTIVE` 这一个宏即可,**不要在上层逐路取反**。判断当前极性是否正确的快捷办法:调 `ioboard_do_read_level()` 读实际引脚电平,再和 `ioboard_do_get()` 的影子寄存器对照——两者对不上说明有人在驱动之外动过这 4 根脚。 **注意极性**:软件 mask 的 1 = 吸合,与硬件电平的高低无关,由驱动内部转换。若发现"写 1 反而不吸合",改 `Drivers/BSP/IOBOARD/ioboard.h` 的 `IOBOARD_DO_LEVEL_ACTIVE` 这一个宏即可,**不要在上层逐路取反**。判断当前极性是否正确的快捷办法:调 `ioboard_do_read_level()` 读实际引脚电平,再和 `ioboard_do_get()` 的影子寄存器对照——两者对不上说明有人在驱动之外动过这 4 根脚。
**状态**:待台架验证。 **状态**:待台架验证。
@@ -336,6 +390,8 @@
4 路开出里 PC14 在 GPIOC、PF0/PF1/PF6 在 GPIOF,所以要写两次 `BSRR`(每个端口各一次)。两次写之间相隔几条指令(约 10 ns 量级),业务层面不可观测;但如果将来对 4 路的**严格同时性**有要求,得在硬件上把这 4 路挪到同一个端口,软件侧无法再压缩。 4 路开出里 PC14 在 GPIOC、PF0/PF1/PF6 在 GPIOF,所以要写两次 `BSRR`(每个端口各一次)。两次写之间相隔几条指令(约 10 ns 量级),业务层面不可观测;但如果将来对 4 路的**严格同时性**有要求,得在硬件上把这 4 路挪到同一个端口,软件侧无法再压缩。
**2026-11-18 之后这条限制的口径**:`IOBOARD_DO_COUNT` 仍是 4,驱动只写 4 路,所以「两个端口」的结论不变。新增的 6 根开出脚分布在三个端口(PC15 在 GPIOC;PE6 在 GPIOE;PF2/PF3/PF4/PF5 在 GPIOF),**将来**若把它们接进驱动、扩到更多路继电器出口,端口数会从 2 增到 3,每次写 mask 最多要写三次 `BSRR`,同步性限制会在原有基础上再变差——扩路之前要把这一点算进设计,而不是等台架上发现不同时。
### 6.3 继电器动作语义属业务层,本文档不定义 ### 6.3 继电器动作语义属业务层,本文档不定义
4 路开出分别对应"跳闸""告警""闭锁"还是别的含义,**不在本文档定义**。这是保护逻辑层的职责,去向: 4 路开出分别对应"跳闸""告警""闭锁"还是别的含义,**不在本文档定义**。这是保护逻辑层的职责,去向:
@@ -355,6 +411,7 @@
| 未接入项 | 现状 | 去向 | | 未接入项 | 现状 | 去向 |
|---|---|---| |---|---|---|
| 新增 6 根开出脚(PC15/PE6/PF2/PF3/PF4/PF5)接进驱动 | 只有 CubeMX 宏与初始化,BSP 驱动零引用 | 先由硬件确认去向与驱动级,再扩 `IOBOARD_DO_COUNT` 与 mask 位宽,见 §2.1.1 |
| 开入去抖 | 未实现 | 业务层接线任务,落点在 `App/task/default_task.c` | | 开入去抖 | 未实现 | 业务层接线任务,落点在 `App/task/default_task.c` |
| 开入 → 104 遥信点表 | 未接入 | `docs/子系统设计/IEC104上行设计说明.md` | | 开入 → 104 遥信点表 | 未接入 | `docs/子系统设计/IEC104上行设计说明.md` |
| UI 遥信配置页(遥信类型/防抖/双点遥信) | 三叶未绑,原因是**缺数据源**而非缺硬件 | `docs/UI设计/页面补齐规划.md` | | UI 遥信配置页(遥信类型/防抖/双点遥信) | 三叶未绑,原因是**缺数据源**而非缺硬件 | `docs/UI设计/页面补齐规划.md` |
@@ -381,3 +438,5 @@
| 双射 | 一一对应:8 个输入位置恰好对应 8 个互不相同的输出位,既不重复也不遗漏 | | 双射 | 一一对应:8 个输入位置恰好对应 8 个互不相同的输出位,既不重复也不遗漏 |
| BSRR | STM32 的"位设置/复位寄存器",一次写入即可原子地把若干位置 1 或清 0 | | BSRR | STM32 的"位设置/复位寄存器",一次写入即可原子地把若干位置 1 或清 0 |
| 临界区 | 一段禁止中断打断的代码区间,用来保证时序或数据不被并发改写 | | 临界区 | 一段禁止中断打断的代码区间,用来保证时序或数据不被并发改写 |
| 备份域 | STM32 内由备份电源开关供电的一小组引脚(本板为 PC13/PC14/PC15),驱动能力远小于普通 GPIO:拉流/灌流各不超过 ±3 mA,输出速度不超过 2 MHz |
| 影子寄存器 | 驱动里保存「软件认为开出 mask 是什么」的一份副本,`ioboard_do_get()` 读它、不读引脚;绕开驱动写引脚会让它与实际电平不一致 |