1. 环境准备与软件安装

蓝桥杯嵌入式竞赛的环境搭建其实没有想象中那么复杂，我参加过多届比赛，也带过不少学生，发现很多新手一开始就被各种软件安装吓到了。其实只要按照正确的顺序来，半小时就能搞定所有基础环境。

首先需要安装STM32CubeMX，这是ST官方推出的图形化配置工具，简直就是嵌入式开发的"神器"。我习惯从官网下载最新版本，目前最新的是6.10.0，安装过程中记得勾选安装STM32CubeProgrammer和相关的硬件驱动，这些在后面下载程序时会用到。

安装完CubeMX后，接着要安装Keil MDK，这是编译和调试代码的主要环境。建议选择MDK5的最新版本，安装完成后别忘了注册，社区版有32KB代码限制，但对于蓝桥杯比赛来说完全够用了。我在这里踩过坑，第一次安装时没注意注册，结果编译时总是报错，折腾了好久才发现是许可证问题。

最后一个关键组件是STM32的器件支持包。在Keil中点击Pack Installer，搜索并安装STM32F1xx系列的支持包，因为蓝桥杯比赛用的主控芯片通常是STM32F103系列。这个步骤很多新手会忽略，导致后面无法正常编译工程。

安装完所有软件后，建议先重启电脑让环境变量生效。我习惯在桌面上创建两个快捷方式：CubeMX和Keil，这样后面操作起来更方便。整个安装过程如果顺利的话，20-30分钟就能完成，为后续的开发节省大量时间。

2. CubeMX工程创建与基础配置

打开CubeMX后，第一步就是创建新工程。点击"New Project"，在芯片选择界面输入STM32F103RBT6，这就是蓝桥杯比赛常用的主控芯片型号。选中芯片后，右边会显示芯片的引脚图和资源概览，这个界面很重要，可以帮助我们快速了解芯片的资源分配。

时钟配置是CubeMX中最关键也最容易出错的部分。我建议先配置RCC（复位和时钟控制），将高速时钟（HSC）设置为外部晶振，因为比赛板子上用的是8MHz的外部晶振。然后在时钟树配置中，将系统时钟设置为72MHz，这是STM32F103的最高工作频率。记得要确保所有时钟配置都没有红色警告，否则后面运行会出问题。

SYS调试接口需要配置为Serial Wire，这样才能通过ST-Link进行程序下载和调试。这个配置在Debug标签页下，选择Serial Wire后，对应的PA13和PA14引脚会自动配置为调试接口引脚。

GPIO配置是整个工程的基础，根据比赛要求，需要配置四个独立按键：PA0、PB0、PB1、PB2都设置为上拉输入模式。流水灯和LCD屏幕的引脚需要配置为推挽输出模式，PC0-PC15用于数据和控制信号输出，PD2作为锁存器开关也要配置为输出模式。

3. 外设模块详细配置

USART串口通信在嵌入式系统中必不可少，蓝桥杯比赛中经常用于调试信息输出或者与上位机通信。在CubeMX中配置USART1为异步通信模式，波特率设置为9600，数据位8位，无校验位，停止位1位。最重要的是要开启USART1的全局中断，这样才能实现中断接收数据。

ADC模数转换器配置需要特别注意，比赛中通常使用ADC1和ADC2。IN5和IN11通道配置为单端输入模式，参数设置中要开启低功耗自动等待功能，转换次数设置为2。Rank1选择Channel 11，采样时间设置为92.5个周期，这样可以获得较好的转换精度。

定时器配置相对复杂但很重要。TIM1配置为PWM生成模式，预分频器设置为169，计数周期为4999，这样可以得到1kHz的PWM信号。TIM2配置为输入捕获模式，用于测量脉冲宽度，从模式选择复位模式，触发源选择TI1FP1。TIM3也配置为PWM模式，参数与TIM1略有不同，用于生成其他频率的PWM信号。

I2C接口配置需要特别注意，PB6和PB7引脚要配置为开漏输出模式，因为I2C总线需要支持线与功能。上拉电阻通常由外部电路提供，所以在CubeMX中不需要额外配置。

4. 时钟树与电源管理配置

时钟树配置是CubeMX中最体现技术水平的环节。首先选择HSE作为时钟源，然后配置PLL倍频器，将8MHz的外部晶振倍频到72MHz系统时钟。APB1总线时钟设置为36MHz，APB2总线时钟设置为72MHz，这些都是STM32F103的标准配置。

在电源管理配置中，需要根据实际需求选择功耗模式。比赛环境中通常不需要考虑功耗问题，所以可以保持默认配置。但如果需要低功耗功能，可以在这里配置睡眠模式或停机模式。

看门狗配置也是重要的一环，我建议在开发初期先禁用独立看门狗和窗口看门狗，等主要功能调试完成后再根据需要开启。这样可以避免在调试过程中因为看门狗复位而影响开发效率。

复位和时钟控制配置中，要确保所有使用的时钟源都正确使能。HSE和HSI都要开启，LSE和LSI可以根据实际需求选择是否开启。比赛中一般只需要HSE和HSI就够了。

5. 工程生成与Keil迁移

完成所有配置后，点击"Generate Code"生成工程代码。在工程设置中，选择MDK-ARM作为工具链，版本选择V5。工程名称和路径最好不要包含中文或特殊字符，我习惯用英文和数字组合，避免出现路径问题。

在代码生成设置中，建议勾选"生成外围设备初始化代码"和"为每个外围设备生成独立的.c和.h文件"。这样生成的代码结构更清晰，便于后续维护和调试。还可以选择生成必要的库文件，减少手动添加的工作量。

工程生成后，用Keil MDK打开生成的工程文件。第一次打开时可能会提示安装器件支持包，如果前面已经安装过，这里直接点击确定即可。工程打开后，可以看到CubeMX生成的代码结构，包括main.c、各个外设的初始化文件等。

在Keil中需要检查一下编译选项，确保优化级别设置为Level 0，这样便于调试。调试器选择ST-Link，接口选择SWD模式。这些配置都在Options for Target对话框中，需要根据实际使用的调试器进行配置。

6. 代码结构与组织解析

Keil工程的文件结构很有讲究，我习惯按照功能模块来组织代码。Main.c文件包含主循环和主要业务逻辑，外设初始化代码由CubeMX自动生成，放在gpio.c、usart.c等文件中。用户代码可以写在main.c中，也可以新建专门的模块文件。

在main函数中，HAL_Init()和SystemClock_Config()是系统初始化函数，由CubeMX自动生成。之后是各个外设的初始化函数，如MX_GPIO_Init()、MX_USART1_UART_Init()等。用户代码应该写在/* USER CODE BEGIN /和/ USER CODE END */注释之间，这样下次用CubeMX重新生成代码时，用户代码不会被覆盖。

中断处理函数由HAL库自动管理，我们只需要在CubeMX中配置好中断优先级，然后在对应的中断回调函数中编写业务逻辑即可。比如USART接收中断完成后会调用HAL_UART_RxCpltCallback()函数，我们可以在这里处理接收到的数据。

对于复杂的应用，我建议采用模块化编程方式。将按键检测、LED控制、LCD显示等功能封装成独立的模块，每个模块包含.c和.h文件。这样不仅代码结构清晰，也便于团队协作和代码复用。

7. 常见问题与调试技巧

在环境搭建过程中，最常见的问题就是编译错误。如果出现头文件找不到的错误，检查一下Include Paths是否配置正确。在Keil的Options for Target中，C/C++选项卡下的Include Paths要包含所有头文件所在的目录。

下载程序时如果连接失败，首先检查ST-Link驱动是否安装正确，然后检查接线是否正确。SWD接口只需要四根线：VCC、GND、SWDIO、SWCLK。有时候板子需要单独供电，记得打开电源开关。

程序运行异常时，可以使用Keil的调试功能进行排查。设置断点、单步执行、查看变量值都是常用的调试手段。我特别喜欢使用实时变量观察窗口，可以实时监控关键变量的变化情况。

如果外设工作不正常，首先检查时钟配置是否正确。很多问题都是由于时钟没有正确使能导致的。其次检查引脚配置，是否与其他功能冲突。最后检查初始化代码，确保参数设置正确。

8. 实战案例：流水灯与按键检测

现在我们来实际做一个简单的例子，实现流水灯效果和按键检测功能。首先在CubeMX中配置PC8-PC15为输出模式，用于控制8个LED灯。PA0、PB0、PB1、PB2配置为上拉输入，作为四个独立按键。

在Keil中编写流水灯控制代码，使用HAL_GPIO_WritePin()函数控制LED的亮灭。可以定义一个数组来存储LED的状态，通过移位操作实现流水灯效果。延时函数可以使用HAL_Delay()，简单易用但会阻塞程序运行。

按键检测采用扫描方式，在主循环中定期检测按键状态。使用HAL_GPIO_ReadPin()读取按键引脚电平，注意要添加消抖处理。最简单的消抖方法是检测到按键按下后延时10ms再次检测，如果仍然为按下状态则认为有效按键。

中断方式处理按键可以提高响应速度，但需要配置外部中断。在CubeMX中将按键引脚配置为外部中断模式，并设置中断优先级。在中断服务函数中处理按键事件，注意中断处理要尽量简短，避免长时间占用中断资源。

将LED控制和按键检测结合起来，可以实现按键控制流水灯方向、速度等功能。这是一个很好的综合练习，涵盖了GPIO输入输出、中断处理等基础知识，为后续更复杂的功能开发打下基础。

9. 进阶功能开发与优化

完成基础功能后，可以尝试更复杂的功能开发。PWM调光是一个很好的进阶练习，使用TIM1或TIM3生成PWM信号控制LED亮度。在CubeMX中配置定时器为PWM模式，在Keil中通过__HAL_TIM_SET_COMPARE()函数调节占空比。

ADC采样功能可以用于读取电位器电压值，结合PWM实现亮度调节。配置ADC1的IN5通道为单端输入模式，使用HAL_ADC_Start()和HAL_ADC_GetValue()函数获取采样值。注意ADC采样需要校准，可以使用HAL库提供的校准函数。

USART通信可以实现与上位机的数据交互，发送调试信息或接收控制命令。使用HAL_UART_Transmit()发送数据，HAL_UART_Receive_IT()中断方式接收数据。建议定义简单的通信协议，包含帧头、数据、校验等字段。

代码优化是提高程序性能的关键。减少HAL_Delay()的使用，采用状态机方式实现非阻塞延时。优化中断服务函数，尽量减少中断处理时间。使用DMA传输数据，减轻CPU负担。这些优化技巧在资源有限的嵌入式系统中尤为重要。

10. 比赛准备与实战建议

蓝桥杯嵌入式比赛不仅考察技术能力，也考验项目规划和调试能力。我建议在赛前准备好常用的代码模块，如按键处理、LED控制、LCD显示、串口通信等，这样在比赛中可以快速搭建基础框架。

比赛过程中要合理分配时间，先完成基础功能，再实现高级功能。遇到问题时不要慌张，使用Keil的调试工具逐步排查。串口打印调试信息是一个很有效的方法，可以帮助快速定位问题。

代码版本管理也很重要，每完成一个功能就备份一次代码。可以使用U盘或者云存储定期备份，避免因为意外丢失代码。注释要写清楚，方便自己和队友阅读代码。

最后要注意比赛规则，严格按照要求完成功能。提交前要全面测试各个功能，确保没有明显bug。保持代码整洁规范，这也会影响评分。