当前位置：首页 > news >正文

STM32CubeMX实战：串口通信与重定向的配置与优化

news 2026/3/26 23:34:56

1. STM32CubeMX串口通信基础配置

第一次接触STM32CubeMX配置串口时，我也被那一堆参数搞得头晕。后来发现只要抓住几个关键点，5分钟就能搞定基础通信。打开CubeMX新建工程后，在Pinout界面找到USART1，勾选Asynchronous模式（异步通信），这时PA9和PA10会自动配置为TX和RX引脚。如果要用其他串口，比如USART2，操作完全一样。

参数配置页面的几个数值特别重要：

Baud Rate（波特率）：常用115200或9600
Word Length（字长）：选8 bits
Parity（校验位）：None
Stop Bits（停止位）：1 bit
数据方向：收发都选

这里有个坑我踩过——如果要用中断接收数据，必须在NVIC Settings里勾选USART全局中断。配置完成后点击生成代码，CubeMX会自动创建初始化代码，在main.c里可以看到MX_USARTx_UART_Init()函数。

2. 串口数据收发实战技巧

2.1 发送数据的三种姿势

最基础的发送方式是使用HAL_UART_Transmit()函数，我在项目里经常这样用：

uint8_t hello[] = "Hello STM32!\r\n"; HAL_UART_Transmit(&huart1, hello, sizeof(hello)-1, HAL_MAX_DELAY);

注意最后一个参数是超时时间，HAL_MAX_DELAY表示一直等待。如果改用中断方式发送，要用HAL_UART_Transmit_IT()，这个方式不会阻塞程序运行。

更高级的用法是DMA传输，适合大数据量场景。配置DMA通道后，调用HAL_UART_Transmit_DMA()即可。实测发现DMA方式能降低CPU占用率约60%，特别适合实时性要求高的应用。

2.2 中断接收的正确姿势

接收数据最可靠的方式是用中断。先在main()初始化里启动接收：

uint8_t rx_data; HAL_UART_Receive_IT(&huart1, &rx_data, 1);

然后重写回调函数：

void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if(huart->Instance == USART1) { // 处理接收到的rx_data HAL_UART_Transmit(&huart1, &rx_data, 1, 100); // 回显 HAL_UART_Receive_IT(&huart1, &rx_data, 1); // 重新启用中断 } }

这里有个关键点：每次中断接收后必须重新启用中断，否则下次就收不到数据了。我在早期项目里就因为这个bug调试了半天。

3. 串口重定向深度优化

3.1 printf重定向的完整方案

想让printf输出到串口，需要在工程里做三处修改。首先在usart.h添加：

#include <stdio.h> #ifdef __GNUC__ #define PUTCHAR_PROTOTYPE int __io_putchar(int ch) #else #define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f) #endif

然后在usart.c文件末尾添加：

PUTCHAR_PROTOTYPE { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY); return ch; }

最后在工程属性里勾选"Use MicroLIB"（Keil环境）或设置正确的链接器参数（其他IDE）。这样就能愉快地使用printf了：

printf("系统启动完成，版本：%d.%d\r\n", 1, 0);

3.2 性能优化技巧

默认的printf实现效率不高，我总结了几条优化经验：

减少浮点数打印，因为会显著增加代码体积
对于固定字符串，直接调用HAL_UART_Transmit更快
使用自定义的轻量级打印函数替代printf

还可以实现scanf重定向，方法与printf类似：

int fgetc(FILE *f) { uint8_t ch; HAL_UART_Receive(&huart1, &ch, 1, HAL_MAX_DELAY); return ch; }

4. 常见问题排查指南

4.1 数据收发异常排查

当串口工作不正常时，我通常按这个顺序检查：

用万用表测量TX/RX引脚电压，空闲时应为高电平
确认波特率等参数与终端软件设置一致
检查时钟配置是否正确（特别是APB总线时钟）
查看硬件连接，杜邦线接触不良是常见问题

有个特别隐蔽的bug：如果使用了低功耗模式，唤醒后需要重新初始化串口。我在一个电池供电项目里就遇到过这个问题。

4.2 中断冲突处理

当多个外设共用中断向量时，需要在中断服务函数里准确判断中断源。例如：

void USART1_IRQHandler(void) { if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXNE)) { // 处理接收中断 } if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_TXE)) { // 处理发送中断 } HAL_UART_IRQHandler(&huart1); }