2026/9/16 14:45:34
FEATURED · 精选文章 
简介蓝桥杯嵌入式竞赛的STM32G431RBT6程序源码与项目说明包主要面向准备蓝桥杯赛项的选手及电子信息、计算机相关专业学生可作为课程设计或毕设参考。资源整体可直接运行但要求读者能看懂代码、自行调试压缩包共两千个文件以一千零一十五个头文件和六百九十三个C语言源文件为主体涵盖硬件抽象层库驱动、应用逻辑与工程配置。另含工程配置文件、十六进制烧写文件、调试映像文件、链接映像文件及说明文档等便于在集成开发环境中编译、烧录与排错包体约一百一十六点八一兆字节目录按模块划分便于查找。已有八百五十四人学习下载具备一定参考热度。作者提供完整源码和项目说明可对照理解微控制器外设配置、蓝桥杯赛题实现思路及从工程搭建到功能调试的完整流程适合借鉴并在此之上扩展调试。1. G431RBT6 这颗主控为什么撑得起蓝桥杯嵌入式源码包蓝桥杯嵌入式赛道换用 STM32G431RBT6 之后“程序源码项目说明.zip”基本成了每次备赛绕不开的资源。这份压缩包乍看像一份现成答案实际是一套“硬件、工程、文档”配套好的模板主控芯片选型、CubeMX 初始化、按键扫描、ADC 采集、PWM 输出、串口上报、LCD 显示全都被串在一条主循环里。G431RBT6 是 Cortex-M4F 内核、最高 170MHz带硬浮点 FPU片上两个 12 位 ADC 支持硬件过采样定时器、串口、SPI、FDCAN 都齐全。所以它的工程比 F103 时代更有“嵌入式正规军”的味道。真正拉开差距的不是抄不抄得到代码而是你能不能对着项目说明里的原理图把每个外设引脚和软件里的句柄对起来。对熟悉这块板子的人来说这份源码不过是嵌入式学习路线上一个高效率的中间站。2. 复现 G431RBT6 源码前先建一个 170MHz 的最小工程2.1 上电默认只有 4MHz时钟树是第一道门槛STM32G431RBT6 上电后默认走 MSI 内部时钟典型频率只有 4MHz 左右。也就是说新板子拿回来直接下载一个点灯程序灯能亮但一旦涉及串口波特率、定时器 PWM、ADC 采样率全部会差出一个数量级。问题几乎不在代码逻辑而在 CubeMX 的项目里根本没把时钟树配到 170MHz。我一般拿到任何 G431RBT6 工程第一件事是打开.ioc文件查 RCC 配置。常见做法是把 PLL Source 选为 HSI16然后参数值作用PLLM2把 16MHz 分频到 8MHzPLLN858MHz 倍频到 170MHzPLLR2作为 SYSCLK 的最终分频SYSCLK170MHzCPU 内核时钟如果板子上有外部晶振也可以把 PLL Source 换成 HSE再重算 PLLM/N/R。要确认是否真正生效最直接的办法是看 CubeMX 时钟树页面里 SYSCLK 是不是 170.0MHz。很多源码包跑起来怪怪的都是因为这里被改回了 16MHz 或者 64MHz。2.2 解压时先校验文件再看目录结构拿到“程序源码项目说明.zip”这类压缩包我建议先算一遍 SHA256再解压。Windows 自带命令就能做certutil -hashfile 蓝桥杯嵌入式STM32G431RBT6程序源码项目说明.zip SHA256在 Linux 或 WSL 下则用 sha256sum。校验的目的不是防篡改而是确认压缩包完整避免解压到一半出现工程文件损坏Keil 打开后疯狂报缺文件。解压到纯英文路径例如D:\G431_Project。中文路径或带空格的路径会导致 Keil MDK 的 UVProj 工程文件偶尔找不到头文件还可能让 J-Link 下载时工作目录异常。解压后先看根目录一般会有四种文件文件类型作用.ioc工程配置引脚、时钟、外设参数全在这里MDK-ARM 目录Keil 工程文件直接双击打开App或User目录主逻辑、状态机、业务代码项目说明文档引脚映射、外设要求、评分要点2.3 最小 main 函数先把板子点亮不要急着读完整源码先确认工具链和板卡是通的。我习惯在 CubeMX 里配好一个最小工程然后只做一件事翻转 LED。以下是 main 循环里的关键部分int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); while (1) { HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); HAL_Delay(500); } }HAL_GPIO_TogglePin直接翻转引脚输出电平不需要先读再写HAL_Delay基于 SysTick前提是HAL_Init()已经跑过且时钟树配置正确。如果这里灯闪得很快或极慢不用怀疑代码回 2.1 检查 SYSCLK。这个最小工程就是后续所有外设调试的底。2.3.1 Keil 工程里千万别漏开 FPUG431RBT6 是 M4F有单精度浮点单元。CubeMX 默认会把 FPU 在启动文件里打开但 Keil MDK 的 C/C 选项里还必须在 Floating Point Hardware 一栏选择 Single Precision。漏掉这一步代码里只要出现float运算跑起来就是 HardFault。蓝桥杯真题里处理电压值、温度值经常会用到浮点显示这个开关直接影响程序能不能过测试点。3. 把程序源码拆成 bsp 层和中断层G431RBT6 的工程骨架3.1 项目说明文档里先看这三样东西拿到项目说明后不要急着看代码。常见做法是先找三样内容引脚分配表、模块接线图、已知问题清单。引脚分配表解决“这个 GPIO 对应板子上哪个按键”模块接线图解决“ADC 通道到底接在哪颗电位器上”已知问题则避免你踩前人已经写进文档里的坑。很多嵌入式开源项目也是这种组织方式一个外设一个驱动文件应用逻辑单独放。这样工程的主线永远是 main 里的初始化序列加一个主循环调度器。下面是一份典型目录结构G431_Project/ ├── Core/ │ ├── Inc/ │ └── Src/ │ ├── main.c │ └── stm32g4xx_it.c ├── bsp/ │ ├── bsp_led.c │ ├── bsp_key.c │ ├── bsp_adc.c │ └── bsp_uart.c ├── Doc/ │ └── 项目说明.md └── MDK-ARM/Core/Src里是 CubeMX 生成的基础代码和中断服务函数bsp目录是手写的板级驱动每个文件对应一个外设Doc放项目说明。看到这个结构就知道作者是想把 HAL 库产生的初始化逻辑和具体业务解耦。3.2 用嵌入式 C 语言的事件标志位组织按键扫描按键扫描是这套源码里最值得细读的部分。很多初学者把按键检测放在中断里然后在中断里延时消抖这在大赛板上一旦加上 LCD 刷新就会出现按键失灵。常见做法是主循环 5ms 到 20ms 周期性扫描一次按键用两级电平加时间戳做消抖再通过事件标志位通知业务逻辑。#define KEY_PIN GPIO_PIN_0 #define KEY_GPIO_PORT GPIOA #define DEBOUNCE_TICKS 5 static uint8_t raw_level; // 当前读取到的电平 static uint8_t stable_level; // 消抖后的稳定电平 static uint32_t last_tick; // 上次电平跳变的时刻 volatile uint8_t key_event; // 0无事件1短按 void BSP_Key_Scan(void) { uint8_t level (HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_PIN) GPIO_PIN_RESET) ? 1 : 0; uint32_t now HAL_GetTick(); if (level ! raw_level) { raw_level level; last_tick now; return; } if ((level ! stable_level) (now - last_tick DEBOUNCE_TICKS)) { stable_level level; if (stable_level 1) { key_event 1; // 低电平有效按下瞬间产生事件 } } }raw_level保存最新读取的物理电平只要电平变化就重置时间戳不做任何判断只有电平连续稳定超过DEBOUNCE_TICKS毫秒才更新stable_level。主循环里只需判断key_event是否为 1处理后立刻清零。这里要注意key_event会被中断函数或主循环之外的代码读写必须用volatile修饰否则编译器可能把这个变量优化进寄存器导致事件丢失。3.3 中断里只做一件事置标志G431RBT6 的 HAL 库工程中中断服务函数集中在stm32g4xx_it.c。新手最常犯的错误是在中断回调里直接调用HAL_UART_Transmit发串口或者在回调里HAL_Delay。中断里跑长时间的阻塞函数轻则丢中断重则卡死主循环。正确姿势是中断里只置位标志把实际处理放回主循环。extern volatile uint8_t uart_rx_done; extern volatile uint8_t uart_rx_data; void USART1_IRQHandler(void) { if (USART1-ISR USART_ISR_RXNE) { uart_rx_data USART1-RDR 0xFF; uart_rx_done 1; } }这段示例里直接操作寄存器读RDR比调用HAL_UART_Receive_IT更直白也省去了回调函数里的句柄判断。参数说明USART1-ISR是状态寄存器RXNE位表示接收数据寄存器已满读RDR会自动清除该位不需要手动写清除。中断优先级分组常用 NVIC 默认配置抢占优先级 0 到 3其中 SysTick 和耗时外设尽量分配不同组。外设中断抢占优先级说明SysTick0最优先保证 HAL_Delay 准确USART11接收数据只置标志TIM22定时采集或 PWM 相关这个优先级表不是绝对的但原则是越不能被阻塞的中断优先级越高。把 SysTick 放最高才能保证HAL_GetTick()在按键消抖里稳定工作。4. G431RBT6 真题外设组合ADC、PWM、串口与 LCD 的参数表4.1 ADC 采集电位器电压先校准再采样最近几届蓝桥杯嵌入式真题基本都绕不开“采集、显示、上报”这个组合。ADC 采集电位器电压换算成实际电压值显示在 LCD 上同时通过串口发送到上位机。G431RBT6 的 ADC 是 12 位最大采样率 2.5Msps支持硬件过采样配置起来比 F103 要复杂一点。在 CubeMX 里开 ADC1选择一个通道比如电位器接在 PA0 对应的通道。注意具体通道号必须以后面的项目说明书和板卡丝印为准同一片 G431RBT6 在不同竞赛板上的引脚映射可能不同。初始化完成后启动 ADC 前要先做校准HAL_ADCEx_Calibration_Start(hadc1, ADC_SINGLE_ENDED); HAL_ADC_Start(hadc1); HAL_ADC_PollForConversion(hadc1, 10); uint16_t adc_val HAL_ADC_GetValue(hadc1); float voltage adc_val * 3.3f / 4095.0f;HAL_ADCEx_Calibration_Start是 G4 系列独有的校准接口必须在单次采样之前调用第二个参数ADC_SINGLE_ENDED表示单端输入。换算公式里分母 4095 对应 12 位 ADC 的最大值3.3f是参考电压。G431RBT6 有 FPU直接用浮点不会对性能造成压力但要注意voltage后面的运算如果多次使用尽量一次算完避免重复转换。采样时间参数同样关键。CubeMX 里 ADC Sampling Time 选 2.5 到 92.5 cycles 不等。信号源阻抗高、走线长时采样时间要放到 47.5 cycles 以上否则电压读数会偏低。遇到过不少人读出的 ADC 值整体偏差 30mV 以上基本都是这里偷懒用了最小的 1.5 cycles。4.2 PWM 输出频率先算好再填 PSC 和 ARRPWM 输出是真题里控制电机、蜂鸣器、调光的标配。G431RBT6 的定时器资源丰富TIM1、TIM8 是高级定时器TIM2、TIM3、TIM4 是通用定时器。选哪个定时器要看 CubeMX 的时钟树里该 TIM 挂在 APB1 还是 APB2。不同分频系数会让定时器时钟不是简单的 170MHz。通用公式是PWM频率 timer_clk / ((PSC 1) * (ARR 1))例如想在 TIM3 上产生 10kHz PWM如果 timer_clk 是 170MHz可以取 PSC169这样计数时钟是 1MHz再取 ARR99输出就是 10kHz。如果是 85MHz 的定时器时钟同样的参数输出 5kHz所以填参数前先确认timer_clk。TIM3-PSC 169; TIM3-ARR 99; TIM3-CCR1 30; // 占空比约 30% TIM3-CCMR1 (TIM3-CCMR1 ~TIM_CCMR1_OC1M_Msk) | TIM_CCMR1_OC1M_1 | TIM_CCMR1_OC1M_2; TIM3-CCER | TIM_CCER_CC1E; TIM3-CR1 | TIM_CR1_CEN;这段寄存器操作把 TIM3 配置成 PWM 模式 1OC1M位段设置为 110即 PWM 模式 1计数到 CCR1 输出有效电平。CC1E使能通道输出CEN启动计数器。实际工程中直接在 CubeMX 里配置好再用__HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, 30)改占空比更稳妥寄存器版本适合调试时快速确认底层行为。PSC 和 ARR 都是 16 位寄存器最大值 65535。如果需要极低频率比如 1Hz 慢闪就要把 PSC 拉高或者改用 TIM2 这类带更大预分频能力的定时器方案。这是嵌入式八股文里常考的溢出计算题放到真实项目里就是“LED 不闪”和“电机转速对不上”的排查方向。4.3 串口配置printf 重定向的两种路线串口上报数值最快速的调试方式是直接把 printf 映射到 USART。G431RBT6 的 USART1 默认挂在 PA9/PA10CubeMX 里配成 Asynchronous波特率 115200、8-N-1。然后需要自己实现字符发送接口。GCC 工具链STM32CubeIDE 等下的实现#include stdio.h int __io_putchar(int ch) { uint8_t c (uint8_t)ch; HAL_UART_Transmit(huart1, c, 1, 10); return ch; } int _write(int fd, char *ptr, int len) { for (int i 0; i len; i) { if (__io_putchar((uint8_t)ptr[i]) EOF) { return i; } } return len; }_write是 syscall 的底层接口printf 最终会调用它把缓冲区逐字节发出去第四个参数 10 是超时毫秒数串口空闲时 1 字节只占不到 0.1ms10ms 足够。Keil MDK 用户则通常勾选 Use MicroLIB再用 fputc 实现同样的逻辑这时因为全部走库函数代码更短。注意如果串口发送在中断回调里调用printf超时参数很容易被拖满进而影响实时性。串口打印适合放在主循环的状态机里不适合压到中断里高频输出。4.4 LCD 显示数值缓冲区大小和格式串LCD 显示 float 类型最省事的写法是char buf[16]; sprintf(buf, %.2fV, voltage); LCD_DisplayStringLine(Line4, buf);有两个点都容易踩。一是缓冲区大小sprintf不检查长度浮点加单位很容易超 12 字节要留余量二是.2f会做四舍五入如果题目要求的是“截断到小数点后两位”就要先用(int)(voltage * 100)拆出整数和小数再拼字符串。LCD 驱动如果是 SPI 接口刷新一次整屏要几十毫秒全局刷新的频率别超过 20Hz否则主循环会被拖死。5. G431RBT6 源码烧进去之后用这 4 个检查点验证5.1 检查点一时钟树是否真的跑在 170MHz烧录后第一步接调试器或者用 J-Link RTT看SystemCoreClock变量。这个变量在 system_stm32g4xx.c 里维护标准值是 170000000。如果读到的是 16000000说明.ioc里时钟配置被改过或者SystemClock_Config()里手动设置的 PLL 参数不对直接回到第 2 章的表格重算。5.2 检查点二串口回环测试把 USART 的 TX 和 RX 用杜邦线短接然后执行一段回环代码HAL_UART_Transmit(huart1, (uint8_t*)OK\r\n, 5, 100); HAL_UART_Receive(huart1, rx_byte, 1, 100);如果串口助手能收到 OK 而收不到回环数据多半是 RX 引脚映射或者中断里没读RDR导致数据滞留。用逻辑分析仪抓 PA9/PA10能直接确认波形有没有发出来比盯着串口助手猜快得多。5.3 检查点三HAL_Delay 卡死和变量被优化程序运行一段时间后卡死最常见两个原因一是在中断里调用HAL_DelaySysTick 被同级或更高优先级中断抢占永远回不来二是共享变量没加volatile主循环读了旧值。解决方案很简单中断里只置标志位标志位统一加volatile修饰串口、ADC 这类句柄则保持 HAL 库生成的原始类型即可。5.4 检查点四改动最小化对比 .ioc 差异从压缩包源码改成自己的真题实现时每次改动都只动一个bsp_xxx.c文件不要顺手改stm32g4xx_it.c的结构。想回顾自己改了什么直接对比.iocgit diff --no-index backup/工程.ioc 当前/工程.ioc.ioc文件是纯文本Git 能直接做差异对比。看驱动配置的改动比看代码改动更直观。最后一个小技巧调试 PWM 和 ADC 时保证采集端的杜邦线别超过 10cm否则引线电感会让 ADC 读数跳动、PWM 波形边缘出现明显振铃。把线剪短很多“硬件问题”会直接消失。本文还有配套的精品资源点击获取
STM32G431RBT6嵌入式开发：源码包拆解与时钟、外设配置实战
简介蓝桥杯嵌入式竞赛的STM32G431RBT6程序源码与项目说明包主要面向准备蓝桥杯赛项的选手及电子信息、计算机相关专业学生可作为课程设计或毕设参考。资源整体可直接运行但要求读者能看懂代码、自行调试压缩包共两千个文件以一千零一十五个头文件和六百九十三个C语言源文件为主体涵盖硬件抽象层库驱动、应用逻辑与工程配置。另含工程配置文件、十六进制烧写文件、调试映像文件、链接映像文件及说明文档等便于在集成开发环境中编译、烧录与排错包体约一百一十六点八一兆字节目录按模块划分便于查找。已有八百五十四人学习下载具备一定参考热度。作者提供完整源码和项目说明可对照理解微控制器外设配置、蓝桥杯赛题实现思路及从工程搭建到功能调试的完整流程适合借鉴并在此之上扩展调试。1. G431RBT6 这颗主控为什么撑得起蓝桥杯嵌入式源码包蓝桥杯嵌入式赛道换用 STM32G431RBT6 之后“程序源码项目说明.zip”基本成了每次备赛绕不开的资源。这份压缩包乍看像一份现成答案实际是一套“硬件、工程、文档”配套好的模板主控芯片选型、CubeMX 初始化、按键扫描、ADC 采集、PWM 输出、串口上报、LCD 显示全都被串在一条主循环里。G431RBT6 是 Cortex-M4F 内核、最高 170MHz带硬浮点 FPU片上两个 12 位 ADC 支持硬件过采样定时器、串口、SPI、FDCAN 都齐全。所以它的工程比 F103 时代更有“嵌入式正规军”的味道。真正拉开差距的不是抄不抄得到代码而是你能不能对着项目说明里的原理图把每个外设引脚和软件里的句柄对起来。对熟悉这块板子的人来说这份源码不过是嵌入式学习路线上一个高效率的中间站。2. 复现 G431RBT6 源码前先建一个 170MHz 的最小工程2.1 上电默认只有 4MHz时钟树是第一道门槛STM32G431RBT6 上电后默认走 MSI 内部时钟典型频率只有 4MHz 左右。也就是说新板子拿回来直接下载一个点灯程序灯能亮但一旦涉及串口波特率、定时器 PWM、ADC 采样率全部会差出一个数量级。问题几乎不在代码逻辑而在 CubeMX 的项目里根本没把时钟树配到 170MHz。我一般拿到任何 G431RBT6 工程第一件事是打开.ioc文件查 RCC 配置。常见做法是把 PLL Source 选为 HSI16然后参数值作用PLLM2把 16MHz 分频到 8MHzPLLN858MHz 倍频到 170MHzPLLR2作为 SYSCLK 的最终分频SYSCLK170MHzCPU 内核时钟如果板子上有外部晶振也可以把 PLL Source 换成 HSE再重算 PLLM/N/R。要确认是否真正生效最直接的办法是看 CubeMX 时钟树页面里 SYSCLK 是不是 170.0MHz。很多源码包跑起来怪怪的都是因为这里被改回了 16MHz 或者 64MHz。2.2 解压时先校验文件再看目录结构拿到“程序源码项目说明.zip”这类压缩包我建议先算一遍 SHA256再解压。Windows 自带命令就能做certutil -hashfile 蓝桥杯嵌入式STM32G431RBT6程序源码项目说明.zip SHA256在 Linux 或 WSL 下则用 sha256sum。校验的目的不是防篡改而是确认压缩包完整避免解压到一半出现工程文件损坏Keil 打开后疯狂报缺文件。解压到纯英文路径例如D:\G431_Project。中文路径或带空格的路径会导致 Keil MDK 的 UVProj 工程文件偶尔找不到头文件还可能让 J-Link 下载时工作目录异常。解压后先看根目录一般会有四种文件文件类型作用.ioc工程配置引脚、时钟、外设参数全在这里MDK-ARM 目录Keil 工程文件直接双击打开App或User目录主逻辑、状态机、业务代码项目说明文档引脚映射、外设要求、评分要点2.3 最小 main 函数先把板子点亮不要急着读完整源码先确认工具链和板卡是通的。我习惯在 CubeMX 里配好一个最小工程然后只做一件事翻转 LED。以下是 main 循环里的关键部分int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); while (1) { HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); HAL_Delay(500); } }HAL_GPIO_TogglePin直接翻转引脚输出电平不需要先读再写HAL_Delay基于 SysTick前提是HAL_Init()已经跑过且时钟树配置正确。如果这里灯闪得很快或极慢不用怀疑代码回 2.1 检查 SYSCLK。这个最小工程就是后续所有外设调试的底。2.3.1 Keil 工程里千万别漏开 FPUG431RBT6 是 M4F有单精度浮点单元。CubeMX 默认会把 FPU 在启动文件里打开但 Keil MDK 的 C/C 选项里还必须在 Floating Point Hardware 一栏选择 Single Precision。漏掉这一步代码里只要出现float运算跑起来就是 HardFault。蓝桥杯真题里处理电压值、温度值经常会用到浮点显示这个开关直接影响程序能不能过测试点。3. 把程序源码拆成 bsp 层和中断层G431RBT6 的工程骨架3.1 项目说明文档里先看这三样东西拿到项目说明后不要急着看代码。常见做法是先找三样内容引脚分配表、模块接线图、已知问题清单。引脚分配表解决“这个 GPIO 对应板子上哪个按键”模块接线图解决“ADC 通道到底接在哪颗电位器上”已知问题则避免你踩前人已经写进文档里的坑。很多嵌入式开源项目也是这种组织方式一个外设一个驱动文件应用逻辑单独放。这样工程的主线永远是 main 里的初始化序列加一个主循环调度器。下面是一份典型目录结构G431_Project/ ├── Core/ │ ├── Inc/ │ └── Src/ │ ├── main.c │ └── stm32g4xx_it.c ├── bsp/ │ ├── bsp_led.c │ ├── bsp_key.c │ ├── bsp_adc.c │ └── bsp_uart.c ├── Doc/ │ └── 项目说明.md └── MDK-ARM/Core/Src里是 CubeMX 生成的基础代码和中断服务函数bsp目录是手写的板级驱动每个文件对应一个外设Doc放项目说明。看到这个结构就知道作者是想把 HAL 库产生的初始化逻辑和具体业务解耦。3.2 用嵌入式 C 语言的事件标志位组织按键扫描按键扫描是这套源码里最值得细读的部分。很多初学者把按键检测放在中断里然后在中断里延时消抖这在大赛板上一旦加上 LCD 刷新就会出现按键失灵。常见做法是主循环 5ms 到 20ms 周期性扫描一次按键用两级电平加时间戳做消抖再通过事件标志位通知业务逻辑。#define KEY_PIN GPIO_PIN_0 #define KEY_GPIO_PORT GPIOA #define DEBOUNCE_TICKS 5 static uint8_t raw_level; // 当前读取到的电平 static uint8_t stable_level; // 消抖后的稳定电平 static uint32_t last_tick; // 上次电平跳变的时刻 volatile uint8_t key_event; // 0无事件1短按 void BSP_Key_Scan(void) { uint8_t level (HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_PIN) GPIO_PIN_RESET) ? 1 : 0; uint32_t now HAL_GetTick(); if (level ! raw_level) { raw_level level; last_tick now; return; } if ((level ! stable_level) (now - last_tick DEBOUNCE_TICKS)) { stable_level level; if (stable_level 1) { key_event 1; // 低电平有效按下瞬间产生事件 } } }raw_level保存最新读取的物理电平只要电平变化就重置时间戳不做任何判断只有电平连续稳定超过DEBOUNCE_TICKS毫秒才更新stable_level。主循环里只需判断key_event是否为 1处理后立刻清零。这里要注意key_event会被中断函数或主循环之外的代码读写必须用volatile修饰否则编译器可能把这个变量优化进寄存器导致事件丢失。3.3 中断里只做一件事置标志G431RBT6 的 HAL 库工程中中断服务函数集中在stm32g4xx_it.c。新手最常犯的错误是在中断回调里直接调用HAL_UART_Transmit发串口或者在回调里HAL_Delay。中断里跑长时间的阻塞函数轻则丢中断重则卡死主循环。正确姿势是中断里只置位标志把实际处理放回主循环。extern volatile uint8_t uart_rx_done; extern volatile uint8_t uart_rx_data; void USART1_IRQHandler(void) { if (USART1-ISR USART_ISR_RXNE) { uart_rx_data USART1-RDR 0xFF; uart_rx_done 1; } }这段示例里直接操作寄存器读RDR比调用HAL_UART_Receive_IT更直白也省去了回调函数里的句柄判断。参数说明USART1-ISR是状态寄存器RXNE位表示接收数据寄存器已满读RDR会自动清除该位不需要手动写清除。中断优先级分组常用 NVIC 默认配置抢占优先级 0 到 3其中 SysTick 和耗时外设尽量分配不同组。外设中断抢占优先级说明SysTick0最优先保证 HAL_Delay 准确USART11接收数据只置标志TIM22定时采集或 PWM 相关这个优先级表不是绝对的但原则是越不能被阻塞的中断优先级越高。把 SysTick 放最高才能保证HAL_GetTick()在按键消抖里稳定工作。4. G431RBT6 真题外设组合ADC、PWM、串口与 LCD 的参数表4.1 ADC 采集电位器电压先校准再采样最近几届蓝桥杯嵌入式真题基本都绕不开“采集、显示、上报”这个组合。ADC 采集电位器电压换算成实际电压值显示在 LCD 上同时通过串口发送到上位机。G431RBT6 的 ADC 是 12 位最大采样率 2.5Msps支持硬件过采样配置起来比 F103 要复杂一点。在 CubeMX 里开 ADC1选择一个通道比如电位器接在 PA0 对应的通道。注意具体通道号必须以后面的项目说明书和板卡丝印为准同一片 G431RBT6 在不同竞赛板上的引脚映射可能不同。初始化完成后启动 ADC 前要先做校准HAL_ADCEx_Calibration_Start(hadc1, ADC_SINGLE_ENDED); HAL_ADC_Start(hadc1); HAL_ADC_PollForConversion(hadc1, 10); uint16_t adc_val HAL_ADC_GetValue(hadc1); float voltage adc_val * 3.3f / 4095.0f;HAL_ADCEx_Calibration_Start是 G4 系列独有的校准接口必须在单次采样之前调用第二个参数ADC_SINGLE_ENDED表示单端输入。换算公式里分母 4095 对应 12 位 ADC 的最大值3.3f是参考电压。G431RBT6 有 FPU直接用浮点不会对性能造成压力但要注意voltage后面的运算如果多次使用尽量一次算完避免重复转换。采样时间参数同样关键。CubeMX 里 ADC Sampling Time 选 2.5 到 92.5 cycles 不等。信号源阻抗高、走线长时采样时间要放到 47.5 cycles 以上否则电压读数会偏低。遇到过不少人读出的 ADC 值整体偏差 30mV 以上基本都是这里偷懒用了最小的 1.5 cycles。4.2 PWM 输出频率先算好再填 PSC 和 ARRPWM 输出是真题里控制电机、蜂鸣器、调光的标配。G431RBT6 的定时器资源丰富TIM1、TIM8 是高级定时器TIM2、TIM3、TIM4 是通用定时器。选哪个定时器要看 CubeMX 的时钟树里该 TIM 挂在 APB1 还是 APB2。不同分频系数会让定时器时钟不是简单的 170MHz。通用公式是PWM频率 timer_clk / ((PSC 1) * (ARR 1))例如想在 TIM3 上产生 10kHz PWM如果 timer_clk 是 170MHz可以取 PSC169这样计数时钟是 1MHz再取 ARR99输出就是 10kHz。如果是 85MHz 的定时器时钟同样的参数输出 5kHz所以填参数前先确认timer_clk。TIM3-PSC 169; TIM3-ARR 99; TIM3-CCR1 30; // 占空比约 30% TIM3-CCMR1 (TIM3-CCMR1 ~TIM_CCMR1_OC1M_Msk) | TIM_CCMR1_OC1M_1 | TIM_CCMR1_OC1M_2; TIM3-CCER | TIM_CCER_CC1E; TIM3-CR1 | TIM_CR1_CEN;这段寄存器操作把 TIM3 配置成 PWM 模式 1OC1M位段设置为 110即 PWM 模式 1计数到 CCR1 输出有效电平。CC1E使能通道输出CEN启动计数器。实际工程中直接在 CubeMX 里配置好再用__HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, 30)改占空比更稳妥寄存器版本适合调试时快速确认底层行为。PSC 和 ARR 都是 16 位寄存器最大值 65535。如果需要极低频率比如 1Hz 慢闪就要把 PSC 拉高或者改用 TIM2 这类带更大预分频能力的定时器方案。这是嵌入式八股文里常考的溢出计算题放到真实项目里就是“LED 不闪”和“电机转速对不上”的排查方向。4.3 串口配置printf 重定向的两种路线串口上报数值最快速的调试方式是直接把 printf 映射到 USART。G431RBT6 的 USART1 默认挂在 PA9/PA10CubeMX 里配成 Asynchronous波特率 115200、8-N-1。然后需要自己实现字符发送接口。GCC 工具链STM32CubeIDE 等下的实现#include stdio.h int __io_putchar(int ch) { uint8_t c (uint8_t)ch; HAL_UART_Transmit(huart1, c, 1, 10); return ch; } int _write(int fd, char *ptr, int len) { for (int i 0; i len; i) { if (__io_putchar((uint8_t)ptr[i]) EOF) { return i; } } return len; }_write是 syscall 的底层接口printf 最终会调用它把缓冲区逐字节发出去第四个参数 10 是超时毫秒数串口空闲时 1 字节只占不到 0.1ms10ms 足够。Keil MDK 用户则通常勾选 Use MicroLIB再用 fputc 实现同样的逻辑这时因为全部走库函数代码更短。注意如果串口发送在中断回调里调用printf超时参数很容易被拖满进而影响实时性。串口打印适合放在主循环的状态机里不适合压到中断里高频输出。4.4 LCD 显示数值缓冲区大小和格式串LCD 显示 float 类型最省事的写法是char buf[16]; sprintf(buf, %.2fV, voltage); LCD_DisplayStringLine(Line4, buf);有两个点都容易踩。一是缓冲区大小sprintf不检查长度浮点加单位很容易超 12 字节要留余量二是.2f会做四舍五入如果题目要求的是“截断到小数点后两位”就要先用(int)(voltage * 100)拆出整数和小数再拼字符串。LCD 驱动如果是 SPI 接口刷新一次整屏要几十毫秒全局刷新的频率别超过 20Hz否则主循环会被拖死。5. G431RBT6 源码烧进去之后用这 4 个检查点验证5.1 检查点一时钟树是否真的跑在 170MHz烧录后第一步接调试器或者用 J-Link RTT看SystemCoreClock变量。这个变量在 system_stm32g4xx.c 里维护标准值是 170000000。如果读到的是 16000000说明.ioc里时钟配置被改过或者SystemClock_Config()里手动设置的 PLL 参数不对直接回到第 2 章的表格重算。5.2 检查点二串口回环测试把 USART 的 TX 和 RX 用杜邦线短接然后执行一段回环代码HAL_UART_Transmit(huart1, (uint8_t*)OK\r\n, 5, 100); HAL_UART_Receive(huart1, rx_byte, 1, 100);如果串口助手能收到 OK 而收不到回环数据多半是 RX 引脚映射或者中断里没读RDR导致数据滞留。用逻辑分析仪抓 PA9/PA10能直接确认波形有没有发出来比盯着串口助手猜快得多。5.3 检查点三HAL_Delay 卡死和变量被优化程序运行一段时间后卡死最常见两个原因一是在中断里调用HAL_DelaySysTick 被同级或更高优先级中断抢占永远回不来二是共享变量没加volatile主循环读了旧值。解决方案很简单中断里只置标志位标志位统一加volatile修饰串口、ADC 这类句柄则保持 HAL 库生成的原始类型即可。5.4 检查点四改动最小化对比 .ioc 差异从压缩包源码改成自己的真题实现时每次改动都只动一个bsp_xxx.c文件不要顺手改stm32g4xx_it.c的结构。想回顾自己改了什么直接对比.iocgit diff --no-index backup/工程.ioc 当前/工程.ioc.ioc文件是纯文本Git 能直接做差异对比。看驱动配置的改动比看代码改动更直观。最后一个小技巧调试 PWM 和 ADC 时保证采集端的杜邦线别超过 10cm否则引线电感会让 ADC 读数跳动、PWM 波形边缘出现明显振铃。把线剪短很多“硬件问题”会直接消失。本文还有配套的精品资源点击获取 
