2. 开发环境搭建：STM32CubeMX安装、STM32CubeIDE配置、X-CUBE-AI扩展包安装
好，咱们正式开始动手。这一章，说白了就是搭台子。台子搭不好，后面唱戏全得摔跟头。我见过太多新手，一上来就急着写代码，结果环境没配好，折腾半天连个LED都点不亮。嗯，咱们别走弯路，一步步来。
2.1 STM32CubeMX安装：图形化配置的第一步
STM32CubeMX是什么？它就是个图形化的配置工具。你点点鼠标，它就能帮你生成初始化代码。我个人习惯，所有STM32项目都从它开始。
安装步骤：
- 去ST官网下载最新版STM32CubeMX。注意，需要注册账号，免费。
- 双击安装包，一路Next。安装路径别带中文，我吃过这个亏。
- 安装完成后，打开软件。它会提示你安装固件包。别急，先关掉。
安装好后，你可以在菜单栏的Help -> Manage embedded software packages里下载你需要的固件包。比如你要用STM32F4系列，就下载STM32F4的包。下载速度可能有点慢，建议挂个代理，或者趁午休时挂着下载。
2.2 STM32CubeIDE配置：真正的开发主战场
STM32CubeIDE，说白了就是ST官方基于Eclipse打造的IDE。它集成了编译器、调试器，还跟CubeMX深度绑定。我个人觉得，比Keil好用，至少免费。
安装与配置要点：
- 同样去ST官网下载，同样免费。安装时注意选择组件，默认就行。
- 第一次启动，它会让你选择工作空间（workspace）。我建议单独建一个文件夹，比如
D:\STM32_Workspace。别放C盘，你懂的。 - 导入CubeMX项目时，直接点File -> Import -> Existing Projects。它会自动识别.ioc文件。
配置编译器时，注意选择正确的工具链。STM32CubeIDE自带GCC，一般不用额外装。但如果你要用IAR或Keil，得单独配置。我在项目中遇到过，客户非要Keil，结果折腾了半天路径映射。嗯，从那以后我尽量说服客户用CubeIDE。
2.3 X-CUBE-AI扩展包安装：AI落地的关键
X-CUBE-AI，这才是咱们课程的核心。它能把训练好的神经网络模型，转换成能在STM32上跑的C代码。你想想看，一个几百KB的模型，压缩后塞进单片机里，还能实时推理，是不是很酷？
安装步骤：
- 在CubeMX里，点击菜单栏的Help -> Manage embedded software packages。
- 在搜索框里输入
X-CUBE-AI，找到对应版本。我建议用最新稳定版，别追新。 - 勾选后点击Install。它会自动下载并安装。安装完成后，在CubeMX的Pinout & Configuration界面里，你会看到 Software Packs 选项卡下多了一个 X-CUBE-AI。
安装完成后，怎么验证？很简单：
- 打开CubeMX，新建一个项目，选好芯片型号。
- 在Software Packs里，点击Select Components，找到X-CUBE-AI，勾上。
- 如果能看到 AI 相关的配置选项，说明安装成功。
这里有个坑：X-CUBE-AI对芯片的RAM和Flash有要求。太小的芯片，比如STM32F0系列，基本跑不了AI模型。我建议至少用STM32F4或G4系列，H7系列更佳。你想想看，模型推理需要内存，太小了连输入数据都放不下。
2.4 环境验证：跑通第一个AI示例
环境搭好了，咱们得验证一下。ST官方提供了很多示例，咱们挑一个最简单的。
验证步骤：
- 在CubeMX里，选择你的开发板型号。我用的是NUCLEO-F767ZI。
- 在Software Packs里，选择X-CUBE-AI，然后选一个预训练模型，比如
image_classification。 - 生成代码，然后在CubeIDE里编译、下载。
- 打开串口助手，看输出。如果能看到分类结果，说明环境没问题。
如果编译报错，别慌。先看错误信息，八成是路径问题或者库版本不匹配。我遇到过最离谱的一次，是X-CUBE-AI版本跟CubeIDE的GCC版本不兼容，换了旧版X-CUBE-AI就好了。嗯，有时候稳定比新功能重要。
2.5 总结：环境搭建的黄金法则
环境搭建，说白了就是三个字：稳、准、狠。
- 稳：用稳定版软件，别追新。
- 准：路径全英文，版本匹配。
- 狠：遇到问题别犹豫，直接重装。我有时候花半小时排查，不如花十分钟重装来得快。
好了，环境搭好了，下一章咱们就开始真正接触AI模型部署了。到时候，你会看到X-CUBE-AI是怎么把模型“塞”进STM32里的。期待一下吧。