Files
STM32F4-Base/Drivers/BSP/IOBOARD/ioboard.h
T
wandering1 6e0755f971 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.
2026-11-18 19:34:47 +08:00

326 lines
20 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#ifndef IOBOARD_H
#define IOBOARD_H
/*
* 模块名称:开入开出板 BSP(74HC165 开入 + 光耦继电器开出)
* 模块功能:把「板上的引脚与时序」翻译成两件事——读 8 路开入、整组写 10 路开出。
* 10 路是**物理位**:对外可控只有 9 路,bit6 KO_24V 是给其它 KO 供电的
* 使能信号,由驱动按继电器类通道是否吸合自动管理(写入被忽略)。
* 只回答「让硬件动起来并如实汇报」,不回答「该不该动」:
* 不做过流判据、不做互锁策略、不碰 IEC 104、不建 RTOS 任务。
* 适用平台:STM32F407ZGT6 + FreeRTOS(裸机不可用:临界区走 FreeRTOS 宏)
* 作者:王建锋
* 创建日期:2026-11-16
* 修改记录:
* 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 宏
* → Src/gpio.c 的 MX_GPIO_Init()。本驱动只引用 main.h 的宏,不写死 GPIO_PIN_x。
* V0.1 实测(2026-11-16 核对):
* HC165_LD (PC2) 输出 PP 初值 SET(= 移位模式)+ 速度 VERY_HIGH
* HC165_CLK (PC3) 输出 PP 初值 RESET(= 时钟低) + 速度 LOW
* HC165_IN2 (PE3) 输入,无上下拉
* KO6 (PC14) 输出 PP 初值 RESET
* TRIP_LED (PF0) 输出 PP 初值 RESET
* ERT_LED (PF1) 输出 PP 初值 RESET
* CLZ_LED (PF6) 输出 PP 初值 RESET
* KO_LED1 (PF2) 输出 PP 初值 RESET
* KO_LED2 (PF3) 输出 PP 初值 RESET
* KO_24V (PF4) 输出 PP 初值 RESET(继电器供电使能,自动)
* KO4 (PF5) 输出 PP 初值 RESET
* KO5 (PC15) 输出 PP 初值 RESET(备份域 ±3 mA,仅作信号位)
* KO_LED3 (PE6) 输出 PP 初值 RESET
* PE2(IN_D4) / PE4(IN_E4) 是旧命名残留,硬件上无信号,本驱动**完全不碰**。
*/
#ifdef __cplusplus
extern "C" {
#endif
#include <stdint.h>
#include "bsp_err.h"
/*
* 纯逻辑层(ioboard_bits.h / ioboard_bits.c)与硬件层(本头 / ioboard.c)**成对进构建**:
* ioboard.h 只 include ioboard_bits.h 取纯函数声明与常量;
* ioboard_di_assemble() 的**定义**在 ioboard_bits.c,链接时必须有它,
* 否则 ioboard.c 与任何调用方都会 undefined symbol。
* 只想要纯逻辑(主机侧单测、App 侧去抖模块)时:include ioboard_bits.h,
* 并把 ioboard_bits.c 编进链接即可,不需要也不应该 include 本头(本头会拉进 bsp_err.h)。
*/
#include "ioboard_bits.h"
/* ======================== 宏定义:引脚绑定 ======================== */
/*
* 引脚**编号**(PC2 / PC3 / PE3 / PC14 / PF0 / PF1 / PF6 / PF2 / PF3 / PF4 / PF5 /
* PC15 / PE6)只作说明与追溯,
* 真正的 <Label>_Pin 宏引用放在 ioboard.c 里——因为那些宏展开后是
* HC165_LD_GPIO_Port 这类 main.h 符号,一旦写进本头文件,任何 include ioboard.h
* 的上层文件(defaultTask、去抖模块、主机侧单测)就都被迫先 include main.h。
* 那样的后果不是编译错误而是「上层代码必须懂 MCU」——分层就此破掉。
*
* SH/LD = HC165_LD_Pin (PC2)
* CLK = HC165_CLK_Pin (PC3)
* QH = HC165_IN2_Pin (PE3)
* DO0 = KO6_Pin (PC14)
* DO1 = TRIP_LED_Pin (PF0)
* DO2 = ERT_LED_Pin (PF1)
* DO3 = CLZ_LED_Pin (PF6)
* DO4 = KO_LED1_Pin (PF2)
* DO5 = KO_LED2_Pin (PF3)
* DO6 = KO_24V_Pin (PF4)
* DO7 = KO4_Pin (PF5)
* DO8 = KO5_Pin (PC15,备份域 ±3 mA,仅作信号位)
* DO9 = KO_LED3_Pin (PE6)
*
* 引脚改版(换脚/换端口)的唯一改点在 ioboard.c 顶部的引脚绑定区,本头文件不用动。
*/
/*
* 每路语义位(软件 mask,1 = 吸合)。
* 名字来自板级丝印/网络标号(KO6 / TRIP_LED / ERT_LED / CLZ_LED / KO_LED1 / KO_LED2 /
* 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 */
#define IOBOARD_DO_ERT ((uint16_t)(1U << 2)) /* DO2,PF1 */
#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_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))
/* ======================== 宏定义:极性(唯一可改点) ======================== */
/*
* 开出极性:软件 mask 的 1 = 继电器吸合,硬件上「吸合」对应 GPIO 输出哪个电平,只由这一行决定。
*
* 当前取值 = 高电平有效,依据:用户口径(2026-11-16)「高电平 = 继电器吸合」。
* 内部结构推断(**未核原理图,仅作注释留档**):CubeMX 给 4 路的初值都是 RESET,
* 若低电平才是吸合,上电即 4 路全吸合——这不符合「上电全释放」的安全默认,
* 所以大概率是 GPIO 高 → 光耦二极管导通 → 继电器线圈得电。
* ⚠ 上板第一步必须用万用表验极性(README 的「上板验证」第 2 步),验反了就改这一行。
*
* 改这一行要注意:ioboard_init() 的「上电释放」会把**释放电平**写下去,
* 所以改极性无需另改初始化——它读的就是本宏。
*/
#define IOBOARD_DO_LEVEL_ACTIVE (1U) /* 1 = 高电平吸合;若硬件实测相反改成 0U */
/* 由上面的极性推出两档动作电平,供 .c 内部使用;不要在其它地方再写一遍高低 */
#define IOBOARD_DO_LEVEL_RELEASE ((IOBOARD_DO_LEVEL_ACTIVE) ? 0U : 1U)
/*
* 开入极性:软件 mask 的 1 = 该路"有信号"(存在 24V 高电平输入),
* 而 74HC165 引脚上读到什么电平才算"有信号",只由这一行决定。
*
* 当前取值 = **低电平有效**,依据:用户口径(2026-11-16)"开入测量的是输入信号有没有
* 24V 高电平;导通仅仅导通无法测量出来。当有高电平输入,74HC165 引脚为低电平"。
* 即板上是**反相**链路:外部 24V 到来 → 光耦导通 → 74HC165 的 A..H 引脚被拉低。
*
* 为什么极性在本层转换、而不是留给页面:`ioboard_di_assemble()` 只做位序反转
* (H,G,...,A → A 在 LSB),电平原样输出。若这里不转换,"有信号"这个语义就要由
* 每个消费者各自记住"0 才是有信号"——读遥信页的人按 1 理解、读状态页的人按 0 理解,
* 两处各错一次都不报错。极性只在一处定义、一次转换,上层只看 mask 的 1/0。
*
* 改这一行要注意:本宏作用在 `ioboard_di_read()` 的返回值上,
* 所以去抖模块、UI 快照、任何 mask 消费者都跟着自动变,无需另改。
* ⚠ 极性若与硬件不符,症状是"屏上每一路的合/分全反",不是无序乱跳。
*/
#define IOBOARD_DI_LEVEL_ACTIVE (0U) /* 0 = 低电平表示有信号;若硬件实测相反改成 1U */
/* 由上面的极性推出一位"有信号"的判据,供 .c 内部使用;不要在其它地方再写一遍 */
#define IOBOARD_DI_LEVEL_IDLE ((IOBOARD_DI_LEVEL_ACTIVE) ? 0U : 1U)
/* ======================== 宏定义:时序(含单位,出处即规格) ======================== */
/*
* 全部时序依据 TI SN74HC165 数据手册(SNx4HC165 Rev.H,第 6.10 节 Timing Requirements),
* 取 VCC = 4.5 V 列(本板 74HC165 由 3.3 V 供电时按最慢的 2 V 列取,见下)。
*
* 手册原值(ns)。左为 25 C 列,右为 -40..85 C(SN74)最坏列,取后者:
* 25 C(2V/4.5V) -40..85 C(2V/4.5V)
* tw SH/LD 低脉冲宽度 120 / 24 120 / 24
* tw CLK 高或低脉冲宽度 120 / 24 120 / 24
* tsu SH/LD 高 在 CLK 上升沿前 120 / 24 120 / 24
* th PAR 数据 在 SH/LD 下降沿后 5 / 5 5 / 5
* tpd SH/LD 到 QH 225 / 30 225 / 45
* tpd CLK 到 QH 225 / 30 225 / 45
*
* 本驱动**不依赖具体电压**,一律按最慢的 2 V / 全温区列(120 ns、225 ns)再放大取整,
* 所以换 VCC 或换温度区间都不必重算:
* ├─ 装载脉冲:手册 120 ns → 取 1 us(8 倍余量);
* ├─ 等待装载完成:SH/LD↓ 之后 QH 要过一个 tpd(2 V 列 max 225 ns),取 1 us(4 倍余量);
* ├─ 时钟高/低相位:手册 120 ns → 取 1 us(8 倍余量);
* └─ 采样延时:CLK↑ 之后 QH 要过 tpd(2 V 列 max 225 ns),取 1 us 再读(4 倍余量)。
*
* ⚠ 这与 HC165_CLK 引脚在 CubeMX 里被配成 GPIO_SPEED_FREQ_LOW 是一致的、不是缺陷:
* LOW 档在 3.3 V / ~50 pF 负载下约 2 MHz 上限(t_rise+t_fall 约 500 ns 量级),
* 而本驱动一位要 >2 us(见下面的 IOBOARD_DI_READ_MAX_US),带宽利用率不到 25%。
* 如果将来要提速,**别改 gpio.c**——去 CubeMX 把 PC3 速度改成 MEDIUM/HIGH 再重生成,
* 然后在这里重算四个 *_NO 取值,并复核 IOBOARD_DI_READ_MAX_US 仍满足调用方的节拍。
*/
/* 单次装载时 SH/LD 保持低的时长(us):手册 tw(SH/LD low) 120 ns @2 V → 8 倍余量 */
#define IOBOARD_HC165_LOAD_PULSE_US 1U
/* SH/LD 由低升高的时刻:必须已经满足 tsu(SH/LD high before CLK↑) 与 tw(SH/LD low) */
#define IOBOARD_HC165_LOAD_SETTLE_US 1U
/* 每个时钟相位(高 / 低)的保持时长(us):手册 tw(CLK high or low) 120 ns @2 V → 8 倍余量 */
#define IOBOARD_HC165_CLK_PHASE_US 1U
/* CLK 上升沿之后到读 QH 的等待(us):躲开手册 tpd(CLK→QH) 2 V max 225 ns,留 4 倍余量 */
#define IOBOARD_HC165_QH_SETTLE_US 1U
/*
* ⚠ 关键前提:上面四个宏是**微秒**,而 DWT 只有**周期**。
* 微秒 → 周期的换算系数在这里写死一次(168 MHz 主频,168 周期 = 1 us,
* 与 App 侧 task_prof.h 的同一口径)。
* 主频改了不会报错,只会让所有延时按比例偏——所以 .c 里在运行期用
* SystemCoreClock 复核一次这个值,偏差超 1 % 就直接把 DI 读操作判成 BSP_ERR_STATE,
* 宁可让开入报错,也不让「延时悄悄变成 1/2」这种静默错误过夜。
*/
#define IOBOARD_CYCLES_PER_US 168U /* = SystemCoreClock / 1000000 */
/*
* 一次 ioboard_di_read 的最坏耗时(us)。用于让调用方判断能否放进它的节拍里,
* 以及留给「必须在临界区里」这句约定的量化依据:
* = 装载脉冲 1 + 装载等待 1 + 8 × (采样等待 1 + 时钟高 1 + 时钟低 1) = 26 us
* 这远小于 1 kHz tick 的 1000 us,关中断 26 us 不会让任何一方丢 tick。
*/
#define IOBOARD_DI_READ_MAX_US (IOBOARD_HC165_LOAD_PULSE_US + \
IOBOARD_HC165_LOAD_SETTLE_US + \
(IOBOARD_DI_COUNT * \
(IOBOARD_HC165_QH_SETTLE_US + \
(2U * IOBOARD_HC165_CLK_PHASE_US))))
/* ======================== 函数声明 ======================== */
/*
* 函数功能:初始化开入开出驱动(影子寄存器复位 + 静止态确认 + 上电全释放)
* 入口参数:无
* 返回值:BSP_OK - 初始化完成,10 路开出已处于释放态(含 PF4 供电使能不使能)
* BSP_ERR_STATE - 静止态确认失败(回读到的 SH/LD 或 CLK 电平与预期不符)
* 限定条件:必须在 MX_GPIO_Init() 之后调用(推荐在 app_main_init 里,
* 与其它 BSP 的初始化一起,且**必须在任何业务代码写开出之前**)
* 函数说明:
* 一、**不重复调用 HAL_GPIO_Init**。13 根引脚的模式/上下拉/速度/上电初值全部由
* CubeMX 生成的 MX_GPIO_Init() 负责,在这里再 Init 一遍只会让 CubeMX 显示的
* 引脚状态与真相脱节,下次重生成还会被覆盖。
* 二、先把 SH/LD 写成高、CLK 写成低(静止态 = 移位模式 + 时钟低),再回读确认。
* 为什么要确认而不是直接写:如果有人在别处改过这两根脚(比如测试代码),
* 这里的确认能把「引脚被抢走」变成一次明确的 BSP_ERR_STATE,而不是让开入
* 从此静默读错。
* 三、最后把 10 路开出整组写成释放态,并让影子寄存器 = 0。
* 即便 MX_GPIO_Init 已经写过 RESET,这里仍显式写一次:初值「靠 CubeMX 设对」
* 是隐式契约,多一次显式写入只花几十个周期,换来上电全释放这条不依赖别人。
* 上电无继电器吸合 ⇒ 24V 供电不使能,PF4 自然保持 RESET。
*/
bsp_err_t ioboard_init(void);
/*
* 函数功能:读一次 8 路开入(完整装载 + 8 拍移位)
* 入口参数:out_mask - 输出,bit0 = A 通道 … bit7 = H 通道(见 ioboard_bits.h)
* 返回值:BSP_OK - 读成功,*out_mask 有效
* BSP_ERR_PARAM - out_mask 为 NULL
* BSP_ERR_STATE - 驱动的引脚静止态被破坏(SH/LD 已被别人拉低等),本次未读数
* 限定条件:任意上下文可调(任务 / ISR 均可)。
* 内部按上下文自动选择临界区:
* 任务上下文 → taskENTER_CRITICAL()(屏蔽 configMAX_SYSCALL_INTERRUPT_PRIORITY
* 及以下的中断);ISR 上下文 → taskENTER_CRITICAL_FROM_ISR()
* (抬高 BASEPRI,返回原值,退出时恢复)。
* 为什么不能只给一套:在 ISR 里调 taskEXIT_CRITICAL() 会把 BASEPRI 直接写 0,
* 等于把正在嵌套的中断临界区提前放掉;反过来,在任务里调 FROM_ISR 版本也会
* 留下一个未恢复的 BASEPRI。两者都是「平时没事、偏偏在高优先级 ISR 活跃时炸」。
* 所以本接口自带上下文判别(见 .c 的 ioboard_enter_critical),调用方不用关心
* 自己在哪;另设独立的 ISR 入口,见下面 ioboard_di_read_from_isr。
* 函数说明:
* 全过程持锁的理由:74HC165 的装载/移位的「相位」由 8 个时钟沿的先后顺序定义,
* 中途被别的代码插进来动 PC2/PC3(或读走 QH 的中间态)就会位序错位;
* 而错位不报错,只表现为「开入状态差一位」——与线接错完全同形。
* 耗时上界 IOBOARD_DI_READ_MAX_US(当前 26 us)。
* 上下文判别只根据两种寄存器状态选临界区,不改变时序本身;两种形态的耗时差异
* 在 1 us 量级以内,不影响 IOBOARD_DI_READ_MAX_US 这个上界。
*/
bsp_err_t ioboard_di_read(uint8_t *out_mask);
/*
* 函数功能:ISR 专用版本:语义与 ioboard_di_read 完全相同,但使用 FROM_ISR 临界区
* 入口参数:out_mask - 同 ioboard_di_read
* 返回值:同 ioboard_di_read
* 限定条件:只允许在中断上下文调用(含 EXTI / 定时器回调 / FreeRTOS 软件定时器回调)
* 函数说明:单独留一个入口而不是靠宏切换,是为了让「谁在 ISR 里读了开入」在调用点
* 一眼可见——这个区别只在时序紧张的现场才变得关键,那时没人想回头查宏。
*/
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 单次写原子,端口段之间不做临界区
* 函数说明:
* 一、极性只在本层转换:mask 进 → 按 IOBOARD_DO_LEVEL_ACTIVE 换成 BSRR 的置位/复位
* 两个字,然后**每个端口段只写一次 BSRR**(BSRR 是高 16 位复位、低 16 位置位,
* 一次写同时表达「这几路置高、那几路置低」,所以同一端口段内的多路之间没有中间态)。
* 二、10 路落在 GPIOC / GPIOF / GPIOE 三个端口,共 4 个端口段(见 ioboard.c 的
* k_do_pin 表),最多 4 次 BSRR 写入。段与段之间只看到「旧态 → 新态」的跃迁,
* 业务层面不可观测;若将来要求严格同时,需硬件把它们挪到同一端口。
* 三、影子寄存器在合成后更新: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 = 当前 1=吸合语义;
* bit6 = KO_24V 供电使能的实际状态(自动算出,非写入回显)
* 返回值:BSP_OK - 成功;BSP_ERR_PARAM - out_mask 为 NULL
* 限定条件:任意上下文可调
* 函数说明:只回答「上次合成后让它是什么状态」,不回答「继电器现在真的动没动」。
* bit6 回答「24V 供电现在是否使能」;后者要上板用辅助触点或万用表量,
* README 有步骤。
*/
bsp_err_t ioboard_do_get(uint16_t *out_mask);
/*
* 函数功能:读 10 路开出引脚的**实际 GPIO 输出电平**(调试/上板验证用)
* 入口参数:out_level - 输出,bit n = 第 n 路引脚当前输出电平(1 = 高电平),
* 与「1=吸合」无关,是纯电气量
* 返回值:BSP_OK - 成功;BSP_ERR_PARAM - out_level 为 NULL
* 限定条件:任意上下文可调
* 函数说明:影子寄存器与这个值不一致 = 有人在 ioboard 之外动了这 10 根脚。
* 上板验证极性时用它,比只看影子寄存器更能抓到真问题。
*/
bsp_err_t ioboard_do_read_level(uint16_t *out_level);
#ifdef __cplusplus
}
#endif
#endif /* IOBOARD_H */