当前位置： 首页 > news >正文

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

news 2026/5/10 16:30:59

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可以实现自动化构建流水线，每次代码提交后自动生成可烧写镜像。我在实际项目中设置的条件触发构建，可以节省大量调试时间。

http://www.jsqmd.com/news/790473/

相关文章：

  • 如何用WeChatMsg永久保存微信聊天记录：5步完成数据备份与智能分析
  • 从攻防演练到真实防御：手把手教你用Wireshark和ARP命令检测并防范ARP欺骗攻击
  • AI专著撰写高效指南：使用AI工具，一键生成20万字专著框架与内容！
  • 为AI智能体构建机械免疫系统：STARK SHIELD三层安全架构详解
  • 3大功能场景深度解析：如何用Umi-OCR高效解决日常文字识别难题
  • FairMOT实战避坑：从训练到部署的5个关键步骤与性能优化心得
  • 超轻角度传感器内部结构
  • 你的提示词正在被悄悄降权：奇点大会首次披露Llama-4/GPT-5/DeepSeek-V3的隐式Prompt评分机制（含逆向校准工具包）
  • 郑州物业系统能对接门禁道闸、财务软件吗？ - movno1
  • 3分钟掌握树状书签管理：Neat Bookmarks终极整理指南
  • 如何彻底解决Windows热键冲突：Hotkey Detective完全使用指南
  • Claude Code 近两天更新解读：MCP、VS Code、token 消耗和国内接入方案
  • 2026年｜2026届毕业生必备：手把手教你用免费降AI工具，将论文AI痕迹从70%降到10% - 降AI实验室
  • 8086/8088单板机VSCode集成自动下载功能（完善串口接收显示版）
  • 2026年论文降AI技巧必备指南：高效通过AI检测，告别降AI困扰 - 降AI实验室
  • 别再手动算时延了！用Python+广义互相关（GCC-PHAT）实现麦克风阵列声源定位
  • 大众认为集体决策正确率高于个人决策，编程统计决策模式，落地成果数据，专业单人决策效率与准确性更高。
  • 跨平台资源下载器：轻松捕获网络视频与音频资源的完整指南
  • Origin颜色映射与对数坐标实战：手把手教你调出专业级径向堆积条形图配色
  • 京东e卡回收平台综合实力大比拼 - 京顺回收
  • 如何高效控制ThinkPad风扇：TPFanCtrl2智能散热解决方案指南
  • 河南物业软件买断式和按年付费哪个更划算？ - movno1
  • 实测Taotoken聚合API的延迟与稳定性表现
  • 观察Taotoken用量看板如何帮助个人开发者精打细算
  • Python 开发者三步完成 Taotoken 的 OpenAI 兼容 SDK 接入指南
  • 传统认为娱乐活动越少越容易成功，编程统计休闲时长，工作状态数据，合理休闲能够大幅度提升工作创造力。
  • 2026重庆钻石回收TOP5实测，收的顶稳居榜首，免费上门回收更省心 - 奢侈品回收测评
  • 如何永久保存微信聊天记录：WeChatMsg完整指南与终极解决方案
  • 终极图像分层神器：如何用Layerdivider一键生成专业PSD分层文件
  • AScript中一个很有意思的语法