RT-Thread 实战指南：通过宏定义快速配置STM32串口设备-深圳市維司達科技有限公司

1. 理解RT-Thread串口设备框架

在嵌入式开发中，串口是最常用的外设之一。RT-Thread作为一款优秀的实时操作系统，提供了完善的串口设备驱动框架。与裸机开发直接操作寄存器不同，RT-Thread将串口抽象为设备，通过统一接口进行访问。

我第一次接触RT-Thread串口时，发现它有几个明显优势：

标准化操作：所有串口设备使用相同的open/read/write接口
多任务安全：内置缓冲区管理和互斥保护
灵活配置：支持中断、DMA等多种工作模式

在board.h中通过宏定义配置串口，实际上是利用了RT-Thread的设备驱动模型。当定义BSP_USING_UART2后，系统会在初始化时自动注册uart2设备，开发者无需手动编写初始化代码。

2. 准备工作与环境搭建

在开始配置串口前，需要准备好开发环境。我推荐使用以下工具组合：

硬件：任意STM32开发板（如STM32F103C8T6）
RT-Thread版本：4.0.x或更高
开发工具：
- RT-Thread Studio（集成开发环境）
- CubeMX（可视化引脚配置）
- 串口调试助手（如Putty）

以STM32F103为例，首先在CubeMX中配置USART2的引脚：

打开CubeMX，选择对应芯片型号
在Pinout视图中找到USART2
配置TX为PA2，RX为PA3
生成初始化代码

提示：使用CubeMX可以避免手动查阅数据手册确认引脚，特别适合多引脚复用场景。

3. 配置board.h实现串口快速添加

在RT-Thread项目中，board.h是板级配置的核心文件。添加串口2只需三步：

3.1 启用串口设备

打开项目中的board.h文件，找到串口配置区域，添加以下宏定义：

#define BSP_USING_UART2 #define BSP_UART2_TX_PIN "PA2" #define BSP_UART2_RX_PIN "PA3"

这些宏定义的作用：

BSP_USING_UART2：告诉系统需要初始化UART2
BSP_UART2_TX_PIN：指定发送引脚
BSP_UART2_RX_PIN：指定接收引脚

3.2 配置串口参数（可选）

如果需要修改默认参数，可以添加以下配置：

#define BSP_UART2_BAUDRATE 115200 #define BSP_UART2_STOP_BITS 1 #define BSP_UART2_DATA_BITS 8 #define BSP_UART2_PARITY NONE

3.3 验证配置结果

编译下载后，在终端输入list_device命令，应该能看到uart2设备：

msh />list_device device type ref count -------- ---------- ----------- uart2 Character Device 0

4. 编写串口应用程序

配置好硬件后，就可以编写应用程序了。RT-Thread提供了多种使用串口的方式。

4.1 基础收发示例

这是一个最简单的串口回显程序：

#include <rtthread.h> #include <rtdevice.h> #define SAMPLE_UART_NAME "uart2" static void serial_thread_entry(void *parameter) { rt_device_t serial = (rt_device_t)parameter; char ch; while (1) { while (rt_device_read(serial, -1, &ch, 1) != 1) { rt_thread_mdelay(10); } rt_device_write(serial, 0, &ch, 1); } } int uart_sample(void) { rt_device_t serial = rt_device_find(SAMPLE_UART_NAME); if (!serial) { rt_kprintf("find %s failed!\n", SAMPLE_UART_NAME); return -RT_ERROR; } rt_device_open(serial, RT_DEVICE_FLAG_RDWR); rt_thread_t thread = rt_thread_create("serial", serial_thread_entry, serial, 512, 25, 10); if (thread) { rt_thread_startup(thread); } return RT_EOK; } MSH_CMD_EXPORT(uart_sample, uart echo sample);

4.2 中断模式优化

上面的例子使用轮询方式读取数据，效率较低。改进为中断模式：

static rt_sem_t rx_sem; static rt_err_t uart_rx_ind(rt_device_t dev, rt_size_t size) { rt_sem_release(rx_sem); return RT_EOK; } static void serial_thread_entry(void *parameter) { char ch; while (1) { while (rt_device_read(serial, -1, &ch, 1) != 1) { rt_sem_take(rx_sem, RT_WAITING_FOREVER); } rt_device_write(serial, 0, &ch, 1); } } int uart_sample_int(void) { serial = rt_device_find(SAMPLE_UART_NAME); /* 初始化信号量 */ rx_sem = rt_sem_create("rx_sem", 0, RT_IPC_FLAG_FIFO); /* 以中断接收模式打开 */ rt_device_open(serial, RT_DEVICE_FLAG_INT_RX); /* 设置接收回调 */ rt_device_set_rx_indicate(serial, uart_rx_ind); /* 创建线程 */ // ... 同前 ... }

5. 调试技巧与常见问题

在实际项目中，我遇到过几个典型问题：

5.1 串口无输出

现象：程序运行但串口没有输出排查步骤：

确认引脚配置是否正确
检查波特率是否匹配
使用逻辑分析仪查看引脚实际信号

5.2 数据丢失

解决方案：

增大接收缓冲区
使用DMA模式
提高接收线程优先级

5.3 多线程安全

当多个线程访问同一串口时，需要添加互斥锁：

static rt_mutex_t uart_mutex; void send_data(const char *str) { rt_mutex_take(uart_mutex, RT_WAITING_FOREVER); rt_device_write(serial, 0, str, rt_strlen(str)); rt_mutex_release(uart_mutex); }

6. 高级应用：结合CubeMX生成代码

对于复杂项目，可以结合CubeMX生成初始化代码：

在CubeMX中配置USART参数
生成代码后，将HAL_UART_MspInit函数移植到board.c
保持RT-Thread的设备驱动框架不变

这种方式的优势是可以利用CubeMX的图形化配置，特别是对于支持硬件流控制的串口。

7. 性能优化建议

根据项目实测，给出以下优化建议：

DMA模式：大数据量传输时，使用DMA可降低CPU负载
```
rt_device_open(serial, RT_DEVICE_FLAG_DMA_RX);
```

缓冲区大小：根据数据量调整缓冲区

#define BSP_UART2_RX_BUFSIZE 256 #define BSP_UART2_TX_BUFSIZE 256

优先级设置：中断服务例程优先级应高于数据处理线程

在最近的一个工业传感器项目中，通过将串口改为DMA模式，CPU占用率从35%降到了12%。

RT-Thread 实战指南：通过宏定义快速配置STM32串口设备