feat(ui): add DI/DO status page showing 8 inputs and 4 outputs

New read-only content page under 实时数据 → 开入开出 showing the board's
8 opto inputs (DI_A..DI_H, 合/分) and 4 relay outputs (KO6/TRIP/ERT/CLZ,
吸合/释放) as a 12-row list, 8 rows per page, 2 pages.

Data path reuses the existing de-bounced input poll instead of adding a
second hardware reader:

  defaultTask (50 ms) → ioboard_di_snap_publish() → de-bounced snapshot
    → ioboard_di_snap_lookup()  [new registration channel]
    → ui_data_feed_tick() (uiTask, 200 ms)
    → ui_data_rt_t.dio_di_* / dio_do_*

No new critical sections, no new hardware access on the UI path. Outputs
come from the volatile shadow register (a memory read, no lock).

Semantic honesty, recorded in ui_page_di_do.c and README §6:
  · Output state is the software shadow register (ODR mirror), NOT a
    mechanical contact feedback — this platform has no auxiliary contact
    readback path. ioboard_do_read_level() also reads ODR, so comparing
    the two is tautological.
  · IOBOARD_DO_LEVEL_ACTIVE polarity has not been checked against the
    schematic.
  · Input bit order has not been verified by manual shorting. The
    2026-11-16 run read 0x00 eight times because the operator had no time
    to short each channel — the data path itself was fine.
  · Board-level inputs are deliberately kept out of the 33-point telemetry
    bitmap (IEC 104 point-table semantics); the two have no mapping.

Invalid snapshots render "--", never 合/分 or 吸合/释放: painting "no data"
as "all inputs released" would tell the field the inputs are open when we
simply failed to read them.

Board-verified 2026-11-16: page 1 shows 分 on all 8 inputs, page 2 shows
释放 on all 4 outputs, page footer and paging correct. Input bit order
still pending manual shorting.

Also: regenerate ui_font_cn_12 for 吸/释, add golden references for both
pages, align check_menu_rows.py L2 geometry with the now-4-item submenu,
and register the new source file in both the Keil project and CMake.

Reviewed independently; zero blocking findings.
This commit is contained in:
2026-11-16 21:45:08 +08:00
parent bdc6f2f9b8
commit 2b466b85f0
24 changed files with 1012 additions and 300 deletions
+118 -2
View File
@@ -5,6 +5,15 @@
* (实时量 rt / 参数 par / 装置信息 info),经 Drivers/BSP/UI/ui_data.h
* 的发布 API 推给 UI 层;本模块是快照的**唯一填充者**,不含任何布局、
* 格式化与 LVGL 调用(显示规格全在页面行表,同文档 §8)
* 唯一填充者的边界(「开入开出」页补记):rt 帧里**每一个**业务字段的一手
* 取数都发生在这里——包括板级 8 路开入(经 App/util/ioboard_di.h 的注册式
* 读口读 defaultTask 发布的去抖快照)与 4 路开出(读 Drivers/BSP/IOBOARD 的
* 影子寄存器)。页面只消费快照,不得自己去调 ioboard_* / ioboard_di_*:
* 那是绕过节拍与失败语义的第二条取数路径,读失败就会直变成屏上的
* "开入全部复归"。两族数据刻意不进 yx_bits/yx_valid(板级引脚 ≠ 104 点表)。
* 写入者互斥(同一条边界的另一面):本模块的四个开入开出字段只由本文件写,
* 而开入的**上游**只由 defaultTask 写(ioboard_di 快照的单写者约束),
* 本模块不发布、不修复、不纠正 defaultTask 的结果——读不到就如实报无效。
* 写方向(道F task-1):同一条 tick 顺带把页面投递的定值整定请求落定——
* ui_data_param_drain() 每轮取一条,执行动作经本文件的 s_param_ops
* (locked = prot_set_locked / check = g_prot_set_meta 上下限 /
@@ -32,6 +41,12 @@
* 装配层实现 + 首轮懒绑(时序与通道四绑定等价,
* 见 feed_yt_bind_once 函数头);行数等值由编译期
* 守卫钉,量纲分档与合法域分档同源同序
* v3 2026-11-16 DTU 项目组 「开入开出」页:rt 帧尾四字段填充——
* dio_do_mask/dio_do_valid 取 ioboard_do_get() 的影子
* 寄存器;dio_di_mask/dio_di_valid 经 ioboard_di 的
* 注册式读口取 defaultTask 的去抖快照,**读失败保留
* 上一次已发布的值并令有效位 = 0**(铁律:读数失败不得
* 当"开入全部复归"上报)
* v1.2 2026-10-26 DTU 项目组 道F task-16:删除本地镜像 feed_cal_block(),
* 两个调用点(填帧 / 门控比较)改调
* adc_cal_prot_blocked()——同一份三路判定此前在
@@ -62,6 +77,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_* 语义位(下层 → 上层合法方向) */
/* 同层(App)数据源 */
#include "adc_input.h" /* ADC_SEM_COUNT / adc_input_raw(TEMP 码值) */
@@ -74,6 +90,7 @@
#include "sys_clock.h" /* 墙钟字符串 */
#include "iec104_comm.h" /* 道G task-9:[comm] 真源 getter/setter/脏位;快照端口切 getter,IEC104_SERV_PORT 字面宏同笔删除 */
#include "iec104_pts.h" /* task-15 批4:遥信点数与单/双点性质(点表事实的唯一来源) */
#include "ioboard_di.h" /* 板级 8 路开入:注册式读口(lookup 拿写者快照 → snap_read 取一致值) */
/* 私有宏定义区 */
@@ -125,13 +142,41 @@ 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 契约里给页面用的
* 路数(BSP 看不见 App 头,物理上自证不了),真值分别是 App/util/ioboard_di.h 的
* IOBOARD_DI_CH_NUM(刻意不 include ioboard.h 的那个数)与 ioboard.h 的四位语义宏。
* 本文件是**唯一**同时看见两侧的编译单元——这里不等号一翻,编不过 */
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 = 吸合)。
* 为什么在这一处汇成一个掩码:填帧要用它,位宽守卫也要用它;两处各写一遍等于
* 第二个真相(少写一位,屏上就凭空多出一路"永远释放"的开出) */
#define FEED_DO_MASK ((uint8_t)(IOBOARD_DO_KO6 | IOBOARD_DO_TRIP | \
IOBOARD_DO_ERT | IOBOARD_DO_CLZ))
/* 静态变量定义区 */
/* 上一次**已发布**的板级开入 mask。
* 为什么单独存一份而不是让页面自己记:ioboard_di_snap_read() 返回 0 时(快照尚未
* 有效 / 读期被持续抢占),本次没有新数据可发;此时屏上唯一诚实的内容是"上次已知
* 状态 + 无效标记"。若就地填 0,现场会把"全部复归"当成事实——那是比不刷新更危险的
* 假信息(开入全局复归往往被当成"所有开关都断开了"来处置)。所以失败拍沿用本变量,
* 且**只在本变量有意义时**(s_dio_di_seen)才沿用:从未读到过有效快照时它是 0,
* 但此时 dio_di_valid 也是 0,页面按无效画,不会把 0 当读数。
* 与 s_scr 的关系:s_scr 每帧清零,装不下跨拍状态,故分开存(1 B .bss)。 */
static uint8_t s_dio_di_last;
static uint8_t s_dio_di_seen; /* 1 = s_dio_di_last 曾来自一次成功的快照读 */
/* 组装缓冲:三帧串行填充,共用一块存储,省两份 RAM。
* 实际最大者是**实时帧**(208 B > par 192 B > info),故给 par 尾追加字段
* 实际最大者是**实时帧**(212 B > par 192 B > info),故给 par 尾追加字段
* 只要不超过 rt 就一字节 RAM 都不多花(这条由主机单测 TC-UIDATA-021g/h 钉住,
* 尺寸一变这里就是唯一会撒谎的地方) */
* 尺寸一变这里就是唯一会撒谎的地方;rt 帧本身就是 rt/par/info 三帧里最大的,
* 它每长 1 B,这块 union 就跟着长 1 B——RAM 台账要按 rt 的量算) */
static union {
ui_data_rt_t rt;
ui_data_par_t par;
@@ -311,6 +356,73 @@ static uint64_t feed_yx_bits(void) {
return bits;
}
/*
* 函数功能:填板级 8 路开入(读 defaultTask 发布的去抖快照)
* 入口参数:p_snap - 目标帧(调用方已清零) ui_data_rt_t *
* 返回值:无
* 限定条件:uiTask 上下文;无锁、不阻塞、不关中断(ioboard_di 的读者路径契约)
* 函数说明(本函数是「读失败不得当全 0 上报」这条铁律在 UI 侧的落点):
* ① 未登记(lookup 返回 NULL,如 TEST_SUITE_STORAGE 构建里没有开入发布者):
* 没有数据源 —— 有效位 = 0,mask 保持"最近已知值或不曾有过"。
* ② 登记了但 snap_read 返回 0(快照尚未有效 / 读期被持续抢占):**本次没有新
* 数据**,不是"读数 = 0"。有效位 = 0,mask 沿用 s_dio_di_last(上次成功读
* 到的去抖结果)——绝不在这里填 0;只有从未成功读过时才轮到 0,而那种情况
* 有效位同样为 0,页面按"无数据"画。
* ③ 成功(返回 1):mask 记入 s_dio_di_last 并带回滚能力(s_dio_di_seen),
* 有效位 = 1。
* 为什么不直接读 s->mask:那会绕过写者的"奇-写-偶"序号协议,可能拿到写者写到
* 一半的字段(ioboard_di.h 的"不要直接读 s->mask")。
* 代价:每次只读一拍,不做平均/滤波——去抖已经在写者侧(20 ms)完成,这里再加
* 一层延迟只会让屏上比现场更慢。
*/
static void feed_fill_dio_di(ui_data_rt_t *p_snap) {
const ioboard_di_snapshot_t *s = ioboard_di_snap_lookup();
uint8_t mask = 0u;
p_snap->dio_di_valid = 0u; /* 先按"无新数据"记账,成功路径再翻 1 */
if (s == NULL) {
/* 没有数据源:沿用上次已知值(从未有过则 0,但 valid=0 已声明它不可消费) */
p_snap->dio_di_mask = (s_dio_di_seen != 0u) ? s_dio_di_last : 0u;
return;
}
if (ioboard_di_snap_read(s, &mask, NULL) == 0u) {
/* 读失败 / 本次无新数据:**不把 mask 写进 s_dio_di_last**,也不填 0——
* snap_read 返回 0 时 out_mask 只是"最近一次发布值",不是一次成功读数 */
p_snap->dio_di_mask = (s_dio_di_seen != 0u) ? s_dio_di_last : 0u;
return;
}
s_dio_di_last = mask;
s_dio_di_seen = 1u;
p_snap->dio_di_mask = mask;
p_snap->dio_di_valid = 1u;
}
/*
* 函数功能:填板级 4 路开出(读驱动的软件影子寄存器)
* 入口参数:p_snap - 目标帧(调用方已清零) ui_data_rt_t *
* 返回值:无
* 限定条件:uiTask 上下文;ioboard_do_get 只读一个 volatile 影子寄存器,
* 无硬件访问、无临界区,任意上下文可调
* 函数说明:mask 只保留 bit0..bit3(IOBOARD_DO_KO6/TRIP/ERT/CLZ),高位是驱动
* 的"无对应硬件"区,原样透传进屏幕等于凭空多出 4 路。
* ⚠ 这是**软件意图**(上次成功写入的值),不是继电器机械吸合实测;
* 驱动无辅助触点回读通路(ioboard.h 的 ioboard_do_get 注),页面措辞
* 不得让操作员以为读到了机械反馈。
* 失败只可能是 out_mask 为 NULL(本处传栈上地址,不会发生);仍按
* "取不到就报无效"处理,不为不可能的分支编造一个成功态。
*/
static void feed_fill_dio_do(ui_data_rt_t *p_snap) {
uint8_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_valid = 1u;
} else {
p_snap->dio_do_mask = 0u;
p_snap->dio_do_valid = 0u;
}
}
/*
* 函数功能:组装实时量快照(遥测 9 路 + 相量实例槽 + 遥信 + 频率 + 墙钟)
* 入口参数:p_snap - 目标帧(调用方已清零) ui_data_rt_t *
@@ -398,6 +510,10 @@ static void feed_fill_rt(ui_data_rt_t *p_snap, uint32_t tick_ms) {
p_snap->yx_bits = feed_yx_bits();
p_snap->yx_valid = FEED_YX_VALID_MASK;
p_snap->yx_dp = feed_yx_dp();
/* 板级开入开出(v3 尾追加):与上面三张点表位图**互不引用**——板级引脚不是
* 104 点表事实,塞进 yx_* 就等于拿物理引脚冒充点表(见 ui_data.h 字段注) */
feed_fill_dio_di(p_snap);
feed_fill_dio_do(p_snap);
/* 点数漂移检查(只在真漂走时打一条日志):点表 YX_N 与本层 UI_DATA_YX_N 一旦不等,
* 页面按 33 行画、协议按另一个数上送,两边都"看起来正常"——这是静默错,值得花一条
* DBG(约 90 B Flash)换一次现场可见的自证;只打一次不刷屏(同丢弃计数口径) */
+31 -1
View File
@@ -153,6 +153,31 @@ static ioboard_di_ch_t s_di_ch[IOBOARD_DI_CH_NUM];
static ioboard_di_snapshot_t s_di_snap;
static uint8_t s_di_pub_mask;
static uint32_t s_di_fail_edges_seen;
/*
* 函数功能:把 s_di_snap 登记到开入快照的共享读口(写者侧一次登记)
* 入口参数:无
* 返回值:无(失败只留一条自检记录)
* 限定条件:defaultTask 初始化段调用一次;仅存在于 !TEST_SUITE_STORAGE 构建
* 函数说明:
* 读者经 ioboard_di_snap_lookup() 取指针后走 ioboard_di_snap_read()。
* 为什么在声明处而不是 poll 体内:ioboard_di_snap_register 是幂等的(同一指针重复
* 登记返回 0),放在这里每轮任务启动只跑一次,且**先于**第一次 default_task_di_poll
* 发布,读者不会看到"未登记"之外的任何中间态。注册表本身零初始化,不依赖启动顺序
* (可在 app_main_init 阶段就被调用),这里不新增任何内核前调用的风险面。
* 必须在 !TEST_SUITE_STORAGE 区内:STORAGE 套件构建把 s_di_snap 整段挖掉,
* 登记语句留在外面就是编译错误。
*/
static void default_task_di_publish_register(void) {
if (ioboard_di_snap_register(&s_di_snap) != 0) {
/* 只可能是"已被另一个指针占用"——本仓只有本处登记 s_di_snap,走到这里说明
* 有人加了第二个写者:不静默接受,留一条痕迹。此刻控制台写者尚未注册,
* syslog_post 按内核状态分流到 s_preboot 静态数组(App/log/sys_log_mcu.c)。
* 栈代价:该调用点内联约 216 B 日志行缓冲,只在这条不可达分支上——不计入
* defaultTask 的静态最坏链(正常路径不经过),但改本函数结构时别把它搬进热路径。 */
syslog_post(SYSLOG_SELFTEST, "di snapshot register rejected");
}
}
#endif
/*
@@ -223,7 +248,12 @@ void default_task_func(void *argument) {
/* 开入第一次读取放在 bring-up 之后:此刻 MX_GPIO_Init 早已配好引脚(模块初始化期),
* 且看门狗尚未启动,几十微秒的移位读不会影响任何节拍。
* 发布开关 DEFAULT_TASK_DI_PUBLISH_EN 在文件作用域统一定义,此处**不得重复定义**。 */
* 发布开关 DEFAULT_TASK_DI_PUBLISH_EN 在文件作用域统一定义,此处**不得重复定义**。
* 发布前先把快照登记到共享读口(读者 = ui_data_feed,见 ioboard_di.h):
* 登记本身零硬件访问,但 s_di_snap 声明在 !TEST_SUITE_STORAGE 区内,登记也须同区。 */
#if !defined(TEST_SUITE_STORAGE)
default_task_di_publish_register();
#endif
(void)default_task_di_poll();
/* 注册控制台写者:本任务此后是串口唯一发送者(其余任务只写环形缓冲)。
+51 -1
View File
@@ -1,6 +1,8 @@
/*
* 模块名称:开入(DI)去抖与快照——纯逻辑实现(本模块可主机侧测试的那一半)
* 模块功能:ioboard_di.h 全部纯函数。零 HAL、零 FreeRTOS、零全局可变状态,
* 模块功能:ioboard_di.h 全部纯函数(另含一张单指针登记表,供写者与读者跨任务
* 共享同一份快照——表本身不涉及 HAL/FreeRTOS,仍是纯逻辑)。
* 零 HAL、零 FreeRTOS;唯一的全局状态是登记表,只由写者登记一次、之后只读。
* MCU(ARMCC C99)与主机侧 MSVC 编译**同一份源码**。
* 适用平台:任何 C99
* 作者:王建锋
@@ -215,3 +217,51 @@ void ioboard_di_snap_faults(const ioboard_di_snapshot_t *s, uint32_t *out_edges,
*out_fails = s->fail_count;
}
}
/* ======================== 注册式共享读口 ======================== */
/*
* 已登记的快照对象;NULL = 尚未登记。编译期零初始化,**没有初始化函数**——
* 于是不存在"谁必须先跑"的启动顺序依赖(见头文件函数说明三)。
* volatile 的理由见头文件函数说明四:跨任务传地址,读者侧不得被编译器缓存。
* 占用后永不改变(register 只允许同一指针重复登记),所以读者读它不需要任何保护:
* 要么读到 NULL(无写者),要么读到一个此后终身有效的地址。
*/
static const ioboard_di_snapshot_t *volatile s_di_snap_registered = 0;
/*
* 函数功能:写者登记它的快照对象(只存指针,不复制、不改写内容)
* 入口参数:s - 由本登记者独占写入的快照对象(s == 0 = 参数非法)
* 返回值:0 = 登记成功 / 重复登记同一指针(幂等);-1 = 参数非法或已被另一指针占用
* 限定条件:单写者;先登记再发布(语义全文见 ioboard_di.h 的同名声明)
* 函数说明:占用后不可变——首个指针即唯一真相源,第二个不同指针一律拒绝并保留首个。
*/
int ioboard_di_snap_register(const ioboard_di_snapshot_t *s)
{
if (di_is_null(s) != 0U) {
return -1;
}
/* 首个登记=占用。重复登记必须是**同一个**指针(幂等),否则拒绝并保留首个:
* 两个快照对象并存就是两份真相,读者拿到哪一份取决于调度顺序,不可接受。 */
if (s_di_snap_registered == 0) {
s_di_snap_registered = s;
return 0;
}
if (s_di_snap_registered == s) {
return 0;
}
return -1;
}
/*
* 函数功能:读者取已登记的快照对象
* 入口参数:无
* 返回值:已登记的快照指针;未登记 = NULL(消费者按"无数据源"处理,不是全 0)
* 限定条件:任意上下文、无锁、不阻塞、不关中断
* 函数说明:拿到指针后必须再走 ioboard_di_snap_read() 取一致值,不要直接读字段。
*/
const ioboard_di_snapshot_t *ioboard_di_snap_lookup(void)
{
return s_di_snap_registered;
}
+56
View File
@@ -6,6 +6,9 @@
* 读引脚在 App/util/ioboard_di.c 的 .c 部分(本 .c 就是那一半,属于同一模块的
* 可测部分);本头文件**不 include** HAL / FreeRTOS / ioboard.h / main.h,
* 可被主机侧 MSVC 单测直接编译。
* 跨任务共享:快照对象归写者(defaultTask)私有,读者经下方的
* ioboard_di_snap_register / ioboard_di_snap_lookup 拿指针,仍用同一套
* 序号协议(ioboard_di_snap_read)读——不引入第二份副本、不引入锁。
*
* 为什么去抖不放进 ioboard.c:BSP 只回答"让硬件动起来并如实汇报",去抖与
* 失败语义是上报层的事;而且 ioboard.c 依赖 HAL/FreeRTOS,主机侧编不过。
@@ -160,6 +163,59 @@ void ioboard_di_snap_reset(ioboard_di_snapshot_t *s);
/* 诊断副本:不保证一致性,仅供自检/串口打印 */
void ioboard_di_snap_copy(const ioboard_di_snapshot_t *s, ioboard_di_snapshot_t *out);
/* ======================== 注册式共享读口 ======================== */
/*
* 为什么要有这一对函数:快照对象是写者(defaultTask)的文件作用域静态变量,
* 作用域外拿不到地址。让读者自己 include 写者的私有状态 = 打开第二个写者入口;
* 让读者 copy 一份 = 造出第二份随时间漂移的真相。所以中间只放"登记一个地址",
* 读者拿走指针后**仍走 ioboard_di_snap_read() 的同一套序号协议**(不是第二个读者实现)。
* 在此之前 ioboard_di_snap_read() 在本仓没有任何调用方(它只被主机侧单测覆盖),
* 本对函数就是它"跨任务可用"的接线:读者 = App/app/ui_data_feed.c(uiTask 上下文),
* 写者 = defaultTask(登记点 = default_task_di_publish_register)。
* 为什么注册表放在本纯逻辑层:它就是一个指针 + 单写者判据,零 HAL / 零 FreeRTOS;
* 放进来才能在主机侧单测里直接验证"拒绝第二个写者",而不必上板。
*/
/*
* 函数功能:写者登记它的快照对象(产品里 = defaultTask 的 s_di_snap)
* 入口参数:s - 由本登记者独占写入的快照对象(s == 0 = 参数非法)
* 返回值:0 - 成功(首次登记成功,或重复登记的**正是同一个**指针:幂等)
* -1 - 参数非法(s == 0),或已被**另一个**指针占用(保留首个,拒绝后来的)
* 限定条件:写在登记成功之后**才开始**发布,不得先发布再登记(见函数说明第二段)
* 函数说明:
* 一、只存指针:不复制、不初始化、不改写快照内容——快照的初始态由写者自己
* (ioboard_di_snap_reset 或静态零初始化)负责,本函数不代劳。否则登记时刻
* 就是一个"把写者正在发布的快照清零"的竞态点。
* 二、单写者:占用后第一个指针就是唯一真相源。第二个不同指针 = 返回 -1 并保留首个;
* 重复登记同一指针 = 幂等返回 0。为什么换写者也不行:指针一变,读者拿到的
* 旧指针生命周期无法保证,且两个快照对象同时存在正是本函数要禁掉的局面
* (换写者需要先下线旧写者,本平台没有这种用法,故不提供注销)。
* 三、登记表本身是编译期零初始化的文件作用域静态,**没有"初始化"步骤**:
* 于是不存在"谁必须先跑一遍初始化"的启动顺序依赖,本函数也是幂等的。
* 是否可用在任务启动之前:可以(注册表零初始化、本就用于 app_main_init 阶段的
* 提前登记),但届时还没有读者——本仓的登记点在写者自己的任务启动段:
* default_task_func 里调 default_task_di_publish_register(),先于首次
* default_task_di_poll() 发布。
* 四、注册表置 volatile:读者(uiTask / 任意上下文)与写者(defaultTask)跨任务
* 通过它传地址,编译器不得把"看起来没变"的读缓存起来。指针本身的赋值在 M4 上
* 是单条 32 位存储,读者不会看到半个地址;"读到非 0 之后指针不再变化"由上面
* 的不可变约束保证,所以读者侧既不用关中断也不用再校验一次。
*/
int ioboard_di_snap_register(const ioboard_di_snapshot_t *s);
/*
* 函数功能:读者取已登记的快照对象
* 入口参数:无
* 返回值:已登记的快照指针;未登记(或登记被拒绝且从未成功过)= NULL
* 限定条件:任意上下文(任务 / 中断 / 启动段)、无锁、不阻塞、不关中断
* 函数说明:拿到指针后必须自己调 ioboard_di_snap_read() 取一致值,**不要**直接读
* s->mask —— 直接读会不带序号校验,拿到写者写到一半的字段。
* 返回 NULL 表示"本构建没有开入发布者"(如 TEST_SUITE_STORAGE),
* 消费者应把它当作"无数据源",不是"开入全 0"。
*/
const ioboard_di_snapshot_t *ioboard_di_snap_lookup(void);
/*
* 函数功能:读"有效 → 失效 下降沿"累计次数与"连续失败拍数"
* 入口参数:s - 快照对象