RK3588开发实战：如何从零开始手动移植uboot源码（避坑指南）

关注

VIP免费原创最新推荐文章于 2026-09-20 13:55:09 发布 421 阅读 AI 写同款· GEO 优化 ›

基于RK3588的嵌入式linux系统开发（二）——uboot源码移植及编译由于官方的SDK占用空间较大（大约20GB左右），需要联系相关供应商提供，且官方的SDK通过各种脚本文件进行集成编译，难以理解系统开发的详细过程。本章介绍直接从官方Github网站下载源码进行移植，进行uboot移植及编译，具体内容如下所述：阅读详情

RK3588深度实战：从零手动移植U-Boot源码的完整心法与避坑实录

如果你已经厌倦了动辄几十GB的官方SDK，厌倦了那些黑盒般的编译脚本，渴望真正理解一块RK3588开发板从通电到启动Linux内核的每一行代码是如何运作的，那么这篇文章正是为你准备的。官方SDK固然方便，但它像一座封装严实的大厦，你住在里面，却不知道墙体和管道是如何铺设的。手动移植U-Boot，就是亲手从打地基开始，一砖一瓦地重建这座大厦的过程。这不仅是为了获得一个可启动的U-Boot，更是一次对嵌入式系统启动流程、硬件初始化、设备树机制和构建系统的深度洗礼。本文将完全脱离官方SDK的自动化流程，带你从官方Git仓库拉取纯净源码开始，一步步完成配置、适配、编译，直至生成可用的镜像。过程中每一个看似微小的步骤背后，都可能隐藏着导致编译失败或启动异常的“坑”，我将结合自己的实战经验，为你一一揭示并填平。

1. 环境准备与源码获取：奠定坚实的基础

在开始任何代码工作之前，一个稳定、纯净且工具链完备的构建环境是成功的一半。对于RK3588这类基于Arm Cortex-A系列的复杂应用处理器，任何环境上的细微偏差都可能导致难以排查的问题。

1.1 构建系统与工具链配置

首先，确保你的Ubuntu系统（推荐20.04 LTS或22.04 LTS）已安装必要的开发工具。不同于简单的apt install gcc，我们需要的是针对Arm架构的交叉编译工具链。

# 更新软件包列表并安装基础开发工具
sudo apt update
sudo apt install -y build-essential git bison flex libssl-dev libncurses-dev

# 安装适用于Arm64架构的Linaro GCC交叉编译工具链
# 这里以GCC 11.3为例，你也可以选择Arm官方或Rockchip推荐的版本
sudo apt install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu

安装完成后，验证工具链是否可用：

aarch64-linux-gnu-gcc --version

你应该能看到类似 aarch64-linux-gnu-gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0 的输出。记下这个版本号，有时不同版本的工具链在编译特定代码时会有细微差异。

注意：强烈建议不要在root用户下进行编译工作。所有操作应在普通用户目录下进行，以避免权限问题污染系统文件。

1.2 获取纯净的U-Boot源码

Rockchip维护的U-Boot源码托管在GitHub上。这里有一个关键决策点：是下载某个发布版本的压缩包，还是直接克隆主分支？为了获取最新的修复和可能的RK3588支持更新，我推荐克隆仓库。

# 创建一个专门的工作目录
mkdir -p ~/workspace/rk3588_uboot
cd ~/workspace/rk3588_uboot

# 克隆Rockchip的U-Boot仓库
git clone https://github.com/rockchip-linux/u-boot.git
cd u-boot

克隆完成后，不要急于切换分支或标签。先查看一下仓库的结构和最近的提交记录，了解其活跃度。

git log --oneline -5

此时，你拥有了一份与官方SDK解耦的、最上游的U-Boot源码。接下来的所有工作，都将基于这份“原材料”展开。

2. 源码结构与关键文件解析：理解U-Boot的骨架

在动手修改之前，我们必须像外科医生熟悉人体解剖一样，熟悉U-Boot的源码结构。这对于后续定位问题、理解修改逻辑至关重要。

U-Boot的目录结构虽然庞大，但对于移植工作，我们只需重点关注以下几个核心部分：

arch/arm/dts/：设备树源文件（.dts/.dtsi）的存放地。这是硬件描述的核心，RK3588的所有外设、内存布局、时钟、引脚复用等信息都在这里定义。移植的大部分工作都围绕它展开。
arch/arm/mach-rockchip/：Rockchip平台特定的机器（Mach）层代码。包含SOC初始化、时钟设置、电源管理等底层硬件操作。
board/rockchip/：具体开发板的板级支持包（BSP）。包含该板子的GPIO初