STM32 HAL库 使用printf函数 Use MicroLIB配置

问题描述

STM32 开发过程中难免需要使用串口打印一些调试信息，经常会用到printf()函数；
STM32 还不能直接使用printf()函数，需要重定向一下，这里讲解两种配置办法；

该配置基于HAL库

---

解决方案：

使用微库

配置MDK-keil ，点击魔术棒，Target里面勾选Use MicroLIB

然后重定向printf()函数，修改fputc()函数

# include "stdio.h"
int fputc(int ch, FILE *f)
{
    HAL_UART_Transmit(&huart1 , (uint8_t *)&ch, 1, 0xFFFF);
    return ch;
}

不使用微库

不用配置MDK-keil

直接重定向printf()函数

//printf重定向代码,修改其底层fputc
#if 1
#include <stdio.h>

/* 告知连接器不从C库链接使用半主机的函数 */
#pragma import(__use_no_semihosting)

/* 定义 _sys_exit() 以避免使用半主机模式 */
void _sys_exit(int x)
{
    x = x;
}

/* 标准库需要的支持类型 */
struct __FILE
{
    int handle;
};

FILE __stdout;

/*  */
int fputc(int ch, FILE *stream)
{
    /* 堵塞判断串口是否发送完成 */
	/* 不同芯片的串口标志位不一定相同！ */
    while((USART1->SR & 0X40) == 0);

    /* 串口发送完成，将该字符发送 */
    USART1->DR = (uint8_t) ch;

    return ch;
}

#endif

使用多串口方法

如果要使用多个串口，比如在做物联网一些项目的时候，一个串口用来连接外设或者连接WIFI模块，另一个串口用来输出调试信息；

参考原子哥的代码，在HAL库中需要修改，具体修改方法参考正点原子视频，直接给出修改后的代码：

需要在 usrat.c 文件中添加如下代码：

#include <stdarg.h>
#include <string.h>
#include <stdio.h>

void UsartPrintf(UART_HandleTypeDef USARTx, char *fmt,...)
{
 
	unsigned char UsartPrintfBuf[296];
	va_list ap;
	unsigned char *pStr = UsartPrintfBuf;
	
	va_start(ap, fmt);
	vsnprintf((char *)UsartPrintfBuf, sizeof(UsartPrintfBuf), fmt, ap);							//格式化
	va_end(ap);
	
	while(*pStr != NULL)
	{
        HAL_UART_Transmit (&USARTx ,(uint8_t *)pStr++,1,HAL_MAX_DELAY );		
	}
 
}

需要在 usrat.h文件中添加如下代码：

#define USART_DEBUG		huart1
 
void UsartPrintf(UART_HandleTypeDef USARTx, char *fmt,...);

使用办法直接调用函数：

UsartPrintf(USART_DEBUG, "The USART1 is OK!\r\n");

注意：函数参数中 USART_DEBUG 参数为在 usrat.h 中重定义的 huart1 。

如果同时打开了USART1和USART2，那么在 usrat.h 中还会有一个 huart2 ，可以像huart1 一样重定义 huart2 ，可以自定义成其它名字以和其它串口区分开来。

优缺点

第一种使用微库，需要配置keil 里面的Use MicroLIB；
第二种不用配置设置，直接使用，但是第二个比较长；
第三种适用与使用多个串口的情况，比如在使用esp8266模块时，一个串口用来调试，另外一个用于和模块通信。
为了防止忘记配置，建议使用第二个；