交心
在我們嵌入式開發(fā)中，調(diào)試代碼的方法有很多。比如使用調(diào)試器在線調(diào)試、借助一些測量儀器、輸出調(diào)試日志等方式。
沒有哪種方法是最好的調(diào)試方法，實際開發(fā)中需要根據(jù)實際情況借助不同的方法進行調(diào)試。但是，在一些稍微大點的項目中，輸出調(diào)試日志卻是比較好的調(diào)試方法。
輸出日志可以比較隨意，想輸出什么就輸出什么，但是也得注意兩個點：
一是輸出的日志盡量整潔明了，因為如果日志稍微多一點，看起來就會很亂，很擾心；
二是方便打開/關(guān)閉日志相關(guān)代碼，程序調(diào)試階段打開，方便定位問題，程序發(fā)布階段關(guān)閉，可節(jié)省不必要地資源開銷。
最近在做Linux方面的開發(fā)，整天分析日志，有點體會。順便也寫點日志筆記分享給大家：
站在巨人的肩膀上
網(wǎng)絡(luò)上有很多現(xiàn)成的日志庫，簡單移植一下就可以使用。這里分享一個常用的日志庫—— EasyLogger。
碼云倉庫及介紹地址：
https://gitee.com/Armink/EasyLogger?_from=gitee_search#easylogger
1、EasyLogger介紹
EasyLogger是一款超輕量級(ROM<1.6K, RAM<0.3K)、高性能的C/C++日志庫，非常適合對資源敏感的軟件項目，例如：IoT產(chǎn)品、可穿戴設(shè)備、智能家居等等。
2、EasyLogger特性
-
支持用戶自定義輸出方式（例如：終端、文件、數(shù)據(jù)庫、串口、485、Flash...）； -
日志內(nèi)容可包含級別、時間戳、線程信息、進程信息等； -
日志輸出被設(shè)計為線程安全的方式，并支持 異步輸出及 緩沖輸出模式； -
支持多種操作系統(tǒng)（RT-Thread、UCOS、Linux、Windows...），也支持裸機平臺； -
日志支持 RAW格式，支持 hexdump； -
支持按 標(biāo)簽 、 級別、 關(guān)鍵詞進行動態(tài)過濾； -
各級別日志支持不同顏色顯示； -
擴展性強，支持以插件形式擴展新功能。
3、EasyLogger的嘗試
該開源項目提供了豐富的demo，有stm32裸機的demo，有RT-Thread的demo、有Windows下的demo、有Linux下的demo。這里我們跑一下stm32裸機的demo。
進行初始化及一些設(shè)置之后就可以調(diào)用其給我們用戶提供的日志打印接口log_a、log_e、log_w等來輸出日志信息，我們使用日志庫也主要使用的是這幾個接口，其它輔助功能有興趣的朋友可自行學(xué)習(xí)使用。
4、EasyLogger的移植、剖析
想要對EasyLogger進行深入學(xué)習(xí)可查閱項目的readme文件、源碼閱讀及如下兩篇文章：
【開源解讀】一款輕量級C日志庫-EasyLogger
第3期 | EasyLogger，一款輕量級且高性能的日志庫
自己動手，豐衣足食
網(wǎng)絡(luò)上的一些日志庫的功能過于強大，有時候我們用不上一些高級的功能，沒必要大動干戈移植一個日志庫。
這時候我們可以通過簡單的幾行代碼實現(xiàn)我們自己的日志打印格式。其實之前也有簡單分享過打印相關(guān)的技術(shù)筆記：C語言、嵌入式中幾個非常實用的宏技巧
摘選那篇筆記的代碼：
左右滑動查看全部代碼>>>
#define??DEBUG???1??
#if?DEBUG
??#define?DBG_PRINTF(fmt,?args...)??\
??do\
??{\
????printf("<>?" ,?__FILE__,?__LINE__,?__FUNCTION__);\
????printf(fmt,?##args);\
??}while(0)
#else
??#define?DBG_PRINTF(fmt,?args...)???
#endif
我們拿來修改一下，下面分享兩種簡單的日志輸出方式：
1、分模塊打印
給各個模塊加上宏打印開關(guān)。在調(diào)試時可以通過宏開關(guān)先屏蔽掉沒有問題的模塊的日志信息，減少日志地輸出，方便專注于有問題的模塊分析。
直接上代碼吧。。。
（1）main.c
左右滑動查看全部代碼>>>
/*?
demo:?分模塊打印日志
公眾號：嵌入式大雜燴
*/
#include?
#include?"module1.h"
#include?"module2.h"
int?main(void)
{
?module1_print();
?module2_print();
?return?0;
}
（2）mylog.h
左右滑動查看全部代碼>>>
#define?__MYLOG_H__
#ifdef?__cplusplus
extern?"C"?{
#endif
#include?
/*?各模塊日志開關(guān)?*/
#define??MODULE1_LOG_SWITCH??1
#define??MODULE2_LOG_SWITCH??1
/*?日志統(tǒng)一輸出的格式?*/
#define?DBG_PRINTF(fmt,?args...)??\
do\
{\
?printf("<>?" ,?__FILE__,?__LINE__,?__FUNCTION__);\
?printf(fmt,?##args);\
}while(0)
#ifdef?__cplusplus
}
#endif
#endif?/*?__MYLOG_H__?*/
（3）module1.c
左右滑動查看全部代碼>>>
#include?"module1.h"
#if?MODULE1_LOG_SWITCH
#define?LOG_MODULE1(fmt,?args...)???DBG_PRINTF(fmt,?##args)??
#else
#define?LOG_MODULE1(fmt,?args...)?
#endif
void?module1_print(void)
{
?LOG_MODULE1("hello?module1\n");
}
（4）module1.h
左右滑動查看全部代碼>>>
#ifndef?__MODEL1_H__
#define?__MODEL1_H__
#ifdef?__cplusplus
extern?"C"?{
#endif
#include?"mylog.h"
void?module1_print(void);
#ifdef?__cplusplus
}
#endif
#endif?/*?__MODEL1_H__?*/
（5）module2.c
左右滑動查看全部代碼>>>
#include?"module2.h"
#if?MODULE2_LOG_SWITCH
#define?LOG_MODULE2(fmt,?args...)???DBG_PRINTF(fmt,?##args)??
#else
#define?LOG_MODULE2(fmt,?args...)?
#endif
void?module2_print(void)
{
?LOG_MODULE2("hello?module2\n");
}
（6）module2.h
左右滑動查看全部代碼>>>
#ifndef?__MODEL2_H__
#define?__MODEL2_H__
#ifdef?__cplusplus
extern?"C"?{
#endif
#include?"mylog.h"
void?module2_print(void);
#ifdef?__cplusplus
}
#endif
#endif?/*?__MODEL2_H__?*/
通過模塊日志開關(guān)可以打開/關(guān)閉各模塊日志打印接口。這里的demo只拿兩個模塊作為例子，可模仿這兩個模塊拓展其它模塊。
編譯、運行：
2、分級打印
分級打印是日志庫里常用的方式，比如上面的EasyLogger日志庫的分級打印實現(xiàn)方式：
這也是EasyLogger的核心部分。
我們可以把這一部分抽出來修改一下：
（1）main.c
左右滑動查看全部代碼>>>
/*??
demo：分級打印日志
公眾號：嵌入式大雜燴
*/
#include?"mylog.h"
int?main(void)
{
????LOG_A("Hello?world");
????LOG_E("Hello?world");
????LOG_W("Hello?world");
????LOG_I("Hello?world");
????LOG_D("Hello?world");
????LOG_V("Hello?world");
?return?0;
}
（2）mylog.h
左右滑動查看全部代碼>>>
#ifndef?__MYLOG_H__
#define?__MYLOG_H__
#ifdef?__cplusplus
extern?"C"?{
#endif
#include?
/*?日志級別?*/
#define?ELOG_LVL_ASSERT????0
#define?ELOG_LVL_ERROR?????1
#define?ELOG_LVL_WARN??????2
#define?ELOG_LVL_INFO??????3
#define?ELOG_LVL_DEBUG?????4
#define?ELOG_LVL_VERBOSE???5
/*?設(shè)置日志級別?*/
#define?ELOG_OUTPUT_LVL????ELOG_LVL_VERBOSE
/*?斷言(Assert)??*/
#define?LOG_A(args,...)\
do{\
????if?(ELOG_OUTPUT_LVL?>=?ELOG_LVL_ASSERT)\
????{\
????????printf("[A/%s?Line:%.4d]?"?args?"\n",?__FILE__,?__LINE__,?##__VA_ARGS__);\
????}\
}while(0)
/*?錯誤(Error)?*/
#define?LOG_E(args,...)\
do{\
????if?(ELOG_OUTPUT_LVL?>=?ELOG_LVL_ASSERT)\
????{\
????????printf("[E/%s?Line:%.4d]?"?args?"\n",?__FILE__,?__LINE__,?##__VA_ARGS__);\
????}\
}while(0)
/*?警告(Warn)?*/
#define?LOG_W(args,...)\
do{\
????if?(ELOG_OUTPUT_LVL?>=?ELOG_LVL_WARN)\
????{\
????????printf("[W/%s?Line:%.4d]?"?args?"\n",?__FILE__,?__LINE__,?##__VA_ARGS__);\
????}\
}while(0)
/*?信息(Info)?*/
#define?LOG_I(args,...)\
do{\
????if?(ELOG_OUTPUT_LVL?>=?ELOG_LVL_INFO)\
????{\
????????printf("[I/%s?Line:%.4d]?"?args?"\n",?__FILE__,?__LINE__,?##__VA_ARGS__);\
????}\
}while(0)
?
/*?調(diào)試(Debug)?*/
#define?LOG_D(args,...)\
do{\
????if?(ELOG_OUTPUT_LVL?>=?ELOG_LVL_DEBUG)\
????{\
????????printf("[D/%s?Line:%.4d]?"?args?"\n",?__FILE__,?__LINE__,?##__VA_ARGS__);\
????}\
}while(0)
?
/*?詳細(Verbose)?*/
#define?LOG_V(args,...)\
do{\
????if?(ELOG_OUTPUT_LVL?>=?ELOG_LVL_VERBOSE)\
????{\
????????printf("[V/%s?Line:%.4d]?"?args?"\n",?__FILE__,?__LINE__,?##__VA_ARGS__);\
????}\
}while(0)
#ifdef?__cplusplus
}
#endif
#endif?/*?__MYLOG_H__?*/
編譯、運行：
以上就是本次的筆記分享，如有錯誤，歡迎指出，感謝閱讀！期待大家的轉(zhuǎn)發(fā)，大家的轉(zhuǎn)發(fā)也是我持續(xù)更新的動力。
猜你喜歡
OpenBLT Bootloader的使用分享
C語言對象編程第一彈：封裝與抽象
免責(zé)聲明：本文內(nèi)容由21ic獲得授權(quán)后發(fā)布，版權(quán)歸原作者所有，本平臺僅提供信息存儲服務(wù)。文章僅代表作者個人觀點，不代表本平臺立場，如有問題，請聯(lián)系我們，謝謝！
下載文檔
