📚 课程目录第2章开发环境搭建

2. 开发环境搭建：STM32CubeMX配置、X-CUBE-AI安装、NPU SDK集成、IDE调试环境配置

说实话，开发环境搭建这事儿，看着简单，但坑是真不少。我带过好几个项目组，每次新人入职，光搭环境就能卡一两天。不是版本对不上，就是路径带中文，再不然就是SDK死活认不到NPU。

这一章，我把自己的习惯做法拆开来讲。你跟着走一遍，基本不会出大问题。

2.1 整体流程概览

先看一张图，心里有个谱。

这四步是串行的。前一步没做好，后面肯定报错。我见过有人跳过CubeMX直接去搞SDK，结果折腾两天发现时钟树配错了。

2.2 STM32CubeMX 配置

这是地基。地基歪了，楼盖得再漂亮也白搭。

2.2.1 新建工程与芯片选择

打开CubeMX，点"New Project"。在"Part Number"里搜你的芯片型号。比如我用的是STM32H747，它带双核，一个Cortex-M7跑应用，一个Cortex-M4做协同。

我的习惯：选完芯片后，先看一眼"Pinout"标签页，确认NPU相关的SPI或FMC引脚没有被其他外设占用。有一次我选了个默认配置，结果NPU的片选脚被LED占用了，查了半天。

2.2.2 时钟树配置

时钟是NPU的命脉。NPU通常需要独立时钟源，不能跟CPU共用PLL输出，否则推理时CPU一降频，NPU也跟着掉速。

时钟域	推荐频率	说明
HCLK (CPU)	400 MHz	M7核心主频
PCLK (外设)	100 MHz	SPI/FMC总线
NPU_CLK	200 MHz	独立PLL输出

在"Clock Configuration"里，我习惯把NPU时钟单独拉一路PLL。别偷懒用系统时钟分频，推理性能会打折扣。

2.2.3 外设配置

NPU跟MCU通信，无非两种方式：SPI或FMC（并行总线）。

SPI模式：引脚少，但速度慢，适合小模型。
FMC模式：速度快，但占引脚多，适合大模型。

我个人偏好FMC。虽然布线麻烦点，但传输速度能到几十MB/s，模型加载时间从秒级降到毫秒级。

注意：配置FMC时，地址线和数据线的时序参数一定要看NPU的数据手册。我遇到过因为建立时间设短了，导致NPU偶尔读错数据，推理结果时好时坏。

2.2.4 生成代码

配好后，点"Project Manager"：

Toolchain / IDE：选MDK-ARM或STM32CubeIDE
Minimum Firmware Version：选最新的，别用太老的HAL库
Generate peripheral initialization as a pair of .c/.h files per peripheral：勾上，方便管理

然后点"Generate Code"。嗯，到这里CubeMX的工作就结束了。

2.3 X-CUBE-AI 安装

X-CUBE-AI是ST官方的AI工具包。说白了，它负责把你的模型转成能在STM32上跑的代码。

2.3.1 获取安装包

去ST官网搜"X-CUBE-AI"，下载最新版。目前稳定版是8.1.0。别下beta版，我吃过亏，beta版生成的代码在NPU上跑会崩。

2.3.2 安装步骤

双击安装包，一路Next。
安装路径不要有中文，不要有空格。我习惯放C:\ST\X-CUBE-AI。
安装完成后，打开CubeMX，在"Software Packs"里能看到"X-CUBE-AI"。

验证安装：在CubeMX里新建一个工程，点"Additional Software" -> "X-CUBE-AI"，如果能正常展开，说明装好了。

2.3.3 常见问题

有同学装完后CubeMX里看不到X-CUBE-AI。原因通常是：

CubeMX版本太旧，需要升级到6.10以上。
安装时选了"Install for all users"，但CubeMX以当前用户运行。重新安装时选"Install for current user"就行。

2.4 NPU SDK 集成

这一步最容易被忽略。很多人以为装好X-CUBE-AI就完事了，结果编译时报错"找不到npu_driver.h"。

2.4.1 SDK 目录结构

NPU SDK通常包含这几部分：

目录	内容
Drivers	NPU底层驱动，寄存器操作
Middleware	推理引擎，内存管理
Examples	示例工程，参考价值很高
Docs	API文档，必读

2.4.2 集成到工程

我建议手动复制，别用CubeMX的自动添加。自动添加有时会漏掉某些文件。

把SDK的Drivers文件夹复制到工程根目录。
在IDE里添加头文件路径：./Drivers/NPU/Inc
添加源文件：./Drivers/NPU/Src/*.c
在main.c里包含头文件：#include "npu_driver.h"

避坑：SDK里的中断优先级默认是0，如果你的系统用了FreeRTOS，记得改成5或更低，否则会抢占系统调度。我曾经因为这个导致任务卡死，排查了两天。

2.4.3 验证集成

写一个简单的初始化函数：

#include "npu_driver.h"

void NPU_Init_Test(void)
{
    NPU_InitTypeDef npu_init = {0};
    npu_init.clock_source = NPU_CLK_PLL;
    npu_init.clock_freq = 200000000;
    npu_init.mode = NPU_MODE_ASYNC;
    
    if (NPU_Init(&npu_init) != NPU_OK)
    {
        Error_Handler();
    }
    
    printf("NPU init success!\n");
}

编译下载，如果串口打印出"NPU init success!"，说明SDK集成成功了。

2.5 IDE 调试环境配置

我用的是STM32CubeIDE，免费且跟CubeMX无缝衔接。当然，Keil MDK也行，看个人习惯。

2.5.1 调试器选择

ST-Link是标配。但如果你用NPU做高性能推理，建议上J-Link，下载速度快，调试功能更强。

调试器	下载速度	断点数量	价格
ST-Link V3	4 MB/s	6个	免费
J-Link EDU	12 MB/s	无限	约300元
J-Link Pro	50 MB/s	无限	约3000元

我个人用J-Link EDU，性价比最高。项目初期调试频繁，快一秒下载就省一秒时间。

2.5.2 调试配置要点

Reset and Run：勾上，下载完自动运行，省得每次手动按复位。
SWD速度：设成4 MHz，别用默认的1.8 MHz，太慢。
Flash下载算法：如果NPU有独立Flash，记得添加对应的算法文件。

2.5.3 调试技巧

调试NPU时，我习惯开两个窗口：一个看CPU寄存器，一个看NPU的状态寄存器。NPU的状态寄存器通常映射到某个内存地址，直接在"Memory"窗口里监视就行。

小技巧：在npu_driver.h里找到NPU_GetStatus()函数，把它加到"Live Watch"里。这样每步进一次，都能看到NPU当前状态，排查问题快很多。

2.6 环境验证清单

最后，给你一张自检表。每完成一步，打个勾：

[ ] CubeMX工程生成成功，无警告
[ ] X-CUBE-AI在CubeMX中可见
[ ] NPU SDK头文件包含无报错
[ ] 编译通过，0 Error 0 Warning
[ ] 下载后串口打印"NPU init success"
[ ] 调试器可单步执行，变量实时更新