STM32之HAL例程分析-串口输出函数printf打印调试信息

最新推荐文章于 2025-06-18 14:02:27 发布

youk110

最新推荐文章于 2025-06-18 14:02:27 发布

阅读量1.9k

点赞数

CC 4.0 BY-SA版权

分类专栏： STM32之HAL例程文章标签： stm32 单片机 c语言

本文链接：https://blog.csdn.net/youk110/article/details/123159614

STM32之HAL例程专栏收录该内容

10 篇文章

订阅专栏

本文详细介绍了如何在STM32F1平台上通过HAL库配置UART通信，包括初始化步骤、HAL_UART_MspInit的重写、printf函数的硬件替代以及中断和DMA模式的使用。通过实例展示了如何将C标准库的printf函数替换为HAL_UART_Transmit实现串口输出。

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

参考ST官方历程进行程序修改。

1、主函数如下代码所示。HAL例程中使用句柄UartHandleTypedef 完成对串口通用参数的初始化，串口的底层硬件初始化则在函数HAK_UART_Init中的HAL_UART_MspInit函数中实现。

int main(void)
{
 

  HAL_Init();
  SystemClock_Config();
  BSP_LED_Init(LED3);
  BSP_LED_Init(LED4);
	 /*##-1- Configure the UART peripheral ######################################*/
  /* Put the USART peripheral in the Asynchronous mode (UART Mode) */
  /* UART configured as follows:
      - Word Length = 8 Bits (7 data bit + 1 parity bit) : BE CAREFUL : Program 7 data bits + 1 parity bit in PC HyperTerminal
      - Stop Bit    = One Stop bit
      - Parity      = no parity
      - BaudRate    = 9600 baud
      - Hardware flow control disabled (RTS and CTS signals) */
  UartHandle.Instance        = USARTx;

  UartHandle.Init.BaudRate   = 9600;
  UartHandle.Init.WordLength = UART_WORDLENGTH_8B;
  UartHandle.Init.StopBits   = UART_STOPBITS_1;
  UartHandle.Init.Parity     = UART_PARITY_NONE;
  UartHandle.Init.HwFlowCtl  = UART_HWCONTROL_NONE;
  UartHandle.Init.Mode       = UART_MODE_TX_RX;

  if (HAL_UART_Init(&UartHandle) != HAL_OK)
  {
    /* Initialization Error */
    Error_Handler();
  }

	  /* Output a message on Hyperterminal using printf function */
  printf("\n\r UART Printf Example: retarget the C library printf function to the UART\n\r");
  printf("** Test finished successfully. ** \n\r");

  /* Infinite loop */
  while (1)
  {
    /* Toggle LED2 and LED4 */
    BSP_LED_Toggle(LED4);
    /* Insert 1000 ms delay */
    HAL_Delay(1000);

  }
}

2、函数HAL_UART_MspInit在文件stm32f1xx_hal_uart.c中已经定义，其定义如下：

 __weak void HAL_UART_MspInit(UART_HandleTypeDef *huart)
{
  /* Prevent unused argument(s) compilation warning */
  UNUSED(huart);
  /* NOTE: This function should not be modified, when the callback is needed,
           the HAL_UART_MspInit can be implemented in the user file
   */ 
}

此函数未对底层串口初始化，由于此函数为weak型，故可在用户文件中对这个函数进行改写，主程序调用时直接调用用户定义的函数。

void HAL_UART_MspInit(UART_HandleTypeDef *huart)
{
  GPIO_InitTypeDef  GPIO_InitStruct;


  /*##-1- Enable peripherals and GPIO Clocks #################################*/
  /* Enable GPIO TX/RX clock */
  USARTx_TX_GPIO_CLK_ENABLE();
  USARTx_RX_GPIO_CLK_ENABLE();


  /* Enable USARTx clock */
  USARTx_CLK_ENABLE();

  /*##-2- Configure peripheral GPIO ##########################################*/
  /* UART TX GPIO pin configuration  */
  GPIO_InitStruct.Pin       = USARTx_TX_PIN;
  GPIO_InitStruct.Mode      = GPIO_MODE_AF_PP;
  GPIO_InitStruct.Pull      = GPIO_PULLUP;
  GPIO_InitStruct.Speed     = GPIO_SPEED_FREQ_HIGH;

  HAL_GPIO_Init(USARTx_TX_GPIO_PORT, &GPIO_InitStruct);

  /* UART RX GPIO pin configuration  */
  GPIO_InitStruct.Pin = USARTx_RX_PIN;

  HAL_GPIO_Init(USARTx_RX_GPIO_PORT, &GPIO_InitStruct);
}

串口IO口定义部分在main.h文件中实现。

/* Definition for USARTx clock resources */
#define USARTx                           USART1
#define USARTx_CLK_ENABLE()              __HAL_RCC_USART1_CLK_ENABLE();
#define USARTx_RX_GPIO_CLK_ENABLE()      __HAL_RCC_GPIOA_CLK_ENABLE()
#define USARTx_TX_GPIO_CLK_ENABLE()      __HAL_RCC_GPIOA_CLK_ENABLE()

#define USARTx_FORCE_RESET()             __HAL_RCC_USART1_FORCE_RESET()
#define USARTx_RELEASE_RESET()           __HAL_RCC_USART1_RELEASE_RESET()

/* Definition for USARTx Pins */
#define USARTx_TX_PIN                    GPIO_PIN_9
#define USARTx_TX_GPIO_PORT              GPIOA
#define USARTx_RX_PIN                    GPIO_PIN_10
#define USARTx_RX_GPIO_PORT              GPIOA

3、对编译器中使用的printf函数进行改写，由终端输出改为硬件串口输出（一个个字符输出）。

#define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f)

PUTCHAR_PROTOTYPE
{
  /* Place your implementation of fputc here */
  /* e.g. write a character to the USART1 and Loop until the end of transmission */
  HAL_UART_Transmit(&UartHandle, (uint8_t *)&ch, 1, 0xFFFF);

  return ch;
}

4、HAL例程对中断、DMA两种模式也进行了封装，可查阅相关代码。程序运行结果如下。