中颖51芯片学习7. printf重定向到串口与自定义日志输出函数

已于 2024-04-23 08:05:53 修改
阅读量1.7k 收藏 32
点赞数 26
分类专栏： # 51单片机 文章标签： 学习 单片机 嵌入式硬件
于 2024-04-20 20:24:05 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/xundh/article/details/137997471
版权

中颖51芯片学习7. printf重定向到串口与自定义日志输出函数

在这里插入图片描述

一、 printf 重定向

1. 概念

printf重定向是指将标准输出函数printf()的输出流重定向到用户定义的其他输出设备或存储介质，而不是默认的标准输出设备（通常是终端或控制台）。这样做可以将printf()函数输出的内容发送到不同的设备，比如串口、文件、LCD屏幕等，从而实现更灵活的输出方式。

2. 实现方式

通过重写putchar函数可以简单地实现printf重定向 。 下面是一个示例：

/**
* @brief printf 重定向
* @param c
*/
void putchar(char c){
    SBUF = c;
    while(!TI);
    TI = 0;
}

调用方法：
main.c

#include "SH79F9476.h"
#include "clk_utils.h"
#include "cpu.h"
#include "euart_utils.h"
#include "common_utils.h"
#include <stdio.h>


void main() {
		char index=0x31;
    // 选择高速时钟
    highFrequenceClk();

	
    // 初始化串口
    Uart0_Init();


    while (1) {
        printf("char(%bd) = %c \n",index, index);
				index++;
				if(index>0x7d)index=0x31;
			
        // 暂停
        delay_ms(500);
    }
}

示例会通过uart0串口输出ascii码。
在这里插入图片描述

3. C51 中printf数值格式化

标准的C语言格式化字符格式如下：

符号作用
%d十进制有符号整数
%u十进制无符号整数
%f浮点数
%s字符串
%c单个字符
%p指针的值
%e指数形式的浮点数
%x, %X无符号以十六进制表示的整数
%0无符号以八进制表示的整数
%g自动选择合适的表示法

数值的输出是%d，如：

printf("My age is %d", age);

但是在C51中，对于单字节变量的格式化输出，需要在%d中加入字母，规则如下：

  • 8位数据格式加字母"b"，如 %bd， %bu
  • 16位数据格式加字母"h", 如 %hd
  • 32位数据格式加字母"l"，如%ld

上例中的程序：

printf("char(%bd) = %c \n",index, index);

%bd 就是输出 8位数据。

二、日志函数

1. 实现方案分析

上面实现的printf函数，只适合一些比较小的应用场合，比如控制几个灯、开关之类，其原因是：

虽然可以方便地将日志重定向到串口，但是putchar中的WHILE(!TI);会阻塞程序执行。在一些商用场合，MCU的资源、时序都不允许让MCU停止下来等待日志输出。

由于putchar是个单字符发送，重写putchar已经没办法实现中断发送的效果。

为了重定向日志，一种可能的方式是对printf函数进行重写。但printf 使用的是可变长度参数函数，很可惜C51不支持可变数量函数参数的功能，C51的宏也不支持传递可变数量参数，使得重写printf难以实现。如果非要实现，可能要换其它编译器把函数编译成库供C51来调用，我个人觉得过于复杂，所以不再走这条路线。

最终决定的方式是自定义日志函数，使用两层宏参数来实现可长度参数的功能。

2. 代码

（1）log_utils.h

#ifndef __LOG_UTILS_H__
#define __LOG_UTILS_H__
#include "euart_utils.h"
#include <stdio.h>

// 发送缓冲区
extern U8 gUart0DataTxD[UART0_DATA_BUF_SIZE];
#define TAG gUart0DataTxD+log_len
/**
 * INFO 级别日志
 */
#define LOGI(args) \
    do {           \
        U8 log_len;  \
        log_len = sprintf(gUart0DataTxD, "[I] %s:%bd: ", __FILE__, __LINE__); \
        log_len += sprintf args;           \
        log_len += sprintf(gUart0DataTxD + log_len, "\n"); \
        Uart0_Transmit(log_len); \
    } while (0)


/**
 * ERROR 级别日志
 */
#define LOGE(args) \
    do {           \
        U8 log_len;  \
        log_len = sprintf(gUart0DataTxD, "[E] %s:%bd: ", __FILE__, __LINE__); \
        log_len += sprintf args;           \
        log_len += sprintf(gUart0DataTxD + log_len, "\n"); \
        Uart0_Transmit(log_len); \
    } while (0)


#endif

（2）main.c

#include "SH79F9476.h"
#include "clk_utils.h"
#include "cpu.h"
#include "common_utils.h"
#include "isr_utils.h"
#include "log_utils.h"
#include <stdio.h>

// 发送缓冲区
void main() {
    char index = 0x31;
    // 选择高速时钟
    highFrequenceClk();

    enableAllIsr();
    // 初始化串口
    Uart0_Init();

    while (1) {
        LOGI((TAG, "char(%bd) = %c",index, index));

        index++;
        if (index > 0x7d)index = 0x31;

        // 暂停
        delay_ms(10);
    }
}

3. 通过预定义宏实现日志分级输出

下面实现了两个级别的日志等级 ：

（1）log_utils.h

#ifndef __LOG_UTILS_H__
#define __LOG_UTILS_H__
#include "euart_utils.h"
#include <stdio.h>

// 发送缓冲区
extern U8 gUart0DataTxD[UART0_DATA_BUF_SIZE];
#define TAG gUart0DataTxD+log_len

// 日志等级
#define LOG_LEVEL_NONE 0
#define LOG_LEVEL_ERROR 1
#define LOG_LEVEL_INFO 2

// 判断预定义的宏 LOG_LEVEL

#if LOG_LEVEL >= LOG_LEVEL_INFO
/**
 * INFO 级别日志
 */
#define LOGI(args) \
    do {           \
        U8 log_len;  \
        log_len = sprintf(gUart0DataTxD, "[I] %s:%bd: ", __FILE__, __LINE__); \
        log_len += sprintf args;           \
        log_len += sprintf(gUart0DataTxD + log_len, "\n"); \
        Uart0_Transmit(log_len); \
    } while (0)
#else
#define LOGI(args) (void)0
#endif

#if LOG_LEVEL >= LOG_LEVEL_ERROR
/**
 * ERROR 级别日志
 */
#define LOGE(args) \
    do {           \
        U8 log_len;  \
        log_len = sprintf(gUart0DataTxD, "[E] %s:%bd: ", __FILE__, __LINE__); \
        log_len += sprintf args;           \
        log_len += sprintf(gUart0DataTxD + log_len, "\n"); \
        Uart0_Transmit(log_len); \
    } while (0)
#else
#define LOGE(args) (void)0
#endif

#endif

当在 Options 里设置 LOG_LEVEL=LOG_LEVEL_ERROR 时，INFO级别的日志将不会再输出 ：
在这里插入图片描述

（2）main.c

#include "SH79F9476.h"
#include "clk_utils.h"
#include "cpu.h"
#include "common_utils.h"
#include "isr_utils.h"
#include "log_utils.h"
#include <stdio.h>

// 发送缓冲区
void main() {
    char index = 0x31;
    // 选择高速时钟
    highFrequenceClk();

    enableAllIsr();
    // 初始化串口
    Uart0_Init();

    while (1) {
        LOGI((TAG, "info(%bd) = %c",index, index));
        delay_ms(100);
        LOGE((TAG, "err(%bd) = %c",index, index));

        index++;
        if (index > 0x7d)index = 0x31;

        // 暂停
        delay_ms(100);
    }
}

（3）运行效果

在这里插入图片描述

三、运行速度问题

由于串口输出一般较慢，在循环中快速输出日志时，会出现这样情况 ： 前面的日志尚未通过串口输出结束、后面的日志又开始调用串口发送函数。

为了最大化利用起串口资源，可将缓冲区做成环形队列，后面要输出的内容直接放入缓冲区，这样可以动态调整缓冲区的大小，以适应快速调用的情况。

但仍需注意的是，单片机的资源有限，缓冲区大小不是可以随心所欲扩大的，另一方面串口速率也限制了发送速度的上限，调用日志的程序还是需要量力而行，避免过于快速输出。

另外，单片机运行在循环执行的程序中，经常有连续输出同样日志的情况，在调用时可以加些限制，防止重复输出相同数据。
下面是输出异常的情况示例：
在这里插入图片描述
下面是改写的程序，使用了环形队列，另外提高了波特率：

1. euart_utils.c

#include "intrins.h"
#include "euart_utils.h"
#include "api_ext.h"
#include "SH79F9476.h"
#include "cpu.h"
#include <stdio.h>
#include "string.h"

// 发送缓冲区
static U8 gUart0DataTxD[UART0_DATA_BUF_SIZE];
// 未发送数据长度
static U8 gUart0DataTxDLen;

// 内部变量，发送指针
static volatile U8 *ptr_tx0_head;

/**
* @brief 初始化串口
*/
void Uart0_Init() {
    //=====TX 建议配置为输出H====
    P3CR = 0x08;
    P3 = 0x08;
    // 配置Uart工作在模式1
    select_bank1();
    // 0110 0111 Tx:P3.3   Rx：P3.4
    UART0CR = 0x67;
    select_bank0();
    SCON = 0x50;
    /*配置波特率参数，波特率9600*/
    /* 计算公式：(int)X=FSY/(16*波特率) ;  SBRT=32768-X  ;   SFINE=（FSY/波特率）-16*X   FSY=8M*/
    // 波特率发生器高位
    SBRTH = 0xFF;
    // 波特率发生器低位
    SBRTL = 0xF3;
    // 波特率发生器微调
    SFINE = 0x0;
    // 使能串口中断
    IEN0 |= 0x10;
	
		ptr_tx0_head = &gUart0DataTxD[0];
}

/**
 * @brief 发送缓冲区数据
 */
void Uart0_Transmit(U8 len) {
		
			gUart0DataTxDLen = len;
			SBUF = *ptr_tx0_head;
			if (gUart0DataTxDLen > 0)
					gUart0DataTxDLen--;
			if (ptr_tx0_head >= &gUart0DataTxD[UART0_DATA_BUF_SIZE]) {
					ptr_tx0_head = &gUart0DataTxD[0];
			} else {
					ptr_tx0_head++;
			}
		
}
/**
 * @brief 向gUart0DataTxD尾部添加数组,注意要考虑到如果添加的过长，就回到队列头部添加剩余部分
 */
void Uart0_Append_Bytes(const char *bytes, U8 len) {
    U8 i  ,startIndex;
    // 如果添加的长度超过缓冲区长度，就只添加缓冲区长度的数据
    if (len > UART0_DATA_BUF_SIZE) {
        len = UART0_DATA_BUF_SIZE;
    }
    startIndex = ptr_tx0_head - &gUart0DataTxD[0] + gUart0DataTxDLen;
    for (i = 0; i < len; i++) {
        gUart0DataTxD[startIndex] = bytes[i];
        startIndex++;
        // 如果添加的数据长度超过了缓冲区长度，就回到队列头部添加剩余部分
        if (startIndex == UART0_DATA_BUF_SIZE) {
            startIndex = 0;
        }
    }
    Uart0_Transmit(gUart0DataTxDLen+len);
}
/**
* @brief UART0中断
**/
void INT_EUART0(void) interrupt 4{
    if(TI){
        TI = 0;
        if(gUart0DataTxDLen >0){
            SBUF = *ptr_tx0_head;
            gUart0DataTxDLen --;
            // 这里产生了一种情况，如果发送的数据长度超过了缓冲区长度，就会导致ptr_tx0指针超出范围
            if(ptr_tx0_head >= &gUart0DataTxD[UART0_DATA_BUF_SIZE]){
                ptr_tx0_head = &gUart0DataTxD[0];
            }else{
                ptr_tx0_head ++;
            }
        }
    }
}

2. main.c

#include "SH79F9476.h"
#include "clk_utils.h"
#include "common_utils.h"
#include "isr_utils.h"
#include "log_utils.h"

// 发送缓冲区
void main() {
    char index = 0x31;
    // 选择高速时钟
    highFrequenceClk();

    enableAllIsr();
    // 初始化串口
    Uart0_Init();

    while (1) {
        LOGI((TAG, "info(%bd) = %c",index, index));
        delay_ms(100);
    
        index++;
        if (index > 0x7d)index = 0x31;

        // 暂停
        delay_ms(20);
    }
}

在主循环20ms暂停情况下可以稳定输出日志：
在这里插入图片描述
本文代码开源地址:
https://gitee.com/xundh/learn-sinowealth-51

编程圈子
关注
专栏目录
Keil C51 的printf
weixin_34406796的博客
03-31 1241
在Keil C51 中使用printf ，首先需要重新实现 putchar(char c)函数。此函数在 char putchar (char c) { ES=0; SBUF = c; while(TI==0); TI=0; ES=1; ...
C51单片机 串口打印printf重定向
2301_77123899的博客
06-04 1143
【代码】C51 串口打印printf重定向。
51单片机printf重定向
Qrpucp的博客
04-26 5403
从keil的帮助文档里我们可以看到，printf是基于putchar实现的，所以我们只要重新实现putchar，就可以实现printf的重定向，即可以将printf用在其他串口上。 putchar的函数实现在…/C51/LIB下可以找到。 #include <reg51.h> #define XON 0x11 #define XOFF 0x13 /* * putchar (...
51单片机串口通信调试printf函数重定向输出打印
热门推荐
yangfeng20的博客
05-14 1万+
51单片机串口通信以及printf调试串行通信1.串口初始化串口工作方式波特率设置通过软件直接生成串口初始化代码2.输出到串口3.发送字符串到串口4.printf重定向到串口5.补充printf格式化输出 串行通信 不知道你们写单片机程序的时候有没有烦恼，它没有想c语言的dos窗口，没有java的运行窗口，没有python的控制台，有时候想输出一条调试信息却无法做到，下面通过简单的方法，将调试信息通过51单片机的串口输出到串口。 1.串口初始化 只介绍本案例中需要使用的一些知识，串口初始化主要是选择串口工作
51单片机（STC8）-- 串口配置及串口重定向（printf）
General_s
12-21 5886
STC8H系列单片机串口通信和串口重定向配置
[单片机]Printf重定向
MiKiJT的博客
07-23 409
mcu里Printf重定向的几种方式
ISP51_Win_V2.8.exe 中颖芯片的ISP下载工具
05-21
ISP51_Win_V2.8.exe 中颖芯片的ISP下载工具
51单片机实现scanf和printf
02-27
3. `printf`函数重定义：使用自定义的函数替换标准库的`printf`，将格式化的输出转化为UART可发送的字节序列。 4. 数据发送：将缓冲区中的数据通过UART发送出去。 通过这样的实现，51单片机可以在接收到输入数据后...
中颖309芯片的STM32驱动程序
05-30
总之，STM32驱动中颖309芯片的过程涉及到硬件接口的配置、通信协议的理解和软件代码的编写。通过深入学习和实践，开发者可以掌握这一技能，从而更高效地利用中颖309芯片在STM32平台上实现所需功能。
ISP51-Win-V2.9.exe 中颖芯片的ISP下载工具
08-22
ISP51_Win_V2.9.exe 中颖芯片的ISP下载工具 ISP51_Win_V2.9.exe 中颖芯片的ISP下载工具
printf重定向printf重定向printf重定向
01-19
重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊重定向啊啊
printf()函数重定向到STM32串口输出
08-03
最近遇到需要MCU输出数字的问题，而STM32的串口输出的是字符型，最先想到的方法是将整型数据转换为字符型输出，C库函数中提供了相关的函数 。
参考资料-中颖单片机入门与实战.zip
01-20
参考资料-中颖单片机入门与实战.zip
C51 - Printf 串口重定向的实现
如图所示
08-01 783
c
51单片机实现printf调试（带完整UART代码详解）
CasingHead的博客
01-10 6569
51单片机 printf到串口调试
重定向printf使用串口
lijianhua003的博客
06-19 971
重定向printf什么意思？
单片机printf函数重定向
qq_25248939的专栏
05-23 2138
#include <reg51.h>#include <stdio.h>typedef char * va_list; //51单片机定义为char，如果是32位单片机就定义为int类型 #define _INTSIZEOF(x) ((sizeof(x) + sizeof(char) - 1) & ~(sizeof(char) - 1) )#define va_start(ap,v) (ap =
串口通信printf函数重定向
weixin_46251230的博客
09-08 2662
printf函数重定向在51单片机的串口通讯也使用过，但51重写的时putchar函数，这次STM32重写的是fputc函数和fgetc函数，至于为什么51和STM32重写的函数不同，但都能用printf函数往串口打印，可以看51串口重写printf函数那篇文章。是ARM单片机的一种调试机制，它需要通过仿真器来连接电脑和ARM单片机，并调用相应的指令来实现单片机向电脑显示器打印信息。fputc是printf函数的底层函数，所以重写了fputc函数后，printf函数也会发生改变，scanf函数比较少用。
嵌入式通信协议：UART简明学习笔记
最新发布
weixin_73867577的博客
10-31 827
学习UART串口的简明学习笔记
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

打赏作者

编程圈子

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

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

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

打赏作者

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

抵扣说明：

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

余额充值