rtdbg.h 是 RT-Thread 操作系统中用于调试日志的头文件,它为开发者提供了丰富的宏定义来配置日志输出行为,并提供了一些便捷的 API 供使用。下面我将从 配置宏 和 可用 API 两个方面进行分析。
一、配置宏
这些宏主要用于控制日志的行为(如级别、标签、颜色等),开发者可以根据需求在源文件中定义这些宏以启用或调整功能:
- 日志启用相关
DBG_ENABLE: 启用日志功能。
如果 RT_USING_DEBUG 已定义但未定义 DBG_ENABLE,会自动启用。
RT_USING_DEBUG: 强制启用所有日志功能。
RT_USING_ULOG: 使用 ulog 替代 rtdbg 的日志系统。
如果启用了 ulog,则 rtdbg.h 中的日志宏会被替换为 ulog 的接口。 - 日志级别相关
DBG_LVL 或 DBG_LEVEL: 设置当前模块的日志输出级别。
可选值:DBG_ERROR (0), DBG_WARNING (1), DBG_INFO (2), DBG_LOG (3)
默认级别是 DBG_WARNING。
LOG_D, LOG_I, LOG_W, LOG_E: 分别对应不同级别的日志输出。
根据 DBG_LEVEL 决定是否编译进代码。 - 日志标签相关
DBG_TAG: 定义当前模块的日志标签。
例如:#define DBG_TAG “MOD_TAG”
DBG_SECTION_NAME: 实际使用的日志标签名称,默认等于 DBG_TAG。 - 颜色输出相关
DBG_COLOR: 启用彩