RT-Thread-RT-Thread Debug 分析与调整RT-Thread问答社区

RT-Thread Debug 分析与调整

5.00

发布于 2023-06-29 18:03:51 浏览：1516 订阅该版

[tocm]

# RT-Thread Debug 分析与调整

RT-Thread 中可以通过 menuconfig 使能相关宏，配置和使用 debug 功能，即可向工作台输出程序运行信息，方便调试和使用。

但目前的 rt-thread(5.0.0) 关于 debug 存在 `rtdebug.h` 和 `rtdbg.h` 这两个文件；存在冗余，并且 `rtdbg.h` 中实现的 `LOG_E` ,  `LOG_W` ,  `LOG_I` ,  `LOG_D` 更优，因此考虑**将  `rtdebug.h` 中的 `RT_DEBUG_LOG` 废弃，全部替换为 `LOG_x`**

## 问题分析

`rtdebug.h` 中的 `RT_DEBUG_LOG`  具体实现如下：

```
#define RT_DEBUG_LOG(type, message)
do 
{
    if (type)
        rt_kprintf message;
}
while (0)
```

调用示例如下：

```
RT_DEBUG_LOG(RT_DEBUG_THREAD, ("startup a thread:%s with priority:%d\n",
                              thread->parent.name, thread->current_priority));
/* RT_DEBUG_THREAD default is 0 */
```

可以看出， `RT_DEBUG_LOG` 可以通过相关宏，实现对特定内核对象的单独使能调试。

但 `rtdbg.h` 中的 `LOG_x` 是将调试信息分为不同的等级，通过与设定的 `DBG_LVL` 进行比较，输出不同等级的调试信息。

可以看出 `LOG_x` 主要针对的是不同等级， `RT_DEBUG_LOG`  针对的是不同对象。那接下来要考虑的重点就是：**废弃  `rtdebug.h` 中 `RT_DEBUG_LOG`  的同时，如何使用  `LOG_x`  保留单独调试不同内核对象的特性。**

## 解决方案

使用以下解决方案：

```C
#define DBG_TAG           "kernel.thread"
#ifdef RT_DEBUG_THREAD
#define DBG_LVL           DBG_LOG
#else
#define DBG_LVL           DBG_WARNING
#endif
#include <rtdbg.h>
```

以内核对象 thread 为例，将以上代码添加到对应的 thread.c 文件中，即可使用对应的 LOG_x，可以注意到，宏判断使用的是 `#ifdef RT_DEBUG_THREAD` 而不再是通过判断对应宏值为 0 还是 1，这是因为 rtdebug.h 老版本问题，现在可以通过 Kconfig 非常便捷的定义相关宏，因此修改了相应的 Kconifg 文件：

```python
    /* old version */
    config RT_DEBUG_THREAD_CONFIG
        bool "Enable debugging of Thread State Changes"
        default n

config RT_DEBUG_THREAD
        int
        default 1 if RT_DEBUG_THREAD_CONFIG
    /* old version */
    
==============================================================================
    
    /* new version */
    config RT_DEBUG_THREAD
        bool "Enable debugging of Thread State Changes"
        default n
    /* new version */
    
```

可以看出，修改后更加的简洁明了。

并且之前使用 `RT_DEBUG_LOG`  的内核对象的调试信息基本都为 `LOG_D` 级别，于是就可以使用  `LOG_D` 进行替换。

需要注意，使用  `LOG_x`  替换  `RT_DEBUG_LOG`  时，要删去换行符，因为 `LOG_x`  已经带有换行的效果。

于是我们就通过定义相关的宏，更改了对应内核对象的调试等级，使用 `LOG_x` 实现了单独调试不同内核对象的效果。

## 后续优化方向

考虑如何优化  `rtdebug.h` 中的 `RT_DEBUG_CONTEXT_CHECK` 相关，实现   `rtdebug.h`  的彻底优化，感兴趣的小伙伴可以一起交流。