2. 开发环境搭建:从零开始,把工具链跑通
说实话,很多初学者卡在第一步——不是学不会 TouchGFX,而是环境没搭好。我见过有人花了两天装 Keil,结果 License 死活激活不了。嗯,这一章我们就来捋一遍,把 STM32CubeMX、TouchGFX Designer、IDE 和硬件驱动全部搞定。
本章目标:装好所有工具,能新建一个 TouchGFX 工程并成功编译。
2.1 STM32CubeMX 安装——芯片配置的起点
STM32CubeMX 是 ST 官方出的图形化配置工具。说白了,它帮你生成初始化代码,省得你对着寄存器手册一行行写。我个人习惯先装这个,因为后面 TouchGFX Designer 也需要它配合。
安装步骤:
- 去 ST 官网下载最新版 STM32CubeMX(需要注册账号,免费)。
- 双击安装包,一路 Next。注意安装路径不要有中文。
- 安装完成后,打开软件,它会提示你安装固件包。选你用的芯片系列,比如 STM32F4、STM32H7 等。
- 固件包下载比较慢,我建议用手机热点或者换个时间段试试。曾经有一次我等了半小时没动静,后来发现是公司网络限制了。
小技巧:固件包可以手动下载,放到 CubeMX 的 Repository 文件夹里,省得在线等。
2.2 TouchGFX Designer 安装——图形界面的核心
TouchGFX Designer 是咱们做 UI 的主战场。它是个可视化编辑器,拖拖拽拽就能生成界面代码。我刚开始用的时候觉得它像个高级版的 PowerPoint,后来才发现它生成的代码质量很高,几乎不用改。
安装要点:
- 从 TouchGFX 官网下载 Designer 安装包(同样免费)。
- 安装前确保电脑已安装 .NET Framework 4.7.2 或更高版本。
- 安装路径同样不要有中文,否则编译时会报一些莫名其妙的错误。
- 安装完成后,打开 Designer,它会自动检测你电脑上的 CubeMX 版本。
注意:TouchGFX Designer 和 CubeMX 的版本要匹配。我曾经因为 CubeMX 版本太新,导致 Designer 生成的工程打不开。建议都用最新稳定版。
2.3 IDE 配置——Keil / IAR / STM32CubeIDE 三选一
IDE 是编译和下载代码的地方。三种主流选择,我分别说说我的看法。
| IDE | 优点 | 缺点 | 我的建议 |
|---|---|---|---|
| Keil MDK | 生态成熟,教程多,调试方便 | 收费(有代码大小限制),界面老旧 | 公司项目常用,个人学习可以用评估版 |
| IAR EWARM | 编译优化好,代码密度高 | 同样收费,界面更复杂 | 适合对代码体积有要求的项目 |
| STM32CubeIDE | 免费,基于 Eclipse,集成 CubeMX | 启动慢,插件偶尔抽风 | 我推荐新手用这个,省钱省心 |
配置步骤(以 STM32CubeIDE 为例):
- 从 ST 官网下载 STM32CubeIDE,安装过程很简单。
- 打开后,设置工作空间路径(同样不要中文)。
- 导入 TouchGFX 生成的工程:File → Import → Existing Projects。
- 配置编译器路径:Project → Properties → C/C++ Build → Settings。
- 第一次编译会比较慢,因为要下载调试工具链。耐心等就好。
避坑:如果你用 Keil,记得安装对应的 Device Pack。我遇到过有人忘了装,结果编译报错“找不到芯片”,折腾了半天。
2.4 硬件驱动准备——让电脑认识开发板
硬件驱动说白了就是让电脑能通过 USB 识别你的开发板。常见的驱动有几种:
- ST-Link 驱动:ST 官方调试器,大部分开发板都集成。去 ST 官网下载 ST-Link 驱动包。
- J-Link 驱动:Segger 家的,如果你用 J-Link 调试器就需要装。
- USB 转串口驱动:比如 CH340、CP2102,很多开发板用它们做串口通信。
我个人的习惯是:插上开发板,打开设备管理器,看有没有黄色感叹号。有的话就装对应驱动,没有就说明系统自动识别了。
曾经踩过的坑:有一次我插上开发板,设备管理器里显示“未知设备”,我以为是驱动坏了,重装了三次。后来发现是 USB 线只能充电不能传数据。嗯,换根线就好了。
2.5 知识体系总览
下面这张图把整个开发环境的关系画清楚了。你想想看,CubeMX 负责底层配置,TouchGFX Designer 负责 UI 设计,IDE 负责编译调试,驱动负责连接硬件。四者缺一不可。
2.6 验证环境——跑通第一个工程
工具都装好了,怎么知道环境没问题?我建议你新建一个最简单的 TouchGFX 工程,编译下载到开发板,看到屏幕亮了就算成功。
快速验证步骤:
- 打开 TouchGFX Designer,新建一个空白工程,选你的芯片型号。
- 随便拖一个 Button 到画布上,保存。
- 点击 Generate Code,Designer 会自动生成代码并调用 CubeMX。
- 用 IDE 打开生成的工程,编译。
- 下载到开发板,按下按钮,看屏幕有没有反应。
如果编译报错:别慌。先检查 CubeMX 生成的 .ioc 文件有没有配置正确,再检查 IDE 的编译器路径。80% 的问题出在这两个地方。