嵌入式 Linux 与 RTOS / 系统课时
用 Buildroot 生成板级镜像
用 Buildroot 生成板级镜像
Buildroot 的目标不是“把几个二进制放到一起”,而是把工具链、内核、Bootloader、根文件系统和目标软件包统一进同一份可重建配置。本节会从板级 defconfig 出发完成配置、构建、镜像检查与配置固化,最终得到可重复生成的板级产物。
学习目标
- 能从板级 defconfig 配置 Toolchain、Kernel、Bootloader、Filesystem 与目标软件包
- 能构建并核对
output/<BOARD>/images中的启动或烧录产物 - 能保存 defconfig、overlay 与镜像拼装脚本,使系统可从干净目录一键重建
从板级 defconfig 建立唯一配置源
Buildroot 的 .config 是完整构建状态,适合当前工作目录;defconfig 只保存与默认值不同的关键选择,更适合进入版本库。已有板级支持时,优先从 <BOARD>_defconfig 启动,不要手工复制一份旧 .config 继续改。
下面使用独立输出目录,避免多个板卡共享 output/ 后互相污染。<BOARD> 替换为实际板级名称。
BOARD="<BOARD>"
make O="output/$BOARD" "${BOARD}_defconfig"
make O="output/$BOARD" menuconfig预期结果:第一条命令在 output/<BOARD>/.config 生成板级配置;第二条命令打开 Buildroot 配置界面。若 <BOARD>_defconfig 不存在,说明当前 Buildroot 源码或 BR2_EXTERNAL 中尚未提供该板级定义。
在配置界面中重点核对五类选项:Toolchain 决定架构、ABI、C 库与编译器来源;Kernel 决定内核源码、配置、镜像格式和设备树;Bootloaders 选择 U-Boot 等引导程序;Filesystem images 决定 ext4、cpio、tar 等根文件系统格式;Target packages 则纳入目标板运行所需的软件。

构建并验证镜像集合
配置完成后直接执行构建。首次构建可能下载并编译工具链、内核和大量软件包,耗时取决于网络、CPU 与缓存。
BOARD="<BOARD>"
make O="output/$BOARD" -j"$(nproc)"
KERNEL_IMAGE="<KERNEL_IMAGE>"
BOOT_IMAGE="<BOOT_IMAGE>"
ROOTFS_IMAGE="rootfs.ext4"
for f in "$KERNEL_IMAGE" "$BOOT_IMAGE" "$ROOTFS_IMAGE"; do
test -s "output/$BOARD/images/$f" || { echo "missing: $f"; exit 1; }
done
echo "image-set-ready"预期输出:
image-set-ready<KERNEL_IMAGE> 可能是 Image、zImage 或其他内核格式;<BOOT_IMAGE> 取决于 Bootloader 的打包方式,实际文件名以当前板级配置为准。如果板级还配置了 post-image 脚本或 genimage,images/ 中通常还会出现一个面向 eMMC、SD 卡或 NOR/NAND 的最终烧录镜像,应把它加入同样的存在性检查。
固化 defconfig 与板级文件
验证配置可启动后,应把最小配置保存到版本库,而不是提交庞大的 .config。下面把 defconfig 固定到板级目录。
VENDOR="<VENDOR>"
BOARD="<BOARD>"
DEFCONFIG="$PWD/board/$VENDOR/$BOARD/defconfig"
mkdir -p "$(dirname "$DEFCONFIG")"
make O="output/$BOARD" savedefconfig BR2_DEFCONFIG="$DEFCONFIG"
test -s "$DEFCONFIG" && echo "defconfig-saved"预期输出:
defconfig-saved同时把根文件系统定制放入 board/<VENDOR>/<BOARD>/rootfs-overlay/,把 post-build、post-image 和 genimage 配置也放在同一板级目录,并通过 Buildroot 配置引用这些路径。这样版本库中保存的是“构建输入”,而不是某次人工修改后的目标板文件。
用干净目录验证可重建性
真正的一键重建标准不是“当前 output/ 还能继续 make”,而是删除输出目录后,只依靠版本库中的 Buildroot 配置、overlay、自定义包和镜像脚本仍能得到同一类产物。Toolchain、C 库、架构等基础选项发生变化时,也应使用干净输出目录重新构建,避免旧中间产物掩盖配置不一致。
验收时至少确认三件事:defconfig 能独立恢复配置,images/ 中启动链所需文件齐全,最终烧录镜像来自脚本化拼装而不是人工复制。做到这三点,板级系统才从“一次构建成功”变成“任何人都能按同一输入重新构建”。