嵌入式 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> 替换为实际板级名称。

bash
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 则纳入目标板运行所需的软件。

Buildroot 板级镜像构建数据流

构建并验证镜像集合

配置完成后直接执行构建。首次构建可能下载并编译工具链、内核和大量软件包,耗时取决于网络、CPU 与缓存。

bash
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"

预期输出:

text
image-set-ready

<KERNEL_IMAGE> 可能是 Image、zImage 或其他内核格式;<BOOT_IMAGE> 取决于 Bootloader 的打包方式,实际文件名以当前板级配置为准。如果板级还配置了 post-image 脚本或 genimage,images/ 中通常还会出现一个面向 eMMC、SD 卡或 NOR/NAND 的最终烧录镜像,应把它加入同样的存在性检查。

固化 defconfig 与板级文件

验证配置可启动后,应把最小配置保存到版本库,而不是提交庞大的 .config。下面把 defconfig 固定到板级目录。

bash
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"

预期输出:

text
defconfig-saved

同时把根文件系统定制放入 board/<VENDOR>/<BOARD>/rootfs-overlay/,把 post-build、post-image 和 genimage 配置也放在同一板级目录,并通过 Buildroot 配置引用这些路径。这样版本库中保存的是“构建输入”,而不是某次人工修改后的目标板文件。

用干净目录验证可重建性

真正的一键重建标准不是“当前 output/ 还能继续 make”,而是删除输出目录后,只依靠版本库中的 Buildroot 配置、overlay、自定义包和镜像脚本仍能得到同一类产物。Toolchain、C 库、架构等基础选项发生变化时,也应使用干净输出目录重新构建,避免旧中间产物掩盖配置不一致。

验收时至少确认三件事:defconfig 能独立恢复配置,images/ 中启动链所需文件齐全,最终烧录镜像来自脚本化拼装而不是人工复制。做到这三点,板级系统才从“一次构建成功”变成“任何人都能按同一输入重新构建”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Buildroot 生成板级镜像

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通