Files
STM32F4-Base/Drivers/BSP/UI/ui_page_di_do.c
T
wandering1 2b466b85f0 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.
2026-11-16 21:45:08 +08:00

232 lines
12 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 模块名称: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,
};