📚 课程目录第3章交叉编译工具链

3. 交叉编译工具链：ARM交叉编译器的安装与配置

在嵌入式Linux开发中，目标硬件（ARM架构）通常不具备运行编译器的能力，因此需要在性能强大的宿主机（x86_64）上安装交叉编译工具链。本章将详细讲解 gcc-arm-linux-gnueabi 的安装、配置与验证，并带领你编写并运行第一个裸机程序。

核心概念：交叉编译（Cross Compilation）是指在宿主机上编译生成目标机可执行代码的过程。工具链前缀 arm-linux-gnueabi 表示目标架构为 ARM，使用 Linux 系统调用接口，EABI（Embedded Application Binary Interface）规范。

3.1 交叉编译工具链的组成

一套完整的交叉编译工具链包含编译器、汇编器、链接器、库文件以及调试工具。下表列出了核心组件及其作用：

组件	命令示例	功能描述
C 编译器	`arm-linux-gnueabi-gcc`	将 C 源码编译为 ARM 汇编或目标文件
C++ 编译器	`arm-linux-gnueabi-g++`	编译 C++ 源码
汇编器	`arm-linux-gnueabi-as`	将汇编代码转换为机器码目标文件
链接器	`arm-linux-gnueabi-ld`	链接目标文件与库，生成最终可执行文件
目标文件工具	`arm-linux-gnueabi-objdump`	反汇编、查看段信息等
二进制工具	`arm-linux-gnueabi-objcopy`	格式转换（如 ELF → 纯二进制）
调试器	`arm-linux-gnueabi-gdb`	远程调试目标机上的程序

  安装建议：在 Ubuntu/Debian 系统中，推荐使用包管理器安装预编译的工具链，避免从源码编译的复杂性。对于嵌入式裸机开发，gcc-arm-linux-gnueabi 是最常用的选择。

3.2 安装交叉编译工具链

以下步骤在 x86_64 Ubuntu 22.04 LTS 环境下验证通过。其他 Linux 发行版命令类似，但包名可能略有差异。

3.2.1 通过 apt 安装（推荐）

# 更新包索引
sudo apt update

# 安装 ARM 交叉编译工具链
sudo apt install gcc-arm-linux-gnueabi binutils-arm-linux-gnueabi

# 验证安装
arm-linux-gnueabi-gcc --version

安装成功后，终端应显示类似 arm-linux-gnueabi-gcc (Ubuntu/Linaro 11.3.0-1ubuntu1~22.04) 11.3.0 的版本信息。

3.2.2 手动下载安装（Linaro 版本）

如果需要特定版本或最新工具链，可以从 Linaro 官方下载：

# 下载 gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabi.tar.xz
wget https://releases.linaro.org/components/toolchain/binaries/latest-7/arm-linux-gnueabi/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabi.tar.xz

# 解压到 /opt 目录
sudo tar -xvf gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabi.tar.xz -C /opt

# 添加环境变量（建议写入 ~/.bashrc）
export PATH=$PATH:/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabi/bin

注意：手动安装后务必检查 PATH 是否包含工具链路径，否则系统会调用宿主机的 gcc 导致编译失败。使用 which arm-linux-gnueabi-gcc 确认路径正确。

3.3 交叉编译工具链工作流程

下图展示了从源码到目标机可执行文件的完整流程，以及各工具在其中的角色：

3.4 编写第一个裸机程序

裸机程序意味着没有操作系统介入，程序直接运行在硬件上。我们编写一个经典的 led.s 汇编程序，控制 ARM 开发板上的 LED 灯闪烁。为简化演示，这里使用 QEMU 的 versatilepb 板型进行仿真。

3.4.1 汇编源码：led.s

@ 文件名: led.s
@ 目标: QEMU versatilepb 板，控制 GPIO 口 LED
@ 编译: arm-linux-gnueabi-as -o led.o led.s
@ 链接: arm-linux-gnueabi-ld -Ttext=0x10000 -o led.elf led.o
@ 转换: arm-linux-gnueabi-objcopy -O binary led.elf led.bin

.global _start
_start:
    @ 设置栈指针（QEMU versatilepb 内存基址 0x10000）
    ldr sp, =0x10000

    @ 使能 GPIO 时钟（地址 0x101E2000）
    ldr r0, =0x101E2000
    mov r1, #0x01
    str r1, [r0]

    @ 设置 GPIO 方向为输出（地址 0x101E2004）
    ldr r0, =0x101E2004
    mov r1, #0x01
    str r1, [r0]

loop:
    @ 点亮 LED（地址 0x101E2008，写 1 亮）
    ldr r0, =0x101E2008
    mov r1, #0x01
    str r1, [r0]

    @ 延时
    bl delay

    @ 熄灭 LED（写 0 灭）
    ldr r0, =0x101E2008
    mov r1, #0x00
    str r1, [r0]

    @ 延时
    bl delay

    b loop

delay:
    ldr r2, =0x1FFFFF
delay_loop:
    subs r2, r2, #1
    bne delay_loop
    bx lr

3.4.2 编译与链接步骤

按照以下命令序列完成从汇编到二进制镜像的转换：

# 第1步：汇编生成目标文件
arm-linux-gnueabi-as -o led.o led.s

# 第2步：链接生成 ELF 可执行文件
arm-linux-gnueabi-ld -Ttext=0x10000 -o led.elf led.o

# 第3步：查看 ELF 文件信息
arm-linux-gnueabi-objdump -h led.elf

# 第4步：转换为纯二进制镜像（裸机加载）
arm-linux-gnueabi-objcopy -O binary led.elf led.bin

# 第5步：查看二进制文件大小
ls -lh led.bin

  关键参数说明：

  -Ttext=0x10000：指定代码段加载地址为 0x10000，这是 QEMU versatilepb 板约定的裸机程序起始地址。

  -O binary：去除 ELF 文件头，生成纯二进制镜像，可直接烧录到 Flash 或加载到内存运行。

3.5 在 QEMU 中运行裸机程序

使用 QEMU 的 -kernel 参数加载裸机镜像，并开启串口输出以便观察运行状态：

# 运行裸机程序（versatilepb 板型）
qemu-system-arm -M versatilepb -m 128M -kernel led.bin -nographic -serial mon:stdio

如果一切正常，QEMU 终端将显示 LED 闪烁的效果（通过串口打印模拟）。按 Ctrl+A 然后按 X 退出 QEMU。

3.6 常见问题与排查

问题现象	可能原因	解决方案
`arm-linux-gnueabi-gcc: command not found`	工具链未安装或 PATH 未设置	执行 `sudo apt install gcc-arm-linux-gnueabi` 或检查 PATH
链接时提示 `undefined reference to '_start'`	入口点未定义或拼写错误	确保汇编中使用 `.global _start` 声明
QEMU 运行后无任何输出	串口地址或 GPIO 地址错误	核对 versatilepb 手册中的外设基地址
`objcopy` 生成的 bin 文件过大	链接地址设置过高，导致填充大量 0	使用 `-Ttext=0x10000` 等低地址

3.7 本章小结

通过本章的学习，你掌握了：

交叉编译工具链的核心组件及其作用
两种安装方式（apt 与手动）及环境配置
从汇编源码到裸机二进制镜像的完整编译流程
在 QEMU 中运行第一个 ARM 裸机程序的方法

下一步实践：尝试修改 led.s 中的延时循环值，观察 LED 闪烁频率的变化；或者添加第二个 GPIO 引脚控制多颗 LED。这为后续调试 Linux 内核启动阶段的 GPIO 初始化打下基础。