开发环境搭建：STM32CubeIDE安装与配置、STM32CubeMX初始化、硬件平台介绍
说实话，做嵌入式开发这么多年，我换过不少IDE。从早期的Keil MDK，到后来IAR，再到现在的STM32CubeIDE。每次换工具都挺折腾的，但这次不一样。
STM32CubeIDE是ST官方基于Eclipse打造的免费IDE。它把代码编辑、编译、调试、项目管理全整合在一起了。最关键的是，它跟STM32CubeMX深度绑定——你画好引脚配置，点一下生成代码，IDE里直接就能用。这个流程，我当年做项目时想都不敢想。
2.1 STM32CubeIDE安装与配置
安装过程其实不复杂，但有几个坑我得提前跟你说。
2.1.1 下载与安装
去ST官网搜"STM32CubeIDE"，找到对应你操作系统的版本。Windows、Linux、macOS都有。我建议下载最新稳定版，别追beta版——我在项目里吃过beta版的亏，调试器死活连不上，折腾了两天才发现是IDE的bug。
安装时注意几点：
- 安装路径不要有中文。Eclipse对中文路径支持不好，编译时可能报一些莫名其妙的错。
- 勾选"安装ST-Link驱动"。如果你用ST-Link调试器，这个驱动必须装。我见过有人装完IDE发现连不上板子，结果就是驱动没勾上。
- 安装时间比较长。大概10-15分钟，去泡杯咖啡吧。
2.1.2 首次启动配置
装完后第一次启动，会让你选工作空间（Workspace）。工作空间就是你存放项目的地方。我个人习惯把工作空间放在SSD上，编译速度快很多。
启动后界面是Eclipse风格，左边是项目浏览器，中间是代码编辑区，下面是控制台和调试视图。如果你用过Eclipse，上手很快。没用过也别慌，常用的按钮就那么几个。
2.1.3 配置编译器与调试器
STM32CubeIDE自带ARM GCC编译器，不需要额外安装。但你要确认一下编译器版本：
- 点击菜单栏
Window → Preferences - 找到
STM32CubeIDE → Toolchain - 查看当前使用的GCC版本
我建议用v10.3或更新的版本。老版本对Cortex-M7的优化不够好，跑实时推理时性能差一截。
调试器配置也很简单。默认用ST-Link GDB Server。你插上开发板，IDE会自动识别。如果识别不到，检查一下：
- USB线是不是数据线（有些线只能充电）
- 驱动有没有装好
- 板子上的跳线帽是不是在正确位置
Run → Debug Configurations 里选择对应的调试接口。我建议初学者先用ST-Link，兼容性最好。
2.2 STM32CubeMX初始化
STM32CubeMX是ST的图形化配置工具。你用它画引脚、配时钟、选外设，然后一键生成初始化代码。说白了，它把最枯燥的寄存器配置工作替你干了。
2.2.1 安装CubeMX
CubeMX可以独立安装，也可以从CubeIDE里直接启动。我推荐后者——在IDE里点那个绿色小芯片图标，就能打开CubeMX，配置完直接生成代码到当前项目，省去导入导出的麻烦。
安装时同样注意路径不要有中文。另外，CubeMX需要Java运行环境，如果电脑没装JRE，安装程序会提示你下载。
2.2.2 新建项目与芯片选择
打开CubeMX，点击"New Project"。你会看到一个芯片选择界面。这里有两种方式：
| 方式 | 适用场景 | 操作 |
|---|---|---|
| 按型号搜索 | 你知道具体芯片型号 | 输入"STM32F407VGT6"直接定位 |
| 按系列筛选 | 你只确定用哪个系列 | 选F4系列，再根据引脚数、Flash大小筛选 |
我一般用第一种。比如我们课程用的STM32F407VGT6，直接搜"STM32F407VG"就能找到。选中后双击，进入配置界面。
2.2.3 引脚配置与时钟树
配置界面分三块：
- Pinout & Configuration：画引脚。你想用哪个外设，点一下对应的引脚，选功能就行。
- Clock Configuration：配时钟。这是最容易出错的地方。
- Project Manager：项目设置。填项目名、选IDE类型、设堆栈大小。
时钟配置我得多说两句。STM32F4的时钟树比较复杂，有HSE、HSI、PLL好几个来源。我见过不少新手把时钟配错了，导致外设跑不起来。
2.2.4 生成代码
配置完成后，点"Generate Code"。CubeMX会生成一个完整的工程，包含：
main.c：主函数和初始化代码stm32f4xx_hal_msp.c：外设的MSP初始化（引脚、时钟、DMA等）stm32f4xx_it.c：中断服务函数- 各个外设的HAL库文件
生成后，在CubeIDE里打开项目，直接就能编译下载。我第一次用这个流程时，从新建项目到点灯，只花了5分钟。想想以前手写寄存器配置的日子……嗯，技术进步真好。
2.3 硬件平台介绍
我们课程主要用三个系列的开发板：F4、F7、H7。它们各有特点，适合不同的场景。
2.3.1 STM32F4系列
F4是ST的经典系列，基于Cortex-M4内核，带FPU和DSP指令集。我用F4做过不少项目，从工业控制到音频处理，它都能胜任。
我们用的具体型号是STM32F407VGT6：
| 参数 | 值 | 说明 |
|---|---|---|
| 内核 | Cortex-M4F | 带硬件浮点运算 |
| 主频 | 168 MHz | 够跑大部分实时推理 |
| Flash | 1 MB | 存放程序和模型权重 |
| SRAM | 192 KB | 运行时数据存储 |
| 外设 | USART、SPI、I2C、ADC、DAC、DCMI | 接口丰富 |
F4的优势是生态成熟、资料多、价格适中。初学者用F4入门最合适。但它的SRAM只有192KB，跑复杂的神经网络模型会有点吃力。
2.3.2 STM32F7系列
F7基于Cortex-M7内核，性能比F4强不少。主频最高216MHz，而且有L1缓存（指令缓存和数据缓存各16KB）。
我们用的是STM32F767ZIT6：
| 参数 | 值 | 说明 |
|---|---|---|
| 内核 | Cortex-M7 | 双精度FPU，性能更强 |
| 主频 | 216 MHz | 比F4快30% |
| Flash | 2 MB | 能装更大的模型 |
| SRAM | 512 KB | 运行内存更充裕 |
| 特色 | Chrom-ART加速器、TFT-LCD控制器 | 适合图形界面 |
F7的缓存是个好东西。我在做图像推理时，开启指令缓存后，推理速度提升了将近40%。但缓存配置也有坑——如果配置不当，会导致程序跑飞。后面我会专门讲这个。
2.3.3 STM32H7系列
H7是ST的旗舰系列，双核架构（Cortex-M7 + Cortex-M4）。主频最高480MHz，性能直接拉满。
我们用的是STM32H743ZIT6：
| 参数 | 值 | 说明 |
|---|---|---|
| 内核 | Cortex-M7 (480MHz) + Cortex-M4 (240MHz) | 双核异构 |
| Flash | 2 MB | 大容量存储 |
| SRAM | 1 MB + 64 KB DTCM + 16 KB ITCM | 内存非常充裕 |
| 特色 | DMA2D图形加速、硬件JPEG编解码、以太网MAC | 多媒体处理能力强 |
H7的DTCM（紧耦合数据内存）是个好东西。把频繁访问的数据放DTCM里，访问速度比普通SRAM快很多。我在做实时音频推理时，把模型权重放DTCM里，推理延迟降低了30%。
但H7也有缺点——功耗高、价格贵、配置复杂。初学者不建议直接上H7，容易在时钟和缓存配置上卡住。
2.3.4 三个系列的对比
我整理了一张对比表，方便你选型：
| 维度 | F4 | F7 | H7 |
|---|---|---|---|
| 入门难度 | 低 | 中 | 高 |
| 推理性能 | 够用 | 良好 | 优秀 |
| 内存大小 | 192KB | 512KB | 1MB+ |
| 功耗 | 低 | 中 | 高 |
| 价格 | 便宜 | 中等 | 贵 |
| 适用场景 | 入门、简单推理 | 中等复杂度推理 | 高性能实时推理 |
我个人建议：如果你是初学者，先用F4把基础打牢。等熟悉了HAL库和CubeMX流程，再升级到F7或H7。一口吃不成胖子，做嵌入式更是这样。
2.4 本章知识体系
下面这张图概括了本章的核心内容：从开发环境搭建到硬件平台选型，整个流程一目了然。