16.1 阶段 0 嵌入式环境与工具链入门
本页目录
一、阶段定位
本阶段是整条设备端路径的「地基」,不写业务逻辑,只解决三件事:把开发板与调试器连上电脑、把交叉工具链装好并能编译出可烧录的固件、把固件烧进芯片并用串口打印出一句话。后面每个阶段都会反复用到这些概念——阶段 1 调外设要知道固件是怎么烧进去的,阶段 2 用 RTOS 要知道栈被放在哪片 RAM,阶段 6 做 OTA 要知道 Flash 是怎么分区的。这些概念如果只靠跟着视频点「下载」,到「板子连不上调试器」时会完全无从下手。
不掌握本阶段会在后面具体卡在哪:
- 说不清「.hex / .bin / .elf」的区别,到阶段 6 做 OTA 时不知道该把哪个文件发给设备、也不知道怎么算固件大小。
- 不会用调试器,代码不跑就只能靠
printf猜,遇到 HardFault 直接卡死,量产现场无法复现。 - 不知道启动文件与链接脚本的作用,编译器报「region FLASH overflowed by 20KB」时不知道该删哪里。
- 不知道怎么把 printf 重定向到串口,所有日志都用不了,阶段 3 联网时连「到底有没有连上」都判断不了。
判断自己卡住的标志不是「感觉没学懂」,而是——(1) 让你把一块新板子通过 SWD 连上并读出芯片 ID,你不知道要接哪几根线;(2) 让你说出「编译后 .elf 和 .bin 各是什么」,你只能说「都是固件」;(3) 让你在电脑上装一套 arm-none-eabi-gcc 并 make 出一个 hex,你不知道要配哪些环境变量。出现任一现象,先把本阶段六个模块过一遍再进 阶段 1 MCU 与外设基础。
二、阶段目标与投入
学完本页,应当能用可观察的行为证明以下能力:
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能把开发板通过调试器连到电脑,用 OpenOCD 或 IDE 识别到芯片 | 能读出芯片 ID / flash 容量 |
| 能从源码编译出一个 hex/bin/elf 并烧录到板上 | 板上 LED 按预期闪烁 |
| 能把 printf 重定向到 UART,在串口助手里看到打印 | 115200 8N1 下能看到字符 |
| 能用调试器打断点、单步、查看变量与寄存器 | 断点能停住,能看 PC/SP 值 |
| 能说出 .elf / .hex / .bin / .map 各自的用途 | 不查资料讲清区别 |
| 能用 Git 提交一个固件工程,并说明哪些产物不该入库 | 编译产物目录被忽略 |
建议学时:
- 全职(每天有效学习 4–6 小时):1.5 周,约 30–40 小时。其中硬件接线与调试器 8 小时、工具链与第一个工程 12 小时、烧录与串口日志 8 小时、调试与断点 8 小时、Git 与工程规范 4 小时。
- 在职(每天 2 小时、周末补 4 小时):3–4 周,约 35 小时。有 C/命令行基础的人可把工具链部分压缩到环境熟悉,重点放在调试器与 HardFault 现场。
学时分配:硬件与调试器 20%、工具链与工程骨架 30%、烧录与串口日志 20%、GDB/RTT 调试 20%、Git 与产物规范 10%。
三、先修自检
进入本阶段前不需要写过固件,但以下基本操作要会;做不到先用一两天熟悉,否则后面做实验会频繁卡壳。
| 先修项 | 合格标准 | 不合格时怎么办 |
|---|---|---|
| C 语言基础 | 懂指针、结构体、位运算(&、\|、<<、~),能看懂 volatile |
用半天补位运算与寄存器操作直觉 |
| 文件与命令行 | 能在终端里切目录、设环境变量、跑一个可执行文件 | 用半天熟悉常用命令 |
| 电路直觉 | 知道 VCC/GND/3.3V,知道别把 5V 直接接到 3.3V 引脚,会用万用表通断档 | 跟着模块 5.1 接线前先确认电源 |
| 英文报错 | 能看懂 undefined reference、region flash overflowed 这类报错大意 |
遇到报错先把英文原文记下来再查 |
| Git 基础 | 能 init / add / commit | 模块 5.5 会带你做一遍 |
四、知识地图
「掌握程度」分三档:了解(能查到)、会用(能调通)、能讲清原理(能回答追问)。本阶段大部分知识点到「会用」即可,编译产物与烧录流程要到「能讲清原理」。
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| 硬件与调试器 | STM32 Nucleo / ESP32 / RP2040 定位、ST-Link/DAP-Link、SWD 四线 | 会用 | 14.2 启动、链接与固件工程 |
| 工具链 | arm-none-eabi-gcc、CMake/Make、STM32CubeIDE/ESP-IDF | 会用 | 14.2 启动、链接与固件工程 |
| 启动与链接 | 复位向量、启动文件、链接脚本、.bss/.data 初始化 | 了解 | 14.2.1 复位启动流程与 Bootloader |
| 编译产物 | .elf / .hex / .bin / .map / .axf | 能讲清原理 | 14.2.4 固件产物、版本与量产烧录 |
| 烧录 | OpenOCD、ST-Link Utility、串口 ISP、hex/bin 烧录 | 会用 | 14.2.4 固件产物、版本与量产烧录 |
| 调试 | GDB、断点/单步、查看寄存器、RTT/ITM、printf 重定向 | 会用 | 14.2.5 调试、追踪与现场取证 |
| 工程规范 | Git 忽略编译产物、版本号、map 分析 | 会用 | 14.2.3 交叉编译工具链与构建系统 |
进度管理建议:把这张表打印出来,每完成一个模块把「掌握程度」上调一档;编译产物与烧录流程两项必须能对着白板讲清楚再往下走。《知识点全清单》里对应章节是更细的全量打勾清单。
五、分模块精讲
5.1 开发板与调试器选型
为什么需要它:学习期选错板子,后面所有外设例程都要重新适应。招聘市场上 STM32 岗位最多、资料最全;ESP32 自带 Wi-Fi/BLE,联网阶段几乎零成本;RP2040 极便宜、USB 体验好但生态偏新。调试器先用板载的(ST-Link 或 DAP-Link),不要一上来买 J-Link。
核心机制:
- STM32 Nucleo:板载 ST-Link,USB 一根线既供电又烧录调试,Cortex-M 内核,HAL 库与 CubeMX 配外设最省心。本路径主线以它为裸机/RTOS 教学板。
- ESP32 开发板:自带 Wi-Fi/BLE,用 ESP-IDF 或 Arduino 框架,阶段 3 联网直接上手;缺点是内核是 Xtensa,调试器与工具链和 STM32 不同。
- RP2040(树莓派 Pico):Cortex-M0+,价格极低,支持 UF2 拖盘烧录,适合极低成本学习;生态与 HAL 成熟度略低于 STM32。
- SWD(Serial Wire Debug):只要 SWDIO、SWCLK、GND、3.3V 四线即可烧录调试,比 JTAG 省引脚。
- 接线前确认供电:开发板可由 USB 供电,不要同时外部供 3.3V 造成冲突;共地是调试器通信的前提。
最小可运行示例:
# 第一次点亮 STM32 Nucleo(文字描述)
1. 用 USB 线把 Nucleo 接到电脑(板载 ST-Link 口)
2. 设备管理器看到 ST-Link 调试口与虚拟串口
3. 打开 STM32CubeIDE 或安装 OpenOCD + arm-none-eabi-gcc
4. 编译官方 Blink 例程,通过 SWD 烧录
5. 板上用户 LED 按 1 秒间隔闪烁
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| OpenOCD 识别不到芯片 | 接了 UART 口而非 ST-Link 口,或 SWDIO/SWCLK 接反 | 用板载 USB 调试口,检查接线与共地 |
| 烧录后板子没反应 | 选错了芯片型号或时钟配置 | 确认目标 MCU 型号与 HSE 时钟 |
| 电脑识别不到串口 | 没装 ST-Link 驱动或 CH340 驱动 | 装对应驱动,换 USB 线(很多线只能充电) |
面试考法:高频问「SWD 和 JTAG 的区别」「为什么调试器要共地」。要答到「SWD 两线复用、省引脚;JTAG 五线;共地是信号电平参考的前提」。
5.2 交叉编译工具链与工程骨架
为什么需要它:MCU 上不能直接跑编译器,必须在电脑(x86)上编译出能在 Cortex-M 上跑的指令,这就是「交叉编译」。工具链装不对,后面所有代码都编译不出来。
核心机制:
- arm-none-eabi-gcc:面向 ARM Cortex-M 的交叉 GCC,前缀
arm-none-eabi-,配套objcopy(转 hex/bin)、size(看 RAM/Flash 占用)、objdump(反汇编)。 - 构建系统:学习期可用 STM32CubeIDE(图形化),工程化项目用 Make 或 CMake;CubeMX 可生成初始化代码。
- 工程骨架通常包含:启动文件(startup_.s,设初始栈、建中断向量表、调
SystemInit后跳main)、链接脚本(.ld,定义 Flash/RAM 地址与大小)、HAL/驱动层、用户代码。 - newlib-nano:精简 C 库,减小 Flash 占用;浮点 printf 要额外链接
-u _printf_float才支持%f。
最小可运行示例:
# 一个最小 Makefile 要点(文字示意,不写本机路径)
TARGET = blink
CROSS = arm-none-eabi-
CFLAGS = -mcpu=cortex-m4 -mthumb -O2 -g
LDFLAGS = -T STM32F407VGTx_FLASH.ld -Wl,-Map=$(TARGET).map
all: $(TARGET).elf
$(CROSS)objcopy -O ihex $< $(TARGET).hex
$(CROSS)objcopy -O binary $< $(TARGET).bin
$(CROSS)size $<
flash: $(TARGET).elf
openocd -f interface/stlink.cfg -f target/stm32f4x.cfg \
-c "program $(TARGET).elf verify reset exit"
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
region FLASH overflowed by 20KB |
代码或库太大,或链接脚本地址错 | 用 size 看占用,确认链接脚本 Flash/RAM 大小 |
undefined reference to _sbrk 等 |
用了 malloc/printf 但没配 newlib stub | 实现 syscalls 桩或用 newlib-nano |
printf 打不出 %f |
没链接浮点支持 | 加 -u _printf_float(Flash 代价) |
面试考法:问「什么是交叉编译」「链接脚本里 Flash 和 RAM 段是干什么的」。要答到「在宿主编译、在目标运行;链接脚本决定代码放哪、栈放哪、堆多大」。
5.3 启动流程与编译产物
为什么需要它:芯片上电后不是从 main() 开始跑的,而是从复位向量跳到一段启动代码;编译产出也不止一个文件。不懂这些,到阶段 6 做 OTA 时不知道发什么、怎么校验。
核心机制:
- 复位流程:上电 → 取初始 MSP(主栈指针)→ 取复位向量地址 → 跳
Reset_Handler→ 初始化.data(从 Flash 拷初始值到 RAM)、清零.bss→ 调SystemInit配时钟 → 调main。 .elf:带调试信息与符号,烧录与调试用它最完整;.hex(Intel HEX):带地址的文本,量产烧录常用;.bin:纯二进制裸映像,烧录时必须指定起始地址;.map:链接映射,看函数/变量落在哪个地址、占多少空间。- Flash 起始地址:Cortex-M 通常 Flash 从
0x08000000开始,RAM 从0x20000000开始(具体看芯片手册)。
最小可运行示例:
# 烧录与查看产物(文字描述)
1. 编译后目录下出现 blink.elf / blink.hex / blink.bin / blink.map
2. arm-none-eabi-size blink.elf → 看 text/data/bss 三段
3. OpenOCD program blink.elf verify reset exit 烧录并复位
4. 板上 LED 闪烁说明映像落到 Flash 起始地址
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 直接烧 .bin 跑飞 | .bin 不带地址,烧错了起始地址 | 烧 .bin 时显式指定 0x08000000,或直接烧 .elf/.hex |
| 上电后 .bss 变量是随机值 | 启动代码没清 .bss | 确认 startup 文件调用了清零 |
| RAM 里全局数组莫名被踩 | 栈溢出到了 .bss 区 | 看 map 与栈水线,阶段 2 深入 |
面试考法:问「.data 和 .bss 有什么区别」「为什么 .bin 烧录要指定地址」。要答到「.data 有初始值要拷,.bss 清零;.bin 是裸映像没有地址信息」。
5.4 调试、断点与日志
为什么需要它:MCU 程序不跑、跑飞、HardFault,靠 printf 猜效率极低。会打断点、单步、看寄存器,是从「能跑例程」到「能排障」的分水岭。
核心机制:
- GDB + OpenOCD:设断点、单步、查看变量/寄存器/内存,遇到 HardFault 能看 PC、LR、xPSR 判断是哪行出的问题。
- printf 重定向:把
fputc或_write实现成往 UART 寄存器写一个字节,串口助手就能看到日志;注意中断里不要直接 printf。 - SEGGER RTT:通过调试器内存块读写日志,不占串口、速度快,是量产前调试利器(需 J-Link 或兼容固件)。
- ITM/SWO:单线程轨迹输出时间戳,可做耗时测量。
最小可运行示例:
/* STM32 HAL:把 printf 重定向到 UART1(文字示意) */
int fputc(int ch, FILE *f) {
HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY);
return ch;
}
/* main 中:printf("boot ok, ram=%u\n", __get_MSP()); */
# GDB 调试典型命令(文字)
(gdb) target extended-remote localhost:3333
(gdb) load
(gdb) break main
(gdb) continue
(gdb) info registers # 看 PC/SP/LR
(gdb) bt # 看调用栈(需带调试信息)
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 断点一停整个系统就卡死 | 停在中断上下文或时序敏感代码 | 用 RTT 打日志代替暂停,或在非关键路径设断点 |
| printf 乱码 | 串口波特率与芯片实际时钟不匹配 | 确认 SystemInit 后时钟树与波特率一致 |
| HardFault 后只能复位 | 没留现场 | 在 HardFault_Handler 里把栈帧寄存器打印出来 |
面试考法:问「HardFault 了你怎么排查」。要答到「看压栈的 PC/LR、反汇编对应地址、区分是取指错误/总线错误/除零,而不是直接复位」。
5.5 版本控制与工程规范
为什么需要它:固件做了三个月,改坏了一版要能回退;量产时「这台设备跑的是哪个 commit」必须能查。
核心机制:
- 必须忽略的产物:编译输出(
build/、obj/、*.elf、*.hex、*.bin、*.map),它们可再生,不该入库。 - 版本号管理:固件里放一个
FIRMWARE_VERSION宏,编译时注入 Git commit hash,串口启动打印出来,方便线上定位。 - 不入库本机路径与调试器配置里的绝对路径;工程要能在另一台机器上 clone 后直接编译。
最小可运行示例:
# 固件 .gitignore 核心条目
build/
obj/
*.elf
*.hex
*.bin
*.map
*.o
*.d
/* 启动时打印版本,便于量产定位 */
printf("FW v%d.%d.%d commit=%s\n",
VER_MAJOR, VER_MINOR, VER_PATCH, GIT_COMMIT);
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 仓库 clone 下来别人编译不过 | 把本地路径写进了 Makefile/工程文件 | 用相对路径,CI 上验证一次 |
| 线上设备不知道跑的哪版 | 没打版本号 | 启动打印 + OTA 上报版本 |
| 编译产物进了 Git | 缺 .gitignore | 加忽略并 git rm --cached |
面试考法:问「固件怎么管理版本」。要答到「语义化版本 + Git commit hash,启动打印,OTA 上报,便于远程定位」。
5.6 第一个可运行固件:点灯 + 串口打印
为什么需要它:学完前面五个模块,必须立刻动手做一个「LED 闪 + 串口打印一句话」的最小固件,否则知识都是悬空的。这个固件不追求功能,只追求「我改一行代码,重新烧录,板子行为立刻变」。
核心机制:
- 用 HAL 的 GPIO 初始化推挽输出,定时翻转引脚电平,LED 就会闪。
- 延时用
HAL_Delay(基于 Systick),但要意识到它是阻塞延时——阶段 2 会用 RTOS 替代。 - 串口初始化后 printf 打印启动信息,验证日志通路。
最小可运行示例:
/* 伪代码:STM32 HAL 点灯 + 串口打印(文字示意) */
int main(void) {
HAL_Init();
SystemClock_Config();
MX_GPIO_Init(); /* PC13 配为推挽输出 */
MX_USART1_UART_Init(); /* 115200 8N1 */
printf("boot ok, msp=%p\n", (void *)__get_MSP());
while (1) {
HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
HAL_Delay(500);
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| LED 不亮 | 引脚号写错或极性反(有些板 LED 是低电平点亮) | 核对原理图,尝试翻转电平 |
| 串口无输出 | TX/RX 接反,或没重定向 printf | 交叉接 TX/RX,确认 fputc 实现 |
| Delay 时间不准 | 时钟树配错 | 用示波器或 GPIO 翻转核对 SysTick |
面试考法:问「HAL_Delay 实现的原理与缺点」。要答到「基于 SysTick 中断计数、阻塞忙等;缺点是占用 CPU、不能在中断里用,多任务后要用 RTOS 延时替代」。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 连接开发板 | 不依赖视频,从接线到 OpenOCD 识别芯片 | 能读出芯片 ID | 2 小时 |
| 编译并烧录 Blink | 用 Make/CMake 或 IDE 编译烧录 | LED 按 1 秒闪烁 | 3 小时 |
| printf 重定向 | 串口助手看到 boot ok |
115200 下字符不乱码 | 2 小时 |
| GDB 断点 | 在 main 设断点并单步 | 能看到 PC/SP 变化 | 2 小时 |
| Git 提交工程 | 配好 .gitignore 提交一次 | git status 干净,产物未入库 |
1 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 改闪烁间隔 | 把 500ms 改成 200ms | 肉眼明显变快 | 0.5 小时 |
| 打印 RAM/Flash 占用 | 用 size 与启动打印 |
能讲清 text/data/bss | 1 小时 |
| 烧录 .bin 并指定地址 | 用 OpenOCD 烧 bin | 能跑起来,讲清为什么要指定地址 | 1 小时 |
| 触发一次 HardFault | 写一个空指针解引用,看现场 | 能在调试器里看到 HardFault 与 PC | 1.5 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 写一份工程目录规范 | 为后续固件定好 src/drivers/boards/ 目录 | 列出至少 5 个目录并说明用途 | 1 小时 |
| 选芯片并写理由 | 为一个电池温湿度传感器选 MCU | 能讲清 RAM/Flash/功耗/无线需求 | 1 小时 |
| 设计启动日志格式 | 定义启动时打印哪些信息 | 含版本、commit、复位原因占位 | 1 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| OpenOCD 识别不到芯片 | 接错口、接线反、共地缺失 | 看 OpenOCD 日志里 connect 那行 |
用板载调试口,核对 SWDIO/SWCLK/GND |
| 烧录后无反应 | 型号错、时钟错、烧错地址 | 核对器件型号与链接脚本 | 用正确型号与 HSE 配置重烧 |
| 串口乱码 | 波特率/时钟不匹配 | 用示波器测引脚频率 | 修正 SystemClock 与波特率 |
region FLASH overflowed |
代码超 Flash 或链接脚本错 | 跑 size 看占用 |
精简代码或修正链接脚本地址 |
| 上电直接进 HardFault | 栈地址错、取指越界 | GDB 看压栈 PC/LR | 反汇编定位,修启动/链接脚本 |
| printf 完全无输出 | 未重定向或 TX 接反 | 单独测 UART 发送 | 实现 fputc,交叉接 TX/RX |
%f 打印不对 |
未链接浮点 printf | 看 map 里是否含浮点库 | 加 -u _printf_float |
| 换电脑编译不过 | 工程里写了本机绝对路径 | 在另一台机器 clone 编译 | 改相对路径,版本号注入 |
八、出口条件
全部勾选后进入 阶段 1 MCU 与外设基础。
- [ ] 能通过 SWD 把开发板连上电脑并识别芯片
- [ ] 能从源码编译出 hex/bin/elf 并烧录,LED 闪烁
- [ ] 能把 printf 重定向到 UART,串口看到启动日志
- [ ] 能用 GDB 打断点、单步、查看 PC/SP/LR
- [ ] 能讲清 .elf / .hex / .bin / .map 的区别与用途
- [ ] 能配置 .gitignore 提交干净的固件工程
- [ ] 排障表里随机抽三个现象,能在 5 分钟内给出排查路径
自测题:
- 芯片上电后是从
main()开始执行的吗?.data和.bss各做什么?- 要点:不是,先跑 Reset_Handler;.data 拷初始值、.bss 清零后再进 main。
- SWD 相比 JTAG 省了什么?
- 要点:SWD 用 SWDIO/SWCLK 两线复用,省引脚,四线即可烧录调试。
- 为什么直接烧 .bin 可能跑飞?
- 要点:.bin 是裸映像不带地址,必须烧到 Flash 起始地址(如 0x08000000)。
- printf 打不出浮点数一般是什么原因?
- 要点:newlib 默认不带浮点格式化,需链接
-u _printf_float,有 Flash 代价。
- 要点:newlib 默认不带浮点格式化,需链接
- HardFault 了为什么不能直接复位?
- 要点:复位会丢失现场,应看压栈的 PC/LR 与反汇编定位出错指令。
- 固件版本号在量产中有什么用?
- 要点:启动打印 + OTA 上报,便于远程定位线上设备跑的是哪版。