从零构建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 --version

2.2 获取基础组件

需要准备三个核心材料：

1. Ubuntu-base根文件系统：从官网下载最小化系统

   wget http://cdimage.ubuntu.com/ubuntu-base/releases/16.04/release/ubuntu-base-16.04.6-base-arm64.tar.gz

2. Linux内核源码：使用Firefly官方维护的kernel分支

   git clone -b firefly-stable https://gitlab.com/TeeFirefly/linux-kernel.git

3. Bootloader组件：包括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 └── bootloader

3. 深度定制Ubuntu根文件系统

3.1 基础系统解压与chroot环境

创建虚拟文件系统并解压Ubuntu-base：

mkdir rootfs sudo tar -xpf ubuntu-base-16.04.6-base-arm64.tar.gz -C rootfs

配置chroot环境需要处理三个关键点：

1. 挂载必要的虚拟文件系统：

   sudo mount -t proc /proc rootfs/proc sudo mount -t sysfs /sys rootfs/sys sudo mount -o bind /dev rootfs/dev

2. 复制QEMU静态程序用于指令集转换：

   sudo cp /usr/bin/qemu-aarch64-static rootfs/usr/bin/

3. 配置网络和软件源：

   sudo cp /etc/resolv.conf rootfs/etc/ echo "deb http://ports.ubuntu.com/ubuntu-ports xenial main universe" | sudo tee rootfs/etc/apt/sources.list

3.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-manager：

  apt install -y network-manager systemctl enable NetworkManager

退出前清理临时文件：

apt clean rm -rf /var/lib/apt/lists/* exit

4. 编译与优化Linux内核

4.1 内核配置与设备树调整

进入内核源码目录应用默认配置：

cd linux-kernel make ARCH=arm64 firefly_linux_defconfig

关键配置调整建议：

1. 启用OverlayFS支持：

   make ARCH=arm64 menuconfig

   路径：File systems -> Overlay filesystem support
2. 优化CPU调度策略：路径：CPU Power -> CPU Frequency scaling -> Default governor (performance)
3. 增加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 ARCH=arm64 CROSS_COMPILE=aarch64-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.img

5. 固件打包与烧写测试

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: mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(trust),0x00002000@0x00008000(misc),0x00010000@0x0000a000(boot),0x00010000@0x0001a000(recovery),0x00010000@0x0002a000(backup),0x00040000@0x0003a000(cache),0x00400000@0x0007a000(userdata),0x00000200@0x0047a000(metadata),0x00000002@0x0047a200(baseparamer),0x00000002@0x0047a400(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模式的操作要点：

1. 使用Type-C线连接开发板与主机
2. 按住Recovery键不放
3. 短按Reset键
4. 保持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 --arch=arm64 xenial minifs http://ports.ubuntu.com/ubuntu-ports

关键裁剪策略：

1. 删除不必要的locale文件：

   find /usr/share/locale -maxdepth 1 ! -name 'en*' -exec rm -rf {} \;

2. 清理文档和man手册：

   rm -rf /usr/share/{doc,man}

3. 使用busybox替代部分工具：

   apt install busybox-static ln -sf /bin/busybox /bin/ls

6.2 性能优化配置

内核启动参数优化示例：

console=ttyFIQ0,1500000 earlyprintk=uart8250-32bit,0xff1a0000 rootwait root=/dev/mmcblk1p8 rw init=/sbin/init coherent_pool=1M

文件系统优化建议：

1. 在/etc/fstab中添加noatime选项：

   /dev/root / ext4 noatime,errors=remount-ro 0 1

2. 调整swappiness值：

   echo "vm.swappiness=10" >> /etc/sysctl.conf

6.3 自动化构建实践

推荐使用Makefile管理构建流程：

all: kernel rootfs image kernel: $(MAKE) -C linux-kernel ARCH=arm64 firefly_linux_defconfig $(MAKE) -C linux-kernel ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j8 rootfs: debootstrap --arch=arm64 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可以实现自动化构建流水线，每次代码提交后自动生成可烧写镜像。我在实际项目中设置的条件触发构建，可以节省大量调试时间。