2. 开发环境搭建：STM32CubeMX安装、TouchGFX Designer安装、IDE（Keil/IAR）配置、硬件驱动准备
做嵌入式GUI开发，环境搭建是第一步。这一步要是没走稳，后面全是坑。我见过不少新手，装完软件就急着写代码，结果编译报错半天找不到原因——最后发现是工具链没配好。
这一章，我把整个环境搭建流程拆成四个部分。你跟着一步步来，基本不会出问题。
2.1 STM32CubeMX 安装与配置
STM32CubeMX 是ST官方推出的图形化配置工具。说白了，它帮你生成初始化代码，省去手动写寄存器配置的麻烦。
2.1.1 下载与安装
- 去ST官网搜索“STM32CubeMX”，找到对应版本下载。
- 安装时选默认路径就行。我个人习惯装在C盘，省得后面路径出问题。
- 安装完成后，打开软件，它会提示你安装固件包。别急着点取消——后面要用。
2.1.2 固件包管理
打开 CubeMX 后，点击 Help → Manage embedded software packages。这里会列出所有支持的 STM32 系列固件包。
你只需要勾选自己用的芯片系列。比如你用 STM32F429，就只下载 F4 的包。全下的话，硬盘空间会吃紧——我试过，光 F4 和 H7 两个系列就占了 3 个多 G。
2.2 TouchGFX Designer 安装
TouchGFX Designer 是图形化界面设计工具。你拖拽控件、配置交互，它自动生成 C++ 代码。
2.2.1 版本选择
| 版本 | 适用场景 | 备注 |
|---|---|---|
| TouchGFX 4.18+ | 新项目推荐 | 支持 STM32CubeMX 集成 |
| TouchGFX 4.16 | 旧项目维护 | 部分老芯片只能用这个版本 |
| TouchGFX 4.13 | 兼容老旧硬件 | 不建议新项目使用 |
我个人建议用最新稳定版。ST 每半年更新一次，新版本会修复不少 bug。我记得 4.17 版本有个字体渲染的坑，升级到 4.18 就解决了。
2.2.2 安装步骤
- 从 ST 官网下载 TouchGFX Designer 安装包。
- 双击安装，一路 Next。它会自动检测你电脑上有没有 CubeMX。
- 安装完成后，打开 Designer，它会提示你关联 CubeMX 工程。选“是”。
2.3 IDE（Keil / IAR）配置
代码写好了，总得有个地方编译、下载、调试。Keil 和 IAR 是嵌入式开发最常用的两个 IDE。
2.3.1 Keil MDK 配置
Keil 上手快，调试功能也够用。我早期项目基本都用它。
- 安装：去 Keil 官网下载 MDK-ARM 版本。安装时记得勾选“Cortex-M”系列支持。
- 破解：这个我就不多说了，你懂的。不过建议有条件还是买正版，公司项目尤其要注意版权问题。
- 配置：打开 Keil，点击 Project → Manage → Run-Time Environment，勾选你需要的组件。比如 CMSIS、Device 等。
2.3.2 IAR Embedded Workbench 配置
IAR 的编译优化比 Keil 强，代码密度也更好。如果你对性能有要求，IAR 是更好的选择。
- 安装：下载 IAR for ARM 版本。安装过程会提示你选择芯片系列，全选也没问题。
- 破解：同样，建议正版。
- 配置：新建工程后，在 Project → Options 里设置芯片型号、调试器类型、优化等级等。
2.3.3 调试器配置
不管用 Keil 还是 IAR，调试器都得配好。常用的有 J-Link、ST-Link、ULINK。
| 调试器 | 速度 | 价格 | 推荐场景 |
|---|---|---|---|
| J-Link | 快 | 贵 | 专业开发、调试复杂问题 |
| ST-Link | 中等 | 便宜 | ST 芯片开发、学习入门 |
| ULINK | 中等 | 中等 | Keil 生态用户 |
我个人推荐 ST-Link。性价比高，而且 STM32 芯片基本都支持。如果你预算充足，J-Link 的调试体验确实更好，尤其是断点多的时候。
2.4 硬件驱动准备
软件环境搭好了，硬件驱动也得跟上。不然开发板连不上电脑，啥也干不了。
2.4.1 串口驱动
大部分开发板都带 USB 转串口芯片。常见的有 CH340、CP2102、FT232。
- CH340：国产芯片，便宜。驱动去官网下载，或者用驱动精灵自动安装。
- CP2102：Silicon Labs 的芯片，稳定。驱动可以从 Silicon Labs 官网下载。
- FT232：FTDI 的芯片，贵但可靠。驱动一般系统自带，没有的话去 FTDI 官网下。
2.4.2 ST-Link 驱动
如果你用 ST 官方的开发板，比如 Nucleo 或 Discovery 系列，板载 ST-Link 需要装驱动。
- 去 ST 官网搜索“ST-Link driver”，下载安装包。
- 安装完成后，插上开发板，设备管理器里应该能看到“STMicroelectronics STLink dongle”。
- 如果显示黄色感叹号，说明驱动没装好。右键更新驱动，手动指定到安装目录。
2.4.3 其他外设驱动
如果你的项目用到 LCD、触摸屏、外部 Flash 等外设，也需要提前准备好驱动。
- LCD 驱动：确认屏幕型号，比如 ILI9341、ST7789。去芯片厂商官网下载驱动库。
- 触摸驱动：常见的有 FT5x06、GT911。驱动代码一般 TouchGFX 自带，但需要配置 I2C 地址和中断引脚。
- 外部 Flash：用于存储图片、字体等资源。常用型号有 W25Q64、W25Q128。驱动代码可以从 STM32CubeMX 生成。
2.5 环境搭建整体流程
下面这张图，把整个环境搭建的流程串起来了。你可以对照着检查自己走到哪一步了。
这张图里，前三层可以并行进行。你可以在下载 CubeMX 的同时，把 Keil 和驱动也装了。最后一层验证是关键——编译通过、下载成功、程序跑起来，才算环境搭好了。
2.6 常见问题与解决
环境搭建过程中，我遇到过不少问题。挑几个典型的说说。
- CubeMX 打不开：检查 Java 环境。命令行输入
java -version，如果提示找不到命令，去装 JRE。 - TouchGFX Designer 无法关联 CubeMX：手动在 Designer 的设置里指定 CubeMX 的安装路径。
- Keil 编译报错 “Error: L6406E”：这是空间不足。在工程设置里增大 ROM/RAM 区域，或者优化代码大小。
- ST-Link 无法识别：先检查驱动，再检查接线。我遇到过杜邦线接触不良导致无法下载的情况，换了线就好了。