📚 课程目录第1章 ARM裸机开发环境搭建

第一章 ARM裸机开发环境搭建

做ARM裸机开发，第一关就是搭环境。很多人觉得这事简单，装个编译器、配个调试器就完事了。但我见过太多人卡在这一步——编译报错找不到头文件、链接脚本写错导致程序跑飞、调试器死活连不上目标板。说白了，环境没搭好，后面全是坑。

这一章，我就带你把这些基础工作做扎实。咱们从交叉编译工具链开始，一步步把Makefile、链接脚本、调试器全部搞定。

1.1 交叉编译工具链安装

ARM裸机程序不能在PC上直接编译运行。你得用交叉编译器——在x86的电脑上生成ARM能执行的机器码。我常用的工具链是arm-none-eabi-gcc，专门针对裸机或RTOS场景，不带Linux的glibc依赖。

为什么选arm-none-eabi-gcc？

开源免费，社区活跃
支持ARM7/9、Cortex-M/R/A全系列
新唐、ST、NXP官方SDK都在用

安装方式很简单，我习惯直接从ARM官方GNU工具链页面下载。选对操作系统版本，解压到固定目录就行。

# 以Linux为例，解压到 /opt 目录
tar -xjf gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2 -C /opt/

# 添加环境变量
export PATH=$PATH:/opt/gcc-arm-none-eabi-10.3-2021.10/bin

# 验证安装
arm-none-eabi-gcc --version

验证时能看到版本信息，就说明装好了。我遇到过有人解压后忘了加PATH，编译时提示"command not found"——嗯，这种小细节最容易忽略。

小技巧：把export命令写到 ~/.bashrc 里，每次开终端自动生效。别问我怎么知道的——我曾经重装系统后忘了这茬，折腾了半小时才想起来。

1.2 Makefile基础

裸机项目文件不多，但手工敲编译命令太原始。Makefile就是帮你自动化编译的脚本。你想想看，每次改一行代码都要敲一长串gcc命令，谁受得了？

一个最简单的Makefile长这样：

# 目标文件
TARGET = led_blink

# 编译器
CC = arm-none-eabi-gcc
LD = arm-none-eabi-ld
OBJCOPY = arm-none-eabi-objcopy

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

# 编译选项
CFLAGS = -mcpu=cortex-m4 -mthumb -Wall -O0 -g
LDFLAGS = -T link.ld -nostartfiles

all: $(TARGET).bin

$(TARGET).bin: $(TARGET).elf
	$(OBJCOPY) -O binary $< $@

$(TARGET).elf: $(OBJS)
	$(LD) $(LDFLAGS) -o $@ $^

%.o: %.c
	$(CC) $(CFLAGS) -c -o $@ $<

clean:
	rm -f $(OBJS) $(TARGET).elf $(TARGET).bin

这里有几个关键点：

CC：指定交叉编译器，别用gcc，那是给x86用的
CFLAGS：-mcpu指定内核型号，-mthumb用Thumb指令集，-O0不优化方便调试
-T link.ld：链接脚本，告诉编译器代码怎么放

我刚开始写Makefile时，总把$@和$<搞混。$@是目标文件，$<是第一个依赖。记不住就多写几次，肌肉记忆比脑子靠谱。

1.3 链接脚本解析

链接脚本是裸机开发的灵魂。它决定了你的代码、数据、堆栈放在哪。没有它，编译器不知道程序该从哪个地址开始执行。

拿STM32F407举例，它的Flash从0x08000000开始，SRAM从0x20000000开始。链接脚本就得告诉编译器这些信息。

/* link.ld - STM32F407链接脚本 */
MEMORY
{
    FLASH (rx)  : ORIGIN = 0x08000000, LENGTH = 1M
    SRAM  (rwx) : ORIGIN = 0x20000000, LENGTH = 128K
}

SECTIONS
{
    .text :
    {
        *(.isr_vector)    /* 中断向量表 */
        *(.text)          /* 代码段 */
        *(.rodata)        /* 只读数据 */
        _etext = .;       /* 代码结束地址 */
    } > FLASH

    .data :
    {
        _sdata = .;       /* 数据段起始 */
        *(.data)
        _edata = .;       /* 数据段结束 */
    } > SRAM AT> FLASH

    .bss :
    {
        _sbss = .;        /* BSS段起始 */
        *(.bss)
        _ebss = .;        /* BSS段结束 */
    } > SRAM
}

注意看.data段的写法：> SRAM AT> FLASH。意思是运行时在SRAM，但初始值存在Flash里。启动代码要把这些数据从Flash拷贝到SRAM。我见过有人忘了这个拷贝，全局变量全是0——程序能跑，但逻辑全乱套。

避坑指南：我曾经在一个项目里把Flash起始地址写成了0x08001000，结果程序死活不执行。查了半天才发现——芯片的Flash是从0x08000000开始的，偏移了4KB，中断向量表对不上，CPU直接跑飞。

1.4 硬件调试器配置

调试器是嵌入式开发的"眼睛"。没有它，你只能靠printf和LED猜问题。J-Link和ST-Link是最常用的两种，配置方法大同小异。

调试器	接口	速度	适用芯片	价格
J-Link EDU	SWD/JTAG	最高50MHz	ARM全系列	约300元
ST-Link/V2	SWD	最高4MHz	STM32系列	约30元
DAP-Link	SWD	最高10MHz	Cortex全系列	约50元

我个人习惯用J-Link，稳定、速度快、支持芯片多。但ST-Link性价比高，做STM32项目完全够用。

连接调试器时，注意这4根线：

SWDIO：数据线
SWCLK：时钟线
GND：地线
VCC：参考电压（3.3V）

用OpenOCD配合GDB调试，命令如下：

# 启动OpenOCD，连接J-Link
openocd -f interface/jlink.cfg -f target/stm32f4x.cfg

# 另开终端，启动GDB
arm-none-eabi-gdb led_blink.elf

# 在GDB中连接OpenOCD
(gdb) target remote localhost:3333
(gdb) monitor reset halt
(gdb) load
(gdb) continue

我第一次用GDB调试时，忘了执行monitor reset halt，直接load程序，结果芯片还在跑旧代码，新程序根本没生效。记住：下载前先让CPU停下来。

经验之谈：如果调试器连不上，先检查接线——SWDIO和SWCLK有没有接反？GND有没有共地？我遇到过最奇葩的问题：杜邦线太长，信号衰减导致通信不稳定。换成短一点的线就好了。

本章知识体系

下面这张图把本章的核心逻辑串起来了。从工具链到调试器，每一步都是下一环的基础。

环境搭建是裸机开发的"地基"。工具链、Makefile、链接脚本、调试器，这四个东西缺一不可。我见过太多人急着写代码，结果在环境上浪费了更多时间。磨刀不误砍柴工——把这一步做扎实了，后面的开发才会顺畅。