Files
STM32F4-Base/Drivers/BSP/UI/ui_menu_tab.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

140 lines
6.0 KiB
C

/*
* 模块名称:UI 菜单节点表(自动生成)
* 模块功能:菜单节点扁平父子索引表 + 5 个表查询 API(导航逻辑层与显示层共用)
* 适用平台:STM32F407ZGTx / PC 模拟器(共用源码)
* 作者:王建锋
* 创建日期:2026-09-07
* 修改记录:
* 2026-09-13 王建锋 工程约定规范化(文件头 / K&R 大括号),内容由生成器自动更新
* 自动生成:本文件由 tools/menu_gen/gen_menu.py 从 ui_menu_tree.txt 自动生成,请勿手改。
* 修改菜单:编辑 ui_menu_tree.txt 后重跑 `python tools/menu_gen/gen_menu.py`。
*/
#include "ui_menu_tab.h"
const ui_menu_node_t g_menu_tab[UI_MENU_TAB_COUNT] = {
{ MENU_ROOT, 0u, "主界面" }, /* 0 主界面 */
{ 0, 0u, "装置信息" }, /* 1 一级菜单 */
{ 0, 0u, "实时数据" }, /* 2 一级菜单 */
{ 2, 0u, "交流量" }, /* 3 二级菜单 */
{ 2, 0u, "直流量" }, /* 4 二级菜单 */
{ 2, 0u, "遥信量" }, /* 5 二级菜单 */
{ 2, 0u, "开入开出" }, /* 6 二级菜单 */
{ 0, 0u, "参数定值" }, /* 7 一级菜单 */
{ 7, 0u, "整定" }, /* 8 二级菜单 */
{ 8, 1u, "参数" }, /* 9 三级菜单 */
{ 8, 1u, "定值" }, /* 10 三级菜单 */
{ 8, 1u, "控制字" }, /* 11 三级菜单 */
{ 8, 1u, "软压板" }, /* 12 三级菜单 */
{ 7, 0u, "查看" }, /* 13 二级菜单 */
{ 13, 0u, "参数" }, /* 14 三级菜单 */
{ 13, 0u, "定值" }, /* 15 三级菜单 */
{ 13, 0u, "控制字" }, /* 16 三级菜单 */
{ 13, 0u, "软压板" }, /* 17 三级菜单 */
{ 0, 0u, "三遥设置" }, /* 18 一级菜单 */
{ 18, 1u, "遥测死区" }, /* 19 二级菜单 */
{ 18, 1u, "遥测系数" }, /* 20 二级菜单 */
{ 18, 1u, "遥信类型" }, /* 21 二级菜单 */
{ 18, 1u, "遥信防抖" }, /* 22 二级菜单 */
{ 18, 1u, "双点遥信" }, /* 23 二级菜单 */
{ 0, 0u, "装置维护" }, /* 24 一级菜单 */
{ 24, 1u, "时钟设置" }, /* 25 二级菜单 */
{ 24, 1u, "强制复归" }, /* 26 二级菜单 */
{ 24, 1u, "手动录波" }, /* 27 二级菜单 */
{ 24, 1u, "清除记录" }, /* 28 二级菜单 */
{ 0, 0u, "通讯参数" }, /* 29 一级菜单 */
{ 29, 1u, "通讯设置" }, /* 30 二级菜单 */
{ 29, 1u, "网口设置" }, /* 31 二级菜单 */
{ 29, 1u, "SNTP设置" }, /* 32 二级菜单 */
{ 0, 0u, "记录查询" }, /* 33 一级菜单 */
{ 33, 0u, "SOE记录" }, /* 34 二级菜单 */
{ 33, 0u, "事故记录" }, /* 35 二级菜单 */
{ 33, 0u, "操作记录" }, /* 36 二级菜单 */
{ 33, 0u, "保护告警" }, /* 37 二级菜单 */
{ 33, 0u, "保护启动" }, /* 38 二级菜单 */
{ 33, 0u, "遥控记录" }, /* 39 二级菜单 */
{ 33, 0u, "自检记录" }, /* 40 二级菜单 */
{ 33, 0u, "运行记录" }, /* 41 二级菜单 */
{ 33, 0u, "运行报告" }, /* 42 二级菜单 */
{ 33, 0u, "录波回放" }, /* 43 二级菜单 */
};
/*
* 函数功能:取 node 的直接子项(按表序),最多 max 个
* 入口参数:node - 节点下标 uint8_t
* out - 子节点下标输出缓冲 uint8_t *
* max - 缓冲容量 uint8_t
* 返回值:实际子项个数 uint8_t
* 限定条件:node < UI_MENU_TAB_COUNT
* 函数说明:子项 = 表中所有 parent == 本下标的行(表序即显示序);建页核心查询
*/
uint8_t ui_menu_tab_children(uint8_t node, uint8_t out[], uint8_t max) {
uint8_t n = 0u;
for (uint8_t i = 0u; i < UI_MENU_TAB_COUNT && n < max; i++) {
if (g_menu_tab[i].parent == node) {
out[n++] = i;
}
}
return n;
}
/*
* 函数功能:判断 node 有无子项
* 入口参数:node - 节点下标 uint8_t
* 返回值:有子项返回 true(=菜单、行带▶);无子项返回 false(=叶子)
* 限定条件:node < UI_MENU_TAB_COUNT
* 函数说明:菜单/叶子由"是否有子项"自动推导,无单独类型字段
*/
bool ui_menu_tab_has_children(uint8_t node) {
for (uint8_t i = 0u; i < UI_MENU_TAB_COUNT; i++) {
if (g_menu_tab[i].parent == node) {
return true;
}
}
return false;
}
/*
* 函数功能:取节点显示名
* 入口参数:node - 节点下标 uint8_t
* 返回值:显示文本(Flash 字面量) const char *
* 限定条件:node < UI_MENU_TAB_COUNT
* 函数说明:行文本一律经此取静态字符串,不 strdup
*/
const char *ui_menu_tab_name(uint8_t node) {
return g_menu_tab[node].name;
}
/*
* 函数功能:判断节点是否需密码(叶子密码保护)
* 入口参数:node - 节点下标 uint8_t
* 返回值:true - 需密码页(按所输密码授权查看/修改权限);false - 直接进(只读)
* 限定条件:无
* 说明:表 pwd 列取自源 ui_menu_tree.txt 行尾 #P 注记;导航逻辑层据此决定是否先经密码页
*/
bool ui_menu_tab_has_pwd(uint8_t node) {
return (g_menu_tab[node].pwd != 0u);
}
/*
* 函数功能:菜单表启动自检
* 入口参数:无
* 返回值:true - 表有效;false - 存在越界 parent(表内笔误)
* 限定条件:无
* 函数说明:每个非根节点的 parent 必须为 MENU_ROOT 或有效下标;在 ui_menu_init 调用
*/
bool ui_menu_tab_valid(void) {
for (uint8_t i = 0u; i < UI_MENU_TAB_COUNT; i++) {
if (i == 0u) {
continue; /* 根 */
}
uint8_t p = g_menu_tab[i].parent;
if (p != MENU_ROOT && p >= UI_MENU_TAB_COUNT) {
return false;
}
if (g_menu_tab[i].pwd > 1u) {
return false; /* pwd 只取 0/1(行尾注记笔误捕获) */
}
}
return true;
}