STM32G431蓝桥杯省赛实战：CubeMX配置PWM调光与ADC读取全流程解析
在嵌入式开发竞赛中，能够快速搭建一个稳定可靠的项目框架往往比写出复杂算法更重要。去年带队参加蓝桥杯时，我发现超过60%的选手在硬件外设配置环节浪费了大量时间——不是引脚冲突就是初始化顺序错误。本文将基于STM32G431开发板，通过CubeMX工具完整复现PWM调光与ADC读取的竞赛级实现方案，从工程结构设计到调试技巧，手把手带你避开那些教科书上不会写的"坑"。
1. 工程创建与外设基础配置
1.1 CubeMX工程初始化要点
启动CubeMX后，选择STM32G431RB芯片型号时，务必注意以下关键设置：
时钟源配置：在
Clock Configuration选项卡中，将HCLK设置为170MHz（G431的最大主频），此时系统会自动计算PLL分频参数。记得勾选Use MicroLIB以便使用printf重定向。调试接口：在
System Core > SYS下启用Serial Wire调试模式，否则下载程序后无法再次连接调试器。引脚分配可视化：点击窗口右上角的
Pinout View可以直观看到所有引脚功能分配情况，避免冲突。
提示：创建工程时建议采用
STM32Cube固件库版本6.3.0，这是目前对G431支持最稳定的版本。
1.2 LED与按键硬件抽象层配置
针对竞赛板上的特定硬件布局，需要特别注意：
/* LED控制宏定义（适配74HC573锁存器） */ #define LED_ALL_OFF() do { \ HAL_GPIO_WritePin(GPIOC, 0xFF00, GPIO_PIN_SET); \ HAL_GPIO_WritePin(GPIOD, GPIO_PIN_2, GPIO_PIN_SET); \ HAL_GPIO_WritePin(GPIOD, GPIO_PIN_2, GPIO_PIN_RESET); \ } while(0)按键模块的CubeMX配置步骤如下：
- 在
Pinout & Configuration界面找到PB0、PB1、PB2和PA0引脚 - 设置为
GPIO_Input模式 - 在
System Core > GPIO中配置上拉电阻（Pull-up） - 生成代码后添加消抖处理逻辑：
uint8_t KEY_Scan(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) { static uint8_t key_up = 1; if(key_up && HAL_GPIO_ReadPin(GPIOx, GPIO_Pin) == GPIO_PIN_RESET) { HAL_Delay(10); key_up = 0; if(HAL_GPIO_ReadPin(GPIOx, GPIO_Pin) == GPIO_PIN_RESET) return 1; } else if(HAL_GPIO_ReadPin(GPIOx, GPIO_Pin) == GPIO_PIN_SET) { key_up = 1; } return 0; }2. PWM调光模块深度配置
2.1 TIM3与TIM17定时器参数详解
在CubeMX中配置PWM输出时，需要理解每个参数的实际物理意义：
| 参数项 | TIM3配置值 | TIM17配置值 | 作用说明 |
|---|---|---|---|
| Prescaler | 0 | 0 | 不分频，直接使用APB时钟 |
| Counter Mode | Up | Up | 向上计数模式 |
| Period | 999 | 499 | 决定PWM频率的关键参数 |
| Clock Division | 1 | 1 | 时钟不分频 |
| AutoReload Preload | Enable | Enable | 避免修改参数时产生毛刺 |
计算公式：
PWM频率 = APB总线频率 / (Prescaler + 1) / (Period + 1)例如当APB1频率为170MHz时，TIM3的PWM频率为：
170,000,000 / 1 / 1000 = 170kHz2.2 动态调整占空比的三种方法
方法一：直接修改CCR寄存器
TIM3->CCR1 = 500; // 50%占空比方法二：使用HAL库函数
__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, 750);方法三：通过DMA动态更新（适合波形复杂场景）
uint16_t pwmValues[100] = {...}; // 预计算的PWM值数组 HAL_TIM_PWM_Start_DMA(&htim3, TIM_CHANNEL_1, (uint32_t*)pwmValues, 100);注意：修改占空比后，如果发现输出异常，检查
HAL_TIM_PWM_Start()是否已调用。
3. ADC读取与数据处理优化
3.1 PB15引脚的多功能配置
STM32G431的ADC通道与引脚对应关系需要特别注意：
- 在CubeMX中将PB15配置为
ADC1_IN15 - 在
Parameter Settings中设置：- Resolution：12位（4096级）
- Data Alignment：右对齐
- Scan Conversion Mode：禁用
- Continuous Conversion Mode：启用
- 在
NVIC Settings中开启ADC中断（可选）
典型初始化代码：
hadc2.Instance = ADC1; hadc2.Init.ClockPrescaler = ADC_CLOCK_ASYNC_DIV1; hadc2.Init.Resolution = ADC_RESOLUTION_12B; hadc2.Init.ScanConvMode = DISABLE; hadc2.Init.ContinuousConvMode = ENABLE; hadc2.Init.DiscontinuousConvMode = DISABLE; hadc2.Init.ExternalTrigConvEdge = ADC_EXTERNALTRIGCONVEDGE_NONE; hadc2.Init.ExternalTrigConv = ADC_SOFTWARE_START; hadc2.Init.DataAlign = ADC_DATAALIGN_RIGHT; hadc2.Init.NbrOfConversion = 1; hadc2.Init.DMAContinuousRequests = DISABLE; hadc2.Init.EOCSelection = ADC_EOC_SINGLE_CONV; hadc2.Init.LowPowerAutoWait = DISABLE; hadc2.Init.Overrun = ADC_OVR_DATA_PRESERVED;3.2 电压值滤波算法实践
原始ADC读数往往存在噪声，推荐采用滑动平均滤波：
#define ADC_FILTER_LEN 10 float ADC_GetFilteredValue(ADC_HandleTypeDef* hadc) { static uint16_t adcValues[ADC_FILTER_LEN] = {0}; static uint8_t index = 0; uint32_t sum = 0; HAL_ADC_Start(hadc); adcValues[index++] = HAL_ADC_GetValue(hadc); if(index >= ADC_FILTER_LEN) index = 0; for(int i=0; i<ADC_FILTER_LEN; i++) { sum += adcValues[i]; } return (sum * 3.3f) / (ADC_FILTER_LEN * 4095.0f); }进阶方案：结合中值滤波与卡尔曼滤波，在sysWork()函数中调用时控制采样间隔：
if(HAL_GetTick() - lastAdcTime >= 20) { // 50Hz采样 currentVoltage = ADC_GetFilteredValue(&hadc2); lastAdcTime = HAL_GetTick(); }4. 系统整合与调试技巧
4.1 模块化工程结构设计
推荐的项目目录结构：
/Project |-- /Core | |-- /Src # 主业务逻辑 | |-- /Inc # 头文件 |-- /Drivers |-- /Middlewares |-- /BSP # 板级支持包 | |-- bsp_lcd.c # LCD驱动 | |-- bsp_led.c # LED控制 |-- /Application # 应用层 |-- app_pwm.c # PWM业务逻辑 |-- app_adc.c # ADC处理关键整合步骤：
- 将官方提供的LCD驱动代码放入
BSP文件夹 - 在
main.c中按顺序初始化各模块：
/* 初始化顺序不可更改 */ HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_ADC2_Init(); MX_TIM3_Init(); MX_TIM17_Init(); BSP_LCD_Init(); // 必须在GPIO之后4.2 常见问题排查指南
现象1：PWM无输出
- 检查
HAL_TIM_PWM_Start()是否调用 - 用示波器测量定时器时钟是否正常
- 验证GPIO是否配置为Alternate Function模式
现象2：ADC读数不稳定
- 在PB15引脚添加0.1uF滤波电容
- 确保采样时间足够（建议设置为
ADC_SAMPLETIME_810CYCLES_5） - 避免在ADC转换期间进行大电流操作
现象3：LCD显示异常
- 检查背光控制引脚电压
- 确认初始化时序符合规格书要求
- 在
MX_GPIO_Init()之后调用LCD初始化
调试过程中，可以充分利用STM32CubeIDE的实时变量监控功能。添加如下代码即可在调试窗口中观察关键变量：
volatile float debugVoltage = 0.0f; // 添加volatile防止优化5. 竞赛实战经验分享
去年指导学生在省赛中使用这套方案时，我们发现几个教科书上不会提及的细节：
PWM频率选择：当设置为170kHz时，LED完全没有闪烁感，但会带来可闻的线圈噪声。最终折中选用20kHz（Period=8499），既消除噪声又保证调光平滑。
ADC采样时机：在LCD刷新周期内采样会导致电压波动，通过示波器捕获发现LCD驱动芯片工作时会产生电源纹波。解决方案是在
HAL_SYSTICK_Callback()的中断间隙进行采样。堆栈溢出预防：当同时使用LCD、PWM和ADC时，默认的栈大小（0x400）可能不够。在
startup_stm32g431xx.s中将Stack_Size改为0x800可避免随机崩溃。
一个实用的调试技巧：利用LED作为状态指示灯。在关键函数入口添加：
changeLedStateByLocation(LED1, ON); // 进入函数亮灯 // ... 函数逻辑 ... changeLedStateByLocation(LED1, OFF); // 退出函数灭灯通过观察LED闪烁情况就能快速定位卡死位置。
