从零构建Firefly-RK3399的Ubuntu系统：镜像定制、内核编译与固件打包全流程

1. 为什么需要从零构建Firefly-RK3399的Ubuntu系统第一次拿到Firefly-RK3399开发板时我也像大多数人一样直接刷写官方镜像。但很快就遇到瓶颈——预装系统缺少我需要的开发工具内核版本不支持某些硬件特性甚至系统分区方案都不符合项目需求。这就是为什么我们需要掌握从零构建系统的能力。定制化Ubuntu系统能带来三个核心优势首先是硬件适配优化你可以针对RK3399的六核CPU和Mali-T860 GPU进行内核参数调优其次是软件生态自由从基础库版本到桌面环境都能按需选择最重要的是开发流程可控当需要移植到OpenEuler等其他系统时你已经掌握了完整的构建链条。这个教程会带你走通全流程从最基础的Ubuntu-core文件系统开始到内核编译时的每一个make配置选项最后打包成可直接烧写的完整固件。我还会分享几个关键环节的避坑经验比如处理aarch64架构的交叉编译问题时如何避免常见的库依赖冲突。2. 准备构建环境与基础材料2.1 搭建交叉编译环境在x86主机上构建ARM64系统需要配置交叉编译工具链。推荐使用Linaro官方提供的gcc-linaro-7.5.0工具链wget https://releases.linaro.org/components/toolchain/binaries/7.5-2019.12/aarch64-linux-gnu/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz sudo tar -xvf gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz -C /opt接着安装必要的构建工具sudo apt-get install build-essential bc libncurses5-dev libssl-dev \ flex bison libelf-dev device-tree-compiler验证工具链是否生效export CROSS_COMPILE/opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu- ${CROSS_COMPILE}gcc --version2.2 获取基础组件需要准备三个核心材料Ubuntu-base根文件系统从官网下载最小化系统wget http://cdimage.ubuntu.com/ubuntu-base/releases/16.04/release/ubuntu-base-16.04.6-base-arm64.tar.gzLinux内核源码使用Firefly官方维护的kernel分支git clone -b firefly-stable https://gitlab.com/TeeFirefly/linux-kernel.gitBootloader组件包括U-Boot和Trust固件git clone https://gitlab.com/TeeFirefly/u-boot.git git clone https://gitlab.com/TeeFirefly/arm-trusted-firmware.git建议新建工作目录并分类存放~/firefly-build/ ├── ubuntu-base ├── linux-kernel └── bootloader3. 深度定制Ubuntu根文件系统3.1 基础系统解压与chroot环境创建虚拟文件系统并解压Ubuntu-basemkdir rootfs sudo tar -xpf ubuntu-base-16.04.6-base-arm64.tar.gz -C rootfs配置chroot环境需要处理三个关键点挂载必要的虚拟文件系统sudo mount -t proc /proc rootfs/proc sudo mount -t sysfs /sys rootfs/sys sudo mount -o bind /dev rootfs/dev复制QEMU静态程序用于指令集转换sudo cp /usr/bin/qemu-aarch64-static rootfs/usr/bin/配置网络和软件源sudo cp /etc/resolv.conf rootfs/etc/ echo deb http://ports.ubuntu.com/ubuntu-ports xenial main universe | sudo tee rootfs/etc/apt/sources.list3.2 系统个性化定制进入chroot环境进行深度定制sudo chroot rootfs /bin/bash基础软件安装示例apt update apt upgrade -y apt install -y vim git net-tools ssh创建新用户并配置sudo权限useradd -m -s /bin/bash firefly usermod -aG sudo firefly passwd firefly配置系统服务时需要注意必须保留systemd-sysv包以确保服务管理正常网络管理推荐使用network-managerapt install -y network-manager systemctl enable NetworkManager退出前清理临时文件apt clean rm -rf /var/lib/apt/lists/* exit4. 编译与优化Linux内核4.1 内核配置与设备树调整进入内核源码目录应用默认配置cd linux-kernel make ARCHarm64 firefly_linux_defconfig关键配置调整建议启用OverlayFS支持make ARCHarm64 menuconfig路径File systems - Overlay filesystem support优化CPU调度策略路径CPU Power - CPU Frequency scaling - Default governor (performance)增加GPU驱动支持路径Device Drivers - Graphics support - ARM Mali Midgard series support针对RK3399的设备树修改vim arch/arm64/boot/dts/rockchip/rk3399-firefly.dtsi常见调整包括修改HDMI输出分辨率配置GPIO引脚复用调整DDR频率参数4.2 内核编译与输出处理启动编译过程建议使用-j$(nproc)参数并行编译make ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- -j8编译完成后生成的关键文件arch/arm64/boot/Image内核镜像arch/arm64/boot/dts/rockchip/rk3399-firefly.dtb设备树二进制打包Rockchip专用格式tools/mkimage -n rk3399 -T rksd -d arch/arm64/boot/Image kernel.img5. 固件打包与烧写测试5.1 组件整合与参数配置创建固件打包目录结构firefly-image/ ├── boot/ │ ├── kernel.img │ └── resource.img ├── rootfs/ └── tools/ ├── afptool └── rkImageMaker准备分区描述文件parameter.txt示例FIRMWARE_VER: 1.0 MACHINE_MODEL: RK3399 MACHINE_ID: 007 MANUFACTURER: Firefly MAGIC: 0x5041524B ATAG: 0x00200800 MACHINE: 3399 CHECK_MASK: 0x80 PWR_HLD: 0,0,A,0,1 TYPE: GPT CMDLINE: mtdpartsrk29xxnand:0x000020000x00004000(uboot),0x000020000x00006000(trust),0x000020000x00008000(misc),0x000100000x0000a000(boot),0x000100000x0001a000(recovery),0x000100000x0002a000(backup),0x000400000x0003a000(cache),0x004000000x0007a000(userdata),0x000002000x0047a000(metadata),0x000000020x0047a200(baseparamer),0x000000020x0047a400(reserved),-0x0047a600(rootfs)5.2 使用rkflash.sh脚本打包Firefly官方提供了便捷的打包脚本./rkflash.sh -b firefly-rk3399 -i firefly-image/ -o output/关键参数说明-b指定板型配置-i输入镜像目录-o输出目录打包完成后会生成output/update.img完整固件output/MD5.txt校验文件5.3 烧写与验证进入Loader模式的操作要点使用Type-C线连接开发板与主机按住Recovery键不放短按Reset键保持Recovery键2秒后松开使用rkdeveloptool工具烧写sudo rkdeveloptool db rk3399_loader_v1.24.126.bin sudo rkdeveloptool wl 0x0 output/update.img sudo rkdeveloptool rd首次启动建议通过串口监控日志sudo picocom -b 1500000 /dev/ttyUSB0常见问题排查卡在U-Boot阶段检查parameter.txt分区表是否匹配内核panic确认设备树是否正确编译根文件系统挂载失败检查ext4文件系统完整性6. 高级定制技巧与优化建议6.1 系统裁剪与最小化使用debootstrap构建更精简的系统sudo debootstrap --archarm64 xenial minifs http://ports.ubuntu.com/ubuntu-ports关键裁剪策略删除不必要的locale文件find /usr/share/locale -maxdepth 1 ! -name en* -exec rm -rf {} \;清理文档和man手册rm -rf /usr/share/{doc,man}使用busybox替代部分工具apt install busybox-static ln -sf /bin/busybox /bin/ls6.2 性能优化配置内核启动参数优化示例consolettyFIQ0,1500000 earlyprintkuart8250-32bit,0xff1a0000 rootwait root/dev/mmcblk1p8 rw init/sbin/init coherent_pool1M文件系统优化建议在/etc/fstab中添加noatime选项/dev/root / ext4 noatime,errorsremount-ro 0 1调整swappiness值echo vm.swappiness10 /etc/sysctl.conf6.3 自动化构建实践推荐使用Makefile管理构建流程all: kernel rootfs image kernel: $(MAKE) -C linux-kernel ARCHarm64 firefly_linux_defconfig $(MAKE) -C linux-kernel ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- -j8 rootfs: debootstrap --archarm64 xenial rootfs http://ports.ubuntu.com/ubuntu-ports cp -r overlay/* rootfs/ image: ./rkflash.sh -b firefly-rk3399 -i firefly-image/ -o output/ clean: rm -rf output/*搭配Jenkins可以实现自动化构建流水线每次代码提交后自动生成可烧写镜像。我在实际项目中设置的条件触发构建可以节省大量调试时间。