From 74efa671bb11a547f2ab8ac174f586132703a506 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Wed, 18 Nov 2026 14:25:32 +0800 Subject: [PATCH] feat(ioboard): wire 6 new CubeMX pins into 10-channel DO driver Flat-expand the board output driver from 4 to 10 channels as decided: IOBOARD_DO_COUNT 4->10, mask uint8_t->uint16_t, IOBOARD_DO_MASK_ALL 0x03FF. The 6 new pins keep their bit positions: KO_LED1=PF2(bit4), KO_LED2=PF3(bit5), KO_24V=PF4(bit6), KO4=PF5(bit7), KO5=PC15(bit8), KO_LED3=PE6(bit9); the original 4 (KO6/TRIP/ERT/CLZ) keep bit0..3. Backups-domain PC15 is used as a signal bit only (+/-3 mA limit). No 24V supply interlock and no LED special-casing: the driver writes KO_24V as an ordinary bit; callers needing relay power sequencing must assert it before energizing a channel. do_write/get/read_level and the shadow register are all uint16_t; do_apply flushes four port segments (GPIOC/GPIOF/GPIOC/GPIOE) and do_read_level caches three port ODRs. UI: UI_DATA_DO_N 4->10, dio_do_mask uint16_t, UI_DATA_VER 3->4 because dio_do_valid shifts 211->212; feed mask and dio row table extended; content-page golden references regenerated for 51 rows / 7 pages. Host ioboard tests 127/127 and ui_data tests 305/305 pass; Keil rebuild 0 errors 0 warnings. RAM ledger, memory snapshot and size attestation refilled from the authoritative map. Docs: ioboard spec v1.2->v1.3 and the resolved 6-pin question closed out. --- App/app/ui_data_feed.c | 51 +++++++---- Drivers/BSP/IOBOARD/README.md | 47 ++++++---- Drivers/BSP/IOBOARD/ioboard.c | 94 ++++++++++++-------- Drivers/BSP/IOBOARD/ioboard.h | 74 ++++++++++------ Drivers/BSP/IOBOARD/ioboard_bits.h | 8 +- Drivers/BSP/UI/ui_data.h | 37 +++++--- Drivers/BSP/UI/ui_page_yx.c | 36 ++++---- docs/任务规划/待处理疑问.md | 2 +- docs/内存管理/RAM使用分析与优化方案.md | 4 +- docs/内存管理/RAM预算台账.md | 4 +- docs/硬件平台/开入开出实施说明.md | 118 ++++++++++++------------- scripts/ram_baseline.tsv | 2 +- scripts/size_attestation.json | 14 +-- simulator/tests/check_content_pages.py | 57 +++++++++--- simulator/tests/ref/shot_yx.bin | Bin 3200 -> 3200 bytes simulator/tests/ref/shot_yxp2.bin | Bin 3200 -> 3200 bytes simulator/tests/ref/shot_yxp5.bin | Bin 3200 -> 3200 bytes simulator/tests/ref/shot_yxp6.bin | Bin 3200 -> 3200 bytes simulator/tests/ref/shot_yxp7.bin | Bin 0 -> 3200 bytes test/board/ioboard_test_task.c | 115 ++++++++++++------------ test/host/ioboard/ioboard_test.c | 41 ++++++--- test/host/ui_data/ui_data_test.c | 28 +++--- 22 files changed, 438 insertions(+), 294 deletions(-) create mode 100644 simulator/tests/ref/shot_yxp7.bin diff --git a/App/app/ui_data_feed.c b/App/app/ui_data_feed.c index c2f18845..1d84fe81 100644 --- a/App/app/ui_data_feed.c +++ b/App/app/ui_data_feed.c @@ -7,8 +7,8 @@ * 格式化与 LVGL 调用(显示规格全在页面行表,同文档 §8) * 唯一填充者的边界(「开入开出」页补记):rt 帧里**每一个**业务字段的一手 * 取数都发生在这里——包括板级 8 路开入(经 App/util/ioboard_di.h 的注册式 - * 读口读 defaultTask 发布的去抖快照)与 4 路开出(读 Drivers/BSP/IOBOARD 的 - * 影子寄存器)。页面只消费快照,不得自己去调 ioboard_* / ioboard_di_*: + * 读口读 defaultTask 发布的去抖快照)与 10 路开出(读 Drivers/BSP/IOBOARD 的 + * uint16_t 影子寄存器)。页面只消费快照,不得自己去调 ioboard_* / ioboard_di_*: * 那是绕过节拍与失败语义的第二条取数路径,读失败就会直变成屏上的 * "开入全部复归"。两族数据刻意不进 yx_bits/yx_valid(板级引脚 ≠ 104 点表)。 * 写入者互斥(同一条边界的另一面):本模块的四个开入开出字段只由本文件写, @@ -47,6 +47,11 @@ * 注册式读口取 defaultTask 的去抖快照,**读失败保留 * 上一次已发布的值并令有效位 = 0**(铁律:读数失败不得 * 当"开入全部复归"上报) + * v4 2026-11-18 DTU 项目组 开出扩为 10 路:FEED_DO_MASK 覆盖 bit0..bit9 + * (新增 6 个 IOBOARD_DO_* 语义宏),shadow 局部变量 + * 与 ioboard_do_get() 输出改 uint16_t,dio_do_mask + * 赋值保留全部 10 位(不再截断到 uint8_t);写侧 + * 位宽守卫改成 IOBOARD_DO_COUNT == UI_DATA_DO_N == 10 * v1.2 2026-10-26 DTU 项目组 道F task-16:删除本地镜像 feed_cal_block(), * 两个调用点(填帧 / 门控比较)改调 * adc_cal_prot_blocked()——同一份三路判定此前在 @@ -77,7 +82,7 @@ #include "ui_data.h" #include "ui_net_sink.h" /* UI_NET_SINK_PORT:远程显示(RemoDispBus)监听端口 */ #include "ftp_cfg.h" /* FTP_CFG_USER_MAX / ftp_cfg_get() */ -#include "ioboard.h" /* 板级 4 路开出:ioboard_do_get / IOBOARD_DO_* 语义位(下层 → 上层合法方向) */ +#include "ioboard.h" /* 板级 10 路开出:ioboard_do_get(uint16_t*) / IOBOARD_DO_* 语义位(下层 → 上层合法方向) */ /* 同层(App)数据源 */ #include "adc_input.h" /* ADC_SEM_COUNT / adc_input_raw(TEMP 码值) */ @@ -143,22 +148,29 @@ typedef char feed_chk_set_n_t[(UI_DATA_SET_N == (uint32_t)PS_ID_COUNT) ? 1 : -1] * 故在写侧也钉一道(BSP 侧同一条守卫在 Drivers/BSP/UI/ui_data.c) */ typedef char feed_chk_set_u8_t[((uint32_t)PS_ID_COUNT <= 64u) ? 1 : -1]; typedef char feed_chk_fuser_t[(UI_DATA_FUSER_LEN >= FTP_CFG_USER_MAX) ? 1 : -1]; -/* v3:板级开入/开出位宽对表。UI_DATA_DI_N / UI_DATA_DO_N 是 BSP 契约里给页面用的 +/* v4:板级开入/开出位宽对表。UI_DATA_DI_N / UI_DATA_DO_N 是 BSP 契约里给页面用的 * 路数(BSP 看不见 App 头,物理上自证不了),真值分别是 App/util/ioboard_di.h 的 - * IOBOARD_DI_CH_NUM(刻意不 include ioboard.h 的那个数)与 ioboard.h 的四位语义宏。 - * 本文件是**唯一**同时看见两侧的编译单元——这里不等号一翻,编不过 */ + * IOBOARD_DI_CH_NUM(刻意不 include ioboard.h 的那个数)与 ioboard_bits.h 的 + * IOBOARD_DO_COUNT。本文件是**唯一**同时看见两侧的编译单元——这里不等号一翻,编不过 */ typedef char feed_chk_di_n_t[(UI_DATA_DI_N == IOBOARD_DI_CH_NUM) ? 1 : -1]; -/* 开出位宽:拿四位语义宏本身还原成位数——ioboard.h 少给一位或多给一位都在这里翻脸 */ -#define FEED_DO_N_REF ((IOBOARD_DO_KO6 | IOBOARD_DO_TRIP | IOBOARD_DO_ERT | IOBOARD_DO_CLZ) + 1u) -typedef char feed_chk_do_n_t[((UI_DATA_DO_N * 2u) == FEED_DO_N_REF) - || ((UI_DATA_DO_N * 4u) == FEED_DO_N_REF) - || ((UI_DATA_DO_N * 8u) == FEED_DO_N_REF) ? 1 : -1]; -/* 板级开出语义位集合:bit0..bit3 = KO6/TRIP/ERT/CLZ(ioboard.h 的四位宏,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 * 为什么在这一处汇成一个掩码:填帧要用它,位宽守卫也要用它;两处各写一遍等于 * 第二个真相(少写一位,屏上就凭空多出一路"永远释放"的开出) */ -#define FEED_DO_MASK ((uint8_t)(IOBOARD_DO_KO6 | IOBOARD_DO_TRIP | \ - IOBOARD_DO_ERT | IOBOARD_DO_CLZ)) +#define FEED_DO_MASK ((uint16_t)(IOBOARD_DO_KO6 | IOBOARD_DO_TRIP | \ + IOBOARD_DO_ERT | IOBOARD_DO_CLZ | \ + IOBOARD_DO_KO_LED1 | IOBOARD_DO_KO_LED2 | \ + IOBOARD_DO_KO_24V | IOBOARD_DO_KO4 | \ + IOBOARD_DO_KO5 | IOBOARD_DO_KO_LED3)) + +/* 位宽守卫(须排在 FEED_DO_MASK 定义之后,否则宏未展开就被当标识符用): + * 三处同时钉死——UI 契约路数 == 驱动路数 == 10,且语义位掩码恰好覆盖 + * bit0..bit9(IOBOARD_DO_MASK_ALL = 0x03FF)。驱动少给一位或多给一位都在这里翻脸 */ +typedef char feed_chk_do_n_t[(UI_DATA_DO_N == 10u) + && (IOBOARD_DO_COUNT == 10u) + && (FEED_DO_MASK == IOBOARD_DO_MASK_ALL) ? 1 : -1]; /* 静态变量定义区 */ @@ -174,7 +186,7 @@ static uint8_t s_dio_di_last; static uint8_t s_dio_di_seen; /* 1 = s_dio_di_last 曾来自一次成功的快照读 */ /* 组装缓冲:三帧串行填充,共用一块存储,省两份 RAM。 - * 实际最大者是**实时帧**(212 B > par 192 B > info),故给 par 尾追加字段 + * 实际最大者是**实时帧**(216 B > par 192 B > info),故给 par 尾追加字段 * 只要不超过 rt 就一字节 RAM 都不多花(这条由主机单测 TC-UIDATA-021g/h 钉住, * 尺寸一变这里就是唯一会撒谎的地方;rt 帧本身就是 rt/par/info 三帧里最大的, * 它每长 1 B,这块 union 就跟着长 1 B——RAM 台账要按 rt 的量算) */ @@ -413,8 +425,9 @@ static void feed_fill_dio_di(ui_data_rt_t *p_snap) { * 返回值:无 * 限定条件:uiTask 上下文;ioboard_do_get 只读一个 volatile 影子寄存器, * 无硬件访问、无临界区,任意上下文可调 - * 函数说明:mask 只保留 bit0..bit3(IOBOARD_DO_KO6/TRIP/ERT/CLZ),高位是驱动 - * 的"无对应硬件"区,原样透传进屏幕等于凭空多出 4 路。 + * 函数说明:mask 覆盖 bit0..bit9(10 路扁平位号),FEED_DO_MASK 与驱动 + * IOBOARD_DO_MASK_ALL 编译期等值;uint16_t 影子里这 10 位全部透传, + * 不再截断到低 8 位(bit8 KO5/bit9 KO_LED3 必须保留)。 * ⚠ 这是**软件意图**(上次成功写入的值),不是继电器机械吸合实测; * 驱动无辅助触点回读通路(ioboard.h 的 ioboard_do_get 注),页面措辞 * 不得让操作员以为读到了机械反馈。 @@ -422,10 +435,10 @@ static void feed_fill_dio_di(ui_data_rt_t *p_snap) { * "取不到就报无效"处理,不为不可能的分支编造一个成功态。 */ static void feed_fill_dio_do(ui_data_rt_t *p_snap) { - uint8_t shadow = 0u; + uint16_t shadow = 0u; if (ioboard_do_get(&shadow) == BSP_OK) { - p_snap->dio_do_mask = (uint8_t)(shadow & FEED_DO_MASK); + p_snap->dio_do_mask = (uint16_t)(shadow & FEED_DO_MASK); p_snap->dio_do_valid = 1u; } else { p_snap->dio_do_mask = 0u; diff --git a/Drivers/BSP/IOBOARD/README.md b/Drivers/BSP/IOBOARD/README.md index 692f87e8..38d8a13f 100644 --- a/Drivers/BSP/IOBOARD/README.md +++ b/Drivers/BSP/IOBOARD/README.md @@ -1,6 +1,6 @@ # 开入开出板 BSP(IOBOARD) -**一句话**:这个驱动让板上的 74HC165 移位寄存器能够被读出 8 路开入,让 4 路光耦继电器能够被整组写入;它只做引脚与时序,不做任何业务判断。 +**一句话**:这个驱动让板上的 74HC165 移位寄存器能够被读出 8 路开入,让 10 路板级开出能够被整组写入;它只做引脚与时序,不做任何业务判断。 --- @@ -17,6 +17,12 @@ | 出口 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 | +| 出口 6(KO_24V) | PF4 | `KO_24V_Pin` | 推挽输出 | RESET | 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`)是命名残留,**硬件上没有对应信号**,本驱动完全不碰。 @@ -126,12 +132,12 @@ ioboard_bits.c ← 纯逻辑:位序组装。只依赖 ,主机侧 | 函数 | 一句话职责 | mask 语义 | |---|---|---| -| `ioboard_init()` | 清影子、自检引脚模式、确认静止态、4 路全释放 | — | +| `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(uint8_t mask)` | 整组原子写 4 路开出 | **bit0..bit3,1 = 吸合**;bit4..bit7 忽略 | -| `ioboard_do_get(uint8_t *out_mask)` | 读软件影子寄存器(上次写入值) | 同上 | -| `ioboard_do_read_level(uint8_t *out_level)` | 读 4 路引脚**实际输出电平**(调试用) | **bit n = 1 表示引脚高电平**,与吸合语义无关 | +| `ioboard_do_write(uint16_t mask)` | 整组写 10 路开出(每段 BSRR 原子) | **bit0..bit9,1 = 吸合/有效**;bit10..bit15 忽略 | +| `ioboard_do_get(uint16_t *out_mask)` | 读软件影子寄存器(上次写入值) | 同上 | +| `ioboard_do_read_level(uint16_t *out_level)` | 读 10 路引脚**实际输出电平**(调试用) | **bit n = 1 表示引脚高电平**,与吸合语义无关 | - `ioboard_init()` **不调用 `HAL_GPIO_Init`**:引脚模式/速度/上下拉由 `MX_GPIO_Init()` 唯一负责。 在这里再初始化一遍只会让 CubeMX 显示的引脚状态与真相脱节,下次重生成还会被覆盖。 @@ -199,16 +205,16 @@ ioboard_bits.c ← 纯逻辑:位序组装。只依赖 ,主机侧 **先验极性**——这一步决定 `IOBOARD_DO_LEVEL_ACTIVE` 的取值是否正确: -1. `ioboard_init()` 之后,4 路应**全部释放**:万用表量出口端子(常开触点)应为断开,继电器无声。 +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/bit2/bit3 分别对应 TRIP/ERT/CLZ 三路,**每次只有一路动作**。 -4. 调 `ioboard_do_write(0x0F)` 四路全吸合,再 `ioboard_do_write(0x00)` 全释放。 +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()` 对照, - 若两者不一致 = 有人在驱动之外写了这 4 根引脚的 ODR。 + 若两者不一致 = 有人在驱动之外写了这 10 根引脚的 ODR。 ### 第 3 步:有示波器时看时序 @@ -234,21 +240,25 @@ ioboard_bits.c ← 纯逻辑:位序组装。只依赖 ,主机侧 软件侧适配点:`ioboard.c` 的 `ioboard_di_shift()` —— 若飞线/改板后要读 16 位, 在那里把循环次数从 `IOBOARD_DI_COUNT`(8)改为 16,并相应调整 `ioboard_bits.c` 的组装与 `IOBOARD_DI_MASK_ALL`。**不是现在该做的事**,记在此处以免将来重复推导。 -2. **4 路开出分属两个端口**(GPIOC×1、GPIOF×3),所以是**两次** BSRR 写,两次之间约 10 ns 量级。 - 每次写内部原子,两次之间只会看到「旧态 → 新态」的跃迁,不会出现目标态以外的组合。 - 若将来业务要求 4 路**严格同一时刻**,需要硬件把它们挪到同一端口。 -3. **极性未经原理图核对**:`IOBOARD_DO_LEVEL_ACTIVE = 1U` 目前只有「用户口径 + 上电初值为 RESET」两条间接依据, +2. **10 路开出分属三个端口**(GPIOC×2、GPIOF×7、GPIOE×1),按 bit 顺序形成 C→F→C→E 四段, + 整组写最多 **4 次** BSRR 写,段间不同步性变差;每次写内部原子,段间只会看到「旧态 → 新态」的跃迁, + 不会出现目标态以外的组合。若将来业务要求 10 路**严格同一时刻**,需要硬件把它们挪到同一端口。 +3. **PC15(KO5)备份域限流、仅信号位**:该脚位于备份域,驱动能力 ±3 mA,本驱动只把它当普通信号位, + 不用于供电或功率输出。 +4. **KO_24V 与继电器供电联锁未实现**:本驱动只按 mask 写引脚,不判断 24V 供电是否已建立;上层若据此控继电器, + 须自行保证「先供电后吸合」。 +5. **极性未经原理图核对**:`IOBOARD_DO_LEVEL_ACTIVE = 1U` 目前只有「用户口径 + 上电初值为 RESET」两条间接依据, 必须按 §5 第 2 步实测确认。 -4. **硬件无辅助触点回读**:`ioboard_do_get()` 读的是**软件影子寄存器**(「我上次让它是什么」), +6. **硬件无辅助触点回读**:`ioboard_do_get()` 读的是**软件影子寄存器**(「我上次让它是什么」), 不是「继电器现在真的动没动」。后者只能靠辅助触点或万用表。 -5. **PE2 / PE4 是命名残留**:硬件无信号,本驱动不配置、不读取。若 CubeMX 里还留着它们, +7. **PE2 / PE4 是命名残留**:硬件无信号,本驱动不配置、不读取。若 CubeMX 里还留着它们, 那是 `IN_D4` / `IN_E4` 的旧配置,不影响本驱动。 -6. **开入位序仅部分验证**:8 路开入与板级丝印 `DI_A`~`DI_H` 的对应关系按移位顺序推定, +8. **开入位序仅部分验证**:8 路开入与板级丝印 `DI_A`~`DI_H` 的对应关系按移位顺序推定, 2026-11-16 已在 **C 通道**上实测确认(信号接入 C 路 → 屏上只有 `DI_C` 显示「合」, 其余 7 路不动),即 A 在 LSB、H 在 MSB 的位序与通道隔离都正确。 其余 7 路尚未逐路验证;若某一路接反,症状是「该路动作时屏上亮的是另一路」。 - UI 侧的遥信页 `Drivers/BSP/UI/ui_page_yx.c` 文件头已改为引用本节(引第 3、6~7 条),不再复述。 -7. **开入是电平检测,不是通断检测**(用户口径,2026-11-16): + UI 侧的遥信页 `Drivers/BSP/UI/ui_page_yx.c` 文件头已改为引用本节(引第 5、8~9 条),不再复述。 +9. **开入是电平检测,不是通断检测**(用户口径,2026-11-16): 本板开入测量的是**输入信号有没有 24V 高电平**,「导通」本身是测不出来的—— 外部信号必须提供 24V,仅仅把回路接通而没有电平,开入不会动作。 板上是**反相链路**:有 24V 输入 → 光耦导通 → 74HC165 的 A..H 引脚被拉**低**。 @@ -264,3 +274,4 @@ ioboard_bits.c ← 纯逻辑:位序组装。只依赖 ,主机侧 | 日期 | 作者 | 变更 | |---|---|---| | 2026-11-16 | 王建锋 | 创建:74HC165 装载/移位时序、4 路光耦继电器整组写、位序纯逻辑拆分 | +| 2026-11-18 | 王建锋 | 扩展:新增 6 路普通开出,扁平 10 路、mask 改 uint16_t | diff --git a/Drivers/BSP/IOBOARD/ioboard.c b/Drivers/BSP/IOBOARD/ioboard.c index 470b1a19..a22920fc 100644 --- a/Drivers/BSP/IOBOARD/ioboard.c +++ b/Drivers/BSP/IOBOARD/ioboard.c @@ -1,12 +1,13 @@ /* * 模块名称:开入开出板 BSP(74HC165 开入 + 光耦继电器开出) - * 模块功能:74HC165 装载/移位时序的寄存器级实现 + 4 路光耦继电器的整组原子写。 + * 模块功能:74HC165 装载/移位时序的寄存器级实现 + 10 路板级开出整组写(段内原子)。 * 位序组装在 ioboard_bits.c(纯逻辑、可主机侧单测),本文件只剩引脚与时间。 * 适用平台:STM32F407ZGT6(Cortex-M4F)+ FreeRTOS V10.3.1 * 作者:王建锋 * 创建日期:2026-11-16 * 修改记录: * 2026-11-16 王建锋 创建 + * 2026-11-18 王建锋 扩展:新增 6 路普通开出,mask 由 uint8_t 扩到 uint16_t * * 分层约定(为什么这样切): * ├─ 引脚编号只有一个来源:main.h 的 Label_Pin 宏,在本文件顶部的「引脚绑定」区 @@ -49,6 +50,18 @@ #define IOBOARD_DO_CH_GPIO_2_PIN ERT_LED_Pin #define IOBOARD_DO_CH_GPIO_3_PORT CLZ_LED_GPIO_Port /* PF6 */ #define IOBOARD_DO_CH_GPIO_3_PIN CLZ_LED_Pin +#define IOBOARD_DO_CH_GPIO_4_PORT KO_LED1_GPIO_Port /* PF2 */ +#define IOBOARD_DO_CH_GPIO_4_PIN KO_LED1_Pin +#define IOBOARD_DO_CH_GPIO_5_PORT KO_LED2_GPIO_Port /* PF3 */ +#define IOBOARD_DO_CH_GPIO_5_PIN KO_LED2_Pin +#define IOBOARD_DO_CH_GPIO_6_PORT KO_24V_GPIO_Port /* PF4 */ +#define IOBOARD_DO_CH_GPIO_6_PIN KO_24V_Pin +#define IOBOARD_DO_CH_GPIO_7_PORT KO4_GPIO_Port /* PF5 */ +#define IOBOARD_DO_CH_GPIO_7_PIN KO4_Pin +#define IOBOARD_DO_CH_GPIO_8_PORT KO5_GPIO_Port /* PC15,备份域 ±3 mA,仅信号位 */ +#define IOBOARD_DO_CH_GPIO_8_PIN KO5_Pin +#define IOBOARD_DO_CH_GPIO_9_PORT KO_LED3_GPIO_Port /* PE6 */ +#define IOBOARD_DO_CH_GPIO_9_PIN KO_LED3_Pin /* ======================== 内部宏与常量 ======================== */ @@ -65,7 +78,7 @@ #define IOBOARD_CTX_AUTO ((uint8_t)0xFFU) /* - * 4 路开出「软件 mask 位 → 端口 + 引脚」的绑定表。 + * 10 路开出「软件 mask 位 → 端口 + 引脚」的绑定表。 * 这是 IOBOARD_DO_CH_GPIO_n_PORT/PIN 宏在运行时的唯一使用点: * 引脚换到别的端口时只改 ioboard.h 的宏,这里一行不动。 * 用「端口指针 + Pin 掩码」而不是逐脚 HAL_GPIO_WritePin,是为了能合成一次 BSRR 写。 @@ -81,17 +94,23 @@ static const ioboard_do_pin_t k_do_pin[IOBOARD_DO_COUNT] = { IOBOARD_DO_CH_GPIO_0_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_0_PIN }, { IOBOARD_DO_CH_GPIO_1_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_1_PIN }, { IOBOARD_DO_CH_GPIO_2_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_2_PIN }, - { IOBOARD_DO_CH_GPIO_3_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_3_PIN } + { IOBOARD_DO_CH_GPIO_3_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_3_PIN }, + { IOBOARD_DO_CH_GPIO_4_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_4_PIN }, + { IOBOARD_DO_CH_GPIO_5_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_5_PIN }, + { IOBOARD_DO_CH_GPIO_6_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_6_PIN }, + { IOBOARD_DO_CH_GPIO_7_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_7_PIN }, + { IOBOARD_DO_CH_GPIO_8_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_8_PIN }, + { IOBOARD_DO_CH_GPIO_9_PORT, (uint32_t)IOBOARD_DO_CH_GPIO_9_PIN } }; /* ======================== 内部状态 ======================== */ /* - * 开出影子寄存器:bit0..bit3 = 上一次成功写入的「1 = 吸合」语义。 + * 开出影子寄存器:bit0..bit9 = 上一次成功写入的「1 = 吸合」语义。 * volatile:同时被任务与可能的 ISR 读,编译器不得把它缓存在寄存器里。 - * 不需要锁:本模块只对整字节赋值(单指令原子),从不做「读-改-写」。 + * 不需要锁:本模块只对整半字赋值(单指令原子),从不做「读-改-写」。 */ -static volatile uint8_t s_do_shadow = 0U; +static volatile uint16_t s_do_shadow = 0U; /* DWT 周期计数器是否已确认可用(懒使能结果,1 = 可用) */ static uint8_t s_dwt_ready = 0U; @@ -318,7 +337,7 @@ static bsp_err_t ioboard_check_idle(void) */ want_cycles = (SystemCoreClock + 500000U) / 1000000U; - if (((uint32_t)IOBOARD_CYCLES_PER_US + 1U < want_cycles) || + if ((want_cycles > (uint32_t)IOBOARD_CYCLES_PER_US + 1U) || ((uint32_t)IOBOARD_CYCLES_PER_US > want_cycles + 1U)) { return BSP_ERR_STATE; } @@ -348,20 +367,22 @@ static bsp_err_t ioboard_check_idle(void) /* ======================== 内部函数:开出 ======================== */ /* - * 函数功能:按给定「1 = 吸合」语义把 4 路开出整组写到引脚上 - * 入口参数:relay_mask - 已屏蔽到 bit0..bit3 的吸合意图 + * 函数功能:按给定「1 = 吸合」语义把 10 路开出按端口分段写到引脚上 + * 入口参数:relay_mask - 已屏蔽到 bit0..bit9 的吸合意图 * 返回值:无 - * 限定条件:任意上下文(BSRR 单次写原子;影子寄存器由调用方维护) + * 限定条件:任意上下文(每段 BSRR 单次写原子;影子寄存器由调用方维护) * 函数说明: * 一、极性转换只在这一处:吸合位 → IOBOARD_DO_LEVEL_ACTIVE 指定的电平。 * 同一端口上「要置 1 的位」进 BSRR 低 16 位、「要清 0 的位」进 BSRR 高 16 位, - * **一次 32 位写**同时表达两个方向,所以这几路之间不存在中间态。 - * 二、4 路分属 GPIOC(1 路)与 GPIOF(3 路),共两次写;每次写内部原子。 - * 两次写之间只可能看到「旧态 → 新态」的跃迁,不会出现「目标态以外的组合」。 - * 若将来业务要求 4 路严格同一时刻,需要硬件把它们挪到同一端口——记在 README。 - * 三、按端口分段累加:不假设 4 路都落在同一端口(引脚改版时不用改本函数)。 + * **一次 32 位写**同时表达两个方向,所以同一端口段内不存在中间态。 + * 二、10 路分属 GPIOC(2 路:bit0、bit8)、GPIOF(7 路:bit1..bit7)、GPIOE(1 路:bit9), + * 按 bit 顺序形成 C→F→C→E 四段,共四次 BSRR 写;每次写内部原子。 + * 段与段之间只可能看到「旧态 → 新态」的跃迁,不会出现「目标态以外的组合」。 + * 若将来业务要求 10 路严格同一时刻,需要硬件把它们挪到同一端口——记在 README。 + * 三、按端口分段累加:遇到相邻端口不同就冲刷上一段;同一端口再次出现时也另起一段, + * 因此不会把跨段的位合并进同一次 BSRR 写,也不会漏写任一段(引脚改版时不用改本函数)。 */ -static void ioboard_do_apply(uint8_t relay_mask) +static void ioboard_do_apply(uint16_t relay_mask) { uint8_t i; GPIO_TypeDef *port; @@ -371,7 +392,7 @@ static void ioboard_do_apply(uint8_t relay_mask) port = k_do_pin[0].port; for (i = 0U; i < (uint8_t)IOBOARD_DO_COUNT; i++) { - uint32_t active = (uint32_t)((relay_mask >> i) & 1U); + uint32_t active = (uint32_t)(((uint32_t)relay_mask >> i) & 1U); uint32_t level; /* 唯一的极性映射点:吸合 = 1 时取 ACTIVE 电平,吸合 = 0 时取 RELEASE 电平 */ @@ -538,7 +559,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 显示的引脚状态与真相脱节,下次重生成还会被覆盖。 - * 只做四件事:清影子寄存器、自检引脚模式、确认并拉回静止态、整组释放 4 路开出。 + * 只做四件事:清影子寄存器、自检引脚模式、确认并拉回静止态、整组释放 10 路开出。 */ bsp_err_t ioboard_init(void) { @@ -600,8 +621,8 @@ bsp_err_t ioboard_di_read_from_isr(uint8_t *out_mask) } /* - * 函数功能:整组写 4 路开出 - * 入口参数:mask - bit0..bit3,1 = 吸合;高位忽略 + * 函数功能:整组写 10 路开出 + * 入口参数:mask - bit0..bit9,1 = 吸合;bit10..bit15 忽略 * 返回值:BSP_OK * 限定条件:任意上下文 * 函数说明: @@ -611,11 +632,11 @@ bsp_err_t ioboard_di_read_from_isr(uint8_t *out_mask) * 配好,init 之前调用也安全。 * 三、影子寄存器在写引脚**之前**更新:若写引脚过程中被更高优先级中断打断, * 上层查到的「我让它是什么」仍是调用方这次要的值,不会闪回旧值。 - * 不设临界区:整字节赋值是单指令原子,BSRR 写本身也原子。 + * 不设临界区:整半字赋值是单指令原子,BSRR 写本身也原子。 */ -bsp_err_t ioboard_do_write(uint8_t mask) +bsp_err_t ioboard_do_write(uint16_t mask) { - uint8_t relay = (uint8_t)(mask & IOBOARD_DO_MASK_ALL); + uint16_t relay = (uint16_t)(mask & IOBOARD_DO_MASK_ALL); s_do_shadow = relay; ioboard_do_apply(relay); @@ -625,11 +646,11 @@ bsp_err_t ioboard_do_write(uint8_t mask) /* * 函数功能:读软件影子寄存器 - * 入口参数:out_mask - 输出,bit0..bit3,1 = 吸合 + * 入口参数:out_mask - 输出,bit0..bit9,1 = 吸合 * 返回值:见 ioboard.h * 限定条件:任意上下文 */ -bsp_err_t ioboard_do_get(uint8_t *out_mask) +bsp_err_t ioboard_do_get(uint16_t *out_mask) { if (out_mask == NULL) { return BSP_ERR_PARAM; @@ -641,7 +662,7 @@ bsp_err_t ioboard_do_get(uint8_t *out_mask) } /* - * 函数功能:读 4 路开出引脚的实际输出电平(调试/上板验证用) + * 函数功能:读 10 路开出引脚的实际输出电平(调试/上板验证用) * 入口参数:out_level - 输出,bit n = 1 表示第 n 路引脚当前为高电平 * 返回值:见 ioboard.h * 限定条件:任意上下文 @@ -649,36 +670,39 @@ bsp_err_t ioboard_do_get(uint8_t *out_mask) * 用 ODR 而不是 IDR:ODR 是「我们让它输出什么」,IDR 是「引脚上实际是什么」。 * 这里要和影子寄存器对照,判断「有没有人在 ioboard 之外写了同一根引脚的 ODR」, * 所以要 ODR。若想查外部短路,那要看 IDR——由 ioboard_check_idle 对 LD/CLK 做了。 - * 按端口各取一次 ODR 再逐路拼,不逐路读寄存器。 + * 按端口各取一次 ODR 再逐路拼,不逐路读寄存器:GPIOC / GPIOF / GPIOE 三个端口 + * 各缓存一次,GPIOE(bit9)绝不复用 GPIOC 的 ODR(两者引脚号会重叠,串用必错)。 */ -bsp_err_t ioboard_do_read_level(uint8_t *out_level) +bsp_err_t ioboard_do_read_level(uint16_t *out_level) { uint8_t i; - uint8_t level = 0U; + uint16_t level = 0U; uint32_t odr_c; uint32_t odr_f; + uint32_t odr_e; uint32_t odr; if (out_level == NULL) { return BSP_ERR_PARAM; } - odr_c = IOBOARD_DO_CH_GPIO_0_PORT->ODR; - - /* GPIOF 与 GPIOC 不同时也可能是同一个端口(引脚改版):同一对象重复读无害 */ - odr_f = IOBOARD_DO_CH_GPIO_1_PORT->ODR; + odr_c = IOBOARD_DO_CH_GPIO_0_PORT->ODR; /* GPIOC:bit0、bit8 */ + odr_f = IOBOARD_DO_CH_GPIO_1_PORT->ODR; /* GPIOF:bit1..bit7 */ + odr_e = IOBOARD_DO_CH_GPIO_9_PORT->ODR; /* GPIOE:bit9 */ for (i = 0U; i < (uint8_t)IOBOARD_DO_COUNT; i++) { if (k_do_pin[i].port == IOBOARD_DO_CH_GPIO_0_PORT) { odr = odr_c; } else if (k_do_pin[i].port == IOBOARD_DO_CH_GPIO_1_PORT) { odr = odr_f; + } else if (k_do_pin[i].port == IOBOARD_DO_CH_GPIO_9_PORT) { + odr = odr_e; } else { - odr = k_do_pin[i].port->ODR; /* 第 3 个端口(当前不存在):退化为单读 */ + odr = k_do_pin[i].port->ODR; /* 未来端口:退化为单读 */ } if ((odr & k_do_pin[i].pin) != 0U) { - level |= (uint8_t)(1U << i); + level |= (uint16_t)(1U << i); } } diff --git a/Drivers/BSP/IOBOARD/ioboard.h b/Drivers/BSP/IOBOARD/ioboard.h index 888d8484..37c2d1bc 100644 --- a/Drivers/BSP/IOBOARD/ioboard.h +++ b/Drivers/BSP/IOBOARD/ioboard.h @@ -3,7 +3,7 @@ /* * 模块名称:开入开出板 BSP(74HC165 开入 + 光耦继电器开出) - * 模块功能:把「板上的引脚与时序」翻译成两件事——读 8 路开入、整组写 4 路开出。 + * 模块功能:把「板上的引脚与时序」翻译成两件事——读 8 路开入、整组写 10 路开出。 * 只回答「让硬件动起来并如实汇报」,不回答「该不该动」: * 不做过流判据、不做互锁策略、不碰 IEC 104、不建 RTOS 任务。 * 适用平台:STM32F407ZGT6 + FreeRTOS(裸机不可用:临界区走 FreeRTOS 宏) @@ -11,6 +11,7 @@ * 创建日期:2026-11-16 * 修改记录: * 2026-11-16 王建锋 创建:74HC165 装载/移位时序 + 4 路光耦继电器整组写 + * 2026-11-18 王建锋 扩展:开出扩为 10 路,新增 6 脚按普通开出位接入 * * 引脚来源(三处一致,改动必须走 CubeMX 重生成,不许在此手补初始化): * STM32F407-Demo.ioc → Inc/main.h 的