相信大多數嵌入式開發者都會碰到對程序進行調試或者查找BUG的情況，常見的兩種方法都是仿真和通過日志進行的。

有條件仿真的是更好，單是在編寫嵌入式軟件程序過程中，并不是所有的硬件都支持仿真或者方便仿真，這樣大多數方法便是加打印信息進行找問題。

打印的接口有很多種，比如串口，網絡，顯示等等。簡單的硬件開發串口估計是最常用的。這里簡單記錄下一種日志打印方法。

目的：

1）方便查找打印日志

2）日志格式規范

3）可以查看用戶添加信息，文件信息，函數接口，以及文件所在行號

4）支持format格式

5）可以支持實時時間

基本知識：

C語言中的__FILE__、LINE__和__FUNCTION

1、FILE 用于指示本行代碼所在源文件的文件名；

2、__LINE__用于指示本行代碼所在源文件中的位置（行數）；

3、__FUNCTION__用于指示本行代碼所在函數（函數名）；

注：

1）"FILE "、" LINE "、" FUNCTION "等均大小寫敏感

2）支持需要添加頭文件#include

源碼

#define DEBUG_EN (1u)
 
#if (DEBUG_EN)
 
#define DEBUG_MAX_SIZE 512
extern char szBuf[DEBUG_MAX_SIZE];
 
#define DEBUG_INFO( format, ... ) do{\\
    u16 unLen = 0;\\
    unLen += snprintf(szBuf+unLen,DEBUG_MAX_SIZE, "[INFO][%s][@%s][#%d]:",__FILE__,__FUNCTION__,__LINE__);\\
    unLen += snprintf(szBuf+unLen,DEBUG_MAX_SIZE-unLen, format, ## __VA_ARGS__ );\\
    usart1_send_buf_with_txe((u8 *)szBuf,unLen);\\
}while(0)
 
#define DEBUG_WARN( format, ... ) do{\\
    u16 unLen = 0;\\
    unLen += snprintf(szBuf+unLen,DEBUG_MAX_SIZE, "[WARN][%s][@%s][#%d]:",__FILE__,__FUNCTION__,__LINE__);\\
    unLen += snprintf(szBuf+unLen,DEBUG_MAX_SIZE-unLen, format, ## __VA_ARGS__ );\\
    usart1_send_buf_with_txe((u8 *)szBuf,unLen);\\
}while(0)
 
#define DEBUG_ERR( format, ... ) do{\\
    u16 unLen = 0;\\
    unLen += snprintf(szBuf+unLen,DEBUG_MAX_SIZE, "[ERR][%s][@%s][#%d]:",__FILE__,__FUNCTION__,__LINE__);\\
    unLen += snprintf(szBuf+unLen,DEBUG_MAX_SIZE-unLen, format, ## __VA_ARGS__ );\\
    usart1_send_buf_with_txe((u8 *)szBuf,unLen);\\
}while(0)
 
#elif 
 
#define DEBUG_INFO(...)
#define DEBUG_WARN(...)
#define DEBUG_ERR(...)
 
#endif

源碼主要使用宏定義的方式，為了支持文件、行號，函數等等，不能使用單獨的函數進行定義。具體原因可以思考下，不過多贅述。

C文件目前只有一個數組定義char szBuf[DEBUG_MAX_SIZE];。

為了兼容，INFO，WARN和ERR三個共用一個buf，聲明全局變量更主要的一個原因是使用了串口的中斷發送函數usart1_send_buf_with_txe，而不是循環發送完成再退出，這里傳輸是進行指針傳遞的，發送使用中斷的好處就是高效率，不耽誤其他程序跑。

當然移植的時候完全可以根據自己的接口和實現方式進行更換。

實現效果

[INFO][..\\source\\main.c][@main][#36]:testStr[111],testInt[111],testHex[0x000015BC]
[WARN][..\\source\\main.c][@main][#37]:testStr[111],testInt[111],testHex[0x000015BC]
[ERR][..\\source\\main.c][@main][#38]:testStr[111],testInt[111],testHex[0x000015BC]