基于HAL库的多串口打印函数（XL_Printf）

基于HAL库的多串口打印函数（XL_Printf）

本文参考以下文章：

https://blog.csdn.net/sehanlingfeng/article/details/80383117
https://baike.baidu.com/item/va_list/8573665?fr=aladdin

一、重定向Printf的局限性

1. 使用重定向函数，需要添加stdio.h头文件

// 重定向函数1
int fputc(int ch,FILE *f)
{
    uint8_t temp[1]={ch};
    HAL_UART_Transmit(&UartHandle,temp,1,2);        //UartHandle是串口的句柄
}
 
//重定向函数2
PUTCHAR_PROTOTYPE
{
  HAL_UART_Transmit(&UARTHandle, (uint8_t *)&ch, 1, 0xFFFF); 
  return ch;
}

2. 采用上述函数会存在以下问题
   Printf函数只用用于单一串口发送，想要用于多函数发送则需要将UartHandle定义成全局变量，通过更改UartHandle来实现发送串口的更换，不符合代码低耦合的要求，对于自定义发送不适合。

二、va_list方法

1. va_list是在C语言中解决变参问题的一组宏，所在头文件：#include <stdarg.h>，用于获取不确定个数的参数。

#ifdef _M_ALPHA
typedef struct {
char *a0; /* pointer to first homed integer argument */
int offset; /* byte offset of next parameter */
} va_list;
#else
typedef char * va_list;
#endif

_M_ALPHA是指DEC ALPHA（Alpha AXP）架构。所以一般情况下va_list所定义变量为字符指针。

 INTSIZEOF 宏,获取类型占用的空间长度，最小占用长度为int的整数倍：
#define _INTSIZEOF(n) ( (sizeof(n) + sizeof(int) - 1) & ~(sizeof(int) - 1) )
VA_START宏，获取可变参数列表的第一个参数的地址（ap是类型为va_list的指针，v是可变参数最左边的参数）：
#define va_start(ap,v) ( ap = (va_list)&v + _INTSIZEOF(v) )
VA_ARG宏，获取可变参数的当前参数，返回指定类型并将指针指向下一参数（t参数描述了当前参数的类型）：
#define va_arg(ap,t) ( *(t *)((ap += _INTSIZEOF(t)) - _INTSIZEOF(t)) )
VA_END宏，清空va_list可变参数列表：
#define va_end(ap) ( ap = (va_list)0 )

2. 原理不懂也没关系，直接用吧。

三、XL_Printf多串口打印函数

1. 函数代码

#include <stdarg.h>
/*-----串口发送函数----------------
带字符解析的发送函数
----------------------------------*/
uint8_t XL_Printf(UART_HandleTypeDef *huart,const char *format, ...)
{
	char buf[512]; //定义临时数组，根据实际发送大小微调
    va_list args;
    va_start(args, format);
    uint16_t len = vsnprintf((char *)buf, sizeof(buf), (char *)format, args);
    va_end(args);
    return HAL_UART_Transmit(huart,buf,len,1000); //串口打印函数，可以更换为中断发送或者DMA发送
}

2. 使用方式与Printf函数一致

printf("%daaaabbbb%s%e",1,"gg",2000.3);
XL_Printf(&huart1,"%daaaabbbb%s%e",1,"gg",2000.3);

其中串口号&huart1可以更换为其他串口