单片机如何实现日志等级打印（适用于多线程，多串口）

最新推荐文章于 2024-11-21 10:15:51 发布
最新推荐文章于 2024-11-21 10:15:51 发布
阅读量969 收藏 13
点赞数 2
CC 4.0 BY-SA版权
分类专栏： MCU裸机教程 文章标签： 单片机 数据库 嵌入式硬件
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_63922192/article/details/134692410
本文介绍了如何在C语言中利用`__VA_ARGS__`宏实现不同等级的日志打印，从ESP32的ESP_LOGx()扩展到单线程和多线程环境下的日志控制，包括使用互斥锁保证线程安全。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

前言

（1）如果有嵌入式企业需要招聘湖南区域日常实习生，任何区域的暑假Linux驱动实习岗位，可C站直接私聊，或者邮件：zhangyixu02@gmail.com，此消息至2025年1月1日前均有效
（2）如果玩过ESP32的同学，会发现，他们的存在日志打印的内容，可以实现不同等级的日志信息打印，如果我们也想要在其他MCU上实现这一功能，应当如何处理呢？
（3）学习本文之前，建议先学习一下：ESP32S3的ESP_LOGx()控制台输出详细介绍

理论

“__ VA_ARGS __”宏介绍

（1）首先，在了解单片机如何实现日志等级打印之前，我们需要了解## __VA_ARGS__这个宏知识。
（2）在C语言中，很多特殊宏， __VA_ARGS__属于其中之一，它用于表示宏中的可变参数部分。在定义带有可变参数的宏时，可以使用__VA_ARGS__来表示在宏中传递的可变参数列表。
（3）例如下面这个例子中，我想对printf()函数进行宏定义，可以这么做。

#include <stdio.h>

// 简单的可变参数宏，将可变参数打印到控制台
#define PRINT_VARIABLE_ARGS(format, ...)  printf(format, __VA_ARGS__)

int main()
{
    // 使用宏打印不定数量的参数
    PRINT_VARIABLE_ARGS("Hello, %s! The sum is: %d\n", "John", 10+20);

    return 0;
}

“##”作用

（1）不知道各位看到上面的代码，有没有发现一些问题。对于printf()函数，我们可以只输出一个字符串，也就是只传入一个参数。
（2）我们于是尝试只传入一个参数试试，会发现存在报错。为什么呢？我们看看他预处理之后的结果就了解问题所在了，我们看到，预处理之后还有一个逗号，这明显是不符合C语言规范的。

#include <stdio.h>

// 简单的可变参数宏，将可变参数打印到控制台
#define PRINT_VARIABLE_ARGS(format, ...)  printf(format, __VA_ARGS__)

int main()
{
    // 使用宏打印不定数量的参数
    PRINT_VARIABLE_ARGS("Hello");
	//预处理之后  printf("Hello", );
    return 0;
}

（3）为了解决上面的问题，C语言又提供了一种处理办法，“##”。如果可变参数被忽略或为空，’##’操作将使预处理器(preprocessor)去除掉它前面的那个逗号。
（4）因此，我们按照如下方式编写即可。

#include <stdio.h>

// 简单的可变参数宏，将可变参数打印到控制台
#define PRINT_VARIABLE_ARGS(format, ...)  printf(format, ##__VA_ARGS__)

int main()
{
    // 使用宏打印不定数量的参数
    PRINT_VARIABLE_ARGS("Hello");
	//预处理之后  printf("Hello");
    return 0;
}

实操

单线程裸机程序实现

（1）了解了上面的知识之后，我们就可以开始实操了。这里我们将模拟ESP32的函数打印函数实现。
（2）Set_Log_Level用于设置日志等级的，Verbose输出信息最多，Error输出信息最少，NO_output不进行日志打印。

#include <stdio.h>

#define NO_output  0
#define Error      1
#define Warning    2
#define Info       3
#define Debug      4
#define Verbose    5

#define Set_Log_Level Info //设置日志输出等级

#if Set_Log_Level >= Verbose
#define ESP_LOGV(format, ...)  printf("Verbose:"format, ##__VA_ARGS__)
#else
#define ESP_LOGV(format, ...)
#endif /*<Set_Log_Level >= Verbose */

#if Set_Log_Level >= Debug
#define ESP_LOGD(format, ...)  printf("Debug:"format, ##__VA_ARGS__)
#else
#define ESP_LOGD(format, ...)
#endif /*<Set_Log_Level >= Debug */

#if Set_Log_Level >= Info
#define ESP_LOGI(format, ...)  printf("Info:"format, ##__VA_ARGS__)
#else
#define ESP_LOGI(format, ...)
#endif /*<Set_LOG_Level >= Info */

#if Set_Log_Level >= Warning
#define ESP_LOGW(format, ...)  printf("Warning:"format, ##__VA_ARGS__)
#else
#define ESP_LOGW(format, ...)
#endif /*<Set_Log_Level >= Warning */

#if Set_Log_Level >= Error
#define ESP_LOGE(format, ...)  printf("Error:"format, ##__VA_ARGS__)
#else
#define ESP_LOGE(format, ...)
#endif /*<Set_Log_Level >= Error */


int main() 
{
    // 使用宏打印不定数量的参数
    ESP_LOGE("Hello, %s! The sum is: %d\n", "John", 10+20);
    ESP_LOGW("Hello, %s! The sum is: %d\n", "John", 10+20);
    ESP_LOGI("Hello, %s! The sum is: %d\n", "John", 10+20);
    ESP_LOGD("Hello, %s! The sum is: %d\n", "John", 10+20);
    ESP_LOGV("Hello, %s! The sum is: %d\n", "John", 10+20);
    return 0;
}

多串口实现日志打印

（1）此部分详细信息请看C站：如何编写一个可变参数函数？如何让所有单片机的所有串口实现printf函数？
（2）这里的Set_Log_Level用于设置日志等级，Set_Log_Uartx 用于设置多串口日志打印的地址信息。

#include <stdio.h>

#define NO_output  0
#define Error      1
#define Warning    2
#define Info       3
#define Debug      4
#define Verbose    5

#define Set_Log_Level Info  //设置日志输出等级

#define Set_Log_Uart0 UART0 //设置串口地址
#define Set_Log_Uart1 UART1
#define Set_Log_Uart2 UART2
/* 作用 ： 用于多路串口重定义
 * 传入参数 ： 
     baseAddress ： 要打印的串口地址，UARTx_BASE，x可为0，1，2，3，4，5，6，7
     format ： 需要打印的东西
     ... ： 如果是打印字符，输入%c。有符号数字，%d。用法与printf一样
 * 返回值 ： 无
*/
void Uart_Printf(uint32_t baseAddress, const char *format,...)
{
    uint32_t length;
    va_list args;
    uint32_t i;
    char TxBuffer[128] = {0};

    va_start(args, format);
    length = vsnprintf((char*)TxBuffer, sizeof(TxBuffer), (char*)format, args);
    va_end(args);

    for(i = 0; i < length; i++)
	{
		//根据不同单片机的串口发送函数，依次发送TxBuffer[i]数据。
		//以下以MSP430为例
		USCI_A_UART_transmitData(baseAddress, TxBuffer[i]);
		//以下以TM4C123为例
		while(UARTBusy(baseAddress));
		UARTCharPut(baseAddress,TxBuffer[i]);
		//以下以STM32F103为例
		USART_SendByte(baseAddress,TxBuffer[i]);
		while(USART_GetFlagStatus(baseAddress,USART_FLAG_TC) == RESET);
	}
}

#if Set_Log_Level >= Verbose
#define Uart0_LOGV(format, ...)  printf(Set_Log_Uart0,"Verbose:"format, ##__VA_ARGS__)
#define Uart1_LOGV(format, ...)  printf(Set_Log_Uart1,"Verbose:"format, ##__VA_ARGS__)
#define Uart2_LOGV(format, ...)  printf(Set_Log_Uart2,"Verbose:"format, ##__VA_ARGS__)
#else
#define Uart0_LOGV(format, ...)
#define Uart1_LOGV(format, ...)
#define Uart2_LOGV(format, ...)
#endif /*<Set_Log_Level >= Verbose */

/*
 * 下面的就大家自己仿照者写吧
 */

多线程多串口实现日志打印

（1）在多线程的任务处理中，使用printf()函数可能就会需要考虑到线程安全的问题。printf() 在多线程环境下不是线程安全的主要原因是它可能涉及到底层的文件流（stdout），而这些文件流的操作不是原子的。多个线程同时调用 printf()时，可能会导致输出的混乱或错误，因为一个线程的输出可能会与另一个线程的输出交错。
（2）为了避免上述问题，我们可以使用互斥锁进行保护。下面以FreeRTOS为例子。

#include <stdio.h>
#include "FreeRTOS.h"
#include "task.h"
#include "semphr.h"

#define NO_output  0
#define Error      1
#define Warning    2
#define Info       3
#define Debug      4
#define Verbose    5

#define Set_Log_Level Info  //设置日志输出等级

#define Set_Log_Uart0 UART0 //设置串口地址
#define Set_Log_Uart1 UART1
#define Set_Log_Uart2 UART2

SemaphoreHandle_t mutex;
void Thread_Safe_Printf(uint32_t baseAddress, const char *format,...)
{
    uint32_t length;
    va_list args;
    uint32_t i;
    char TxBuffer[128] = {0};
	// 获取互斥锁
	if (xSemaphoreTake(mutex, portMAX_DELAY)) 
	{
		va_start(args, format);
	    length = vsnprintf((char*)TxBuffer, sizeof(TxBuffer), (char*)format, args);
	    va_end(args);
	
	    for(i = 0; i < length; i++)
		{
			//根据不同单片机的串口发送函数，依次发送TxBuffer[i]数据。
			//以下以MSP430为例
			USCI_A_UART_transmitData(baseAddress, TxBuffer[i]);
			//以下以TM4C123为例
			while(UARTBusy(baseAddress));
			UARTCharPut(baseAddress,TxBuffer[i]);
			//以下以STM32F103为例
			USART_SendByte(baseAddress,TxBuffer[i]);
			while(USART_GetFlagStatus(baseAddress,USART_FLAG_TC) == RESET);
		}
		// 释放互斥锁
		xSemaphoreGive(mutex);
	}
}

#if Set_Log_Level >= Verbose
#define Uart0_LOGV(format, ...)  Thread_Safe_Printf(Set_Log_Uart0,"Verbose:"format, ##__VA_ARGS__)
#define Uart1_LOGV(format, ...)  Thread_Safe_Printf(Set_Log_Uart1,"Verbose:"format, ##__VA_ARGS__)
#define Uart2_LOGV(format, ...)  Thread_Safe_Printf(Set_Log_Uart2,"Verbose:"format, ##__VA_ARGS__)
#else
#define Uart0_LOGV(format, ...)
#define Uart1_LOGV(format, ...)
#define Uart2_LOGV(format, ...)
#endif /*<Set_Log_Level >= Verbose */

/*
 * 下面的就大家自己仿照者写吧
 */

参考

（1）C站：ESP32S3的ESP_LOGx()控制台输出详细介绍
（2）C站：如何编写一个可变参数函数？如何让所有单片机的所有串口实现printf函数？
（3）C站：整理：C/C++可变参数，“## VA_ARGS”宏的介绍和使用
（4）C站：C语言中"#“和”##"的用法

使用单片机实现内核日志的应用程序打印
qq_37934722的博客
07-22 237
通过串口通信，将内核日志打印到计算机上，方便进行调试和排错。需要注意的是，不同的单片机和开发板可能会有所不同，需要根据实际情况进行配置和修改。在计算机上使用超级终端或其他串口终端工具，将串口转USB模块连接至计算机，并设置正确的波特率、数据位、停止位和校验位等参数。然后，在串口终端工具的窗口中，即可看到打印在单片机上的内核日志信息。本文将介绍如何使用单片机实现内核日志的应用程序打印。以下是一个简单的示例代码，用于在单片机上打印内核日志。该示例代码使用了串口通信，并将内核日志打印到计算机上。
【C/C++开源库】单片机/嵌入式中的C语言日志库
qq_41854911的博客
03-05 7114
日志系统在系统开发和调整过程中的重要性，大家应该都清楚，特别是项目出问题之后，却没有日志可以帮忙定位问题，就非常令人痛苦。 因为我们不可能一直通过调试器去单步调试程序，所以设备的运行日志显得尤为重要。 通常我们对日志有这些要求： 不同的日志级别（Debug,Warning, Info, Error, Fatal）； 日志打印要和printf一样简单易用； 能够设置日志级别； 占用空间小； 可配置，甚至可以禁用日志； 基于不同日志级别，支持颜色高亮； 可以自定义配置，时间戳； 支持RTOS； 以上是比较基
分享一个适合单片机的轻量级日志库
strongerHuang
09-06 635
关注+星标公众号，不错过精彩内容来源| Github编排 | strongerHuang单片机项目在很多时候都需要调试，通过日志诊断bug是常见的一种调试方法。下面就给大家分享一个开源的适合单片机的轻量级日志库，只有log.c 和 log.h 两个文件，使用非常方便。用法这个日志库的使用比较简单，新手完全可以胜任。1、概述在你的项目中添加log.c 和 log.h 文件。提供 6 用于日志记录...
以STM32为例讲解如何在单片机中实现类似 Linux `debug` 的日志打印功能
最新发布
weixin_42300449的博客
11-21 462
通过上述方法，你可以在单片机中实现一个类似 Linuxdebug的日志打印功能。这种方法不仅方便调试，还可以在发布阶段通过条件编译控制日志的输出，提高系统的性能和稳定性。
单片机日志打印宏_好用！（带颜色）
qq_44857505的博客
09-22 400
嵌入式日志打印宏(带颜色)
单片机 彩色终端日志打印显示
IT嵌入式小生
02-16 695
自己整理的一个颜色打印，按需所取 包括基本的日期 函数文件 文件名字 行数的打印
单片机日志库.rar
10-10
单片机开发，专用日志库，可在stm32上使用，方便移植，功能齐全
【高级技巧揭秘】：STC8H8K64U串口通信在多线程环境下的数据处理
![嵌入式串口通信基于芯片STC8H8K64U串口通信入门003(一)]...掌握该单片机的基本通信方式，特别是串口通信，对进行高效、稳定的硬件设计至关
单片机多任务编程：抢占式与协作式任务管理的最佳实践
本文首先概述了单片机多任务编程的基本概念，随后详细探讨了抢占式和协作式任务管理的理论与实践，分析了各自的优势、局限性和适用场景。文中通过案例研究，解析了实现高效多任务编程的关键代码，并探讨了性能优化与...
C语言在单片机多协议通信中的挑战与应用揭秘
![C语言在单片机多协议通信中的挑战与应用揭秘]...随着技术的发展，单片机越来越多地应用于多协议通信场合，而C语言在这个领域仍然扮演着至关重要的角色。 ##
DMX512单片机多任务编程：任务调度与资源管理实战
本文深入探讨了DMX512单片机在多任务编程环境下的任务调度与资源管理问题。首先，概述了多任务编程的理论基础及其在DMX512单片机中的应用。随后，详细分析了任务调度的基本原理、常用算法及在实时操作系统中的策略。...
【单片机开发必备】：stc15w4k56s4单片机USB通信故障全攻略
![成都仪器开发：stc15w4k56s4单片机用USB串口线下载程序不成功一直提示正在检测目标单片机的一个原因和解决]...# 1. STC15W4K56S4单片机概述 ## 单片机的发展历程 自1970年代初单片机诞生以来，其技术不断进步，应用...
单片机学习日志
qq_41219040的博客
02-22 296
2019.2.21 1.遗留问题：DS1302时钟模块 利用独立按键控制小时和分钟的加减，但是会出现加减分钟时 小时会随机变化 且有时秒会变化到超过60 使得程序卡死 2.读写数据是要关闭定时器 防止时序混乱 write_adc(0x01); while(1) { EA = 0; adc_val=read_adc(0x01); EA = 1; 。。。。。。 } 3.定时器里不应有太多程序 可将其中...
单片机学习日志—2018.07.20
qq_40616514的博客
07-21 217
学习日志                     姓名：   王瑶           日期： 2017.07.20     今日学习任务 回忆了上周学习的知识。   今日任务完成情况 （详细说明本日任务是否按计划完成，开发的代码量。）   对单片机LED灯、数码管、矩阵按键、独立按键、以及中断、定时...
设计单片机日志系统
jdh99的专栏
09-13 7615
设计单片机日志系统本文博客链接:http://blog.csdn.net/jdh99,作者:jdh,转载请注明. 环境：主机:WIN10开发环境:MDK5.12MCU:STM32F407说明：为单片机设计了一套简单的日志系统，通过日志系统提供的接口可以查看设备状态，并进行一些基本的调试。日志系统通过串口输出，所以单片机需要准备一个串口供日志系统使用。注意串口发送不能用DMA发送（避免在在中断中打印
预处理器进行调试
angtuanv07384的博客
01-04 131
先介绍几个编译器内置的宏定义，这些宏定义不仅可以帮助我们完成跨平台的源码编写，灵活使用也可以巧妙地帮我们输出非常有用的调试信息。 ANSI C标准中有几个标准预定义宏（也是常用的）： __LINE__：在源代码中插入当前源代码行号； __FILE__：在源文件中插入当前源文件名； __DATE__：在源文件中插入当前的编译日期 __TIME__：在源文件中插入当前编译时间； ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

风正豪

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值