简介一份完整的蓝桥杯嵌入式竞赛源码包基于STM32G431RBT6主控芯片适合正在备赛的高校学生也适合电子信息、计算机等专业将其用于课程设计、期末大作业或毕业设计参考。工程集成HAL库外设驱动包含定时器PWM、ADC采集、串口通信、按键扫描、LCD显示、中断处理等竞赛常见模块代码层次清晰便于对照项目说明梳理外设初始化、中断回调与主循环调度逻辑。压缩包内文件总数达2000个大小约116.81MB以h头文件与c源文件为主体包含HAL库底层驱动源码同时提供uvprojx工程文件、hex烧录文件、map映射文件以及crf、o等编译中间产物既能直接打开工程编译也能借助映射文件进行链接期调试分析。目前已有854人学习下载用户反馈良好适合自学钻研与二次开发。使用者需要具备一定C语言和STM32基础阅读代码后可根据赛题要求自行修改扩展对备赛冲刺、课程设计和项目实践均有较高参考价值。1. 蓝桥杯嵌入式STM32G431RBT6先认清比赛板子再写代码很多人拿到蓝桥杯嵌入式STM32G431RBT6的程序源码包第一反应是打开 main.c 找功能实现把 LED、按键、ADC 挨个调通就算完事。但真正让你在第十七届蓝桥杯嵌入式国赛真题上丢分的往往不是某个外设写不出来而是源码结构混乱、项目说明缺失导致现场改一个参数要全局搜索改完还要担心影响另一边。STM32G431RBT6 相比 F103 多了一套更复杂的时钟树、独立 ADC 和互相级联的定时器比赛的考察点也从“会点灯”变成“会看原理图和数据手册”。这篇博文不打算一份份贴例程而是把 G431 的源码组织、驱动封装和项目说明该怎么写讲透。无论你是刚开始定嵌入式学习路线还是在刷蓝桥杯嵌入式历年真题这套整理思路都比单纯背外设代码更有复用价值。源码包只是起点把源码变成能在三天后还能看懂、能在现场快速改动的工程才算真正掌握这块板子。2. 用 CubeMX 搭出 G431 工程骨架时钟、引脚与源码目录的分层2.1 为什么围绕 G431 生成 CubeMX 工程而不是手写寄存器STM32G431RBT6 的 GPIO 数量不算多但定时器可以挂在不同的 APB 时钟域ADC 支持外部触发、注入组和硬件过采样。纯手写寄存器不是不行只是在比赛现场容易漏掉某个位域。我一般直接用 STM32CubeMX 生成 HAL 库工程然后在底层驱动外面再包一层 BSP避免在业务逻辑里堆满HAL_GPIO_WritePin。生成工程时Part Number 填入 STM32G431RBT6选择 LQFP64 封装。时钟源选外部晶振具体频率以你手上板子的丝印为准。HCLK 我习惯先跑 80MHz因为 G431 在 80MHz 下 FLASH 等待周期少ADC 和定时器的时钟树更好分配170MHz 也能跑但比赛题目很少需要这么高主频反而容易在定时器分频计算上出乱子。用 CubeMX 生成工程的另一个好处是.ioc文件本身就是项目说明的一部分。把my_g431.ioc保留在源码根目录后文要讲的项目说明文档里可以引用它。2.2 引脚分配别背原理图直接查复用表G431 的引脚是有复用冲突的。比如 PA9/PA10 常用作 USART1但 PA10 也可能被接到按键上TIM3 的 PWM 输出在 PA6/PA7但这两个引脚同时也能做 ADC 输入。比赛板上的资源分配经过官方筛选但不同年份的板子仍有差异所以第一件事是把板子原理图里的引脚列表整理成一张表。外设资源常见引脚复用功能备注板载 LEDPC8~PC15GPIO 输出多数为低电平点亮独立按键PA0、PD0 等GPIO 输入内部或外部上拉ADC 采样PA1ADC1_IN1电位器电压采样PWM 输出PA6/PA7TIM3_CH1/CH2建议 10kHz 以上串口调试PA9/PA10USART1用于 printf 重映射扩展 LCDPD0~PD7GPIO 并行看你的 LCD 协议这张表要放进Doc/目录。比赛现场临时查数据手册不现实先整理成表格源码里写注释时直接引用引脚别名比如#define KEY_Pin GPIO_PIN_0而不是裸写数字。2.3 目录分层把 main.c 拆成 BSP 和 App 两层CubeMX 生成的默认目录会帮你建好 Core 和 Drivers但如果你把所有初始化后的业务全塞进 main.c等到按键、ADC、PWM、串口一起工作时main.c 会变成没人敢动的“屎山”。常见做法是在 Drivers 下建 BSP 文件夹每个外设一个文件App 之下放任务逻辑。my_g431_project/ ├── Core/ │ ├── Inc/ │ └── Src/ │ ├── main.c │ ├── gpio.c │ ├── usart.c │ └── tim.c ├── Drivers/ │ ├── BSP/ │ │ ├── bsp_led.c │ │ ├── bsp_key.c │ │ ├── bsp_adc.c │ │ ├── bsp_tim_pwm.c │ │ └── bsp_uart.c │ ├── CMSIS/ │ └── STM32G4xx_HAL_Driver/ ├── MDK-ARM/ └── Doc/ ├── 项目说明.md └── 引脚分配表.md每个 BSP 文件只对外提供两个函数BSP_XX_Init()和BSP_XX_Task()。业务层不直接操作 HAL 句柄只需要知道调用顺序。int main(void) { HAL_Init(); SystemClock_Config(); BSP_LED_Init(); BSP_KEY_Init(); BSP_ADC_Init(); BSP_TIM_PWM_Init(); BSP_UART_Init(); App_Init(); while (1) { App_Task(); } }这段代码的意图是让 main.c 只保留系统骨架。SystemClock_Config()由 CubeMX 生成一般不改BSP 初始化顺序会影响外设间的引用关系比如 ADC 用定时器触发就必须先初始化并启动定时器再启动 ADC 的 DMA 采集。这里把 PWM 初始化放在 ADC 之后是因为比赛中常见“ADC 读数控制 PWM 占空比”的需求先保证外设都在再在App_Task()里读取采样值。目录分层的好处在于源码包被别人打开时依据文件名和函数名就能定位问题。配合后面章节的项目说明文档这个 zip 才真正具备可交付性。3. 驱动与 APILED、按键、ADC、PWM 和串口在 G431 上的落地写法3.1 按键扫描不要用阻塞延时消抖用状态机G431 的 GPIO 输入速度很快机械按键抖动通常持续 10~20ms。很多例程用HAL_Delay(20)消抖但阻塞延时在比赛里会拖垮整个任务周期尤其是在 PWM 和串口并行跑的时候。更稳的做法是设置一个 1ms 的定时器节拍每次节拍调用一次扫描函数用状态机区分“按下瞬间”和“释放瞬间”。typedef enum { KEY_IDLE, KEY_WAIT_STABLE, KEY_PRESSED, KEY_RELEASE } key_state_t; uint8_t BSP_KEY_Scan(void) { static key_state_t st KEY_IDLE; static uint16_t cnt 0; uint8_t valid 0; switch (st) { case KEY_IDLE: if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_RESET) { st KEY_WAIT_STABLE; cnt 0; } break; case KEY_WAIT_STABLE: if (cnt 5) { cnt 0; st KEY_PRESSED; valid 1; } break; case KEY_PRESSED: if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_SET) { st KEY_RELEASE; } break; case KEY_RELEASE: if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_SET) { st KEY_IDLE; } break; } return valid; }逻辑说明BSP_KEY_Scan()每次调用只处理一次状态迁移。KEY_WAIT_STABLE状态下累计 5ms确认电平稳定才认为按键有效避免毛刺误触发。valid只在按下瞬间置 1之后即使按住不放也不会重复触发适合做菜单切换。参数KEY_GPIO_Port和KEY_Pin来自 stm32g4xx_hal_conf.h 或 main.h不要直接写GPIOA和GPIO_PIN_0便于不同板子间移植。如果比赛题要求长按功能可以在KEY_PRESSED分支里额外统计持续时间再增加一个长按返回值。不要把长按和短按混在同一个valid里否则状态机分支会乱掉。3.2 ADC 采样用定时器触发得到稳定的电位器读数G431 的 ADC 支持多种触发源比赛里的电位器采样用轮询也能跑但当你同时刷 LCD、调 PWM 时频繁调用HAL_ADC_PollForConversion会占住 CPU。常见做法是用 TIM6 产生 Update 事件通过 TRGO 触发 ADC1 转换再用 DMA 把结果搬到内存整个过程不需要 CPU 介入。static uint32_t adc_value; void BSP_ADC_Init(void) { ADC_HandleTypeDef hadc1; hadc1.Instance ADC1; hadc1.Init.ClockPrescaler ADC_CLOCK_SYNC_PCLK_DIV4; hadc1.Init.Resolution ADC_RESOLUTION_12B; hadc1.Init.ScanConvMode DISABLE; hadc1.Init.EOCSelection ADC_EOC_SINGLE_CONV; hadc1.Init.ExternalTrigConv ADC_EXTERNALTRIGCONV_T6_TRGO; hadc1.Init.ExternalTrigConvEdge ADC_EXTERNALTRIGCONVEDGE_RISING; hadc1.Init.Overrun ADC_OVR_DATA_OVERWRITTEN; HAL_ADC_Init(hadc1); HAL_ADC_Start_DMA(hadc1, (uint32_t *)adc_value, 1); }参数说明ADC_RESOLUTION_12B是 12 位分辨率对应 0~4095。ADC_EXTERNALTRIGCONV_T6_TRGO选择 TIM6 的 TRGO 事件作为启动触发这样采样频率由定时器控制不受主循环抖动影响。ADC_OVR_DATA_OVERWRITTEN表示数据覆盖模式适合连续搬运。每次采样完成DMA 会把结果写入adc_value。TIM6 需要配置为 1ms 周期预分频值根据定时器时钟计算自动重装载值决定触发间隔。一般采样周期在 1ms 到 10ms 之间就够电位器用太快反而会引入电源噪声。读取时直接访问adc_value但要注意它是uint32_t用 12 位时要屏蔽高 20 位或者直接强转uint16_t。3.3 PWM 输出先禁能定时器再改 ARR 和 CCRG431 的 TIM1 是高级定时器带互补输出和刹车功能但比赛里最常用 TIM3 或 TIM4 做普通 PWM。调占空比时用__HAL_TIM_SET_COMPARE随时改比较值没问题但如果你要改频率必须修改自动重装载值 ARR。ARR 正在递减计数器时被改可能会导致计数器超出新 ARR输出暂时卡在高电平或低电平。void BSP_PWM_SetFreq(uint32_t freq_khz) { uint16_t arr 1000 / freq_khz - 1; HAL_TIM_PWM_Stop(htim3, TIM_CHANNEL_1); __HAL_TIM_SET_AUTORELOAD(htim3, arr); __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, arr / 2); HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); }这段代码假设定时器时钟为 1MHz实际要根据你的分频重新计算。逻辑说明先停止通道修改 ARR 和 CCR再重新启动。停止和启动之间有几百微秒的间隙对于电机这类惯性负载影响不大如果是驱动灯带这个间隙不可见。关键点在于修改频率和占空比时要同时保障两者比例一致避免 ARR 变了而 CCR 没变导致占空比跳变。PWM 频率的选择也要看题目。输出给蜂鸣器一般用 1kHz 到 4kHz控制电机用 10kHz 到 20kHzLCD 背光用 1kHz 左右。不要一上来就写 50Hz那是舵机专用频率。G431 的定时器能轻松支持 20kHz 以上的 PWM但要注意电机驱动板的死区时间是否匹配。3.4 串口和 printf只用于调试不要影响实时任务串口在比赛里多用于输出调试信息和接收指令。G431 的 USART 自带 FIFO但在默认 HAL 库下HAL_UART_Transmit是阻塞的。如果每帧数据几十字节在 115200 波特率下会占用数毫秒造成按键扫描和 PWM 控制抖动。常见做法是只在自己的调试宏里使用 printf比赛提交时把调试输出关掉。#include stdio.h int fputc(int ch, FILE *f) { (void)f; HAL_UART_Transmit(huart1, (uint8_t *)ch, 1, 10); return ch; }重定向后可以直接printf(adc%lu\r\n, adc_value)但%lu对应的类型是unsigned longG431 的uint32_t在 ARMCC 下是unsigned int所以要写成%u或强制转换。HAL_UART_Transmit最后一个参数 10 是超时毫秒数在故障情况下可以避免死等。如果你要用单片机扫码枪或蓝牙模块接收数据那应该用中断接收加环形缓冲区而不要用这里的方式。3.5 串口和 LCD 同时刷屏时的调度策略LCD 如果接在并行 GPIO 上刷一次整屏可能耗时几十毫秒。比赛里常见的 UI 每秒刷新几次这时候如果把 LCD 写入直接放在主循环printf又放在中断里两边节奏会互相干扰。我一般会在项目说明文档里留一个“任务时序表”用 TIM6 的 1ms 节拍分时调度每 5ms 扫描按键每 20ms 读一次 ADC每 100ms 刷一次 LCD。这样即使串口打印偶尔卡顿也不会影响按键灵敏度和 PWM 更新。源码里只需维护一个 tick 计数不必引入实时操作系统。4. 从源码到项目说明怎样把设计和验证写进文档4.1 项目说明文档必须包含的六块内容源码包里的.zip文件如果只有工程别人收到后很难知道你想表达什么。蓝桥杯嵌入式历年真题的评分并不强制要求提交文档但一份好的项目说明能让你自己三天后回看时不至于从头推理。我一般会在 Doc 目录下写一个项目说明.md固定包含六块。题目需求与功能拆分系统框图与引脚分配外设设计说明测试结果与现象源码文件说明版本记录与踩坑记录题目需求不需要长篇大论把比赛题目的功能点列成清单即可。系统框图可以用文字描述比如“左侧按键输入 → 状态机切换界面 → ADC 采样电压 → 计算目标占空比 → TIM3 输出 PWM”。源码文件说明要写清楚每个 BSP 文件对应哪个外设哪些函数是初始化哪些是周期任务。版本记录用来记录每次改动改了什么参数现场改乱了能回滚。4.2 用 HAL 库的注释风格规范自己的 APISTM32 HAL 库的头文件里已经有一套很好的注释模板模仿它可以获得 IDE 悬停提示也能让代码在团队评审时更好读。每个 BSP 函数都应该有brief、param、retval和note字段。/** * brief 初始化 LED 引脚设置默认熄灭状态。 * param 无 * retval 无 * note 应在时钟初始化之后调用。 */ void BSP_LED_Init(void);参数说明只有一句话note里写的是调用前置条件。这么做的好处是当你把源码包发给别人时对方不需要打开.c文件就知道函数怎么用。项目说明里也能直接引用这些注释避免文档和代码不同步。4.3 把调试宏和比赛逻辑分离比赛代码最容易翻车的地方是调试输出散落在业务逻辑里。提交前删掉所有 printf 不现实留着重定向又担心串口阻塞。更稳妥的做法是统一用一个调试宏控制。#define ENABLE_DEBUG_PRINT 1 #if ENABLE_DEBUG_PRINT #define DBG_PRINT(fmt, ...) \ printf(%s:%d: fmt \r\n, __FILE__, __LINE__, ##__VA_ARGS__) #else #define DBG_PRINT(fmt, ...) do {} while (0) #endif这个宏在代码里的用法和 printf 一样DBG_PRINT(adc%u, adc_value)。提交现场演示版本时把ENABLE_DEBUG_PRINT改成 0所有调试输出会被预处理器吞掉不再占用 CPU。__VA_ARGS__是可变参数宏的标准写法##是 GCC 和 ARMCC 都支持的兼容扩展用来消除空参数时的逗号。5. 比赛现场最实用的三个 G431 调试技巧5.1 读取芯片 UID先确认目标板状态STM32G431RBT6 的 UID 由厂商在出厂时写入不同芯片读取结果不同。现场如果发现程序行为异常先打印 UID 和 Flash 容量能确认你是不是在用正版芯片。G431 的 UID 基地址在数据手册中有明确标注直接按地址读三个 32 位整数即可。uint32_t uid[3]; uid[0] *(volatile uint32_t *)0x1FFF7590; uid[1] *(volatile uint32_t *)0x1FFF7594; uid[2] *(volatile uint32_t *)0x1FFF7598; printf(UID: %08X %08X %08X\r\n, uid[0], uid[1], uid[2]);如果现场串口打不出 UID先检查串口波特率是否匹配再检查该地址在型号手册里的偏移是否正确。这块板子如果是从非官方渠道买的UID 地址可能异常程序跑飞也就说得通。5.2 在 HardFault 里查看 CFSR 寄存器快速定位内存访问错误程序跳进 HardFault 后很多人只会复位。G431 内核的 CFSR 寄存器记录了是总线错误、地址错误还是状态错误读取它比盲改代码效率高得多。void HardFault_Handler(void) { volatile uint32_t cfsr SCB-CFSR; volatile uint32_t hfsr SCB-HFSR; volatile uint32_t mmar SCB-MMFAR; volatile uint32_t bfar SCB-BFAR; __disable_irq(); while (1) { } }在while (1)处打断点把cfsr变量添加到 Watch 窗口。CFSR 的 bit 14 为MMARVALID表示 MMAR 有效bit 15 是MSTKERR表示入栈失败。常见的情况是数组越界写坏了栈指针导致异常入栈失败。此时看bfar和mmar基本能锁到是哪个地址访问出问题再回源码找对应数组。5.3 用 TIM6 的 1ms tick 做轻量任务准时器G431 的 TIM6 是基本定时器没有外部引脚最适合做时间基准。在TIM6_IRQHandler里对一个volatile uint32_t sys_tick自增主循环里按节拍执行不同任务。volatile uint32_t sys_tick; void TIM6_IRQHandler(void) { if (TIM6-SR TIM_SR_UIF) { TIM6-SR 0; sys_tick; } }在任务函数里用sys_tick差值判断是否到达执行周期不要直接取模。因为取模在 MCU 上会消耗额外周期而差值判断更适合周期不固定的任务。这段代码比用 HAL 的回调更直接也省一层封装。配合前面 BSP_KEY_Scan 的状态机整个比赛程序就有一个稳定心跳。本文还有配套的精品资源点击获取 STM32G431嵌入式开发：CubeMX驱动封装与BSP分层实战
简介一份完整的蓝桥杯嵌入式竞赛源码包基于STM32G431RBT6主控芯片适合正在备赛的高校学生也适合电子信息、计算机等专业将其用于课程设计、期末大作业或毕业设计参考。工程集成HAL库外设驱动包含定时器PWM、ADC采集、串口通信、按键扫描、LCD显示、中断处理等竞赛常见模块代码层次清晰便于对照项目说明梳理外设初始化、中断回调与主循环调度逻辑。压缩包内文件总数达2000个大小约116.81MB以h头文件与c源文件为主体包含HAL库底层驱动源码同时提供uvprojx工程文件、hex烧录文件、map映射文件以及crf、o等编译中间产物既能直接打开工程编译也能借助映射文件进行链接期调试分析。目前已有854人学习下载用户反馈良好适合自学钻研与二次开发。使用者需要具备一定C语言和STM32基础阅读代码后可根据赛题要求自行修改扩展对备赛冲刺、课程设计和项目实践均有较高参考价值。1. 蓝桥杯嵌入式STM32G431RBT6先认清比赛板子再写代码很多人拿到蓝桥杯嵌入式STM32G431RBT6的程序源码包第一反应是打开 main.c 找功能实现把 LED、按键、ADC 挨个调通就算完事。但真正让你在第十七届蓝桥杯嵌入式国赛真题上丢分的往往不是某个外设写不出来而是源码结构混乱、项目说明缺失导致现场改一个参数要全局搜索改完还要担心影响另一边。STM32G431RBT6 相比 F103 多了一套更复杂的时钟树、独立 ADC 和互相级联的定时器比赛的考察点也从“会点灯”变成“会看原理图和数据手册”。这篇博文不打算一份份贴例程而是把 G431 的源码组织、驱动封装和项目说明该怎么写讲透。无论你是刚开始定嵌入式学习路线还是在刷蓝桥杯嵌入式历年真题这套整理思路都比单纯背外设代码更有复用价值。源码包只是起点把源码变成能在三天后还能看懂、能在现场快速改动的工程才算真正掌握这块板子。2. 用 CubeMX 搭出 G431 工程骨架时钟、引脚与源码目录的分层2.1 为什么围绕 G431 生成 CubeMX 工程而不是手写寄存器STM32G431RBT6 的 GPIO 数量不算多但定时器可以挂在不同的 APB 时钟域ADC 支持外部触发、注入组和硬件过采样。纯手写寄存器不是不行只是在比赛现场容易漏掉某个位域。我一般直接用 STM32CubeMX 生成 HAL 库工程然后在底层驱动外面再包一层 BSP避免在业务逻辑里堆满HAL_GPIO_WritePin。生成工程时Part Number 填入 STM32G431RBT6选择 LQFP64 封装。时钟源选外部晶振具体频率以你手上板子的丝印为准。HCLK 我习惯先跑 80MHz因为 G431 在 80MHz 下 FLASH 等待周期少ADC 和定时器的时钟树更好分配170MHz 也能跑但比赛题目很少需要这么高主频反而容易在定时器分频计算上出乱子。用 CubeMX 生成工程的另一个好处是.ioc文件本身就是项目说明的一部分。把my_g431.ioc保留在源码根目录后文要讲的项目说明文档里可以引用它。2.2 引脚分配别背原理图直接查复用表G431 的引脚是有复用冲突的。比如 PA9/PA10 常用作 USART1但 PA10 也可能被接到按键上TIM3 的 PWM 输出在 PA6/PA7但这两个引脚同时也能做 ADC 输入。比赛板上的资源分配经过官方筛选但不同年份的板子仍有差异所以第一件事是把板子原理图里的引脚列表整理成一张表。外设资源常见引脚复用功能备注板载 LEDPC8~PC15GPIO 输出多数为低电平点亮独立按键PA0、PD0 等GPIO 输入内部或外部上拉ADC 采样PA1ADC1_IN1电位器电压采样PWM 输出PA6/PA7TIM3_CH1/CH2建议 10kHz 以上串口调试PA9/PA10USART1用于 printf 重映射扩展 LCDPD0~PD7GPIO 并行看你的 LCD 协议这张表要放进Doc/目录。比赛现场临时查数据手册不现实先整理成表格源码里写注释时直接引用引脚别名比如#define KEY_Pin GPIO_PIN_0而不是裸写数字。2.3 目录分层把 main.c 拆成 BSP 和 App 两层CubeMX 生成的默认目录会帮你建好 Core 和 Drivers但如果你把所有初始化后的业务全塞进 main.c等到按键、ADC、PWM、串口一起工作时main.c 会变成没人敢动的“屎山”。常见做法是在 Drivers 下建 BSP 文件夹每个外设一个文件App 之下放任务逻辑。my_g431_project/ ├── Core/ │ ├── Inc/ │ └── Src/ │ ├── main.c │ ├── gpio.c │ ├── usart.c │ └── tim.c ├── Drivers/ │ ├── BSP/ │ │ ├── bsp_led.c │ │ ├── bsp_key.c │ │ ├── bsp_adc.c │ │ ├── bsp_tim_pwm.c │ │ └── bsp_uart.c │ ├── CMSIS/ │ └── STM32G4xx_HAL_Driver/ ├── MDK-ARM/ └── Doc/ ├── 项目说明.md └── 引脚分配表.md每个 BSP 文件只对外提供两个函数BSP_XX_Init()和BSP_XX_Task()。业务层不直接操作 HAL 句柄只需要知道调用顺序。int main(void) { HAL_Init(); SystemClock_Config(); BSP_LED_Init(); BSP_KEY_Init(); BSP_ADC_Init(); BSP_TIM_PWM_Init(); BSP_UART_Init(); App_Init(); while (1) { App_Task(); } }这段代码的意图是让 main.c 只保留系统骨架。SystemClock_Config()由 CubeMX 生成一般不改BSP 初始化顺序会影响外设间的引用关系比如 ADC 用定时器触发就必须先初始化并启动定时器再启动 ADC 的 DMA 采集。这里把 PWM 初始化放在 ADC 之后是因为比赛中常见“ADC 读数控制 PWM 占空比”的需求先保证外设都在再在App_Task()里读取采样值。目录分层的好处在于源码包被别人打开时依据文件名和函数名就能定位问题。配合后面章节的项目说明文档这个 zip 才真正具备可交付性。3. 驱动与 APILED、按键、ADC、PWM 和串口在 G431 上的落地写法3.1 按键扫描不要用阻塞延时消抖用状态机G431 的 GPIO 输入速度很快机械按键抖动通常持续 10~20ms。很多例程用HAL_Delay(20)消抖但阻塞延时在比赛里会拖垮整个任务周期尤其是在 PWM 和串口并行跑的时候。更稳的做法是设置一个 1ms 的定时器节拍每次节拍调用一次扫描函数用状态机区分“按下瞬间”和“释放瞬间”。typedef enum { KEY_IDLE, KEY_WAIT_STABLE, KEY_PRESSED, KEY_RELEASE } key_state_t; uint8_t BSP_KEY_Scan(void) { static key_state_t st KEY_IDLE; static uint16_t cnt 0; uint8_t valid 0; switch (st) { case KEY_IDLE: if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_RESET) { st KEY_WAIT_STABLE; cnt 0; } break; case KEY_WAIT_STABLE: if (cnt 5) { cnt 0; st KEY_PRESSED; valid 1; } break; case KEY_PRESSED: if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_SET) { st KEY_RELEASE; } break; case KEY_RELEASE: if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_SET) { st KEY_IDLE; } break; } return valid; }逻辑说明BSP_KEY_Scan()每次调用只处理一次状态迁移。KEY_WAIT_STABLE状态下累计 5ms确认电平稳定才认为按键有效避免毛刺误触发。valid只在按下瞬间置 1之后即使按住不放也不会重复触发适合做菜单切换。参数KEY_GPIO_Port和KEY_Pin来自 stm32g4xx_hal_conf.h 或 main.h不要直接写GPIOA和GPIO_PIN_0便于不同板子间移植。如果比赛题要求长按功能可以在KEY_PRESSED分支里额外统计持续时间再增加一个长按返回值。不要把长按和短按混在同一个valid里否则状态机分支会乱掉。3.2 ADC 采样用定时器触发得到稳定的电位器读数G431 的 ADC 支持多种触发源比赛里的电位器采样用轮询也能跑但当你同时刷 LCD、调 PWM 时频繁调用HAL_ADC_PollForConversion会占住 CPU。常见做法是用 TIM6 产生 Update 事件通过 TRGO 触发 ADC1 转换再用 DMA 把结果搬到内存整个过程不需要 CPU 介入。static uint32_t adc_value; void BSP_ADC_Init(void) { ADC_HandleTypeDef hadc1; hadc1.Instance ADC1; hadc1.Init.ClockPrescaler ADC_CLOCK_SYNC_PCLK_DIV4; hadc1.Init.Resolution ADC_RESOLUTION_12B; hadc1.Init.ScanConvMode DISABLE; hadc1.Init.EOCSelection ADC_EOC_SINGLE_CONV; hadc1.Init.ExternalTrigConv ADC_EXTERNALTRIGCONV_T6_TRGO; hadc1.Init.ExternalTrigConvEdge ADC_EXTERNALTRIGCONVEDGE_RISING; hadc1.Init.Overrun ADC_OVR_DATA_OVERWRITTEN; HAL_ADC_Init(hadc1); HAL_ADC_Start_DMA(hadc1, (uint32_t *)adc_value, 1); }参数说明ADC_RESOLUTION_12B是 12 位分辨率对应 0~4095。ADC_EXTERNALTRIGCONV_T6_TRGO选择 TIM6 的 TRGO 事件作为启动触发这样采样频率由定时器控制不受主循环抖动影响。ADC_OVR_DATA_OVERWRITTEN表示数据覆盖模式适合连续搬运。每次采样完成DMA 会把结果写入adc_value。TIM6 需要配置为 1ms 周期预分频值根据定时器时钟计算自动重装载值决定触发间隔。一般采样周期在 1ms 到 10ms 之间就够电位器用太快反而会引入电源噪声。读取时直接访问adc_value但要注意它是uint32_t用 12 位时要屏蔽高 20 位或者直接强转uint16_t。3.3 PWM 输出先禁能定时器再改 ARR 和 CCRG431 的 TIM1 是高级定时器带互补输出和刹车功能但比赛里最常用 TIM3 或 TIM4 做普通 PWM。调占空比时用__HAL_TIM_SET_COMPARE随时改比较值没问题但如果你要改频率必须修改自动重装载值 ARR。ARR 正在递减计数器时被改可能会导致计数器超出新 ARR输出暂时卡在高电平或低电平。void BSP_PWM_SetFreq(uint32_t freq_khz) { uint16_t arr 1000 / freq_khz - 1; HAL_TIM_PWM_Stop(htim3, TIM_CHANNEL_1); __HAL_TIM_SET_AUTORELOAD(htim3, arr); __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, arr / 2); HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); }这段代码假设定时器时钟为 1MHz实际要根据你的分频重新计算。逻辑说明先停止通道修改 ARR 和 CCR再重新启动。停止和启动之间有几百微秒的间隙对于电机这类惯性负载影响不大如果是驱动灯带这个间隙不可见。关键点在于修改频率和占空比时要同时保障两者比例一致避免 ARR 变了而 CCR 没变导致占空比跳变。PWM 频率的选择也要看题目。输出给蜂鸣器一般用 1kHz 到 4kHz控制电机用 10kHz 到 20kHzLCD 背光用 1kHz 左右。不要一上来就写 50Hz那是舵机专用频率。G431 的定时器能轻松支持 20kHz 以上的 PWM但要注意电机驱动板的死区时间是否匹配。3.4 串口和 printf只用于调试不要影响实时任务串口在比赛里多用于输出调试信息和接收指令。G431 的 USART 自带 FIFO但在默认 HAL 库下HAL_UART_Transmit是阻塞的。如果每帧数据几十字节在 115200 波特率下会占用数毫秒造成按键扫描和 PWM 控制抖动。常见做法是只在自己的调试宏里使用 printf比赛提交时把调试输出关掉。#include stdio.h int fputc(int ch, FILE *f) { (void)f; HAL_UART_Transmit(huart1, (uint8_t *)ch, 1, 10); return ch; }重定向后可以直接printf(adc%lu\r\n, adc_value)但%lu对应的类型是unsigned longG431 的uint32_t在 ARMCC 下是unsigned int所以要写成%u或强制转换。HAL_UART_Transmit最后一个参数 10 是超时毫秒数在故障情况下可以避免死等。如果你要用单片机扫码枪或蓝牙模块接收数据那应该用中断接收加环形缓冲区而不要用这里的方式。3.5 串口和 LCD 同时刷屏时的调度策略LCD 如果接在并行 GPIO 上刷一次整屏可能耗时几十毫秒。比赛里常见的 UI 每秒刷新几次这时候如果把 LCD 写入直接放在主循环printf又放在中断里两边节奏会互相干扰。我一般会在项目说明文档里留一个“任务时序表”用 TIM6 的 1ms 节拍分时调度每 5ms 扫描按键每 20ms 读一次 ADC每 100ms 刷一次 LCD。这样即使串口打印偶尔卡顿也不会影响按键灵敏度和 PWM 更新。源码里只需维护一个 tick 计数不必引入实时操作系统。4. 从源码到项目说明怎样把设计和验证写进文档4.1 项目说明文档必须包含的六块内容源码包里的.zip文件如果只有工程别人收到后很难知道你想表达什么。蓝桥杯嵌入式历年真题的评分并不强制要求提交文档但一份好的项目说明能让你自己三天后回看时不至于从头推理。我一般会在 Doc 目录下写一个项目说明.md固定包含六块。题目需求与功能拆分系统框图与引脚分配外设设计说明测试结果与现象源码文件说明版本记录与踩坑记录题目需求不需要长篇大论把比赛题目的功能点列成清单即可。系统框图可以用文字描述比如“左侧按键输入 → 状态机切换界面 → ADC 采样电压 → 计算目标占空比 → TIM3 输出 PWM”。源码文件说明要写清楚每个 BSP 文件对应哪个外设哪些函数是初始化哪些是周期任务。版本记录用来记录每次改动改了什么参数现场改乱了能回滚。4.2 用 HAL 库的注释风格规范自己的 APISTM32 HAL 库的头文件里已经有一套很好的注释模板模仿它可以获得 IDE 悬停提示也能让代码在团队评审时更好读。每个 BSP 函数都应该有brief、param、retval和note字段。/** * brief 初始化 LED 引脚设置默认熄灭状态。 * param 无 * retval 无 * note 应在时钟初始化之后调用。 */ void BSP_LED_Init(void);参数说明只有一句话note里写的是调用前置条件。这么做的好处是当你把源码包发给别人时对方不需要打开.c文件就知道函数怎么用。项目说明里也能直接引用这些注释避免文档和代码不同步。4.3 把调试宏和比赛逻辑分离比赛代码最容易翻车的地方是调试输出散落在业务逻辑里。提交前删掉所有 printf 不现实留着重定向又担心串口阻塞。更稳妥的做法是统一用一个调试宏控制。#define ENABLE_DEBUG_PRINT 1 #if ENABLE_DEBUG_PRINT #define DBG_PRINT(fmt, ...) \ printf(%s:%d: fmt \r\n, __FILE__, __LINE__, ##__VA_ARGS__) #else #define DBG_PRINT(fmt, ...) do {} while (0) #endif这个宏在代码里的用法和 printf 一样DBG_PRINT(adc%u, adc_value)。提交现场演示版本时把ENABLE_DEBUG_PRINT改成 0所有调试输出会被预处理器吞掉不再占用 CPU。__VA_ARGS__是可变参数宏的标准写法##是 GCC 和 ARMCC 都支持的兼容扩展用来消除空参数时的逗号。5. 比赛现场最实用的三个 G431 调试技巧5.1 读取芯片 UID先确认目标板状态STM32G431RBT6 的 UID 由厂商在出厂时写入不同芯片读取结果不同。现场如果发现程序行为异常先打印 UID 和 Flash 容量能确认你是不是在用正版芯片。G431 的 UID 基地址在数据手册中有明确标注直接按地址读三个 32 位整数即可。uint32_t uid[3]; uid[0] *(volatile uint32_t *)0x1FFF7590; uid[1] *(volatile uint32_t *)0x1FFF7594; uid[2] *(volatile uint32_t *)0x1FFF7598; printf(UID: %08X %08X %08X\r\n, uid[0], uid[1], uid[2]);如果现场串口打不出 UID先检查串口波特率是否匹配再检查该地址在型号手册里的偏移是否正确。这块板子如果是从非官方渠道买的UID 地址可能异常程序跑飞也就说得通。5.2 在 HardFault 里查看 CFSR 寄存器快速定位内存访问错误程序跳进 HardFault 后很多人只会复位。G431 内核的 CFSR 寄存器记录了是总线错误、地址错误还是状态错误读取它比盲改代码效率高得多。void HardFault_Handler(void) { volatile uint32_t cfsr SCB-CFSR; volatile uint32_t hfsr SCB-HFSR; volatile uint32_t mmar SCB-MMFAR; volatile uint32_t bfar SCB-BFAR; __disable_irq(); while (1) { } }在while (1)处打断点把cfsr变量添加到 Watch 窗口。CFSR 的 bit 14 为MMARVALID表示 MMAR 有效bit 15 是MSTKERR表示入栈失败。常见的情况是数组越界写坏了栈指针导致异常入栈失败。此时看bfar和mmar基本能锁到是哪个地址访问出问题再回源码找对应数组。5.3 用 TIM6 的 1ms tick 做轻量任务准时器G431 的 TIM6 是基本定时器没有外部引脚最适合做时间基准。在TIM6_IRQHandler里对一个volatile uint32_t sys_tick自增主循环里按节拍执行不同任务。volatile uint32_t sys_tick; void TIM6_IRQHandler(void) { if (TIM6-SR TIM_SR_UIF) { TIM6-SR 0; sys_tick; } }在任务函数里用sys_tick差值判断是否到达执行周期不要直接取模。因为取模在 MCU 上会消耗额外周期而差值判断更适合周期不固定的任务。这段代码比用 HAL 的回调更直接也省一层封装。配合前面 BSP_KEY_Scan 的状态机整个比赛程序就有一个稳定心跳。本文还有配套的精品资源点击获取