嵌入式 Linux 与 RTOS / 系统课时
编译并启动 U-Boot
编译并启动 U-Boot
本篇把 U-Boot 从源码编译到可交互命令行跑通:先确认 ARM64 平台与交叉工具链,再用匹配的 defconfig 构建,最后通过串口或 QEMU 控制台核对版本、环境变量和基础命令,为后续加载内核保留一个可控入口。
学习目标
- 能根据目标 ARM64 平台选择对应 defconfig,并完成一次干净构建。
- 能识别主要 U-Boot 构建产物,并区分“编译成功”和“板上可启动”。
- 能从控制台检查版本、板级信息、环境变量和命令行是否可用。
先把平台与工具链对齐
U-Boot 的 defconfig 不是“ARM64 通用配置”,而是板级启动方式、驱动和默认环境的集合。真实开发板应优先使用主线源码或板卡厂商明确指定的 defconfig;如果只是验证构建链,可先用 qemu_arm64_defconfig 得到一个可重复的 ARM64 实验环境。
先确认交叉编译器确实面向 AArch64。下面命令可直接检查工具链前缀是否正确。
aarch64-linux-gnu-gcc --version预期输出
aarch64-linux-gnu-gcc (<TOOLCHAIN_VERSION>) <GCC_VERSION>
Copyright (C) <YEAR> Free Software Foundation, Inc.
...具体版本与发行版可能不同;关键是命令存在,且目标前缀为 aarch64-linux-gnu-。若使用厂商工具链,应把后续 CROSS_COMPILE 改成其实际前缀。
完成一次可复现构建
下面以 U-Boot 源码根目录和 QEMU ARM64 配置为例。真实板卡只需把 DEFCONFIG 换成其板级配置,构建流程保持一致。
set -e
UBOOT_SRC="<PATH>"
DEFCONFIG="qemu_arm64_defconfig"
CROSS_COMPILE="aarch64-linux-gnu-"
cd "$UBOOT_SRC"
make distclean
make "$DEFCONFIG"
make -j"$(nproc)" CROSS_COMPILE="$CROSS_COMPILE"
test -f u-boot.bin
ls -lh u-boot u-boot.bin预期输出
...
LD u-boot
OBJCOPY u-boot-nodtb.bin
COPY u-boot.bin
-rwxr-xr-x ... u-boot
-rw-r--r-- ... u-boot.bin中间目标名称会随配置变化,文件大小也不是固定值。test -f u-boot.bin 返回成功,说明本例所需镜像已生成;但真实板卡可能还要求 SPL、TPL、FIT 镜像或厂商封装文件,不能直接把 u-boot.bin 当成最终烧录物。

图中的关键边界是:构建产物生成只证明工具链和配置能完成编译,出现 U-Boot 提示符才证明当前启动路径至少已经走到 U-Boot 命令行。
从控制台确认 U-Boot 可控
在 QEMU 中可以直接把刚生成的镜像作为固件启动。若你使用真实开发板,则应按板卡手册把正确启动镜像放入 SD、eMMC、SPI NOR 或其他启动介质,再从串口观察同类输出。
cd "<PATH>"
qemu-system-aarch64 \
-machine virt \
-cpu cortex-a57 \
-m 1024 \
-nographic \
-bios u-boot.bin预期输出
U-Boot <VERSION> (<DATE> - <TIME> +0000)
DRAM: 1 GiB
...
Hit any key to stop autoboot: 0
=>版本、日期和探测到的设备可能不同。看到 => 提示符后,先执行一组只读检查,确认当前 U-Boot 的身份、DRAM 信息和环境变量是否正常。
version
bdinfo
printenv
help预期输出
U-Boot <VERSION> (<DATE> - <TIME> +0000)
...
DRAM bank = 0x00000000
-> start = <ADDR>
-> size = <SIZE>
...
baudrate=<BAUD>
bootcmd=<COMMAND>
...
? - alias for 'help'
...bdinfo 和 printenv 的字段依平台而异,不应拿某块板的固定地址去判断另一块板是否异常。真正要确认的是:DRAM 已被识别、串口波特率与终端一致、bootcmd 等关键变量可读取,并且 help 能列出命令。
迁移到真实板卡时避开三个坑
第一,defconfig 必须与 SoC、板型和启动介质匹配;能编译的相近配置并不等于能启动。第二,很多 SoC 在 U-Boot 之前还有 Boot ROM、TF-A、OpenSBI 或厂商固件,烧录地址和镜像封装必须服从该平台启动链。第三,不要在尚未备份环境时随意执行 saveenv,否则一次错误的 bootcmd、网络地址或介质参数就可能被永久保存。
当你能稳定重复“选择正确配置 → 构建 → 启动 → 进入 => → 读取环境”的流程时,U-Boot 就从不可见的启动阶段变成了可诊断、可控制的板级入口。