UI 菜单初步完成

2026-09-07 10:48:18 +08:00
parent 89462d8aa1
commit 2b41bdccb5
30 changed files with 2226 additions and 859 deletions
@@ -0,0 +1,119 @@
+/* 本文件由 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, "主界面" },   /*  0  L0 */
+    {        0, "装置信息" },   /*  1  L1 */
+    {        0, "实时数据" },   /*  2  L1 */
+    {        2, "交流量" },   /*  3  L2 */
+    {        2, "直流量" },   /*  4  L2 */
+    {        2, "遥信量" },   /*  5  L2 */
+    {        0, "参数定值" },   /*  6  L1 */
+    {        6, "整定" },   /*  7  L2 */
+    {        7, "参数" },   /*  8  L3 */
+    {        7, "定值" },   /*  9  L3 */
+    {        7, "控制字" },   /* 10  L3 */
+    {        7, "软压板" },   /* 11  L3 */
+    {        6, "查看" },   /* 12  L2 */
+    {       12, "参数" },   /* 13  L3 */
+    {       12, "定值" },   /* 14  L3 */
+    {       12, "控制字" },   /* 15  L3 */
+    {       12, "软压板" },   /* 16  L3 */
+    {        0, "三遥设置" },   /* 17  L1 */
+    {       17, "遥测死区" },   /* 18  L2 */
+    {       17, "遥测系数" },   /* 19  L2 */
+    {       17, "遥信类型" },   /* 20  L2 */
+    {       17, "遥信防抖" },   /* 21  L2 */
+    {       17, "双点遥信" },   /* 22  L2 */
+    {        0, "装置维护" },   /* 23  L1 */
+    {       23, "时钟设置" },   /* 24  L2 */
+    {       23, "强制复归" },   /* 25  L2 */
+    {       23, "手动录波" },   /* 26  L2 */
+    {       23, "清除记录" },   /* 27  L2 */
+    {        0, "通讯参数" },   /* 28  L1 */
+    {       28, "通讯设置" },   /* 29  L2 */
+    {       28, "网口设置" },   /* 30  L2 */
+    {       28, "SNTP设置" },   /* 31  L2 */
+    {        0, "记录查询" },   /* 32  L1 */
+    {       32, "SOE记录" },   /* 33  L2 */
+    {       32, "事故记录" },   /* 34  L2 */
+    {       32, "操作记录" },   /* 35  L2 */
+    {       32, "保护告警" },   /* 36  L2 */
+    {       32, "保护启动" },   /* 37  L2 */
+    {       32, "遥控记录" },   /* 38  L2 */
+    {       32, "自检记录" },   /* 39  L2 */
+    {       32, "运行记录" },   /* 40  L2 */
+    {       32, "运行报告" },   /* 41  L2 */
+};
+
+/*
+ * 函数功能：取 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;
+}
+
+/*
+ * 函数功能：菜单表启动自检
+ * 入口参数：无
+ * 返回值：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;
+        }
+    }
+    return true;
+}