打造实用个性的Log输出宏

蓝凌风

       我们在调试嵌入式程序的时候，用IDE+调试器是最直接的方式，但是很多时候我们还需要用串口输出来打印一些Debug的信息，来帮助我们调试。串口调试最简单的方式的话，最简单就是用printf来打印。但是只有Printf不能很好的控制输出的信息，或者让代码变得很臃肿。我们就用宏来封装下Printf，让它更好的使用，更加便利。这里给大家分享一个我在别人基础再改进的Log宏代码

1. #ifndef __LOG_H__
   
2. #define __LOG_H__
   
3. #include "bsp.h"
   
4. #define LOG_ERROR                      (0x01)
   
5. #define LOG_WARNING                    (0x02)
   
6. #define LOG_NOTICE                     (0x04)
   
7. #define LOG_INFO                       (0x08)
   
8. #define LOG_DEBUG                      (0x10)
   
9. 
   
10. /* This log macro must be set befor compiler, output error, warning, info debug lever */
    
11. #define DEBUG_LEVEL_SWITCH             (0xFF)
    
12. #define LOGHEARD            "LLFeng"
    
13. #define DebugPrintf(fmt, arg...)          UART_Printf(huart1,(const char*)fmt, ##arg)
    
14. 
    
15. #if ((DEBUG_LEVEL_SWITCH & LOG_ERROR) == LOG_ERROR)
    
16. #define log_err(fmt, arg...)      DebugPrintf("%s:[%s@%s,%d]"fmt"\r\n",LOGHEARD,__FUNCTION__,__FILE__,__LINE__, ##arg)
    
17. #else
    
18.     #define log_err(fmt, arg...)
    
19. #endif
    
20. 
    
21. #if ((DEBUG_LEVEL_SWITCH & LOG_WARNING) == LOG_WARNING)
    
22.     #define log_warn(fmt, arg...)      DebugPrintf("%s:"fmt"\r\n",LOGHEARD, ##arg)
    
23. #else
    
24.     #define log_warn(fmt, arg...)
    
25. #endif
    
26. 
    
27. #if ((DEBUG_LEVEL_SWITCH & LOG_NOTICE) == LOG_NOTICE)
    
28.     #define log_notice(fmt, arg...)      DebugPrintf("%s:"fmt"\r\n",LOGHEARD, ##arg)
    
29. #else
    
30.     #define log_notice(fmt, arg...)
    
31. #endif
    
32. 
    
33. #if ((DEBUG_LEVEL_SWITCH & LOG_INFO) == LOG_INFO)
    
34.     #define log_info(fmt, arg...)      DebugPrintf("%s:"fmt"\r\n",LOGHEARD, ##arg)
    
35. #else
    
36.     #define log_info(fmt, arg...)
    
37. #endif
    
38. 
    
39. #if ((DEBUG_LEVEL_SWITCH & LOG_DEBUG) == LOG_DEBUG)
    
40. #define log_debug(fmt, arg...)      DebugPrintf("%s:[%s@%s,%d]"fmt"\r\n",LOGHEARD,__FUNCTION__,__FILE__,__LINE__, ##arg)
    
41. #else
    
42.     #define log_debug(fmt, arg...)
    
43. #endif
    
44. 
    
45. #if ((DEBUG_LEVEL_SWITCH & LOG_DEBUG) == LOG_DEBUG)
    
46. #define log_data(data,size)    HAL_UART_Transmit(&huart1,data,size,100)     
    
47. #else
    
48.     #define log_data(data, size)
    
49. #endif
    
50. #endif

复制代码

       代码里一开始就是定义的log输出的等级LOG_ERROR，LOG_WARNING，LOG_NOTICE，LOG_INFO，LOG_DEBUG，每个等级控制Printf输出不同的内容，我们D 通过改变DEBUG_LEVEL_SWITCH的宏定义就能近山Log的等级输出，比如定义DEBUG_LEVEL_SWITCH 为LOG_ERROR，那最终程序只会打印log_debug这个Log宏函数的输出，其它等级就不会有输出。这里的log_debug还加入了打印函数名，文件名跟行数等信息，我们只要像printf那样调用log_debug就会加上打印我们前面说的内容来帮助我们更好的定位问题，这里还加上个性化输出的字符串LOGHEARD，我们改变LOGHEARD的定义就让Log输出变的很有个性。如下图用log_info和log_debug打印的输出。

       在实际写代码的过程，我们只根据实际情况去调用不同的Log函数去打印我们所要的信息。调试完毕后我们再定义DEBUG_LEVEL_SWITCH调试等级来控制log不同等级的输出或者压根就不输出。比如我代码定义DEBUG_LEVEL_SWITCH 为0xFF，就是打开了所有的输出，等我们调试完了，不需要看其它没必须的信息，我们不用去删除代码，只需要再改输出等级DEBUG_LEVEL_SWITCH 为LOG_ERROR|LOG_DEBUG ，这样log就会打印对应的这两条宏函数的输出。这样就既便利又有修改。

bo0ejypjc0

谢谢分享,

7iekap1

myjx1e2g

好贴，值得分享,