From 6e0755f97152f62de724e9bde66ba9a83691de08 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Wed, 18 Nov 2026 19:34:47 +0800 Subject: [PATCH] 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. --- App/app/ui_data_feed.c | 19 +++- Drivers/BSP/IOBOARD/README.md | 23 +++-- Drivers/BSP/IOBOARD/ioboard.c | 40 +++++++-- Drivers/BSP/IOBOARD/ioboard.h | 36 ++++++-- docs/README.md | 2 +- docs/任务规划/待处理疑问.md | 2 +- docs/硬件平台/开入开出实施说明.md | 69 +++++++------- scripts/size_attestation.json | 8 +- test/board/ioboard_test_task.c | 144 +++++++++++++++++++++++++----- test/host/ioboard/ioboard_test.c | 49 +++++++++- 10 files changed, 302 insertions(+), 90 deletions(-) diff --git a/App/app/ui_data_feed.c b/App/app/ui_data_feed.c index 1d84fe81..3885b678 100644 --- a/App/app/ui_data_feed.c +++ b/App/app/ui_data_feed.c @@ -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(本处传栈上地址,不会发生);仍按 diff --git a/Drivers/BSP/IOBOARD/README.md b/Drivers/BSP/IOBOARD/README.md index 38d8a13f..792e1ba9 100644 --- a/Drivers/BSP/IOBOARD/README.md +++ b/Drivers/BSP/IOBOARD/README.md @@ -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 ← 纯逻辑:位序组装。只依赖 ,主机侧 | `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 ← 纯逻辑:位序组装。只依赖 ,主机侧 - 若**继电器不动**、引脚电平也变了 → 极性反了,把 `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 ← 纯逻辑:位序组装。只依赖 ,主机侧 不会出现目标态以外的组合。若将来业务要求 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()` 读的是**软件影子寄存器**(「我上次让它是什么」), diff --git a/Drivers/BSP/IOBOARD/ioboard.c b/Drivers/BSP/IOBOARD/ioboard.c index a22920fc..e4ebfdc2 100644 --- a/Drivers/BSP/IOBOARD/ioboard.c +++ b/Drivers/BSP/IOBOARD/ioboard.c @@ -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 * 限定条件:任意上下文 * 函数说明: diff --git a/Drivers/BSP/IOBOARD/ioboard.h b/Drivers/BSP/IOBOARD/ioboard.h index 37c2d1bc..df616e8a 100644 --- a/Drivers/BSP/IOBOARD/ioboard.h +++ b/Drivers/BSP/IOBOARD/ioboard.h @@ -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 的