69 lines
1.6 KiB
C
69 lines
1.6 KiB
C
/**
|
||
* @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
|