1. 项目概述为什么我们要亲手编译ARM Linux内核如果你手头有一块全志方案的开发板比如Orange Pi Zero 2或者荔枝派Nano你可能已经体验过直接从官方或社区下载现成的SD卡镜像刷入、上电、登录一气呵成。这很方便但就像你永远在吃别人做好的菜却不知道后厨的灶火怎么开调料怎么放。当你的项目需要一块特定的屏幕驱动、一个特殊的外设接口或者你想把内核裁剪到极致以节省那几十兆宝贵的内存时你就会发现不会自己编译内核寸步难行。“嵌入式Linux开发从0开始编译并启动ARM Linux内核全志”这个标题听起来像是一个庞大的工程但实际上它是一系列标准化操作的集合。其核心价值在于让你从“镜像使用者”转变为“系统构建者”。这个过程不仅仅是敲几条命令更是理解嵌入式Linux系统从源码到可运行实体的完整生命周期。对于全志这类在国内嵌入式市场特别是消费电子和物联网领域应用广泛的国产芯片平台掌握其内核构建方法意味着你能更深入地定制硬件功能优化系统性能并为后续的驱动开发、应用部署打下坚实的基础。简单来说这个项目就是获取官方或社区维护的Linux内核源码为你的特定全志SoC如H3、H5、V3s等进行配置、编译生成内核镜像zImage或uImage、设备树二进制文件.dtb以及内核模块最后将它们与一个现成的根文件系统rootfs组合制作成一张可以启动开发板的SD卡。接下来我将以最常见的全志H3芯片Orange Pi PC等板卡常用为例带你走完这个充满成就感的流程。即使你用的是其他全志芯片整体思路也完全一致只是具体的配置文件和设备树名称不同。2. 环境准备与工具链选型搭建你的“数字车间”工欲善其事必先利其器。编译内核需要一个稳定、高效的Linux环境。虽然理论上可以在Windows的WSL或macOS下进行但我强烈推荐使用一台物理的Linux主机或者一台性能足够的Linux虚拟机如VMware Workstation Pro Ubuntu。这能避免许多因环境差异导致的诡异问题。2.1 编译主机的选择与配置我的主力编译机是一台安装了Ubuntu 22.04 LTS的台式机。选择LTS长期支持版本是因为其软件包稳定社区支持周期长。对于嵌入式开发不建议使用滚动更新的发行版如Arch以免工具链版本频繁变动引入不确定性。首先更新系统并安装基础开发工具sudo apt update sudo apt upgrade -y sudo apt install -y build-essential git wget flex bison libssl-dev libncurses-devbuild-essential包含了GCC、make等核心编译工具。git用于克隆内核源码仓库。flex和bison语法分析器生成器内核配置过程会用到。libssl-dev提供加密库支持内核的模块签名等功能需要。libncurses-dev用于支持make menuconfig这种基于文本的图形化配置界面。2.2 ARM交叉编译工具链的获取与验证这是最关键的一步。我们的编译主机是x86_64架构而目标板是ARM架构因此我们需要一个“交叉”编译器。对于全志平台社区普遍推荐使用Linaro或Arm官方提供的GCC工具链。方案选择与理由Linaro GCC历史久社区验证充分与全志原厂BSP适配性好。但版本可能稍旧。Arm GNU ToolchainArm官方维护更新及时优化好。是当前更推荐的选择。这里我们选择Arm官方工具链。访问 Arm Developer官网 找到 “AArch32 target with hard float (arm-linux-gnueabihf)” 版本。对于全志H3Cortex-A7/A8这类32位ARMv7-A芯片就选这个。如果是64位的H5、H6则需要选择“AArch64 target (aarch64-linux-gnu)”。下载并安装以10.3-2021.07版本为例# 下载 wget https://developer.arm.com/-/media/Files/downloads/gnu-a/10.3-2021.07/binrel/arm-gnu-toolchain-10.3-2021.07-x86_64-arm-linux-gnueabihf.tar.xz # 解压到/opt目录便于系统管理 sudo tar -xJf arm-gnu-toolchain-10.3-2021.07-x86_64-arm-linux-gnueabihf.tar.xz -C /opt # 将工具链路径添加到当前用户的bashrc中 echo export PATH/opt/arm-gnu-toolchain-10.3-2021.07-x86_64-arm-linux-gnueabihf/bin:$PATH ~/.bashrc source ~/.bashrc安装后验证工具链是否可用arm-linux-gnueabihf-gcc --version如果正确输出了GCC版本信息如10.3.1并且前缀是arm-linux-gnueabihf-说明安装成功。实操心得务必确认工具链前缀与后续编译命令中的CROSS_COMPILE变量完全一致。一个常见的错误是下载了aarch64的工具链却试图编译32位内核或者环境变量设置错误导致调用的是系统自带的x86编译器这会在编译早期就报出架构不匹配的错误。3. 内核源码获取与版本选择找到正确的“蓝图”全志芯片的内核支持主要在两个地方一是全志原厂的Git仓库通常通过linux-sunxi社区间接获取二是芯片或开发板供应商提供的SDK包。对于初学者和大多数应用场景我推荐使用linux-sunxi社区维护的内核它整合了原厂代码和大量社区补丁对常见开发板的支持最好。3.1 克隆内核源码树linux-sunxi社区的内核主线跟踪的是Linux内核的某个长期支持LTS版本并打上了全志平台的补丁。我们克隆其仓库git clone https://github.com/linux-sunxi/linux-sunxi.git cd linux-sunxi进入目录后可以查看有哪些分支。通常sunxi-next分支包含了最新但可能不稳定的代码而sunxi-加上内核版本号如sunxi-5.15的分支更稳定。我们选择一个稳定的LTS分支git checkout sunxi-5.15注意事项内核版本并非越新越好。新的内核可能引入了对更新硬件的支持但也可能带来新的Bug或尚未稳定的驱动。对于生产或学习选择一个经过社区充分测试的LTS版本如5.10, 5.15, 6.1是更稳妥的做法。全志H3这类老芯片在较新的内核中可能已转入“维护模式”新功能少但稳定性高。3.2 源码树结构初窥进入内核根目录有几个关键子目录需要了解arch/arm/ARM架构相关的核心代码。我们编译的配置文件和设备树源文件dts都在这里例如arch/arm/boot/dts/sun8i-h3-orangepi-pc.dts就是Orange Pi PC的设备树。drivers/所有设备驱动的源码。这是最庞大的部分。.config编译配置文件目前还没有需要生成或获取。它决定了哪些驱动、功能被编译进内核或模块。4. 内核配置定制你的系统“基因”这是整个过程中最具技术含量也最考验耐心的环节。内核有上万个配置选项我们不可能从头开始。通常的起点是一个已知可用的基础配置。4.1 获取基础配置对于linux-sunxi社区为许多板子提供了默认配置。以Orange Pi PC全志H3为例make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- sunxi_defconfig这条命令做了以下几件事ARCHarm指定目标架构为ARM。CROSS_COMPILEarm-linux-gnueabihf-指定交叉编译工具链前缀。sunxi_defconfig使用sunxi全志SoC的代号平台的默认配置文件。这个文件位于arch/arm/configs/sunxi_defconfig。执行后会在根目录生成一个.config文件。4.2 使用menuconfig进行精细调整有了基础配置我们可以根据需求进行裁剪或增补。使用经典的文本图形界面make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- menuconfig你会看到一个基于ncurses的配置界面。在这里你可以启用/禁用功能用空格键切换。[*]表示编译进内核[M]表示编译为模块[ ]表示不编译。查找选项按/键输入关键词如“USB NETWORK”来搜索。保存与退出配置完成后选择 Save 直接回车使用默认的.config文件名然后选择 Exit 直到退出。几个关键的配置经验系统类型确保System Type - ARM system type - Allwinner A83t/A80/A64/A53/A31/A23/A20/A10被选中并且其子项里你的具体SoC如Allwinner H3被选中。设备树支持Device Drivers and Filesystem Support - Device Tree and Open Firmware support必须启用。现代ARM Linux几乎完全依赖设备树。CPU频率调节CPU Power Management - CPU Frequency scaling - Default CPUFreq governor建议选择ondemand或conservative以实现动态调频省电。网络驱动确保你的网卡驱动被编译内置或模块。对于H3的百兆以太网EMAC需要Device Drivers - Network device support - Ethernet driver support - Allwinner Sunxi Gbit MAC support。如果是USB WiFi则需要找到对应的USB无线网卡驱动如rtl8188eu。文件系统你的根文件系统是什么格式如果是EXT4确保File systems - The Extended 4 (ext4) filesystem被启用。如果使用SquashFS常用于只读根文件系统也需要启用。内核模块对于不常变动或非启动必须的驱动如某些USB设备驱动、文件系统驱动可以编译为模块[M]以减小内核镜像大小并在需要时动态加载。踩坑记录曾经为了追求极致的小内核我把Kernel Features - Use the ARM EABI to compile the kernel这个选项给关掉了结果编译出的内核根本无法启动板子卡在最初阶段。后来才知道EABI嵌入式应用二进制接口是ARM Linux运行的基石这个选项绝对不能动。教训对于不理解的配置项尤其是Kernel Features和Boot options大类下的保持默认是最安全的选择。5. 编译过程详解从源码到二进制配置完成后就可以开始编译了。这个过程耗时较长取决于你的主机CPU性能。5.1 启动编译使用-j参数指定并行编译的作业数通常设置为你的CPU核心数1以最大化利用资源make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- -j$(nproc)$(nproc)命令会自动获取你主机的逻辑CPU核心数。编译过程会依次进行准备阶段根据.config生成必要的头文件和依赖关系。内核镜像编译编译arch/arm/boot/下的核心代码生成zImage压缩的内核镜像。设备树编译编译设备树源文件.dts为二进制文件.dtb。设备树描述了板级的硬件信息如内存地址、外设连接等是内核识别硬件的关键。模块编译编译所有标记为[M]的驱动为.ko内核模块文件。5.2 关键输出文件定位编译成功后我们需要找到以下几个核心文件内核镜像arch/arm/boot/zImage设备树二进制文件对于Orange Pi PC文件是arch/arm/boot/dts/sun8i-h3-orangepi-pc.dtb。请务必根据你的具体开发板型号找到对应的.dtb文件。你可以在arch/arm/boot/dts/目录下搜索sun8i-h3-*来找到所有H3芯片的开发板设备树。内核模块所有编译好的模块文件散落在内核源码树的各个子目录中。我们不需要手动收集可以用安装命令。5.3 安装内核模块到临时目录内核模块需要被安装到根文件系统中。我们先指定一个临时目录例如./output/modules来存放它们make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- INSTALL_MOD_PATH./output/modules modules_install这条命令会将所有模块以及模块的依赖关系文件modules.dep复制到./output/modules/lib/modules/内核版本号/目录下。这个内核版本号会包含我们编译时的一些本地版本标识如5.15.0后面在制作根文件系统时会用到。6. 制作可启动的SD卡组装你的系统现在我们有了一颗“心脏”内核和“神经图”设备树还需要一个“身体”根文件系统和“启动引导器”。对于全志平台通常使用U-Boot作为引导程序并且SD卡有固定的分区布局。6.1 准备SD卡与分区将一张至少8GB的SD卡插入读卡器连接到你的Linux主机。使用lsblk或sudo fdisk -l命令确认SD卡设备名通常是/dev/sdb或/dev/mmcblk0。操作前请万分小心别选错了硬盘假设我们的SD卡是/dev/sdb首先清空分区表并创建两个必要分区sudo fdisk /dev/sdb在fdisk交互界面中输入o创建新的DOS分区表。输入n创建新分区选择p主分区分区号1起始扇区默认2048结束扇区输入64M创建一个64MB的分区用于存放内核和dtb。这个分区通常格式化为FAT32因为U-Boot可以直接读取。输入t更改分区类型选择分区1输入c设置为W95 FAT32 (LBA)。输入n创建第二个分区选择p主分区分区号2起始扇区默认结束扇区直接回车使用所有剩余空间作为根文件系统分区。输入w将更改写入磁盘并退出。然后格式化这两个分区# 格式化第一个分区为FAT32 sudo mkfs.vfat /dev/sdb1 # 格式化第二个分区为EXT4根据你的根文件系统类型选择 sudo mkfs.ext4 /dev/sdb26.2 部署U-Boot、内核与设备树全志芯片的启动流程是芯片内部ROM从SD卡特定位置加载U-Boot的SPLSecondary Program Loader再由SPL加载完整的U-Boot最后由U-Boot加载内核和设备树。我们需要一个编译好的U-Boot。你可以从开发板供应商处获取或者自己用u-boot-sunxi项目编译。这里假设你已经有了u-boot-sunxi-with-spl.bin文件。使用dd命令将U-Boot写入SD卡的特定扇区对于全志H3通常是8KB偏移处sudo dd ifu-boot-sunxi-with-spl.bin of/dev/sdb bs1024 seek8注意seek8表示跳过8个1024字节的块即从8KB位置开始写入。这个偏移量因芯片而异务必查阅你的开发板文档。接下来挂载第一个FAT分区并将内核和设备树复制进去# 创建挂载点并挂载 mkdir -p /mnt/sdcard_boot sudo mount /dev/sdb1 /mnt/sdcard_boot # 复制内核和设备树 sudo cp arch/arm/boot/zImage /mnt/sdcard_boot/ sudo cp arch/arm/boot/dts/sun8i-h3-orangepi-pc.dtb /mnt/sdcard_boot/6.3 准备与部署根文件系统根文件系统包含了Linux运行所需的所有用户空间工具、库和配置文件。对于初学者最简单的方法是使用一个现成的基础根文件系统比如Debian或Ubuntu Base。以Debian为例可以从官方下载一个最小化的根文件系统压缩包如rootfs.tar.xz。然后将其解压到SD卡的第二个分区# 挂载第二个分区 mkdir -p /mnt/sdcard_root sudo mount /dev/sdb2 /mnt/sdcard_root # 解压根文件系统请将rootfs.tar.xz替换为你的实际文件路径 sudo tar -xJf rootfs.tar.xz -C /mnt/sdcard_root现在将我们之前编译好的内核模块安装到这个根文件系统中# 将临时目录中的模块复制到根文件系统的对应位置 sudo cp -r ./output/modules/lib/modules/* /mnt/sdcard_root/lib/modules/重要步骤在根文件系统中创建必要的设备节点并设置正确的文件权限。最简单的方法是使用chroot环境但更直接的方式是确保/dev目录下有console和null节点。在部署好的根文件系统中检查sudo ls -l /mnt/sdcard_root/dev/console /mnt/sdcard_root/dev/null如果没有可以手动创建sudo mknod /mnt/sdcard_root/dev/console c 5 1 sudo mknod /mnt/sdcard_root/dev/null c 1 36.4 配置U-Boot启动参数最后我们需要告诉U-Boot如何启动内核。这通过在FAT分区/dev/sdb1创建一个名为boot.scr或uEnv.txt的脚本来实现。这里我们创建一个简单的boot.cmd文本文件然后将其编译为U-Boot可识别的boot.scr。创建boot.cmdcat EOF boot.cmd # 设置内核加载地址和设备树加载地址 setenv loadaddr 0x42000000 setenv fdt_addr_r 0x43000000 # 从SD卡加载内核和设备树 fatload mmc 0:1 \${loadaddr} zImage fatload mmc 0:1 \${fdt_addr_r} sun8i-h3-orangepi-pc.dtb # 设置内核启动参数 setenv bootargs consolettyS0,115200 earlyprintk root/dev/mmcblk0p2 rootwait panic10 # 启动内核 bootz \${loadaddr} - \${fdt_addr_r} EOFconsolettyS0,115200指定串口控制台为UART0波特率115200。这是全志H3的调试串口对于通过串口登录至关重要。root/dev/mmcblk0p2指定根文件系统在SD卡的第二个分区。mmcblk0是SD卡设备p2是第二个分区。rootwait等待根设备就绪。panic10内核崩溃后10秒重启。使用U-Boot工具mkimage将这个文本文件编译成U-Boot脚本# 假设mkimage工具已安装可通过安装u-boot-tools包获得 mkimage -C none -A arm -T script -d boot.cmd boot.scr将生成的boot.scr复制到SD卡的FAT分区sudo cp boot.scr /mnt/sdcard_boot/完成后卸载所有分区sudo umount /mnt/sdcard_boot sudo umount /mnt/sdcard_root7. 上电测试与问题排查点亮你的板子将制作好的SD卡插入开发板连接串口调试线USB to TTL到主机的USB口使用串口终端工具如minicom,picocom或screen打开对应的串口设备如/dev/ttyUSB0波特率设置为115200 8N1。然后给开发板上电。7.1 观察启动日志如果一切顺利你将在串口终端看到U-Boot的启动信息接着是内核解压、初始化硬件、加载驱动、挂载根文件系统最后出现登录提示符可能是rootorangepi:~#。恭喜你你亲手编译的内核成功启动了7.2 常见问题与排查技巧实录然而现实往往不会一帆风顺。下面是我在无数次编译启动中遇到的典型问题及解决方法问题1U-Boot启动后卡在“Starting kernel ...”再无输出。可能原因1内核镜像损坏或加载地址错误。排查在U-Boot命令行在启动倒计时时按任意键中断手动加载并启动内核检查是否有错误信息。 fatload mmc 0:1 0x42000000 zImage bootz 0x42000000 - 0x43000000解决确认zImage文件是否正确复制loadaddr是否与boot.scr中设置的一致。重新编译内核并复制。可能原因2设备树dtb不匹配或加载失败。排查同样在U-Boot中手动加载dtb并使用fdt命令检查。 fatload mmc 0:1 0x43000000 sun8i-h3-orangepi-pc.dtb fdt addr 0x43000000 fdt print如果fdt print没有输出设备树信息说明dtb文件损坏或格式不对。解决确认你使用的.dtb文件是否完全对应你的开发板型号。一个H3的dtb不能用在H5的板子上。检查编译dtb时是否有错误。问题2内核启动后在挂载根文件系统时失败提示“VFS: Unable to mount root fs”。可能原因1内核缺少对应文件系统的驱动。排查内核日志中会明确提示“unknown-block(179,2)”之类的信息并列出它尝试过的文件系统类型如ext4, vfat。解决重新配置内核make menuconfig确保File systems下你根文件系统所用的格式如EXT4被编译进内核[*]而不是模块[M]。因为挂载根文件系统时模块还没有被加载。可能原因2内核命令行参数root指定错误。排查检查bootargs中的root/dev/mmcblk0p2是否正确对应你的根文件系统分区。对于SD卡第一个分区是p1第二个是p2。解决修正boot.scr或uEnv.txt中的root参数。也可以尝试使用PARTUUID或LABEL来指定避免设备号变化。问题3系统启动后网络不通或USB设备不识别。可能原因对应的内核驱动没有启用。排查使用dmesg | grep eth0或dmesg | grep usb查看内核日志看是否有驱动加载失败或未找到设备的错误。解决重新配置内核确保相关驱动被启用。对于网络可能是Device Drivers - Network device support - Ethernet driver support下的具体网卡驱动对于USB可能是Device Drivers - USB support下的核心USB支持和主机控制器驱动如DWC2或OHCI/ EHCI。记住对于启动早期就必须工作的核心驱动一定要编译进内核而不是模块。问题4内核版本号显示“dirty”或有“”后缀模块无法加载。可能原因内核源码树不干净或者模块版本与内核不匹配。排查运行uname -r查看内核版本再查看/lib/modules/下的目录名是否完全一致。解决在编译前确保源码树是干净的git status没有未提交的修改或者使用make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- modules_prepare来准备模块构建环境。最彻底的方法是在make modules_install后手动将/lib/modules/下的目录名改为uname -r输出的名字不推荐或者确保编译和安装的环境、配置完全一致。独家避坑技巧准备一个“救急”SD卡。在开始任何内核修改前先制作一张完全由官方或已验证的镜像制作的SD卡。当你的自定义内核无法启动时可以立即换上这张“救急卡”来确认硬件和基础环境是好的从而将问题隔离在内核配置或编译环节。另外善用串口日志它是嵌入式开发最可靠的“黑匣子”90%的问题都能从启动日志中找到线索。8. 进阶优化与调试手段成功启动只是第一步。要让你的系统更贴合项目需求还需要一些进阶操作。8.1 内核裁剪与尺寸优化对于资源紧张的设备内核尺寸至关重要。使用make menuconfig进行精细裁剪移除调试信息Kernel hacking下的绝大多数选项如KGDB、Kernel debugging都可以关掉它们会显著增大内核体积。移除不需要的架构和驱动在General setup - Local version中不要添加额外字符串。在Device Drivers中移除非你板子的输入设备、声音、显卡、无线网卡等驱动。使用size命令分析编译后使用arm-linux-gnueabihf-size vmlinux可以查看内核各段text, data, bss的大小帮助你定位“肥胖”的模块。8.2 设备树DTS的修改与调试设备树是描述硬件的关键。假设你需要修改一个LED的GPIO引脚或者启用一个默认关闭的接口如SPI1。找到对应的DTS文件在arch/arm/boot/dts/下找到你的板级.dts文件如sun8i-h3-orangepi-pc.dts。理解语法设备树是一种层级数据结构。修改一个节点属性例如要启用SPI1需要将status属性从disabled改为okay。spi1 { status okay; // 可以在这里添加SPI设备子节点 };编译单独的DTB修改后不需要重新编译整个内核只需编译设备树make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- dtbs调试在内核命令行添加of*参数可以打印设备树信息。最有用的是earlycon和initcall_debug但更高级的调试需要借助dtc设备树编译器工具反编译DTB查看或者通过/sys/firmware/devicetree/base在运行系统中查看。8.3 驱动编译为模块的动态管理将驱动编译为模块.ko文件可以减小内核体积并允许动态加载/卸载。模块被安装在/lib/modules/$(uname -r)/kernel/目录下。加载模块sudo insmod /path/to/module.ko查看已加载模块lsmod卸载模块sudo rmmod module_name模块依赖使用depmod命令生成模块依赖关系然后modprobe module_name可以自动加载依赖。一个实用场景你的项目需要支持多种USB无线网卡但每次只使用一种。你可以将所有这些USB WiFi驱动都编译为模块。系统启动后插入哪种网卡就用modprobe加载对应的驱动通常系统会自动处理。这样既保持了内核的简洁又获得了灵活性。从一行命令开始到串口终端上跳动的登录提示符结束这趟“从0编译ARM Linux内核”的旅程其意义远不止于让一块开发板跑起来。它让你穿透了嵌入式系统那层神秘的面纱亲手触摸到从源码到二进制、从硬件描述到系统启动的每一个齿轮。当你下次再面对一个陌生的嵌入式平台时这份经验将成为你最可靠的路线图获取工具链、找到源码、理解配置、解决启动问题。全志平台只是一个起点这套方法论在Rockchip、Amlogic乃至STM32MP1等平台上同样适用只是具体的配置文件和工具链前缀有所不同。嵌入式开发的世界很大但有了自己编译内核的能力你就拥有了探索这个世界最基础也最重要的钥匙。
详解：简化自定义类型比较)
