2. STM32CubeMX 工程创建与配置

好，咱们正式开始动手。这一章我会带着你，从零创建一个 STM32H747 的项目。别小看这一步，很多坑其实都埋在这里。我见过不少新手，代码写了大半，回头发现时钟配错了，或者调试口被占用了，那才叫一个头疼。

咱们的目标很明确：把基础环境搭稳，后面跑 AI 模型才不会出幺蛾子。

2.1 新建 STM32H747 项目

打开 STM32CubeMX，界面很直观。点击 “New Project”，进入芯片选择窗口。

在搜索框输入 STM32H747，你会看到一堆型号。别慌，咱们选的是 STM32H747XIH6 或者 STM32H747I-DISCO 板载的那颗。我个人习惯直接搜 H747XI，然后挑带 H6 后缀的，因为它是 BGA 封装，引脚多，方便折腾。

选好后，点 “Start Project”。系统会弹出一个初始化对话框，问你要不要初始化所有外设。点 “No” —— 咱们自己来配，心里有数。

2.2 时钟树配置（HSE + PLL）

时钟是芯片的心脏。H747 有两个内核：一个 Cortex-M7（主核，跑 AI 推理），一个 Cortex-M4（辅核，做控制）。咱们主要用 M7，所以时钟得给它喂饱。

切换到 Clock Configuration 标签页。默认用的是 HSI（内部高速振荡器），精度一般，跑不了高频。咱们要换成 HSE（外部高速晶振）。

1. 选择 HSE 作为时钟源：在 HSE 下拉框里选 Crystal/Ceramic Resonator。H747 开发板上通常焊了一个 25MHz 的晶振。
2. 配置 PLL1：H747 的 PLL 很强大，可以独立给 M7 和 M4 供时钟。咱们主要配 PLL1，它负责给 M7 内核和系统总线提供时钟。
   • 输入源：HSE（25MHz）
   • 分频系数 M：5（25 / 5 = 5MHz 进入 PLL）
   • 倍频系数 N：96（5 * 96 = 480MHz）
   • 系统输出分频 P：2（480 / 2 = 240MHz，这是 M7 的内核频率）
3. 确认 AHB 总线时钟：在 AHB Prescaler 里选 /1，这样 AHB 总线也是 240MHz。外设总线 APB1 和 APB2 可以适当分频，比如 APB1 设 /2 得到 120MHz，APB2 设 /2 得到 120MHz。

配好之后，时钟树大概长这样：

2.3 调试接口配置（SWD）

调试接口是咱们和芯片沟通的桥梁。H747 支持 JTAG 和 SWD 两种模式。我强烈建议用 SWD，它只需要两根线（SWDIO + SWCLK），省引脚，而且速度不慢。

在 Pinout & Configuration 标签页里，找到 SYS 分类下的 Debug 选项。默认可能是 JTAG (5 pins)，咱们改成 Serial Wire (SWD)。

改完之后，你会发现 PA13（SWDIO）和 PA14（SWCLK）自动被分配了功能。别动它们，这是保命线。

2.4 串口配置（USART1）

串口是咱们的“日志输出口”。AI 模型跑起来之后，打印推理结果、打印帧率，全靠它。我选 USART1，因为它通常映射到 PA9（TX）和 PA10（RX），这两个引脚在开发板上很容易接出来。

在 Connectivity 分类下找到 USART1，勾选 Asynchronous 模式。然后配置参数：

配完之后，记得在 NVIC Settings 标签页里，把 USART1 全局中断的 Enabled 勾上。这样咱们才能用中断方式收发数据，不阻塞 CPU。

2.5 GPIO 配置（LED + 按键）

LED 和按键是嵌入式开发的“Hello World”。咱们用 LED 指示系统状态，用按键触发拍照或推理。

在开发板上，LED 通常接在 PB0 或 PI8（具体看板子）。咱们以 PB0 为例：

• 在 Pinout 视图里找到 PB0，右键选择 GPIO_Output。
• 在 GPIO 配置页面里，把 Maximum output speed 设为 Low（LED 不需要高速）。
• 把 User Label 改成 LED_GREEN，这样代码里直接引用这个名字，清晰明了。

按键呢？开发板上的用户按键通常接在 PC13 或 PA0。咱们以 PC13 为例：

• 找到 PC13，右键选择 GPIO_Input。
• 在 GPIO 配置里，把 Pull-up/Pull-down 设为 Pull-up（按键按下时读到低电平）。
• User Label 改成 KEY_USER。

2.6 生成初始化代码

所有配置都确认无误后，点 Project Manager 标签页。这里有几个关键设置：

点 GENERATE CODE，CubeMX 会帮你生成完整的工程。打开 Keil 或者你喜欢的 IDE，编译一下，应该零错误零警告。