1. 香橙派Zero 3开发板简介与准备工作香橙派Zero 3是一款基于全志H618处理器的开源硬件开发板主打高性能和低功耗特性。这块板子虽然体积小巧但配置相当给力四核Cortex-A53架构、1.5GHz主频还支持4K视频解码特别适合用来做嵌入式开发和物联网项目。我第一次拿到这块板子时就被它丰富的接口吸引了——千兆网口、USB Type-C、40针GPIO接口一应俱全完全能满足各种开发需求。在开始构建Linux内核和根文件系统之前我们需要准备好开发环境。我强烈建议使用Ubuntu 20.04或22.04作为开发主机系统因为大多数嵌入式开发工具链对这两个版本的支持最完善。你需要安装的基础软件包包括build-essential基础编译工具git版本控制bison/flex语法分析工具libncurses-devmenuconfig界面依赖准备工具链是最关键的一步。我实测发现Linaro的aarch64-linux-gnu工具链兼容性最好可以直接用apt安装sudo apt install gcc-aarch64-linux-gnu装好后记得验证下工具链是否可用aarch64-linux-gnu-gcc --version2. 主线Linux内核编译与适配2.1 获取与配置内核源码香橙派Zero 3的主线内核支持已经相当完善我们可以直接从kernel.org获取最新稳定版。我推荐使用6.1以上的内核版本因为对H618芯片组的支持更全面wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.6.tar.xz tar xvf linux-6.6.tar.xz cd linux-6.6配置阶段有个小技巧先使用全志H616的默认配置作为基础虽然Zero 3是H618但两者兼容性很好make ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- defconfig然后通过menuconfig进行针对性调整make ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- menuconfig在配置界面中这几个选项需要特别注意Device Drivers Graphics support下启用Mali GPU驱动Device Drivers Network device support启用千兆网卡驱动Boot options中配置默认命令行参数2.2 内核编译与设备树处理编译命令很简单但有几个实用参数可以加速编译过程make ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- -j$(nproc) Image modules dtbs编译完成后关键文件位于arch/arm64/boot/Image- 内核镜像arch/arm64/boot/dts/allwinner/sun50i-h618-orangepi-zero3.dtb- 设备树文件我遇到过的一个典型问题是WiFi模块驱动缺失解决方法是在内核配置中手动启用Device Drivers Network device support Wireless LAN Realtek 8723CS SDIO WiFi3. Buildroot构建轻量级根文件系统3.1 Buildroot基础配置Buildroot是我最推荐的根文件系统构建工具它的优势在于高度定制化和轻量化。首先获取最新版本wget https://buildroot.org/downloads/buildroot-2023.02.tar.xz tar xvf buildroot-2023.02.tar.xz cd buildroot-2023.02香橙派Zero 3已经有现成的配置文件可以直接加载make orangepi_zero3_defconfig然后进入配置界面进行个性化调整make menuconfig几个关键配置项Toolchain选择外部工具链前面安装的aarch64-linux-gnuSystem configuration设置root密码和主机名Filesystem images启用tar格式输出3.2 软件包定制与优化Buildroot的强大之处在于可以精确控制包含哪些软件包。我通常会添加这些实用组件dropbear轻量级SSH服务器busybox基础命令工具集e2fsprogs文件系统工具ifupdown网络配置工具一个实用技巧是启用ccache加速后续编译make menuconfig然后在Build options中启用ccache支持。编译命令很简单make -j$(nproc)编译完成后根文件系统位于output/images/rootfs.tar大小通常在20MB左右非常精简。4. Ubuntu-base根文件系统移植4.1 基础系统部署如果你需要更完整的桌面环境或软件生态Ubuntu-base是个不错的选择。首先获取最小化镜像wget http://cdimage.ubuntu.com/ubuntu-base/releases/22.04/release/ubuntu-base-22.04-base-arm64.tar.gz准备一个ext4格式的分区假设是/dev/sdb2挂载并解压sudo mkfs.ext4 /dev/sdb2 sudo mount /dev/sdb2 /mnt sudo tar xzvf ubuntu-base-22.04-base-arm64.tar.gz -C /mnt4.2 系统配置与软件安装需要配置的几个关键文件/etc/apt/sources.list- 替换为国内镜像源加速下载/etc/resolv.conf- 配置DNS解析/etc/fstab- 设置自动挂载使用chroot进入系统环境进行配置sudo mount --bind /dev /mnt/dev sudo mount --bind /proc /mnt/proc sudo mount --bind /sys /mnt/sys sudo chroot /mnt在chroot环境中安装基础软件包apt update apt install sudo ssh net-tools wireless-tools5. 系统烧录与启动调试5.1 TF卡分区方案推荐使用GPT分区表布局如下16MB - FAT32格式存放uboot和内核512MB - swap交换分区可选剩余空间 - ext4根文件系统可以使用fdisk进行分区sudo fdisk /dev/sdX # 依次输入 gGPT分区表、n新建分区、t更改类型、w保存5.2 烧录与启动配置烧录uboot到TF卡起始位置sudo dd ifu-boot-sunxi-with-spl.bin of/dev/sdX bs1k seek8拷贝内核和设备树到第一分区sudo cp Image /mnt/boot/ sudo cp sun50i-h618-orangepi-zero3.dtb /mnt/boot/最后配置uboot环境变量setenv bootargs consolettyS0,115200 root/dev/mmcblk0p3 rootwait rw setenv bootcmd fatload mmc 0:1 0x40200000 Image; fatload mmc 0:1 0x4fa00000 sun50i-h618-orangepi-zero3.dtb; booti 0x40200000 - 0x4fa00000 saveenv6. 常见问题排查在实际操作中有几个高频出现的坑需要特别注意内核启动卡住这种情况八成是设备树不匹配导致的。检查串口输出如果卡在Starting kernel...尝试重新编译设备树或者检查板子型号是否选择正确。根文件系统挂载失败确认bootargs中的root参数是否正确指向TF卡的分区号。我遇到过多次把mmcblk0p2写成mmcblk0p3导致启动失败的情况。网络无法连接如果是Buildroot系统需要确认是否包含了正确的网络驱动和工具。一个快速检查方法是看/dev下是否有对应的网络设备节点。USB设备不识别主线内核对某些USB设备的支持可能需要额外配置。在内核配置中确保选中了对应的USB控制器驱动和HID驱动。
香橙派Zero 3主线Linux内核与根文件系统构建实战
发布时间：2026/5/20 0:43:15
1. 香橙派Zero 3开发板简介与准备工作香橙派Zero 3是一款基于全志H618处理器的开源硬件开发板主打高性能和低功耗特性。这块板子虽然体积小巧但配置相当给力四核Cortex-A53架构、1.5GHz主频还支持4K视频解码特别适合用来做嵌入式开发和物联网项目。我第一次拿到这块板子时就被它丰富的接口吸引了——千兆网口、USB Type-C、40针GPIO接口一应俱全完全能满足各种开发需求。在开始构建Linux内核和根文件系统之前我们需要准备好开发环境。我强烈建议使用Ubuntu 20.04或22.04作为开发主机系统因为大多数嵌入式开发工具链对这两个版本的支持最完善。你需要安装的基础软件包包括build-essential基础编译工具git版本控制bison/flex语法分析工具libncurses-devmenuconfig界面依赖准备工具链是最关键的一步。我实测发现Linaro的aarch64-linux-gnu工具链兼容性最好可以直接用apt安装sudo apt install gcc-aarch64-linux-gnu装好后记得验证下工具链是否可用aarch64-linux-gnu-gcc --version2. 主线Linux内核编译与适配2.1 获取与配置内核源码香橙派Zero 3的主线内核支持已经相当完善我们可以直接从kernel.org获取最新稳定版。我推荐使用6.1以上的内核版本因为对H618芯片组的支持更全面wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.6.tar.xz tar xvf linux-6.6.tar.xz cd linux-6.6配置阶段有个小技巧先使用全志H616的默认配置作为基础虽然Zero 3是H618但两者兼容性很好make ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- defconfig然后通过menuconfig进行针对性调整make ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- menuconfig在配置界面中这几个选项需要特别注意Device Drivers Graphics support下启用Mali GPU驱动Device Drivers Network device support启用千兆网卡驱动Boot options中配置默认命令行参数2.2 内核编译与设备树处理编译命令很简单但有几个实用参数可以加速编译过程make ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- -j$(nproc) Image modules dtbs编译完成后关键文件位于arch/arm64/boot/Image- 内核镜像arch/arm64/boot/dts/allwinner/sun50i-h618-orangepi-zero3.dtb- 设备树文件我遇到过的一个典型问题是WiFi模块驱动缺失解决方法是在内核配置中手动启用Device Drivers Network device support Wireless LAN Realtek 8723CS SDIO WiFi3. Buildroot构建轻量级根文件系统3.1 Buildroot基础配置Buildroot是我最推荐的根文件系统构建工具它的优势在于高度定制化和轻量化。首先获取最新版本wget https://buildroot.org/downloads/buildroot-2023.02.tar.xz tar xvf buildroot-2023.02.tar.xz cd buildroot-2023.02香橙派Zero 3已经有现成的配置文件可以直接加载make orangepi_zero3_defconfig然后进入配置界面进行个性化调整make menuconfig几个关键配置项Toolchain选择外部工具链前面安装的aarch64-linux-gnuSystem configuration设置root密码和主机名Filesystem images启用tar格式输出3.2 软件包定制与优化Buildroot的强大之处在于可以精确控制包含哪些软件包。我通常会添加这些实用组件dropbear轻量级SSH服务器busybox基础命令工具集e2fsprogs文件系统工具ifupdown网络配置工具一个实用技巧是启用ccache加速后续编译make menuconfig然后在Build options中启用ccache支持。编译命令很简单make -j$(nproc)编译完成后根文件系统位于output/images/rootfs.tar大小通常在20MB左右非常精简。4. Ubuntu-base根文件系统移植4.1 基础系统部署如果你需要更完整的桌面环境或软件生态Ubuntu-base是个不错的选择。首先获取最小化镜像wget http://cdimage.ubuntu.com/ubuntu-base/releases/22.04/release/ubuntu-base-22.04-base-arm64.tar.gz准备一个ext4格式的分区假设是/dev/sdb2挂载并解压sudo mkfs.ext4 /dev/sdb2 sudo mount /dev/sdb2 /mnt sudo tar xzvf ubuntu-base-22.04-base-arm64.tar.gz -C /mnt4.2 系统配置与软件安装需要配置的几个关键文件/etc/apt/sources.list- 替换为国内镜像源加速下载/etc/resolv.conf- 配置DNS解析/etc/fstab- 设置自动挂载使用chroot进入系统环境进行配置sudo mount --bind /dev /mnt/dev sudo mount --bind /proc /mnt/proc sudo mount --bind /sys /mnt/sys sudo chroot /mnt在chroot环境中安装基础软件包apt update apt install sudo ssh net-tools wireless-tools5. 系统烧录与启动调试5.1 TF卡分区方案推荐使用GPT分区表布局如下16MB - FAT32格式存放uboot和内核512MB - swap交换分区可选剩余空间 - ext4根文件系统可以使用fdisk进行分区sudo fdisk /dev/sdX # 依次输入 gGPT分区表、n新建分区、t更改类型、w保存5.2 烧录与启动配置烧录uboot到TF卡起始位置sudo dd ifu-boot-sunxi-with-spl.bin of/dev/sdX bs1k seek8拷贝内核和设备树到第一分区sudo cp Image /mnt/boot/ sudo cp sun50i-h618-orangepi-zero3.dtb /mnt/boot/最后配置uboot环境变量setenv bootargs consolettyS0,115200 root/dev/mmcblk0p3 rootwait rw setenv bootcmd fatload mmc 0:1 0x40200000 Image; fatload mmc 0:1 0x4fa00000 sun50i-h618-orangepi-zero3.dtb; booti 0x40200000 - 0x4fa00000 saveenv6. 常见问题排查在实际操作中有几个高频出现的坑需要特别注意内核启动卡住这种情况八成是设备树不匹配导致的。检查串口输出如果卡在Starting kernel...尝试重新编译设备树或者检查板子型号是否选择正确。根文件系统挂载失败确认bootargs中的root参数是否正确指向TF卡的分区号。我遇到过多次把mmcblk0p2写成mmcblk0p3导致启动失败的情况。网络无法连接如果是Buildroot系统需要确认是否包含了正确的网络驱动和工具。一个快速检查方法是看/dev下是否有对应的网络设备节点。USB设备不识别主线内核对某些USB设备的支持可能需要额外配置。在内核配置中确保选中了对应的USB控制器驱动和HID驱动。
