单片机与物联网 / 系统课时
用接收中断写入串口环形队列
用接收中断写入串口环形队列
本课实现一个可直接用于 STM32 裸机工程的串口接收方案:USART 每收到一个字节,中断服务函数就把它写入环形队列,主循环再按自己的节奏取出处理。完成后,主循环不必阻塞等待串口,也能连续接收数据,并能检测队列溢出和硬件接收错误。
学习目标
- 理解 USART 接收中断、环形队列和主循环之间的数据传递关系。
- 使用 C 语言实现单生产者、单消费者环形队列,并在接收中断中写入字节。
- 验证连续接收、队列满、缓冲区回绕及硬件 Overrun 的处理行为。
为什么接收中断只负责入队
轮询接收通常需要反复检查接收标志,等待新字节到达。如果主循环正在执行其他任务,接收寄存器中的旧数据尚未读走,下一个字符又完成接收,就可能出现硬件 Overrun(接收溢出)。
接收中断把处理拆成两个执行上下文:
- USART 收到字节,硬件设置接收标志并申请中断。
- 中断服务函数读取接收数据寄存器,将字节写入 RAM 中的环形队列。
- 主循环检查队列,取出字节并完成命令解析、协议处理等业务逻辑。

中断内应避免等待发送完成、字符串格式化、动态内存分配和耗时协议解析。例如 115200 baud、8N1 格式每个字符占 10 bit,连续接收时约每 86.8 微秒就可能到达一个新字节。
环形队列如何保证中断与主循环不冲突
采用 128 字节静态数组,使用 head 表示下一次写入位置,tail 表示下一次读取位置。两个索引范围都是 0~127,每次加一后通过掩码回绕。
本课采用空出一个槽位的设计,不额外维护共享计数器,因此实际最大容量为 127 字节。
- 队列为空:
head == tail。 - 队列已满:
((head + 1) & 127) == tail。 - 入队成功:先写数据,再更新
head。 - 出队成功:先读取数据,再更新
tail。
例如初始 head=126、tail=124,写入两个字节后 head 依次变为 127、0,写入位置分别为 126、127。数据仍然留在数组中,不需要搬移。

单生产者、单消费者条件下,中断只修改 head,主循环只修改 tail。Cortex-M 上自然对齐的 32 位索引读写可以原子完成,但这不代表任意多字段操作都是原子的。本课还通过发布索引前后的内存屏障约束数据访问顺序。
实现队列和 USART 接收中断
下面以 STM32F103C8、USART1、CMSIS 设备头文件和直接寄存器访问 为例。示例适用于 STM32F1 的 USART 寄存器模型,不应直接复制到采用 ISR/RDR/ICR 寄存器模型的新系列芯片。
硬件连接为 PA10 接 USB-UART 模块 TX、PA9 接模块 RX、GND 共地,串口参数 115200、8N1、无流控,接口必须使用 3.3V 兼容电平。假定 MCU 以复位后的内部 HSI 8 MHz 运行,未另行配置 PLL,USART1 使用 8 MHz 的 PCLK2。
下面给出单文件 main.c,工程需要提供 STM32F103 对应的 CMSIS 启动文件、设备头文件和链接脚本。
#include <stdint.h>
#include "stm32f103xb.h"
#define RX_SIZE 128u
#define RX_MASK (RX_SIZE - 1u)
static uint8_t rx_buffer[RX_SIZE];
static volatile uint32_t rx_head = 0;
static volatile uint32_t rx_tail = 0;
static volatile uint32_t rx_dropped = 0;
static volatile uint32_t rx_overrun = 0;
static volatile uint32_t rx_errors = 0;
static void rx_push_isr(uint8_t value)
{
uint32_t head = rx_head;
uint32_t next = (head + 1u) & RX_MASK;
if (next == rx_tail) {
++rx_dropped; // 队列已满,丢弃新字节
return;
}
rx_buffer[head] = value;
__DMB(); // 发布 head 前,确保数据写入已完成
rx_head = next;
}
static int rx_pop(uint8_t *value)
{
uint32_t tail = rx_tail;
if (tail == rx_head) {
return 0;
}
*value = rx_buffer[tail];
__DMB(); // 读取数据后,才释放当前槽位
rx_tail = (tail + 1u) & RX_MASK;
return 1;
}
void USART1_IRQHandler(void)
{
uint32_t sr = USART1->SR;
if (sr & (USART_SR_RXNE | USART_SR_ORE |
USART_SR_FE | USART_SR_NE | USART_SR_PE)) {
// STM32F1 通过先读 SR、再读 DR 清除相应接收标志
uint8_t value = (uint8_t)USART1->DR;
if (sr & USART_SR_ORE) {
++rx_overrun;
}
if (sr & (USART_SR_FE | USART_SR_NE | USART_SR_PE)) {
++rx_errors;
}
if ((sr & USART_SR_RXNE) &&
!(sr & (USART_SR_FE | USART_SR_NE | USART_SR_PE))) {
rx_push_isr(value);
}
}
}
static void usart1_init(void)
{
RCC->APB2ENR |= RCC_APB2ENR_IOPAEN |
RCC_APB2ENR_USART1EN;
// PA9: 复用推挽输出,50 MHz;PA10: 浮空输入
GPIOA->CRH &= ~((0xFu << 4) | (0xFu << 8));
GPIOA->CRH |= (0xBu << 4) | (0x4u << 8);
USART1->CR1 = 0;
USART1->CR2 = 0;
USART1->CR3 = 0;
// PCLK2=8 MHz,16 倍过采样,115200 baud
USART1->BRR = 0x0045u;
USART1->CR1 = USART_CR1_TE | USART_CR1_RE |
USART_CR1_RXNEIE | USART_CR1_UE;
NVIC_SetPriority(USART1_IRQn, 5);
NVIC_EnableIRQ(USART1_IRQn);
}
static void usart1_send(uint8_t value)
{
while (!(USART1->SR & USART_SR_TXE)) {
}
USART1->DR = value;
}
int main(void)
{
usart1_init();
uint8_t value;
for (;;) {
if (rx_pop(&value)) {
// 演示用回显;正式任务可改为非阻塞发送队列
usart1_send(value);
}
}
}这里的阻塞式 usart1_send() 仅用于展示收到字节后的可观察结果,接收中断始终不等待发送。但主循环发送时仍会占用执行时间;如果改成复杂命令解析或高吞吐通信,应使用 USART 发送中断或 DMA 输出队列。
RX_SIZE 必须是 2 的整数次幂,否则按位掩码回绕不等价于取模。rx_dropped、rx_overrun 和 rx_errors 分别统计软件队列丢字节、硬件溢出和帧/噪声/奇偶校验错误。
编译运行并检查接收效果
使用已经配置好 STM32F103 CMSIS 启动文件及链接脚本的裸机工程,将 main.c 加入工程,确认启动文件中的向量表引用 USART1_IRQHandler。启动代码应在进入 main() 前完成必要的数据段初始化。
- 编译并烧录固件,确保设备以 HSI 8 MHz 时钟启动。如果工程中的
SystemInit()已配置 PLL,必须重新计算 BRR。 - 打开串口终端,选择对应端口,配置 115200 baud、8 data bits、无校验、1 stop bit、无流控。
- 发送
ABC,观察终端是否依次回显ABC。需要关闭终端的本地回显,避免重复显示。 - 在调试器中观察
rx_head、rx_tail、rx_dropped和rx_overrun。正常低负载接收时,两个错误计数应保持为 0。
预期结果:发送 ABC 后,终端收到相同的三个字节,主循环持续运行。由于接收与处理并发进行,调试暂停位置不同,head 和 tail 的瞬时值不一定相等。
需要测试队列溢出时,可暂时把主循环的 rx_pop() 调用禁用,连续发送至少 128 字节。队列最多保存 127 字节,随后每个未被保存的新字节都会使 rx_dropped 增加。恢复出队后,再验证剩余字节按先进先出顺序读出。
测试回绕时,持续交替发送和消费超过 256 字节;若收发速率可被主循环跟上,数据顺序应该保持正确,head 和 tail 会多次从 127 回到 0。
接收丢字节时如何定位
首先区分软件队列满、硬件接收溢出和通信配置错误,不要看到数据缺失就直接增大缓冲区。
| 观察现象 | 更可能的原因 | 处理方式 |
|---|---|---|
rx_dropped 增长 |
主循环消费慢、队列满 | 减少主循环阻塞,增加队列容量 |
rx_overrun 增长 |
接收寄存器未及时读走 | 缩短高优先级中断,检查关中断时间 |
rx_errors 增长 |
波特率、电平、噪声或帧格式异常 | 核对 PCLK2、BRR、接线及 8N1 参数 |
| 完全没有进入中断 | 时钟、GPIO、NVIC 或中断向量配置错误 | 检查 USART1 时钟、RXNEIE、NVIC 和启动文件 |
| 回显重复或乱码 | 本地回显开启或实际串口时钟不匹配 | 关闭本地回显,核对系统时钟 |
容量估算可以使用一个简单算例:115200 baud、8N1 下,串口每秒最多约接收 11520 字节。如果主循环最长连续 5 ms 无法消费,那么这段时间约有 57.6 字节到达。至少需要容纳 58 字节,再留额外余量,因此使用 128 槽、实际容量 127 字节的队列比较合适。
这个估算只覆盖软件缓冲区占用。若 CPU 长时间屏蔽中断,硬件在队列入队之前就可能发生 Overrun,再大的 RAM 队列也无法补救。
正式工程应让 ISR 保持短小、主循环及时消费,并针对接收突发长度和最长处理延迟设置缓冲区容量。只有在吞吐量、实时性和错误计数均通过压力测试后,才能认为该串口接收链路满足使用要求。