00 工具链与工程构建¶
所属系列:STM32H7x7 学习系列 教程对应:第 1 章(Makefile 环境搭建)、第 3 章(CubeMX 创建工程)、8.5(把 LVGL 加入编译)、第 18 章(调试技巧) 更新日期:2026年11月2日
1. 这个块解决什么问题¶
CubeMX 的 Toolchain/IDE 下拉框有 5 个选项(EWARM、MDK-ARM、STM32CubeIDE、Makefile、CMake),教程主线走 Makefile,但教程自己也在多工具链间切换(第 8 章 LVGL 分别给了 Keil MDK / CubeIDE / Makefile 三套构建步骤)。
更关键的是教程 1.2 给出的选择动机:
在双核 STM32H7 工程中,CubeMX 生成的 MDK 工程会互相包含,导致编译失败;而 Makefile 可以更精确地控制每个核各自的编译内容。 ——教程 1.2《为什么使用 Makefile 而不是 MDK》
所以工具链在双核 H7 上不是"口味问题",而是能不能构建的问题。本块把 5 种形态的生成物、语法差异、构建/调试链路一次讲清,并为后续所有笔记提供统一的环境版本基线。
2. 篇目:主线已完成 + 副线按需¶
| # | 篇目 | 关键内容 | 状态 |
|---|---|---|---|
| 01 | CubeMX 五种工程形态对比 | 5 种形态的生成物/语法/构建/调试差异矩阵;教程选 Makefile 的完整论证;双核下的取舍 | ✅ 已完成 |
| 02 | 环境搭建与工具链排错(Windows) | 教程 1.3 / 1.4 的落地版:工具清单与下载来源、GCC / binutils 版本兼容、6 个 Windows 特有坑(rm 缺失 / 0 字节 elf / 文件锁 / .ld 语法报错 / -j 输出交错 / make 同名冲突)、SOP 与验收清单 | ✅ 已完成 |
| 03 | Makefile 工程逐段解剖与手改指南 | 5 个必须读懂的区逐段解剖(工具链变量 / 文件清单 / 编译链接选项 / 链接脚本 / 目标规则);.mk 外置接线(教程 1.5);4 条手改配方;重新生成覆盖矩阵(待实测)+ 接线行清单;报错定位口令 | ✅ 已完成 |
| 04 | 调试与烧录链路(Cortex-Debug 从零配置) | 配置原文完整收录:tasks.json(4 个任务:build/flash × CM7/CM4)+ launch.json(5 套配置:launch / Flash Only / CM4 Attach)+ 逐字段解释 + preLaunchTask 联动;双核调试姿势;可选改进;排错表 | ✅ 已完成 |
主线到此闭合:01~04 覆盖教程第 1 章(1.1 ~ 1.7)与 1.4 调试配置的全部内容。
副线(按需补写,不编号、不排期)——只有到实际需要时才写:
| 篇目 | 触发条件 |
|---|---|
| CMake 工程与官方工具链 | 开始学 CMake / 跟到教程 8.5(LVGL 的三套构建步骤)时 |
启动文件与链接脚本(.sct / .ld / .icf 对照) | 教程 4.4 内存布局、4.30 VMA/LMA、第 7 章 Bootloader 分区,或搬运外部 Bootloader 教程(.sct 视角)时 |
| Keil MDK 对照 | Makefile 调试链路遇到瓶颈、需要拿 Keil 对照验证时(内容并入上一条的对照表,不单独成篇) |
💡 教程 1.5(
.mk文件)、1.6(hex/elf/bin 产物)、1.7(优化选项)的内容归入 03 篇;教程 18 章(map / 反汇编 / 栈回溯)中与调试链路相关的部分归入 04 篇。
3. 环境基线(每篇笔记实测环境的唯一出处)¶
| 项 | 版本 | 说明 |
|---|---|---|
| CubeMX | 待补 | Toolchain 下拉的 5 个选项以你本地版本为准 |
| FW_H7 固件包 | 待补 | HAL 行为随版本变化,升级后回来更新 |
| arm-none-eabi-gcc | 待补 | 教程用 xPack 发行版 |
| arm-none-eabi-ld(binutils) | 待补 | 决定 .ld 语法兼容性(见 02 篇第 3 节),用 arm-none-eabi-ld --version 查 |
| make | 待补 | 教程用 ezwinports 版本 |
| OpenOCD | 0.12.0(教程实测) | xPack 发行版 |
| VS Code 插件 | Cortex-Debug | 教程 1.4 调试链路 |
⚠️ 版本敏感:以上版本号在首次完整跑通"编译 → 烧录 → 断点"后回填,此后每篇笔记只引用本表,不再各写各的。
4. 与其他块的边界¶
| 相关内容 | 归属 | 理由 |
|---|---|---|
CubeMX 双核工程结构(CM4/CM7 目录、.ioc) | 本块 01 / 02 篇 | 工程生成层面 |
| BOOT0 / Option Bytes / 启动流程 | 01_芯片与体系结构 | 芯片层面 |
.ld 里的内存段划分(ITCM/DTCM/AXI SRAM) | 01_芯片与体系结构,副线《启动文件与链接脚本》只讲语法 | 内存语义 vs 语法 |
| map 文件分析、栈回溯 | 本块 04 篇 | 调试链路 |
Bootloader 分区与 .sct ↔ .ld 互译 | 06_系统与工程实践,副线《启动文件与链接脚本》提供语法底稿 | 应用 vs 语法 |