STM32串口打印的那些知識

本文轉載自查看原文 2020-06-07 23:36 1955 STM32/ 串口/ 嵌入式大雜燴

常規打印方法

在STM32的應用中，我們常常對printf進行重定向的方式來把打印信息printf到我們的串口助手。在MDK環境中，我們常常使用MicroLIB+fputc的方式實現串口打印功能，即：

要實現fputc函數的原因是：printf函數依賴於fputc函數，重新實現fputc內部從串口發送數據即可間接地實現printf打印輸出數據到串口。

不知道大家有沒有看過正點原子裸機串口相關的例程，他們的串口例程里不使用MicroLIB，而是使用標准庫+fputc的方式。相關代碼如：

#if 1
#pragma import(__use_no_semihosting)
//標准庫需要的支持函數
struct __FILE
{
    int handle;
};

FILE __stdout;
/**
 * @brief	定義_sys_exit()以避免使用半主機模式
 * @param	void
 * @return  void
 */
void _sys_exit(int x)
{
    x = x;
}

int fputc(int ch, FILE *f)
{
    while((USART1->ISR & 0X40) == 0); //循環發送,直到發送完畢

    USART1->TDR = (u8) ch;
    return ch;
}
#endif

關於這兩種方法的一些說明可以查看Mculover666兄的重定向printf函數到串口輸出的多種方法這篇文章。這篇文章中不僅包含上面的兩種方法，而且也包含着在GCC中使用標准庫重定向printf的方法。

自己實現一個打印函數

以上的幾種方法基本上是改造C庫的printf函數來實現串口打印的功能。其實我們也可以自己實現一個串口打印的功能。

printf本身就是一個變參函數，其原型為：

int printf (const char *__format, ...);

所以，我們要重新封裝的一個串口打印函數自然也應該是一個變參函數。具體實現如下：

1、基於STM32的HAL庫

#define TX_BUF_LEN  256     /* 發送緩沖區容量，根據需要進行調整 */
uint8_t TxBuf[TX_BUF_LEN];  /* 發送緩沖區                       */
void MyPrintf(const char *__format, ...)
{
  va_list ap;
  va_start(ap, __format);
  
  /* 清空發送緩沖區 */
  memset(TxBuf, 0x0, TX_BUF_LEN);
  
  /* 填充發送緩沖區 */
  vsnprintf((char*)TxBuf, TX_BUF_LEN, (const char *)__format, ap);
  va_end(ap);
  int len = strlen((const char*)TxBuf);
  
  /* 往串口發送數據 */
  HAL_UART_Transmit(&huart1, (uint8_t*)&TxBuf, len, 0xFFFF);
}

因為我們使用printf函數基本不使用其返回值，所以這里直接用void類型了。自定義變參函數需要用到va_start、va_end等宏，需要包含頭文件stdarg.h。關於變參函數的一些學習可以查看網上的一些博文，如：

https://www.cnblogs.com/wulei0630/p/9444062.html

這里我們使用的是STM32的HAL庫，其給我們提供HAL_UART_Transmit接口可以直接把整個發送緩沖區的內容給一次性發出去。

2、基於STM32標准庫

若是基於STM32的標准庫，就需要一字節一字節的循環發送出去，具體代碼如：

#define TX_BUF_LEN  256     /* 發送緩沖區容量，根據需要進行調整 */
uint8_t TxBuf[TX_BUF_LEN];  /* 發送緩沖區                       */
void MyPrintf(const char *__format, ...)
{
  va_list ap;
  va_start(ap, __format);
    
  /* 清空發送緩沖區 */
  memset(TxBuf, 0x0, TX_BUF_LEN);
    
  /* 填充發送緩沖區 */
  vsnprintf((char*)TxBuf, TX_BUF_LEN, (const char *)__format, ap);
  va_end(ap);
  int len = strlen((const char*)TxBuf);
  
  /* 往串口發送數據 */
  for (int i = 0; i < len; i++)
  {
	while(USART_GetFlagStatus(USART1, USART_FLAG_TC)==RESET);    
	USART_SendData(USART1, TxBuf[i]);
  }
}

測試結果：