3. 编译环境搭建：安装交叉编译工具链（ARM GCC）、配置环境变量、首次编译体验

好，咱们正式开始动手了。这一章的目标很明确——把编译环境搭起来，然后跑通第一次编译。说白了，就是让你的电脑能听懂U-Boot的代码，并且把它变成能在ARM板上运行的二进制文件。

我见过不少新手卡在这一步。不是工具链装错了版本，就是环境变量没配好，折腾半天连个hello world都编译不过。别急，咱们一步步来。

3.1 为什么需要交叉编译工具链？

你想想看，你的电脑是x86架构的，而目标板是ARM架构的。x86的编译器编译出来的程序，ARM根本跑不了。所以我们需要一个特殊的编译器——它运行在你的x86电脑上，但生成的目标代码是ARM的。这就是交叉编译。

我个人习惯把交叉编译工具链比喻成“翻译官”。它把你的C代码翻译成ARM能理解的机器指令。没有它，后面所有的工作都是空中楼阁。

3.2 安装ARM GCC工具链

ARM GCC有好几个版本。我推荐使用Linaro维护的版本，稳定且社区支持好。咱们以gcc-arm-none-eabi为例，这个版本适合裸机开发，U-Boot正好用得上。

3.2.1 下载工具链

去Linaro的官方发布页面，找到最新稳定版。我个人习惯用9.2-2019.12这个版本，经过大量项目验证，坑比较少。

# 下载命令示例
wget https://releases.linaro.org/components/toolchain/binaries/9.2-2019.12/arm-none-eabi/gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2

3.2.2 解压到指定目录

我一般放在/opt/toolchains/下面，方便管理。

sudo mkdir -p /opt/toolchains
sudo tar -xjf gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2 -C /opt/toolchains/
小提示： 解压后检查一下目录结构。正常情况下，你会看到bin、lib、arm-none-eabi等子目录。如果少了什么，可能是下载的包不完整。

3.3 配置环境变量

环境变量不配好，系统就找不到你的编译器。每次编译都输一长串路径？那太傻了。咱们把它加到~/.bashrc里，一劳永逸。

# 编辑 ~/.bashrc
export PATH=$PATH:/opt/toolchains/gcc-arm-none-eabi-9-2019-q4-major/bin
export CROSS_COMPILE=arm-none-eabi-
export ARCH=arm

这里解释一下：

  • PATH：告诉系统去哪里找可执行文件
  • CROSS_COMPILE：指定交叉编译器的前缀。U-Boot的Makefile会根据这个前缀找到对应的gcc、ld、objcopy等工具
  • ARCH：指定目标架构为ARM
注意： 我曾经遇到过一位同事，把CROSS_COMPILE写成了arm-none-eabi（少了最后的短横线）。结果编译时系统找不到编译器，报了一堆莫名其妙的错误。嗯，这个短横线不能省。

配置完成后，执行source ~/.bashrc使其生效。然后验证一下：

arm-none-eabi-gcc --version

如果看到版本信息，说明工具链安装成功。如果提示“command not found”，检查一下路径写对了没有。

3.4 首次编译体验

环境搭好了，咱们来点真格的。以QEMU模拟的vexpress开发板为例，跑通U-Boot的编译流程。

3.4.1 获取U-Boot源码

git clone https://github.com/u-boot/u-boot.git
cd u-boot

我个人习惯用v2023.10这个稳定版本。你可以用git checkout v2023.10切过去。

3.4.2 配置目标板

U-Boot支持几百种开发板。每个板子都有自己的默认配置。咱们用vexpress开发板为例：

make vexpress_ca9x4_defconfig

这条命令会生成一个.config文件，里面包含了针对这个板子的所有配置选项。说白了，就是告诉U-Boot：“嘿，我要给这个板子编译，你按它的参数来。”

3.4.3 开始编译

make -j4

-j4表示用4个线程并行编译，能快不少。如果你的电脑性能好，可以改成-j8甚至-j16。

第一次编译大概需要3-5分钟。你会看到屏幕上刷刷地滚过各种编译信息。如果一切顺利，最后会生成u-boot.bin和u-boot（ELF格式）两个文件。

成功标志： 看到类似下面的输出，说明编译成功了。 
  LD      u-boot
  OBJCOPY u-boot.srec
  OBJCOPY u-boot.bin
  CFG     u-boot.cfg
  GEN     u-boot.map

3.5 常见问题与避坑指南

编译过程中可能会遇到一些问题。我把自己踩过的坑列出来，你遇到了可以直接对照排查。

错误信息 原因 解决方法
arm-none-eabi-gcc: command not found 环境变量没配好 检查~/.bashrc中的PATH设置
*** Your GCC is too old 编译器版本过低 升级到Linaro 9.2或更高版本
make: *** No rule to make target 'vexpress_ca9x4_defconfig' 板子名字写错了 用make help查看支持的板子列表
undefined reference to `__aeabi_uidiv' 链接时缺少除法库 检查CROSS_COMPILE是否设置正确
我的经验： 如果编译报错，先别急着搜解决方案。仔细看错误信息的前几行，很多时候问题就出在环境配置上。我曾经花了一下午查一个链接错误，最后发现是CROSS_COMPILE变量里多了一个空格。嗯，这种低级错误最坑人。

3.6 本章知识体系

为了让你更直观地理解整个编译环境的搭建流程，我画了一张图：

编译环境搭建流程 步骤1：下载工具链 从Linaro获取ARM GCC 步骤2：解压安装 放到/opt/toolchains/ 步骤3：配置环境变量 PATH + CROSS_COMPILE + ARCH 步骤4：获取U-Boot源码 git clone 步骤5：配置目标板 make xxx_defconfig 步骤6：编译 make -j4 编译成功！生成文件： u-boot.bin（二进制） | u-boot（ELF） | u-boot.map（符号表） 常见问题排查 环境变量未生效 → source ~/.bashrc | 编译器版本过旧 → 升级到9.2+ | 板子名错误 → make help

这张图把整个流程串起来了。从下载工具链到最终编译成功，每一步都有明确的输入和输出。你照着这个流程走，基本不会出大问题。

3.7 验证编译结果

编译完成后，我习惯做两件事来验证：

  1. 检查文件大小：ls -lh u-boot.bin，正常应该在几百KB到1MB之间。如果只有几KB，说明编译有问题。
  2. 查看文件类型：file u-boot.bin，应该显示“data”或“raw binary”。如果显示“ELF”，说明你搞混了文件。
避坑指南： 我曾经有一次编译出来的u-boot.bin只有12KB，烧到板子上直接黑屏。查了半天，发现是配置时选错了板子型号。所以，编译完成后一定要检查文件大小，这是最快速的验证手段。

好了，编译环境搭建就到这里。你现在应该已经成功编译出了u-boot.bin。这个二进制文件虽然还不能直接跑（因为没有板子），但它证明了你的工具链和环境配置是正确的。下一章，我们会深入U-Boot的启动流程，看看这个二进制文件到底是怎么工作的。

可可精品资料库

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