1. 环境准备与软件安装

蓝桥杯嵌入式竞赛使用的STM32G431RBT6开发板需要搭建合适的开发环境。我刚开始接触这个板子时，也被各种软件配置搞得头大，后来慢慢摸索出了一套高效的方法。STM32CubeMX和Keil5是官方推荐的开发工具组合，一个负责硬件初始化，一个负责代码编写和调试，配合使用能大大提升开发效率。

STM32CubeMX是ST官方推出的图形化配置工具，它可以通过直观的界面配置芯片的时钟、引脚和外设，然后自动生成初始化代码。这对于初学者特别友好，不需要手动编写大量底层寄存器配置代码。Keil5则是经典的嵌入式开发IDE，提供完整的编辑、编译、调试功能链。

1.1 软件下载与安装

首先需要获取这两个软件。STM32CubeMX可以在ST官网下载，但蓝桥杯组委会通常会在比赛资料包中提供定制版本，这个版本已经包含了竞赛需要的所有芯片支持包，避免了自己下载时可能遇到的兼容性问题。我一般会直接使用官方资料包里的版本，这样最稳妥。

Keil5的安装稍微复杂一些，需要先下载安装包然后激活。这里有个小技巧：安装路径一定要全英文，很多同学喜欢用中文目录名，结果后期编译时各种奇怪错误。安装完成后记得安装设备支持包，对于STM32G4系列，需要下载DFP包，这个在Keil的Pack Installer里可以直接找到并安装。

提示：如果遇到软件激活问题，可以尝试使用Keil官方提供的社区版，它有32KB代码限制，但对于蓝桥杯竞赛项目来说完全够用了。

2. 工程创建与芯片配置

打开STM32CubeMX后，第一步就是创建新工程。点击"Start New Project"，在芯片选择界面输入STM32G431RBT6，注意不要选错型号，因为STM32系列型号繁多，选错了会导致后续配置无法正常使用。

芯片选好后会进入主配置界面，这里可以看到芯片的引脚图和所有可用外设。蓝桥杯竞赛常用的外设包括GPIO、定时器、UART、ADC等，都需要在这里进行初始配置。我建议先配置时钟树，因为时钟是芯片工作的基础，配置不好会导致各种时序问题。

2.1 时钟树配置详解

时钟树配置是STM32CubeMX中最关键也最容易出错的部分。STM32G431RBT6使用8MHz外部晶振，通过PLL倍频到80MHz主频。在Clock Configuration标签页中，需要将HSE设置为Crystal/Ceramic Resonator，然后在PLL配置中将VCO输入频率设置为8MHz，倍频系数设为20，这样就能得到80MHz的系统时钟。

这里有个坑我踩过好几次：PLL的输入频率有范围限制，不能随意设置。STM32G4的PLL输入频率需要在4-16MHz之间，输出频率最高可达170MHz，但蓝桥杯要求使用80MHz，所以设置倍频系数为10倍就好。配置完成后，检查各个总线时钟是否在允许范围内，特别是APB1和APB2总线，它们连接着各种外设，时钟超限会导致外设工作异常。

2.2 调试接口配置

在System Core中配置调试接口非常重要但却经常被忽略。SWD（Serial Wire Debug）是推荐的调试方式，只需要两根线（SWDIO和SWCLK）就能实现调试和烧录功能。在Pinout界面中找到SYS->Debug，选择Serial Wire，这样PA13和PA14引脚就会被配置为SWD接口。

如果不配置这个选项，第一次烧录程序后SWD接口可能会被禁用，导致无法再次烧录，只能通过复位引脚或电源循环来恢复。我刚开始时就遇到过这种情况，后来才知道必须在CubeMX中提前配置好调试接口。

3. 外设模块配置实战

蓝桥杯竞赛中常用的外设包括GPIO、定时器、UART等，每个都需要仔细配置。GPIO是最基础的外设，用于控制LED、按键等。在CubeMX中点击对应引脚，选择GPIO_Output或GPIO_Input模式，还可以设置上拉/下拉电阻、输出速度和初始状态。

定时器配置稍微复杂些。STM32G431有多个定时器，高级定时器如TIM1、TIM8，通用定时器如TIM2-TIM5，基本定时器如TIM6、TIM7。PWM输出通常使用通用定时器，在Configuration标签页中设置预分频器、自动重装载值和PWM模式。比如要生成1kHz的PWM，在80MHz时钟下，预分频器设为80-1，自动重装载值设为1000-1，这样就能得到精确的1kHz频率。

3.1 UART串口配置

串口通信是调试和数据显示的重要工具。STM32G431有多个UART接口，通常使用USART1。在Connectivity中选择USART1，模式设为Asynchronous，波特率常用115200。数据位8位，停止位1位，无校验位是标准配置。

这里有个实用技巧：使能串口中断和DMA可以提高通信效率。如果只是用于调试输出，使用轮询方式就足够了；但如果需要大量数据传输，建议使用DMA方式，这样可以减少CPU占用。我在项目中通常会同时启用中断和DMA，根据实际需求选择使用哪种方式。

3.2 ADC模数转换器配置

ADC用于读取模拟信号，比如电位器电压或传感器数据。STM32G431的ADC分辨率可达12位，采样速率快。在Analog中选择ADC1，启用需要的通道，设置采样时间和转换模式。对于蓝桥杯竞赛，通常使用单次转换模式就够了，如果需要连续采样，可以使用连续转换模式。

ADC时钟需要特别注意，它来自APB2总线，但最大频率不能超过80MHz。STM32G431的ADC预分频器可以设置为1、2、4、6、8、10、12、16、32、64、128、256，需要根据系统时钟计算合适的分频值，确保ADC时钟不超过限制。

4. 代码生成与Keil5工程设置

外设配置完成后，点击Project Manager设置工程信息。工程名称不要用中文，路径也不要包含中文空格等特殊字符。Toolchain/IDE选择MDK-ARM V5，这是Keil5的工程格式。在Code Generator中建议选择"Generate peripheral initialization as a pair of '.c/.h' files per peripheral"，这样每个外设的初始化代码会单独成对出现，便于阅读和维护。

点击GENERATE CODE生成工程，这个过程会自动创建完整的Keil工程文件和所有初始化代码。第一次生成时，CubeMX会下载需要的芯片支持包，需要保持网络连接。生成完成后，点击Open Project会自动在Keil5中打开工程。

4.1 Keil5工程结构解析

打开的Keil工程包含多个分组：Application/MDK-ARM包含启动文件和链接脚本，Drivers包含HAL库和CMSIS文件，Src和Inc包含用户代码。我建议先浏览一下生成的文件结构，了解各个文件的作用。

main.c中已经包含了外设初始化代码和空的主循环。HAL_Init()初始化HAL库，SystemClock_Config()配置系统时钟，这些都是CubeMX自动生成的，一般不需要修改。MX_GPIO_Init()、MX_USART1_UART_Init()等函数初始化各个外设，这些函数在main()中按顺序调用。

注意：自动生成的代码中有很多注释段，比如/* USER CODE BEGIN XXX */和/* USER CODE END XXX */，在这些标记之间的代码会在重新生成时保留，之外的部分会被覆盖。所以自定义的代码一定要放在这些保护块之间。

4.2 编译配置与优化

在Keil5的Options for Target对话框中，需要检查几个重要设置。Target标签页中确认芯片型号是STM32G431RBT6，Xtal（晶振频率）设置为8.0MHz。Output标签页中勾选Create HEX File，这样编译后会生成HEX烧录文件。

C/C++标签页中，Define一栏通常已经包含了USE_HAL_DRIVER和STM32G431xx等宏定义。Include Paths包含了所有头文件路径，这些都是自动设置的，不要随意修改。Optimization等级建议使用-O0 during debugging，这样调试时变量不会被优化掉，等代码稳定后再改为-O2以提高性能。

Debug标签页中选择使用CMSIS-DAP Debugger或ST-Link Debugger，具体取决于使用的调试器。Settings中确认Port是SW，时钟频率设为4MHz左右即可。Flash Download中勾选Reset and Run，这样程序烧录后会自动运行。

5. 编程技巧与调试方法

HAL库提供了丰富的API函数，封装了底层寄存器操作，让编程更加简单。比如控制LED可以使用HAL_GPIO_WritePin()和HAL_GPIO_TogglePin()，读取按键使用HAL_GPIO_ReadPin()。串口发送数据使用HAL_UART_Transmit()，接收数据可以使用HAL_UART_Receive()或中断方式。

定时器PWM输出使用HAL_TIM_PWM_Start()启动，用__HAL_TIM_SET_COMPARE()改变占空比。ADC采样使用HAL_ADC_Start()和HAL_ADC_GetValue()获取采样值。这些函数都有统一的命名规范，熟悉后很容易记忆和使用。

5.1 常见问题排查

编译时最常见的错误是头文件找不到或函数未定义，这通常是因为包含路径不正确或必要的源文件没有添加到工程中。Keil5的错误信息比较详细，双击错误可以直接定位到出错位置。如果遇到奇怪的编译错误，可以尝试Rebuild All而不是只是Build。

调试时如果程序运行不正常，首先检查时钟配置是否正确。我习惯在main()开始时先添加一个简单的LED闪烁代码，如果LED能正常闪烁，说明至少时钟和GPIO是工作正常的。然后逐步添加其他功能，每步都测试确认，这样容易定位问题。

串口调试是重要的调试手段，可以使用printf重定向到串口。在usart.c中添加以下代码：

#include <stdio.h>

#ifdef __GNUC__
#define PUTCHAR_PROTOTYPE int __io_putchar(int ch)
#else
#define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f)
#endif

PUTCHAR_PROTOTYPE
{
    HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, 0xFFFF);
    return ch;
}

然后在main.c中就可以直接使用printf输出调试信息了。注意需要包含stdio.h头文件，并在Keil的Options for Target->Target中勾选Use MicroLIB。

5.2 性能优化建议

虽然HAL库使用方便，但执行效率相对较低，在需要高性能的场景可以考虑直接寄存器操作或使用LL库。比如频繁调用的GPIO操作，可以使用寄存器直接操作：

// 代替HAL_GPIO_TogglePin()
GPIOA->ODR ^= GPIO_PIN_5;

对于时间敏感的代码段，可以暂时关闭中断：

__disable_irq();
// 关键代码段
__enable_irq();

ADC采样可以使用DMA方式连续采样，减少CPU干预。定时器可以配置为从模式，实现硬件自动触发ADC采样，进一步提高采样精度和实时性。

6. 烧录与实战建议

程序编译通过后，点击Keil5的Load按钮即可烧录到开发板。烧录前确保调试器连接正确，开发板供电正常。如果烧录失败，检查调试器驱动是否安装，连接线是否完好，还可以尝试降低SWD时钟频率。

蓝桥杯竞赛中，除了代码功能正确外，稳定性和鲁棒性也很重要。建议添加看门狗功能，防止程序跑飞。在main循环中定期喂狗：

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_USART1_UART_Init();
    MX_IWDG_Init(); // 初始化独立看门狗
    
    while (1)
    {
        // 用户代码
        HAL_IWDG_Refresh(&hiwdg); // 喂狗
    }
}

对于输入信号添加软件滤波，比如按键去抖动，ADC采样多次取平均。输出信号考虑异常情况保护，比如PWM占空比限制在安全范围内。

实际开发中，我习惯先用CubeMX配置好基础外设，生成工程框架后再添加业务逻辑。每次修改硬件配置后，重新生成代码前记得备份自己编写的代码，因为重新生成会覆盖保护块之外的内容。版本控制工具如Git可以很好地管理代码变更，建议即使是个人项目也使用版本控制。

多使用断点调试和变量监视功能，复杂问题可以使用Keil5的Event Recorder和System Analyzer进行性能分析。这些工具可以帮助定位深层问题，提高调试效率。最重要的是多实践多总结，每个项目都会遇到不同的问题，积累的经验是最宝贵的财富。