保姆级教程：在Ubuntu 20.04上为FT2000+芯片编译并打包PBF与BIOS（附完整脚本解析）

保姆级实战：Ubuntu 20.04环境下飞腾FT2000+固件开发全流程解析

最近在开源社区看到不少开发者对国产芯片的固件开发流程存在畏难情绪。作为从x86平台转型过来的"老嵌入式"，我完全理解这种忐忑——新架构、新工具链、新术语体系，每一步都像在走钢丝。但经过三个实际项目的锤炼，我发现飞腾平台的开发环境搭建其实比想象中友好得多。本文将用最接地气的方式，带你完整走通FT2000+的PBF与BIOS编译打包流程，重点解决以下几个典型痛点：

• 开发环境配置中的依赖项冲突问题
• 交叉编译工具链的路径陷阱
• 固件参数调优时的硬件适配技巧
• 自动化脚本中的隐藏"彩蛋"

我们将使用Ubuntu 20.04作为基准系统，一方面因为其LTS特性保证稳定性，另一方面官方工具链对该版本的支持最完善。整个过程会涉及约23个关键步骤，每个环节我都会标注实际开发中容易翻车的点。

1. 开发环境准备：避开依赖地狱

在干净的Ubuntu 20.04系统上（推荐使用虚拟机），首先要解决的是软件源配置问题。由于需要安装的依赖涉及多个版本库，建议先执行以下源更新：

sudo sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list sudo apt update && sudo apt upgrade -y

必须安装的基础依赖包：

sudo apt install -y build-essential git flex bison libssl-dev libncurses5-dev \ bc u-boot-tools device-tree-compiler lzop dosfstools mtools parted

注意：如果之前安装过其他版本的开发工具链，建议先执行sudo apt autoremove清理残留，避免版本冲突。

常见问题排查表：

2. 工具链配置：路径的艺术

飞腾官方提供的交叉编译工具链是整套流程的核心，但官方文档对路径配置的说明往往语焉不详。我们采用aarch64-linux-gnu-gcc 8.3版本为例：

wget https://ftpmirror1.gnu.org/gnu/gcc/gcc-8.3.0/gcc-8.3.0.tar.xz tar xvf gcc-8.3.0.tar.xz cd gcc-8.3.0 ./configure --target=aarch64-linux-gnu --prefix=/opt/ft2000-toolchain make -j$(nproc) && sudo make install

关键配置点：

1. 绝对不要将工具链安装在包含空格的路径中
2. 在~/.bashrc中添加：

   export PATH="/opt/ft2000-toolchain/bin:$PATH" export CROSS_COMPILE=aarch64-linux-gnu-

3. 验证安装：

   aarch64-linux-gnu-gcc --version # 应显示 "aarch64-linux-gnu-gcc (GNU) 8.3.0"

提示：如果遇到权限问题，可以创建专门的开发用户组：

sudo groupadd ftdev sudo usermod -aG ftdev $USER sudo chgrp -R ftdev /opt/ft2000-toolchain sudo chmod -R 775 /opt/ft2000-toolchain

3. 源码获取与预处理

飞腾的PBF源码托管在内部git服务器，但我们可以通过开源镜像加速下载：

git clone https://gitee.com/mirrors/phytium-pbf.git -b ft2000-4.1.0 cd phytium-pbf

目录结构解析：

├── arch/ # 芯片架构相关代码 ├── board/ # 开发板支持包 ├── configs/ # 默认配置文件 ├── drivers/ # 外设驱动 ├── include/ # 头文件 └── scripts/ # 编译脚本

重点修改文件：

1. configs/ft2000_defconfig：

   CONFIG_CPU_DDR_FREQ=y CONFIG_DDR_FREQ=2400 # 根据内存颗粒型号调整

2. board/phytium/ft2000/memory.c：

   /* 修改内存时序参数 */ struct dram_timing_t ddr_timing = { .tRFC = 350, .tRP = 13, .tRCD = 13 };

4. 编译脚本深度解析

官方提供的build.sh脚本虽然只有50行，但暗藏玄机。我们拆解关键段落：

#!/bin/bash # 编译日志输出到文件同时显示在终端 exec > >(tee build.log) 2>&1 # 检查工具链 check_toolchain() { which ${CROSS_COMPILE}gcc || { echo "Toolchain not found!" exit 1 } } # 并行编译控制 if [ -z "$JOBS" ]; then JOBS=$(($(nproc)*2)) fi # 关键编译步骤 make distclean make ft2000_defconfig make -j$JOBS all 2>&1 | tee make.log # 生成最终镜像 dd if=/dev/zero of=boot.img bs=1M count=64 mkfs.vfat boot.img mmd -i boot.img ::/EFI ::/EFI/BOOT mcopy -i boot.img build/ft2000/pbf.bin ::/EFI/BOOT/BOOTAA64.EFI

脚本中的技术要点：

1. exec > >(tee build.log)实现终端输出与日志记录同步
2. $(($(nproc)*2))自动计算最优并行编译任务数
3. dd+mkfs.vfat组合创建虚拟磁盘镜像
4. mmd和mcopy来自mtools工具包，用于操作FAT镜像

常见编译错误处理：

# 遇到未定义引用错误时尝试重新链接 find . -name "*.o" -delete make -j$JOBS all

5. 烧写与验证

生成boot.img后，可以通过以下方式烧写到开发板：

sudo dd if=boot.img of=/dev/sdX bs=4M status=progress sync

上电启动时，在串口终端观察输出（波特率115200）：

[0.100] DDR Init Success [0.105] CPU: FT2000+ 4Core @2.0GHz [0.110] Boot from SPI Flash [0.115] Starting PBF...

性能调优参数建议：

6. 进阶调试技巧

当遇到启动失败时，可以尝试以下诊断方法：

1. 获取完整硬件日志：

   sudo apt install screen screen /dev/ttyUSB0 115200

2. 内存测试模式：

   # 在U-Boot命令行输入 mtest 0x80000000 0x8FFFFFFF

3. 电压监测：

   # 需要外接万用表 CPU核心电压：1.15V ±5% DDR电压：1.2V 严格禁止超5%

BIOS界面操作备忘：

• F2进入设置菜单
• F7加载默认配置
• F10保存并重启

7. 自动化打包系统搭建

对于需要频繁编译的场景，建议配置Jenkins自动化流程：

pipeline { agent any stages { stage('Prepare') { steps { sh 'git clean -fdx' sh 'git pull origin ft2000-4.1.0' } } stage('Build') { steps { sh 'chmod +x build.sh' sh './build.sh' archiveArtifacts 'boot.img' } } } }

配套的版本管理策略：

1. 每日构建版本：YYYYMMDD格式标签
2. 发布候选版：RC1、RC2递增
3. 正式版本：遵循主版本.次版本.修订号规范

在开发过程中，我特别推荐使用git bisect定位引入问题的提交。某次调试中，正是这个方法帮我快速找到了导致DDR初始化失败的罪魁祸首——一个错误的内存时序参数提交。