2. 开发环境搭建：STM32CubeMX安装、STM32CubeIDE安装、X-CUBE-AI扩展包安装、固件包准备

好，咱们正式开始动手。这一章说白了就是「把家伙事儿备齐」。很多朋友一上来就急着写代码，结果装个工具链折腾半天，最后发现版本不匹配——这种事我见得太多了。

我个人习惯是，先把环境理清楚，再动手。你想想看，如果连IDE都打不开，后面那些AI模型推理性能测试根本跑不起来。所以，咱们一步步来。

2.1 STM32CubeMX 安装

STM32CubeMX 是 ST 官方出品的图形化配置工具。它的核心作用就一个：帮你生成初始化代码，省去手动配置时钟树、外设、引脚这些繁琐工作。

安装步骤：

  1. 去 ST 官网下载最新版 STM32CubeMX（需要注册账号，免费）。
  2. 双击安装包，一路 Next。注意安装路径不要带中文。
  3. 安装完成后，首次启动会提示你安装 Java 运行环境。嗯，这里要注意——CubeMX 依赖 Java，如果电脑里没有 JRE，它会自动帮你装一个。
  4. 启动后，界面长这样：左侧是工程管理，右侧是芯片选型。
我的小经验： 我建议把 CubeMX 安装在 C 盘默认路径。以前我试过改到 D 盘，结果某些固件包路径解析出问题，折腾了半小时。后来就老实了。

2.2 STM32CubeIDE 安装

STM32CubeIDE 是 ST 官方的集成开发环境，基于 Eclipse 魔改而来。它集成了编译器、调试器、代码编辑等功能。说白了，你写代码、编译、下载、调试，全在这一个工具里完成。

安装步骤：

  1. 同样从 ST 官网下载 STM32CubeIDE 安装包。注意区分 Windows、Linux、macOS 版本。
  2. 安装过程比较慢，因为要解压很多组件。我建议你泡杯咖啡等着。
  3. 安装完成后，首次启动会让你选择工作空间（Workspace）。我个人习惯在项目根目录下建一个 workspace 文件夹，方便管理。
  4. 启动后，界面默认是英文。如果你看着不习惯，可以在 Help → Install New Software 里安装中文语言包。不过我个人建议用英文版，因为很多报错信息是英文的，切来切去反而容易懵。
避坑指南： 我曾经遇到过 CubeIDE 和 CubeMX 版本不匹配导致工程打不开的情况。解决办法很简单：尽量保持两个工具都是最新版，或者至少大版本号一致。

2.3 X-CUBE-AI 扩展包安装

X-CUBE-AI 是 ST 官方推出的 AI 推理扩展包。它的作用是把训练好的神经网络模型（比如 TensorFlow Lite、Keras、ONNX）转换成可以在 STM32 上运行的 C 代码。

安装方式有两种：

  • 方式一：通过 CubeMX 在线安装

打开 CubeMX，点击 Help → Manage Embedded Software Packages。在搜索框里输入 X-CUBE-AI，勾选对应版本，点击 Install。嗯，这里要注意——在线安装速度取决于你的网络。我建议用手机热点或者换个时间段试试。

  • 方式二：手动下载安装

去 ST 官网下载 X-CUBE-AI 的压缩包。解压后，在 CubeMX 的 Manage Embedded Software Packages 界面，点击 From Local，选择解压后的文件夹即可。

关键点： X-CUBE-AI 的版本必须和你的 CubeMX 主版本匹配。比如 CubeMX 6.x 对应 X-CUBE-AI 7.x。版本不对，模型转换时会报一堆莫名其妙的错误。

2.4 固件包准备

固件包（Firmware Package）是 ST 官方为每个芯片系列提供的底层驱动库。比如你要用 STM32F4 系列，就需要下载 STM32CubeF4 固件包。

下载方式：

  1. 在 CubeMX 的 Manage Embedded Software Packages 界面，找到你芯片对应的固件包。
  2. 点击 Install，等待下载完成。固件包通常比较大（几百 MB），建议用有线网络。
  3. 安装完成后，在 CubeMX 新建工程时，它会自动关联对应的固件包。
我的建议： 如果你经常做项目，可以把常用固件包都下载好。比如 F4、F7、H7、L4 这些系列。省得每次新建工程都要等下载。

2.5 环境验证：跑一个最小工程

工具都装好了，咱们验证一下环境是否正常。

步骤：

  1. 打开 CubeMX，新建工程，选择你的开发板型号（比如 STM32F407VET6）。
  2. 配置一个 GPIO 输出，比如 PB0 接 LED。
  3. 生成代码，选择目标 IDE 为 STM32CubeIDE。
  4. 在 CubeIDE 中打开工程，编译、下载。
  5. 如果 LED 能闪烁，说明环境搭建成功。
注意： 我第一次用 CubeMX 生成代码时，发现生成的 main.c 里没有 while 循环。后来才发现是配置时不小心把 Generate peripheral initialization as a pair of .c/.h files 选项勾反了。所以生成代码后，建议先看一眼 main.c 的结构。

2.6 常见问题与解决

问题 原因 解决办法
CubeMX 启动报 Java 错误 Java 环境未安装或版本过低 重新安装 JRE 8 或更高版本
CubeIDE 编译报错：找不到头文件 固件包路径未正确配置 在工程属性中手动添加固件包路径
X-CUBE-AI 模型转换失败 模型格式不支持或版本不匹配 检查模型是否为 TFLite/ONNX 格式，更新 X-CUBE-AI 版本
下载程序时提示找不到调试器 驱动未安装或调试器未连接 安装 ST-Link 驱动，检查 USB 连接

好了，环境搭建这部分就到这儿。工具链装好之后，下一章咱们就开始真正接触 X-CUBE-AI 的模型转换流程了。到时候我会拿一个实际的手写数字识别模型来演示，你想想看，把训练好的模型塞进单片机里跑，是不是挺有意思的？

← 上一章 📖 返回目录 下一章 →