1. 在这颗 M0+ 上,我为什么把串口收发交给 LL 库:省掉的是句柄,不是顺序
手上这块 G030 的小板子只有 48 脚,主频被拉到 64MHz,串口另一头接上位机,帧长从 8 字节到 200 多字节不等,间隔也没规律。这套收发我最后是用 LL 库这个功能库搭起来的,而不是 HAL。HAL 那条路我也跑通过,DMA 加空闲中断能收能发,但一出问题就得顺着回调和句柄一层层往下扒,中断里那套状态机对 M0+ 来说偏重。换成 LL 之后,收发代码短了一半,中断服务函数里只剩几个标志位判断,延迟和可预期性都好了不少。反直觉的地方在于:LL 库不是 HAL 的精简版,它是寄存器操作的薄封装,省掉的正是句柄和状态机,代价是所有使能顺序、标志清除、DMAMUX 请求映射都得自己盯。它适合已经能翻参考手册、想把中断压短的场合,不适合还停在“能跑就行”的阶段。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 拆工程底座:从 .ioc、LL 驱动目录到 64MHz 时钟树
2.1 别急着编译,先看清每个文件在管什么
拿到工程包,我一般先不编译,而是对着目录把“谁是真相源、谁可以改、谁碰了就出事”过一遍。这一步看着像浪费时间,实际是把后面一半的排查工作提前做掉了:串口不出字的时候,你能立刻判断问题是在初始化代码里,还是在时钟、引脚这些更上游的地方。
| 文件或目录 | 作用 | 是否需要动 |
|---|---|---|
| STM32G030C8T6.ioc | CubeMX 工程配置,引脚、时钟、外设的原始状态都记录在这里 | 改动引脚和时钟时用 |
| Core/Src/main.c | 主循环、串口 DMA 的调用入口 | 业务代码一般写这里 |
| Core/Src/usart.c | USART1 初始化,波特率、字长、停止位都在这里 | 调波特率改这里 |
| Core/Src/dma.c | DMA1 通道初始化,DMAMUX 请求映射在这里 | 换通道改这里 |
| Drivers/STM32G0xx_LL_Driver | LL 库头文件和源码 | 不动 |
| Startup/startup_stm32g030xx.s | M0+ 启动文件,中断向量表 | 一般不动 |
| STM32G030C8TX_FLASH.ld | GCC 链接脚本,Flash/RAM 大小定义 | 不做内存裁剪时不改 |
这张表里我最在意三行。第一行是 .ioc,它是整份工程的唯一真相源,引脚复用号、时钟树、外设开关全在里面,代码里写的任何配置只要和它对不上,最后都会以“编译通过但功能不通”的形式还回来。第二行是 usart.c 和 dma.c,这两处是真正要改参数的地方,波特率在 usart.c,通道和请求在 dma.c,改的时候只改这两处,不要顺手去动 main.c 里的调用顺序。第三行是启动文件,中断向量表就在里面,中断服务函数的名字必须和向量表里登记的名字完全一致,名字差一个字母,函数写得再对也不会被调用——这是后面排查章节里反复出现的一条线索。
至于 Drivers/STM32G0xx_LL_Driver,它是这个功能库的本体,头文件里每个函数的参数含义都写得很清楚,遇到不确定的签名,直接翻头文件比搜二手笔记快。链接脚本 STM32G030C8TX_FLASH.ld 平时不用动,但如果你后面要给环形缓冲开大数组,先看一眼 RAM 余量,别把栈顶压到变量区上。
2.2 64MHz 是怎么凑出来的:HSI16 到 PLL 的三步换算
这块芯片的 SYSCLK 上限是 64MHz,而内部高速时钟 HSI16 只有 16MHz,中间必须过一次 PLL。G0 的 PLL 结构不复杂:输入先过一个 M 分频,再乘 N,最后过 R 分频送到系统时钟,写成公式就是 SYSCLK = 输入频率 / M × N / R。我惯用的组合是 M=1、N=8、R=2,16 × 8 / 2 正好 64MHz,这也是 CubeMX 里把时钟树拉到 64MHz 时最常见的落点。具体值以你 .ioc 里那一版为准,但换算关系值得自己推一遍,因为后面所有跟时间有关的东西——波特率、SysTick、超时判断——都挂在这个数上。
这里有个容易被忽略的依赖:串口的波特率寄存器不是直接写一个数,而是由外设时钟频率除以目标波特率算出来的。也就是说,PCLK 一变,BRR 就跟着变,你代码里写的 115200 只是“期望值”,真正决定波形的是传进去的那个时钟频率参数。所以顺序必须是先把时钟树钉死,再去配串口;反过来做,调完串口再动时钟,前面调的全白费。另一种情况更隐蔽:.ioc 里时钟是 64MHz,但工程里某次改动把 PLL 关掉了,系统退回 HSI16 跑,串口配置一个字没变,收到的数据却开始零星出错,看上去像“玄学干扰”,实际是时钟源换了。
另外还有两个配套动作不能漏。一个是 Flash 等待周期,64MHz 下 M0+ 的 Flash 撑不住零等待,得设成 2 个 latency,设少了会出现取指错误这类很难查的问题。另一个是总线分频,AHB 和 APB 都可以不分频,但如果你的外设对时序敏感,务必确认 .ioc 里 APB 的分频系数和你代码里 LL_RCC_SetAPB1Prescaler 写的一致,两边不一致的时候,代码是“按自己的理解”在算波特率。
2.3 用 LL 库把时钟配一遍,再自证
下面这段是我在 SystemClock_Config 里用的顺序,函数名都是 LL 库里的原始接口,参数按上面那组 64MHz 的组合填:
c复制/* 1. 打开 HSI16,并等它稳定 */
LL_RCC_HSI_Enable();
while (LL_RCC_HSI_IsReady() != 1) { }
/* 2. 配置 PLL:源选 HSI16,M=1,N=8,R=2 -> 16MHz * 8 / 2 = 64MHz */
LL_RCC_PLL_ConfigDomain_SYS(LL_RCC_PLLSOURCE_HSI,
LL_RCC_PLLM_DIV_1,
8,
LL_RCC_PLLR_DIV_2);
/* 3. 打开 PLL 和它的系统时钟域,等锁定 */
LL_RCC_PLL_Enable();
LL_RCC_PLL_EnableDomain_SYS();
while (LL_RCC_PLL_IsReady() != 1) { }
/* 4. 先把 Flash 等待周期提到 2,再切系统时钟 */
LL_FLASH_SetLatency(LL_FLASH_LATENCY_2);
LL_RCC_SetSysClkSource(LL_RCC_SYS_CLKSOURCE_PLL);
while (LL_RCC_GetSysClkSource() != LL_RCC_SYS_CLKSOURCE_STATUS_PLL) { }
/* 5. 设总线分频,这里 AHB / APB 都不分频 */
LL_RCC_SetAHBPrescaler(LL_RCC_SYSCLK_DIV_1);
LL_RCC_SetAPB1Prescaler(LL_RCC_SYSCLK_DIV_1);
/* 6. 让库内部的 SystemCoreClock 变量跟上真实频率 */
SystemCoreClockUpdate();
几个参数值得单独说。LL_RCC_PLLM_DIV_1 和 LL_RCC_PLLR_DIV_2 是枚举而不是数字,别图省事直接写 1 和 2,头文件里这两组枚举的取值不一定等于你想象中的数值。LL_FLASH_SetLatency 必须放在切时钟之前,顺序反了就是拿 64MHz 去跑 0 等待的 Flash。最后那句 SystemCoreClockUpdate() 不是可选项,库内部很多延时和波特率计算都读 SystemCoreClock 这个变量,不更新它,代码会以为你还在 16MHz 上跑。
配完得自证,不能只看编译通过。我最常用的土办法是拿 SysTick 数一秒翻转一次 GPIO,用逻辑分析仪或者示波器看方波周期,1Hz 就说明 64MHz 落地了;没有仪器就退一步,用串口按 115200 发一串固定字符,上位机收到不乱码,基本也能说明时钟和波特率对得上。这一步花五分钟,能省掉后面半小时的“到底是时钟问题还是串口问题”。
3. 搭收发通道:USART1 参数、DMAMUX 请求和启动顺序
3.1 引脚复用与 USART 参数:三处必须和 .ioc 对齐
引脚这一块,我踩过最没技术含量但也最费时间的坑:照着别的系列的记忆去填复用号。G0 的复用编号和 F1、F4 不是一套,正确做法是打开 .ioc 的引脚预览,看它给 USART1 分配的是哪两个脚、哪个 AF 号,然后原样抄进代码。下面这段就是按 .ioc 抄下来的结果,AF 号那一行我特意留了注释:
c复制/* GPIO 复用:具体 AF 号以 .ioc 的引脚预览为准,不要凭系列记忆填 */
LL_GPIO_InitTypeDef gpio = {0};
LL_GPIO_StructInit(&gpio);
gpio.Pin = LL_GPIO_PIN_9 | LL_GPIO_PIN_10;
gpio.Mode = LL_GPIO_MODE_ALTERNATE;
gpio.Speed = LL_GPIO_SPEED_FREQ_HIGH;
gpio.OutputType = LL_GPIO_OUTPUT_PUSHPULL;
gpio.Pull = LL_GPIO_PULL_UP;
gpio.AlternateFunction = LL_GPIO_AF_1; /* 抄 .ioc,别凭记忆 */
LL_GPIO_Init(GPIOA, &gpio);
/* 时钟门:GPIO 走 IOP,USART1 走 APB2,DMA1 走 AHB1 */
LL_IOP_GRP1_EnableClock(LL_IOP_GRP1_PERIPH_GPIOA);
LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_USART1);
LL_AHB1_GRP1_EnableClock(LL_AHB1_GRP1_PERIPH_DMA1);
三行时钟门对应三个不同的总线,这一点在 G0 上和别的系列差别挺大:GPIO 的时钟挂在 IOP 上,不是 AHB1;USART1 挂在 APB2 上;DMA1 挂在 AHB1 上。开错门的表现是“寄存器写进去了但外设没反应”,非常像代码没生效。参数上,Pull 我习惯给接收脚上拉,线悬空的时候不至于收到一堆乱码;Speed 给到 HIGH,115200 其实用不着,但高波特率下省得回头再改。
USART 本身的参数按下面这组填,标准 8N1、无流控、16 倍过采样:
c复制LL_USART_InitTypeDef usart = {0};
LL_USART_StructInit(&usart);
usart.BaudRate = 115200;
usart.DataWidth = LL_USART_DATAWIDTH_8B;
usart.StopBits = LL_USART_STOPBITS_1;
usart.Parity = LL_USART_PARITY_NONE;
usart.TransferDirection = LL_USART_DIRECTION_TX_RX;
usart.HardwareFlowControl = LL_USART_HWCONTROL_NONE;
usart.OverSampling = LL_USART_OVERSAMPLING_16;
LL_USART_Init(USART1, &usart);
/* 关键:把真实的 PCLK 传进去,库内部据此算 BRR */
LL_USART_SetBaudRate(USART1, 64000000, LL_USART_OVERSAMPLING_16, 115200);
LL_USART_SetBaudRate 的第二个参数是外设时钟频率,这里填的 64000000 必须等于你第 2 章里实际配出来的 PCLK。这个值填错了不会报错,只会让波形整体偏移,表现是“低波特率勉强能收、高波特率全是错码”。OverSampling 选 16 倍是稳妥做法,它对时钟误差的容忍度更高;8 倍过采样能跑更高波特率,但对时钟精度要求更严,这颗芯片上我没必要冒那个险。
3.2 DMAMUX 请求映射:通道是搬运工,请求才是信号源
G0 的 DMA 和更老的系列不一样,它多了一层 DMAMUX。可以这么理解:DMA 通道是一个搬运工,但搬运工不知道什么时候该搬,得有人在旁边喊号子,DMAMUX 就是那个把外设信号接到某个通道上的交换机。所以配置分成两件事——把通道的地址、宽度、长度配好,再把通道和具体请求绑起来。少做第二步,通道使能了也不会动,这是新手最容易卡住的地方。
接收方向的初始化如下,通道号按 .ioc 里分配的来,例子里是通道 2:
c复制#define RX_BUF_SIZE 64
static uint8_t dma_rx_buf[RX_BUF_SIZE];
LL_DMA_InitTypeDef dma = {0};
LL_DMA_StructInit(&dma);
dma.PeriphOrM2MSrcAddress = (uint32_t)&USART1->RDR; /* 源:串口数据寄存器 */
dma.MemoryOrM2MDstAddress = (uint32_t)dma_rx_buf; /* 目的:本地缓冲 */
dma.Direction = LL_DMA_DIRECTION_PERIPH_TO_MEMORY;
dma.Mode = LL_DMA_MODE_CIRCULAR; /* 循环模式,收满自动回卷 */
dma.PeriphOrM2MSrcIncMode = LL_DMA_PERIPH_NOINCREMENT; /* 外设地址固定 */
dma.MemoryOrM2MDstIncMode = LL_DMA_MEMORY_INCREMENT; /* 内存地址递增 */
dma.PeriphOrM2MSrcDataSize = LL_DMA_PDATAALIGN_BYTE;
dma.MemoryOrM2MDstDataSize = LL_DMA_MDATAALIGN_BYTE;
dma.NbData = RX_BUF_SIZE;
dma.Priority = LL_DMA_PRIORITY_HIGH;
LL_DMA_Init(DMA1, LL_DMA_CHANNEL_2, &dma);
/* 第二步不能漏:把通道和 DMAMUX 请求绑在一起 */
LL_DMA_SetPeriphRequest(DMA1, LL_DMA_CHANNEL_2, LL_DMAMUX_REQ_USART1_RX);
几个参数的选择理由:Mode 用循环模式,是因为串口收包是连续不断的,定长模式收满一次就停,还得在中断里重新装填,多一次出错机会。PeriphOrM2MSrcDataSize 和 MemoryOrM2MDstDataSize 都设成 BYTE,串口是按字节来的,设成半字会直接把数据切错。NbData 就是缓冲长度,这个数不是随便定的,它决定了“一包最长能有多长”,超过这个长度的帧会在循环模式下被覆盖,所以 RX_BUF_SIZE 要照着你实际最大帧长往上留一截。
发送方向的配置基本对称,方向反过来,外设地址换成 &USART1->TDR,并且内存地址递增要打开。发送用普通模式就够了,发完一次装填一次,不需要循环。
3.3 启动序列:为什么 USART 要最后使能
初始化写完之后,真正的坑在“什么时候使能什么”。我见过也自己写错过的一种顺序是先 LL_USART_Enable,再去开 DMA 请求和 IDLE 中断,结果上电后第一包数据就丢了,或者 IDLE 标志在配置期间已经被置起来,中断一开就立刻进一次,进去发现没有数据。正确的顺序是自下而上,最后才把 USART 放出来:
c复制/* 1. 先清一次历史标志,避免带病启动 */
LL_USART_ClearFlag_IDLE(USART1);
/* 2. 开 DMA 通道(可选同时开传输完成中断) */
LL_DMA_EnableIT_TC(DMA1, LL_DMA_CHANNEL_2);
LL_DMA_EnableChannel(DMA1, LL_DMA_CHANNEL_2);
/* 3. 把 USART 的 DMA 收发请求打开 */
LL_USART_EnableDMAReq_RX(USART1);
LL_USART_EnableDMAReq_TX(USART1);
/* 4. 打开 IDLE 中断 */
LL_USART_EnableIT_IDLE(USART1);
/* 5. 配 NVIC,最后再使能 USART */
NVIC_SetPriority(USART1_IRQn, 1);
NVIC_EnableIRQ(USART1_IRQn);
LL_USART_Enable(USART1);
顺序背后的逻辑很简单:只要 USART 还没使能,它就不会产生任何标志;一旦使能,线上任何一个空闲电平跳变都可能立刻置起 IDLE。所以“清标志”和“开中断”要放在使能之前,让中断系统从一个干净状态开始。NVIC 优先级给 1 是比较中间的位置,如果你的工程里还有定时器中断要抢实时性,把串口放到更低优先级,避免它在高波特率下长时间占着 CPU。
还有一处容易漏:LL_USART_EnableDMAReq_TX 只有在你要用 DMA 发送时才需要打开。只用中断发送的话,这一行留着不影响功能,但会让发送寄存器空标志的行为变得不那么直观,排查时容易误判。
4. 用 IDLE 中断收变长帧:清除顺序、长度换算与环形缓冲
4.1 为什么 IDLE 比定长 DMA 更适合变长帧
定长 DMA 的思路是“我假定每包 32 字节”,收满 32 字节触发一次传输完成中断。这套在协议固定的场合很好用,但上位机发的是命令行,短的时候十来个字节,长的时候两百多,定长方案要么收不满一直等,要么收多了把下一包的头切掉。IDLE 中断补的正是这个缺口:串口线上连续一段时间没有新数据,硬件就会置起空闲标志,你在这个时刻把 DMA 已经搬了多少字节读出来,就是这一包的真实长度。
这里的换算关系要记牢:DMA 的计数器是“还剩多少没搬”,所以 本包长度 = 缓冲总长 - 剩余量。循环模式下这个剩余量会在收满一圈后回卷,所以长度算出来永远落在 0 到 RX_BUF_SIZE 之间,超过缓冲长度的帧会被悄悄截断——这是设计上的取舍,不是 bug,但如果你不知道,就会在测长帧的时候怀疑人生。
4.2 中断服务函数里的清除顺序
中断里的动作顺序,是我认为整套方案里最需要写死的地方。顺序错了不会编译报错,只会在压力测试的时候偶发丢包,属于典型的“血泪经验”:
c复制void USART1_IRQHandler(void)
{
/* 1. 先处理空闲:取长度 -> 停通道 -> 搬数据 -> 重装 -> 再开通道 */
if (LL_USART_IsActiveFlag_IDLE(USART1))
{
uint16_t remain = LL_DMA_GetDataLength(DMA1, LL_DMA_CHANNEL_2);
uint16_t len = RX_BUF_SIZE - remain;
LL_DMA_DisableChannel(DMA1, LL_DMA_CHANNEL_2);
ring_push(dma_rx_buf, len); /* 交给环形缓冲 */
LL_DMA_SetDataLength(DMA1, LL_DMA_CHANNEL_2, RX_BUF_SIZE);
LL_DMA_EnableChannel(DMA1, LL_DMA_CHANNEL_2);
LL_USART_ClearFlag_IDLE(USART1); /* 最后清 */
}
/* 2. 溢出错误必须处理,否则接收会卡死 */
if (LL_USART_IsActiveFlag_ORE(USART1))
{
LL_USART_ClearFlag_ORE(USART1);
}
/* 3. 发送侧如果用中断,在这里补 TXE 的处理 */
}
几个细节单独解释。LL_DMA_GetDataLength 必须在停通道之前读,读和停之间如果还有数据进来,长度就会偏小;反过来先停再读,是更稳的做法,代价是可能丢掉停的那一瞬间到达的几个字节。我选的是先读后停,因为这个窗口只有几个时钟周期,实际影响远小于先停后读带来的“最后一字节丢失”。搬完数据后要重新 LL_DMA_SetDataLength 再使能通道,循环模式下虽然会自动回卷,但显式重装一次能让计数器回到已知状态,排查时心里有底。
LL_USART_ClearFlag_IDLE 放在最后,是因为清标志的动作本身可能和其他标志位有交互,先清再搬数据的话,搬的过程中如果又来一包,这一次中断就白进了。至于 ORE,很多人不写这一段,正常情况确实很少触发,但只要发生过一次溢出没清,接收就会彻底停住,现象是“串口突然死了,复位才好”。
4.3 环形缓冲:把中断里的搬运和主循环解耦
中断里最忌讳做长活。把 DMA 缓冲里的数据直接扔给协议解析,解析一慢就影响下一包接收,所以中间要垫一层环形缓冲。我用的结构很朴素,一个数组加头尾两个下标:
c复制#define RING_SIZE 512
static uint8_t ring_buf[RING_SIZE];
static volatile uint16_t ring_head = 0; /* 中断里写 */
static volatile uint16_t ring_tail = 0; /* 主循环里读 */
/* 中断上下文调用:把一段数据塞进环形缓冲 */
static void ring_push(const uint8_t *src, uint16_t len)
{
for (uint16_t i = 0; i < len; i++)
{
uint16_t next = (ring_head + 1) % RING_SIZE;
if (next == ring_tail) /* 满了就丢最老的,别覆盖未读数据 */
{
ring_tail = (ring_tail + 1) % RING_SIZE;
}
ring_buf[ring_head] = src[i];
ring_head = next;
}
}
ring_head 和 ring_tail 都加了 volatile,因为一个在中断里改、一个在主循环里改,不加优化器会把判断优化掉。满的时候我选择丢最老的而不是阻塞,串口这种流式数据,丢一帧旧命令比卡死整个接收循环要好。主循环侧只需要判断 ring_head != ring_tail 就取一个字节,取完推进 ring_tail,两边完全不共享锁。
缓冲大小 512 是按最坏情况估的:上位机连发三条 200 字节的命令,加上主循环一次解析的耗时,512 够周转。这个数没有标准答案,估算方法是“最大帧长 × 2 + 主循环单次处理时间内可能到达的字节数”,宁大勿小,RAM 够的话翻倍也不心疼。
5. 排查清单:串口一个字不出、DMA 不搬数、IDLE 反复进中断的五种真因
5.1 现象:编译通过,串口一个字节都不输出
原因通常在三层里的某一层断掉了:时钟门没开、引脚复用号填错、或者 USART 根本没使能。LL 库的好处是每一层都能单独验证——先量引脚,用万用表测 TX 脚对地电压,如果一直是 0 或者悬空,说明 GPIO 那层就没通;再用调试器看 USART1->CR1 里的使能位,没置起来就是初始化漏了最后一句 LL_USART_Enable。
解决顺序我固定成三步:先确认 LL_APB2_GRP1_EnableClock 这一句真的执行到了(有时候被前面的 return 提前跳过),再确认 .ioc 里的复用号和代码里写的一致,最后确认 LL_USART_Enable 在初始化末尾。这三步走完还不出字,才去怀疑硬件焊接。
5.2 现象:DMA 通道使能了,计数器一动不动
这是 DMAMUX 那层没接上。G0 的通道只是一个搬运工,请求信号必须由 LL_DMA_SetPeriphRequest 明确绑过去,而且在循环模式下,通道使能之前就得绑好。另一个常见原因是 DMA1 的时钟没开,LL_AHB1_GRP1_EnableClock(LL_AHB1_GRP1_PERIPH_DMA1) 这一句漏掉的话,寄存器写得进去但不会真正生效,看上去就像通道“假使能”。
解决上我一般直接看两个地方:LL_DMA_GetDataLength 的值有没有随数据减少,以及通道配置寄存器里请求号是不是你期望的那个。前者不动就查时钟门,后者不对就查 SetPeriphRequest 的参数,注意请求枚举是 LL_DMAMUX_REQ_USART1_RX 而不是 LL_DMAMUX_REQ_USART1_TX,收发搞反是很常见的一处笔误。
5.3 现象:只收到第一包,后面彻底没反应
大概率是 IDLE 标志没有清,或者清除的时机
