/* * 模块名称:UI Page DI DO (开入开出内容页) * 模块功能:实时数据 → 开入开出 叶子的只读状态页——12 行竖向列表,每行一路通道: * 前 8 行是板上的 8 路开入(DI_A..DI_H),后 4 行是 4 路开出(KO6/TRIP/ERT/CLZ); * 名 + 值两列,8 行一页共 2 页;数据只读 Drivers/BSP/UI/ui_data.h 的实时快照, * 零 App include、零 LVGL 对象(框架按描述符整页自绘) * 为什么 12 行按「8 开入 + 4 开出」切开而不是混排:8 行一页的窗口恰好让第 1 页全是开入、 * 第 2 页全是开出——两类信号各占一页,操作员不用在一页里跨类对照;第 2 页只有 * 4 行、下方留白是页数决定的(12 行 / 每页 8 行),页脚"第 2 页,共 2 页"已说明 * 这是最后一页,故不再加提示行(多一行提示就要多扩一个汉字字模) * 为什么开出写「吸合 / 释放」而开入写「合 / 分」:开出的"1"是继电器线圈被驱动,业内固定 * 说法就是吸合与释放;开入的"1"是外部触点闭合,屏上沿用遥信页的"合位/分位"口径 * 但省掉"位"字——值列只有一格,短词读得更快 * 这张屏能看到什么、看不到什么(务必与下一段一起读,屏上的"吸合"不等于继电器真吸合): * 1. 开出这几行显示的是**软件影子寄存器**(ODR 镜像),也就是"我们让这一路吸合了", * 不是继电器机械触点真的闭合了的实测反馈——本平台的硬件没有辅助触点回读通路。 * 2. 驱动里的 ioboard_do_read_level() 读的同样是 ODR,所以它读回来与本页的值恒等; * 它只用来发现"有人在驱动之外写了这 4 根引脚的 ODR",不能证明光耦导通或触点真闭合。 * 验证步骤见 Drivers/BSP/IOBOARD/README.md 第 5 节第 2 步。 * 3. 开出极性宏 IOBOARD_DO_LEVEL_ACTIVE(Drivers/BSP/IOBOARD/ioboard.h)写明是"唯一可改点", * **尚未按原理图核对**——若硬件实际是低电平吸合,屏上的"吸合"仍是对的(软件 mask 语义, * 极性在驱动层换),但驱动改动之前本页结论只能算"按软件意图显示"。 * 4. 开入这 8 路**位序没有经过人工短接验证**:2026-11-16 那轮实测 8 路读回全是 0x00, * 原因是操作员没来得及逐路短接(不是驱动故障),所以 DI_A..DI_H 与物理端子的对应 * 关系目前只是按驱动位序(bit0 = 通道 A … bit7 = 通道 H)推定,未经现场核对。 * 验证方法见 docs/硬件平台/开入开出实施说明.md §5.1(只有 A 动作 → 0x01 / 只有 H 动作 → 0x80)。 * 5. 本页与 33 点遥信(ui_data_rt_t 的 yx_bits/yx_valid/yx_dp)**没有任何映射关系**:那是 * 104 点表的语义,板级开入尚未接进点表(docs/架构设计/硬件规格与能力边界.md 的 H3 能力 * 边界)。本页只显示板级原始状态,不冒充点表事实。 * 为什么值是「--」而不是「分 / 释放」:valid 为 0 表示"这一路没有可信读数"。此时 mask 里可能 * 还留着上一次的值,把它画成"分"或"释放"等于把"没数据"伪装成"已复归"——现场会 * 因此以为开入全部断开。这是本仓"读失败不得当全 0 上报"铁律在屏上的落点。 * 上真板子时开出这几行会正常显示「吸合 / 释放」,不会一直是「--」:板端 App/app/ui_data_feed.c * 经 ioboard_do_get() 取得到影子寄存器,dio_do_valid 恒为 1;只有 PC 模拟器构建没有 * ioboard 硬件、影子取不到时才恒为 0,于是开出四行显示「--」。上板看到「--」先查 * feed 侧是否在跑,不要去改本页的判定——本页只认 valid 位。 * 适用平台:STM32F407ZGTx / PC 模拟器(共用源码) * 作者:王建锋 * 创建日期:2026-11-16 * 修改记录: * v1.0 2026-11-16 DTU 项目组 创建(开入开出上屏:8 路开入 + 4 路开出只读页) */ /* 头文件包含区 */ #include "ui_page_di_do.h" #include #include "ui_data.h" #include "ui_tokens.h" /* 私有宏定义区 */ #define DIO_DI_N 8u /* 开入路数(一块 74HC165 的 A..H) */ #define DIO_DO_N 4u /* 开出路数(KO6 / TRIP / ERT / CLZ) */ #define DIO_ROW_N (DIO_DI_N + DIO_DO_N) /* 值列词表(「吸」「释」两字 2026-11-16 随本页扩进 ui_font_cn_12,其余原在子集内) */ #define DIO_INVALID "--" #define DIO_DI_ON "合" #define DIO_DI_OFF "分" #define DIO_DO_ON "吸合" #define DIO_DO_OFF "释放" /* 静态变量定义区 */ /* * 行名表(下标 = 全局行号 0..11) * 开入名取板级通道丝印 DI_A..DI_H:仓库里查不到这 8 路的功能语义名(断路器位置、压板投退之类 * 都是点表层的说法,板级开入还没接进点表,见文件头第 5 条),故如实写丝印名,**不编造功能名** * ——与遥信页对点表未定义点写 YX5..YX14 是同一条口径(ui_page_yx.c 名表注释)。 * 开出名照抄丝印 KO6/TRIP/ERT/CLZ,与 ioboard.h 的 IOBOARD_DO_* 宏一一对应;宏注释已写明这些 * 名字"只作追溯,不是业务定义",屏上因此不写"跳闸/告警/闭锁"——那三个动作的语义属于业务层。 */ static const char *const s_dio_name[DIO_ROW_N] = { "DI_A", "DI_B", "DI_C", "DI_D", /* 0~3 开入通道 A..D */ "DI_E", "DI_F", "DI_G", "DI_H", /* 4~7 开入通道 E..H */ "KO6", "TRIP", "ERT", "CLZ", /* 8~11 开出 DO0..DO3 */ }; /* 名表行数与页面行数一致(不一致 = 编译期错误;ARMCC C99 无 _Static_assert,用宽度法) */ typedef char dio_name_count_check[(sizeof(s_dio_name) / sizeof(s_dio_name[0]) == DIO_ROW_N) ? 1 : -1]; /* 帧缓存:只在发布序号变化时整帧拷一次(同遥信页口径,UI_数据供给设计说明.md §5.4) */ static ui_data_rt_t s_rt; static uint32_t s_seq = 0xFFFFFFFFu; /* 函数定义区 */ /* * 函数功能:定长缓冲内拷字面量(代码规范 7.5 禁 strcpy) * 入口参数:a_dst - 目标缓冲(框架行缓冲 UI_BUF_STRLEN) char * * a_src - 源串(含 NUL) const char * * len - 目标缓冲容量 uint32_t * 返回值:无 * 限定条件:源串长度必须小于 len(编译期由字面量 sizeof 保证,不做运行期截断—— * 截断只会把"吸合"打成"吸",比读错更难查) */ static void dio_put(char *a_dst, const char *a_src, uint32_t len) { uint32_t i = 0u; if (len == 0u) { return; } while (((i + 1u) < len) && (a_src[i] != '\0')) { a_dst[i] = a_src[i]; i++; } a_dst[i] = '\0'; } /* * 长度参数**必须取目标缓冲容量**,不能取 sizeof(源):本表的源是 `const char *const` 表里的 * **指针**,`sizeof(lit)` 得到的是指针宽度(4/8),于是 "吸合" 会被拷成第一个汉字 "吸"。 * 这个错编译器、cppcheck、编码钩子都不会响——遥信页(ui_page_yx.c 同名宏注释)就是被像素 * 文本断言揪出来的。照抄坑的结论而不是坑的写法。 */ #define DIO_PUT(dst, lit) dio_put((dst), (lit), (uint32_t)UI_BUF_STRLEN) /* * 函数功能:开页复位帧缓存(接框架 init_cb) * 入口参数:无 * 返回值:无 * 限定条件:框架开页链内(uiTask) * 函数说明:序号必须复位——否则重开本页会沿用上次开页的帧号,首帧之前的 "--" 可能被永久 * 留在屏上(遥信页踩过的同一条纪律) */ static void pg_init(void) { s_seq = 0xFFFFFFFFu; (void)memset(&s_rt, 0, sizeof(s_rt)); } /* * 函数功能:按发布序号刷新帧缓存 * 入口参数:无 * 返回值:无 * 限定条件:uiTask 绘制链内(refresh 前) * 函数说明:ui_data_rt() 的通道是 0=成功 / -1=尚无首帧(不是 bool 成败);失败时把序号打回 * 不可能的值,下一轮一定重试,不会停在半新不旧的帧上 */ static void pg_sync(void) { uint32_t seq = ui_data_rt_seq(); if ((seq == s_seq) && (s_rt.valid != 0u)) { return; } if (ui_data_rt(&s_rt) != 0) { s_seq = 0xFFFFFFFFu; (void)memset(&s_rt, 0, sizeof(s_rt)); return; } s_seq = seq; } /* * 函数功能:总行数(固定 12 行,不随有效性增减) * 入口参数:无 * 返回值:行数 uint16_t * 限定条件:框架绘制/翻页链内 * 函数说明:故意返回常量——通道是硬件定数,行数随数据漂会让页数与黄金参考一起漂, * 也会让现场看不出"这一路到底存不存在" */ static uint16_t pg_count(void) { return (uint16_t)DIO_ROW_N; } /* * 函数功能:逐行取数(名 = 固定名表,值 = 开入/开出 mask 的一位) * 入口参数:a_row - 行下标(0..11) uint16_t * a_name - 名输出缓冲(UI_BUF_STRLEN) char * * a_value - 值输出缓冲 char * * 返回值:无 * 限定条件:框架绘制链内(本函数无副作用) * 函数说明:判定顺序是"先无效、再位值"——valid 为 0 时 mask 里可能仍是旧值(ui_data.h 的 * dio_di_valid 注),位值此时不可消费,必须画 "--";只有 valid 为 1 才解释那一位 */ static void pg_refresh(uint16_t a_row, char *a_name, char *a_value) { uint8_t bit; a_value[0] = '\0'; if (a_row >= (uint16_t)DIO_ROW_N) { a_name[0] = '\0'; return; /* 防御:行号越界不越读名表(count 恒 12,走不到) */ } pg_sync(); DIO_PUT(a_name, s_dio_name[a_row]); if (a_row < (uint16_t)DIO_DI_N) { if ((s_rt.valid == 0u) || (s_rt.dio_di_valid == 0u)) { DIO_PUT(a_value, DIO_INVALID); return; } bit = (uint8_t)((s_rt.dio_di_mask >> (uint8_t)a_row) & 0x01u); DIO_PUT(a_value, (bit != 0u) ? DIO_DI_ON : DIO_DI_OFF); return; } if ((s_rt.valid == 0u) || (s_rt.dio_do_valid == 0u)) { DIO_PUT(a_value, DIO_INVALID); return; } bit = (uint8_t)((s_rt.dio_do_mask >> (uint8_t)(a_row - (uint16_t)DIO_DI_N)) & 0x01u); DIO_PUT(a_value, (bit != 0u) ? DIO_DO_ON : DIO_DO_OFF); } /* * 页面描述符(外部链接:生成物 ui_page_registry.c 按菜单树 #page=di_do 绑定引用): * 12 行的动态页(rows=NULL + count_cb/refresh),8 行/页 = 2 页;几何全取 UI_TOKENS 列表原型, * 与交流量/遥信量页同骨架——首行 y=24,第 8 行 y=122、行带 y2=135,页脚在 y=143,不相撞。 * band_h 必须 >0(selectable 页选中行是黑字,无白带即不可见) */ const content_page_def_t ui_page_di_do_desc = { .id = "di_do", .title = "开入开出", .selectable = 1u, .top_y = UI_LIST_TOP, .pitch = UI_ROW_PITCH, .band_h = UI_ROW_BAND_H, .text_dy = 0, .left_x = UI_LIST_LEFT_X, .right_x = UI_LIST_RIGHT_X, .rows_per_page = UI_LIST_ROWS, .init_cb = pg_init, .count_cb = pg_count, .refresh = pg_refresh, /* 自动失效轮询(机制见 ui_content_page.h 的 auto_ms 注;口径见供给说明 §5.5): * 开入变位与开出动作都是低频事件,屏上可见变化只在 rt 帧(200ms 拍)落地时发生;周期取 * 500ms 与遥信页同档——变位"1s 内上屏"够用(最坏 200 + 500 = 700ms 到位), * 500 = 25 × LVGL 整刷周期 20ms,落整刷边界 */ .auto_ms = 500u, };