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.
This commit is contained in:
+32
-19
@@ -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;
|
||||
|
||||
@@ -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 ← 纯逻辑:位序组装。只依赖 <stdint.h>,主机侧
|
||||
|
||||
| 函数 | 一句话职责 | 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 ← 纯逻辑:位序组装。只依赖 <stdint.h>,主机侧
|
||||
|
||||
**先验极性**——这一步决定 `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 ← 纯逻辑:位序组装。只依赖 <stdint.h>,主机侧
|
||||
软件侧适配点:`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 ← 纯逻辑:位序组装。只依赖 <stdint.h>,主机侧
|
||||
| 日期 | 作者 | 变更 |
|
||||
|---|---|---|
|
||||
| 2026-11-16 | 王建锋 | 创建:74HC165 装载/移位时序、4 路光耦继电器整组写、位序纯逻辑拆分 |
|
||||
| 2026-11-18 | 王建锋 | 扩展:新增 6 路普通开出,扁平 10 路、mask 改 uint16_t |
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -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 的 <Label>_Pin / <Label>_GPIO_Port 宏
|
||||
@@ -23,6 +24,12 @@
|
||||
* 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) 是旧命名残留,硬件上无信号,本驱动**完全不碰**。
|
||||
*/
|
||||
|
||||
@@ -46,7 +53,8 @@ extern "C" {
|
||||
/* ======================== 宏定义:引脚绑定 ======================== */
|
||||
|
||||
/*
|
||||
* 引脚**编号**(PC2 / PC3 / PE3 / PC14 / PF0 / PF1 / PF6)只作说明与追溯,
|
||||
* 引脚**编号**(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。
|
||||
@@ -59,19 +67,33 @@ extern "C" {
|
||||
* 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),只作**追溯**,不是业务定义:
|
||||
* 「跳闸 / 告警 / 闭锁」三个动作各自的判据与互斥规则属于业务层,BSP 不解释、不排序。
|
||||
* 名字来自板级丝印/网络标号(KO6 / TRIP_LED / ERT_LED / CLZ_LED / KO_LED1 / KO_LED2 /
|
||||
* KO_24V / KO4 / KO5 / KO_LED3),只作**追溯**,不是业务定义:
|
||||
* 「跳闸 / 告警 / 闭锁」等动作各自的判据与互斥规则属于业务层,BSP 不解释、不排序。
|
||||
* KO5(PC15)位于备份域,驱动能力 ±3 mA,10 路统一按信号位处理,不作供电/功率输出。
|
||||
*/
|
||||
#define IOBOARD_DO_KO6 ((uint8_t)(1U << 0)) /* DO0,PC14 */
|
||||
#define IOBOARD_DO_TRIP ((uint8_t)(1U << 1)) /* DO1,PF0 */
|
||||
#define IOBOARD_DO_ERT ((uint8_t)(1U << 2)) /* DO2,PF1 */
|
||||
#define IOBOARD_DO_CLZ ((uint8_t)(1U << 3)) /* DO3,PF6 */
|
||||
#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 */
|
||||
|
||||
/* ======================== 宏定义:极性(唯一可改点) ======================== */
|
||||
|
||||
@@ -182,19 +204,19 @@ extern "C" {
|
||||
/*
|
||||
* 函数功能:初始化开入开出驱动(影子寄存器复位 + 静止态确认 + 上电全释放)
|
||||
* 入口参数:无
|
||||
* 返回值:BSP_OK - 初始化完成,4 路开出已处于释放态
|
||||
* 返回值:BSP_OK - 初始化完成,10 路开出已处于释放态
|
||||
* BSP_ERR_STATE - 静止态确认失败(回读到的 SH/LD 或 CLK 电平与预期不符)
|
||||
* 限定条件:必须在 MX_GPIO_Init() 之后调用(推荐在 app_main_init 里,
|
||||
* 与其它 BSP 的初始化一起,且**必须在任何业务代码写开出之前**)
|
||||
* 函数说明:
|
||||
* 一、**不重复调用 HAL_GPIO_Init**。7 根引脚的模式/上下拉/速度/上电初值全部由
|
||||
* 一、**不重复调用 HAL_GPIO_Init**。13 根引脚的模式/上下拉/速度/上电初值全部由
|
||||
* CubeMX 生成的 MX_GPIO_Init() 负责,在这里再 Init 一遍只会让 CubeMX 显示的
|
||||
* 引脚状态与真相脱节,下次重生成还会被覆盖。
|
||||
* 二、先把 SH/LD 写成高、CLK 写成低(静止态 = 移位模式 + 时钟低),再回读确认。
|
||||
* 为什么要确认而不是直接写:如果有人在别处改过这两根脚(比如测试代码),
|
||||
* 这里的确认能把「引脚被抢走」变成一次明确的 BSP_ERR_STATE,而不是让开入
|
||||
* 从此静默读错。
|
||||
* 三、最后把 4 路开出整组写成释放态,并让影子寄存器 = 0。
|
||||
* 三、最后把 10 路开出整组写成释放态,并让影子寄存器 = 0。
|
||||
* 即便 MX_GPIO_Init 已经写过 RESET,这里仍显式写一次:初值「靠 CubeMX 设对」
|
||||
* 是隐式契约,多一次显式写入只花几十个周期,换来上电全释放这条不依赖别人。
|
||||
*/
|
||||
@@ -237,42 +259,42 @@ bsp_err_t ioboard_di_read(uint8_t *out_mask);
|
||||
bsp_err_t ioboard_di_read_from_isr(uint8_t *out_mask);
|
||||
|
||||
/*
|
||||
* 函数功能:整组写 4 路开出(原子:一次写多个端口,不产生中间态)
|
||||
* 入口参数:mask - bit0..bit3 对应 PC14/PF0/PF1/PF6,**1 = 继电器吸合**;
|
||||
* bit4..bit7 无对应硬件,忽略(不报错:上层常直接把 4 位以上的状态原样传下)
|
||||
* 函数功能:整组写 10 路开出(按端口分段,每段一次 BSRR 写,段内不产生中间态)
|
||||
* 入口参数:mask - bit0..bit9 对应既有 4 路与新增 6 路,**1 = 吸合/有效**;
|
||||
* bit10..bit15 无对应硬件,忽略(不报错:上层常直接把状态字原样传下)
|
||||
* 返回值:BSP_OK - 已写入,影子寄存器已更新
|
||||
* 限定条件:任意上下文可调;内部一次写入即可,无需临界区
|
||||
* 限定条件:任意上下文可调;BSRR 单次写原子,端口段之间不做临界区
|
||||
* 函数说明:
|
||||
* 一、极性只在本层转换:mask 进 → 按 IOBOARD_DO_LEVEL_ACTIVE 换成 BSRR 的置位/复位
|
||||
* 两个字,然后**每个端口只写一次 BSRR**(BSRR 是高 16 位复位、低 16 位置位,
|
||||
* 一次写同时表达「这几路置高、那几路置低」,所以 4 路之间没有中间态)。
|
||||
* 二、4 路分散在 GPIOC(1 路)与 GPIOF(3 路)两个端口,两个 BSRR 写入之间隔着
|
||||
* 几条指令(约 10 ns 量级)。这是同步时序的极限,业务层面不可观测;
|
||||
* 若将来要求严格同时,需硬件把 4 路挪到同一端口——记在 README 的已知限制里。
|
||||
* 两个字,然后**每个端口段只写一次 BSRR**(BSRR 是高 16 位复位、低 16 位置位,
|
||||
* 一次写同时表达「这几路置高、那几路置低」,所以同一端口段内的多路之间没有中间态)。
|
||||
* 二、10 路落在 GPIOC / GPIOF / GPIOE 三个端口,共 4 个端口段(见 ioboard.c 的
|
||||
* k_do_pin 表),最多 4 次 BSRR 写入。段与段之间只看到「旧态 → 新态」的跃迁,
|
||||
* 业务层面不可观测;若将来要求严格同时,需硬件把它们挪到同一端口。
|
||||
* 三、影子寄存器在写入后更新,ioboard_do_get() 读到的就是「上一次成功写入的值」。
|
||||
*/
|
||||
bsp_err_t ioboard_do_write(uint8_t mask);
|
||||
bsp_err_t ioboard_do_write(uint16_t mask);
|
||||
|
||||
/*
|
||||
* 函数功能:读软件影子寄存器(不是硬件回读——硬件无辅助触点回读通路)
|
||||
* 入口参数:out_mask - 输出,bit0..bit3 = 上一次 ioboard_do_write 的 1=吸合语义
|
||||
* 入口参数:out_mask - 输出,bit0..bit9 = 上一次 ioboard_do_write 的 1=吸合语义
|
||||
* 返回值:BSP_OK - 成功;BSP_ERR_PARAM - out_mask 为 NULL
|
||||
* 限定条件:任意上下文可调
|
||||
* 函数说明:只回答「我上次让它是什么状态」,不回答「继电器现在真的动没动」。
|
||||
* 后者要上板用辅助触点或万用表量,README 有步骤。
|
||||
*/
|
||||
bsp_err_t ioboard_do_get(uint8_t *out_mask);
|
||||
bsp_err_t ioboard_do_get(uint16_t *out_mask);
|
||||
|
||||
/*
|
||||
* 函数功能:读 4 路开出引脚的**实际 GPIO 输出电平**(调试/上板验证用)
|
||||
* 函数功能:读 10 路开出引脚的**实际 GPIO 输出电平**(调试/上板验证用)
|
||||
* 入口参数:out_level - 输出,bit n = 第 n 路引脚当前输出电平(1 = 高电平),
|
||||
* 与「1=吸合」无关,是纯电气量
|
||||
* 返回值:BSP_OK - 成功;BSP_ERR_PARAM - out_level 为 NULL
|
||||
* 限定条件:任意上下文可调
|
||||
* 函数说明:影子寄存器与这个值不一致 = 有人在 ioboard 之外动了这 4 根脚。
|
||||
* 函数说明:影子寄存器与这个值不一致 = 有人在 ioboard 之外动了这 10 根脚。
|
||||
* 上板验证极性时用它,比只看影子寄存器更能抓到真问题。
|
||||
*/
|
||||
bsp_err_t ioboard_do_read_level(uint8_t *out_level);
|
||||
bsp_err_t ioboard_do_read_level(uint16_t *out_level);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
|
||||
@@ -25,14 +25,14 @@ extern "C" {
|
||||
/* 开入路数:74HC165 一片 8 位(两块级联,V0.1 只接回一块的数据线,见 README 已知限制) */
|
||||
#define IOBOARD_DI_COUNT 8
|
||||
|
||||
/* 开出路数:4 路光耦驱动继电器 */
|
||||
#define IOBOARD_DO_COUNT 4
|
||||
/* 开出路数:10 路板级开出(既有 4 路光耦驱动继电器 + 2026-11-18 新增 6 路普通开出) */
|
||||
#define IOBOARD_DO_COUNT 10
|
||||
|
||||
/* 开入 mask 有效位:bit0..bit7 */
|
||||
#define IOBOARD_DI_MASK_ALL ((uint8_t)((1U << IOBOARD_DI_COUNT) - 1U))
|
||||
|
||||
/* 开出 mask 有效位:bit0..bit3(bit4..bit7 无对应硬件) */
|
||||
#define IOBOARD_DO_MASK_ALL ((uint8_t)((1U << IOBOARD_DO_COUNT) - 1U))
|
||||
/* 开出 mask 有效位:bit0..bit9;PC15(bit8)为备份域限流引脚,仅作信号位 */
|
||||
#define IOBOARD_DO_MASK_ALL ((uint16_t)0x03FFU)
|
||||
|
||||
/* ======================== 纯函数 ======================== */
|
||||
|
||||
|
||||
+25
-12
@@ -22,6 +22,12 @@
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-10-25
|
||||
* 修改记录:
|
||||
* v4 2026-11-18 DTU 项目组 板级开出 4 → 10 路:dio_do_mask 由 uint8_t 加宽为
|
||||
* uint16_t(bit4..bit9 = KO_LED1/KO_LED2/KO_24V/KO4/
|
||||
* KO5/KO_LED3),UI_DATA_DO_N 4 → 10。属既有尾字段加宽
|
||||
* (非尾追加),但因 dio_do_valid 偏移 211 → 212 有静默
|
||||
* 错位风险,按 docs/UI设计/UI_数据供给设计.md §4.3 升版
|
||||
* 3 → 4;整帧仍 216 B,其余字段偏移不变
|
||||
* v3 2026-11-16 DTU 项目组 「开入开出」页数据源:实时帧尾追加
|
||||
* dio_di_mask/dio_di_valid/dio_do_mask/dio_do_valid
|
||||
* 四字段(板级 8 路开入 + 4 路开出),与 33 点遥信
|
||||
@@ -66,9 +72,12 @@ extern "C" {
|
||||
* 同时看见两份头的编译单元 App/app/ui_data_feed.c)编译期守卫钉死,BSP 物理上
|
||||
* 自证不了,所以守卫点放在写侧而不是这里 */
|
||||
#define UI_DATA_DI_N 8u
|
||||
/* 板级开出路数(v3):dio_do_mask / dio_do_valid 的位宽依据。等值守卫同上落在写侧
|
||||
* (与 Drivers/BSP/IOBOARD/ioboard.h 的 IOBOARD_DO_KO6/TRIP/ERT/CLZ 四位对表) */
|
||||
#define UI_DATA_DO_N 4u
|
||||
/* 板级开出路数(v4):dio_do_mask / dio_do_valid 的位宽依据。等值守卫同上落在写侧
|
||||
* (与 Drivers/BSP/IOBOARD/ioboard_bits.h 的 IOBOARD_DO_COUNT=10、IOBOARD_DO_MASK_ALL
|
||||
* 对表)。10 路位号:bit0 KO6 / bit1 TRIP / bit2 ERT / bit3 CLZ / bit4 KO_LED1 /
|
||||
* bit5 KO_LED2 / bit6 KO_24V / bit7 KO4 / bit8 KO5 / bit9 KO_LED3(扁平 10 路,
|
||||
* 无 LED/24V/PC15 特殊处理,语义宏定义见 Drivers/BSP/IOBOARD/ioboard.h) */
|
||||
#define UI_DATA_DO_N 10u
|
||||
|
||||
/*
|
||||
* 契约版本:结构体字段只允许尾部追加,追加即升此值并在写侧填默认值
|
||||
@@ -78,8 +87,11 @@ extern "C" {
|
||||
/* v2(2026-10-26,道F task-1):ui_data_par_t 尾追加 cal_block——版本号是页面与
|
||||
* 写侧唯一的对齐凭据,追加字段不升版 = 老页面按新帧长 memcpy 时静默错位
|
||||
* v3(2026-11-16):「开入开出」页——ui_data_rt_t 尾追加 dio_di_mask/dio_di_valid/
|
||||
* dio_do_mask/dio_do_valid(板级开入开出,208 B → 216 B,见 ui_data_rt_t 字段注) */
|
||||
#define UI_DATA_VER 3u
|
||||
* dio_do_mask/dio_do_valid(板级开入开出,208 B → 216 B,见 ui_data_rt_t 字段注)
|
||||
* v4(2026-11-18):板级开出 4 → 10 路,dio_do_mask uint8_t → uint16_t。既有尾字段
|
||||
* 加宽而非新追加,但 dio_do_valid 偏移 211 → 212:老布局消费者按新帧读会把 mask
|
||||
* 高字节(bit8/9)误当 valid 标志——同一类静默错位,按契约 §4.3 升版 */
|
||||
#define UI_DATA_VER 4u
|
||||
|
||||
/* ── 通道数量 ─────────────────────────────────────────────────────────────── */
|
||||
|
||||
@@ -182,10 +194,11 @@ typedef struct {
|
||||
* (点表 YX1~4 开关位置点在 V0.1 恒无效)。把板级开入塞进点表位图 = 拿物理引脚
|
||||
* 冒充点表事实,主站与屏会按两套语义读同一组位——那正是本仓最忌的静默错。
|
||||
* 两族字段互不引用,页面各画各的,谁改了谁也不会悄悄改到另一边。
|
||||
* 字段宽度:8 路 / 4 路各一字节即够,两块 mask/valid 合占 4 B,struct 由 208 B
|
||||
* 变 216 B(帧内 uint64_t 位图成员使整帧按 8 对齐,尾部再补 4 B);写侧共用
|
||||
* 缓冲 s_scr 因此 +8 B(宿主机单测
|
||||
* TC-UIDATA-021g 钉尺寸,改字段要同步那里) */
|
||||
* 字段宽度(v4):开入 8 路 mask/valid 各 1 B;开出 10 路 mask 需 uint16_t
|
||||
* (v3 的 4 路是 uint8_t),dio_do_valid 仍 1 B。加宽后 dio_do_mask 落在偶地址
|
||||
* 偏移 210、占 210~211,dio_do_valid 顺延到 212,尾部填充吸收后整帧仍 216 B
|
||||
* (帧内 uint64_t 位图成员使整帧按 8 对齐);写侧共用缓冲 s_scr 尺寸不变。
|
||||
* 宿主机单测 TC-UIDATA-021g/q/r 钉尺寸与偏移,改字段要同步那里 */
|
||||
uint8_t dio_di_mask; /* 8 路开入去抖后状态:bit n = 通道 n 合(1)。
|
||||
* 来源 = defaultTask 的 DI 去抖快照
|
||||
* (App/util/ioboard_di.h),写侧按序号协议
|
||||
@@ -196,9 +209,9 @@ typedef struct {
|
||||
* 新数据用**——铁律"读失败不得当全 0 上报"
|
||||
* 的落点:全 0 在现场会被读成"开入全部复归"。
|
||||
* 与本文件头的 valid(首帧)不是同一件事 */
|
||||
uint8_t dio_do_mask; /* 4 路开出影子寄存器:bit n = 吸合(1)。
|
||||
* 语义位 = IOBOARD_DO_KO6/TRIP/ERT/CLZ
|
||||
* (bit0..bit3)。⚠ 这是**软件意图**(上一次
|
||||
uint16_t dio_do_mask; /* 10 路开出影子寄存器:bit n = 吸合(1)。
|
||||
* 语义位 = IOBOARD_DO_KO6/TRIP/ERT/CLZ/KO_LED1/KO_LED2/KO_24V/KO4/KO5/KO_LED3
|
||||
* (bit0..bit9,10 路扁平位号)。⚠ 这是**软件意图**(上一次
|
||||
* 成功写入的值),不是继电器机械吸合实测——
|
||||
* 本平台没有辅助触点回读通路,页面措辞
|
||||
* 不得让人以为读到了机械反馈 */
|
||||
|
||||
+20
-16
@@ -64,11 +64,11 @@ typedef char yx_name_count_check[(sizeof(s_yx_name) / sizeof(s_yx_name[0]) == UI
|
||||
#define YX_SP_OFF "复归"
|
||||
|
||||
/*
|
||||
* 板级开入开出区(追加在 33 点遥信之后的 12 行)
|
||||
* 板级开入开出区(追加在 33 点遥信之后的 18 行)
|
||||
*
|
||||
* 为什么并入遥信页而不是单独一页:现场关心的是"这一台装置现在什么状态",
|
||||
* 把 104 点表遥信与板级开入开出分两屏看,等于要人自己把两处信息拼起来。
|
||||
* 但**并入显示不等于并入点表**:这 12 行没有进 YX_VALID_MASK、不经 iec104 上送,
|
||||
* 但**并入显示不等于并入点表**:这 18 行没有进 YX_VALID_MASK、不经 iec104 上送,
|
||||
* 它们的数据源是 dio_di_* / dio_do_*(板级 GPIO 与 74HC165),不是 yx_bits。
|
||||
* 什么时候真接进点表(占 YX5~14 预留位)由协议契约决定,不由本页决定。
|
||||
*
|
||||
@@ -76,24 +76,26 @@ typedef char yx_name_count_check[(sizeof(s_yx_name) / sizeof(s_yx_name[0]) == UI
|
||||
* (继电器线圈被驱动/未驱动,见 ioboard.h 的开出极性宏注释)。
|
||||
*
|
||||
* 硬件层面的事实(反相链路、电平检测非通断检测、极性宏在驱动层的转换、位序与开出极性
|
||||
* 的验证状态)详见 Drivers/BSP/IOBOARD/README.md 第 6 节第 3、6~7 条。
|
||||
* 的验证状态)详见 Drivers/BSP/IOBOARD/README.md「6. 已知限制」中的
|
||||
* PC15 备份域限流、极性未经原理图核对、硬件无辅助触点回读、开入位序验证状态等条目。
|
||||
* 本文件不复述,避免两处详述漂移后互相矛盾。
|
||||
*
|
||||
* 这 12 行能看到什么、看不到什么(与 33 行点表遥信同等对待,别把板级状态当点表事实):
|
||||
* 1. 开出这 4 行显示的是**软件影子寄存器**(ODR 镜像)——"我们让这一路吸合了",
|
||||
* 这 18 行能看到什么、看不到什么(与 33 行点表遥信同等对待,别把板级状态当点表事实):
|
||||
* 1. 开出这 10 行显示的是**软件影子寄存器**(ODR 镜像)——"我们让这一路吸合了",
|
||||
* 不是继电器机械触点真闭合的实测反馈,本平台没有辅助触点回读通路。
|
||||
* 2. 驱动里的 ioboard_do_read_level() 读的同样是 ODR,故它读回与本页恒等;
|
||||
* 它只用来发现"有人在驱动之外写了这 4 根引脚的 ODR",不证明光耦导通。
|
||||
* 3. 这 12 行与上面 33 行**没有任何映射关系**:上面是 104 点表(协议事实、经 iec104 上送),
|
||||
* 它只用来发现"有人在驱动之外写了这 10 根引脚的 ODR",不证明光耦导通。
|
||||
* 3. 这 18 行与上面 33 行**没有任何映射关系**:上面是 104 点表(协议事实、经 iec104 上送),
|
||||
* 这里是板级 GPIO/74HC165 物理状态(未进点表、不上送)。同屏只是"一屏看全"。
|
||||
* 4. valid 为 0 时显示「--」而不是「分/释放」:此时 mask 里可能还留着上一次的值,画成
|
||||
* "分"等于把"没数据"伪装成"已复归"。真板子上开出四行会正常显示「吸合/释放」
|
||||
* "分"等于把"没数据"伪装成"已复归"。真板子上开出十行会正常显示「吸合/释放」
|
||||
* (板端 feed 走 ioboard_do_get() 取得到影子,dio_do_valid=1);只有 PC 模拟器构建
|
||||
* 没有 ioboard 硬件时才恒为 0 显示「--」。上板看到「--」先查 feed 侧,不要改本页判定。
|
||||
* 5. 拼接边界与页数:行 0~32 = 33 点遥信(下标即 104 点表 IOA-1),行 33~44 = 板级
|
||||
* 开入开出(DI_A..DI_H + KO6/TRIP/ERT/CLZ,名表见下方 s_dio_name);合计
|
||||
* 33 + 12 = 45 行,45 / 8 行每页 = 5 满页 + 1 余页 = 6 页。拼接是**纯行号偏移**:
|
||||
* 没有第二套取数分支边界要维护,pg_refresh 里 `a_row >= UI_DATA_YX_N` 即转板级段。
|
||||
* 5. 拼接边界与页数:行 0~32 = 33 点遥信(下标即 104 点表 IOA-1),行 33~50 = 板级
|
||||
* 开入开出(DI_A..DI_H + KO6/TRIP/ERT/CLZ/KO_LED1/KO_LED2/KO_24V/KO4/KO5/KO_LED3,
|
||||
* 名表见下方 s_dio_name);合计 33 + 18 = 51 行,51 / 8 行每页 = 6 满页 + 1 余页
|
||||
* = 7 页。拼接是**纯行号偏移**:没有第二套取数分支边界要维护,
|
||||
* pg_refresh 里 `a_row >= UI_DATA_YX_N` 即转板级段。
|
||||
*/
|
||||
#define DIO_ROW_N ((uint16_t)(UI_DATA_DI_N + UI_DATA_DO_N))
|
||||
#define DIO_DI_ON "合"
|
||||
@@ -101,10 +103,12 @@ typedef char yx_name_count_check[(sizeof(s_yx_name) / sizeof(s_yx_name[0]) == UI
|
||||
#define DIO_DO_ON "吸合"
|
||||
#define DIO_DO_OFF "释放"
|
||||
|
||||
/* 12 行名表:前 8 路板级开入,后 4 路开出(照抄丝印名,全 ASCII) */
|
||||
/* 18 行名表:前 8 路板级开入,后 10 路开出(照抄丝印名,全 ASCII);
|
||||
* 开出顺序与 bit0..bit9 一一对应,改顺序 = 屏上把路号指错继电器,禁止 */
|
||||
static const char *const s_dio_name[] = {
|
||||
"DI_A", "DI_B", "DI_C", "DI_D", "DI_E", "DI_F", "DI_G", "DI_H",
|
||||
"KO6", "TRIP", "ERT", "CLZ"
|
||||
"KO6", "TRIP", "ERT", "CLZ",
|
||||
"KO_LED1", "KO_LED2", "KO_24V", "KO4", "KO5", "KO_LED3"
|
||||
};
|
||||
|
||||
/* 板级名表行数与快照点数一致(不一致 = 编译期错误,同上面 33 点名表的做法) */
|
||||
@@ -186,7 +190,7 @@ static void pg_sync(void) {
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:总行数(固定 45 行 = 33 点遥信 + 12 行板级开入开出,不随有效性增减)
|
||||
* 函数功能:总行数(固定 51 行 = 33 点遥信 + 18 行板级开入开出,不随有效性增减)
|
||||
* 入口参数:无
|
||||
* 返回值:行数 uint16_t
|
||||
* 限定条件:框架绘制/翻页链内
|
||||
@@ -262,7 +266,7 @@ static void pg_refresh(uint16_t a_row, char *a_name, char *a_value) {
|
||||
|
||||
/*
|
||||
* 页面描述符(外部链接:生成物 ui_page_registry.c 按菜单树 #page=yx 绑定引用):
|
||||
* 固定 45 行的动态页(rows=NULL + count_cb/refresh),8 行/页 = 5 满页 + 1 余页 = 6 页;band_h 必须 >0
|
||||
* 固定 51 行的动态页(rows=NULL + count_cb/refresh),8 行/页 = 6 满页 + 1 余页 = 7 页;band_h 必须 >0
|
||||
* (selectable 页选中行是黑字,无白带即不可见,同记录页约定)
|
||||
*/
|
||||
const content_page_def_t ui_page_yx_desc = {
|
||||
|
||||
+1
-1
@@ -12,4 +12,4 @@
|
||||
|
||||
* 把临时的探针,测试IEC104协议正确性的脚本都保存下来,有组织的进行存储和管理。下次可以重复利用测试。
|
||||
|
||||
* 2026-11-18 CubeMX 新增的 6 根开出脚(PC15=`KO5`、PF5=`KO4`、PF2=`KO_LED1`、PF3=`KO_LED2`、PE6=`KO_LED3`、PF4=`KO_24V`)现在只有宏和初始化、驱动没接管,有三件事要确认:①这 6 脚真实接到哪里——`docs/硬件平台/V0.1.tel` 里查不到这些网络名,网表分析报告显示它们在 V0.1 上是 U18 桥 A 侧的悬空线;②是否打算按 10 路开出规划(若按 10 路,驱动要从 `IOBOARD_DO_COUNT`=4 扩到 10、mask 位宽跟着改);③PC15 在备份域、限 ±3 mA,若当真开出用是外接三极管驱动还是换脚。(同步记录见 `docs/硬件平台/开入开出实施说明.md` §2.1)
|
||||
* 确认 6 脚真实去向及 PC15 是否外接驱动(10 路扁平开出已落地,口径见 `docs/硬件平台/开入开出实施说明.md` §2.1)
|
||||
|
||||
@@ -47,10 +47,10 @@ dhara 失败类 +84;RO 另 +208,全是该失败类名表)→ `ER_IROM1`
|
||||
<!-- MEM_SNAPSHOT:BEGIN generated by scripts/check_mem_numbers.py -->
|
||||
| 区域 | 用量 | 容量 | 占比 |
|
||||
|---|---|---|---|
|
||||
| ER_IROM1 | 415,980 B (406.23 KB) | 1,048,576 B (1024 KB) | 39.7% |
|
||||
| ER_IROM1 | 416,092 B (406.34 KB) | 1,048,576 B (1024 KB) | 39.7% |
|
||||
| RW_IRAM1 | 118,408 B (115.63 KB) | 131,072 B (128 KB) | 90.3% |
|
||||
| RW_CCM | 57,376 B (56.03 KB) | 65,280 B (64 KB) | 87.9% |
|
||||
| **Flash (ROM 合计)** | **418,268 B (408.5 KB)** | 1,048,576 B (1024 KB) | **39.9%** |
|
||||
| **Flash (ROM 合计)** | **418,380 B (408.6 KB)** | 1,048,576 B (1024 KB) | **39.9%** |
|
||||
<!-- MEM_SNAPSHOT:END -->
|
||||
|
||||
各区的容量与常量来源:
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
<!-- MEM_BUDGET:BEGIN generated by scripts/ram_baseline.py -->
|
||||
| 区域 | 用量 | 容量 | 占比 | 门禁(≤92%) |
|
||||
|---|---|---|---|---|
|
||||
| ER_IROM1 (Flash) | 415,980 B | 1,048,576 B | 39.7% | 参考 |
|
||||
| ER_IROM1 (Flash) | 416,092 B | 1,048,576 B | 39.7% | 参考 |
|
||||
| RW_CCM | 57,376 B | 65,280 B | 87.9% | PASS |
|
||||
| UNINIT_CCM | 48 B | 256 B | 18.8% | 参考 |
|
||||
| RW_IRAM1 | 118,408 B | 131,072 B | 90.3% | PASS |
|
||||
@@ -27,7 +27,7 @@
|
||||
| UI | 36,791 B | 16 KB | ⚠ 超 19.9 KB |
|
||||
| RTOS 堆 | 57,376 B | 56 KB | 堆=配额 |
|
||||
| 应用 | 47,699 B | 8 KB | ⚠ 超 38.6 KB |
|
||||
| 其它 | 10,795 B | — | 参考 |
|
||||
| 其它 | 10,797 B | — | 参考 |
|
||||
<!-- MEM_BUDGET:END -->
|
||||
|
||||
- **门禁**:pre-commit `mem-budget` 钩子(`scripts/ram_baseline.py --gate`)——
|
||||
|
||||
+59
-59
@@ -1,10 +1,10 @@
|
||||
# 开入开出板实施说明
|
||||
|
||||
> **文档定位**:V0.1 主板「开入开出板」的**实施口径**——硬件接线、时序原理、软件分层与接口、上板验证步骤、已知限制。
|
||||
> **一句话结论**:板上**能读 8 路开入、能控 4 路开出**;第二块 74HC165 的数据输出线在板上没接到 MCU,所以**开入是 8 路而不是设计的 16 路**。2026-11-18 的 CubeMX 重生成另外定义了 6 个开出引脚(PC15/PE6/PF2/PF3/PF4/PF5),**但驱动没有接管这 6 脚**,它们不在 `ioboard_do_write()` 的 4 位 mask 内——**可驱动的开出仍是 4 路**。
|
||||
> **一句话结论**:板上**能读 8 路开入、能控 10 路开出**;第二块 74HC165 的数据输出线在板上没接到 MCU,所以**开入是 8 路而不是设计的 16 路**。2026-11-18 的 CubeMX 重生成新增的 6 脚已接进 IOBOARD 驱动,开出统一按 **10 路扁平编址**:`IOBOARD_DO_COUNT=10`、mask 为 `uint16_t` 的 bit0~bit9,不再按功能分类接入。
|
||||
> **相关文档**:引脚总表与能力边界 [`硬件规格与能力边界.md`](../架构设计/硬件规格与能力边界.md);
|
||||
> 硬件缺陷登记 [`硬件改版登记.md`](../任务规划/硬件改版登记.md);V0.1 网表逐脚核对的出处 [`V0.1_网表详细分析报告.md`](V0.1_网表详细分析报告.md)。
|
||||
> **版本**:v1.2 **日期**:2026-11-18(本次:同步 CubeMX 新增的 6 个开出引脚宏,其中 PC14/PC15 在备份域)
|
||||
> **版本**:v1.3 **日期**:2026-11-18(本次:CubeMX 新增的 6 脚已接进 IOBOARD 驱动,扩成扁平 10 路开出;上一版记录 6 个开出引脚宏)
|
||||
|
||||
---
|
||||
|
||||
@@ -23,8 +23,8 @@
|
||||
|
||||
| 层次 | 状态 | 依据 |
|
||||
|---|---|---|
|
||||
| **硬件** | ✅ 已具备 | 4 路光耦继电器出口 + 74HC165 开入回路在板上实装;引脚已由 CubeMX 配好并重生成(`Inc/main.h` 有宏、`Src/gpio.c` 的 `MX_GPIO_Init` 有初值)。2026-11-18 重生成另外定义了 6 个开出引脚宏,见「MCU 侧引脚表」的注释 |
|
||||
| **驱动(BSP 硬件抽象层)** | ✅ 已实现(**只覆盖 4 路开出**) | `Drivers/BSP/IOBOARD/` 下的纯逻辑层与 GPIO/时序层,只做引脚操作与位序组装,见本文「软件结构」一节;`IOBOARD_DO_COUNT` 仍为 4,新增的 6 脚不在驱动映射表里 |
|
||||
| **硬件** | ✅ 已具备 | 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 纳入映射 |
|
||||
| **业务层** | ❌ 未接入 | 保护判据仍处**未标定闭锁**态;104 规约的遥信点表未接开入;继电器动作语义(哪路是跳闸、哪路是告警、哪路是闭锁)**尚未定义** |
|
||||
|
||||
**因此当前能做的**:用调试口读回 8 路开入的真实状态、单独驱动某一路继电器观察动作。
|
||||
@@ -44,37 +44,36 @@
|
||||
|
||||
### 2.1 MCU 侧引脚表
|
||||
|
||||
**这一节是接线与排查的对照表:每根脚叫什么宏、由谁初始化、初始电平是什么、驱动管不管它。** 表里每一行都对应 `Inc/main.h` 里的一组 `*_Pin` / `*_GPIO_Port` 宏;端口与脚号据 **2026-11-18 CubeMX 重生成**的 `STM32F407-Demo.ioc` 与 `Inc/main.h` 核对,六根新增开出的去向需硬件确认(见本节末的说明)。
|
||||
**这一节是接线与排查的对照表:每根脚叫什么宏、由谁初始化、初始电平是什么、驱动管不管它。** 表里每一行都对应 `Inc/main.h` 里的一组 `*_Pin` / `*_GPIO_Port` 宏;端口与脚号据 **2026-11-18 CubeMX 重生成**的 `STM32F407-Demo.ioc` 与 `Inc/main.h` 核对。新增 6 脚已按固定位号纳入驱动,但它们的真实去向仍需硬件确认(见本节末的说明)。
|
||||
|
||||
| 引脚 | `Inc/main.h` 宏名 | 方向 | CubeMX 初值 | 驱动是否接管 | 接到哪里 |
|
||||
|---|---|---|---|---|---|
|
||||
| PC2 | `HC165_LD_Pin` | 推挽输出 | 高(移位态) | 是(`ioboard_di_shift()`) | 两块 74HC165 的 `SH/LD`(装载脚),并联 |
|
||||
| PC3 | `HC165_CLK_Pin` | 推挽输出 | 低 | 是(`ioboard_di_shift()`) | 两块 74HC165 的 CLK,并联 |
|
||||
| PE3 | `HC165_IN2_Pin` | 输入(无上下拉) | — | 是(`ioboard_di_read()`) | 第一块 74HC165 的 QH(串行输出) |
|
||||
| PC14 | `KO6_Pin`(端口宏 `KO6_GPIO_Port` = `GPIOC`) | 推挽输出 | 低(`GPIO_PIN_RESET`,释放) | 是(开出通道 0) | 光耦 → 第 1 路继电器线圈;**本脚在备份域**,限流见本节末 |
|
||||
| PF0 | `TRIP_LED_Pin`(端口宏 `TRIP_LED_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(释放) | 是(开出通道 1) | 光耦 → 第 2 路继电器线圈 |
|
||||
| PF1 | `ERT_LED_Pin`(端口宏 `ERT_LED_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(释放) | 是(开出通道 2) | 光耦 → 第 3 路继电器线圈 |
|
||||
| PF6 | `CLZ_LED_Pin`(端口宏 `CLZ_LED_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(释放) | 是(开出通道 3) | 光耦 → 第 4 路继电器线圈 |
|
||||
| PC15 | `KO5_Pin`(端口宏 `KO5_GPIO_Port` = `GPIOC`) | 推挽输出 | 低(`GPIO_PIN_RESET`) | **否** | 网表未标 / 待硬件确认;**本脚在备份域**,限流见本节末 |
|
||||
| PE6 | `KO_LED3_Pin`(端口宏 `KO_LED3_GPIO_Port` = `GPIOE`) | 推挽输出 | 低 | **否** | 网表未标 / 待硬件确认 |
|
||||
| PF2 | `KO_LED1_Pin`(端口宏 `KO_LED1_GPIO_Port` = `GPIOF`) | 推挽输出 | 低 | **否** | 网表未标 / 待硬件确认 |
|
||||
| PF3 | `KO_LED2_Pin`(端口宏 `KO_LED2_GPIO_Port` = `GPIOF`) | 推挽输出 | 低 | **否** | 网表未标 / 待硬件确认 |
|
||||
| PF4 | `KO_24V_Pin`(端口宏 `KO_24V_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(`GPIO_PIN_RESET`,即**继电器线圈无电**) | **否** | 网表未标 / 待硬件确认;用途见下方「`KO_24V` 与继电器线圈供电」 |
|
||||
| PF5 | `KO4_Pin`(端口宏 `KO4_GPIO_Port` = `GPIOF`) | 推挽输出 | 低 | **否** | 网表未标 / 待硬件确认 |
|
||||
| PC14 | `KO6_Pin`(端口宏 `KO6_GPIO_Port` = `GPIOC`) | 推挽输出 | 低(`GPIO_PIN_RESET`,释放) | 是(bit0,语义宏 `IOBOARD_DO_KO6`) | 光耦 → 第 1 路继电器线圈;**本脚在备份域**,限流见本节末 |
|
||||
| PF0 | `TRIP_LED_Pin`(端口宏 `TRIP_LED_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(释放) | 是(bit1) | 光耦 → 第 2 路继电器线圈 |
|
||||
| PF1 | `ERT_LED_Pin`(端口宏 `ERT_LED_GPIO_Port` = `GPIOF`) | 推挽输出 | 低(释放) | 是(bit2) | 光耦 → 第 3 路继电器线圈 |
|
||||
| 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` 与继电器线圈供电」 |
|
||||
| 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..3_*` 四组端口/脚号映射(分别指向 PC14、PF0、PF1、PF6),`IOBOARD_DO_COUNT`(定义在 `Drivers/BSP/IOBOARD/ioboard_bits.h`)仍为 4;`ioboard_do_write()` 的 mask 只有 bit0~bit3 四位。表里标「**否**」的 6 根脚,是 CubeMX 侧已定义宏、`Src/gpio.c` 的 `MX_GPIO_Init` 已把它们配成推挽输出并赋低电平初值,**但 BSP 驱动既不会去写它们,也不会读回它们**——它们不是「已实现的第 5~10 路开出」。
|
||||
**表怎么看**:「驱动是否接管」一列是这一节最要紧的信息。`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 / 供电 / 信号的分类接入。
|
||||
|
||||
**这 6 根脚目前的状态,一句话说清**:
|
||||
**这 10 路开出的位号口径,一句话说清**:
|
||||
|
||||
- **已做**:CubeMX 定义了宏(`Inc/main.h`),生成了推挽输出 + 无上下拉 + 低速的初始化,初值一律 `GPIO_PIN_RESET`;
|
||||
- **未做**:没有进 `ioboard_do_write()` 的 4 位 mask、没有进 `ioboard_do_get()` / `ioboard_do_read_level()` 的影子与回读逻辑,也没有纳入 `ioboard_init()` 的静止态确认;
|
||||
- **因此在接入驱动之前,任何业务代码都不应直接对这几根脚 `HAL_GPIO_WritePin`**——绕过驱动写引脚会让影子寄存器与实际电平脱节,`ioboard_do_read_level()` 的极性核对就失去意义。
|
||||
- **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`——否则影子寄存器与实际电平脱节,极性核对失去意义。
|
||||
|
||||
**`KO_24V` 与继电器线圈供电**:按命名,`KO_24V`(PF4)应是 4 路继电器线圈的 **24 V 供电使能**——**线圈没有 24 V 就不会吸合**,所以任何使某路继电器吸合的动作,都必须**先**把 `KO_24V` 置为有效电平、再写对应开出路。上电时 CubeMX 把它初始化为低电平,即**默认线圈无电、不会误吸合**,这与 §4.4「上电默认态」的安全目标一致。但要注意三条边界:
|
||||
**`KO_24V` 与继电器线圈供电**:按命名,`KO_24V`(PF4)应是继电器线圈的 **24 V 供电使能**——**线圈没有 24 V 就不会吸合**。驱动现在把 `KO_24V` 当普通开出路 bit6 写(语义宏 `IOBOARD_DO_KO_24V`),**仍没有联锁逻辑**;上层若要据此控继电器,须自行保证先供电后吸合,不要在驱动层期待自动顺序。上电时 CubeMX 把它初始化为低电平,即**默认线圈无电、不会误吸合**,这与 §4.4「上电默认态」的安全目标一致。但要注意两条边界:
|
||||
|
||||
1. PF4 的实际走线在现有网表里查不到网络名(见下段),「24 V 使能」目前只是**引脚命名与用户口述**的口径,未经网表或台架证实;
|
||||
2. 驱动没有接管 PF4,`ioboard_do_write()` 也**不会**自动置它——将来把开出扩到更多路时,必须把「先给线圈供电、再吸合」的顺序写进驱动,不能留给上层每处自己记得;
|
||||
3. 由于驱动不碰 PF4,目前它始终保持上电初值(低),所以**即使有人手工驱动了某一根开出脚,继电器也不会吸合**——这是当前状态的安全侧。
|
||||
2. 是否真的存在「先供电后吸合」的硬件时序,同样未经证实;驱动不实现联锁、也不替上层保证顺序,上层必须按实际硬件自行处理。
|
||||
|
||||
**为什么这 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`。
|
||||
|
||||
@@ -82,31 +81,33 @@
|
||||
|
||||
- 它们**不能**直接驱动光耦或继电器的线圈电流,只能作为控制信号去带外部三极管/MOS 管;
|
||||
- CubeMX 给这两根脚配的是普通推挽输出、无上下拉、低速(`GPIO_SPEED_FREQ_LOW`)——速度约束满足,但**电流约束 CubeMX 管不了,要由外部电路保证**;
|
||||
- 对 PC14(`KO6_Pin`,第 1 路继电器)来说,这条限制**已经存在**:驱动把它当普通推挽输出写,一旦光耦输入侧的负载超过 ±3 mA,出口可靠性就没有保证;
|
||||
- 对 PC15(`KO5_Pin`)来说,这是它**能不能当开出用**的前提条件——接线与选型确认之前不要把它规划成一路继电器出口。
|
||||
- 对 PC14(`KO6_Pin`,bit0)来说,这条限制**已经存在**:驱动把它当普通推挽输出写,一旦光耦输入侧的负载超过 ±3 mA,出口可靠性就没有保证;
|
||||
- 对 PC15(`KO5_Pin`,bit8)来说,它**仅作信号位、不驱动继电器**;±3 mA / 2 MHz / 30 pF 的限制始终成立,是否外接驱动、能否承担实际出口,须待硬件确认。
|
||||
|
||||
### 2.1.1 本次同步的变更记录与未完成项
|
||||
### 2.1.1 本次同步的变更记录与剩余限制
|
||||
|
||||
**读这一小节是为了分清「哪些已由 CubeMX 落地、哪些还欠驱动」**,免得把引脚定义当成功能完成。
|
||||
**读这一小节是为了分清「哪些已由 CubeMX 落地、哪些已由驱动接管」,免得把引脚定义当成功能完成,也免得把已完成的接入还当成待办。**
|
||||
|
||||
2026-11-18 的 CubeMX 重生成相对上一版**新增了 6 组宏**,全部为 `GPIO_Output` + `Locked=true`(锁定,防止后续重生成被改回默认网络):
|
||||
|
||||
| 宏名 | 端口宏 | 脚 |
|
||||
| 语义宏 | 引脚 | bit |
|
||||
|---|---|---|
|
||||
| `KO5_Pin` | `KO5_GPIO_Port` = `GPIOC` | PC15 |
|
||||
| `KO4_Pin` | `KO4_GPIO_Port` = `GPIOF` | PF5 |
|
||||
| `KO_LED1_Pin` | `KO_LED1_GPIO_Port` = `GPIOF` | PF2 |
|
||||
| `KO_LED2_Pin` | `KO_LED2_GPIO_Port` = `GPIOF` | PF3 |
|
||||
| `KO_LED3_Pin` | `KO_LED3_GPIO_Port` = `GPIOE` | PE6 |
|
||||
| `KO_24V_Pin` | `KO_24V_GPIO_Port` = `GPIOF` | PF4 |
|
||||
| `IOBOARD_DO_KO_LED1` | PF2 | bit4 |
|
||||
| `IOBOARD_DO_KO_LED2` | PF3 | bit5 |
|
||||
| `IOBOARD_DO_KO_24V` | PF4 | bit6 |
|
||||
| `IOBOARD_DO_KO4` | PF5 | bit7 |
|
||||
| `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 路。
|
||||
|
||||
| 未完成项 | 现状 | 缺口 |
|
||||
**剩余限制**(不改变「驱动已接管 10 路」的事实,仍需硬件或上层处理):
|
||||
|
||||
| 剩余限制 | 现状 | 去向 |
|
||||
|---|---|---|
|
||||
| 6 根新脚纳入 BSP 驱动 | `ioboard.c` 的 `IOBOARD_DO_CH_GPIO_0..3_*` 仍只有 4 路,`IOBOARD_DO_COUNT` = 4 | 需先由硬件确认去向与驱动级(是否经光耦/三极管),再扩 `IOBOARD_DO_COUNT`、扩展 mask 位数、把 PC15 的 3 mA 约束写进驱动注释 |
|
||||
| PC15 备份域限流 | CubeMX 已按普通推挽输出配置 | 硬件选型确认前不能规划为继电器出口 |
|
||||
| `KO_24V` 供电时序 | 仅引脚定义存在 | 驱动接管后需保证「先供电后吸合」 |
|
||||
| 6 脚真实去向未确认 | 网表查不到这些网络名,只知 CubeMX 宏与位号 | `docs/任务规划/待处理疑问.md` |
|
||||
| PC15 备份域限流 | ±3 mA / ≤2 MHz / ≤30 pF,仅作信号位、不驱动继电器 | 见本节「PC14 与 PC15 在备份域」 |
|
||||
| `KO_24V` 供电联锁 | 驱动把它当普通 bit6 写,**没有联锁逻辑** | 上层若要据此控继电器,须自行保证先供电后吸合 |
|
||||
|
||||
### 2.2 74HC165 侧:两块芯片共用两根控制线,数据线只有一根
|
||||
|
||||
@@ -123,7 +124,7 @@
|
||||
因此:
|
||||
|
||||
- **不要**把 PE2/PE4 当成可用的开入通道,读到什么都无意义;
|
||||
- `Drivers/BSP/IOBOARD/` 的驱动**完全不碰这两根脚**(只初始化并在读操作里使用 PC2/PC3/PE3 与 4 根开出);
|
||||
- `Drivers/BSP/IOBOARD/` 的驱动**完全不碰这两根脚**(只在初始化与读操作里使用 PC2/PC3/PE3 与 10 路开出);
|
||||
- 这两根脚的初始化留在 CubeMX 生成代码里,是历史遗留,不影响功能,但清理需要动 `USER CODE` 区之外的配置,**留给硬件改版时一并定夺**。
|
||||
|
||||
---
|
||||
@@ -253,12 +254,12 @@
|
||||
|
||||
| 接口 | 职责 | 参数语义 |
|
||||
|---|---|---|
|
||||
| `ioboard_init()` | 初始化:确认静止态、把 4 路开出置为全释放、清影子寄存器 | 无。返回 `BSP_ERR_STATE` 表示静止态确认失败(引脚被别人动过) |
|
||||
| `ioboard_init()` | 初始化:确认静止态、把 10 路开出置为全释放、清影子寄存器 | 无。返回 `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(uint8_t mask)` | 写一次 4 路开出 | mask 的 bit0 到 bit3 分别对应 4 路;**1 = 继电器吸合**,与硬件电平高低无关。高 4 位会被静默丢弃(函数体内 `mask & IOBOARD_DO_MASK_ALL` 只留低 4 位),即 **bit4 及以上写什么都不会作用到任何引脚**——2026-11-18 新增的 6 根开出脚(PC15/PE6/PF2/PF3/PF4/PF5)不在这个 mask 里 |
|
||||
| `ioboard_do_get(uint8_t *out_mask)` | 取软件影子寄存器里的当前开出 mask | 读的是驱动认为的状态,不读引脚 |
|
||||
| `ioboard_do_read_level(uint8_t *out_level)` | 直接读 4 根开出引脚的**实际电平** | 用于极性核对:与 `ioboard_do_get()` 对不上,说明有人在驱动之外动过这 4 根脚 |
|
||||
| `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()` 对不上,说明有人在驱动之外动过这些脚 |
|
||||
|
||||
**mask 里 1 的含义**:开入 mask 的 1 = 该路**有信号**(触点闭合 / 压板投入);开出 mask 的 1 = 该路**继电器吸合**。两个方向的 1 都代表"该通道处于激活态",与硬件电平的高低**无关**——电平极性的换算在驱动内部完成。
|
||||
|
||||
@@ -272,11 +273,11 @@
|
||||
|
||||
### 4.4 上电默认态
|
||||
|
||||
`ioboard_init()` 会把 4 路开出置为**全释放**并清影子寄存器。这是安全设计:上电默认所有出口不动作。
|
||||
`ioboard_init()` 会把 10 路开出置为**全释放**并清影子寄存器。这是安全设计:上电默认所有出口不动作。
|
||||
|
||||
但要注意**从上电到 `ioboard_init()` 执行之间**有一段窗口,这期间引脚电平由 CubeMX 生成的初值决定(见「硬件接线」的引脚表),驱动管不到。因此上板验证时**务必观察上电瞬间有没有误吸合**,这是「开出:逐路验证继电器动作」一节的第一条。
|
||||
|
||||
2026-11-18 新增的 6 根开出脚**不在 `ioboard_init()` 的静止态确认与全释放范围内**:它们的电平从复位起就由 `Src/gpio.c` 的 `MX_GPIO_Init` 写死的低电平决定,驱动既不清也不查。`KO_24V`(PF4)因此在整机运行期间始终为低,按「24 V 线圈供电使能」的口径即**线圈无电**,继电器不会吸合。
|
||||
2026-11-18 新增的 6 脚已在 v1.3 纳入 `ioboard_init()` 的静止态确认与全释放范围。`KO_24V`(PF4)因此也由驱动写低电平初值;若按「24 V 线圈供电使能」的口径,即默认线圈无电——但这一口径未经网表或台架证实,驱动也没有供电联锁逻辑。
|
||||
|
||||
### 4.5 时序实现要点
|
||||
|
||||
@@ -318,16 +319,16 @@
|
||||
|
||||
**目的**:确认"置哪一位,动的是哪一路继电器",以及上电时确实全释放。
|
||||
|
||||
1. **上电瞬间**:听/看 4 路继电器,**都不应有吸合动作**。判据:全部处于释放态。
|
||||
1. **上电瞬间**:先听/看既有 4 路继电器,**都不应有吸合动作**。判据:全部处于释放态;新增 6 脚的真实去向在网表里查不到,只能用万用表或调试器读电平,不能把电平变化直接当成继电器动作。
|
||||
2. 用万用表(通断档或电阻档)接在某一路继电器的**触点两端**,先确认释放态读数是常开(断路)或常闭(导通),记下来。
|
||||
3. 只置 **bit0**(mask = 0x01),观察:该路继电器**有吸合声**、触点状态翻转;**其余 3 路不动**。
|
||||
4. 逐位重复:mask = 0x02 / 0x04 / 0x08,确认每一路都只对应一个 bit。
|
||||
5. 写 **全 1**(mask = 0x0F),确认 4 路**同时**吸合——这一步是「4 路开出分属两个端口」那条限制的现场确认。
|
||||
6. 最后写 mask = 0x00,确认 4 路全部回到释放态。
|
||||
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 路,别顺手去点新加的那 6 根脚。** 2026-11-18 新增的 PC15/PE6/PF2/PF3/PF4/PF5 虽然已由 CubeMX 配成推挽输出,但去向在网表里查不到(§2.1),PC15 还受备份域 ±3 mA 限制。要单独观察其中某根脚的电平,只允许用调试器或万用表**读**;**不要**在业务代码里 `HAL_GPIO_WritePin` 写它们——绕开驱动写引脚会让 `ioboard_do_get()` 的影子寄存器与实际电平脱节。将来给 `KO_24V` 通电做继电器测试时,必须**先**置 PF4 使线圈有 24 V、再写开出路,顺序反了只会看到「写了但不吸合」。
|
||||
**注意新增 6 脚的验证边界**:PF2/PF3/PF4/PF5/PC15/PE6 虽已纳入驱动并固定在 bit4~bit9,但 `docs/硬件平台/V0.1.tel` 里查不到这些网络名(见 §2.1),不能用「网表推测的继电器路数」当判据;PC15 还受备份域 ±3 mA 限制,只允许当信号位观察电平。`KO_24V`(bit6)由驱动当普通开出路写,**没有供电联锁逻辑**;若要据此做继电器测试,须由上层自行保证先供电后吸合。
|
||||
|
||||
**注意极性**:软件 mask 的 1 = 吸合,与硬件电平的高低无关,由驱动内部转换。若发现"写 1 反而不吸合",改 `Drivers/BSP/IOBOARD/ioboard.h` 的 `IOBOARD_DO_LEVEL_ACTIVE` 这一个宏即可,**不要在上层逐路取反**。判断当前极性是否正确的快捷办法:调 `ioboard_do_read_level()` 读实际引脚电平,再和 `ioboard_do_get()` 的影子寄存器对照——两者对不上说明有人在驱动之外动过这 4 根脚。
|
||||
**注意极性**:软件 mask 的 1 = 吸合,与硬件电平的高低无关,由驱动内部转换。若发现"写 1 反而不吸合",改 `Drivers/BSP/IOBOARD/ioboard.h` 的 `IOBOARD_DO_LEVEL_ACTIVE` 这一个宏即可,**不要在上层逐路取反**。判断当前极性是否正确的快捷办法:调 `ioboard_do_read_level()` 读实际引脚电平,再和 `ioboard_do_get()` 的影子寄存器对照——两者对不上说明有人在驱动之外动过这些脚。
|
||||
|
||||
**状态**:待台架验证。
|
||||
|
||||
@@ -386,20 +387,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 4 路开出分属两个端口(同步性限制)
|
||||
### 6.2 10 路开出分属三个端口(同步性限制)
|
||||
|
||||
4 路开出里 PC14 在 GPIOC、PF0/PF1/PF6 在 GPIOF,所以要写两次 `BSRR`(每个端口各一次)。两次写之间相隔几条指令(约 10 ns 量级),业务层面不可观测;但如果将来对 4 路的**严格同时性**有要求,得在硬件上把这 4 路挪到同一个端口,软件侧无法再压缩。
|
||||
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 路的**严格同时性**有要求,软件侧无法再压缩——只能改硬件,把这些路挪到同一个端口。
|
||||
|
||||
**2026-11-18 之后这条限制的口径**:`IOBOARD_DO_COUNT` 仍是 4,驱动只写 4 路,所以「两个端口」的结论不变。新增的 6 根开出脚分布在三个端口(PC15 在 GPIOC;PE6 在 GPIOE;PF2/PF3/PF4/PF5 在 GPIOF),**将来**若把它们接进驱动、扩到更多路继电器出口,端口数会从 2 增到 3,每次写 mask 最多要写三次 `BSRR`,同步性限制会在原有基础上再变差——扩路之前要把这一点算进设计,而不是等台架上发现不同时。
|
||||
**这条限制在 v1.3 的口径**:`IOBOARD_DO_COUNT=10`,驱动写满 bit0~bit9,「三个端口、C→F→C→E 四段、整组写最多 4 次 BSRR」是当前事实;相比旧版只写 4 路、两个端口、2 次 BSRR,同步性进一步变差。把它算进设计,不要等台架上才发现不同时。
|
||||
|
||||
### 6.3 继电器动作语义属业务层,本文档不定义
|
||||
|
||||
4 路开出分别对应"跳闸""告警""闭锁"还是别的含义,**不在本文档定义**。这是保护逻辑层的职责,去向:
|
||||
10 路开出分别对应"跳闸""告警""闭锁"还是别的含义,**不在本文档定义**。这是保护逻辑层的职责,去向:
|
||||
|
||||
- 保护判据与动作逻辑 → `docs/算法/采集与算法层设计说明.md`、`docs/算法/继电保护功能复现规划.md`
|
||||
- 104 规约的遥信/遥控点表 → `docs/子系统设计/IEC104上行设计说明.md`
|
||||
|
||||
在业务层把这些定义清楚之前,**4 路开出只能用于台架验证,不得用于真实跳闸**。
|
||||
在业务层把这些定义清楚之前,**这 10 路开出只能用于台架验证,不得用于真实跳闸**;新增 6 脚的真实去向尚未由网表确认,PC15 仅作信号位。
|
||||
|
||||
### 6.4 保护判据未标定闭锁(承重限制)
|
||||
|
||||
@@ -411,7 +412,6 @@
|
||||
|
||||
| 未接入项 | 现状 | 去向 |
|
||||
|---|---|---|
|
||||
| 新增 6 根开出脚(PC15/PE6/PF2/PF3/PF4/PF5)接进驱动 | 只有 CubeMX 宏与初始化,BSP 驱动零引用 | 先由硬件确认去向与驱动级,再扩 `IOBOARD_DO_COUNT` 与 mask 位宽,见 §2.1.1 |
|
||||
| 开入去抖 | 未实现 | 业务层接线任务,落点在 `App/task/default_task.c` |
|
||||
| 开入 → 104 遥信点表 | 未接入 | `docs/子系统设计/IEC104上行设计说明.md` |
|
||||
| UI 遥信配置页(遥信类型/防抖/双点遥信) | 三叶未绑,原因是**缺数据源**而非缺硬件 | `docs/UI设计/页面补齐规划.md` |
|
||||
|
||||
@@ -23,4 +23,4 @@ date code ro rw zi er_irom1 er_pct iram1 iram1_pct ccm ccm_pct top_rwzi
|
||||
2026-11-11 256024 31760 2080 152368 287784 27.4 97024 74.0 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;ui_net_sink.o=6802;ui_port.o=6432;wave_ring.o=5332;sb_link.o=4376;ch395f.o=4162;console_log.o=4132
|
||||
2026-11-13 256592 32036 2088 152584 288628 27.5 97248 74.2 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;ui_net_sink.o=6802;ui_port.o=6432;wave_ring.o=5332;sb_link.o=4376;ch395f.o=4162;console_log.o=4132
|
||||
2026-11-15 256592 32036 2088 152584 288628 27.5 97248 74.2 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;ui_net_sink.o=6802;ui_port.o=6432;wave_ring.o=5332;sb_link.o=4376;ch395f.o=4162;console_log.o=4132
|
||||
2026-11-18 367488 48492 2288 173544 415980 39.7 118408 90.3 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;iec104_tcpserver.o=7656;ui_net_sink.o=6802;ui_port.o=6432;iec104_source.o=5944;wave_ring.o=5332;sb_link.o=4376
|
||||
2026-11-18 367488 48604 2288 173544 416092 39.7 118408 90.3 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;iec104_tcpserver.o=7656;ui_net_sink.o=6802;ui_port.o=6432;iec104_source.o=5944;wave_ring.o=5332;sb_link.o=4376
|
||||
|
||||
|
@@ -1,17 +1,17 @@
|
||||
{
|
||||
"built_at": "2026-11-18T12:31:56+08:00",
|
||||
"fingerprint": "c2e9d2f36bf2232d1ba145f336fa835b5877e4d2b7e55fb1f30bd76ea48b9484",
|
||||
"built_at": "2026-11-18T14:25:14+08:00",
|
||||
"fingerprint": "9845ece8f91825fd88a918396c54bf22a2beb01b18f34b44fcfc8e10c447481b",
|
||||
"fingerprint_files": 1583,
|
||||
"fingerprint_source": "git-index",
|
||||
"gated_regions": [
|
||||
"RW_IRAM1",
|
||||
"RW_CCM"
|
||||
],
|
||||
"git_head": "795ce970a2e8a411244bb638d7f49c99507b0667",
|
||||
"git_head": "afd43f51e81cc072d2ac1eaa7492d9621a62daef",
|
||||
"map": "MDK-ARM/STM32F407-Demo/STM32F407-Demo.map",
|
||||
"map_mtime": 1794976218,
|
||||
"map_mtime": 1794983104,
|
||||
"pct": {
|
||||
"ER_IROM1": 39.67,
|
||||
"ER_IROM1": 39.68,
|
||||
"RW_CCM": 87.89,
|
||||
"RW_IRAM1": 90.34,
|
||||
"UNINIT_CCM": 18.75
|
||||
@@ -19,7 +19,7 @@
|
||||
"regions": {
|
||||
"ER_IROM1": {
|
||||
"max": 1048576,
|
||||
"size": 415980
|
||||
"size": 416092
|
||||
},
|
||||
"RW_CCM": {
|
||||
"max": 65280,
|
||||
@@ -38,7 +38,7 @@
|
||||
"scope_note": "\u540c\u7801\u51ed\u8bc1\uff1a\u6307\u7eb9\u8986\u76d6\u56fa\u4ef6\u4f53\u79ef\u76f8\u5173\u6e90\u7801\uff0c\u53e3\u5f84\u89c1\u672c\u811a\u672c docstring",
|
||||
"sizes": {
|
||||
"code": 367488,
|
||||
"ro_data": 48492,
|
||||
"ro_data": 48604,
|
||||
"rw_data": 2288,
|
||||
"zi_data": 173544
|
||||
},
|
||||
|
||||
@@ -78,11 +78,14 @@ PAGES = [
|
||||
# yxp2 再多按 8 次下移,让选中行跨过页边界落到第 2 页首行
|
||||
("yx", "dedde"),
|
||||
("yxp2", "dedde dddddddd"),
|
||||
# 遥信页 33→45 行(板级开入开出 12 行追加在末尾),8 行/页 → 6 页:
|
||||
# 第 5 页 = row32(过流Ⅲ段) + row33..39(DI_A..DI_G),第 6 页 = row40(DI_H) + row41..44(KO6/TRIP/ERT/CLZ)。
|
||||
# 每段 dddddddd = 8 次下移翻一页;从第 1 页到第 6 页共 5 段。
|
||||
# 遥信页 33→51 行(板级开入开出 18 行 = 8 DI + 10 DO 追加在末尾),8 行/页 → 7 页:
|
||||
# 第 5 页 = row32(YX33) + row33..39(DI_A..DI_G),
|
||||
# 第 6 页 = row40(DI_H) + row41..47(KO6/TRIP/ERT/CLZ/KO_LED1/KO_LED2/KO_24V);
|
||||
# 第 7 页 = row48..50(KO4/KO5/KO_LED3) + 5 个空行。
|
||||
# 每段 dddddddd = 8 次下移翻一页;从第 1 页到第 N 页共 N-1 段。
|
||||
("yxp5", "dedde dddddddd dddddddd dddddddd dddddddd"),
|
||||
("yxp6", "dedde dddddddd dddddddd dddddddd dddddddd dddddddd"),
|
||||
("yxp7", "dedde dddddddd dddddddd dddddddd dddddddd dddddddd dddddddd"),
|
||||
# SOE 记录(node 51,记录查询下第 1 项):6 下进记录查询 → e → 首项 SOE记录 → e;
|
||||
# 数据 = simulator/main.c 的固定 3 条假记录(含 type 7 未标定闭锁这条非元件支路)
|
||||
("soe", "dddddde e"),
|
||||
@@ -396,12 +399,12 @@ TEXTS = {
|
||||
("r5名", "未标定闭锁", (94, 108), False),
|
||||
("页脚", "第 1 页,共 1 页", (140, 160), False),
|
||||
],
|
||||
# ── 批 4:遥信量(33 点固定名表,5 页)──
|
||||
# ── 批 4:遥信量(33 点固定名表 + 18 行板级开入开出 = 51 行,7 页)──
|
||||
# 第 1 页 8 行**全是 --**(位置 1~4 是无硬件的双点,YX5~8 点表未定义)——这不是画面坏了,
|
||||
# 是 V0.1 的真实状态:27 个点没有开入来源。方案 B(只显有效点)会把这件事藏起来,方案 A
|
||||
# 是 V0.1 的真实状态:这些点没有开入来源。方案 B(只显有效点)会把这件事藏起来,方案 A
|
||||
# 让现场能逐点对、也能一眼看出缺哪些点(取舍见 页面扩充详细方案.md §3.1.3)。
|
||||
# 第 2 页才出现有来源的点(故障总 / 过流Ⅰ段 = 复归);两页合起来同时钉住分页数学:
|
||||
# 33 行 / 8 行每页 = 5 页,页码算错这里直接响。
|
||||
# 第 2 页才出现有来源的点(故障总 / 过流Ⅰ段 = 复归);末页补 18 行板级 DI/DO:
|
||||
# 51 行 / 8 行每页 = 6 满页 + 1 余页 = 7 页,页码算错这里直接响。
|
||||
"yx": [
|
||||
("标题", "遥信量", (0, 24), False),
|
||||
("r0名", "位置1", (24, 38), True),
|
||||
@@ -420,7 +423,7 @@ TEXTS = {
|
||||
("r6值", "--", (108, 122), False),
|
||||
("r7名", "YX8", (122, 136), False),
|
||||
("r7值", "--", (122, 136), False),
|
||||
("页脚", "第 1 页,共 6 页", (140, 160), False),
|
||||
("页脚", "第 1 页,共 7 页", (140, 160), False),
|
||||
],
|
||||
"yxp2": [
|
||||
("标题", "遥信量", (0, 24), False),
|
||||
@@ -440,7 +443,7 @@ TEXTS = {
|
||||
("r6值", "复归", (108, 122), False),
|
||||
("r7名", "过流Ⅰ段", (122, 136), False),
|
||||
("r7值", "复归", (122, 136), False),
|
||||
("页脚", "第 2 页,共 6 页", (140, 160), False), # 选中行落到第 2 页首行(YX9);页码同时钉住 45/8 = 6 页
|
||||
("页脚", "第 2 页,共 7 页", (140, 160), False), # 选中行落到第 2 页首行(YX9);页码同时钉住 51/8 = 7 页
|
||||
],
|
||||
# 第 5 页:row32 = YX33,row33..39 = DI_A..DI_G(板级开入,模拟器无数据源 → 值恒 --)
|
||||
"yxp5": [
|
||||
@@ -461,9 +464,10 @@ TEXTS = {
|
||||
("r6值", "--", (108, 122), False),
|
||||
("r7名", "DI_G", (122, 136), False),
|
||||
("r7值", "--", (122, 136), False),
|
||||
("页脚", "第 5 页,共 6 页", (140, 160), False),
|
||||
("页脚", "第 5 页,共 7 页", (140, 160), False),
|
||||
],
|
||||
# 第 6 页:row40 = DI_H,row41..44 = KO6/TRIP/ERT/CLZ(开出,模拟器无 ioboard → --)
|
||||
# 第 6 页:row40 = DI_H,row41..47 = KO6/TRIP/ERT/CLZ/KO_LED1/KO_LED2/KO_24V
|
||||
# (开出,模拟器无 ioboard → 值恒 "--")
|
||||
"yxp6": [
|
||||
("标题", "遥信量", (0, 24), False),
|
||||
("r0名", "DI_H", (24, 38), True),
|
||||
@@ -476,7 +480,24 @@ TEXTS = {
|
||||
("r3值", "--", (66, 80), False),
|
||||
("r4名", "CLZ", (80, 94), False),
|
||||
("r4值", "--", (80, 94), False),
|
||||
("页脚", "第 6 页,共 6 页", (140, 160), False),
|
||||
("r5名", "KO_LED1", (94, 108), False),
|
||||
("r5值", "--", (94, 108), False),
|
||||
("r6名", "KO_LED2", (108, 122), False),
|
||||
("r6值", "--", (108, 122), False),
|
||||
("r7名", "KO_24V", (122, 136), False),
|
||||
("r7值", "--", (122, 136), False),
|
||||
("页脚", "第 6 页,共 7 页", (140, 160), False),
|
||||
],
|
||||
# 第 7 页(51 行的余页):row48..50 = KO4/KO5/KO_LED3,行 51..55 为空(只 3 行有数据)。
|
||||
"yxp7": [
|
||||
("标题", "遥信量", (0, 24), False),
|
||||
("r0名", "KO4", (24, 38), True),
|
||||
("r0值", "--", (24, 38), True),
|
||||
("r1名", "KO5", (38, 52), False),
|
||||
("r1值", "--", (38, 52), False),
|
||||
("r2名", "KO_LED3", (52, 66), False),
|
||||
("r2值", "--", (52, 66), False),
|
||||
("页脚", "第 7 页,共 7 页", (140, 160), False),
|
||||
],
|
||||
# ── 批 3:参数定值 → 查看 四页(数据 = prot_set 出厂默认,值串带单位)──
|
||||
# 名与值两列都断:值列断的是换算后的小数位与单位——光看像素,没人会去核 0.95 是不是被
|
||||
@@ -900,10 +921,18 @@ ABSENT = {
|
||||
("开入无数据不画合", "合", (38, 136), False),
|
||||
],
|
||||
"yxp6": [
|
||||
("开出无数据不画释放", "释放", (38, 94), False),
|
||||
("开出无数据不画吸合", "吸合", (38, 94), False),
|
||||
# row41..47 = KO6/TRIP/ERT/CLZ/KO_LED1/KO_LED2/KO_24V(全为普通行,inv=False)
|
||||
("开出无数据不画释放", "释放", (38, 136), False),
|
||||
("开出无数据不画吸合", "吸合", (38, 136), False),
|
||||
("开入H无数据不画分", "分", (24, 38), True), # r0 是选中行(白带),inv=True
|
||||
],
|
||||
"yxp7": [
|
||||
# row48..50 = KO4/KO5/KO_LED3;r0 选中行白带 inv=True,r1/r2 普通行 inv=False
|
||||
("开出r0无数据不画释放", "释放", (24, 38), True),
|
||||
("开出r0无数据不画吸合", "吸合", (24, 38), True),
|
||||
("开出无数据不画释放", "释放", (38, 66), False),
|
||||
("开出无数据不画吸合", "吸合", (38, 66), False),
|
||||
],
|
||||
# ---- 道F task-3:反向断言钉的是"规矩本身",不依赖参考图 ----
|
||||
# 1970 那条是本页最值钱的反向断言:记录侧的占位串一旦漏进时钟页,
|
||||
# 用户一次"照抄保存"就把 1970 写进 RTC(口径见 ui_page_clock.c 的 CK_INVAL 注)
|
||||
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -1,6 +1,6 @@
|
||||
/******************************************************************************
|
||||
* 模块名称:开入开出板(IOBOARD)板级测试套件
|
||||
* 模块功能:为 74HC165 八路开入与四路光耦继电器开出提供台架观察窗口——
|
||||
* 模块功能:为 74HC165 八路开入与十路开出提供台架观察窗口——
|
||||
* 逐路给出「哪一路变了 / 变成什么」,而不是只给一个 0xFF 的混合图样。
|
||||
*
|
||||
* 为什么是**半自动**(本平台三条事实决定了它不能做成交互式):
|
||||
@@ -85,13 +85,13 @@
|
||||
/* 开入/开出路数的编译期一致性钉:ioboard.h 与 ioboard_di.h 刻意互不 include
|
||||
* (后者是纯逻辑层),两者的一致性由这里钉死。 */
|
||||
#define IOBOARD_TEST_DI_COUNT_EXPECT 8U
|
||||
#define IOBOARD_TEST_DO_COUNT_EXPECT 4U
|
||||
#define IOBOARD_TEST_DO_COUNT_EXPECT 10U
|
||||
|
||||
#if (IOBOARD_DI_COUNT != IOBOARD_TEST_DI_COUNT_EXPECT)
|
||||
#error "IOBOARD_DI_CH_NUM/IOBOARD_DI_COUNT must be 8 (suite assumes 8 DI channels)"
|
||||
#endif
|
||||
#if (IOBOARD_DO_COUNT != IOBOARD_TEST_DO_COUNT_EXPECT)
|
||||
#error "IOBOARD_DO_COUNT must be 4 (suite assumes 4 DO channels)"
|
||||
#error "IOBOARD_DO_COUNT must be 10 (suite assumes 10 DO channels)"
|
||||
#endif
|
||||
|
||||
#if (IOBOARD_TEST_DI_SAMPLE_GAP_MS > IOBOARD_TEST_DI_SAMPLE_GAP_MAX_MS)
|
||||
@@ -102,7 +102,7 @@
|
||||
#endif
|
||||
|
||||
#define IOBOARD_TEST_DI_MASK_ALL ((uint8_t)IOBOARD_DI_MASK_ALL)
|
||||
#define IOBOARD_TEST_DO_MASK_ALL ((uint8_t)IOBOARD_DO_MASK_ALL)
|
||||
#define IOBOARD_TEST_DO_MASK_ALL ((uint16_t)IOBOARD_DO_MASK_ALL)
|
||||
|
||||
/* 进入各 Phase 前把统计清零:TEST_REPORT_IMPL 只打印、不自清零,若不清,
|
||||
* Phase N 的汇总行会带上 Phase 1..N-1 的累计失败数(台架 2026-11-16 实证:
|
||||
@@ -125,13 +125,17 @@ static const char *const k_di_name[IOBOARD_TEST_DI_COUNT_EXPECT] = {
|
||||
"DI_A", "DI_B", "DI_C", "DI_D", "DI_E", "DI_F", "DI_G", "DI_H"
|
||||
};
|
||||
|
||||
/* 开出通道名(与八位语义位的顺序一一对应,见 ioboard.h 的 IOBOARD_DO_* 宏) */
|
||||
static const uint8_t k_do_bit[IOBOARD_TEST_DO_COUNT_EXPECT] = {
|
||||
(uint8_t)IOBOARD_DO_KO6, (uint8_t)IOBOARD_DO_TRIP,
|
||||
(uint8_t)IOBOARD_DO_ERT, (uint8_t)IOBOARD_DO_CLZ
|
||||
/* 开出通道名(与十位语义位的顺序一一对应,见 ioboard.h 的 IOBOARD_DO_* 宏) */
|
||||
static const uint16_t k_do_bit[IOBOARD_TEST_DO_COUNT_EXPECT] = {
|
||||
(uint16_t)IOBOARD_DO_KO6, (uint16_t)IOBOARD_DO_TRIP,
|
||||
(uint16_t)IOBOARD_DO_ERT, (uint16_t)IOBOARD_DO_CLZ,
|
||||
(uint16_t)IOBOARD_DO_KO_LED1, (uint16_t)IOBOARD_DO_KO_LED2,
|
||||
(uint16_t)IOBOARD_DO_KO_24V, (uint16_t)IOBOARD_DO_KO4,
|
||||
(uint16_t)IOBOARD_DO_KO5, (uint16_t)IOBOARD_DO_KO_LED3
|
||||
};
|
||||
static const char *const k_do_name[IOBOARD_TEST_DO_COUNT_EXPECT] = {
|
||||
"KO6", "TRIP", "ERT", "CLZ"
|
||||
"KO6", "TRIP", "ERT", "CLZ",
|
||||
"KO_LED1", "KO_LED2", "KO_24V", "KO4", "KO5", "KO_LED3"
|
||||
};
|
||||
|
||||
/* Phase 1 的单比特结果(0 = 本路未通过,不进双射核对的集合) */
|
||||
@@ -162,20 +166,20 @@ static void ioboard_io_delay(uint32_t ms)
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:把「4 路电气电平」折回「4 路是否吸合」的位掩码
|
||||
* 入口参数:level - ioboard_do_read_level() 回的电气电平(bit0..bit3 = 4 路)
|
||||
* 函数功能:把「10 路电气电平」折回「10 路是否吸合」的位掩码
|
||||
* 入口参数:level - ioboard_do_read_level() 回的电气电平(bit0..bit9 = 10 路)
|
||||
* 返回值:每一位 1 = 该路吸合,0 = 该路释放
|
||||
* 限定条件:纯函数,无副作用,任意上下文可调
|
||||
* 函数说明:**逐位**折算——每一位 XOR 该位自己的 RELEASE 电平。这是唯一正确的形态:
|
||||
* 吸合 ⇔ 电平 ≠ RELEASE。见 ioboard_release_all 上方注释里的反例。
|
||||
*/
|
||||
static uint8_t ioboard_level_to_attracted(uint8_t level)
|
||||
static uint16_t ioboard_level_to_attracted(uint16_t level)
|
||||
{
|
||||
#if (IOBOARD_DO_LEVEL_RELEASE != 0U)
|
||||
/* RELEASE = 1 时逐位取反;否则电平本身就是"是否吸合" */
|
||||
return (uint8_t)(~level & (uint8_t)IOBOARD_TEST_DO_MASK_ALL);
|
||||
return (uint16_t)(~level & (uint16_t)IOBOARD_TEST_DO_MASK_ALL);
|
||||
#else
|
||||
return (uint8_t)(level & (uint8_t)IOBOARD_TEST_DO_MASK_ALL);
|
||||
return (uint16_t)(level & (uint16_t)IOBOARD_TEST_DO_MASK_ALL);
|
||||
#endif
|
||||
}
|
||||
|
||||
@@ -187,11 +191,11 @@ static uint8_t ioboard_level_to_attracted(uint8_t level)
|
||||
* 而 IOBOARD_DO_LEVEL_ACTIVE 定义了「吸合 = 高还是低」。把电气电平**折回"是否吸合"**
|
||||
* 是「每一位都换成该位自己的语义」,所以折算必须**逐位**做:每位 XOR 上 RELEASE 电平。
|
||||
* ⚠ 不能写成 `level ^ IOBOARD_DO_LEVEL_RELEASE` —— 那是把一个标量电平异或进整个掩码,
|
||||
* RELEASE=0 时恒等(等于没折算),RELEASE=1 时把 4 位全部取反、语义彻底反过来。
|
||||
* RELEASE=1 时把 10 位全部取反、语义彻底反过来。
|
||||
* 2026-11-16 台架实证:本文件曾写 `level ^ (IOBOARD_DO_LEVEL_RELEASE & 0x0Fu)`,
|
||||
* 在当前 RELEASE=0 下它是恒等变换,等价于「把电气电平原样当成吸合位掩码」。
|
||||
* 这一写法在 RELEASE=0 时碰巧给出正确结果(因为那时"电平"就等于"吸合"),
|
||||
* 但一旦有人把 IOBOARD_DO_LEVEL_ACTIVE 改成 0(极性反接),它会把 4 位全部取反,
|
||||
* 但一旦有人把 IOBOARD_DO_LEVEL_ACTIVE 改成 0(极性反接),它会把 10 位全部取反,
|
||||
* 判据整体自相矛盾地翻面。折算已收敛到下面这个函数,全文件只此一处。
|
||||
*
|
||||
* 函数功能:ioboard_do_write(0) 全释放,并回读电气电平核对是否真回到 RELEASE。
|
||||
@@ -203,7 +207,7 @@ static uint8_t ioboard_level_to_attracted(uint8_t level)
|
||||
*/
|
||||
static void ioboard_release_all(const char *where)
|
||||
{
|
||||
uint8_t level = 0xFFu;
|
||||
uint16_t level = 0xFFFFu;
|
||||
bsp_err_t rc = ioboard_do_write(0u);
|
||||
|
||||
if (rc != BSP_OK) {
|
||||
@@ -213,9 +217,9 @@ static void ioboard_release_all(const char *where)
|
||||
}
|
||||
|
||||
(void)ioboard_do_read_level(&level);
|
||||
if ((uint8_t)(level & IOBOARD_TEST_DO_MASK_ALL) !=
|
||||
(uint8_t)(IOBOARD_DO_LEVEL_RELEASE & IOBOARD_TEST_DO_MASK_ALL)) {
|
||||
DBG_ERROR("!!! RELEASE READBACK MISMATCH (%s): level=0x%02X expect release !!!",
|
||||
if ((uint16_t)(level & IOBOARD_TEST_DO_MASK_ALL) !=
|
||||
(uint16_t)(IOBOARD_DO_LEVEL_RELEASE & IOBOARD_TEST_DO_MASK_ALL)) {
|
||||
DBG_ERROR("!!! RELEASE READBACK MISMATCH (%s): level=0x%04X expect release !!!",
|
||||
where, (unsigned int)level);
|
||||
}
|
||||
}
|
||||
@@ -232,7 +236,7 @@ static void ioboard_release_all(const char *where)
|
||||
static void ioboard_emergency_release(const char *why)
|
||||
{
|
||||
DBG_ERROR("================ IOBOARD ALARM ================");
|
||||
DBG_ERROR("!! %s -> all 4 relays released NOW !!", why);
|
||||
DBG_ERROR("!! %s -> all 10 outputs released NOW !!", why);
|
||||
ioboard_release_all("emergency");
|
||||
DBG_ERROR("===============================================");
|
||||
}
|
||||
@@ -252,8 +256,8 @@ static void ioboard_emergency_release(const char *why)
|
||||
static int ioboard_phase_selftest(void)
|
||||
{
|
||||
bsp_err_t rc;
|
||||
uint8_t shadow = 0xFFu;
|
||||
uint8_t level = 0xFFu;
|
||||
uint16_t shadow = 0xFFFFu;
|
||||
uint16_t level = 0xFFFFu;
|
||||
int ok = 1;
|
||||
|
||||
DBG_INFO("=== IOBOARD Phase 0: self test (init / release state) ===");
|
||||
@@ -273,18 +277,19 @@ static int ioboard_phase_selftest(void)
|
||||
rc = ioboard_do_read_level(&level);
|
||||
IOBOARD_TEST_CHECK(rc == BSP_OK, "ioboard_do_read_level() ret=%d", (int)rc);
|
||||
|
||||
DBG_INFO(" DO shadow=0x%02X (bit0=KO6 bit1=TRIP bit2=ERT bit3=CLZ), GPIO level=0x%02X",
|
||||
DBG_INFO(" DO shadow=0x%04X (bit0=KO6 bit1=TRIP bit2=ERT bit3=CLZ bit4=KO_LED1"
|
||||
" bit5=KO_LED2 bit6=KO_24V bit7=KO4 bit8=KO5 bit9=KO_LED3), GPIO level=0x%04X",
|
||||
(unsigned int)shadow, (unsigned int)level);
|
||||
DBG_INFO(" DO polarity: ACTIVE=%u RELEASE=%u",
|
||||
(unsigned int)IOBOARD_DO_LEVEL_ACTIVE,
|
||||
(unsigned int)IOBOARD_DO_LEVEL_RELEASE);
|
||||
|
||||
IOBOARD_TEST_CHECK((uint8_t)(shadow & IOBOARD_TEST_DO_MASK_ALL) == 0u,
|
||||
"all 4 DO released at entry (shadow=0x%02X expect 0x00)",
|
||||
IOBOARD_TEST_CHECK((uint16_t)(shadow & IOBOARD_TEST_DO_MASK_ALL) == 0u,
|
||||
"all 10 DO released at entry (shadow=0x%04X expect 0x0000)",
|
||||
(unsigned int)shadow);
|
||||
IOBOARD_TEST_CHECK((uint8_t)(level & IOBOARD_TEST_DO_MASK_ALL) ==
|
||||
(uint8_t)(IOBOARD_DO_LEVEL_RELEASE & IOBOARD_TEST_DO_MASK_ALL),
|
||||
"all 4 DO pins at RELEASE level (level=0x%02X)",
|
||||
IOBOARD_TEST_CHECK((uint16_t)(level & IOBOARD_TEST_DO_MASK_ALL) ==
|
||||
(uint16_t)(IOBOARD_DO_LEVEL_RELEASE & IOBOARD_TEST_DO_MASK_ALL),
|
||||
"all 10 DO pins at RELEASE level (level=0x%04X)",
|
||||
(unsigned int)level);
|
||||
|
||||
IOBOARD_TEST_REPORT("Phase 0 self test");
|
||||
@@ -569,15 +574,15 @@ static void ioboard_phase_di_stable(void)
|
||||
/* ===================== Phase 3:开出逐个点动 ===================== */
|
||||
|
||||
/*
|
||||
* 函数功能:Phase 3 —— 4 路开出逐个点动(空载),验动作与回读极性。
|
||||
* 函数功能:Phase 3 —— 10 路开出逐个点动(空载),验动作与回读极性。
|
||||
* 入口参数:无
|
||||
* 返回值:无(结果计入 g_ioboard_test_stats)
|
||||
* 限定条件:需人工听继电器动作声;**开出当前空载**,可安全点动。
|
||||
* 函数说明:每路点动时长 IOBOARD_TEST_DO_ARM_MS(1 s,空载继电器动作声足以辨认)。
|
||||
* 判据三条:
|
||||
* ① ioboard_do_read_level() 回读电平与 IOBOARD_DO_LEVEL_ACTIVE 极性一致;
|
||||
* ② 其余 3 路保持不吸合(防"一位写全组动"的锁存错误);
|
||||
* ③ 释放后回读全部回到 IOBOARD_DO_LEVEL_RELEASE。
|
||||
* ② 其余 9 路保持不吸合(防"一位写全组动"的锁存错误);
|
||||
* ③ 释放后回读全部回到 IOBOARD_DO_LEVEL_RELEASE(覆盖 bit0..bit9 全 10 路)。
|
||||
* ⚠ 若判据 ① 全线失败,第一嫌疑是**极性宏写反**而不是硬件损坏:
|
||||
* ioboard.h 的 README 步骤 2 明确"DO 极性未在板上验证"。
|
||||
* 日志里同时打出 RELEASE 与 ACTIVE 两个电平值,就是为了一眼分辨这一点。
|
||||
@@ -587,23 +592,23 @@ static void ioboard_phase_do_actuation(void)
|
||||
{
|
||||
uint32_t i;
|
||||
|
||||
DBG_INFO("=== IOBOARD Phase 3: DO relay tap test (4 relays, NO LOAD) ===");
|
||||
DBG_INFO("=== IOBOARD Phase 3: DO relay tap test (10 outputs, NO LOAD) ===");
|
||||
IOBOARD_TEST_STATS_RESET();
|
||||
DBG_INFO(" listen for the relay click; release level = %u, active level = %u",
|
||||
(unsigned int)IOBOARD_DO_LEVEL_RELEASE, (unsigned int)IOBOARD_DO_LEVEL_ACTIVE);
|
||||
|
||||
for (i = 0u; i < (uint32_t)IOBOARD_TEST_DO_COUNT_EXPECT; i++) {
|
||||
uint8_t only = (uint8_t)(k_do_bit[i] & (uint8_t)IOBOARD_TEST_DO_MASK_ALL);
|
||||
uint8_t shadow = 0xFFu;
|
||||
uint8_t level = 0xFFu;
|
||||
uint16_t only = (uint16_t)(k_do_bit[i] & (uint16_t)IOBOARD_TEST_DO_MASK_ALL);
|
||||
uint16_t shadow = 0xFFFFu;
|
||||
uint16_t level = 0xFFFFu;
|
||||
uint32_t active_bits;
|
||||
bsp_err_t rc;
|
||||
|
||||
DBG_INFO(" [%u/4] CUE: %s relay will CLOSE for %u ms .. listen for click",
|
||||
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);
|
||||
rc = ioboard_do_write(only);
|
||||
if (rc != BSP_OK) {
|
||||
IOBOARD_TEST_CHECK(0, "%s: ioboard_do_write(0x%02X) ret=%d",
|
||||
IOBOARD_TEST_CHECK(0, "%s: ioboard_do_write(0x%04X) ret=%d",
|
||||
k_do_name[i], (unsigned int)only, (int)rc);
|
||||
ioboard_emergency_release("ioboard_do_write failed");
|
||||
ioboard_release_all("after emergency");
|
||||
@@ -618,30 +623,30 @@ static void ioboard_phase_do_actuation(void)
|
||||
/* "与极性一致":按 IOBOARD_DO_LEVEL_ACTIVE 把电气电平折回"是否吸合" */
|
||||
active_bits = ioboard_level_to_attracted(level);
|
||||
|
||||
DBG_INFO(" shadow=0x%02X level=0x%02X -> attracted=0x%02X (expected 0x%02X)",
|
||||
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]);
|
||||
|
||||
/* 三条断言分工不同,不要合并:
|
||||
* ① 影子寄存器 == 只有这一路(写入意图是否正确落地)
|
||||
* ② 该路确实处于吸合电平(极性折算是否正确)
|
||||
* ③ 其余 3 路都没有被带起来(其余位全为 0,不是"至少有一位") */
|
||||
IOBOARD_TEST_CHECK((uint8_t)(shadow & IOBOARD_TEST_DO_MASK_ALL) == only,
|
||||
"%s: shadow=0x%02X (expect 0x%02X: only this bit set)",
|
||||
* ③ 其余 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%02X)",
|
||||
"%s: pin at ACTIVE level while commanded (level=0x%04X)",
|
||||
k_do_name[i], (unsigned int)level);
|
||||
IOBOARD_TEST_CHECK((uint8_t)(active_bits & ~only) == 0u,
|
||||
"%s: other 3 relays stay released (attracted=0x%02X)",
|
||||
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_release_all("after tap");
|
||||
(void)ioboard_do_read_level(&level);
|
||||
IOBOARD_TEST_CHECK((uint8_t)(level & IOBOARD_TEST_DO_MASK_ALL) ==
|
||||
(uint8_t)(IOBOARD_DO_LEVEL_RELEASE & IOBOARD_TEST_DO_MASK_ALL),
|
||||
"%s: all 4 released after tap (level=0x%02X)",
|
||||
IOBOARD_TEST_CHECK((uint16_t)(level & IOBOARD_TEST_DO_MASK_ALL) ==
|
||||
(uint16_t)(IOBOARD_DO_LEVEL_RELEASE & IOBOARD_TEST_DO_MASK_ALL),
|
||||
"%s: all 10 released after tap (level=0x%04X)",
|
||||
k_do_name[i], (unsigned int)level);
|
||||
ioboard_io_delay(IOBOARD_TEST_DO_RELEASE_MS);
|
||||
}
|
||||
@@ -720,7 +725,7 @@ static void ioboard_test_body(void)
|
||||
*/
|
||||
static void ioboard_thread_entry(void *argument)
|
||||
{
|
||||
uint8_t level = 0xFFu;
|
||||
uint16_t level = 0xFFFFu;
|
||||
|
||||
(void)argument;
|
||||
|
||||
@@ -729,9 +734,9 @@ static void ioboard_thread_entry(void *argument)
|
||||
/* 序列结束(无论成败)必须全释放,并单独记一条断言:这是安全口径的最后一道 */
|
||||
ioboard_release_all("suite end");
|
||||
(void)ioboard_do_read_level(&level);
|
||||
IOBOARD_TEST_CHECK((uint8_t)(level & IOBOARD_TEST_DO_MASK_ALL) ==
|
||||
(uint8_t)(IOBOARD_DO_LEVEL_RELEASE & IOBOARD_TEST_DO_MASK_ALL),
|
||||
"final: all 4 DO at RELEASE level after suite (level=0x%02X)",
|
||||
IOBOARD_TEST_CHECK((uint16_t)(level & IOBOARD_TEST_DO_MASK_ALL) ==
|
||||
(uint16_t)(IOBOARD_DO_LEVEL_RELEASE & IOBOARD_TEST_DO_MASK_ALL),
|
||||
"final: all 10 DO at RELEASE level after suite (level=0x%04X)",
|
||||
(unsigned int)level);
|
||||
|
||||
IOBOARD_TEST_REPORT(IOBOARD_TEST_SUMMARY_NAME);
|
||||
@@ -777,8 +782,8 @@ static void ioboard_thread_entry(void *argument)
|
||||
void ioboard_test_run(void)
|
||||
{
|
||||
TaskHandle_t h_thread = NULL;
|
||||
uint8_t do_shadow = 0xFFu;
|
||||
uint8_t do_level = 0xFFu;
|
||||
uint16_t do_shadow = 0xFFFFu;
|
||||
uint16_t do_level = 0xFFFFu;
|
||||
|
||||
DBG_INFO("IOBOARD test suite started (semi-automatic; self-spawned thread prio=Normal)");
|
||||
DBG_INFO("thread stack: %u B static (TCB static, no heap)", (unsigned int)sizeof(s_ioboard_thread_stack));
|
||||
@@ -788,7 +793,7 @@ void ioboard_test_run(void)
|
||||
(void)ioboard_do_get(&do_shadow);
|
||||
(void)ioboard_do_read_level(&do_level);
|
||||
(void)ioboard_do_write(0u); /* 启动期无条件全释放 */
|
||||
DBG_INFO(" DO before start: shadow=0x%02X level=0x%02X -> forced to release",
|
||||
DBG_INFO(" DO before start: shadow=0x%04X level=0x%04X -> forced to release",
|
||||
(unsigned int)do_shadow, (unsigned int)do_level);
|
||||
|
||||
h_thread = xTaskCreateStatic(ioboard_thread_entry, "iobTest",
|
||||
|
||||
@@ -51,6 +51,11 @@ static int s_fail;
|
||||
typedef char ioboard_di_ch_num_must_match_bsp[(IOBOARD_DI_CH_NUM == IOBOARD_DI_COUNT)
|
||||
? 1 : -1];
|
||||
|
||||
/* 10 路开出 mask 必须是 uint16_t 宽:bit8 (KO5) / bit9 (KO_LED3) 放在 uint8_t 里会被静默截掉。
|
||||
* 用编译期 sizeof 断言钉住 IOBOARD_DO_MASK_ALL 的类型,避免驱动把 mask 链路退回 uint8_t。 */
|
||||
typedef char ioboard_do_mask_must_be_16bit[(sizeof(IOBOARD_DO_MASK_ALL) == sizeof(uint16_t))
|
||||
? 1 : -1];
|
||||
|
||||
#define WIN IOBOARD_DI_DEBOUNCE_MS
|
||||
|
||||
/* ---------------------------------------------------------------------------
|
||||
@@ -253,32 +258,42 @@ static void do_active_level_matches_documented_high(void)
|
||||
}
|
||||
|
||||
/*
|
||||
* 语义位:KO6=bit0、TRIP=bit1、ERT=bit2、CLZ=bit3,四位互异且恰好铺满 bit0..bit3。
|
||||
* 为何值得测:这四个位就是出口通道号。互换两位 = 跳闸与告警出口对调,
|
||||
* 语义位:前四路 KO6=bit0、TRIP=bit1、ERT=bit2、CLZ=bit3,新增六路从 bit4 到 bit9 依序排布;
|
||||
* 十位互异且恰好铺满 bit0..bit9。为何值得测:这些位就是出口通道号,互换两位 = 两个出口对调,
|
||||
* 台架上继电器照样"动",只有知道端子接线的人才会发现。
|
||||
*/
|
||||
static void do_semantic_bits_are_distinct_and_dense(void)
|
||||
{
|
||||
const uint8_t all = (uint8_t)(IOBOARD_DO_KO6 | IOBOARD_DO_TRIP
|
||||
| IOBOARD_DO_ERT | IOBOARD_DO_CLZ);
|
||||
const uint16_t all = (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);
|
||||
|
||||
CHECK(IOBOARD_DO_KO6 == 0x01U, "KO6 is bit0 (PC14)");
|
||||
CHECK(IOBOARD_DO_TRIP == 0x02U, "TRIP is bit1 (PF0)");
|
||||
CHECK(IOBOARD_DO_ERT == 0x04U, "ERT is bit2 (PF1)");
|
||||
CHECK(IOBOARD_DO_CLZ == 0x08U, "CLZ is bit3 (PF6)");
|
||||
CHECK(all == IOBOARD_DO_MASK_ALL, "the four channel bits exactly fill IOBOARD_DO_MASK_ALL");
|
||||
CHECK(IOBOARD_DO_MASK_ALL == 0x0FU, "IOBOARD_DO_MASK_ALL is 0x0F (bit4..7 have no hardware)");
|
||||
CHECK(IOBOARD_DO_KO6 == 0x001U, "KO6 is bit0 (PC14)");
|
||||
CHECK(IOBOARD_DO_TRIP == 0x002U, "TRIP is bit1 (PF0)");
|
||||
CHECK(IOBOARD_DO_ERT == 0x004U, "ERT is bit2 (PF1)");
|
||||
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_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)");
|
||||
CHECK(all == IOBOARD_DO_MASK_ALL, "all ten semantic bits exactly fill IOBOARD_DO_MASK_ALL");
|
||||
CHECK(IOBOARD_DO_MASK_ALL == 0x03FFU, "IOBOARD_DO_MASK_ALL is 0x03FF (bit0..bit9 all have hardware)");
|
||||
}
|
||||
|
||||
/*
|
||||
* 路数常量:一片 74HC165 = 8 位。为何值得测:组装函数的移位用 IOBOARD_DI_COUNT 推导,
|
||||
* 若有人为"将来两块级联 16 路"把它改成 16,返回值仍是 uint8_t,移位会溢出为未定义行为。
|
||||
* 路数常量:一片 74HC165 = 8 位开入,开出扩到 10 路。为何值得测:组装函数的移位用
|
||||
* IOBOARD_DI_COUNT 推导,若有人为"将来两块级联 16 路"把它改成 16,返回值仍是 uint8_t,
|
||||
* 移位会溢出为未定义行为;开出 10 路则是为钉住新增六路后的总数,退回 4 路即红。
|
||||
*/
|
||||
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 == 4, "IOBOARD_DO_COUNT is 4 relay outputs");
|
||||
CHECK(IOBOARD_DO_COUNT == 10, "IOBOARD_DO_COUNT is 10 relay outputs");
|
||||
}
|
||||
|
||||
/* ---------------------------------------------------------------------------
|
||||
|
||||
@@ -58,9 +58,10 @@
|
||||
* 值区一字不动;解闭锁后重新提交可成功
|
||||
* TC-UIDATA-020 apply 中途失败(预检与执行不一致的防御分支):如实 ERR_RANGE,
|
||||
* 已生效的前几项不回滚(prot_set 无回滚接口,谎称整批未写更坏)
|
||||
* TC-UIDATA-021 v2/v3 帧扩展:UI_DATA_VER == 3、既有字段偏移逐字节见证(只允许尾
|
||||
* 追加)、cal_block 两种态(未标定/已标定)整帧往返、rt 帧 v3
|
||||
* 尾追加的板级开入开出四字段落在 208..211(既有字段不挪位)
|
||||
* TC-UIDATA-021 v2/v3/v4 帧扩展:UI_DATA_VER == 4、既有字段偏移逐字节见证(只允许尾
|
||||
* 追加)、cal_block 两种态(未标定/已标定)整帧往返、rt 帧 v3/v4
|
||||
* 尾追加的板级开入开出四字段落在 208..212(do_mask 210..211 两字节,
|
||||
* do_valid 顺延到 212;其余既有字段不挪位)
|
||||
* ── 以下 5 组 = 装置维护通道与时钟换算(道F task-3,
|
||||
* docs/任务规划/UI补齐.md §2 第 3 行「装置维护 3 页」的地基)──
|
||||
* TC-UIDATA-022 时钟换算与"无效值拒收":12 条锚点正向换算 + 反函数互逆 +
|
||||
@@ -870,10 +871,12 @@ static void tc_param_frame_v2(void)
|
||||
{
|
||||
ui_data_par_t src;
|
||||
ui_data_par_t got;
|
||||
ui_data_rt_t layout_probe; /* 只为 sizeof 字段宽度,不求值、不发布 */
|
||||
|
||||
/* 版本号是页面与写侧唯一对齐凭据;v2 = par 尾追加 cal_block,
|
||||
* v3 = rt 尾追加板级开入开出四字段(ui_data.h 文件头「追加即升此值」) */
|
||||
CHECK(UI_DATA_VER == 3u, "TC-UIDATA-021a contract version is 3");
|
||||
* v3 = rt 尾追加板级开入开出四字段,v4 = dio_do_mask 加宽为 uint16_t
|
||||
* (do_valid 从 211 顺延到 212,旧布局读新帧会把 mask 高字节误当 valid) */
|
||||
CHECK(UI_DATA_VER == 4u, "TC-UIDATA-021a contract version is 4");
|
||||
/* v1 布局逐字节见证:字段只允许尾追加,任何插入/重排都会让下面四条红
|
||||
* (页面按名字取字段,错位是静默的——只有把偏移钉死才照得出来) */
|
||||
CHECK(offsetof(ui_data_par_t, seq) == 0u, "TC-UIDATA-021b seq offset unchanged");
|
||||
@@ -888,8 +891,9 @@ static void tc_param_frame_v2(void)
|
||||
/* rt 帧尺寸(MSVC x64 / ARMCC 实测均 216 B):v3 只是尾追加 4 个 uint8(恰好
|
||||
* 落在旧尾部填充里,字段偏移 208..211 连续),但**整 struct 由 208 涨到 216**——
|
||||
* 尾部 char[20] 之后有 4 B 对齐填充,加 4 B 正好把它顶满、再补 4 B 新填充
|
||||
* (24 B 数组区 → 需要 8 的倍数)。所以 s_scr union 的真实增量是 8 B 而不是 4 B,
|
||||
* 写侧 .bss 台账按 216 算(这条断言就是"别猜、量出来"的落点) */
|
||||
* (24 B 数组区 → 需要 8 的倍数)。10 路开出把 dio_do_mask 加宽为 uint16_t,
|
||||
* do_valid 顺延到 212,但尾填充吸收了这 1 B,实测 sizeof 仍为 216 B,
|
||||
* 所以 s_scr union 上界不变(数值由 UI agent 用 cl.exe x64 探针实测给出)。 */
|
||||
CHECK(sizeof(ui_data_rt_t) == 216u, "TC-UIDATA-021g rt frame is 216 B (v3 +8, union follows rt)");
|
||||
CHECK(sizeof(ui_data_par_t) < sizeof(ui_data_rt_t),
|
||||
"TC-UIDATA-021h par still smaller than rt (shared scratch follows rt)");
|
||||
@@ -910,9 +914,13 @@ static void tc_param_frame_v2(void)
|
||||
CHECK(offsetof(ui_data_rt_t, dio_di_valid) == 209u,
|
||||
"TC-UIDATA-021p rt dio_di_valid offset 209");
|
||||
CHECK(offsetof(ui_data_rt_t, dio_do_mask) == 210u,
|
||||
"TC-UIDATA-021q rt dio_do_mask offset 210");
|
||||
CHECK(offsetof(ui_data_rt_t, dio_do_valid) == 211u,
|
||||
"TC-UIDATA-021r rt dio_do_valid offset 211");
|
||||
"TC-UIDATA-021q rt dio_do_mask offset 210 (uint16_t spans 210..211)");
|
||||
CHECK(offsetof(ui_data_rt_t, dio_do_valid) == 212u,
|
||||
"TC-UIDATA-021r rt dio_do_valid offset 212 (+1 after do_mask widened to uint16_t)");
|
||||
CHECK(sizeof(layout_probe.dio_do_mask) == sizeof(uint16_t),
|
||||
"TC-UIDATA-021s rt dio_do_mask is uint16_t wide");
|
||||
CHECK(UI_DATA_DO_N == 10u,
|
||||
"TC-UIDATA-021t 10 DO channels in UI contract");
|
||||
|
||||
/* 闭锁态:1 = 未标定(写侧按 UA/UN/IA 三路 VALID 现算,本层只存真值) */
|
||||
ui_data_init();
|
||||
|
||||
Reference in New Issue
Block a user