2024年最新嵌入式设备系统日志记录及调试技巧_嵌入式日志系统(1)，面试要掌握这几个关键点

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上物联网嵌入式知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、电子书籍、讲解视频，并且后续会持续更新

如果你需要这些资料，可以戳这里获取

*return: 输出字符的ASCII码
******************************************************/
int fputc(int ch, FILE *f)
{
while(USART_GetFlagStatus(USART1, USART_FLAG_TC) == RESET); //等待上次发送结束
USART_SendData(USART1, (unsigned char)ch); //发送数据到串口
return ch;
}

贴上上面的代码,再另外初始化串口，就可以实现printf打印日志信息了，但日志信息讲究日志层级分层，一股脑信息太多杂乱。优化下然后就有了以下代码


### 串口日志层级分层

#ifdef ENBALE_DEBUG
#define DBG_ERROR(fmt,args…) printf(“[%s,%s,%d] ERROR:”#fmt"\r\n", __FILE__,__FUNCTION__,__LINE__,##args)
#define DBG_WARN(fmt,args…) printf(“[%s,%s,%d] WARN:”#fmt"\r\n", __FILE__,__FUNCTION__,__LINE__,##args)
#define DBG_DEBUG(fmt,args…) printf(“[%s,%s,%d] DEBUG:”#fmt"\r\n", __FILE__,__FUNCTION__,__LINE__,##args)
#elif ENBALE_WARN
#define DBG_ERROR(fmt,args…) printf(“[%s,%s,%d] ERROR:”#fmt"\r\n", __FILE__,__FUNCTION__,__LINE__,##args)
#define DBG_WARN(fmt,args…) printf(“[%s,%s,%d] WARN:”#fmt"\r\n", __FILE__,__FUNCTION__,__LINE__,##args)
#define DBG_DEBUG(fmt,args…)
#elif ENBALE_ERROR
#define DBG_ERROR(fmt,args…) printf(“[%s,%s,%d] ERROR:”#fmt"\r\n", __FILE__,__FUNCTION__,__LINE__,##args)
#define DBG_WARN(fmt,args…)
#define DBG_DEBUG(fmt,args…)
#else
#define DBG_ERROR(fmt,args…)
#define DBG_WARN(fmt,args…)
#define DBG_DEBUG(fmt,args…)
#endif

这个也是之前用的比较多的，以上代码是模仿linux 内核的写法，可以比较好的做到日志信息分层，编译时相加对应的编译开关即可。另外如果嵌入式设备有可靠的时钟，可以加上日志信息时间。  
 但有个弊端就是，切换debug等级时，需要重新编译且需更新固件，而嵌入式设备出现异常后更新固件往往复位后，故障有时很难复现，调试起来比较浪费时间。


### 优化后的带信息分层的串口日志


需要不通过更新新固件切换debug等级，那只能放弃debug宏,自行实现log函数。也就是如下内容，也是本人正在用的。

#include <stdarg.h>
#include <stdio.h>
const unsigned short debugLevel __attribute__((section(“ConfigSector”))) = 0; //指定到配置扇区
enum LogLevel
{
ERROR_FILTER = 1,
WARN_FILTER = 2,
DEBUG_FILTER = 3,
};

#define OUPUT_ERROR (debugLevel>= ERROR_FILTER)
#define OUPUT_WARN (debugLevel>= WARN_FILTER)
#define OUPUT_DEBUG (debugLevel>= DEBUG_FILTER)
//strrchr(__FILE__, ‘\’)去除目录路径，只保留文件
#define DBG_ERROR(fmt,args…) error_core(strrchr(__FILE__, ‘\’),__FUNCTION__,__LINE__,fmt,##args)
#define DBG_WARN(fmt,args…) warn_core(strrchr(__FILE__, ‘\’),__FUNCTION__,__LINE__,fmt,##args)
#define DBG_DEBUG(fmt,args…) debug_core(strrchr(__FILE__, ‘\’),__FUNCTION__,__LINE__,fmt,##args)

void change_debug_level(enum LogLevel level)
{
unsigned short temp = level; //枚举sizeof会按子值优化
FLASH_Write(&temp,&debugLevel ,1); //flash写入一个半字两字节至debuglevel的位置
}

void error_core(const char* filename,const char* func, int line,const char* fmt, …)
{
if(OUPUT_ERROR)
{
va_list valist;/*可变参数的宏*/
printf(“[%s,%s,%d] ERROR:”,filename,func,line);
va_start(valist,fmt);
vprintf(fmt,valist);
va_end(valist);
printf(“\r\n”);
}
}

void debug_core(const char* filename,const char* func, int line,const char* fmt, …)
{
if(OUPUT_DEBUG)
{
va_list valist;/*可变参数的宏*/
printf(“[%s,%s,%d] DEBUG:”,filename,func,line);
va_start(valist,fmt);
vprintf(fmt,valist);
va_end(valist);
printf(“\r\n”);
}
}

void warn_core(const char* filename,const char* func, int line,const char* fmt, …)
{
if(OUPUT_WARN)
{
va_list valist;
printf(“[%s,%s,%d] WARN:”,filename,func,line);
va_start(valist,fmt);
vprintf(fmt,valist);
va_end(valist);
printf(“\r\n”);
}
}

通过flash存储调试等级，即可在程序运行中修改等级，同时通过封装printf函数实现日志记录。


这里面我使用的芯片为哈弗体系，全局常量存储编译器默认分配在flash，需要注意如果使用片内flash时，注意存储调试等级的flash块不要与代码区重合，要不然修改调试等级擦除flash块同时PC指针指向当前块的代码区，会导致仪器死机；


在项目中我通过[散列加载]( )指定一个扇区，专门存储一些配置数据。

Config_ROM2 0x08010800 FIXED 0x0000800 { ;指定根区，即load address = execution address，
.ANY (ConfigSector)
}

> 
> const unsigned short debugLevel **attribute**((section(“ConfigSector”))) = 0; //指定到配置扇区
> 
> 
> 


## 日志文件存储


串口只能做实时信息输出，所以只用调试阶段比较适用，查阅历史日志排查故障还是得通过日志文件来管理。  
 一般嵌入式设备日志管理都是fatfs，fatfs移植啥的就不多说。


基本代码逻辑是没有什么变化，将以上串口日志输出改为文件输出，文件管理的话最好加上rtc模块好做文件切分管理。

#include <stdarg.h>
#include <stdio.h>
const unsigned short debugLevel __attribute__((section(“ConfigSector”))) = 0; //指定到配置扇区
enum LogLevel
{
ERROR_FILTER = 1,
WARN_FILTER = 2,
DEBUG_FILTER = 3,
};
u8 outputFile[30];
#define OUPUT_ERROR (debugLevel>= ERROR_FILTER)
#define OUPUT_WARN (debugLevel>= WARN_FILTER)
#define OUPUT_DEBUG (debugLevel>= DEBUG_FILTER)

void change_debug_level(enum LogLevel level)
{
unsigned short temp = level; //枚举sizeof会按子值优化
FLASH_Write(&temp,&debugLevel ,1); //flash写入一个半字两字节至debuglevel的位置
}

void error_core(const char* filename,const char* func, int line,const char* fmt, va_list valist)
{
if(OUPUT_ERROR)
{
FIL fsrc;
time_t time =rtc_get_time(); //按自己的系统获取时间
sprintf(&outputFile[0], “0:/log_%04d-%02d-%02d.txt”,
time.Year, time.Month, time.Day);
if(f_open( &fsrc , outputFile,FA_READ|FA_WRITE|FA_OPEN_APPEND) == FR_OK )
{
f_printf(&fsrc,“[%04d-%02d-%02d %02d:%02d:%02d] [%s,%s,%d] ERROR:”,time.Year, time.Month, time.Day,time.Hour, time.Minute, time.Second,filename,func,line);
f_vprintf(&fsrc,fmt,valist);//需要自己实现
f_printf(&fsrc,“\r\n”);
f_close(&fsrc);
}
}
}

void debug_core(const char* filename,const char* func, int line,const char* fmt, va_list valist)
{
if(OUPUT_DEBUG)
{
FIL fsrc;
time_t time =rtc_get_time(); //按自己的系统获取时间
sprintf(&outputFile[0], “0:/log_%04d-%02d-%02d.txt”,
time.Year, time.Month, time.Day);
if(f_open( &fsrc , outputFile,FA_READ|FA_WRITE|FA_OPEN_APPEND) == FR_OK )
{
f_printf(&fsrc,“[%04d-%02d-%02d %02d:%02d:%02d] [%s,%s,%d] DEBUG:”, time.Year, time.Month, time.Day,time.Hour, time.Minute, time.Second,filename,func,line);
f_vprintf(&fsrc,fmt,valist);//需要自己实现
f_printf(&fsrc,“\r\n”);
f_close(&fsrc);
}
}
}

void warn_core(const char* filename,const char* func, int line,const char* fmt, va_list valist)
{
if(OUPUT_WARN)
{
FIL fsrc;
time_t time =rtc_get_time(); //按自己的系统获取时间
sprintf(&outputFile[0], “0:/log_%04d-%02d-%02d.txt”,
time.Year, time.Month, time.Day);
if(f_open( &fsrc , outputFile,FA_READ|FA_WRITE|FA_OPEN_APPEND) == FR_OK )
{
f_printf(&fsrc,“[%04d-%02d-%02d %02d:%02d:%02d] [%s,%s,%d] WARN:”, time.Year, time.Month, time.Day,time.Hour, time.Minute, time.Second,filename,func,line);
f_vprintf(&fsrc,fmt,valist);//需要自己实现
f_printf(&fsrc,“\r\n”);
f_close(&fsrc);
}
}
}

f\_vprintf需要自己实现，将f\_printf变参改为va\_list类型即可。

/*-----------------------------------------------------------------------*/
/* Put a Formatted String to the File */
/*-----------------------------------------------------------------------*/

int f_vprintf (
FIL* fp, /* Pointer to the file object */
const TCHAR* fmt, /* Pointer to the format string */
va_list arp /* Optional arguments… */
)
{

putbuff pb;
BYTE f, r;
UINT i, j, w;
DWORD v;
TCHAR c, d, str[32], \*p;


putc\_init(&pb, fp);

for (;;) {
	c = \*fmt++;
	if (c == 0) break;			/\* End of string \*/
	if (c != '%') {				/\* Non escape character \*/
		putc\_bfd(&pb, c);
		continue;
	}
	w = f = 0;
	c = \*fmt++;
	if (c == '0') {				/\* Flag: '0' padding \*/
		f = 1; c = \*fmt++;

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上物联网嵌入式知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、电子书籍、讲解视频，并且后续会持续更新

如果你需要这些资料，可以戳这里获取

.(img-vhrg4qji-1715645554265)]
[外链图片转存中…(img-yyHRDu2j-1715645554266)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上物联网嵌入式知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、电子书籍、讲解视频，并且后续会持续更新

如果你需要这些资料，可以戳这里获取