初始化版本

internal/menu_def.h

@@ -0,0 +1,69 @@
+/**
+ * @file menu_def.h
+ * @brief 菜单组件内部宏定义和辅助函数（用户无需关心）
+ */
+#ifndef MENU_DEF_H
+#define MENU_DEF_H
+
+#include "menu_config.h"
+#include "menu.h"
+#include <stdint.h>
+#include <string.h>
+
+/************************** 内部宏定义 **************************/
+/**
+ * @brief 断言宏（工业级：调试时检查，发布时忽略）
+ */
+#if MENU_CONFIG_ENABLE_ASSERT
+#define MENU_ASSERT(condition) \
+    do { \
+        if (!(condition)) { \
+            menu_utils_assert_failed(__FILE__, __LINE__); \
+            while (1); \
+        } \
+    } while (0)
+#else
+#define MENU_ASSERT(condition) ((void)0)
+#endif
+
+/**
+ * @brief 调试打印宏（工业级：集中控制调试输出）
+ */
+#if MENU_CONFIG_ENABLE_DEBUG
+#define MENU_DEBUG(fmt, ...) menu_utils_printf("[MENU DEBUG] " fmt "\r\n", ##__VA_ARGS__)
+#else
+#define MENU_DEBUG(fmt, ...) ((void)0)
+#endif
+
+/**
+ * @brief 内存清零宏
+ */
+#define MENU_MEM_SET_ZERO(ptr, size) memset((ptr), 0, (size))
+
+/**
+ * @brief 无效ID定义
+ */
+#define MENU_INVALID_ID  ((MenuNodeId)0xFFFF)
+
+/************************** 内部辅助函数声明 **************************/
+/**
+ * @brief 断言失败处理函数
+ * @param file 文件名
+ * @param line 行号
+ */
+void menu_utils_assert_failed(const char* file, uint32_t line);
+
+/**
+ * @brief 调试打印函数（对接port层的硬件打印接口）
+ * @param fmt 格式化字符串
+ * @param ... 可变参数
+ */
+void menu_utils_printf(const char* fmt, ...);
+
+/**
+ * @brief 获取系统滴答时间（ms，对接port层）
+ * @return 当前滴答时间
+ */
+uint32_t menu_utils_get_tick(void);
+
+#endif // MENU_DEF_H