3. STM32CubeMX 集成与配置：项目创建、AI中间件添加、内存与时钟配置
好，咱们正式开始动手。上一章我们把AI模型训练好了，也量化完了。但模型文件怎么跑到STM32里去？这中间有个关键桥梁——STM32CubeMX。
说白了，CubeMX就是ST官方的一站式配置工具。你选芯片、配时钟、管脚、外设，最后生成工程代码。我刚开始用的时候，觉得它就是个图形化寄存器配置器。后来才发现，它对AI部署的支持才是真正的杀手锏。
3.1 从零开始：创建CubeMX项目
打开CubeMX，第一步就是选芯片。我个人习惯是直接搜型号，比如STM32H743或者STM32F767。别偷懒用“Select by Series”慢慢翻，效率太低。
- 新建项目： 点击“New Project”，进入芯片选择界面。
- 搜索芯片： 在“Part Number”框里输入你的目标型号。比如我这次用的是STM32H743ZIT6。
- 确认封装： 选好后，双击进入Pinout & Configuration视图。
嗯，这里要注意。如果你用的是开发板，比如Nucleo或Discovery，可以直接在“Board Selector”里选板子。CubeMX会自动帮你配好板载外设，省不少事。但如果是自己画的板子，老老实实从芯片开始配。
3.2 添加AI中间件：让CubeMX认识你的模型
项目建好了，接下来就是加AI中间件。这一步很多人会漏掉，或者顺序搞反。
在Pinout & Configuration视图里，找到左侧的“Software Packs” -> “Select Components”。
- 打开组件管理器： 点击“Select Components”按钮。
- 搜索X-CUBE-AI： 在搜索框里输入“X-CUBE-AI”。
- 勾选核心库： 展开列表，勾选“X-CUBE-AI”下的“Core”库。版本我建议选最新的稳定版，比如8.1.0或更高。
为什么是Core库？因为Core库包含了AI推理引擎的运行时（Runtime），以及模型加载、内存管理等基础功能。你想想看，没有这个，你的模型就是一堆死数据。
添加完成后，你会发现在“Pinout & Configuration”视图的“Software Packs”下，多了一个“X-CUBE-AI”的选项卡。点进去，就是模型导入的入口了。
3.3 内存配置：给AI模型安个家
模型导入之前，有一件事必须做——配内存。AI模型吃内存，尤其是权重数据。STM32的片上RAM通常只有几百KB到几MB，而一个稍大点的模型，权重可能就占掉好几MB。
我建议你按这个思路来配：
| 内存区域 | 用途 | 典型大小 | 注意事项 |
|---|---|---|---|
| DTCM RAM | 模型权重 + 中间激活值 | 128KB - 512KB | 速度最快，优先放权重 |
| SRAM1/SRAM2 | 输入输出缓冲区 | 256KB - 1MB | DMA访问常用区域 |
| SDRAM（外扩） | 大模型权重或临时数据 | 8MB - 64MB | 速度慢，但容量大 |
| Flash | 模型权重（只读部署） | 1MB - 2MB | 掉电不丢失，但写入慢 |
在CubeMX里，内存配置主要在“System Core” -> “RCC”和“System Core” -> “DMA”里。但更关键的是，你要在“X-CUBE-AI”的配置界面里，指定模型权重放在哪个内存区域。
我个人习惯：如果模型小于512KB，直接放DTCM RAM，速度最快。如果模型大于1MB，我会考虑放SDRAM，或者用Flash + 运行时加载的方式。
3.4 时钟配置：让AI跑得快又不翻车
时钟配置，说白了就是给CPU和各个外设定好工作频率。AI推理是计算密集型任务，CPU频率越高，推理越快。但频率高了，功耗和发热也上去了。
在CubeMX的“Clock Configuration”视图里，你会看到一个复杂的时钟树。别慌，我教你一个稳妥的配置方法：
- 选HSE作为主时钟源： 外部晶振，精度高。我一般用8MHz或25MHz的晶振。
- 配置PLL： 把HSE倍频到CPU的最高主频。比如STM32H743最高480MHz，我就配到480MHz。
- 分频给AHB和APB总线： AHB总线通常和CPU同频或半频。APB1和APB2建议不超过100MHz，因为很多外设跑不了太高。
- 检查SDRAM时钟： 如果你用了SDRAM，它的时钟频率不能太高，一般不超过200MHz。太高了容易数据出错。
配置完时钟后，记得在“Project Manager”里生成代码。生成前，检查一下“Toolchain / IDE”是不是选对了。我一般用MDK-ARM或STM32CubeIDE。
3.5 知识体系总览：一张图看懂
说了这么多，你可能有点晕。没关系，我画了一张图，把整个流程串起来。
这张图把整个流程分成了5步。你按这个顺序走，基本不会出错。尤其是第2步和第3步，很多人会搞反——先配了内存，再加中间件，结果发现中间件占用的内存没算进去，又要回头改。
3.6 实战小贴士：生成代码后的检查
代码生成后，别急着编译。先打开工程，检查几个关键文件：
- main.c： 看看SystemClock_Config()函数是不是按你配的时钟生成的。我习惯在这里加个断点，跑起来后确认时钟频率。
- app_x-cube-ai.c： 这是AI中间件的初始化文件。检查一下AI网络是否被正确实例化。
- ai_model.h： 模型的结构定义。看看输入输出张量的尺寸对不对。