固件编译与烧录：交叉编译链配置、Makefile编写、JTAG/SWD烧录流程

好，咱们接着聊。上一章我们把硬件平台搭起来了，板子能上电，LED能闪。但说句实话，那只是让硬件「活过来」。真正让嵌入式系统「有灵魂」的，是固件。而固件从代码变成机器码，再烧进芯片里，这中间的门道，我今天跟你好好掰扯掰扯。

我个人习惯把这一章叫做「从代码到硅片的三部曲」：编译、链接、烧录。每一步都有坑，我踩过的坑，今天全告诉你。

交叉编译链：为什么你的电脑跑不了ARM代码？

你想想看，你的PC是x86架构，而STM32是ARM Cortex-M内核。这两个指令集完全不同。你在PC上写的C代码，编译器默认生成的是x86的机器码，ARM芯片根本看不懂。

所以我们需要交叉编译链。说白了，就是一套在PC上运行、但能生成ARM机器码的工具集。

工具链的组成

一套完整的GCC交叉编译链，通常包含这几个家伙：

  • arm-none-eabi-gcc：C编译器，把.c变成.o
  • arm-none-eabi-g++：C++编译器（虽然嵌入式里用得少）
  • arm-none-eabi-ld：链接器，把多个.o和库文件合成一个.elf
  • arm-none-eabi-objcopy：格式转换器，把.elf转成.bin或.hex
  • arm-none-eabi-objdump：反汇编工具，调试时看汇编代码
  • arm-none-eabi-size：查看固件大小，code/rodata/rwdata/zi-data
我的小建议：新手别自己从源码编译工具链，太折磨了。直接去ARM官网下载GNU Arm Embedded Toolchain，或者用Linaro的版本。我一直在用gcc-arm-none-eabi-10.3-2021.10，稳定得很。

安装与验证

以Ubuntu为例，安装其实就一行命令：

sudo apt-get install gcc-arm-none-eabi

装完后验证一下：

arm-none-eabi-gcc --version

看到版本号就对了。如果提示找不到命令，多半是环境变量没配好。我遇到过一回，折腾了半小时才发现是PATH里漏了路径。

Makefile编写：别用手动敲命令了

你当然可以每次手动敲：

arm-none-eabi-gcc -c main.c -o main.o
arm-none-eabi-gcc -c stm32f4xx_it.c -o stm32f4xx_it.o
...
arm-none-eabi-ld -T stm32f4.ld *.o -o firmware.elf

但项目一大了，几十个源文件，你敲得过来吗？所以我们需要Makefile。

一个最小可用的Makefile模板

这是我个人常用的模板，去掉了花哨的功能，保留核心：

# 工具链定义
CC = arm-none-eabi-gcc
LD = arm-none-eabi-ld
OBJCOPY = arm-none-eabi-objcopy
SIZE = arm-none-eabi-size

# 编译选项
CFLAGS = -mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16
CFLAGS += -O2 -g -Wall -std=c99

# 链接脚本
LDFLAGS = -T stm32f4.ld --specs=nano.specs

# 源文件
SRCS = main.c stm32f4xx_it.c system_stm32f4xx.c
OBJS = $(SRCS:.c=.o)

# 目标文件
TARGET = firmware

# 默认目标
all: $(TARGET).elf $(TARGET).bin

# 编译规则
%.o: %.c
	$(CC) $(CFLAGS) -c $< -o $@

# 链接
$(TARGET).elf: $(OBJS)
	$(CC) $(CFLAGS) $(LDFLAGS) $^ -o $@
	$(SIZE) $@

# 生成bin文件
$(TARGET).bin: $(TARGET).elf
	$(OBJCOPY) -O binary $< $@

# 清理
clean:
	rm -f $(OBJS) $(TARGET).elf $(TARGET).bin
注意：链接脚本(.ld文件)千万别搞错。我曾经把STM32F407的链接脚本用到了F103上，结果芯片直接不启动。不同型号的Flash和RAM地址不一样，一定要核对芯片手册。

Makefile里的几个关键点

  • -mcpu=cortex-m4：指定CPU内核，别写错了。M3用cortex-m3，M4用cortex-m4，M7用cortex-m7
  • -mthumb：ARM有两种指令集，ARM和Thumb。Cortex-M系列只支持Thumb，所以必须加这个
  • -mfloat-abi=hard：如果芯片有FPU，用硬浮点效率高很多。但注意，如果你的芯片没有FPU（比如STM32F103），千万别加这个，否则编译出来的代码跑不了
  • -O2：优化等级。调试时用-O0，发布时用-O2或-Os

JTAG/SWD烧录流程：把固件送进芯片

编译好了，生成了.bin文件。怎么把它写进芯片？这就轮到调试器出场了。

JTAG vs SWD：选哪个？

特性 JTAG SWD
引脚数 5根（TMS, TCK, TDI, TDO, nTRST） 2根（SWDIO, SWCLK）
速度 最高可达几十MHz 通常4-10MHz，但够用
调试能力 完整，支持边界扫描 完整，支持所有调试功能
适用场景 FPGA、复杂SoC、多核调试 绝大多数ARM Cortex-M芯片

我个人建议：做ARM Cortex-M开发，直接用SWD。省引脚，布线简单，功能一点不少。JTAG那两根多余的线，在紧凑的板子上就是累赘。

烧录工具：OpenOCD + GDB

这是嵌入式调试的黄金组合。OpenOCD负责和调试器通信，GDB负责和开发者交互。

先启动OpenOCD：

openocd -f interface/stlink.cfg -f target/stm32f4x.cfg

然后另开一个终端，用GDB连接：

arm-none-eabi-gdb firmware.elf
(gdb) target remote localhost:3333
(gdb) monitor reset halt
(gdb) load
(gdb) continue
核心流程：
  1. reset halt：复位并暂停芯片
  2. load：把固件写入Flash
  3. continue：让芯片开始运行

避坑指南：烧录失败的常见原因

  • 连接不稳定：SWD线太长（超过20cm）或者杜邦线接触不良。我建议用带屏蔽的排线，或者直接焊上去
  • 芯片被锁：如果Flash里写了错误的代码，导致芯片反复复位，OpenOCD可能连不上。解决办法：按住复位键，在OpenOCD启动的瞬间松开，趁芯片还没跑起来就halt住
  • 供电不足：调试器从USB取电，如果板子功耗大，可能带不动。我遇到过一块电机驱动板，一烧录就掉线，最后发现是USB线太细，压降太大
  • Option Bytes被改：有些芯片的读保护（RDP）被开启了，调试器无法访问Flash。需要用ST-Link Utility之类的工具先解除保护

知识体系总览

下面这张图，把整个编译烧录的流程串起来了。你对照着看，心里就有谱了。

固件编译与烧录流程 ① 编译阶段 源文件 (.c / .h) arm-none-eabi-gcc 编译 目标文件 (.o) ② 链接阶段 链接脚本 (.ld) 可执行文件 (.elf) 二进制文件 (.bin / .hex) ③ 烧录阶段 调试器 (ST-Link / J-Link) SWD / JTAG 协议 目标芯片 Flash 常用工具链 GCC ARM Embedded + OpenOCD + GDB 或：Keil MDK / IAR EWARM（商业IDE）

嗯，这张图把整个流程讲清楚了。从源文件开始，经过编译生成.o，再通过链接脚本合成.elf，最后转成.bin通过调试器烧进Flash。每一步都有对应的工具和配置。

我的经验：刚开始学的时候，别急着用IDE。手动敲一遍编译命令，写一次Makefile，用命令行烧录一次。这个过程虽然慢，但能让你真正理解每一层在干什么。以后出了问题，你才知道从哪里下手查。

好了，这一章的内容就到这儿。编译链配置、Makefile编写、烧录流程，这三板斧你掌握了，固件开发的基础就算打牢了。下一章我们聊聊调试技巧，那才是真正考验功力的时候。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →