1. 课程导学与开发环境搭建
大家好，欢迎来到《STM32CubeMX生成I2C与SPI驱动开发实战》的第一章。
说实话，我见过太多工程师在I2C和SPI上栽跟头。明明时序图看得懂，代码写出来就是不通。问题出在哪？多半是工具没用对，或者环境没搭好。这一章，咱们先把地基打牢。
1.1 STM32CubeMX是什么？
STM32CubeMX，说白了就是ST官方出的一款图形化配置工具。你点点鼠标，它就能帮你生成初始化代码。省去你翻数据手册、查寄存器的时间。
我个人习惯，拿到一个新项目，第一件事就是打开CubeMX。为什么？因为它能帮你避免很多低级错误。比如引脚冲突、时钟配置不对——这些坑，我早年都踩过。
核心价值： CubeMX不是帮你写业务逻辑，而是帮你把芯片“初始化”这件事做到极致。你只需要关注驱动和应用层。
1.2 安装与配置——别跳过这一步
安装CubeMX其实很简单，但有几个细节我得提醒你。
- 下载Java运行环境（JRE）：CubeMX基于Java，必须先装JRE。版本别太老，建议Java 8以上。
- 从ST官网下载CubeMX：注意区分Windows/Linux/Mac版本。
- 安装路径不要有中文：我遇到过因为路径带中文，导致固件包下载失败的情况。嗯，这点很坑。
- 首次启动后安装固件包：在Help → Manage embedded software packages里，选择你用的芯片系列，比如STM32F1、F4、H7等。
避坑指南： 我曾经在项目中期才发现CubeMX版本太旧，生成的HAL库有bug。后来我养成了一个习惯——每次新项目都去ST官网看看有没有新版。别偷懒，这能省你三天调试时间。
1.3 MDK-ARM / IAR IDE 安装
CubeMX生成的是工程文件，你还得有个IDE来编译和下载。主流选择就两个：Keil MDK-ARM 和 IAR Embedded Workbench。
| 对比项 | Keil MDK-ARM | IAR EWARM |
|---|---|---|
| 上手难度 | 较低，资料多 | 中等，界面稍复杂 |
| 编译效率 | 一般 | 较高，优化选项丰富 |
| 调试体验 | 稳定，支持J-Link/ST-Link | 稳定，支持多种调试器 |
| 价格 | 较贵（但有免费版限制代码大小） | 较贵（有30天试用） |
| 社区资源 | 非常丰富 | 相对少一些 |
我个人建议：初学者先用Keil，资料多、遇到问题好搜。等你有经验了，再试试IAR，它的代码优化确实更好。
小技巧： 安装Keil时，记得勾选“添加环境变量”。这样你可以在命令行里直接调用编译器，方便做自动化构建。
1.4 STM32开发板介绍
咱们这门课，我选的是STM32F407VGT6这款芯片。为什么选它？
- 性能够用：Cortex-M4内核，带FPU，跑I2C和SPI绰绰有余。
- 外设丰富：有3个I2C、3个SPI，足够咱们折腾。
- 价格适中：不像H7那么贵，也不像F1那么老。
你手头如果有其他开发板也没关系。CubeMX支持全系列STM32，配置思路是一样的。你只需要在选芯片时换成你自己的型号就行。
下面这张图，是我画的本章知识体系。你看一眼，心里就有数了。
1.5 开发流程总览
咱们这门课，整个开发流程是这样的：
- CubeMX配置：选芯片、配时钟、使能I2C/SPI外设、配置引脚。
- 生成代码：CubeMX帮你生成HAL库初始化代码。
- IDE打开工程：在Keil或IAR里打开生成的工程。
- 编写驱动：在生成的框架里，添加你的I2C/SPI读写函数。
- 编译下载：烧录到开发板，验证功能。
你想想看，如果没有CubeMX，你得手动配置时钟树、查引脚复用表、写寄存器初始化代码。一个I2C初始化，少说也得写上百行。现在呢？点几下鼠标就搞定了。
我的建议： 别把CubeMX当成“黑盒子”。它生成的代码，你最好打开看看。理解它帮你做了什么，你才能真正掌握I2C和SPI。后面几章，我会带着你一行一行分析生成的代码。
1.6 本章小结
这一章，咱们把工具链捋了一遍。从CubeMX是什么，到怎么装，再到IDE选哪个，最后认识了咱们的开发板。
嗯，说实话，环境搭建这一步最枯燥，但也最重要。我见过太多人，代码写了一半才发现编译器版本不对，或者CubeMX固件包没装全。与其到时候抓狂，不如一开始就按部就班来。