feat(ioboard): make KO_24V an auto relay supply enable (9 channels)

KO_24V (PF4, bit6) is not an externally controllable output: it feeds
the other KO channels, so the driver now asserts it automatically
whenever any relay-class channel (bit0/1/2/3/7/8) is attracted, and
never for the three LED channels (bit4/5/9). Externally controllable
outputs become 9; physical bit map, DO_COUNT=10, DO_MASK_ALL=0x03FF,
k_do_pin[] binding, per-port BSRR segments and the uint16_t path are
unchanged.

- ioboard_do_write: clear the caller's bit6, synthesize it from
  IOBOARD_DO_RELAY_MASK (0x18F), then one shadow store + one apply,
  so bit6 changes in the same BSRR write as its GPIOF neighbours.
- ioboard_do_get: bit6 now reports the actual 24V supply state, not
  an echo of the caller's write. Power-on release keeps PF4 low.
- board test Phase 3 derives expectations from RELAY_MASK (no second
  truth table); the KO_24V row exercises "write ignored" and a new
  auto-24V check verifies set-on-relay / drop-on-release.
- host contract test pins RELAY_MASK membership (excludes bit6 and
  LED bits, union fills 0x3FF); 131/131 passed.
- docs: sync note v1.4 + BSP README unify the semantics (9
  controllable + auto supply enable); stale "10 controllable" and
  "24V interlock not implemented" wording removed; netlist-unknown
  routing, PC15 backup-domain 3 mA limit and the missing auxiliary
  contact remain documented as open facts.

Verified: Keil rebuild 0 error 0 warning (sizes identical to parent
wave), host unit tests 131/131, check_bsp_err / check_doc_links /
git diff --check clean. Board Phase 3 still needs a bench run.
This commit is contained in:
2026-11-18 19:34:47 +08:00
parent 74efa671bb
commit 6e0755f971
10 changed files with 302 additions and 90 deletions
+17 -2
View File
@@ -52,6 +52,12 @@
* 与 ioboard_do_get() 输出改 uint16_t,dio_do_mask
* 赋值保留全部 10 位(不再截断到 uint8_t);写侧
* 位宽守卫改成 IOBOARD_DO_COUNT == UI_DATA_DO_N == 10
* 语义订正(同日 2026-11-18,**不改任何数值**):
* KO_24V(bit6) 由「对外可控通道」改为「继电器供电自动
* 使能」——FEED_DO_MASK 仍含 bit6,但透传语义随之从
* 「可控通道的写入回显」变成「当前 24V 供电是否使能」
* (驱动按继电器类通道自动合成,见 ioboard.h 的
* IOBOARD_DO_RELAY_MASK 与 ioboard_do_get 注)
* v1.2 2026-10-26 DTU 项目组 道F task-16:删除本地镜像 feed_cal_block(),
* 两个调用点(填帧 / 门控比较)改调
* adc_cal_prot_blocked()——同一份三路判定此前在
@@ -157,6 +163,12 @@ typedef char feed_chk_di_n_t[(UI_DATA_DI_N == IOBOARD_DI_CH_NUM) ? 1 : -1];
/* 板级开出语义位集合(bit0..bit9,10 路扁平位号,1 = 吸合):
* bit0 KO6 / bit1 TRIP / bit2 ERT / bit3 CLZ(原有四位,位号不变)
* bit4 KO_LED1 / bit5 KO_LED2 / bit6 KO_24V / bit7 KO4 / bit8 KO5 / bit9 KO_LED3
* bit6 KO_24V:这一位透传的是 **KO_24V 供电使能的实际状态**(驱动自动合成,非可控
* 通道写入回显)——2026-11-18 起它不再是对外可控通道,调用方写 ioboard_do_write()
* 的 bit6 被忽略,ioboard_do_get() 的 bit6 由驱动按「继电器类通道有没有任一吸合」
* 自动置/清。所以它**仍然留在本掩码里**:屏上那一格画的是「24V 供电现在通不通」,
* 不是「操作员有没有命令它合」;把它从掩码里剔掉反而会让页面丢掉唯一可见的供电事实。
* 对外可控通道共 9 路(LED 三路 bit4/bit5/bit9 不触发供电,bit6 自身也不受控)。
* 为什么在这一处汇成一个掩码:填帧要用它,位宽守卫也要用它;两处各写一遍等于
* 第二个真相(少写一位,屏上就凭空多出一路"永远释放"的开出) */
#define FEED_DO_MASK ((uint16_t)(IOBOARD_DO_KO6 | IOBOARD_DO_TRIP | \
@@ -420,7 +432,8 @@ static void feed_fill_dio_di(ui_data_rt_t *p_snap) {
}
/*
* 函数功能:填板级 4 路开出(读驱动的软件影子寄存器)
* 函数功能:填板级开出 10 个物理位(读驱动的软件影子寄存器:对外可控 9 路,
* bit6 = KO_24V 供电使能自动状态,见 FEED_DO_MASK 注释)
* 入口参数:p_snap - 目标帧(调用方已清零) ui_data_rt_t *
* 返回值:无
* 限定条件:uiTask 上下文;ioboard_do_get 只读一个 volatile 影子寄存器,
@@ -428,7 +441,9 @@ static void feed_fill_dio_di(ui_data_rt_t *p_snap) {
* 函数说明:mask 覆盖 bit0..bit9(10 路扁平位号),FEED_DO_MASK 与驱动
* IOBOARD_DO_MASK_ALL 编译期等值;uint16_t 影子里这 10 位全部透传,
* 不再截断到低 8 位(bit8 KO5/bit9 KO_LED3 必须保留)。
* ⚠ 这是**软件意图**(上次成功写入的值),不是继电器机械吸合实测;
* ⚠ 这是**软件意图**(上次成功写入的值;bit6 例外——它是驱动自动合成的
* KO_24V 供电使能实际状态,不是调用方的写入回显,见 FEED_DO_MASK 注释),
* 不是继电器机械吸合实测;
* 驱动无辅助触点回读通路(ioboard.h 的 ioboard_do_get 注),页面措辞
* 不得让操作员以为读到了机械反馈。
* 失败只可能是 out_mask 为 NULL(本处传栈上地址,不会发生);仍按
+14 -9
View File
@@ -1,6 +1,6 @@
# 开入开出板 BSP(IOBOARD)
**一句话**:这个驱动让板上的 74HC165 移位寄存器能够被读出 8 路开入,让 10 路板级开出能够被整组写入;它只做引脚与时序,不做任何业务判断。
**一句话**:这个驱动让板上的 74HC165 移位寄存器能够被读出 8 路开入,让 10 路物理开出(其中对外可控 9 路)能够被整组写入;它只做引脚与时序,不做任何业务判断。bit6 KO_24V 是继电器供电使能,由驱动自动管理,不是对外输出。
---
@@ -19,7 +19,7 @@
| 出口 3(CLZ) | PF6 | `CLZ_LED_Pin` | 推挽输出 | RESET | LOW |
| 出口 4(KO_LED1) | PF2 | `KO_LED1_Pin` | 推挽输出 | RESET | LOW |
| 出口 5(KO_LED2) | PF3 | `KO_LED2_Pin` | 推挽输出 | RESET | LOW |
| 出口 6(KO_24V) | PF4 | `KO_24V_Pin` | 推挽输出 | RESET | LOW |
| 供电使能(KO_24V,bit6,自动) | PF4 | `KO_24V_Pin` | 推挽输出 | RESET(上电无继电器吸合 ⇒ 24V 不使能) | LOW |
| 出口 7(KO4) | PF5 | `KO4_Pin` | 推挽输出 | RESET | LOW |
| 出口 8(KO5) | PC15 | `KO5_Pin` | 推挽输出 | RESET | LOW(备份域 ±3 mA,仅信号位) |
| 出口 9(KO_LED3) | PE6 | `KO_LED3_Pin` | 推挽输出 | RESET | LOW |
@@ -135,10 +135,11 @@ ioboard_bits.c ← 纯逻辑:位序组装。只依赖 <stdint.h>,主机侧
| `ioboard_init()` | 清影子、自检引脚模式、确认静止态、10 路全释放 | — |
| `ioboard_di_read(uint8_t *out_mask)` | 一次完整装载 + 8 拍移位;任意上下文 | **bit0 = A … bit7 = H** |
| `ioboard_di_read_from_isr(uint8_t *out_mask)` | 同上,强制 FROM_ISR 临界区 | 同上 |
| `ioboard_do_write(uint16_t mask)` | 整组写 10 路开出(每段 BSRR 原子) | **bit0..bit9,1 = 吸合/有效**;bit10..bit15 忽略 |
| `ioboard_do_get(uint16_t *out_mask)` | 读软件影子寄存器(上次写入值) | 同上 |
| `ioboard_do_write(uint16_t mask)` | 整组写 10 路物理开出(每段 BSRR 原子);**对外可控 9 路**,bit6 由驱动自动合成、写入被忽略 | **bit0..bit9,1 = 吸合/有效**;bit6 = 继电器供电使能(任一继电器类通道吸合 ⇒ 自动拉高,LED 三路不触发);bit10..bit15 忽略 |
| `ioboard_do_get(uint16_t *out_mask)` | 读软件影子寄存器(上次合成值) | 同上;bit6 = KO_24V 供电状态实际值,不是调用方写入回显 |
| `ioboard_do_read_level(uint16_t *out_level)` | 读 10 路引脚**实际输出电平**(调试用) | **bit n = 1 表示引脚高电平**,与吸合语义无关 |
- 继电器类通道 = bit0 KO6 / bit1 TRIP / bit2 ERT / bit3 CLZ / bit7 KO4 / bit8 KO5(合起来即 `IOBOARD_DO_RELAY_MASK`);LED 三路 = bit4 KO_LED1 / bit5 KO_LED2 / bit9 KO_LED3,不触发 24V 使能。合成后的最终 mask 一次 apply 写引脚,无「先写 6 脚再写 PF4」的中间态。
- `ioboard_init()` **不调用 `HAL_GPIO_Init`**:引脚模式/速度/上下拉由 `MX_GPIO_Init()` 唯一负责。
在这里再初始化一遍只会让 CubeMX 显示的引脚状态与真相脱节,下次重生成还会被覆盖。
- 读失败时**不写** `*out_mask`——「读失败」与「读到全 0」必须可区分,判断权留给上层。
@@ -211,9 +212,9 @@ ioboard_bits.c ← 纯逻辑:位序组装。只依赖 <stdint.h>,主机侧
- 若**继电器不动**、引脚电平也变了 → 极性反了,把 `IOBOARD_DO_LEVEL_ACTIVE` 改成 `0U`。
- 若**继电器吸合了但初始化后不释放**(上电就吸合)→ 同样说明极性反了,**立即改宏后重测**,
这属于安全问题,不要带着它继续做其它测试。
3. 逐路验证 bit1..bit9 分别对应 TRIP/ERT/CLZ/KO_LED1/KO_LED2/KO_24V/KO4/KO5/KO_LED3 九路,**每次只有一路动作**。
4. 调 `ioboard_do_write(IOBOARD_DO_MASK_ALL)` 十路全吸合,再 `ioboard_do_write(0x00)` 全释放。
用 `ioboard_do_get()` 回读影子寄存器,应为刚写入的值;与 `ioboard_do_read_level()` 对照,
3. 逐路验证 bit1..bit9 分别对应 TRIP/ERT/CLZ/KO_LED1/KO_LED2/KO_24V/KO4/KO5/KO_LED3 九路物理位(bit6 写入被忽略,见第 4 条)。
4. 继电器类通道(bit0/1/2/3/7/8)点动时,`IOBOARD_DO_KO_24V`(bit6,PF4)自动拉高;写 LED 三路(bit4/5/9)或单独写 bit6 时 PF4 保持 RESET。调 `ioboard_do_write(IOBOARD_DO_MASK_ALL)` 则为 9 路对外可控通道全吸合 + bit6 自动使能(影子回读 `0x03FF`),再 `ioboard_do_write(0x00)` 全释放(影子回读 `0x0000`,PF4 = RESET)。
用 `ioboard_do_get()` 回读影子寄存器,应与合成值一致(bit6 是实际供电状态,不是写入回显);与 `ioboard_do_read_level()` 对照,
若两者不一致 = 有人在驱动之外写了这 10 根引脚的 ODR。
### 第 3 步:有示波器时看时序
@@ -245,8 +246,12 @@ ioboard_bits.c ← 纯逻辑:位序组装。只依赖 <stdint.h>,主机侧
不会出现目标态以外的组合。若将来业务要求 10 路**严格同一时刻**,需要硬件把它们挪到同一端口。
3. **PC15(KO5)备份域限流、仅信号位**:该脚位于备份域,驱动能力 ±3 mA,本驱动只把它当普通信号位,
不用于供电或功率输出。
4. **KO_24V 与继电器供电联锁未实现**:本驱动只按 mask 写引脚,不判断 24V 供电是否已建立;上层若据此控继电器,
须自行保证「先供电后吸合」。
4. **KO_24V(PF4,bit6)的自动使能只到软件合成为止**:这一位不是对外可控通道,而是继电器供电使能,
由驱动按 `ioboard.h` 的 `IOBOARD_DO_RELAY_MASK` 合成——继电器类通道(bit0/1/2/3/7/8)任一吸合即拉高,
全部释放即拉低;调用方写这一位一律被忽略,LED 三路(bit4/5/9)不触发(分类见 §4.2、实测见 §5 第 2 步)。
旧版这一条要求的「上层须自行保证先供电后吸合」随本契约作废:上层既不需要、也无法再自行排这个顺序。
残留的限制是**这一位究竟有没有带电**:板上没有供电回读通路,`ioboard_do_get()` 的 bit6 只给出驱动
合成的那个值,「24V 端子实际带电吗」仍只能上台架用万用表量 —— 成因与手段见第 6 条,此处不重复展开。
5. **极性未经原理图核对**:`IOBOARD_DO_LEVEL_ACTIVE = 1U` 目前只有「用户口径 + 上电初值为 RESET」两条间接依据,
必须按 §5 第 2 步实测确认。
6. **硬件无辅助触点回读**:`ioboard_do_get()` 读的是**软件影子寄存器**(「我上次让它是什么」),
+32 -8
View File
@@ -8,6 +8,9 @@
* 修改记录:
* 2026-11-16 王建锋 创建
* 2026-11-18 王建锋 扩展:新增 6 路普通开出,mask 由 uint8_t 扩到 uint16_t
* 2026-11-18 王建锋 语义修订:KO_24V(bit6) 由对外可控改为继电器供电自动使能,
* ioboard_do_write 忽略调用方 bit6,按 IOBOARD_DO_RELAY_MASK
* 合成;物理 10 路与 k_do_pin[] 绑定不变
*
* 分层约定(为什么这样切):
* ├─ 引脚编号只有一个来源:main.h 的 Label_Pin 宏,在本文件顶部的「引脚绑定」区
@@ -106,7 +109,8 @@ static const ioboard_do_pin_t k_do_pin[IOBOARD_DO_COUNT] =
/* ======================== 内部状态 ======================== */
/*
* 开出影子寄存器:bit0..bit9 = 上一次成功写入的「1 = 吸合」语义。
* 开出影子寄存器:bit0..bit9 = 上一次成功合成并写入的「1 = 吸合」语义;
* bit6 = 继电器供电使能的实际状态(由 IOBOARD_DO_RELAY_MASK 自动算出,非调用方写入值)。
* volatile:同时被任务与可能的 ISR 读,编译器不得把它缓存在寄存器里。
* 不需要锁:本模块只对整半字赋值(单指令原子),从不做「读-改-写」。
*/
@@ -368,7 +372,8 @@ static bsp_err_t ioboard_check_idle(void)
/*
* 函数功能:按给定「1 = 吸合」语义把 10 路开出按端口分段写到引脚上
* 入口参数:relay_mask - 已屏蔽到 bit0..bit9 的吸合意图
* 入口参数:relay_mask - 已屏蔽到 bit0..bit9 的**最终合成**吸合位(bit6 已由
* ioboard_do_write 按继电器类通道自动算出)
* 返回值:无
* 限定条件:任意上下文(每段 BSRR 单次写原子;影子寄存器由调用方维护)
* 函数说明:
@@ -378,9 +383,13 @@ static bsp_err_t ioboard_check_idle(void)
* 二、10 路分属 GPIOC(2 路:bit0、bit8)、GPIOF(7 路:bit1..bit7)、GPIOE(1 路:bit9),
* 按 bit 顺序形成 C→F→C→E 四段,共四次 BSRR 写;每次写内部原子。
* 段与段之间只可能看到「旧态 → 新态」的跃迁,不会出现「目标态以外的组合」。
* bit6(PF4)与前六个 bit 同属 GPIOF 段,自动使能位与继电器通道在同一次 BSRR 写内
* 生效,不会出现「先写 6 脚再写 PF4」的中间态。
* 若将来业务要求 10 路严格同一时刻,需要硬件把它们挪到同一端口——记在 README。
* 三、按端口分段累加:遇到相邻端口不同就冲刷上一段;同一端口再次出现时也另起一段,
* 因此不会把跨段的位合并进同一次 BSRR 写,也不会漏写任一段(引脚改版时不用改本函数)。
* 四、bit6(PF4)仍是 k_do_pin[6] 的普通物理位,由调用方合成的 relay_mask 决定电平;
* 这里不再判断语义,只做极性转换。供电自动使能的合成发生在 ioboard_do_write 里。
*/
static void ioboard_do_apply(uint16_t relay_mask)
{
@@ -560,6 +569,7 @@ static bsp_err_t ioboard_di_read_impl(uint8_t *out_mask, uint8_t in_isr)
* 本函数**不调用 HAL_GPIO_Init**——引脚模式/速度/上下拉由 MX_GPIO_Init() 唯一负责,
* 在这里再 Init 一遍只会让 CubeMX 显示的引脚状态与真相脱节,下次重生成还会被覆盖。
* 只做四件事:清影子寄存器、自检引脚模式、确认并拉回静止态、整组释放 10 路开出。
* 上电无继电器吸合 ⇒ 24V 供电不使能,PF4 随 s_do_shadow=0 保持 RESET,自然成立。
*/
bsp_err_t ioboard_init(void)
{
@@ -587,6 +597,7 @@ bsp_err_t ioboard_init(void)
* 即便 MX_GPIO_Init 已经写过 RESET,这里也显式再写一次:
* 「初值靠 CubeMX 设对」是隐式契约,显式写一次只花几条指令,
* 换来「上电全释放」不依赖别的模块。
* s_do_shadow = 0(无继电器吸合)⇒ PF4 保持 RESET,24V 不使能。
*/
ioboard_do_apply(s_do_shadow);
@@ -621,8 +632,9 @@ bsp_err_t ioboard_di_read_from_isr(uint8_t *out_mask)
}
/*
* 函数功能:整组写 10 路开出
* 入口参数:mask - bit0..bit9,1 = 吸合;bit10..bit15 忽略
* 函数功能:整组写 10 路开出(bit6 KO_24V 由驱动自动合成,写入被忽略)
* 入口参数:mask - bit0..bit9,1 = 吸合;bit6 例外,写入值被忽略;
* bit10..bit15 忽略
* 返回值:BSP_OK
* 限定条件:任意上下文
* 函数说明:
@@ -630,14 +642,25 @@ bsp_err_t ioboard_di_read_from_isr(uint8_t *out_mask)
* 而「传了带高位的值」与「忘了屏蔽」无法区分,所以选择宽容。
* 二、不判断「是否已 init」:影子寄存器初值就是 0(全释放),引脚已由 MX_GPIO_Init
* 配好,init 之前调用也安全。
* 三、影子寄存器在写引脚**之前**更新:若写引脚过程中被更高优先级中断打断,
* 上层查到的「我让它是什么」仍是调用方这次要的值,不会闪回旧值。
* 三、bit6 不由调用方控制:先 mask 掉调用方写入的 IOBOARD_DO_KO_24V,再看剩下的
* 继电器类通道是否有任一吸合(IOBOARD_DO_RELAY_MASK);有则自动置 bit6
* (24V 供电使能),无则保持清。LED 三路不触发。
* 四、合成后的最终 mask 先写影子寄存器、再整组一次 apply:写引脚过程中被中断打断时,
* 上层查到的是本次合成值;BSRR 分段内部原子,不存在「先写 6 脚再写 PF4」的中间态。
* 不设临界区:整半字赋值是单指令原子,BSRR 写本身也原子。
*/
bsp_err_t ioboard_do_write(uint16_t mask)
{
uint16_t relay = (uint16_t)(mask & IOBOARD_DO_MASK_ALL);
/* 调用方写入的 bit6 无效:清掉后由继电器类通道的实际吸合意图重新合成 */
relay = (uint16_t)(relay & (uint16_t)~IOBOARD_DO_KO_24V);
if ((relay & IOBOARD_DO_RELAY_MASK) != 0U) {
relay = (uint16_t)(relay | IOBOARD_DO_KO_24V);
}
/* 影子与引脚使用同一个最终值:一次 apply,段内无中间态 */
s_do_shadow = relay;
ioboard_do_apply(relay);
@@ -646,7 +669,7 @@ bsp_err_t ioboard_do_write(uint16_t mask)
/*
* 函数功能:读软件影子寄存器
* 入口参数:out_mask - 输出,bit0..bit9,1 = 吸合
* 入口参数:out_mask - 输出,bit0..bit9,1 = 吸合;bit6 = 24V 供电使能实际状态
* 返回值:见 ioboard.h
* 限定条件:任意上下文
*/
@@ -663,7 +686,8 @@ bsp_err_t ioboard_do_get(uint16_t *out_mask)
/*
* 函数功能:读 10 路开出引脚的实际输出电平(调试/上板验证用)
* 入口参数:out_level - 输出,bit n = 1 表示第 n 路引脚当前为高电平
* 入口参数:out_level - 输出,bit n = 1 表示第 n 路引脚当前为高电平;
* bit6 是 PF4 的真实电平(继电器供电使能),不经过语义折算
* 返回值:见 ioboard.h
* 限定条件:任意上下文
* 函数说明:
+29 -7
View File
@@ -4,6 +4,8 @@
/*
* 模块名称:开入开出板 BSP(74HC165 开入 + 光耦继电器开出)
* 模块功能:把「板上的引脚与时序」翻译成两件事——读 8 路开入、整组写 10 路开出。
* 10 路是**物理位**:对外可控只有 9 路,bit6 KO_24V 是给其它 KO 供电的
* 使能信号,由驱动按继电器类通道是否吸合自动管理(写入被忽略)。
* 只回答「让硬件动起来并如实汇报」,不回答「该不该动」:
* 不做过流判据、不做互锁策略、不碰 IEC 104、不建 RTOS 任务。
* 适用平台:STM32F407ZGT6 + FreeRTOS(裸机不可用:临界区走 FreeRTOS 宏)
@@ -12,6 +14,8 @@
* 修改记录:
* 2026-11-16 王建锋 创建:74HC165 装载/移位时序 + 4 路光耦继电器整组写
* 2026-11-18 王建锋 扩展:开出扩为 10 路,新增 6 脚按普通开出位接入
* 2026-11-18 王建锋 语义修订:KO_24V(bit6) 改为继电器供电自动使能,
* 对外可控通道由 10 路降为 9 路;DO_COUNT 与物理位不变
*
* 引脚来源(三处一致,改动必须走 CubeMX 重生成,不许在此手补初始化):
* STM32F407-Demo.ioc → Inc/main.h 的 <Label>_Pin / <Label>_GPIO_Port 宏
@@ -26,7 +30,7 @@
* CLZ_LED (PF6) 输出 PP 初值 RESET
* KO_LED1 (PF2) 输出 PP 初值 RESET
* KO_LED2 (PF3) 输出 PP 初值 RESET
* KO_24V (PF4) 输出 PP 初值 RESET
* KO_24V (PF4) 输出 PP 初值 RESET(继电器供电使能,自动)
* KO4 (PF5) 输出 PP 初值 RESET
* KO5 (PC15) 输出 PP 初值 RESET(备份域 ±3 mA,仅作信号位)
* KO_LED3 (PE6) 输出 PP 初值 RESET
@@ -83,6 +87,11 @@ extern "C" {
* KO_24V / KO4 / KO5 / KO_LED3),只作**追溯**,不是业务定义:
* 「跳闸 / 告警 / 闭锁」等动作各自的判据与互斥规则属于业务层,BSP 不解释、不排序。
* KO5(PC15)位于备份域,驱动能力 ±3 mA,10 路统一按信号位处理,不作供电/功率输出。
*
* bit6 KO_24V **不是对外可控通道**:它是给其它 KO 供电的使能信号,由 ioboard_do_write()
* 按 IOBOARD_DO_RELAY_MASK 是否非零自动置/清;调用方写入 bit6 一律被忽略,
* 而 ioboard_do_get() 的 bit6 反映当前实际供电状态。对外可控通道共 9 路,
* 物理位仍是 10 路(bit6 由 k_do_pin[6] 驱动 PF4,do_read_level 可读到真实电平)。
*/
#define IOBOARD_DO_KO6 ((uint16_t)(1U << 0)) /* DO0,PC14 */
#define IOBOARD_DO_TRIP ((uint16_t)(1U << 1)) /* DO1,PF0 */
@@ -90,11 +99,16 @@ extern "C" {
#define IOBOARD_DO_CLZ ((uint16_t)(1U << 3)) /* DO3,PF6 */
#define IOBOARD_DO_KO_LED1 ((uint16_t)(1U << 4)) /* DO4,PF2 */
#define IOBOARD_DO_KO_LED2 ((uint16_t)(1U << 5)) /* DO5,PF3 */
#define IOBOARD_DO_KO_24V ((uint16_t)(1U << 6)) /* DO6,PF4 */
#define IOBOARD_DO_KO_24V ((uint16_t)(1U << 6)) /* DO6,PF4,供电使能(自动),写入被忽略 */
#define IOBOARD_DO_KO4 ((uint16_t)(1U << 7)) /* DO7,PF5 */
#define IOBOARD_DO_KO5 ((uint16_t)(1U << 8)) /* DO8,PC15,备份域 ±3 mA,仅信号位 */
#define IOBOARD_DO_KO_LED3 ((uint16_t)(1U << 9)) /* DO9,PE6 */
/* 继电器类通道 mask,用于 KO_24V 供电自动使能;LED 三路不触发 */
#define IOBOARD_DO_RELAY_MASK ((uint16_t)(IOBOARD_DO_KO6 | IOBOARD_DO_TRIP | \
IOBOARD_DO_ERT | IOBOARD_DO_CLZ | \
IOBOARD_DO_KO4 | IOBOARD_DO_KO5))
/* ======================== 宏定义:极性(唯一可改点) ======================== */
/*
@@ -204,7 +218,7 @@ extern "C" {
/*
* 函数功能:初始化开入开出驱动(影子寄存器复位 + 静止态确认 + 上电全释放)
* 入口参数:无
* 返回值:BSP_OK - 初始化完成,10 路开出已处于释放态
* 返回值:BSP_OK - 初始化完成,10 路开出已处于释放态(含 PF4 供电使能不使能)
* BSP_ERR_STATE - 静止态确认失败(回读到的 SH/LD 或 CLK 电平与预期不符)
* 限定条件:必须在 MX_GPIO_Init() 之后调用(推荐在 app_main_init 里,
* 与其它 BSP 的初始化一起,且**必须在任何业务代码写开出之前**)
@@ -219,6 +233,7 @@ extern "C" {
* 三、最后把 10 路开出整组写成释放态,并让影子寄存器 = 0。
* 即便 MX_GPIO_Init 已经写过 RESET,这里仍显式写一次:初值「靠 CubeMX 设对」
* 是隐式契约,多一次显式写入只花几十个周期,换来上电全释放这条不依赖别人。
* 上电无继电器吸合 ⇒ 24V 供电不使能,PF4 自然保持 RESET。
*/
bsp_err_t ioboard_init(void);
@@ -261,6 +276,8 @@ bsp_err_t ioboard_di_read_from_isr(uint8_t *out_mask);
/*
* 函数功能:整组写 10 路开出(按端口分段,每段一次 BSRR 写,段内不产生中间态)
* 入口参数:mask - bit0..bit9 对应既有 4 路与新增 6 路,**1 = 吸合/有效**;
* bit6 KO_24V 例外:写入被忽略,驱动按继电器类通道是否吸合自动置/清
* (见 IOBOARD_DO_RELAY_MASK);对外可控通道共 9 路;
* bit10..bit15 无对应硬件,忽略(不报错:上层常直接把状态字原样传下)
* 返回值:BSP_OK - 已写入,影子寄存器已更新
* 限定条件:任意上下文可调;BSRR 单次写原子,端口段之间不做临界区
@@ -271,17 +288,22 @@ bsp_err_t ioboard_di_read_from_isr(uint8_t *out_mask);
* 二、10 路落在 GPIOC / GPIOF / GPIOE 三个端口,共 4 个端口段(见 ioboard.c 的
* k_do_pin 表),最多 4 次 BSRR 写入。段与段之间只看到「旧态 → 新态」的跃迁,
* 业务层面不可观测;若将来要求严格同时,需硬件把它们挪到同一端口。
* 三、影子寄存器在写入后更新,ioboard_do_get() 读到的就是「上一次成功写入的值」。
* 三、影子寄存器在合成后更新:bit0..bit9 去掉调用方写入的 bit6,再按
* (mask & IOBOARD_DO_RELAY_MASK) 是否非零自动补上 IOBOARD_DO_KO_24V;
* 合成值与写引脚用的是同一个最终 mask,一次 apply 完成,不产生中间态。
* ioboard_do_get() 读到的 bit6 是当前实际供电状态,不是调用方写入值。
*/
bsp_err_t ioboard_do_write(uint16_t mask);
/*
* 函数功能:读软件影子寄存器(不是硬件回读——硬件无辅助触点回读通路)
* 入口参数:out_mask - 输出,bit0..bit9 = 上一次 ioboard_do_write 的 1=吸合语义
* 入口参数:out_mask - 输出,bit0..bit9 = 当前 1=吸合语义;
* bit6 = KO_24V 供电使能的实际状态(自动算出,非写入回显)
* 返回值:BSP_OK - 成功;BSP_ERR_PARAM - out_mask 为 NULL
* 限定条件:任意上下文可调
* 函数说明:只回答「我上次让它是什么状态」,不回答「继电器现在真的动没动」。
* 后者要上板用辅助触点或万用表量,README 有步骤。
* 函数说明:只回答「上次合成后让它是什么状态」,不回答「继电器现在真的动没动」。
* bit6 回答「24V 供电现在是否使能」;后者要上板用辅助触点或万用表量,
* README 有步骤。
*/
bsp_err_t ioboard_do_get(uint16_t *out_mask);
+1 -1
View File
@@ -269,7 +269,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 数据可信五级台阶/波次退出判据**;**[`开入开出实施说明.md`](硬件平台/开入开出实施说明.md)——74HC165 开入(8 路)与 4 路光耦继电器开出的接线、时序原理、软件分层与接口、上板验证步骤与已知限制** |
| `硬件平台/` | 网表详细分析报告与语义图(V0.0 / V0.1);**[`ADC通道映射说明.md`](硬件平台/ADC通道映射说明.md)——V0.1 十七路 ADC 语义/网名/通道号权威映射表(固件取数、UI 显示、自检注入以此为准),含 §7 链路四段口径、§8 注入实测记录与 §9 数据可信五级台阶/波次退出判据**;**[`开入开出实施说明.md`](硬件平台/开入开出实施说明.md)——74HC165 开入(8 路)与开出(9 路对外可控 + KO_24V 继电器供电自动使能)的接线、时序原理、软件分层与接口、上板验证步骤与已知限制** |
| `芯片手册/` | 外部芯片数据手册转录(CH395F / GD5F2GQ5UE / SD2506 / TPAFE5160 / RTL8305NBI 等) |
| `images/` | 文档技术配图(`.svg` 产物,由 `tools/arch_diagram/`、`tools/refgraph/` 生成) |
+1 -1
View File
@@ -12,4 +12,4 @@
* 把临时的探针,测试IEC104协议正确性的脚本都保存下来,有组织的进行存储和管理。下次可以重复利用测试。
* 确认 6 脚真实去向及 PC15 是否外接驱动(10 路扁平开出已落地,口径见 `docs/硬件平台/开入开出实施说明.md` §2.1)
* 确认 6 脚真实去向及 PC15 是否外接驱动(10 个物理位号已落地,其中 9 路对外可控 + KO_24V 继电器供电自动使能;口径见 `docs/硬件平台/开入开出实施说明.md` §2.1)
+37 -32
View File
@@ -1,10 +1,10 @@
# 开入开出板实施说明
> **文档定位**:V0.1 主板「开入开出板」的**实施口径**——硬件接线、时序原理、软件分层与接口、上板验证步骤、已知限制。
> **一句话结论**:板上**能读 8 路开入、能控 10 路开出**;第二块 74HC165 的数据输出线在板上没接到 MCU,所以**开入是 8 路而不是设计的 16 路**。2026-11-18 的 CubeMX 重生成新增的 6 脚已接进 IOBOARD 驱动,开出统一按 **10 路扁平编址**:`IOBOARD_DO_COUNT=10`、mask 为 `uint16_t` 的 bit0~bit9,不再按功能分类接入。
> **一句话结论**:板上**能读 8 路开入、对外可控 9 路开出,另有 1 路供电自动使能**;第二块 74HC165 的数据输出线在板上没接到 MCU,所以**开入是 8 路而不是设计的 16 路**。2026-11-18 的 CubeMX 重生成新增的 6 脚已接进 IOBOARD 驱动,开出统一按 **10 路扁平编址**:`IOBOARD_DO_COUNT=10`、mask 为 `uint16_t` 的 bit0~bit9;其中 bit6(`KO_24V` / PF4)不是对外可控通道,而是**继电器供电使能**——由驱动在任一继电器类通道吸合时自动拉高,LED 三路不触发,调用方写入 bit6 被忽略。
> **相关文档**:引脚总表与能力边界 [`硬件规格与能力边界.md`](../架构设计/硬件规格与能力边界.md);
> 硬件缺陷登记 [`硬件改版登记.md`](../任务规划/硬件改版登记.md);V0.1 网表逐脚核对的出处 [`V0.1_网表详细分析报告.md`](V0.1_网表详细分析报告.md)。
> **版本**:v1.3 **日期**:2026-11-18(本次:CubeMX 新增的 6 脚已接进 IOBOARD 驱动,扩成扁平 10 路开出;上一版记录 6 个开出引脚宏)
> **版本**:v1.4 **日期**:2026-11-18(本次:KO_24V 改为继电器供电自动使能,对外可控开出 9 路;上一版 v1.3 将 CubeMX 新增的 6 脚扩成扁平 10 路开出)
---
@@ -23,8 +23,8 @@
| 层次 | 状态 | 依据 |
|---|---|---|
| **硬件** | ✅ 已具备 | 10 路光耦继电器出口相关的引脚与 74HC165 开入回路在板上实装;引脚已由 CubeMX 配好并重生成(`Inc/main.h` 有宏、`Src/gpio.c` 的 `MX_GPIO_Init` 有初值)。2026-11-18 重生成新增的 6 脚见「MCU 侧引脚表」 |
| **驱动(BSP 硬件抽象层)** | ✅ 已实现(**覆盖 10 路开出**) | `Drivers/BSP/IOBOARD/` 下的纯逻辑层与 GPIO/时序层,只做引脚操作与位序组装,见本文「软件结构」一节;`IOBOARD_DO_COUNT=10`,新增 6 脚按 bit4~bit9 纳入映射 |
| **硬件** | ✅ 已具备 | 10 路物理位号相关引脚与 74HC165 开入回路在板上实装(9 路对外可控开出 + 1 路供电使能 PF4);引脚已由 CubeMX 配好并重生成(`Inc/main.h` 有宏、`Src/gpio.c` 的 `MX_GPIO_Init` 有初值)。2026-11-18 重生成新增的 6 脚见「MCU 侧引脚表」 |
| **驱动(BSP 硬件抽象层)** | ✅ 已实现(**覆盖 10 路物理位号,其中 9 路对外可控 + 1 路供电自动使能**) | `Drivers/BSP/IOBOARD/` 下的纯逻辑层与 GPIO/时序层,只做引脚操作与位序组装,见本文「软件结构」一节;`IOBOARD_DO_COUNT=10`,新增 6 脚按 bit4~bit9 纳入映射;bit6 由驱动自动算出、调用方写入忽略 |
| **业务层** | ❌ 未接入 | 保护判据仍处**未标定闭锁**态;104 规约的遥信点表未接开入;继电器动作语义(哪路是跳闸、哪路是告警、哪路是闭锁)**尚未定义** |
**因此当前能做的**:用调试口读回 8 路开入的真实状态、单独驱动某一路继电器观察动作。
@@ -57,23 +57,27 @@
| PF6 | `CLZ_LED_Pin`(端口宏 `CLZ_LED_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(释放) | 是(bit3) | 光耦 → 第 4 路继电器线圈 |
| PF2 | `KO_LED1_Pin`(端口宏 `KO_LED1_GPIO_Port` = `GPIOF`) | 推挽输出 | 低 | 是(bit4,语义宏 `IOBOARD_DO_KO_LED1`) | 网表未标 / 待硬件确认 |
| PF3 | `KO_LED2_Pin`(端口宏 `KO_LED2_GPIO_Port` = `GPIOF`) | 推挽输出 | 低 | 是(bit5,语义宏 `IOBOARD_DO_KO_LED2`) | 网表未标 / 待硬件确认 |
| PF4 | `KO_24V_Pin`(端口宏 `KO_24V_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(`GPIO_PIN_RESET`) | 是(bit6,语义宏 `IOBOARD_DO_KO_24V`) | 网表未标 / 待硬件确认;用途见下方「`KO_24V` 与继电器线圈供电」 |
| PF4 | `KO_24V_Pin`(端口宏 `KO_24V_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(`GPIO_PIN_RESET`) | bit6 仅作**继电器供电使能**,由驱动自动算出、调用方写入忽略;`ioboard_do_get()` / UI 显示里的 bit6 是「供电使能当前状态」,非可控通道 | 网表未标 / 待硬件确认;用途见下方「`KO_24V` 与继电器供电使能」 |
| PF5 | `KO4_Pin`(端口宏 `KO4_GPIO_Port` = `GPIOF`) | 推挽输出 | 低 | 是(bit7,语义宏 `IOBOARD_DO_KO4`) | 网表未标 / 待硬件确认 |
| PC15 | `KO5_Pin`(端口宏 `KO5_GPIO_Port` = `GPIOC`) | 推挽输出 | 低(`GPIO_PIN_RESET`) | 是(bit8,语义宏 `IOBOARD_DO_KO5`) | 网表未标 / 待硬件确认;**本脚在备份域**,仅作信号位,限流见本节末 |
| PE6 | `KO_LED3_Pin`(端口宏 `KO_LED3_GPIO_Port` = `GPIOE`) | 推挽输出 | 低 | 是(bit9,语义宏 `IOBOARD_DO_KO_LED3`) | 网表未标 / 待硬件确认 |
**表怎么看**:「驱动是否接管」一列是这一节最要紧的信息。`Drivers/BSP/IOBOARD/ioboard.c` 里已定义 `IOBOARD_DO_CH_GPIO_0..9_*` 十组端口/脚号映射,按 bit 顺序为 PC14、PF0、PF1、PF6、PF2、PF3、PF4、PF5、PC15、PE6;`IOBOARD_DO_COUNT`(定义在 `Drivers/BSP/IOBOARD/ioboard_bits.h`)为 10,`ioboard_do_write()` 的 mask 为 `uint16_t` 的 bit0~bit9(全量值 `IOBOARD_DO_MASK_ALL = ((uint16_t)0x03FFU)`)。每路都有语义宏,例如 `IOBOARD_DO_KO6`、`IOBOARD_DO_KO_LED1`、`IOBOARD_DO_KO_24V`、`IOBOARD_DO_KO5`;统一按位号接入,不做 LED / 供电 / 信号的分类接入。
**表怎么看**:「驱动是否接管」一列是这一节最要紧的信息。`Drivers/BSP/IOBOARD/ioboard.c` 里已定义 `IOBOARD_DO_CH_GPIO_0..9_*` 十组端口/脚号映射,按 bit 顺序为 PC14、PF0、PF1、PF6、PF2、PF3、PF4、PF5、PC15、PE6;`IOBOARD_DO_COUNT`(定义在 `Drivers/BSP/IOBOARD/ioboard_bits.h`)为 10,`ioboard_do_write()` 的 mask 为 `uint16_t` 的 bit0~bit9(全量值 `IOBOARD_DO_MASK_ALL = ((uint16_t)0x03FFU)`)。每路都有语义宏,例如 `IOBOARD_DO_KO6`、`IOBOARD_DO_KO_LED1`、`IOBOARD_DO_KO_24V`、`IOBOARD_DO_KO5`;统一按位号接入,不做 LED / 供电 / 信号的分类接入。**但「对外可控」与「物理位号」不是一回事**:10 个物理位里只有 9 路对外可控,bit6(`KO_24V` / PF4)是供电使能、由驱动自动算出,调用方写入被忽略。
**这 10 路开出的位号口径,一句话说清**:
**这 10 个物理位号的口径,一句话说清**(其中 9 路对外可控、1 路供电使能):
- **bit0~bit3**:既有 4 路,位号保持不变,分别接 PC14(`KO6`)、PF0(`TRIP_LED`)、PF1(`ERT_LED`)、PF6(`CLZ_LED`);
- **bit4~bit9**:2026-11-18 新增 6 脚,固定位号依次为 PF2(`KO_LED1`)、PF3(`KO_LED2`)、PF4(`KO_24V`)、PF5(`KO4`)、PC15(`KO5`,仅信号位)、PE6(`KO_LED3`);
- **写与读**:`ioboard_do_write()` 写整组 bit0~bit9,`ioboard_do_get()` 读影子寄存器,`ioboard_do_read_level()` 回读这 10 根脚的实际电平。业务代码应只通过这些接口操作开出,不要绕过驱动直接 `HAL_GPIO_WritePin`——否则影子寄存器与实际电平脱节,极性核对失去意义。
- **继电器类通道(6 路触发)**:bit0 PC14(`KO6`)、bit1 PF0(`TRIP`)、bit2 PF1(`ERT`)、bit3 PF6(`CLZ`)、bit7 PF5(`KO4`)、bit8 PC15(`KO5`,备份域仅信号位);这些通道吸合时,供电使能 bit6 自动拉高;
- **LED 三路(不触发供电使能)**:bit4 PF2(`KO_LED1`)、bit5 PF3(`KO_LED2`)、bit9 PE6(`KO_LED3`);这三路动作不会拉高 bit6;
- **供电使能(1 路,非对外可控)**:bit6 PF4(`KO_24V`),由驱动在任一继电器类通道吸合时自动拉高,调用方写入 bit6 被忽略;
- **写与读**:`ioboard_do_write()` 写整组 bit0~bit9,但调用方写入的 bit6 会被忽略、由驱动按上述规则覆盖;`ioboard_do_get()` 读影子寄存器,其中 bit6 是「供电使能当前状态」而不是可控通道;`ioboard_do_read_level()` 回读这 10 根脚的实际电平。业务代码应只通过这些接口操作开出,不要绕过驱动直接 `HAL_GPIO_WritePin`——否则影子寄存器与实际电平脱节,极性核对失去意义。UI 显示里的 bit6 同样按「供电使能当前状态」解释,不可当作可控开出。
**`KO_24V` 与继电器线圈供电**:按命名,`KO_24V`(PF4)应是继电器线圈的 **24 V 供电使能**——**线圈没有 24 V 就不会吸合**。驱动现在把 `KO_24V` 当普通开出路 bit6 写(语义宏 `IOBOARD_DO_KO_24V`),**仍没有联锁逻辑**;上层若要据此控继电器,须自行保证先供电后吸合,不要在驱动层期待自动顺序。上电时 CubeMX 把它初始化为低电平,即**默认线圈无电、不会误吸合**,这与 §4.4「上电默认态」的安全目标一致。但要注意两条边界:
**`KO_24V` 与继电器供电使能**:`KO_24V`(PF4,软件位 bit6)的实际语义是**继电器供电使能**,不是「对外开出第 6 路」。规则由用户裁定固定:
1. PF4 的实际走线在现有网表里查不到网络名(见下段),「24 V 使能」目前只是**引脚命名与用户口述**的口径,未经网表或台架证实;
2. 是否真的存在「先供电后吸合」的硬件时序,同样未经证实;驱动不实现联锁、也不替上层保证顺序,上层必须按实际硬件自行处理。
- **触发条件**:只有当任一继电器类通道(bit0 `KO6`、bit1 `TRIP`、bit2 `ERT`、bit3 `CLZ`、bit7 `KO4`、bit8 `KO5`)吸合时,bit6 才由驱动**自动拉高**;LED 三路(bit4 `KO_LED1`、bit5 `KO_LED2`、bit9 `KO_LED3`)不触发供电使能。
- **调用方写入被忽略**:bit6 仍物理对应 PF4,但调用方写入 bit6 一律被驱动忽略、由驱动自动算出;`ioboard_do_get()` 与 UI 显示里的 bit6 是**供电使能当前状态**,不是可控通道。因此对外可控开出是 **9 路**(6 路继电器类 + 3 路 LED),不是 10 路。
- **上电初值**:CubeMX 把 PF4 初始化为低(`GPIO_PIN_RESET`),即默认供电使能无效,与本文「上电默认态」一节的安全目标一致。
**边界(不要臆造)**:PF4 的实际走线在现有网表里查不到网络名(见下段),6 脚真实去向仍待硬件确认;「24 V 使能」是用户裁定的语义口径,未经网表或台架证实,不要据此推断走线或辅助触点。供电使能**没有辅助触点回读**——驱动只能通过 bit6 表达「软件认为使能是否已拉高」,不读取任何硬件反馈触点。
**为什么这 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`。
@@ -99,15 +103,15 @@
| `IOBOARD_DO_KO5` | PC15(备份域,仅信号位) | bit8 |
| `IOBOARD_DO_KO_LED3` | PE6 | bit9 |
**已在 v1.3 完成**:这 6 脚已按上表位号接进 `Drivers/BSP/IOBOARD/` 驱动,`IOBOARD_DO_COUNT` 从 4 扩到 10,mask 由 4 位 `uint8_t` 改为 `uint16_t` 的 bit0~bit9(全量值 `IOBOARD_DO_MASK_ALL = ((uint16_t)0x03FFU)`);`ioboard_init()` 的静止态确认、`ioboard_do_write()` / `ioboard_do_get()` / `ioboard_do_read_level()` 均已覆盖 10 路。
**已在 v1.3 完成**:这 6 脚已按上表位号接进 `Drivers/BSP/IOBOARD/` 驱动,`IOBOARD_DO_COUNT` 从 4 扩到 10,mask 由 4 位 `uint8_t` 改为 `uint16_t` 的 bit0~bit9(全量值 `IOBOARD_DO_MASK_ALL = ((uint16_t)0x03FFU)`);`ioboard_init()` 的静止态确认、`ioboard_do_write()` / `ioboard_do_get()` / `ioboard_do_read_level()` 均已覆盖 10 路。**v1.4 修正**:bit6(`KO_24V` / PF4)语义从「对外开出第 6 路」改为**继电器供电自动使能**,对外可控通道由 10 个减为 **9 路**,供电使能无辅助触点回读。
**剩余限制**(不改变「驱动已接管 10 路」的事实,仍需硬件或上层处理):
**剩余限制**(不改变「驱动已接管 10 路物理位号、其中 9 路对外可控」的事实,仍需硬件处理):
| 剩余限制 | 现状 | 去向 |
|---|---|---|
| 6 脚真实去向未确认 | 网表查不到这些网络名,只知 CubeMX 宏与位号 | `docs/任务规划/待处理疑问.md` |
| PC15 备份域限流 | ±3 mA / ≤2 MHz / ≤30 pF,仅作信号位、不驱动继电器 | 见本节「PC14 与 PC15 在备份域」 |
| `KO_24V` 供电联锁 | 驱动把它当普通 bit6 写,**没有联锁逻辑** | 上层若要据此控继电器,须自行保证先供电后吸合 |
| 供电使能无辅助触点回读 | bit6 是驱动自动算出的使能状态,不读取硬件反馈触点 | 用户裁定口径;LED 三路不触发供电使能也是裁定,非待办 |
### 2.2 74HC165 侧:两块芯片共用两根控制线,数据线只有一根
@@ -124,7 +128,7 @@
因此:
- **不要**把 PE2/PE4 当成可用的开入通道,读到什么都无意义;
- `Drivers/BSP/IOBOARD/` 的驱动**完全不碰这两根脚**(只在初始化与读操作里使用 PC2/PC3/PE3 与 10 路开出);
- `Drivers/BSP/IOBOARD/` 的驱动**完全不碰这两根脚**(只在初始化与读操作里使用 PC2/PC3/PE3 与 10 个开出物理位号);
- 这两根脚的初始化留在 CubeMX 生成代码里,是历史遗留,不影响功能,但清理需要动 `USER CODE` 区之外的配置,**留给硬件改版时一并定夺**。
---
@@ -254,12 +258,12 @@
| 接口 | 职责 | 参数语义 |
|---|---|---|
| `ioboard_init()` | 初始化:确认静止态、把 10 路开出置为全释放、清影子寄存器 | 无。返回 `BSP_ERR_STATE` 表示静止态确认失败(引脚被别人动过) |
| `ioboard_init()` | 初始化:确认静止态、把 9 路对外可控开出置为全释放、供电使能 bit6 置低、清影子寄存器 | 无。返回 `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(uint16_t mask)` | 写一次 10 路开出 | `mask` 为 `uint16_t`,bit0~bit9 分别对应 10 路(固定位号见「MCU 侧引脚表」);**1 = 继电器吸合**,与硬件电平高低无关。高 6 位(bit10~bit15)会被静默丢弃,函数体内按 `IOBOARD_DO_MASK_ALL` 取低 10 位 |
| `ioboard_do_get(uint16_t *out_mask)` | 取软件影子寄存器里的当前开出 mask | 读的是驱动认为的状态,不读引脚;bit0~bit9 有效 |
| `ioboard_do_read_level(uint16_t *out_level)` | 直接读 10 根开出引脚的**实际电平** | 用于极性核对:与 `ioboard_do_get()` 对不上,说明有人在驱动之外动过这些脚 |
| `ioboard_do_write(uint16_t mask)` | 写一次 9 路对外可控开出(bit6 供电使能由驱动自动覆盖) | `mask` 为 `uint16_t`,bit0~bit9 对应 10 个物理位号(见「MCU 侧引脚表」);**1 = 继电器吸合**,与硬件电平高低无关。**调用方写入的 bit6 被忽略**,驱动按「任一继电器类通道吸合则拉高、LED 三路不触发」自动算出 bit6;高 6 位(bit10~bit15)静默丢弃 |
| `ioboard_do_get(uint16_t *out_mask)` | 取软件影子寄存器里的当前 mask | 读的是驱动认为的状态,不读引脚;bit0~bit9 有效,**其中 bit6 是「供电使能当前状态」,不是可控通道**;无辅助触点回读 |
| `ioboard_do_read_level(uint16_t *out_level)` | 直接读 10 根开出引脚的**实际电平** | 用于极性核对:与 `ioboard_do_get()` 对不上,说明有人在驱动之外动过这些脚;bit6 反映 PF4 实际电平(供电使能),非可控通道 |
**mask 里 1 的含义**:开入 mask 的 1 = 该路**有信号**(触点闭合 / 压板投入);开出 mask 的 1 = 该路**继电器吸合**。两个方向的 1 都代表"该通道处于激活态",与硬件电平的高低**无关**——电平极性的换算在驱动内部完成。
@@ -273,11 +277,11 @@
### 4.4 上电默认态
`ioboard_init()` 会把 10 路开出置为**全释放**并清影子寄存器。这是安全设计:上电默认所有出口不动作。
`ioboard_init()` 会把 9 路对外可控开出置为**全释放**并清影子寄存器,供电使能 bit6 同步为低。这是安全设计:上电默认所有出口不动作、继电器线圈无电。
但要注意**从上电到 `ioboard_init()` 执行之间**有一段窗口,这期间引脚电平由 CubeMX 生成的初值决定(见「硬件接线」的引脚表),驱动管不到。因此上板验证时**务必观察上电瞬间有没有误吸合**,这是「开出:逐路验证继电器动作」一节的第一条。
2026-11-18 新增的 6 脚已在 v1.3 纳入 `ioboard_init()` 的静止态确认与全释放范围。`KO_24V`(PF4)因此也由驱动写低电平初值;若按「24 V 线圈供电使能」的口径,即默认线圈无电——但这一口径未经网表或台架证实,驱动也没有供电联锁逻辑。
2026-11-18 新增的 6 脚已在 v1.3 纳入 `ioboard_init()` 的静止态确认与全释放范围。`KO_24V`(PF4)因此也由驱动写低电平初值,即默认供电使能无效、继电器线圈无电;上电后 bit6 只在任一继电器类通道吸合时由驱动自动拉高。PF4 的实际走线网表查不到,仍待硬件确认。
### 4.5 时序实现要点
@@ -322,11 +326,12 @@
1. **上电瞬间**:先听/看既有 4 路继电器,**都不应有吸合动作**。判据:全部处于释放态;新增 6 脚的真实去向在网表里查不到,只能用万用表或调试器读电平,不能把电平变化直接当成继电器动作。
2. 用万用表(通断档或电阻档)接在某一路继电器的**触点两端**,先确认释放态读数是常开(断路)或常闭(导通),记下来。
3. 只置 **bit0**(mask = `0x0001`),观察:该路继电器**有吸合声**、触点状态翻转;其余路不动。
4. 逐位重复:mask = `0x0002` / `0x0004` / `0x0008` / `0x0010` / `0x0020` / `0x0040` / `0x0080` / `0x0100` / `0x0200`,确认每一路都只对应一个 bit。其中 bit8 是 PC15(`KO5`),**仅作信号位、不驱动继电器**,不要据它期待触点动作。
5. 写 **全 1**(mask = `0x03FF`,即 `IOBOARD_DO_MASK_ALL`),确认 10 路同时有效——这一步是「10 路分属三端口、整组写最多 4 次 BSRR」那条限制的现场确认:端口切换之间不是严格原子,观察是否出现可感知的先后差。
6. 最后写 mask = `0x0000`,确认 10 路全部回到释放态。
4. 逐位重复(**跳过 bit6**):mask = `0x0002` / `0x0004` / `0x0008` / `0x0010` / `0x0020` / `0x0080` / `0x0100` / `0x0200`,确认每一路都只对应一个对外可控 bit。其中 bit8 是 PC15(`KO5`),**仅作信号位、不驱动继电器**,不要据它期待触点动作。bit6 是供电使能、由驱动自动算出,写入会被忽略,故不作为可控通道逐位验证。
5. 验证供电自动使能:单独写任一继电器类通道(bit0/bit1/bit2/bit3/bit7/bit8)使其吸合,用 `ioboard_do_get()` 读到 bit6 自动拉高;只写 LED 三路(bit4/bit5/bit9)时 bit6 保持为低。供电使能无辅助触点回读,只能以影子寄存器 bit6 为判据。
6. 写 **全 1**(mask = `0x03FF`,即 `IOBOARD_DO_MASK_ALL`),确认 10 个物理位同时有效——这一步是「10 路分属三端口、整组写最多 4 次 BSRR」那条限制的现场确认:端口切换之间不是严格原子,观察是否出现可感知的先后差。注意 bit6 即使写入 1,也仅反映「有继电器类通道吸合时使能拉高」,不是独立可控路。
7. 最后写 mask = `0x0000`,确认 9 路对外可控开出全部回到释放态、bit6 随之为低。
**注意新增 6 脚的验证边界**:PF2/PF3/PF4/PF5/PC15/PE6 虽已纳入驱动并固定在 bit4~bit9,但 `docs/硬件平台/V0.1.tel` 里查不到这些网络名(见 §2.1),不能用「网表推测的继电器路数」当判据;PC15 还受备份域 ±3 mA 限制,只允许当信号位观察电平。`KO_24V`(bit6)由驱动当普通开出路写,**没有供电联锁逻辑**;若要据此做继电器测试,须由上层自行保证先供电后吸合。
**注意新增 6 脚的验证边界**:PF2/PF3/PF4/PF5/PC15/PE6 虽已纳入驱动并固定在 bit4~bit9,但 `docs/硬件平台/V0.1.tel` 里查不到这些网络名(见本文「MCU 侧引脚表」一节),不能用「网表推测的继电器路数」当判据;PC15 还受备份域 ±3 mA 限制,只允许当信号位观察电平。`KO_24V`(bit6)是继电器供电使能,由驱动在继电器类通道吸合时自动拉高、LED 三路不触发,调用方写入忽略;6 脚真实去向仍待硬件确认。
**注意极性**:软件 mask 的 1 = 吸合,与硬件电平的高低无关,由驱动内部转换。若发现"写 1 反而不吸合",改 `Drivers/BSP/IOBOARD/ioboard.h` 的 `IOBOARD_DO_LEVEL_ACTIVE` 这一个宏即可,**不要在上层逐路取反**。判断当前极性是否正确的快捷办法:调 `ioboard_do_read_level()` 读实际引脚电平,再和 `ioboard_do_get()` 的影子寄存器对照——两者对不上说明有人在驱动之外动过这些脚。
@@ -387,20 +392,20 @@
**改好后的软件适配点**(这里只定位,不写实现):位序组装在 `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 10 路开出分属三个端口(同步性限制)
### 6.2 10 路物理位号分属三个端口(同步性限制)
10 路开出里 bit0 的 PC14、bit8 的 PC15 在 GPIOC,bit1~bit7 的 PF0/PF1/PF6/PF2/PF3/PF4/PF5 在 GPIOF,bit9 的 PE6 在 GPIOE;按 bit 顺序形成 C→F→C→E 四段,所以整组写最多要写 4 次 `BSRR`(每段一次)。各段写入之间相隔几条指令(约 10 ns 量级),业务层面通常不可观测;但若对 10 路的**严格同时性**有要求,软件侧无法再压缩——只能改硬件,把这些路挪到同一个端口。
10 个物理位号里 bit0 的 PC14、bit8 的 PC15 在 GPIOC,bit1~bit7 的 PF0/PF1/PF6/PF2/PF3/PF4/PF5 在 GPIOF,bit9 的 PE6 在 GPIOE;按 bit 顺序形成 C→F→C→E 四段,所以整组写最多要写 4 次 `BSRR`(每段一次)。各段写入之间相隔几条指令(约 10 ns 量级),业务层面通常不可观测;但若对这些位的**严格同时性**有要求,软件侧无法再压缩——只能改硬件,把这些路挪到同一个端口。
**这条限制在 v1.3 的口径**:`IOBOARD_DO_COUNT=10`,驱动写满 bit0~bit9,「三个端口、C→F→C→E 四段、整组写最多 4 次 BSRR」是当前事实;相比旧版只写 4 路、两个端口、2 次 BSRR,同步性进一步变差。把它算进设计,不要等台架上才发现不同时。
**这条限制的当前口径**:`IOBOARD_DO_COUNT=10`,驱动写满 bit0~bit9,「三个端口、C→F→C→E 四段、整组写最多 4 次 BSRR」是当前事实;相比旧版只写 4 路、两个端口、2 次 BSRR,同步性进一步变差。其中 bit6 是供电使能、由驱动自动覆盖,不占对外可控通道。把它算进设计,不要等台架上才发现不同时。
### 6.3 继电器动作语义属业务层,本文档不定义
10 路开出分别对应"跳闸""告警""闭锁"还是别的含义,**不在本文档定义**。这是保护逻辑层的职责,去向:
9 路对外可控开出分别对应"跳闸""告警""闭锁"还是别的含义,**不在本文档定义**(供电使能 bit6 由驱动自动算出,不在此列)。这是保护逻辑层的职责,去向:
- 保护判据与动作逻辑 → `docs/算法/采集与算法层设计说明.md`、`docs/算法/继电保护功能复现规划.md`
- 104 规约的遥信/遥控点表 → `docs/子系统设计/IEC104上行设计说明.md`
在业务层把这些定义清楚之前,**这 10 路开出只能用于台架验证,不得用于真实跳闸**;新增 6 脚的真实去向尚未由网表确认,PC15 仅作信号位。
在业务层把这些定义清楚之前,**这些开出只能用于台架验证,不得用于真实跳闸**;新增 6 脚的真实去向尚未由网表确认,PC15 仅作信号位。
### 6.4 保护判据未标定闭锁(承重限制)
+4 -4
View File
@@ -1,15 +1,15 @@
{
"built_at": "2026-11-18T14:25:14+08:00",
"fingerprint": "9845ece8f91825fd88a918396c54bf22a2beb01b18f34b44fcfc8e10c447481b",
"built_at": "2026-11-18T19:34:47+08:00",
"fingerprint": "2b815f23ef5e7e502695180c28661baea47730f1132c5eca711ab11b8564d9b2",
"fingerprint_files": 1583,
"fingerprint_source": "git-index",
"gated_regions": [
"RW_IRAM1",
"RW_CCM"
],
"git_head": "afd43f51e81cc072d2ac1eaa7492d9621a62daef",
"git_head": "74efa671bb11a547f2ab8ac174f586132703a506",
"map": "MDK-ARM/STM32F407-Demo/STM32F407-Demo.map",
"map_mtime": 1794983104,
"map_mtime": 1795001672,
"pct": {
"ER_IROM1": 39.68,
"RW_CCM": 87.89,
+121 -23
View File
@@ -133,9 +133,13 @@ static const uint16_t k_do_bit[IOBOARD_TEST_DO_COUNT_EXPECT] = {
(uint16_t)IOBOARD_DO_KO_24V, (uint16_t)IOBOARD_DO_KO4,
(uint16_t)IOBOARD_DO_KO5, (uint16_t)IOBOARD_DO_KO_LED3
};
/* 开出通道名(与十位语义位的顺序一一对应,见 ioboard.h 的 IOBOARD_DO_* 宏)。
* KO_24V 带 "(auto)" 后缀:2026-11-18 起它不是对外可控通道,而是驱动按继电器类通道
* 自动合成的供电使能(写入被忽略)。台架日志若把它和九个可控通道并列印成 "KO_24V",
* 操作员会去找那条并不存在的「命令它合」的路径。 */
static const char *const k_do_name[IOBOARD_TEST_DO_COUNT_EXPECT] = {
"KO6", "TRIP", "ERT", "CLZ",
"KO_LED1", "KO_LED2", "KO_24V", "KO4", "KO5", "KO_LED3"
"KO_LED1", "KO_LED2", "KO_24V(auto)", "KO4", "KO5", "KO_LED3"
};
/* Phase 1 的单比特结果(0 = 本路未通过,不进双射核对的集合) */
@@ -573,20 +577,101 @@ static void ioboard_phase_di_stable(void)
/* ===================== Phase 3:开出逐个点动 ===================== */
/*
* 函数功能:Phase 3 的专项复核——继电器类通道吸合时 KO_24V(PF4) 必须自动带电,
* 整组释放后必须自动回落(2026-11-18 KO_24V 语义修订的专用判据)。
* 入口参数:无
* 返回值:无(结果计入 g_ioboard_test_stats)
* 限定条件:仅套件线程调用,且只在 ioboard_phase_do_actuation() 的逐路循环之后调用;
* 开出当前空载,可安全点动(本函数会额外点动一路继电器 1 s)。
* 函数说明:逐路循环里每条继电器通道都已间接测过一次自动使能,为什么还要单列:
* 「整条自动使能压根没生效」是最严重的一种失效(继电器线圈根本没得电,
* 屏上与影子里却显示已吸合),而它在逐路日志里只表现为 6 条 shadow 断言
* 一起红,看不出根因。这里用一个通道做一次正例(吸合 → bit6 置位)+
* 一次反例(释放 → bit6 回落),日志里是一条独立、可指认的判据。
* 期望值仍由 IOBOARD_DO_RELAY_MASK **推导**(与本文件 Phase 3 主体同一套
* 规则),不在这里另抄一张 bit6 真相表;开头那条自校验断言保证这套推导本身
* 不会因为 RELAY_MASK 被改小退化成空判据。
*/
static void ioboard_phase_auto_24v_check(void)
{
uint16_t cmd = (uint16_t)(IOBOARD_DO_CLZ & (uint16_t)~IOBOARD_DO_KO_24V);
uint16_t expect = cmd;
uint16_t shadow = 0xFFFFu;
uint16_t level = 0xFFFFu;
uint32_t attracted;
bsp_err_t rc;
if ((cmd & (uint16_t)IOBOARD_DO_RELAY_MASK) != 0u) {
expect = (uint16_t)(expect | IOBOARD_DO_KO_24V);
}
/* 自校验:所选通道必须在触发集里,否则下面的正例就变成"期望 bit6 不动"的空判据 */
IOBOARD_TEST_CHECK((expect & (uint16_t)IOBOARD_DO_KO_24V) != 0u,
"auto-24V: CLZ is inside IOBOARD_DO_RELAY_MASK (derived expect=0x%04X)",
(unsigned int)expect);
DBG_INFO(" auto-24V: closing CLZ alone, PF4 must come up by itself (expect 0x%04X)",
(unsigned int)expect);
rc = ioboard_do_write(cmd);
if (rc != BSP_OK) {
IOBOARD_TEST_CHECK(0, "auto-24V: ioboard_do_write(0x%04X) ret=%d",
(unsigned int)cmd, (int)rc);
ioboard_emergency_release("auto-24V write failed");
return;
}
ioboard_io_delay(IOBOARD_TEST_DO_ARM_MS);
(void)ioboard_do_get(&shadow);
(void)ioboard_do_read_level(&level);
attracted = ioboard_level_to_attracted(level);
DBG_INFO(" shadow=0x%04X level=0x%04X -> attracted=0x%04X (expected 0x%04X)",
(unsigned int)shadow, (unsigned int)level,
(unsigned int)attracted, (unsigned int)expect);
IOBOARD_TEST_CHECK((uint16_t)(shadow & IOBOARD_TEST_DO_MASK_ALL) == expect,
"auto-24V: shadow=0x%04X (expect 0x%04X: CLZ + auto bit6)",
(unsigned int)shadow, (unsigned int)expect);
IOBOARD_TEST_CHECK((uint16_t)(attracted & IOBOARD_DO_KO_24V) != 0u,
"auto-24V: PF4 at ACTIVE level while a relay channel is closed (level=0x%04X)",
(unsigned int)level);
IOBOARD_TEST_CHECK((uint16_t)(attracted & (uint16_t)~expect) == 0u,
"auto-24V: nothing else energised (attracted=0x%04X expect 0x%04X)",
(unsigned int)attracted, (unsigned int)expect);
/* 反例:整组释放后供电必须跟着回落——否则 24V 常带电,"释放"只是屏上的假象 */
ioboard_release_all("after auto-24V check");
(void)ioboard_do_get(&shadow);
(void)ioboard_do_read_level(&level);
IOBOARD_TEST_CHECK((uint16_t)(shadow & IOBOARD_DO_KO_24V) == 0u,
"auto-24V: shadow bit6 clear once every relay is released (shadow=0x%04X)",
(unsigned int)shadow);
IOBOARD_TEST_CHECK((uint16_t)(ioboard_level_to_attracted(level) & IOBOARD_DO_KO_24V)
== 0u,
"auto-24V: PF4 back at RELEASE level (level=0x%04X)",
(unsigned int)level);
}
/*
* 函数功能:Phase 3 —— 10 路开出逐个点动(空载),验动作与回读极性。
* 入口参数:无
* 返回值:无(结果计入 g_ioboard_test_stats)
* 限定条件:需人工听继电器动作声;**开出当前空载**,可安全点动。
* 函数说明:每路点动时长 IOBOARD_TEST_DO_ARM_MS(1 s,空载继电器动作声足以辨认)。
* 判据三条:
* ① ioboard_do_read_level() 回读电平与 IOBOARD_DO_LEVEL_ACTIVE 极性一致;
* ② 其余 9 路保持不吸合(防"一位写全组动"的锁存错误);
* ③ 释放后回读全部回到 IOBOARD_DO_LEVEL_RELEASE(覆盖 bit0..bit9 全 10 路)。
* ⚠ 若判据 ① 全线失败,第一嫌疑是**极性宏写反**而不是硬件损坏:
* 判据三条(期望值由驱动的合成规则推导,见循环内注释;2026-11-18 KO_24V 语义修订):
* ① 影子寄存器 == 本次写入合成后的期望值 expect;
* ② expect 里的每一位都处于吸合电平(极性折算是否正确,含自动使能的 bit6);
* ③ expect 之外的每一位都保持不吸合(防"一位写全组动"的锁存错误);
* ④ 释放后回读全部回到 IOBOARD_DO_LEVEL_RELEASE(覆盖 bit0..bit9 全 10 路)。
* 逐路期望值分三类(都由同一条推导规则得出,不是四张表):
* · 继电器类通道 bit0/1/2/3/7/8 → expect = 该位 | bit6(PF4 顺带带电,会听到两声)
* · LED 通道 bit4/5/9 → expect = 该位(PF4 不动)
* · bit6 自己 → 写入被忽略 ⇒ expect = 0(哪一路都不动,没有咔哒声)
* ⚠ 若判据 ② 全线失败,第一嫌疑是**极性宏写反**而不是硬件损坏:
* ioboard.h 的 README 步骤 2 明确"DO 极性未在板上验证"。
* 日志里同时打出 RELEASE 与 ACTIVE 两个电平值,就是为了一眼分辨这一点。
* 任何一路写失败立即 ioboard_emergency_release 刹车并终止后续点动。
* 任何一路写失败立即 ioboard_emergency_release 刹车并跳过该路;
* 逐路循环跑完再走一次 ioboard_phase_auto_24v_check() 单列复核供电使能。
*/
static void ioboard_phase_do_actuation(void)
{
@@ -599,13 +684,23 @@ static void ioboard_phase_do_actuation(void)
for (i = 0u; i < (uint32_t)IOBOARD_TEST_DO_COUNT_EXPECT; i++) {
uint16_t only = (uint16_t)(k_do_bit[i] & (uint16_t)IOBOARD_TEST_DO_MASK_ALL);
uint16_t cmd = (uint16_t)(only & (uint16_t)~IOBOARD_DO_KO_24V);
uint16_t expect = cmd;
uint16_t shadow = 0xFFFFu;
uint16_t level = 0xFFFFu;
uint32_t active_bits;
bsp_err_t rc;
DBG_INFO(" [%u/10] CUE: %s relay will CLOSE for %u ms .. listen for click",
(unsigned int)(i + 1u), k_do_name[i], (unsigned int)IOBOARD_TEST_DO_ARM_MS);
/* 期望值**推导**而非抄表(驱动规则:调用方的 bit6 无效 → 先丢;继电器类通道
* 任一为 1 → 自动补 bit6)。这样本文件与 ioboard.h 的 IOBOARD_DO_RELAY_MASK
* 同源:那张表改了,这里的期望跟着变,不会出现"测试与驱动各信一套"。 */
if ((cmd & (uint16_t)IOBOARD_DO_RELAY_MASK) != 0u) {
expect = (uint16_t)(expect | IOBOARD_DO_KO_24V);
}
DBG_INFO(" [%u/10] CUE: %s: write 0x%04X expect attracted 0x%04X (%u ms, listen)",
(unsigned int)(i + 1u), k_do_name[i], (unsigned int)only,
(unsigned int)expect, (unsigned int)IOBOARD_TEST_DO_ARM_MS);
rc = ioboard_do_write(only);
if (rc != BSP_OK) {
IOBOARD_TEST_CHECK(0, "%s: ioboard_do_write(0x%04X) ret=%d",
@@ -625,23 +720,23 @@ static void ioboard_phase_do_actuation(void)
DBG_INFO(" shadow=0x%04X level=0x%04X -> attracted=0x%04X (expected 0x%04X)",
(unsigned int)shadow, (unsigned int)level,
(unsigned int)active_bits, (unsigned int)k_do_bit[i]);
(unsigned int)active_bits, (unsigned int)expect);
/* 三条断言分工不同,不要合并:
* ① 影子寄存器 == 只有这一路(写入意图是否正确落地)
* ② 该路确实处于吸合电平(极性折算是否正确)
* ③ 其余 9 路都没有被带起来(其余位全为 0,不是"至少有一位") */
IOBOARD_TEST_CHECK((uint16_t)(shadow & IOBOARD_TEST_DO_MASK_ALL) == only,
"%s: shadow=0x%04X (expect 0x%04X: only this bit set)",
k_do_name[i], (unsigned int)shadow, (unsigned int)only);
IOBOARD_TEST_CHECK((active_bits & k_do_bit[i]) != 0u,
"%s: pin at ACTIVE level while commanded (level=0x%04X)",
/* 三条断言分工不同,不要合并(bit6 已并进 expect,所以三条都自动适配三类通道):
* ① 影子寄存器 == 合成后的期望值(写入意图 + 自动使能是否正确落地)
* ② 期望里的每一位都处于吸合电平(极性折算是否正确;bit6 行 expect=0,本条空真)
* ③ 期望之外的位全为 0,不是"至少有一位"(bit6 行即"写它等于什么都没写") */
IOBOARD_TEST_CHECK((uint16_t)(shadow & IOBOARD_TEST_DO_MASK_ALL) == expect,
"%s: shadow=0x%04X (expect 0x%04X: driver-composed incl. auto bit6)",
k_do_name[i], (unsigned int)shadow, (unsigned int)expect);
IOBOARD_TEST_CHECK((active_bits & expect) == expect,
"%s: every expected bit at ACTIVE level while commanded (level=0x%04X)",
k_do_name[i], (unsigned int)level);
IOBOARD_TEST_CHECK((uint16_t)(active_bits & (uint16_t)~only) == 0u,
"%s: other 9 outputs stay released (attracted=0x%04X)",
k_do_name[i], (unsigned int)active_bits);
IOBOARD_TEST_CHECK((uint16_t)(active_bits & (uint16_t)~expect) == 0u,
"%s: outputs outside expect stay released (attracted=0x%04X expect 0x%04X)",
k_do_name[i], (unsigned int)active_bits, (unsigned int)expect);
/* 立即释放,并核对全部回到不吸合 */
/* 立即释放,并核对全部回到不吸合(写 0 后 bit6 也自动回落,全 0 断言天然成立) */
ioboard_release_all("after tap");
(void)ioboard_do_read_level(&level);
IOBOARD_TEST_CHECK((uint16_t)(level & IOBOARD_TEST_DO_MASK_ALL) ==
@@ -651,6 +746,9 @@ static void ioboard_phase_do_actuation(void)
ioboard_io_delay(IOBOARD_TEST_DO_RELEASE_MS);
}
/* 供电自动使能单列复核:正例 + 反例各一条,见该函数头注释 */
ioboard_phase_auto_24v_check();
IOBOARD_TEST_REPORT("Phase 3 DO actuation");
}
+46 -3
View File
@@ -261,6 +261,11 @@ static void do_active_level_matches_documented_high(void)
* 语义位:前四路 KO6=bit0、TRIP=bit1、ERT=bit2、CLZ=bit3,新增六路从 bit4 到 bit9 依序排布;
* 十位互异且恰好铺满 bit0..bit9。为何值得测:这些位就是出口通道号,互换两位 = 两个出口对调,
* 台架上继电器照样"动",只有知道端子接线的人才会发现。
*
* 位号与「可控性」是两件事:本用例只钉**位号**(bit6 = PF4 这个物理位在哪一位)。
* 2026-11-18 起 bit6 已不是对外可控通道,而是**自动供电使能位(写入被忽略)**——
* 位号没变,所以那条 CHECK 原样保留;触发集成员资格另由
* do_relay_mask_covers_only_relay_channels() 单独钉。
*/
static void do_semantic_bits_are_distinct_and_dense(void)
{
@@ -276,7 +281,7 @@ static void do_semantic_bits_are_distinct_and_dense(void)
CHECK(IOBOARD_DO_CLZ == 0x008U, "CLZ is bit3 (PF6)");
CHECK(IOBOARD_DO_KO_LED1 == 0x010U, "KO_LED1 is bit4 (PF2)");
CHECK(IOBOARD_DO_KO_LED2 == 0x020U, "KO_LED2 is bit5 (PF3)");
CHECK(IOBOARD_DO_KO_24V == 0x040U, "KO_24V is bit6 (PF4)");
CHECK(IOBOARD_DO_KO_24V == 0x040U, "KO_24V is bit6 (PF4, auto 24V supply enable; writes ignored)");
CHECK(IOBOARD_DO_KO4 == 0x080U, "KO4 is bit7 (PF5)");
CHECK(IOBOARD_DO_KO5 == 0x100U, "KO5 is bit8 (PC15 signal only)");
CHECK(IOBOARD_DO_KO_LED3 == 0x200U, "KO_LED3 is bit9 (PE6)");
@@ -285,7 +290,43 @@ static void do_semantic_bits_are_distinct_and_dense(void)
}
/*
* 路数常量:一片 74HC165 = 8 位开入,开出扩到 10 路。为何值得测:组装函数的移位用
* 函数功能:钉住继电器类通道集合 IOBOARD_DO_RELAY_MASK 的成员资格(谁吸合会顺带拉起
* PF4 的 24V 供电)——只有位号与并集关系,不触碰任何寄存器
* 入口参数:无(纯宏契约)
* 返回值:无(结果计入 s_pass / s_fail)
* 限定条件:主机侧可编译;只依赖 ioboard.h 的宏,**不** include ioboard.c、不打 GPIO 桩,
* 因此本用例不测 ioboard_do_write() 的实际行为,只测它赖以合成的那张表
* 函数说明:为何值得测——这条集合是 2026-11-18 KO_24V 语义修订后**唯一**决定硬件供电的
* 软件判据,写错了两种表现都不报错,且都要万用表才看得出来:
* · 混进 LED 位(bit4 KO_LED1 / bit5 KO_LED2 / bit9 KO_LED3):操作员在屏上点一盏
* 指示灯,硬件上就多了一路继电器线圈带电——台架表现为"LED 点亮顺带带电继电器线圈",
* 现场则是一次谁都没有命令过的出口供电;
* · 混进 bit6 自身:ioboard_do_write() 里 (relay & IOBOARD_DO_RELAY_MASK) 恒非零,
* PF4 上电即自锁成常供电,连写 0 也"全释放"不掉。
* 期望值 0x18F = bit0|bit1|bit2|bit3|bit7|bit8 的合值(KO6/TRIP/ERT/CLZ/KO4/KO5 六路),
* 逐项对应 ioboard.h 里 IOBOARD_DO_RELAY_MASK 的宏体;LED 三路是 0x010/0x020/0x200、
* bit6 是 0x040,均不在其中。换器件/换板若改了这张表,本用例先红,逼着改的人同步
* README 与板级套件的期望值。
*/
static void do_relay_mask_covers_only_relay_channels(void)
{
const uint16_t led_bits = (uint16_t)(IOBOARD_DO_KO_LED1 | IOBOARD_DO_KO_LED2
| IOBOARD_DO_KO_LED3);
CHECK(IOBOARD_DO_RELAY_MASK == 0x18FU,
"IOBOARD_DO_RELAY_MASK == 0x18F (bit0 KO6 | bit1 TRIP | bit2 ERT | bit3 CLZ | bit7 KO4 | bit8 KO5)");
CHECK((uint16_t)(IOBOARD_DO_RELAY_MASK & IOBOARD_DO_KO_24V) == 0U,
"RELAY_MASK excludes bit6 itself (else PF4 self-latches and never releases)");
CHECK((uint16_t)(IOBOARD_DO_RELAY_MASK & led_bits) == 0U,
"RELAY_MASK excludes the three KO_LED channels (an LED must not energise relay coils)");
CHECK((uint16_t)(IOBOARD_DO_RELAY_MASK | led_bits | IOBOARD_DO_KO_24V)
== IOBOARD_DO_MASK_ALL,
"RELAY_MASK + 3 LED bits + bit6 partition all 10 physical DO bits (nothing lost, nothing added)");
}
/*
* 路数常量:一片 74HC165 = 8 位开入;开出是 10 个**物理位**(对外可控 9 路,
* bit6 是自动供电使能)。为何值得测:组装函数的移位用
* IOBOARD_DI_COUNT 推导,若有人为"将来两块级联 16 路"把它改成 16,返回值仍是 uint8_t,
* 移位会溢出为未定义行为;开出 10 路则是为钉住新增六路后的总数,退回 4 路即红。
*/
@@ -293,7 +334,8 @@ static void counts_match_one_74hc165(void)
{
CHECK(IOBOARD_DI_COUNT == 8, "IOBOARD_DI_COUNT is 8 (one 74HC165)");
CHECK(IOBOARD_DI_MASK_ALL == 0xFFU, "IOBOARD_DI_MASK_ALL covers all 8 DI bits");
CHECK(IOBOARD_DO_COUNT == 10, "IOBOARD_DO_COUNT is 10 relay outputs");
CHECK(IOBOARD_DO_COUNT == 10,
"IOBOARD_DO_COUNT is 10 physical outputs (9 controllable + auto 24V enable)");
}
/* ---------------------------------------------------------------------------
@@ -875,6 +917,7 @@ int main(void)
do_polarity_macros_are_complementary();
do_active_level_matches_documented_high();
do_semantic_bits_are_distinct_and_dense();
do_relay_mask_covers_only_relay_channels();
counts_match_one_74hc165();
/* 三、开入极性(与第二节对称) */