3. 开发环境搭建：安装ARM GCC工具链、配置Makefile、使用OpenOCD进行烧录与调试
好，到了真正动手前的最后一步——搭环境。
说实话，我见过太多人卡在这一步。不是装不上，而是装完不知道对不对，烧录时找不到设备，调试时连不上目标板。其实只要理清三个东西：工具链（编译）、构建系统（Makefile）、烧录调试器（OpenOCD），后面就顺了。
本章核心目标：在你的电脑上搭建一套能编译、烧录、调试ARM裸机程序的完整环境。我们以STM32F103（Cortex-M3）为例，但流程通用于大多数ARM Cortex-M芯片。
3.1 安装ARM GCC工具链
ARM GCC，全称是 GNU Arm Embedded Toolchain。它负责把C代码变成目标芯片能跑的机器码。
我个人习惯用 gcc-arm-none-eabi 这个版本。为什么是 none-eabi？因为我们的Bootloader跑在裸机上，没有操作系统，所以不需要Linux的glibc支持，none-eabi 就是“无操作系统，嵌入式应用二进制接口”的意思。
3.1.1 下载与安装
去ARM官网或者GitHub的release页面下载。我建议直接选 9.2.1 或 10.3-2021.10 这两个版本，稳定，踩坑少。
- Windows：下载
.exe安装包，一路Next。注意勾选“Add to PATH”。 - Linux：下载
.tar.bz2压缩包，解压到/opt或/usr/local，然后手动加PATH。 - macOS：用Homebrew最省事——
brew install arm-none-eabi-gcc。
小技巧：装完后在终端跑 arm-none-eabi-gcc --version，看到版本号就说明装好了。如果提示“命令未找到”，八成是PATH没配对。
3.1.2 验证工具链
写一个最简单的C文件，编译试试：
// test.c
int main(void) {
return 0;
}然后执行：
arm-none-eabi-gcc -c test.c -o test.o -mcpu=cortex-m3 -mthumb没有报错，生成 test.o，说明工具链能正常工作。-mcpu=cortex-m3 指定CPU内核，-mthumb 指定Thumb指令集——Cortex-M系列只支持Thumb，这个不能忘。
注意：如果你用的是Cortex-M4或M7，记得把 -mcpu 改成对应的型号，比如 -mcpu=cortex-m4。我刚开始学的时候用M3的编译选项去编译M4的代码，结果浮点指令全崩了。
3.2 配置Makefile
有了工具链，接下来要告诉它怎么干活。Makefile就是我们的“施工图纸”。
你想想看，每次敲一长串编译命令，多累啊。Makefile把编译、链接、生成镜像的步骤自动化，一条 make 搞定所有。
3.2.1 一个基础的Makefile模板
下面这个模板，我用了好几年，改改芯片型号就能用：
# 工具链定义
CC = arm-none-eabi-gcc
LD = arm-none-eabi-ld
OBJCOPY = arm-none-eabi-objcopy
SIZE = arm-none-eabi-size
# 目标芯片参数
MCU = cortex-m3
FPU =
# 编译选项
CFLAGS = -mcpu=$(MCU) -mthumb -Wall -O2 -nostdlib -ffreestanding
LDFLAGS = -T linker.ld -nostartfiles
# 源文件
SRCS = main.c startup.c
OBJS = $(SRCS:.c=.o)
TARGET = bootloader
# 默认目标
all: $(TARGET).elf $(TARGET).bin $(TARGET).hex
# 编译规则
%.o: %.c
$(CC) $(CFLAGS) -c $< -o $@
# 链接
$(TARGET).elf: $(OBJS)
$(LD) $(LDFLAGS) $(OBJS) -o $@
$(SIZE) $@
# 生成二进制和hex文件
$(TARGET).bin: $(TARGET).elf
$(OBJCOPY) -O binary $< $@
$(TARGET).hex: $(TARGET).elf
$(OBJCOPY) -O ihex $< $@
# 清理
clean:
rm -f $(OBJS) $(TARGET).elf $(TARGET).bin $(TARGET).hex
.PHONY: all clean这里有几个关键点：
- -nostdlib：不使用标准C库，因为裸机没有操作系统支持。
- -ffreestanding：告诉编译器这是独立环境，不需要main函数的返回值处理。
- -T linker.ld：指定链接脚本，这个我们下一章会详细讲。
3.2.2 常用变量说明
| 变量 | 作用 | 常见取值 |
|---|---|---|
CC |
C编译器 | arm-none-eabi-gcc |
OBJCOPY |
格式转换工具 | arm-none-eabi-objcopy |
CFLAGS |
编译参数 | -mcpu=cortex-m3 -mthumb -O2 |
LDFLAGS |
链接参数 | -T linker.ld -nostartfiles |
MCU |
目标CPU型号 | cortex-m3, cortex-m4 |
避坑指南：我曾经在Makefile里忘了加 -mthumb，结果编译出来的代码全是ARM指令，烧进去芯片直接跑飞。Cortex-M系列只认Thumb指令，这个标志位必须带上。
3.3 使用OpenOCD进行烧录与调试
代码编译好了，怎么弄到芯片里？这就轮到OpenOCD出场了。
OpenOCD（Open On-Chip Debugger）是一个开源的调试和烧录工具。它通过调试器（比如ST-Link、J-Link、CMSIS-DAP）和芯片通信，实现擦除、写入、调试等功能。
3.3.1 安装OpenOCD
- Windows：从官网下载预编译包，或者用
scoop install openocd。 - Linux：
sudo apt install openocd（Ubuntu/Debian）。 - macOS：
brew install openocd。
装完后验证：
openocd --version3.3.2 烧录流程
烧录需要三个东西：配置文件（告诉OpenOCD用什么调试器和目标芯片）、固件文件（.bin或.hex）、烧录命令。
先写一个配置文件 stm32f103.cfg：
# 指定调试器接口
source [find interface/stlink.cfg]
# 指定目标芯片
source [find target/stm32f1x.cfg]
# 设置工作频率
adapter speed 1000然后执行烧录命令：
openocd -f stm32f103.cfg -c "program bootloader.bin 0x08000000 verify reset exit"这条命令的意思是：加载配置文件，把 bootloader.bin 烧录到地址 0x08000000（STM32F103的Flash起始地址），校验，复位芯片，然后退出。
注意：烧录地址一定要和链接脚本里的Flash起始地址一致。我见过有人把程序烧到0x08001000，结果芯片上电后从0x08000000开始执行，全是0xFF，直接死机。
3.3.3 调试会话
调试比烧录更常用。启动一个调试会话：
openocd -f stm32f103.cfgOpenOCD会启动一个GDB服务器，默认监听端口3333。然后另开一个终端，用GDB连接：
arm-none-eabi-gdb bootloader.elf
(gdb) target remote localhost:3333
(gdb) monitor reset halt
(gdb) load
(gdb) continue这里 monitor reset halt 让芯片停在复位向量处，load 把程序下载到RAM或Flash，continue 开始执行。
个人经验：调试时我习惯先 monitor reset halt，然后 stepi 单步执行几条指令，确认复位向量和栈指针正确。这一步能发现很多链接脚本的问题。
3.4 本章知识体系
下面这张图把三个工具的关系画清楚了：
3.5 常见问题与排查
环境搭建总会遇到各种问题。我把最常见的几个列出来：
| 问题 | 可能原因 | 解决方法 |
|---|---|---|
arm-none-eabi-gcc: command not found |
工具链未加入PATH | 检查安装路径，手动添加PATH或重新安装并勾选“Add to PATH” |
Error: unknown MCU name |
-mcpu 参数写错 |
确认芯片内核型号，Cortex-M3写 cortex-m3，M4写 cortex-m4 |
OpenOCD: unable to find interface |
调试器驱动未安装或未连接 | 检查USB连接，安装ST-Link/J-Link驱动，确认设备管理器能识别 |
OpenOCD: target not halted |
芯片处于低功耗模式或SWD引脚被占用 | 按住复位键再尝试连接，或者检查硬件电路 |
GDB: Remote connection closed |
OpenOCD服务未启动或端口被占用 | 先启动OpenOCD，再启动GDB；检查3333端口是否被其他程序占用 |
重要提醒：如果你用的是J-Link，OpenOCD的配置文件要改成 source [find interface/jlink.cfg]。ST-Link和J-Link的配置不能混用，我刚开始学的时候在这上面浪费了半天。
3.6 本章小结
到这步，你的开发环境应该能跑起来了。总结一下我们做了什么：
- 安装了ARM GCC工具链，验证了编译功能。
- 写了一个通用的Makefile模板，把编译、链接、生成镜像自动化。
- 配置了OpenOCD，实现了烧录和GDB调试。
嗯，这里要注意：环境搭建不是一次性的。换芯片、换调试器、换电脑，都可能需要重新配置。把配置文件、Makefile模板保存好，下次直接复用。