主题
串口调试实战
串口是最便宜的调试通道,也是最容易做错的通道。本文从「能打印」做到「能传结构化数据」,中间补齐三个工程必备件:中断接收、环形缓冲、帧协议。
波特率与误差
异步通信靠双方各自的时钟对时,误差必须足够小:
误差 = (实际波特率 - 目标波特率) / 目标波特率 × 100%| 误差范围 | 后果 |
|---|---|
| < 1% | 稳定 |
| 1%–2% | 偶发误码,长帧更明显 |
| > 2% | 大量乱码,基本不可用 |
8MHz 晶振配 115200 时误差约 3.5%,这就是「用内部 RC 跑 115200 必乱码」的原因。解决办法:换用更高主频(如 72MHz)、改用外部晶振,或降低波特率到 9600 / 38400。
快速自查
能收到数据但内容随机 → 先怀疑波特率误差;一个字节都收不到 → 先查 TX/RX 是否交叉、是否共地。
中断接收 + 环形缓冲
不要在主循环里 while 等字节。中断只负责把数据塞进缓冲,主循环按自己的节奏取。
c
#define RX_RB_SIZE 256
typedef struct {
volatile unsigned short head;
volatile unsigned short tail;
unsigned char buf[RX_RB_SIZE];
} uart_rb_t;
static uart_rb_t s_rx;
void USART1_IRQHandler(void)
{
/* 收到一个字节:读 SR 再读 DR 才能清 RXNE */
if (USART1->SR & USART_SR_RXNE) {
unsigned char byte = (unsigned char)(USART1->DR & 0xFF);
unsigned short next = (s_rx.head + 1) & (RX_RB_SIZE - 1);
if (next != s_rx.tail) { /* 未满才写,满了丢弃 */
s_rx.buf[s_rx.head] = byte;
s_rx.head = next;
}
}
/* 溢出错误必须清,否则会反复进中断 */
if (USART1->SR & (USART_SR_ORE | USART_SR_FE | USART_SR_NE)) {
(void)USART1->DR;
}
}主循环取数据:
c
int uart_read_byte(unsigned char *out)
{
if (s_rx.head == s_rx.tail) return -1;
*out = s_rx.buf[s_rx.tail];
s_rx.tail = (s_rx.tail + 1) & (RX_RB_SIZE - 1);
return 0;
}为什么需要帧协议
裸发数据在工程上不可用:干扰会让字节丢失、错位,接收端无法判断「这一包从哪开始、是否完整」。
一个够用的帧结构:
| 字段 | 长度 | 说明 |
|---|---|---|
| 帧头 | 1 | 固定 0xA5,用于定位起点 |
| 命令 | 1 | 区分数据类型 |
| 长度 | 1 | 载荷长度,0–64 |
| 载荷 | N | 实际数据 |
| 校验 | 2 | CRC16(覆盖命令+长度+载荷) |
c
#define FRAME_HEAD 0xA5
#define FRAME_MAX 64
/* CRC16/MODBUS,多项式 0xA001,初值 0xFFFF */
unsigned short crc16(const unsigned char *data, unsigned int len)
{
unsigned short crc = 0xFFFF;
while (len--) {
crc ^= *data++;
for (unsigned char i = 0; i < 8; i++) {
if (crc & 1) crc = (crc >> 1) ^ 0xA001;
else crc >>= 1;
}
}
return crc;
}接收状态机
用状态机解析,逐字节喂入,不依赖「一次收完整包」这种不可靠假设:
c
typedef enum { S_HEAD, S_CMD, S_LEN, S_DATA, S_CRC_L, S_CRC_H } parse_state_t;
typedef struct {
parse_state_t state;
unsigned char cmd;
unsigned char len;
unsigned char idx;
unsigned char data[FRAME_MAX];
unsigned short crc;
} frame_parser_t;
static frame_parser_t s_fp;
/* 返回 1 表示解析出一帧完整且校验通过的数据 */
int frame_feed(unsigned char byte)
{
switch (s_fp.state) {
case S_HEAD:
if (byte == FRAME_HEAD) s_fp.state = S_CMD;
break;
case S_CMD:
s_fp.cmd = byte;
s_fp.state = S_LEN;
break;
case S_LEN:
if (byte > FRAME_MAX) { s_fp.state = S_HEAD; break; }
s_fp.len = byte;
s_fp.idx = 0;
s_fp.state = (byte == 0) ? S_CRC_L : S_DATA;
break;
case S_DATA:
s_fp.data[s_fp.idx++] = byte;
if (s_fp.idx >= s_fp.len) s_fp.state = S_CRC_L;
break;
case S_CRC_L:
s_fp.crc = byte;
s_fp.state = S_CRC_H;
break;
case S_CRC_H:
s_fp.crc |= (unsigned short)byte << 8;
s_fp.state = S_HEAD;
{
unsigned char tmp[FRAME_MAX + 2];
tmp[0] = s_fp.cmd;
tmp[1] = s_fp.len;
for (unsigned char i = 0; i < s_fp.len; i++) tmp[2 + i] = s_fp.data[i];
if (crc16(tmp, s_fp.len + 2) == s_fp.crc) return 1;
}
break;
default:
s_fp.state = S_HEAD;
break;
}
return 0;
}超时保护
只有状态机还不够。若在 S_DATA 中途断包,解析器会一直等后续字节,下一帧的帧头被当成数据吞掉。工程上要加帧内超时(如 50ms 无新字节就复位状态机)。
调试技巧
| 需求 | 做法 |
|---|---|
| 看原始字节 | 串口助手切 HEX 模式,别用文本模式猜 |
| 确认波特率 | 发 0x55(01010101),示波器量位宽 |
| 判断丢包 | 发送端每帧带自增序号,接收端看是否连续 |
| 定位干扰 | 降低波特率对比,若低速正常则为信号完整性问题 |
| 同时调试多机 | 每个模块加前缀 [SENSOR] / [MOTOR],日志里区分来源 |
完整链路
c
int main(void)
{
board_clock_init();
uart_init(115200);
printf("boot v1.0, build %s %s\r\n", __DATE__, __TIME__);
for (;;) {
unsigned char b;
while (uart_read_byte(&b) == 0) {
if (frame_feed(b)) {
handle_frame(s_fp.cmd, s_fp.data, s_fp.len);
}
}
/* 其它任务 */
}
}做到这一步,你就有了一个能长期使用、不会因为干扰而崩掉的通信通道,后续接传感器、接屏、接上位机都基于它扩展。