RT-Thread实战:串口DMA接收+消息队列处理全流程解析(附STM32代码)
在嵌入式系统开发中,串口通信是最基础也最常用的外设接口之一。传统的轮询方式会占用大量CPU资源,而中断方式在高频率数据传输时又容易丢失数据。本文将深入探讨如何利用RT-Thread实时操作系统的DMA接收和消息队列机制,构建一个高效可靠的串口通信框架。
1. 系统架构设计
串口DMA接收配合消息队列的处理流程,本质上是一种生产者-消费者模型的实现。DMA作为数据的生产者,在后台自动搬运数据;消息队列作为缓冲区,解耦数据接收和处理;工作线程作为消费者,专注于业务逻辑处理。
关键组件交互关系:
| 组件 | 角色 | 触发条件 | 执行动作 |
|---|---|---|---|
| DMA控制器 | 数据搬运工 | 串口接收到数据 | 自动将数据从串口DR寄存器搬运到内存缓冲区 |
| 空闲中断 | 数据包分割器 | 串口线路空闲 | 标记数据包接收完成,触发回调函数 |
| 回调函数 | 消息生产者 | 空闲中断触发 | 通过消息队列通知工作线程有新数据到达 |
| 工作线程 | 消息消费者 | 消息队列非空 | 从缓冲区读取数据并进行业务处理 |
这种架构的优势在于:
- 低CPU占用:DMA在后台自动完成数据搬运,CPU仅在数据包完整接收后才介入处理
- 实时响应:消息队列机制确保数据能够及时被处理线程获取
- 松耦合:各组件职责明确,便于维护和扩展
2. 硬件与RT-Thread配置
2.1 硬件准备
以STM32F103系列为例,需要完成以下硬件配置:
-
串口外设使能:
// board.h 中配置串口引脚 #define BSP_USING_UART2 #define UART2_TX_PIN "PA2" #define UART2_RX_PIN "PA3" -
DMA控制器配置:
// stm32f1xx_hal_conf.h 中开启DMA支持 #define HAL_DMA_MODULE_ENABLED -
时钟树配置:
- 确保USART2时钟已使能
- DMA1时钟使能
- 对应GPIO端口时钟使能
提示:不同STM32系列的具体配置可能有所差异,请参考对应型号的参考手册。
2.2 RT-Thread环境搭建
-
使用Env工具配置RT-Thread内核:
# 开启消息队列功能 RT_USING_MESSAGEQUEUE=y # 开启串口设备框架 RT_USING_SERIAL=y # 开启DMA支持 RT_SERIAL_USING_DMA=y -
在CubeMX中生成初始化代码时,需要特别注意:
- 使能串口全局中断
- 配置DMA通道为循环模式
- 设置合适的波特率、数据位、停止位和校验位
3. 核心代码实现
3.1 消息队列与数据结构定义
首先定义通信所需的数据结构:
/* 串口接收消息结构 */
struct rx_msg {
rt_device_t dev; // 串口设备句柄
rt_size_t size; // 接收到的数据大小
};
/* 全局变量定义 */
static rt_device_t serial; // 串口设备句柄
static struct rt_messagequeue rx_mq; // 消息队列控制块
static char msg_pool[256]; // 消息队列存储池
消息队列初始化:
rt_mq_init(&rx_mq, "uart_mq",
msg_pool, // 存储池
sizeof(struct rx_msg), // 单条消息大小
sizeof(msg_pool), // 存储池总大小
RT_IPC_FLAG_FIFO); // 先进先出策略
3.2 DMA接收回调函数
回调函数是连接硬件中断和RT-Thread系统的桥梁:
static rt_err_t uart_input(rt_device_t dev, rt_size_t size)
{
struct rx_msg msg;
rt_err_t result;
msg.dev = dev;
msg.size = size;
result = rt_mq_send(&rx_mq, &msg, sizeof(msg));
if (result == -RT_EFULL) {
rt_kprintf("Message queue full! Data may lost.\n");
}
return result;
}
关键点说明:
- 该函数由RT-Thread串口框架在检测到空闲中断时自动调用
size参数表示本次接收到的数据长度- 消息发送采用非阻塞方式,队列满时会立即返回错误
3.3 数据处理线程
工作线程负责从消息队列获取通知并处理数据:
static void serial_thread_entry(void *parameter)
{
struct rx_msg msg;
rt_err_t result;
rt_uint32_t rx_length;
static char rx_buffer[RT_SERIAL_RB_BUFSZ + 1];
while (1) {
rt_memset(&msg, 0, sizeof(msg));
/* 等待消息到达 */
result = rt_mq_recv(&rx_mq, &msg, sizeof(msg), RT_WAITING_FOREVER);
if (result == RT_EOK) {
/* 从串口读取数据 */
rx_length = rt_device_read(msg.dev, 0, rx_buffer, msg.size);
rx_buffer[rx_length] = '\0';
/* 业务处理开始 */
rt_kprintf("Received %d bytes: %s\n", rx_length, rx_buffer);
/* 业务处理结束 */
}
}
}
线程创建:
rt_thread_t thread = rt_thread_create("serial",
serial_thread_entry,
RT_NULL,
1024, // 栈大小
25, // 优先级
10); // 时间片
if (thread != RT_NULL) {
rt_thread_startup(thread);
}
4. 性能优化与问题排查
4.1 常见性能瓶颈
-
消息队列溢出:
- 症状:频繁出现"Message queue full"提示
- 解决方案:
- 增大消息队列容量
- 提高工作线程优先级
- 优化数据处理耗时
-
数据包分割异常:
- 症状:接收到的数据被不正确地分割
- 解决方案:
- 调整空闲中断检测时间
- 添加软件超时机制
- 实现自定义协议头尾标识
4.2 调试技巧
-
使用逻辑分析仪:
- 捕获实际串口波形
- 验证波特率准确性
- 检查数据包间隔
-
RT-Thread内置工具:
# 查看消息队列状态 msgs list # 查看线程状态 ps # 查看串口设备信息 list_device -
性能统计:
// 在空闲钩子中统计CPU使用率 static void idle_hook() { rt_uint32_t total; rt_uint32_t used; rt_memory_info(&total, &used, RT_NULL); rt_kprintf("Memory used: %d/%d\n", used, total); }
4.3 高级优化策略
-
双缓冲技术:
#define BUF_SIZE 256 static char buf1[BUF_SIZE], buf2[BUF_SIZE]; static char *current_buf = buf1; // 在回调函数中切换缓冲区 if (current_buf == buf1) { process_buffer(buf2); current_buf = buf2; } else { process_buffer(buf1); current_buf = buf1; } -
动态优先级调整:
// 当队列长度超过阈值时提高线程优先级 if (rx_mq.entry > (rx_mq.max_msgs / 2)) { rt_thread_control(thread, RT_THREAD_CTRL_CHANGE_PRIORITY, (void*)10); } -
数据批处理:
// 一次处理多条消息 #define BATCH_SIZE 5 struct rx_msg msgs[BATCH_SIZE]; rt_size_t recv_count = rt_mq_recv(&rx_mq, msgs, sizeof(msgs), 0);
5. 实战案例扩展
5.1 Modbus RTU协议实现
基于上述框架实现Modbus RTU从机:
// 在serial_thread_entry中添加协议解析
void process_modbus(const char *data, rt_size_t size)
{
if (size < 4) return; // 最小帧长度
uint8_t slave_id = data[0];
uint8_t function = data[1];
// CRC校验
if (!check_crc(data, size)) {
send_error_response(slave_id, function, CRC_ERROR);
return;
}
switch (function) {
case 0x03: // 读保持寄存器
handle_read_holding_registers(data);
break;
case 0x06: // 写单个寄存器
handle_write_single_register(data);
break;
default:
send_error_response(slave_id, function, ILLEGAL_FUNCTION);
}
}
5.2 与文件系统结合
将接收到的数据保存到SD卡:
static void save_to_file(const char *data, rt_size_t size)
{
int fd = open("/sd/log.txt", O_WRONLY | O_CREAT | O_APPEND);
if (fd >= 0) {
write(fd, data, size);
write(fd, "\n", 1);
close(fd);
}
}
5.3 网络透传实现
通过WiFi模块转发串口数据:
static void forward_to_wifi(const char *data, rt_size_t size)
{
struct netdev *dev = netdev_get_by_name("w0");
if (dev && netdev_is_up(dev)) {
send(dev->socket, data, size, 0);
}
}
4458



被折叠的 条评论
为什么被折叠?



