2. 开发环境搭建：Keil MDK安装与配置、STM32CubeMX安装、驱动与固件包管理
做嵌入式开发，环境搭建是第一道坎。很多人觉得不就是装个软件嘛，但我在项目里见过太多因为环境没配好，浪费一两天时间的案例。说白了，工具链顺了，后面调试才顺。这一章咱们就把Keil MDK、STM32CubeMX和固件包管理这些基础打牢。
2.1 为什么选择Keil MDK + STM32CubeMX？
你可能用过IAR、GCC或者其他的IDE。我个人习惯在STM32L4项目上用Keil MDK，原因很简单：
- 生态成熟： ST官方很多参考代码和例程都是基于Keil的，遇到问题好找资料。
- 调试器支持好： 对J-Link、ST-Link的支持非常稳定，我很少遇到连接不上的情况。
- 编译效率： ARMCC编译器对Cortex-M4内核的优化做得不错，代码密度和性能都挺好。
而STM32CubeMX呢？它是ST官方推出的图形化配置工具。你想想看，以前配个时钟树、管脚复用，得翻几百页数据手册。现在用CubeMX，点几下鼠标就生成了初始化代码。我刚开始用的时候，确实觉得这东西省了不少事。
2.2 Keil MDK安装与配置
安装Keil MDK其实不复杂，但有几个坑要注意。我曾经帮一个同事排查了半天，结果发现他装的是旧版本，不兼容STM32L4的芯片包。
2.2.1 下载与安装步骤
- 获取安装包： 去Keil官网（www.keil.com）下载MDK-ARM最新版本。目前我用的是5.38，稳定且支持L4系列。
- 运行安装程序： 以管理员身份运行，路径不要带中文。我习惯装到
C:\Keil_v5，方便后续找文件。 - 选择组件： 安装时勾选所有组件，尤其是“Cortex-M Device Support”和“ARM Compiler”。
- 激活License： 如果你有正版License，在File -> License Management里添加。没有的话，评估版也能用，就是代码限制在32KB以内。对于学习来说，够用了。
2.2.2 配置芯片包与编译器
装完Keil后，第一件事就是装芯片包。没有芯片包，你连STM32L4的型号都选不了。
- 在线安装： 打开Keil，点击
Pack Installer，搜索“STM32L4”，找到对应的DFP（Device Family Pack），点击Install。网速慢的话，等一会儿就好。 - 离线安装： 如果你在封闭网络环境，可以去Keil官网下载离线包，手动双击安装。
编译器方面，我建议用ARMCC V6。相比V5，V6的编译速度更快，代码优化也更好。在Project -> Options for Target -> Target里，把ARM Compiler选成“Use default compiler version 6”。
| 编译器版本 | 优点 | 缺点 |
|---|---|---|
| ARMCC V5 | 兼容性好，老项目迁移方便 | 编译慢，优化一般 |
| ARMCC V6 | 编译快，代码密度高 | 部分老语法不兼容 |
2.3 STM32CubeMX安装与使用
CubeMX是ST官方工具，用来生成初始化代码和配置外设。对于低功耗设计来说，它的功耗计算器功能特别好用。
2.3.1 安装步骤
- 下载： 去ST官网搜索“STM32CubeMX”，下载最新版本。目前我用的是6.10.0。
- 安装： 需要Java运行环境（JRE）。如果电脑没有，安装程序会自动帮你装。路径同样不要有中文。
- 更新固件包： 打开CubeMX，点击Help -> Manage embedded software packages，选择STM32L4系列，下载最新固件包。这个包包含了HAL库、LL库和各种中间件。
2.3.2 快速上手：生成一个最小工程
咱们来走一遍流程，生成一个STM32L476RG的最小工程：
- 打开CubeMX，点击“New Project”。
- 在Part Number里搜索“STM32L476RG”，双击选中。
- 在Pinout & Configuration里，配置一个LED引脚（比如PA5），设置为GPIO_Output。
- 在Clock Configuration里，配置时钟源为HSI，主频设为80MHz。
- 点击Project -> Generate Code，选择Toolchain为MDK-ARM V5（兼容V6），生成代码。
生成完成后，用Keil打开工程，编译下载。如果LED能亮，说明环境搭建成功了。
2.4 驱动与固件包管理
固件包管理，说白了就是管理HAL库、LL库和中间件的版本。我见过有人用旧版库，结果新芯片不兼容，折腾半天才发现是库版本问题。
2.4.1 固件包的结构
STM32L4的固件包（STM32Cube_FW_L4）包含以下内容：
| 目录 | 内容 |
|---|---|
| Drivers | HAL库、LL库、CMSIS核心文件 |
| Middlewares | USB、FATFS、FreeRTOS等中间件 |
| Projects | 官方例程，可以直接参考 |
| Utilities | 一些工具脚本和模板 |
我个人习惯把固件包放在 C:\STM32Cube\Repository 里，方便多个工程共用。别每个工程都复制一份，太占空间。
2.4.2 如何管理多个版本？
有时候，不同项目需要不同版本的库。比如老项目用1.8.0，新项目用1.10.0。CubeMX的固件包管理器支持多版本共存：
- 在CubeMX里，点击Help -> Manage embedded software packages。
- 选择STM32L4系列，你会看到已安装的版本列表。
- 可以安装多个版本，生成工程时选择对应的版本就行。
2.5 知识体系总览
下面这张图，帮你理清开发环境搭建的整体逻辑：
2.6 常见问题与避坑
最后，分享几个我在项目中遇到过的实际问题：
- 编译报错“找不到芯片”： 多半是芯片包没装或者版本不对。去Pack Installer里检查一下，重新安装。
- 下载程序时提示“Flash Download Failed”： 检查一下调试器设置。我遇到过ST-Link固件版本太旧，升级一下就好了。
- CubeMX生成的代码编译不过： 看看是不是Keil版本太老。有些新库需要V6编译器，老版本Keil不支持。