跳转至

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 语法