1. 项目概述为什么我们要亲手编译ARM Linux内核如果你手头有一块全志方案的开发板比如Orange Pi Zero 2或者NanoPi想在上面跑点自己的程序或者想深入理解嵌入式系统是怎么从一堆代码变成能点亮屏幕、连接网络的智能设备那么“从零开始编译并启动ARM Linux内核”就是你绕不开的一步。这不仅仅是把官方提供的现成镜像烧录到SD卡那么简单而是一个从源码到二进制从裸机到操作系统的完整构建过程。我之所以花时间折腾这个是因为现成的镜像往往只包含了最通用的驱动和配置当你需要启用某个特定的硬件功能、裁剪掉不需要的模块以节省资源或者单纯想学习内核的启动流程时自己动手编译就成了唯一的选择。全志的芯片比如常见的V3s、F1C100s、T527等在开源硬件和创客圈子里非常流行其对应的Linux内核源码在社区维护得也相当不错。这个过程能让你彻底搞清楚一个为特定ARM架构比如ARMv7或ARMv8定制的Linux内核是如何被交叉编译工具链“翻译”出来的内核镜像、设备树Device Tree和根文件系统这三者之间是什么关系以及最终我们如何让这块小小的开发板按照我们的意愿启动起来。对于嵌入式Linux驱动开发者来说这更是基本功因为驱动代码最终是要编译进内核或者以模块形式加载的。接下来我就以手头一块全志V3s的开发板为例带你走一遍这个充满细节的旅程。2. 开发环境搭建与工具链选型工欲善其事必先利其器。编译Linux内核需要一个高效、可靠的交叉编译环境。所谓“交叉编译”就是在我们常用的x86_64架构的电脑宿主机上生成能在ARM架构开发板目标机上运行的代码。2.1 交叉编译工具链的选择与安装市面上工具链很多比如Linaro、ARM官方提供的gcc-arm-none-eabi以及各大芯片厂商自己定制的工具链。对于全志平台我强烈推荐使用社区验证过的、与内核版本匹配的工具链。这里我选择gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf。选择7.5.0版本是因为它和较新的内核兼容性好同时稳定性经过考验。“gnueabihf”中的“hf”代表硬浮点Hard Float能利用ARM芯片的浮点运算单元提升性能。在Ubuntu 20.04宿主机上安装步骤如下# 1. 下载工具链假设放在/home/username/目录下 wget https://releases.linaro.org/components/toolchain/binaries/7.5-2019.12/arm-linux-gnueabihf/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz # 2. 解压 tar -xvf gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz # 3. 将工具链路径加入系统环境变量方便调用 echo export PATH$PATH:/home/username/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin ~/.bashrc source ~/.bashrc # 4. 验证安装 arm-linux-gnueabihf-gcc --version如果终端能正确输出gcc的版本信息说明工具链安装成功。这里有个关键细节一定要将工具链的bin目录路径添加到PATH环境变量中否则后续编译时会找不到arm-linux-gnueabihf-为前缀的命令如gcc, ld等。2.2 获取Linux内核源码与全志平台支持全志芯片的内核源码主要维护在几个地方一是全志官方为某些芯片提供的SDK通常比较庞大二是Linux内核主线Mainline社区开发者会逐步将全志芯片的驱动并入主线三是诸如linux-sunxi现为sunxi-linux这样的社区维护分支它对全志Allwinner系列芯片的支持非常活跃和及时。对于初学者或追求稳定性的开发者我建议从社区分支开始。这里我们使用sunxi-linux的某个稳定分支。以linux-5.10.y分支为例这个版本长期支持驱动相对完善。# 克隆sunxi-linux仓库并切换到特定分支 git clone https://github.com/sunxi-linux/linux -b sunxi-5.10 cd linux注意内核源码体积较大下载需要一定时间。确保你的宿主机磁盘空间充足建议预留15GB以上。克隆完成后你可以通过git branch -a查看所有远程分支选择适合你芯片的版本。例如对于较新的T527芯片可能需要更新版本的分支。2.3 宿主机基础依赖包安装编译内核需要宿主机安装一些必要的开发工具和库。在Ubuntu/Debian系统上可以一次性安装sudo apt-get update sudo apt-get install -y build-essential libncurses5-dev libssl-dev bc flex bison libelf-devbuild-essential: 包含gcc, make等基础编译工具。libncurses5-dev: 用于支持make menuconfig图形化配置界面。libssl-dev和bc: 内核编译过程中某些功能如模块签名需要。flex和bison: 语法分析器生成工具编译某些内核组件时需要。libelf-dev: 处理ELF格式文件所需的库。安装这些依赖可以避免后续编译时出现令人头疼的“找不到xxx.h文件”或“命令未找到”的错误。3. 内核配置与裁剪为你的板子量身定做拿到内核源码后直接编译是不行的我们必须告诉编译系统我们要为哪种架构的哪种芯片启用哪些功能。这就是内核配置。3.1 导入默认配置与图形化配置全志社区通常为热门开发板提供了默认配置文件defconfig。以Orange Pi Zero使用全志H2芯片为例其配置可能是sun8i-h3-defconfig。对于V3s社区常用sun8i-v3s-licheepi-zero-defconfig针对Lichee Pi Zero开发板核心是V3s。# 在linux源码根目录下执行 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- sun8i-v3s-licheepi-zero-defconfig这条命令做了几件事ARCHarm指定目标架构为ARMCROSS_COMPILE指定交叉编译工具链前缀最后是defconfig的名称。执行后会在源码根目录生成一个.config文件这是内核编译的“总蓝图”。但默认配置可能包含了你不需要的驱动也可能缺少你需要的功能。我们需要进行微调make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- menuconfig这会启动一个基于ncurses的文本图形界面。在这里你可以像逛菜单一样浏览和修改成千上万个配置选项。3.2 关键配置项解析与实操心得面对海量选项新手容易懵。我建议重点关注以下几类它们直接影响内核能否在你的板子上正常启动和工作系统类型System Type:确保在ARM system type下选择了正确的CPU系列如Allwinner A1x SoCs或Allwinner sun8i Family。对于V3s它属于sun8i家族。在Allwinner SoC Support子菜单中务必选中你的具体SoC型号例如Allwinner V3s。这确保了最基础的芯片支持被编译进去。设备树支持Device Tree:确保CONFIG_OFFlattened Device Tree support是开启的。现代ARM Linux几乎都使用设备树来描述硬件。在Allwinner SoC Support下找到你的开发板对应的设备树源文件.dts编译选项并启用。例如对于Lichee Pi Zero需要找到CONFIG_MACH_SUN8I_V3S_LICHEEPI_ZERO并设为y编译进内核。驱动配置:串口驱动这是你最重要的调试窗口确保CONFIG_SERIAL_8250和CONFIG_SERIAL_8250_CONSOLE启用。并在其子选项中找到对应全志平台的UART驱动如Allwinner A10 UART。SD/MMC驱动你的根文件系统很可能在SD卡上。确保CONFIG_MMC、CONFIG_MMC_SUNXI启用。网络驱动如果你的板子有网络有线或无线找到对应的驱动。例如V3s的EMAC网络控制器对应CONFIG_SUN8I_EMAC。USB驱动如果需要连接USB设备确保对应的Host控制器驱动如CONFIG_USB_OHCI_HCD,CONFIG_USB_EHCI_HCD已启用。文件系统支持你的根文件系统是什么格式如果是EXT4确保CONFIG_EXT4_FSy。如果是SquashFS常用于只读系统则启用CONFIG_SQUASHFS。如果使用initramfs初始内存文件系统作为临时根文件系统来引导需要在General setup-Initial RAM filesystem and RAM disk (initramfs/initrd) support中配置。内核调试与打印初期调试内核的打印信息至关重要。确保CONFIG_PRINTK、CONFIG_EARLY_PRINTK是开启的。EARLY_PRINTK能在内核非常早期的阶段就通过串口输出信息对于排查启动卡死的问题帮助巨大。实操心得第一次配置时可以在默认defconfig的基础上只修改你明确知道需要改动的选项。对于不确定的选项保持默认通常默认值是最安全或最通用的选择。配置完成后记得保存。菜单界面底部有操作提示按Y编译进内核M编译为模块N不编译。模块的好处是可以减小内核体积在需要时动态加载但启动时需要额外的initramfs来加载模块对初学者稍复杂。建议初期将核心驱动直接编译进内核Y简化启动流程。4. 内核编译与产物生成配置完成后就可以开始编译了。这个过程比较耗时取决于你电脑的CPU核心数和内核配置的复杂程度。4.1 启动编译与参数优化使用-j参数指定并行编译任务数可以大幅缩短编译时间。通常设为你的CPU核心数1或2。make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- -j$(nproc)$(nproc)命令会自动获取你系统的CPU核心数。编译过程中终端会滚动输出大量的编译信息。如果没有出现error只有warning通常可以忽略编译会继续进行。编译最终会生成几个核心文件arch/arm/boot/zImage: 压缩的内核镜像文件。这是最主要的启动内核。arch/arm/boot/dts/板子名称.dtb: 设备树二进制文件Device Tree Blob。它由我们之前配置时选择的.dts文件编译而来包含了板级的硬件描述信息比如内存地址、外设寄存器、中断号等。对于V3s Lichee Pi Zero这个文件可能是sun8i-v3s-licheepi-zero.dtb。如果配置了模块模块文件会分散在lib/modules/内核版本/kernel/目录下。4.2 常见编译错误排查即使按照步骤来也可能遇到编译错误。这里记录几个我踩过的坑“recipe for target ‘xxx’ failed”这通常是缺少某个依赖包。仔细看错误信息的上方通常会提示缺少某个.h头文件或某个命令。根据提示安装对应的开发包即可。例如如果提示openssl/xxx.h找不到那就安装libssl-dev。工具链版本不兼容如果你使用了太新或太旧的工具链可能会遇到奇怪的语法错误或链接错误。错误信息可能包含“unrecognized command line option”或“undefined reference”。解决方案是换用社区推荐的工具链版本确保与内核版本匹配。配置冲突有时手动修改.config文件不当会导致选项依赖关系出错。一个干净的解决方法是备份你的自定义配置可以用make savedefconfig生成精简的defconfig文件然后make mrproper彻底清理源码树再重新导入defconfig并进入menuconfig修改。编译成功后建议将zImage和对应的.dtb文件复制到一个单独的目录方便后续打包。cp arch/arm/boot/zImage /path/to/your/sd_card_boot/ cp arch/arm/boot/dts/sun8i-v3s-licheepi-zero.dtb /path/to/your/sd_card_boot/5. 构建根文件系统与启动介质准备只有内核是启动不了一个完整系统的我们还需要根文件系统rootfs。根文件系统包含了操作系统运行所必需的所有目录结构、系统工具如ls,mount、库文件、配置文件如/etc/fstab,/etc/inittab等。5.1 使用BusyBox构建最小根文件系统对于嵌入式环境BusyBox是一个瑞士军刀式的工具集它把许多常用的Unix工具如sh,echo,mount,ifconfig集成进一个单一的可执行文件通过创建符号链接来提供各种命令极大地节省了空间。构建步骤# 1. 下载并解压BusyBox源码以1.35.0稳定版为例 wget https://busybox.net/downloads/busybox-1.35.0.tar.bz2 tar -xvf busybox-1.35.0.tar.bz2 cd busybox-1.35.0 # 2. 配置BusyBox同样使用交叉编译 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- defconfig # 使用默认配置 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- menuconfig # 可选进行定制在menuconfig中一个重要的设置是进入Settings-Build Options选中Build static binary (no shared libs)。这将BusyBox编译成静态链接运行时不需要额外的动态库简化了根文件系统的制作但体积会稍大。对于新手静态编译更省心。# 3. 编译并安装到指定目录 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- -j$(nproc) make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- install CONFIG_PREFIX/path/to/your/rootfs安装后在/path/to/your/rootfs目录下你会看到bin,sbin,usr等目录以及linuxrc文件。5.2 完善根文件系统目录与关键文件BusyBox只提供了基础命令一个可用的根文件系统还需要更多目录和关键配置文件。cd /path/to/your/rootfs mkdir -p dev proc sys tmp run etc/init.ddev: 设备文件目录内核启动后会在这里创建设备节点如console,ttyS0。proc和sys: 虚拟文件系统内核通过它们向用户空间暴露系统信息和控制接口。tmp: 临时文件目录。etc/init.d: 初始化脚本目录。接下来创建最关键的初始化文件。在/path/to/your/rootfs/etc/init.d/下创建一个名为rcS的脚本注意赋予可执行权限chmod x rcS#!/bin/sh # rcS - 系统启动初始化脚本 # 挂载虚拟文件系统 mount -t proc none /proc mount -t sysfs none /sys mount -t tmpfs none /tmp # 设置主机名 hostname MyAllwinnerBoard # 挂载/dev为tmpfs允许内核动态创建设备节点 mount -t tmpfs none /dev # 创建设备节点 mknod /dev/console c 5 1 mknod /dev/null c 1 3 mknod /dev/zero c 1 5 # 设置网络如果需要这里可以调用ifconfig配置IP # /sbin/ifconfig lo 127.0.0.1 up # /sbin/ifconfig eth0 192.168.1.100 netmask 255.255.255.0 up # 打印欢迎信息 echo Welcome to My Custom ARM Linux on Allwinner V3s!然后在/path/to/your/rootfs/etc/下创建一个简单的inittab文件告诉init进程由BusyBox提供如何启动::sysinit:/etc/init.d/rcS ::askfirst:-/bin/sh ::restart:/sbin/init ::ctrlaltdel:/sbin/reboot ::shutdown:/bin/umount -a -r这个配置的意思是系统启动时执行/etc/init.d/rcS然后启动一个登录shellaskfirst定义重启和关机的动作。5.3 制作SD卡启动盘我们需要将编译好的内核、设备树和根文件系统放到SD卡的正确位置。全志芯片通常支持从SD卡的特定分区启动。分区将SD卡插入读卡器并连接到电脑。假设SD卡设备是/dev/sdb操作前务必用lsblk命令确认误操作会格式化你的硬盘。sudo fdisk /dev/sdb在fdisk交互界面中输入o创建新的DOS分区表。输入n创建新分区分区类型选p(主分区)分区号1起始扇区默认大小例如64M用于存放内核和dtb。输入t然后选择分区1将分区类型改为c(W95 FAT32 (LBA))。输入n创建第二个分区类型p分区号2起始扇区默认大小分配剩余所有空间用于根文件系统。输入w写入并退出。格式化与拷贝# 格式化第一个分区为FAT32启动分区 sudo mkfs.vfat /dev/sdb1 # 格式化第二个分区为EXT4根文件系统分区 sudo mkfs.ext4 /dev/sdb2 # 挂载并拷贝文件 sudo mkdir -p /mnt/boot /mnt/rootfs sudo mount /dev/sdb1 /mnt/boot sudo mount /dev/sdb2 /mnt/rootfs # 拷贝内核和设备树到启动分区 sudo cp /path/to/your/sd_card_boot/zImage /mnt/boot/ sudo cp /path/to/your/sd_card_boot/sun8i-v3s-licheepi-zero.dtb /mnt/boot/ # 拷贝根文件系统 sudo cp -a /path/to/your/rootfs/* /mnt/rootfs/ # 卸载 sudo umount /mnt/boot sudo umount /mnt/rootfs sync # 确保所有数据写入磁盘6. 上电启动、串口调试与问题排查激动人心的时刻到了将制作好的SD卡插入开发板连接串口调试工具如USB转TTL模块到电脑。串口连接通常有三根线TX板子接调试工具的RXRX板子接调试工具的TXGND对接。板子的供电口接上5V电源。在电脑上使用串口终端软件如minicom,picocom或Windows下的Putty、MobaXterm。设置正确的串口设备如/dev/ttyUSB0、波特率全志平台通常是115200、数据位8、停止位1、无校验、无流控。给开发板上电在串口终端里你应该能看到如瀑布般的内核启动信息。如果一切顺利最后会出现类似/ #的BusyBox shell提示符。恭喜你你的自定义内核成功启动了6.1 启动失败常见问题与排查技巧然而现实往往更骨感。以下是几种常见的启动失败现象及排查思路串口无任何输出一片空白检查硬件连接确认串口线是否接反TX/RX交叉地线是否接好供电是否正常。检查串口终端设置波特率115200是否正确串口设备号是否正确有时需要sudo权限或用户加入dialout组检查内核配置确认CONFIG_EARLY_PRINTK和正确的UART驱动已启用并编译进内核。对于全志V3s其调试串口通常是UART0。检查SD卡和启动介质SD卡是否接触不良是否烧录了正确的引导程序如U-Boot对于全志很多芯片SD卡启动需要有一个特殊的“启动头”但如果我们使用U-Boot SPLSecondary Program Loader或者某些板子的ROM代码可以直接加载FAT分区里的zImage和dtb。最稳妥的方式是参考你具体开发板的官方或社区Wiki使用他们推荐的烧录工具如sunxi-tools包里的sunxi-fel或dd命令来制作完整的启动SD卡镜像其中包含了必要的引导代码。内核启动到一半卡住例如卡在“Starting kernel ...”之后查看卡住前的最后几条信息这是最重要的线索。可能的原因有设备树不匹配.dtb文件与你的实际硬件不匹配。确认你编译和使用的dtb文件是否对应你的确切板型。一个V3s的dtb可能不适用于另一个不同外设设计的V3s板子。内存配置错误内核或设备树中定义的内存大小、地址与硬件不符。检查设备树源文件.dts中的memory节点。驱动初始化失败某个关键驱动如时钟、MMC初始化失败。尝试在menuconfig中简化配置去掉非必要的驱动或者将可疑驱动的日志级别调高CONFIG_DYNAMIC_DEBUG或驱动本身的debug选项。内核恐慌Kernel Panic错误信息通常会明确指出原因例如“Unable to mount root fs”: 内核找不到根文件系统。检查内核命令行参数bootargs是否正确传递了root信息例如root/dev/mmcblk0p2 rootwait。检查根文件系统分区格式是否与内核配置支持的文件系统如EXT4一致。检查根文件系统目录是否完整特别是/init或/linuxrc是否存在且可执行。“VFS: Cannot open root device”: 类似上述问题根设备指定错误或驱动未加载。确保MMC/SD卡驱动已编译进内核。成功进入shell但网络/USB等外设不工作这通常是驱动未启用或配置不正确。首先用lsmod查看已加载的模块用ifconfig -a查看网络接口。如果接口不存在说明网络驱动未加载。你需要返回内核配置确保对应驱动已编译Y或M。如果是模块M你还需要在根文件系统中包含这个模块文件位于/lib/modules/下并在启动脚本中insmod加载它。6.2 进阶配置内核启动参数与使用U-Boot更常见的启动流程是芯片ROM代码 - U-Boot SPL - U-Boot - Linux Kernel。U-Boot是一个功能强大的引导加载程序它可以灵活地设置内核启动参数。在U-Boot命令行中你可以设置bootargs环境变量来传递参数给内核setenv bootargs consolettyS0,115200 root/dev/mmcblk0p2 rootwait panic10 saveenv bootconsolettyS0,115200: 指定控制台为串口0波特率115200。root/dev/mmcblk0p2: 指定根文件系统在SD卡的第二个分区。rootwait: 等待根设备就绪。panic10: 内核发生panic后10秒重启。你也可以让U-Boot直接从SD卡加载内核和设备树并启动fatload mmc 0:1 0x41000000 zImage fatload mmc 0:1 0x41800000 sun8i-v3s-licheepi-zero.dtb bootz 0x41000000 - 0x41800000这种方式更加灵活便于调试不同的内核和参数。整个从零编译并启动全志ARM Linux内核的过程就像在组装一个精密的数字时钟。你需要正确的零件源码、工具链、按照图纸配置进行组装编译、提供动力根文件系统、最后校准调试才能让它准确运行。这个过程充满挑战但每一步的成功都会带来巨大的成就感并且让你对嵌入式Linux系统的理解深入到骨髓。当你第一次看到自己编译的内核在屏幕上打印出启动日志并最终弹出那个熟悉的#提示符时你会觉得所有的折腾都是值得的。这不仅仅是启动了一个系统更是为你打开了一扇通往嵌入式世界深处的大门。
全志ARM Linux内核编译指南：从交叉编译到SD卡启动全流程
1. 项目概述为什么我们要亲手编译ARM Linux内核如果你手头有一块全志方案的开发板比如Orange Pi Zero 2或者NanoPi想在上面跑点自己的程序或者想深入理解嵌入式系统是怎么从一堆代码变成能点亮屏幕、连接网络的智能设备那么“从零开始编译并启动ARM Linux内核”就是你绕不开的一步。这不仅仅是把官方提供的现成镜像烧录到SD卡那么简单而是一个从源码到二进制从裸机到操作系统的完整构建过程。我之所以花时间折腾这个是因为现成的镜像往往只包含了最通用的驱动和配置当你需要启用某个特定的硬件功能、裁剪掉不需要的模块以节省资源或者单纯想学习内核的启动流程时自己动手编译就成了唯一的选择。全志的芯片比如常见的V3s、F1C100s、T527等在开源硬件和创客圈子里非常流行其对应的Linux内核源码在社区维护得也相当不错。这个过程能让你彻底搞清楚一个为特定ARM架构比如ARMv7或ARMv8定制的Linux内核是如何被交叉编译工具链“翻译”出来的内核镜像、设备树Device Tree和根文件系统这三者之间是什么关系以及最终我们如何让这块小小的开发板按照我们的意愿启动起来。对于嵌入式Linux驱动开发者来说这更是基本功因为驱动代码最终是要编译进内核或者以模块形式加载的。接下来我就以手头一块全志V3s的开发板为例带你走一遍这个充满细节的旅程。2. 开发环境搭建与工具链选型工欲善其事必先利其器。编译Linux内核需要一个高效、可靠的交叉编译环境。所谓“交叉编译”就是在我们常用的x86_64架构的电脑宿主机上生成能在ARM架构开发板目标机上运行的代码。2.1 交叉编译工具链的选择与安装市面上工具链很多比如Linaro、ARM官方提供的gcc-arm-none-eabi以及各大芯片厂商自己定制的工具链。对于全志平台我强烈推荐使用社区验证过的、与内核版本匹配的工具链。这里我选择gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf。选择7.5.0版本是因为它和较新的内核兼容性好同时稳定性经过考验。“gnueabihf”中的“hf”代表硬浮点Hard Float能利用ARM芯片的浮点运算单元提升性能。在Ubuntu 20.04宿主机上安装步骤如下# 1. 下载工具链假设放在/home/username/目录下 wget https://releases.linaro.org/components/toolchain/binaries/7.5-2019.12/arm-linux-gnueabihf/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz # 2. 解压 tar -xvf gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz # 3. 将工具链路径加入系统环境变量方便调用 echo export PATH$PATH:/home/username/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin ~/.bashrc source ~/.bashrc # 4. 验证安装 arm-linux-gnueabihf-gcc --version如果终端能正确输出gcc的版本信息说明工具链安装成功。这里有个关键细节一定要将工具链的bin目录路径添加到PATH环境变量中否则后续编译时会找不到arm-linux-gnueabihf-为前缀的命令如gcc, ld等。2.2 获取Linux内核源码与全志平台支持全志芯片的内核源码主要维护在几个地方一是全志官方为某些芯片提供的SDK通常比较庞大二是Linux内核主线Mainline社区开发者会逐步将全志芯片的驱动并入主线三是诸如linux-sunxi现为sunxi-linux这样的社区维护分支它对全志Allwinner系列芯片的支持非常活跃和及时。对于初学者或追求稳定性的开发者我建议从社区分支开始。这里我们使用sunxi-linux的某个稳定分支。以linux-5.10.y分支为例这个版本长期支持驱动相对完善。# 克隆sunxi-linux仓库并切换到特定分支 git clone https://github.com/sunxi-linux/linux -b sunxi-5.10 cd linux注意内核源码体积较大下载需要一定时间。确保你的宿主机磁盘空间充足建议预留15GB以上。克隆完成后你可以通过git branch -a查看所有远程分支选择适合你芯片的版本。例如对于较新的T527芯片可能需要更新版本的分支。2.3 宿主机基础依赖包安装编译内核需要宿主机安装一些必要的开发工具和库。在Ubuntu/Debian系统上可以一次性安装sudo apt-get update sudo apt-get install -y build-essential libncurses5-dev libssl-dev bc flex bison libelf-devbuild-essential: 包含gcc, make等基础编译工具。libncurses5-dev: 用于支持make menuconfig图形化配置界面。libssl-dev和bc: 内核编译过程中某些功能如模块签名需要。flex和bison: 语法分析器生成工具编译某些内核组件时需要。libelf-dev: 处理ELF格式文件所需的库。安装这些依赖可以避免后续编译时出现令人头疼的“找不到xxx.h文件”或“命令未找到”的错误。3. 内核配置与裁剪为你的板子量身定做拿到内核源码后直接编译是不行的我们必须告诉编译系统我们要为哪种架构的哪种芯片启用哪些功能。这就是内核配置。3.1 导入默认配置与图形化配置全志社区通常为热门开发板提供了默认配置文件defconfig。以Orange Pi Zero使用全志H2芯片为例其配置可能是sun8i-h3-defconfig。对于V3s社区常用sun8i-v3s-licheepi-zero-defconfig针对Lichee Pi Zero开发板核心是V3s。# 在linux源码根目录下执行 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- sun8i-v3s-licheepi-zero-defconfig这条命令做了几件事ARCHarm指定目标架构为ARMCROSS_COMPILE指定交叉编译工具链前缀最后是defconfig的名称。执行后会在源码根目录生成一个.config文件这是内核编译的“总蓝图”。但默认配置可能包含了你不需要的驱动也可能缺少你需要的功能。我们需要进行微调make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- menuconfig这会启动一个基于ncurses的文本图形界面。在这里你可以像逛菜单一样浏览和修改成千上万个配置选项。3.2 关键配置项解析与实操心得面对海量选项新手容易懵。我建议重点关注以下几类它们直接影响内核能否在你的板子上正常启动和工作系统类型System Type:确保在ARM system type下选择了正确的CPU系列如Allwinner A1x SoCs或Allwinner sun8i Family。对于V3s它属于sun8i家族。在Allwinner SoC Support子菜单中务必选中你的具体SoC型号例如Allwinner V3s。这确保了最基础的芯片支持被编译进去。设备树支持Device Tree:确保CONFIG_OFFlattened Device Tree support是开启的。现代ARM Linux几乎都使用设备树来描述硬件。在Allwinner SoC Support下找到你的开发板对应的设备树源文件.dts编译选项并启用。例如对于Lichee Pi Zero需要找到CONFIG_MACH_SUN8I_V3S_LICHEEPI_ZERO并设为y编译进内核。驱动配置:串口驱动这是你最重要的调试窗口确保CONFIG_SERIAL_8250和CONFIG_SERIAL_8250_CONSOLE启用。并在其子选项中找到对应全志平台的UART驱动如Allwinner A10 UART。SD/MMC驱动你的根文件系统很可能在SD卡上。确保CONFIG_MMC、CONFIG_MMC_SUNXI启用。网络驱动如果你的板子有网络有线或无线找到对应的驱动。例如V3s的EMAC网络控制器对应CONFIG_SUN8I_EMAC。USB驱动如果需要连接USB设备确保对应的Host控制器驱动如CONFIG_USB_OHCI_HCD,CONFIG_USB_EHCI_HCD已启用。文件系统支持你的根文件系统是什么格式如果是EXT4确保CONFIG_EXT4_FSy。如果是SquashFS常用于只读系统则启用CONFIG_SQUASHFS。如果使用initramfs初始内存文件系统作为临时根文件系统来引导需要在General setup-Initial RAM filesystem and RAM disk (initramfs/initrd) support中配置。内核调试与打印初期调试内核的打印信息至关重要。确保CONFIG_PRINTK、CONFIG_EARLY_PRINTK是开启的。EARLY_PRINTK能在内核非常早期的阶段就通过串口输出信息对于排查启动卡死的问题帮助巨大。实操心得第一次配置时可以在默认defconfig的基础上只修改你明确知道需要改动的选项。对于不确定的选项保持默认通常默认值是最安全或最通用的选择。配置完成后记得保存。菜单界面底部有操作提示按Y编译进内核M编译为模块N不编译。模块的好处是可以减小内核体积在需要时动态加载但启动时需要额外的initramfs来加载模块对初学者稍复杂。建议初期将核心驱动直接编译进内核Y简化启动流程。4. 内核编译与产物生成配置完成后就可以开始编译了。这个过程比较耗时取决于你电脑的CPU核心数和内核配置的复杂程度。4.1 启动编译与参数优化使用-j参数指定并行编译任务数可以大幅缩短编译时间。通常设为你的CPU核心数1或2。make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- -j$(nproc)$(nproc)命令会自动获取你系统的CPU核心数。编译过程中终端会滚动输出大量的编译信息。如果没有出现error只有warning通常可以忽略编译会继续进行。编译最终会生成几个核心文件arch/arm/boot/zImage: 压缩的内核镜像文件。这是最主要的启动内核。arch/arm/boot/dts/板子名称.dtb: 设备树二进制文件Device Tree Blob。它由我们之前配置时选择的.dts文件编译而来包含了板级的硬件描述信息比如内存地址、外设寄存器、中断号等。对于V3s Lichee Pi Zero这个文件可能是sun8i-v3s-licheepi-zero.dtb。如果配置了模块模块文件会分散在lib/modules/内核版本/kernel/目录下。4.2 常见编译错误排查即使按照步骤来也可能遇到编译错误。这里记录几个我踩过的坑“recipe for target ‘xxx’ failed”这通常是缺少某个依赖包。仔细看错误信息的上方通常会提示缺少某个.h头文件或某个命令。根据提示安装对应的开发包即可。例如如果提示openssl/xxx.h找不到那就安装libssl-dev。工具链版本不兼容如果你使用了太新或太旧的工具链可能会遇到奇怪的语法错误或链接错误。错误信息可能包含“unrecognized command line option”或“undefined reference”。解决方案是换用社区推荐的工具链版本确保与内核版本匹配。配置冲突有时手动修改.config文件不当会导致选项依赖关系出错。一个干净的解决方法是备份你的自定义配置可以用make savedefconfig生成精简的defconfig文件然后make mrproper彻底清理源码树再重新导入defconfig并进入menuconfig修改。编译成功后建议将zImage和对应的.dtb文件复制到一个单独的目录方便后续打包。cp arch/arm/boot/zImage /path/to/your/sd_card_boot/ cp arch/arm/boot/dts/sun8i-v3s-licheepi-zero.dtb /path/to/your/sd_card_boot/5. 构建根文件系统与启动介质准备只有内核是启动不了一个完整系统的我们还需要根文件系统rootfs。根文件系统包含了操作系统运行所必需的所有目录结构、系统工具如ls,mount、库文件、配置文件如/etc/fstab,/etc/inittab等。5.1 使用BusyBox构建最小根文件系统对于嵌入式环境BusyBox是一个瑞士军刀式的工具集它把许多常用的Unix工具如sh,echo,mount,ifconfig集成进一个单一的可执行文件通过创建符号链接来提供各种命令极大地节省了空间。构建步骤# 1. 下载并解压BusyBox源码以1.35.0稳定版为例 wget https://busybox.net/downloads/busybox-1.35.0.tar.bz2 tar -xvf busybox-1.35.0.tar.bz2 cd busybox-1.35.0 # 2. 配置BusyBox同样使用交叉编译 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- defconfig # 使用默认配置 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- menuconfig # 可选进行定制在menuconfig中一个重要的设置是进入Settings-Build Options选中Build static binary (no shared libs)。这将BusyBox编译成静态链接运行时不需要额外的动态库简化了根文件系统的制作但体积会稍大。对于新手静态编译更省心。# 3. 编译并安装到指定目录 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- -j$(nproc) make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- install CONFIG_PREFIX/path/to/your/rootfs安装后在/path/to/your/rootfs目录下你会看到bin,sbin,usr等目录以及linuxrc文件。5.2 完善根文件系统目录与关键文件BusyBox只提供了基础命令一个可用的根文件系统还需要更多目录和关键配置文件。cd /path/to/your/rootfs mkdir -p dev proc sys tmp run etc/init.ddev: 设备文件目录内核启动后会在这里创建设备节点如console,ttyS0。proc和sys: 虚拟文件系统内核通过它们向用户空间暴露系统信息和控制接口。tmp: 临时文件目录。etc/init.d: 初始化脚本目录。接下来创建最关键的初始化文件。在/path/to/your/rootfs/etc/init.d/下创建一个名为rcS的脚本注意赋予可执行权限chmod x rcS#!/bin/sh # rcS - 系统启动初始化脚本 # 挂载虚拟文件系统 mount -t proc none /proc mount -t sysfs none /sys mount -t tmpfs none /tmp # 设置主机名 hostname MyAllwinnerBoard # 挂载/dev为tmpfs允许内核动态创建设备节点 mount -t tmpfs none /dev # 创建设备节点 mknod /dev/console c 5 1 mknod /dev/null c 1 3 mknod /dev/zero c 1 5 # 设置网络如果需要这里可以调用ifconfig配置IP # /sbin/ifconfig lo 127.0.0.1 up # /sbin/ifconfig eth0 192.168.1.100 netmask 255.255.255.0 up # 打印欢迎信息 echo Welcome to My Custom ARM Linux on Allwinner V3s!然后在/path/to/your/rootfs/etc/下创建一个简单的inittab文件告诉init进程由BusyBox提供如何启动::sysinit:/etc/init.d/rcS ::askfirst:-/bin/sh ::restart:/sbin/init ::ctrlaltdel:/sbin/reboot ::shutdown:/bin/umount -a -r这个配置的意思是系统启动时执行/etc/init.d/rcS然后启动一个登录shellaskfirst定义重启和关机的动作。5.3 制作SD卡启动盘我们需要将编译好的内核、设备树和根文件系统放到SD卡的正确位置。全志芯片通常支持从SD卡的特定分区启动。分区将SD卡插入读卡器并连接到电脑。假设SD卡设备是/dev/sdb操作前务必用lsblk命令确认误操作会格式化你的硬盘。sudo fdisk /dev/sdb在fdisk交互界面中输入o创建新的DOS分区表。输入n创建新分区分区类型选p(主分区)分区号1起始扇区默认大小例如64M用于存放内核和dtb。输入t然后选择分区1将分区类型改为c(W95 FAT32 (LBA))。输入n创建第二个分区类型p分区号2起始扇区默认大小分配剩余所有空间用于根文件系统。输入w写入并退出。格式化与拷贝# 格式化第一个分区为FAT32启动分区 sudo mkfs.vfat /dev/sdb1 # 格式化第二个分区为EXT4根文件系统分区 sudo mkfs.ext4 /dev/sdb2 # 挂载并拷贝文件 sudo mkdir -p /mnt/boot /mnt/rootfs sudo mount /dev/sdb1 /mnt/boot sudo mount /dev/sdb2 /mnt/rootfs # 拷贝内核和设备树到启动分区 sudo cp /path/to/your/sd_card_boot/zImage /mnt/boot/ sudo cp /path/to/your/sd_card_boot/sun8i-v3s-licheepi-zero.dtb /mnt/boot/ # 拷贝根文件系统 sudo cp -a /path/to/your/rootfs/* /mnt/rootfs/ # 卸载 sudo umount /mnt/boot sudo umount /mnt/rootfs sync # 确保所有数据写入磁盘6. 上电启动、串口调试与问题排查激动人心的时刻到了将制作好的SD卡插入开发板连接串口调试工具如USB转TTL模块到电脑。串口连接通常有三根线TX板子接调试工具的RXRX板子接调试工具的TXGND对接。板子的供电口接上5V电源。在电脑上使用串口终端软件如minicom,picocom或Windows下的Putty、MobaXterm。设置正确的串口设备如/dev/ttyUSB0、波特率全志平台通常是115200、数据位8、停止位1、无校验、无流控。给开发板上电在串口终端里你应该能看到如瀑布般的内核启动信息。如果一切顺利最后会出现类似/ #的BusyBox shell提示符。恭喜你你的自定义内核成功启动了6.1 启动失败常见问题与排查技巧然而现实往往更骨感。以下是几种常见的启动失败现象及排查思路串口无任何输出一片空白检查硬件连接确认串口线是否接反TX/RX交叉地线是否接好供电是否正常。检查串口终端设置波特率115200是否正确串口设备号是否正确有时需要sudo权限或用户加入dialout组检查内核配置确认CONFIG_EARLY_PRINTK和正确的UART驱动已启用并编译进内核。对于全志V3s其调试串口通常是UART0。检查SD卡和启动介质SD卡是否接触不良是否烧录了正确的引导程序如U-Boot对于全志很多芯片SD卡启动需要有一个特殊的“启动头”但如果我们使用U-Boot SPLSecondary Program Loader或者某些板子的ROM代码可以直接加载FAT分区里的zImage和dtb。最稳妥的方式是参考你具体开发板的官方或社区Wiki使用他们推荐的烧录工具如sunxi-tools包里的sunxi-fel或dd命令来制作完整的启动SD卡镜像其中包含了必要的引导代码。内核启动到一半卡住例如卡在“Starting kernel ...”之后查看卡住前的最后几条信息这是最重要的线索。可能的原因有设备树不匹配.dtb文件与你的实际硬件不匹配。确认你编译和使用的dtb文件是否对应你的确切板型。一个V3s的dtb可能不适用于另一个不同外设设计的V3s板子。内存配置错误内核或设备树中定义的内存大小、地址与硬件不符。检查设备树源文件.dts中的memory节点。驱动初始化失败某个关键驱动如时钟、MMC初始化失败。尝试在menuconfig中简化配置去掉非必要的驱动或者将可疑驱动的日志级别调高CONFIG_DYNAMIC_DEBUG或驱动本身的debug选项。内核恐慌Kernel Panic错误信息通常会明确指出原因例如“Unable to mount root fs”: 内核找不到根文件系统。检查内核命令行参数bootargs是否正确传递了root信息例如root/dev/mmcblk0p2 rootwait。检查根文件系统分区格式是否与内核配置支持的文件系统如EXT4一致。检查根文件系统目录是否完整特别是/init或/linuxrc是否存在且可执行。“VFS: Cannot open root device”: 类似上述问题根设备指定错误或驱动未加载。确保MMC/SD卡驱动已编译进内核。成功进入shell但网络/USB等外设不工作这通常是驱动未启用或配置不正确。首先用lsmod查看已加载的模块用ifconfig -a查看网络接口。如果接口不存在说明网络驱动未加载。你需要返回内核配置确保对应驱动已编译Y或M。如果是模块M你还需要在根文件系统中包含这个模块文件位于/lib/modules/下并在启动脚本中insmod加载它。6.2 进阶配置内核启动参数与使用U-Boot更常见的启动流程是芯片ROM代码 - U-Boot SPL - U-Boot - Linux Kernel。U-Boot是一个功能强大的引导加载程序它可以灵活地设置内核启动参数。在U-Boot命令行中你可以设置bootargs环境变量来传递参数给内核setenv bootargs consolettyS0,115200 root/dev/mmcblk0p2 rootwait panic10 saveenv bootconsolettyS0,115200: 指定控制台为串口0波特率115200。root/dev/mmcblk0p2: 指定根文件系统在SD卡的第二个分区。rootwait: 等待根设备就绪。panic10: 内核发生panic后10秒重启。你也可以让U-Boot直接从SD卡加载内核和设备树并启动fatload mmc 0:1 0x41000000 zImage fatload mmc 0:1 0x41800000 sun8i-v3s-licheepi-zero.dtb bootz 0x41000000 - 0x41800000这种方式更加灵活便于调试不同的内核和参数。整个从零编译并启动全志ARM Linux内核的过程就像在组装一个精密的数字时钟。你需要正确的零件源码、工具链、按照图纸配置进行组装编译、提供动力根文件系统、最后校准调试才能让它准确运行。这个过程充满挑战但每一步的成功都会带来巨大的成就感并且让你对嵌入式Linux系统的理解深入到骨髓。当你第一次看到自己编译的内核在屏幕上打印出启动日志并最终弹出那个熟悉的#提示符时你会觉得所有的折腾都是值得的。这不仅仅是启动了一个系统更是为你打开了一扇通往嵌入式世界深处的大门。
