1. 工程创建前的准备工作第一次接触蓝桥杯嵌入式比赛的同学拿到这块STM32G431RBT6开发板时可能会有点懵。别担心我去年参赛时也经历过这个阶段。今天我就把从零开始搭建工程的完整流程包括那些官方文档里没写的细节全都分享给大家。首先你得准备好三样东西Keil MDK-ARM开发环境建议用5.25以上版本、STM32G4系列的设备支持包、以及STM32CubeMX配置工具。这里有个坑要注意CubeMX和Keil的安装路径最好不要带中文和空格我之前因为路径问题折腾了半天才搞定。开发板连接电脑后记得安装DAP调试器的驱动。如果设备管理器里看到未知设备可以去ST官网下载ST-Link驱动。虽然板载的是DAP调试器但ST-Link驱动是通用的。安装好后你会在设备管理器里看到STMicroelectronics STLink USB设备。2. CubeMX工程配置详解打开CubeMX后点击Start New Project在MCU选择界面输入STM32G431RBT6。这里有个细节输入型号时记得切换成英文输入法否则会出现输入一个字母显示两个字母的bug。选型时注意别选成STM32G431RBT6TR带TR的是卷带包装版本虽然芯片一样但容易混淆。时钟配置是第一个重点。STM32G431的时钟树比F1系列复杂不少但比赛用到的配置其实很固定。开发板上的24MHz晶振接在OSC_IN和OSC_OUT引脚上所以在RCC配置里要把HSE选为Crystal/Ceramic Resonator。然后进入Clock Configuration标签页在PLL Source Mux选择HSE将PLLM分频器设为324MHz/38MHzPLLN倍频设为208MHz*20160MHzPLLP分频设为2160MHz/280MHz系统时钟最后将系统时钟源选择为PLLCLK这样配置后SYSCLK就是比赛常用的80MHz了。记得检查APB1和APB2的时钟频率是否正确外设的时钟上限不同配置错了会导致外设无法工作。3. 关键外设初始化配置串口调试接口必须配置否则下载一次程序后就得重新上电才能再次下载。在CubeMX的Pinout视图里找到SYS-Debug选择Serial Wire。这样PA13和PA14引脚就会被配置为SWD接口既不影响调试也不占用串口资源。GPIO配置要根据比赛题目来定但有几个固定套路LED通常接在PB0-PB7配置为GPIO_Output按键接在PA0和PA1配置为GPIO_InputADC通道通常用PA4电位器和PA5光敏电阻USART1建议预先配置好方便调试时打印信息。在Connectivity标签下启用USART1模式选择Asynchronous波特率设为115200。引脚会自动映射到PA9(TX)和PA10(RX)。4. 生成Keil工程的关键设置在Project Manager标签页里填写工程名称和路径后有几点要特别注意Toolchain/IDE选择MDK-ARM V5在Code Generator里勾选Generate peripheral initialization as a pair of .c/.h files一定要勾选Keep User Code when re-generating最后点击GENERATE CODE生成工程。如果弹出安装固件包的提示要选择比赛指定的版本通常是STM32G4xx_DFP 1.4.0。我遇到过因为固件包版本不对导致编译失败的情况这点要格外注意。5. Keil工程的环境配置打开生成的MDK-ARM工程后先进行必要的配置点击魔术棒图标进入Options for Target在Debug选项卡选择CMSIS-DAP Debugger点击SettingsPort选择SWMax Clock可以设为4MHz勾选Reset and Run这样下载后程序会自动运行在Output选项卡勾选Create HEX File有个隐藏设置很重要在C/C选项卡的Define里添加USE_FULL_LL_DRIVER。这样可以使用轻量级的LL库相比HAL库更节省资源适合比赛这种对代码大小有严格要求的场景。6. 用户代码的编写规范在main.c文件中找到USER CODE BEGIN和USER CODE END之间的区域。所有自定义代码都必须写在这两个标记之间否则重新生成代码时会被覆盖。我建议按照功能模块来组织代码/* USER CODE BEGIN PV */ // 全局变量定义区 uint8_t led_status 0; /* USER CODE END PV */ /* USER CODE BEGIN PFP */ // 函数声明区 void LED_Display(uint8_t pattern); /* USER CODE END PFP */ int main(void) { /* USER CODE BEGIN 1 */ // 初始化代码 /* USER CODE END 1 */ while (1) { /* USER CODE BEGIN 3 */ // 主循环代码 LED_Display(0x55); HAL_Delay(500); LED_Display(0xAA); HAL_Delay(500); /* USER CODE END 3 */ } } /* USER CODE BEGIN 4 */ // 自定义函数实现 void LED_Display(uint8_t pattern) { GPIOB-ODR (GPIOB-ODR 0xFF00) | pattern; } /* USER CODE END 4 */对于需要频繁调用的函数建议使用LL库直接操作寄存器速度比HAL库快很多。比如上面的LED_Display函数就是用LL库的方式实现的。7. 常见问题排查指南第一次使用这套开发环境难免会遇到各种问题。下面是我总结的几个典型问题及解决方法程序下载失败检查调试器连接是否正常确认Options for Target - Debug里选择了正确的调试器尝试降低SWD时钟频率1MHz以下程序运行异常检查时钟配置是否正确特别是PLL倍频设置确认复位电路正常必要时手动复位查看HardFault_Handler中的错误信息代码大小超出限制使用LL库替代HAL库开启编译器优化O1级别移除不必要的库函数和中间件外设不工作检查CubeMX中的引脚分配是否有冲突确认外设时钟已使能查看对应外设的初始化代码是否正确生成8. 比赛实战技巧根据我去年参赛的经验比赛时要注意以下几点工程备份每完成一个功能模块就备份一次工程我习惯用工程名日期功能的命名方式比如LED_Blink_20230301。代码复用提前准备好常用功能的代码片段比如LED显示函数按键扫描函数定时器中断服务程序ADC采样函数调试技巧善用GPIO引脚作为调试信号输出在关键代码处插入LED闪烁作为执行标记使用sprintf和USART输出调试信息时间管理先完成基础功能再考虑优化遇到难题先跳过做完其他题目再回头解决最后留出足够时间生成hex文件和整理工程比赛用的开发板资源有限要特别注意内存使用情况。STM32G431RBT6只有128KB Flash和32KB RAM在变量定义时要精打细算。全局变量尽量用uint8_t等小类型大数组可以考虑加const修饰符存放到Flash中。