Files
STM32F4-Base/Drivers/BSP/IOBOARD
wandering1 518e12f200 chore(gate): cppcheck 受检范围与编码规范对齐,存量 30 条 style 清零
起因:装真 cppcheck 2.21.0 后本钩子暴露 106 条命中,其中 76 条本就不该被扫。
cppcheck 与 coding-standard 两个钩子的注释都自称「范围一致」,实际各漏一块,
而本钩子此前从未真正跑起来(C:\cppcheck\cppcheck.exe 是坏 zipapp,进程根本没起,
--error-exitcode 对「没跑起来」不生效),所以没人发现。两轮合计 834 条命中里
802 条是「不该被扫的」,真问题被完全淹没。

一、范围对齐(106 → 30)
cppcheck 钩子 exclude 补三条 104 上游前缀:App/iec60870/common/、
App/iec60870/104/business/、App/iec60870/104/IEC104[_.]。三条只豁免上游库
尚未改造的部分,我们自己的小写适配文件(iec104_core/net_mcu/source/comm)仍受检。
不能改写成祖先目录 App/iec60870/,那会把适配层一起豁免。
test-cppcheck 钩子排除 test/host/iec104_netmcu/results(按 check_static_selftest.py
生成的自检变异体是故意写坏的副本,不是被测代码)。

二、剩余 30 条直接改代码清零(未建抑制基线)
逐条核过:cppcheck 判对了,它们违反本仓 docs/代码规范/嵌入式C语言代码规范_V1.0.md
§6.1.1「变量应在使用前声明,并尽可能在靠近使用的地方声明」。仓内对「永久免检」
有明确反对立场(coding-standard 的 104 排除注释写着「改完必须删掉这三行,否则等于
自建代码永久免检」),故不建抑制基线,直接改对:
- iec104_comm.c:4 处 v > IEC104_COMM_CA_MAX / PORT_MAX 删除。上界 65535 是
  uint16_t 类型极限,比较恒为假(compareValueOutOfTypeRangeError);宏本身保留,
  App/app/ui_data_feed.c 的 UI 范围提示仍要用它表达合法带上界。
- ioboard_bits.c:删 && (i < IOBOARD_DI_COUNT),外层 for 已限定,且它在取下标之后才判。
- iec104_source.c:三处 ifdef 哑变量(a/p/raw、e/i/b/raw/p/element、i/m/g/valid)
  把声明搬进各自编译档内,删掉全部 (void)x 抑制句——正是这些抑制句让 cppcheck
  认为「读了未赋值变量」(unassignedVariable)。另 remote_lookup / parameter_config
  的 i/n/p、g/m 就近声明。
- iec104_net_mcu.c:Listen 的 uint32_t i、Wait 的 listen_slot/client_slot/sock
  移进各自分支;sock 加 const。
- net_socket.c:net_pending_bytes 的 p_sock 加 const。
- ui_task.c:ui_task_wave_load_head 的 FRESULT fr 移进 if (ofr == FR_OK) 块。
- ioboard_di.c:ioboard_di_snap_read 的 s1/s2 移进重试循环。
- ui_page_yx.c:pg_refresh 的 dio_row 移进板级开入开出区分支。

三、实证
- cppcheck 钩子:106 → 30 → 0,Passed。
- 反证钩子没被排除条款吞掉:注入 variableScope 探针 → 立即报出
  variableScope + unreadVariable 两条;恢复后重新 Passed。
- Keil BUILD_OK 0 errors 0 warnings,Program Size 逐项不变
  (Code=365896 RO=48336 RW=2736 ZI=173104)=本轮全是纯排版,零目标码变化。
- test-cppcheck Passed(0 命中)。
- 全量 manual 阶段 52 根钩子全绿、0 失败。
- host 套件:iec104_comm 50/50、ioboard 131/131、iec104_dtu 7 tests OK、
  iec104_serv 50/50、net_socket 683/683、sys_clock 111/111、iec104_netmcu 17/17、
  net_events 34/34、net_listener 34/34、net_pending 43/43、net_select 22/22、
  ui_sink 17/17、lftpd 35/35、lftpd_inet 29/29、time_sync 33/33。
- UI golden:77 个页面 + 待机水位 + rtlive 全通过。
- net-handle:495 文件 PASS 0 违规。
- 裁剪档 IEC104_SOURCE_NO_VALUE_STORE 隔离编译 rc=0 无 error/warning
  (声明搬进 #else 后必须保证该档仍成立)。
- BOM:ui_page_yx.c / ui_task.c 编辑后 BOM 被剥,已补回,check_bom_drift rc=0。

四、顺带修掉的两处真实漏项
- ram_baseline.py 的 subsystem_of() 前缀表漏 ioboard:App/util/ioboard_di.c
  编出的 ioboard_di.o(4 B)一直静默算进「其它」而非「应用」,台账配额表看不见。
- 内存台账回填:a2242b73(IEC104_Net_Listen 修复)是上次回填 d2c328e8 之后的
  代码改动,内存数字从未重测,mem-numbers / mem-budget 两根钩子因此红。
  本轮按当前权威构建重新回填(Code=365896,相对 d2c328e8 的 365924 减 28 B)。

五、文档
docs/代码规范/cppcheck使用说明.md:
- §4.2 新增「安装陷阱:cppcheck.exe 可能是假 zipapp」——识别方法、根因、
  2.21.0 正确装法(MSI 截断与续传、管理式解包、必须整目录)、为什么不用 pip 版、
  教训(Failed 里没有命中/条数/文件名就当工具没跑起来)。
- §4.5 修正「Drivers/BSP/UI/ 不检查」的过期说法——它在本仓是手写 UI 页面代码
  (库在 Lib/lvgl/),实测本钩子直接报了 ui_page_yx.c。
- §4.6 新增两根钩子的范围关系表:共享 11 项共同核心,各自另有小块豁免
  (cppcheck 多排 test/,coding-standard 多排 Src/ Inc/ nand_ftl),是设计意图
  不是漏配;改共同核心必须两边一起改。
2026-11-19 14:00:29 +08:00
..

开入开出板 BSP(IOBOARD)

一句话:这个驱动让板上的 74HC165 移位寄存器能够被读出 8 路开入,让 10 路物理开出(其中对外可控 9 路)能够被整组写入;它只做引脚与时序,不做任何业务判断。bit6 KO_24V 是继电器供电使能,由驱动自动管理,不是对外输出。


1. 器件与接线

1.1 MCU 侧引脚(来源:STM32F407-Demo.ioc → Inc/main.h → Src/gpio.c)

功能 引脚 main.h 宏 模式 CubeMX 初值 速度
74HC165 装载 SH/LD PC2 HC165_LD_Pin 推挽输出 SET(移位模式) VERY_HIGH
74HC165 时钟 CLK PC3 HC165_CLK_Pin 推挽输出 RESET(时钟低) LOW
74HC165 数据 QH PE3 HC165_IN2_Pin 输入 — —
出口 0(KO6) PC14 KO6_Pin 推挽输出 RESET LOW
出口 1(TRIP) PF0 TRIP_LED_Pin 推挽输出 RESET LOW
出口 2(ERT) PF1 ERT_LED_Pin 推挽输出 RESET LOW
出口 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
供电使能(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

PE2(旧名 IN_D4)与 PE4(旧名 IN_E4)是命名残留,硬件上没有对应信号,本驱动完全不碰。

⚠ 改动引脚只能走 CubeMX(改 .ioc 后重生成)。Src/gpio.c 是生成文件,手改会在下次重生成时被覆盖。 引脚换脚/换端口时,软件侧唯一要动的地方是 ioboard.c 顶部的「引脚绑定」区;ioboard.h 不用动。

1.2 74HC165 侧接法

  • 两块 74HC165 级联,共用 CLK(PC3)与 SH/LD(PC2)。
  • 但只有一块芯片的 QH 回到了 MCU(PE3)。第二块的 QH → 第一块的 SER 链路或引出线在板上缺失, 所以本驱动把一次 8 拍读到的数据当作一块芯片的 8 位开入(A..H 通道)。
  • 这就是「已知限制」第一条的来源,见 §5。

2. 时序原理与数据手册依据

2.1 四条从数据手册直接得到的事实

出处:TI SNx4HC165 Rev.H(SN74HC165 / SN54HC165)第 7 节 Detailed Description 与 7.3 节 Functional Modes 真值表; ST M74HC165 与 Nexperia 74HC165 的功能表与之相同。本驱动按 TI 版本建模。

  1. SH/LD = 低 → 异步并行装载(A..H 八个输入进寄存器),与时钟无关。
  2. SH/LD = 高 → 移位模式;每个 CLK 低到高沿使数据向 QH 方向移动一位。
  3. 移位方向是 A → B → … → H → QH,即 H 离输出最近。第一个时钟沿之前 QH 上已经是 H, 第 8 个沿之前才是 A。所以 8 次采样的顺序是 H,G,F,E,D,C,B,A,而接口要求 A 在 LSB。
  4. 手册明确要求:CLK 与 CLK INH 在 SH/LD 由低升高之前必须已经是低电平 (原文:"...CLK and CLK INH should be LOW before the LOW-to-HIGH transition of SH/LD to prevent shifting the data when SH/LD goes HIGH.")。 违反它的症状不是报错,而是整串数据偏一位。

2.2 为什么是这个顺序

CLK  ‾‾|____|‾‾‾‾|____|‾‾‾‾|____|‾‾‾‾|____|‾‾‾‾ ... 共 8 个上升沿
LD   ‾‾‾‾‾‾‾\________________________/‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
QH   ======X= 装载后先是 H  ====== 上升沿后 G ==== F ==== ... ==== A
          ↑采样点(每次上升沿之前读)
  • 先让 CLK 低:满足上面第 4 条。代码里这一步由 ioboard_check_idle() 保证,并在时序函数里再显式写一次, 使「CLK 低」与「LD 拉低」在代码顺序上紧邻。
  • LD 拉低 → 短暂延时 → LD 拉高:装载是异步的,延时只为满足最小脉宽 tw(SH/LD low)。
  • 每次先读 QH,再打上升沿:手册时序图里数据在上升沿之前已稳定;上升沿后 QH 要过一个 tpd 才变成新值。 若改成「先打沿再读」,第 8 个沿之后读到的会是 SER 端的内容而不是 A——这是最经典的「多读一位」错误。

2.3 延时取值与出处(ioboard.h 的 IOBOARD_HC165_*_US)

宏 取值 手册原值(最慢列:VCC 2 V / −40…85 °C) 余量
IOBOARD_HC165_LOAD_PULSE_US 1 µs tw(SH/LD low) 120 ns 8×
IOBOARD_HC165_LOAD_SETTLE_US 1 µs tpd(SH/LD → QH) 225 ns 4×
IOBOARD_HC165_CLK_PHASE_US 1 µs tw(CLK high or low) 120 ns 8×
IOBOARD_HC165_QH_SETTLE_US 1 µs tpd(CLK → QH) 225 ns 4×

按最慢电压/温度列取值,所以换 VCC 或温区都不必重算。 一次完整读取的上界 IOBOARD_DI_READ_MAX_US = 1 + 1 + 8×(1+1+1) = 26 µs。

关于 HC165_CLK 的速度是 LOW(≈2 MHz 上限)

这不是缺陷,也不需要改。SPEED_FREQ_LOW 在 3.3 V / ~50 pF 负载下的边沿约 500 ns 量级, 驱动每一位的实际周期是 2 µs 以上(上升 1 µs + 下降 1 µs),带宽利用率不到 25%,边沿永远不会成为瓶颈。

若将来确实需要提速:去 CubeMX 把 PC3 改成 MEDIUM/HIGH 再重生成,不要改 Src/gpio.c; 然后重算上表四个宏,并复核 26 µs 这个上界仍满足调用方的节拍。


3. 位序算例(人工核对依据)

设只有 A 与 H 两路有信号,其余 6 路无信号:

  • 第 1 次采样读到 H = 1,第 2..7 次读到 G..B = 0,第 8 次读到 A = 1;
  • 于是读取序列 bits = [1,0,0,0,0,0,0,1];
  • 组装规则 bit(7-i) = bits[i]:bits[0](H)→ bit7,bits[7](A)→ bit0;
  • 结果 mask = 0x81(bit7 与 bit0 为 1)。

另一条非对称算例(对称图样不含位序信息,不能用):

  • bits = [1,0,1,0,1,0,1,0] → 为 1 的是第 1/3/5/7 次采样 = H, F, D, B → 落在 bit7/5/3/1 → 0xAA;
  • 其反序 [0,1,0,1,0,1,0,1] → G, E, C, A → 落在 bit6/4/2/0 → 0x55。

历史教训:这组输入在评审中先后被算成 0xA5、0x5A、0xAA。 正确值是 0xAA;0xA5/0x5A 不是任何实现的输出,引用前请手推。 (顺带:[1,0,1,0,1,0,1,0] 是回文图样,反序不变,所以它根本不含位序信息——正因如此才要配上 0x55 那一条成对断言。)


4. 软件结构

4.1 分层

业务层(defaultTask / 未来 104 / UI)        ← 判据、去抖、互锁,全在这里
        │  只看 ioboard.h 的 4 个函数 + 位宏
        ▼
ioboard.c        ← 引脚 + 时序 + 极性转换 + 影子寄存器(唯一 include HAL/FreeRTOS 的文件)
        │  只调 ioboard_di_assemble()
        ▼
ioboard_bits.c   ← 纯逻辑:位序组装。只依赖 <stdint.h>,主机侧可单测

为什么位序要单独成文件:位序错一位不会报错,只表现为「开入状态差一位」—— 在台架上这与「线接错一位」完全同形,无法归因。把它剥离成纯函数,主机侧用假数据一条条钉住; 台架上剩下的就只可能是物理层问题。

4.2 接口

函数 一句话职责 mask 语义
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 原子);对外可控 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」必须可区分,判断权留给上层。 上层不能把失败当成「全 0」上报(否则故障会被伪装成「信号消失」)。
  • ioboard_di_read 自动判别任务/ISR 上下文(读 SCB->ICSR.VECTACTIVE)。 调度器尚未启动时(初始化阶段)自动改用 __disable_irq(),因为 taskENTER_CRITICAL() 在 taskSCHEDULER_NOT_STARTED 时是空操作。

4.3 极性:唯一可改点

ioboard.h:

#define IOBOARD_DO_LEVEL_ACTIVE     (1U)    /* 1 = 高电平吸合;若硬件实测相反改成 0U */
#define IOBOARD_DO_LEVEL_RELEASE    ((IOBOARD_DO_LEVEL_ACTIVE) ? 0U : 1U)

改极性只改 IOBOARD_DO_LEVEL_ACTIVE 这一行:调用方永远只说「哪一路吸合」, 从不手写 HIGH/LOW;ioboard_init() 的「上电全释放」读的也是这个宏,所以不需要另改初始化。

当前取值依据:用户口径「高电平 = 继电器吸合」。若原理图显示相反,改这一行即可。 ⚠ 这个取值尚未经原理图核对、也尚未上板验证,见 §5 第一条。

4.4 构建注册

  • ioboard_bits.c 与 ioboard.c 必须一起进构建:前者提供 ioboard_di_assemble() 的定义, 后者调用它;缺任何一半都会链接失败(undefined symbol)。
  • Keil 工程:MDK-ARM/STM32F407-Demo.uvprojx 的 Drivers/BSP 组已注册两个文件, IncludePath 已加 ../Drivers/BSP/IOBOARD。
  • 模拟器端不编驱动:simulator/CMakeLists.txt 不加,理由与本仓既有硬件驱动(CH395F / TPAFE5160 / RS485)一致—— 它们已在 scripts/check_registration.py 的 SIM_EXEMPT 名单里逐个点名「模拟器无对应」。 本驱动的纯逻辑部分由 test/host/ioboard 的主机侧单测直接编译覆盖,所以不进模拟器不形成覆盖空窗。
  • 只想要纯逻辑时(主机侧单测、上层去抖模块):只 include ioboard_bits.h,不要 include ioboard.h ——后者会拉进 bsp_err.h,而且不提供任何纯函数。

5. 上板验证步骤

第 0 步:先看驱动自己报什么

上电后立刻调用一次 ioboard_init(),检查返回值:

返回值 含义 先查什么
BSP_OK 引脚模式正确、静止态确认通过 继续第 1 步
BSP_ERR_STATE PC2/PC3/PE3 模式不对,或 DWT 不可用,或主频换算不符,或引脚电平与期望不符 用调试器读 GPIOC->MODER / GPIOE->MODER,确认 PC2=01、PC3=01、PE3=00;读 DWT->CTRL 确认 CYCCNTENA=1

第 1 步:验证开入逐路对应关系(不需要示波器)

目标:确认「bit0 = A」这条不是纸面推导。

  1. 上电后反复调用 ioboard_di_read(),记下基线 mask(无信号时通常全 0 或全 1,取决于板上端子接法)。
  2. 按板子的开入端子定义,把第 1 路(对应 A)短接到该板定义的"ON"电平(通常是 IN 与 COM 短接,或加 24 V),依次只改一路。
  3. 每次改一路,读一次 mask,期望只有对应的 bit 翻转:
    • 第 1 路 → bit0 翻转;第 2 路 → bit1;……第 8 路 → bit7。
  4. 若发现整体错一位(比如第 1 路动 bit1),那不是软件位序问题(位序已被主机侧单测钉死), 而是板上 A..H 与端子的映射顺序与预期不同——查接线图,不要改软件。

没有万用表也能做:用一根杜邦线手动短接 PE3 到 GND/3V3 不能验证通道对应,只能验证数据线通路。 通道对应必须动真实端子。

第 2 步:验证开出极性与逐路动作(万用表 / 耳朵)

先验极性——这一步决定 IOBOARD_DO_LEVEL_ACTIVE 的取值是否正确:

  1. ioboard_init() 之后,10 路应全部释放:万用表量出口端子(常开触点)应为断开,继电器无声。
  2. 调 ioboard_do_write(IOBOARD_DO_KO6)(只有第 0 路),期望只有出口 0 的继电器动作("嗒"一声)。
    • 同时用 ioboard_do_read_level() 读引脚电平:第 0 路应为 1(与 IOBOARD_DO_LEVEL_ACTIVE = 1U 一致)。
    • 若继电器不动、引脚电平也变了 → 极性反了,把 IOBOARD_DO_LEVEL_ACTIVE 改成 0U。
    • 若继电器吸合了但初始化后不释放(上电就吸合)→ 同样说明极性反了,立即改宏后重测, 这属于安全问题,不要带着它继续做其它测试。
  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 步:有示波器时看时序

把探头接 PC2(LD) 与 PC3(CLK),触发在 LD 下降沿。期望看到:

  • LD 先为高;出现一个低脉冲(宽 1 µs 量级),随后回到高并保持;
  • LD 回到高之后,CLK 才开始第一组 8 个脉冲,每个高、低各 1 µs 量级;
  • LD 由低升高的那一刻,CLK 必须是低电平(这是 §2.1 第 4 条),放大看 LD 上升沿处 CLK 应为 0;
  • 整段从 LD 下降沿到第 8 个 CLK 下降沿约 26 µs。

同时把第三个探头接 PE3(QH):第一个 CLK 上升沿之前 QH 上应是第 8 路(H)的电平; 每个上升沿之后约 30~225 ns 内 QH 翻转。

⚠ 本驱动在读取全过程持有 FreeRTOS 临界区(关 configMAX_SYSCALL_INTERRUPT_PRIORITY 以下中断), 所以示波器上会看到这段时序连续、无中断插入——这正是设计意图。若看到中间被插入了一段 别的波形,说明有人在临界区里做了长操作,去查那个地方。


6. 已知限制

  1. 第二块 74HC165 读不到:两块级联但第二块的数据输出线在板上没接回 MCU,所以只能读 8 路开入。 软件侧适配点:ioboard.c 的 ioboard_di_shift() —— 若飞线/改板后要读 16 位, 在那里把循环次数从 IOBOARD_DI_COUNT(8)改为 16,并相应调整 ioboard_bits.c 的组装与 IOBOARD_DI_MASK_ALL。不是现在该做的事,记在此处以免将来重复推导。
  2. 10 路开出分属三个端口(GPIOC×2、GPIOF×7、GPIOE×1),按 bit 顺序形成 C→F→C→E 四段, 整组写最多 4 次 BSRR 写,段间不同步性变差;每次写内部原子,段间只会看到「旧态 → 新态」的跃迁, 不会出现目标态以外的组合。若将来业务要求 10 路严格同一时刻,需要硬件把它们挪到同一端口。
  3. PC15(KO5)备份域限流、仅信号位:该脚位于备份域,驱动能力 ±3 mA,本驱动只把它当普通信号位, 不用于供电或功率输出。
  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() 读的是软件影子寄存器(「我上次让它是什么」; bit6 例外,是驱动按合成规则给出的供电状态,见第 4 条),不是「继电器现在真的动没动」。 后者只能靠辅助触点或万用表。
  7. PE2 / PE4 是命名残留:硬件无信号,本驱动不配置、不读取。若 CubeMX 里还留着它们, 那是 IN_D4 / IN_E4 的旧配置,不影响本驱动。
  8. 开入位序仅部分验证:8 路开入与板级丝印 DI_ADI_H 的对应关系按移位顺序推定, 2026-11-16 已在 C 通道上实测确认(信号接入 C 路 → 屏上只有 DI_C 显示「合」, 其余 7 路不动),即 A 在 LSB、H 在 MSB 的位序与通道隔离都正确。 其余 7 路尚未逐路验证;若某一路接反,症状是「该路动作时屏上亮的是另一路」。 UI 侧的遥信页 Drivers/BSP/UI/ui_page_yx.c 文件头已改为引用本节(引第 5、89 条),不再复述。
  9. 开入是电平检测,不是通断检测(用户口径,2026-11-16): 本板开入测量的是输入信号有没有 24V 高电平,「导通」本身是测不出来的—— 外部信号必须提供 24V,仅仅把回路接通而没有电平,开入不会动作。 板上是反相链路:有 24V 输入 → 光耦导通 → 74HC165 的 A..H 引脚被拉低。 这个反相由 ioboard.h 的 IOBOARD_DI_LEVEL_ACTIVE(当前 0U = 低电平有效)在 ioboard_di_read() 返回前转换,所以上层看到的 mask 里 1 恒表示「有信号」, 消费者不需要各自记住「0 才是有信号」。 实测依据:IOBOARD_DI_LEVEL_ACTIVE 取 1U 时屏上全灭、取 0U 时对应那一路亮。

7. 修改记录

日期 作者 变更
2026-11-16 王建锋 创建:74HC165 装载/移位时序、4 路光耦继电器整组写、位序纯逻辑拆分
2026-11-18 王建锋 扩展:新增 6 路普通开出,扁平 10 路、mask 改 uint16_t