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

89 lines
4.2 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 菜单节点表头文件(自动生成)
* 模块功能:菜单节点结构、表规模护栏与表查询 API 声明
* 适用平台:STM32F407ZGTx / PC 模拟器(共用源码)
* 作者:王建锋
* 创建日期:2026-09-07
* 修改记录:
* 2026-09-13 王建锋 工程约定规范化(文件头),内容由生成器自动更新
* 自动生成:本文件由 tools/menu_gen/gen_menu.py 从 ui_menu_tree.txt 自动生成,请勿手改。
* 修改菜单:编辑 ui_menu_tree.txt 后重跑 `python tools/menu_gen/gen_menu.py`。
*/
#ifndef UI_MENU_TAB_H
#define UI_MENU_TAB_H
#include <stdint.h>
#include <stdbool.h>
#define MENU_ROOT 0xFFu /* 根哨兵:仅根节点(主界面)的 parent 取此值;8 位,上限 255 项 */
/* 菜单节点:子项 = parent 等于本下标的所有行(按表序);有子项=菜单,无=叶子 */
/* 字段序 parent/pwd 在前:32 位下两项 8 位合并 + 4 位指针 = 8 B/项 */
typedef struct {
uint8_t parent; /* 父节点下标(0..254);根为 MENU_ROOT(0xFF) */
uint8_t pwd; /* 1 = 需密码(密码页按所输密码授权);0 = 直接进(只读) */
const char *name; /* 显示文本(字面量,存 Flash) */
} ui_menu_node_t;
#define UI_MENU_TAB_COUNT 44
/* 护栏:8 位索引上限 255 项(哨兵 0xFF 占用 255);超界则编译失败(C99 写法,兼容 ARMCC v5) */
typedef char menu_tab_count_check[(UI_MENU_TAB_COUNT <= 255) ? 1 : -1];
extern const ui_menu_node_t g_menu_tab[];
/*
* 表查询 API(导航逻辑层 ui_menu.c 与显示层 ui_menu_view.c 共用):
* 实现随表生成,改菜单(ui_menu_tree.txt)调用方零代码改动。
*/
/*
* 函数功能:取某节点的直接子项(按表序)
* 入口参数:node - 节点下标 uint8_t 0 - 表长-1
* out - 子项下标输出 uint8_t[] 长度 >= max,可为 NULL(只数个数时)
* max - 最多写出个数 uint8_t >= 1
* 返回值:实际写出的子项个数 uint8_t 0 - max(0 = 叶子节点)
* 限定条件:node 越界时返回 0,不写 out(与"叶子"同形,调用方需要区分就先用 has_children)
* 函数说明:不分配内存、不递归,只查一层。
*/
uint8_t ui_menu_tab_children(uint8_t node, uint8_t out[], uint8_t max);
/*
* 函数功能:判断节点是否为菜单节点(有子项)
* 入口参数:node - 节点下标 uint8_t 0 - 表长-1
* 返回值:true - 有子项(显示为菜单,带 ▶);false - 无子项(叶子,可进内容页)
* 限定条件:纯查询,无副作用;node 越界返回 false
* 函数说明:这是**谓词**(bool 合法),不是成败码——bsp-err 的 err-type 检查里白名单放行的形态。
*/
bool ui_menu_tab_has_children(uint8_t node);
/*
* 函数功能:取节点的显示名
* 入口参数:node - 节点下标 uint8_t 0 - 表长-1
* 返回值:显示名字符串指针 const char* 指向表内静态存储,**不为 NULL**(越界返回空串)
* 限定条件:返回的是静态存储地址,调用方不得写、不得 free
* 函数说明:编码随表来源(ui_menu_tree.txt),显示层直接喂 LVGL。
*/
const char *ui_menu_tab_name(uint8_t node);
/*
* 函数功能:判断该叶子是否需要密码
* 入口参数:node - 节点下标 uint8_t 0 - 表长-1
* 返回值:true - 需密码(先进密码页,按所输密码授权);false - 直接进(只读)
* 限定条件:纯查询;node 越界返回 false(保守取"只读",不放开写权限)
* 函数说明:授权强度由密码页所输密码决定,本函数只回答"要不要过这一关"。
*/
bool ui_menu_tab_has_pwd(uint8_t node);
/*
* 函数功能:菜单表启动自检(表与生成器是否自洽)
* 入口参数:无
* 返回值:true - 表自洽(非根节点的 parent 下标均有效、pwd 只取 0/1);
* false - 表被手工改坏,调用方应拒绝进入菜单而不是继续用
* 限定条件:ui_menu_init() 阶段调用一次
* 函数说明:宁可拒绝显示,也不要按一张错表导航——错表可能把只读叶子指到写页面上。
*/
bool ui_menu_tab_valid(void);
#endif