从0开始编译 U-Boot那些教程没告诉你的交叉编译原理和踩坑记录写在前面嘿这里是CharlieChen114514笔者的一位朋友准备接触嵌入式Linux了刚好笔者准备重新试试IMX6ULL更加进一步的重新学习嵌入式Linux。笔者手头的系列文章看了一下感觉不够扎实。所以打算好好的做一下专门的嵌入式Linux系列的开发博客尝试分享给各位入门其实我也算入门的嵌入式Linux爱好者不敢碰瓷真驱动开发和系统裁剪工程师大佬们一些我的踩坑经验虽然我的本职工作跟这个半毛钱关系没有但是我仍然会尝试保证这些内容的可靠性。这个系列的仓库笔者专门维护在一个IMX加油仓库上 Link:Awesome-Embedded-Learning-Studio/imx-forge: This is a repo with templated contains imx6ull-chips, uboot, kernel, rootfs patches to make fast applyURL:https://github.com/Awesome-Embedded-Learning-Studio/imx-forge各位感兴趣的话可以提Issue或者任何问题PS: 挖了不少坑不过没事该填会填嵌入式C开发大致快到C部分的尾声了剩下的可能是笔者象到了可能有帮助的Feature进行补充了笔者会在最后的时候添加这个仓库的下一部分的建设专门发一篇文章说明为什么又要写一篇编译教程你可能会问网上 U-Boot 编译教程一堆为什么还要写说实话当我第一次尝试编译 U-Boot 的时候我也这么想。照着教程敲命令不就行了吗结果现实给了我一记响亮的耳光。第一个报错是缺少某个依赖包我装上这个编译到一半又缺另一个。第二个坑是工具链问题我一开始用系统自带的 gcc 编译产物根本不对。第三个坑最离谱我改了配置文件结果完全不生效排查了半天发现是 .config 残留导致的。产物验证更是没人教编译完了不知道怎么确认没白忙活。大多数教程的问题是只给命令不给原理。告诉你运行make xxx_defconfig但不解释 defconfig 是什么告诉你用arm-linux-gnueabihf-gcc但不说为什么要用交叉编译器告诉你编译产物是 u-boot.bin但不教你验证架构对不对。所以这篇文章的目标很明确我们要完整地走一遍 U-Boot 编译流程理解每一步在做什么、为什么要这么做、可能会遇到什么坑。到了最后你会意识到这些步骤可以自动化我会给你一个完整的build.sh脚本——但那时候你已经理解了脚本的每一行在做什么而不是机械地复制粘贴。我们的工作环境先说明一下本文的环境避免踩不必要的坑平台Ubuntu 24.04 LTS 目标板i.MX6ULL 14x14 EVK (eMMC) 工具链arm-none-linux-gnueabihf-gcc U-Boot 版本基于 NXP uboot-imx (lf_v2025.04)哦对目标的板子是啥样后面笔者会再出一个——以正点原子开发板为例子如何进行正确的修改。嗯笔者在出差亲爱的板子还在家里睡觉呢。当然环境不完全一样也没关系。Ubuntu 20.04/22.04 都可以工具链只要是 ARM 硬浮点 ABI 的就行版本最好是 2020 年之后的。U-Boot 版本差异主要在配置选项上编译流程基本一致。准备工作那些看似无关的包为什么必须装在我们开始编译之前先要把依赖装齐。这一步看起来简单但缺了任何一个包你都会在不同阶段遇到莫名其妙的报错。sudoaptinstall\build-essential\bc\bison\flex\libssl-dev\libgnutls28-dev\libncurses-dev\device-tree-compiler\python3\python3-pyelftools\swig我来逐项解释这些包都是干什么的。build-essential是基础构建工具包包含了 gcc、make、libc-dev 这些编译必备的东西。没有它你连最简单的 C 程序都编不过。bc是命令行计算器你可能觉得奇怪编译 U-Boot 要计算器干嘛答案在于 Kconfig 配置系统。U-Boot 的配置系统来自 Linux 内核而内核的 Kconfig 脚本会用到 bc 进行数值计算。没有 bcmake menuconfig 的时候会报错。bison和flex是语法分析器生成工具用编译原理的话说就是词法分析器和语法分析器生成器。U-Boot 需要解析 Kconfig 配置文件和设备树文件这两者都需要 bison 和 flex。你可能会在编译错误信息里看到 “missing bison” 或 “missing flex”这就是缺这两个包的表现。libssl-dev和libgnutls28-dev是加密库开发文件。U-Boot 支持 FIT Image 格式这是一种带签名的镜像格式用于安全启动。还支持加密的环境变量存储。这些功能需要 OpenSSL 或 GnuTLS 库。如果你不需要这些功能理论上可以不装但为了避免编译到一半报错建议还是装上。libncurses-dev是 ncurses 库的开发文件。ncurses 是一个终端图形库make menuconfig 这种文本配置界面就是用它做的。没有它你就没法用图形界面配置 U-Boot。device-tree-compiler也就是 dtc是设备树编译器。U-Boot 需要把 .dts 设备树源文件编译成 .dtb 二进制文件。虽然 U-Boot 源码里自带了一个 dtc但系统安装一个版本更稳定而且可以用于验证编译产物。python3和python3-pyelftools是 Python 环境和 ELF 文件解析库。U-Boot 的某些构建脚本是用 Python 写的pyelftools 用于分析 ELF 文件格式。虽然不是严格必需但装上可以避免一些奇怪的问题。swig是 Simplified Wrapper and Interface Generator用于把 C/C 代码包装成其他语言比如 Python的接口。U-Boot 的某些工具需要它不装的话编译可能会失败。理解交叉编译为什么不能直接用 gcc现在我们来到第一个核心概念交叉编译。很多新手在这里卡住不明白为什么不能用系统的 gcc 直接编译。问题很简单你的开发机是 x86_64 架构的而 U-Boot 要跑在 ARM 架构的板子上。x86 的 CPU 跑不了 ARM 指令反之亦然。所以我们需要一个能运行在 x86 上、但生成 ARM 代码的编译器——这就是交叉编译器。交叉编译器的命名规则是有规律的。以arm-none-linux-gnueabihf-gcc为例arm是目标架构none表示没有厂商非嵌入式工具链linux是目标操作系统gnueabihf是 GNU EABI 硬浮点 ABI这里重点解释一下gnueabihf。ARM 有两种浮点 ABI软浮点gnueabi和硬浮点gnueabihf。软浮点模式下浮点运算用软件模拟函数调用时整数和浮点参数都通过通用寄存器传递。硬浮点模式下浮点运算用硬件 FPU 执行浮点参数通过浮点寄存器传递。i.MX6ULL 有硬件 FPU所以我们要用硬浮点工具链性能更好。获取交叉编译工具有几种方式。一种是直接从 ARM 官网下载预构建的工具链另一种是用 Ubuntu 的包管理器安装比如gcc-arm-linux-gnueabihf还有一种是自己用 crosstool-NG 编译。对于初学者推荐用前两种省时省力。安装好后你可以用这个命令验证arm-none-linux-gnueabihf-gcc--version如果输出了版本信息说明工具链在 PATH 里可以正常使用。第一步distclean——为什么要清理现在我们终于可以开始编译了。第一步是清理旧的编译产物makeARCHarmCROSS_COMPILEarm-none-linux-gnueabihf- distclean这里解释一下这两个变量的作用。ARCHarm告诉 U-Boot 目标架构是 ARM它会在arch/arm/目录下找架构相关代码。CROSS_COMPILEarm-none-linux-gnueabihf-指定交叉编译器前缀U-Boot 会用arm-none-linux-gnueabihf-gcc编译 C 文件用arm-none-linux-gnueabihf-ld链接以此类推。distclean目标会删除所有编译生成的文件包括 .config 配置文件。为什么要这么做因为编译产物可能会污染后续编译。最典型的例子就是 .config 残留你改了 defconfig但旧的 .config 还在make 的时候可能会优先用 .config导致你的修改不生效。所以如果你准备总的确认你的修改是有效的请distclean一笔勾销之前的编译产物。如果你确信需要保留某些配置可以用make clean只删除编译产物不删 .config。但对于第一次编译建议还是用 distclean。第二步defconfig——配置的魔法清理完成后我们需要配置 U-BootmakeARCHarmCROSS_COMPILEarm-none-linux-gnueabihf- mx6ull_14x14_evk_emmc_defconfig这个命令背后的机制比很多人想象的复杂。configs/目录下有 500 多个 defconfig 文件每个文件代表一种板型或配置组合。defconfig 不是 .config 的完整复制它只存储与默认值不同的配置选项。举个例子如果某个配置项默认是 n板子需要它设为 ydefconfig 里就只会记录CONFIG_XXXy。当你运行make xxx_defconfig时U-Boot 会做这几件事加载指定的 defconfig处理 Kconfig 文件评估所有配置符号、依赖和默认值最后生成完整的 .config 文件。所以 .config 是 defconfig Kconfig 系统共同作用的结果不是简单的复制粘贴。配置文件的位置是configs/mx6ull_14x14_evk_emmc_defconfig你可以打开看看内容CONFIG_TARGET_MX6ULL_14X14_EVKy CONFIG_DEFAULT_DEVICE_TREEimx6ull-14x14-evk-emmc CONFIG_MX6ULLy ...每一行都是一个配置选项。如果你想修改配置可以用make menuconfig打开图形界面或者直接编辑 .config 文件。但要注意直接编辑 .config 可能会被 menuconfig 覆盖推荐还是用 menuconfig。配置完成后.config 文件会出现在源码根目录。这个文件是编译时实际使用的配置包含了完整的配置信息默认值 板级特定设置。第三步make——并行编译的威力配置完成后终于可以编译了makeARCHarmCROSS_COMPILEarm-none-linux-gnueabihf- -j$(nproc)-j$(nproc)这个参数很重要。nproc命令会输出 CPU 核心数-j告诉 make 可以并行运行这么多任务。现代 CPU 都是多核的不利用并行编译就太浪费了。我电脑配置好基本上nproc一下我手碰到桌子另一端的杯子拿回来喝一口水之后编译就完成了。编译过程做了这些事情编译 C 源文件生成 .o 目标文件链接生成 u-boot ELF 文件用 objcopy 转换格式生成 u-boot.bin 纯二进制编译设备树生成 u-boot.dtb最后打包成 u-boot-dtb.imx 镜像。编译完成后你会在源码根目录看到这些文件u-bootELF 格式的可执行文件带调试信息大约 6MB。这个文件可以用于调试但不能直接烧录。u-boot.bin纯二进制格式去掉了 ELF 头和调试信息大约 600KB。这个是可以直接烧录到板子上的文件。u-boot-nodtb.bin不带设备树的二进制文件。U-Boot 支持运行时加载设备树这个文件用于这种场景。u-boot.dtb设备树 blob编译后的二进制格式设备树大约 30KB。u-boot-dtb.binu-boot-nodtb.bin 和 u-boot.dtb 的简单拼接。u-boot-dtb.imxNXP i.MX 专用格式在 u-boot-dtb.bin 的基础上加了 IVTImage Vector Table头。这里重点解释一下 u-boot-dtb.imx。NXP i.MX 系列芯片的 Boot ROM 有特殊要求它要求镜像开头有一个 IVT 头里面包含了镜像的入口地址、DCDDevice Configuration Data等信息。没有这个头Boot ROM 不识别镜像启动会失败。tools/mkimage工具就是用来生成这种格式的。产物验证如何确认编译没白忙活编译完成了但我们还不能高兴得太早。你需要验证产物是否正确不然烧到板子上发现起不来排查起来更麻烦。架构检查用 readelf 看清真相首先检查架构是否正确readelf-hu-boot|grepMachine你应该看到类似这样的输出Machine: ARM如果不是 ARM说明你用错了工具链白忙活了。我见过有人用 aarch64 工具链编译 armv7 代码产物架构不对板子上当然跑不起来。除了架构还可以看入口地址readelf-hu-boot|grepEntry point输出类似Entry point address: 0x87800000这个地址是 U-Boot 在内存中的加载位置。i.MX6ULL 的 DDR 起始地址是 0x80000000U-Boot 加载到 0x87800000这个值是在链接脚本里定义的。设备树验证dtc 反编译接下来验证设备树是否正确dtc-Idtb-Odts u-boot.dtb|grepfsl,imx6ull你应该能看到类似这样的输出compatible fsl,imx6ull;如果看不到 imx6ull 的字样说明设备树可能选错了。设备树选错的后果很严重板子能启动但外设全认不出来串口有输出但网络、存储都不工作。这个在之后就是我们的魔改工作。iMX 镜像验证mkimage 工具最后验证一下 u-boot-dtb.imx 的格式./tools/mkimage-lu-boot-dtb.imx你应该能看到类似这样的输出Image Type: ARM Linux Firmware Image (uncompressed) Data Size: 613888 Bytes 599.50 KiB 0.59 MiB Load Address: 87800000 Entry Point: 87800000这个输出告诉我们镜像的类型、大小、加载地址和入口点。如果这些值不对说明 mkimage 打包出了问题。总结成脚本方便起见我们把它自动化到这里你应该已经掌握了 U-Boot 编译的完整流程。但每次都要敲这么多命令确实有点累。而且容易出错比如忘了 distclean 导致配置不生效或者 ARCH 和 CROSS_COMPILE 写错了。所以我们把这些步骤总结成一个脚本。下面是完整的build.sh我加了依赖检查和产物验证确保每一步都不会出错#!/bin/bash## U-Boot build script for mx6ull_14x14_evk_emmc#set-e# ConfigurationARCHarmCROSS_COMPILEarm-none-linux-gnueabihf-DEFCONFIGmx6ull_14x14_evk_emmc_defconfigDEFAULT_DEVICE_TREEimx6ull-14x14-evk-emmc# Colors for outputRED\033[0;31mGREEN\033[0;32mYELLOW\033[1;33mNC\033[0m# No Colorlog_info(){echo-e${GREEN}[INFO]${NC}$1}log_error(){echo-e${RED}[ERROR]${NC}$1}log_warn(){echo-e${YELLOW}[WARN]${NC}$1}# Get number of CPU cores for parallel buildNPROC$(nproc)log_infoUsing${NPROC}parallel jobs# Check host dependenciescheck_host_dependencies(){log_infoChecking host dependencies...MISSING_PKGS()FOUND_PKGS()# Helper: check if command existscheck_cmd(){localcmd$1localpkg$2ifcommand-v${cmd}/dev/null;thenFOUND_PKGS(${pkg})return0elseMISSING_PKGS(${pkg})return1fi}# Check build toolscheck_cmd gcc build-essential||truecheck_cmdmakebuild-essential||truecheck_cmdbcbc||truecheck_cmd bison bison||truecheck_cmd flex flex||truecheck_cmd dtc device-tree-compiler||truecheck_cmd python3 python3||truecheck_cmd swig swig||true# Check libraries via dpkgifdpkg-slibssl-dev/dev/null;thenFOUND_PKGS(libssl-dev)elseMISSING_PKGS(libssl-dev)fiifdpkg-slibgnutls28-dev/dev/null||[-f/usr/include/gnutls/gnutls.h];thenFOUND_PKGS(libgnutls28-dev)elseMISSING_PKGS(libgnutls28-dev)fiifdpkg-slibncurses-dev/dev/null||[-f/usr/include/ncursesw/ncurses.h]||[-f/usr/include/ncurses/ncurses.h];thenFOUND_PKGS(libncurses-dev)elseMISSING_PKGS(libncurses-dev)fi# Check pyelftools Python moduleifpython3-cimport elftools2/dev/null;thenFOUND_PKGS(python3-pyelftools)elseMISSING_PKGS(python3-pyelftools)fi# Remove duplicatesFOUND_PKGS($(echo${FOUND_PKGS[]}|tr \n|sort-u))MISSING_PKGS($(echo${MISSING_PKGS[]}|tr \n|sort-u))# Display resultsforpkgin${FOUND_PKGS[]};dolog_info ✓${pkg}doneforpkgin${MISSING_PKGS[]};dolog_warn ✗${pkg}(not found)doneif[${#MISSING_PKGS[]}-gt0];thenlog_errorMissing dependencies:${MISSING_PKGS[*]}echolog_infoInstall missing packages with:echo-e${YELLOW}sudo apt install${MISSING_PKGS[*]}${NC}echoexit1filog_infoAll host dependencies found}# Check if toolchain existscheck_toolchain(){log_infoChecking toolchain...if!command-v${CROSS_COMPILE}gcc/dev/null;thenlog_errorCross compiler ${CROSS_COMPILE}gcc not found!log_errorPlease ensure the toolchain is installed and in your PATHexit1fiGCC_VERSION$(${CROSS_COMPILE}gcc--version|head-n1)log_infoToolchain found:${GCC_VERSION}fortoolinobjcopy objdump strip;doif!command-v${CROSS_COMPILE}${tool}/dev/null;thenlog_errorTool ${CROSS_COMPILE}${tool} not found!exit1fidonelog_infoAll required toolchain components found}# Check if device tree existscheck_device_tree(){log_infoChecking device tree...DTS_FILEarch/arm/dts/${DEFAULT_DEVICE_TREE}.dtsif[!-f${DTS_FILE}];thenlog_errorDevice tree file not found:${DTS_FILE}exit1filog_infoDevice tree found:${DTS_FILE}BASE_DTSarch/arm/dts/imx6ull-14x14-evk.dtsif[-f${BASE_DTS}];thenlog_infoBase device tree found:${BASE_DTS}fi}# Check if defconfig existscheck_defconfig(){log_infoChecking defconfig...DEFCONFIG_FILEconfigs/${DEFCONFIG}if[!-f${DEFCONFIG_FILE}];thenlog_errorDefconfig file not found:${DEFCONFIG_FILE}exit1filog_infoDefconfig found:${DEFCONFIG_FILE}}# Clean builddo_distclean(){log_infoRunning distclean...makeARCH${ARCH}CROSS_COMPILE${CROSS_COMPILE}distclean}# Configure U-Bootdo_configure(){log_infoConfiguring U-Boot with${DEFCONFIG}...makeARCH${ARCH}CROSS_COMPILE${CROSS_COMPILE}${DEFCONFIG}}# Build U-Bootdo_build(){log_infoBuilding U-Boot...makeARCH${ARCH}CROSS_COMPILE${CROSS_COMPILE}-j${NPROC}}# Verify build artifactsverify_build_artifacts(){log_infoVerifying build artifacts...localhas_error0# Check ELF fileif[-fu-boot];thenlocalreadelf_cmd${CROSS_COMPILE}readelfif!command-v${readelf_cmd}/dev/null;thenreadelf_cmdreadelffiifcommand-v${readelf_cmd}/dev/null;thenARCH_INFO$(${readelf_cmd}-hu-boot2/dev/null|grepMachine:|awk{print $2})if[[${ARCH_INFO}*ARM*]];thenlog_info ✓ u-boot:${ARCH_INFO}ENTRY_ADDR$(${readelf_cmd}-hu-boot2/dev/null|grepEntry point|awk{print $4})if[-n${ENTRY_ADDR}];thenlog_info Entry: 0x${ENTRY_ADDR}fielselog_error ✗ u-boot: Wrong architecture (${ARCH_INFO})has_error1fifielselog_error ✗ u-boot: not foundhas_error1fi# Check binary fileif[-fu-boot.bin];thenSIZE$(stat-c%s u-boot.bin2/dev/null||stat-f%z u-boot.bin2/dev/null)log_info ✓ u-boot.bin:${SIZE}byteselselog_error ✗ u-boot.bin: not foundhas_error1fi# Check device tree blobif[-fu-boot.dtb];thenifcommand-vdtc/dev/null;thenDTS_INFO$(dtc-Idtb-Odts u-boot.dtb2/dev/null|grep-Ecompatible|fsl,imx6ull|head-3)if[[${DTS_INFO}*fsl,imx6ull*]]||[[${DTS_INFO}*imx6ull-14x14-evk*]];thenlog_info ✓ u-boot.dtb: i.MX6ULL device tree detectedelselog_info ✓ u-boot.dtb: presentfielseDTB_SIZE$(stat-c%s u-boot.dtb2/dev/null||stat-f%z u-boot.dtb2/dev/null)log_info ✓ u-boot.dtb:${DTB_SIZE}bytesfielselog_error ✗ u-boot.dtb: not foundhas_error1fi# Check iMX imageif[-fu-boot-dtb.imx];thenif[-f./tools/mkimage];thenIMX_INFO$(./tools/mkimage-lu-boot-dtb.imx2/dev/null|grepImage Type)if[-n${IMX_INFO}];thenlog_info ✓ u-boot-dtb.imx:${IMX_INFO}elseSIZE$(stat-c%s u-boot-dtb.imx2/dev/null||stat-f%z u-boot-dtb.imx2/dev/null)log_info ✓ u-boot-dtb.imx:${SIZE}bytesfififiif[${has_error}-eq0];thenlog_infoAll build artifacts verified successfullyreturn0elselog_errorBuild artifact verification failedreturn1fi}# Main build processmain(){log_infoStarting U-Boot build for${DEFCONFIG}log_info# Pre-build checkscheck_host_dependencies check_toolchain check_device_tree check_defconfig log_infolog_infoAll checks passed, starting build...log_info# Build processdo_distclean do_configure do_build log_info# Verify build artifactsverify_build_artifacts||exit1log_infolog_infoBuild completed successfully!log_infoOutput files summary:[-fu-boot.bin]log_info - u-boot.bin[-fu-boot-dtb.bin]log_info - u-boot-dtb.bin[-fu-boot-dtb.imx]log_info - u-boot-dtb.imx (for i.MX boot)[-fu-boot.dtb]log_info - u-boot.dtb[-fu-boot.srec]log_info - u-boot.sreclog_info}# Run main functionmain$这个脚本做了几件事检查主机依赖、检查交叉编译工具链、检查设备树和 defconfig 文件是否存在、执行 distclean/configure/build 三阶段编译、最后验证编译产物。每一步都有日志输出出错时能快速定位。使用方法很简单chmodx build.sh ./build.sh写在最后到这里U-Boot 编译的完整流程你就掌握了。从手动敲命令到理解每个步骤的含义从排查错误到自动化脚本我们走完了整个旅程。编译不是黑魔法每一步都有它的原因。distclean 是为了避免缓存毒药defconfig 是通过 Kconfig 生成配置make -j$(nproc) 是利用多核加速产物验证是确保没白忙活。当你理解了这些你就不是在机械地复制命令而是在掌控整个构建过程。