wandering1
7e15f49ff3
这族是菜单深度号：L0 根、L1 一级、L2 二级、L3 三级。用户 2026-10-28：「编号看不懂」， 且与采集链分层的 L1~L5 撞形（同一份文档里两套 L 号，读的人得先猜是哪套）。 改法（生成物走生成器，不手改）： - `tools/menu_gen/gen_menu.py`：加 MENU_LEVEL_NAMES 常量，生成 ui_menu_tab.c 的注释从 `/* 12 L2 */` 变成 `/* 12 二级菜单 */`；重跑生成器，生成物 42 行注释随之更新。 - 文档 4 篇 113 行：菜单页面设计（94）、内容页架构（10）、01_主界面_说明（8）、 中文字体生成与配置（1）。映射：L0 → 主界面（根）、L1/L2/L3 → 一级/二级/三级菜单； `4 级（L0~L3）` → `4 级（主界面 → 三级菜单）`；括号里的 `（L1）` → `（一级菜单）`。 范围纪律：只动 UI 菜单这一族。同名的测试层级族（L0/L0.5/L1/L2/L3，见测试开发标准流程） 与链路延迟分段 L1~L8 不动——那两个属批次 3 的另两族。 验证：@build 0 错 0 警；check_menu_rows 8 状态 PASS（5368 B 池不变）；生成器重跑幂等 （rc=0，生成物只剩注释差异 42/42 行）；doc-links 通过（195 文档）；mojibake / bom-guard / 新编号门禁 / git diff --check 全绿。
138 lines
5.9 KiB
C
138 lines
5.9 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 二级菜单 */
|
|
{ 0, 0u, "参数定值" }, /* 6 一级菜单 */
|
|
{ 6, 0u, "整定" }, /* 7 二级菜单 */
|
|
{ 7, 1u, "参数" }, /* 8 三级菜单 */
|
|
{ 7, 1u, "定值" }, /* 9 三级菜单 */
|
|
{ 7, 1u, "控制字" }, /* 10 三级菜单 */
|
|
{ 7, 1u, "软压板" }, /* 11 三级菜单 */
|
|
{ 6, 0u, "查看" }, /* 12 二级菜单 */
|
|
{ 12, 0u, "参数" }, /* 13 三级菜单 */
|
|
{ 12, 0u, "定值" }, /* 14 三级菜单 */
|
|
{ 12, 0u, "控制字" }, /* 15 三级菜单 */
|
|
{ 12, 0u, "软压板" }, /* 16 三级菜单 */
|
|
{ 0, 0u, "三遥设置" }, /* 17 一级菜单 */
|
|
{ 17, 1u, "遥测死区" }, /* 18 二级菜单 */
|
|
{ 17, 1u, "遥测系数" }, /* 19 二级菜单 */
|
|
{ 17, 1u, "遥信类型" }, /* 20 二级菜单 */
|
|
{ 17, 1u, "遥信防抖" }, /* 21 二级菜单 */
|
|
{ 17, 1u, "双点遥信" }, /* 22 二级菜单 */
|
|
{ 0, 0u, "装置维护" }, /* 23 一级菜单 */
|
|
{ 23, 1u, "时钟设置" }, /* 24 二级菜单 */
|
|
{ 23, 1u, "强制复归" }, /* 25 二级菜单 */
|
|
{ 23, 1u, "手动录波" }, /* 26 二级菜单 */
|
|
{ 23, 1u, "清除记录" }, /* 27 二级菜单 */
|
|
{ 0, 0u, "通讯参数" }, /* 28 一级菜单 */
|
|
{ 28, 1u, "通讯设置" }, /* 29 二级菜单 */
|
|
{ 28, 1u, "网口设置" }, /* 30 二级菜单 */
|
|
{ 28, 1u, "SNTP设置" }, /* 31 二级菜单 */
|
|
{ 0, 0u, "记录查询" }, /* 32 一级菜单 */
|
|
{ 32, 0u, "SOE记录" }, /* 33 二级菜单 */
|
|
{ 32, 0u, "事故记录" }, /* 34 二级菜单 */
|
|
{ 32, 0u, "操作记录" }, /* 35 二级菜单 */
|
|
{ 32, 0u, "保护告警" }, /* 36 二级菜单 */
|
|
{ 32, 0u, "保护启动" }, /* 37 二级菜单 */
|
|
{ 32, 0u, "遥控记录" }, /* 38 二级菜单 */
|
|
{ 32, 0u, "自检记录" }, /* 39 二级菜单 */
|
|
{ 32, 0u, "运行记录" }, /* 40 二级菜单 */
|
|
{ 32, 0u, "运行报告" }, /* 41 二级菜单 */
|
|
};
|
|
|
|
/*
|
|
* 函数功能：取 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;
|
|
}
|