071、STM32Cube.AI工具链介绍与安装

071、STM32Cube.AI工具链介绍与安装

从一次“模型跑飞”说起

去年冬天，我在调试一个基于STM32F746的工业振动监测节点。模型在PC端用Keras训练，量化后只有48KB，自信满满地烧进芯片。结果上电三秒，系统直接HardFault——不是推理结果不对，是模型压根没跑起来。折腾了两天，最后发现是Cube.AI工具链版本和STM32CubeMX的HAL库版本不匹配，生成的初始化代码里有个结构体成员偏移量算错了。

从那以后，我养成了一个习惯：每次搭建TinyML开发环境，先花半小时把工具链的版本依赖关系理清楚。这比调模型参数重要十倍。

工具链全家桶：你到底需要装什么

STM32Cube.AI不是单个软件，是一套工具的组合。核心组件包括：

STM32CubeMX：图形化配置工具，负责生成初始化代码、配置时钟树、外设引脚。它也是Cube.AI的“入口”——你在这里导入模型，配置运行时参数。

X-CUBE-AI扩展包：这是真正的AI引擎。它包含模型转换器（把Keras/TFLite/ONNX转成STM32能吃的C代码）、优化器（量化、剪枝、算子融合）、以及运行时库（推理引擎）。安装后会在CubeMX里多出一个“Software Packs”选项。

STM32CubeProgrammer：烧录工具。虽然也可以用IDE直接下载，但遇到模型分区、校验和计算这类场景，命令行版的Programmer更靠谱。