2b466b85f0
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.
232 lines
12 KiB
C
232 lines
12 KiB
C
/*
|
||
* 模块名称: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 <string.h>
|
||
|
||
#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,
|
||
};
|