0%

OrangePi-3B 适配 AOSP —— 移植 U-Boot

OrangePi-3B 适配 AOSP 系列笔记:

温馨提示:

  1. OrangePi-3B 硬件版本 V1.1.1 的板子出现过有线网卡“无故”失灵的故障, 所以在进行操作前请确认开发板工作良好(修复这个问题需要更换 RK3566 芯片).
    https://www.bilibili.com/read/cv33224126
  2. 香橙派目前已经推出了硬件版本为 V2.1 的 OrangePi-3B, 有线网卡供应商更换为 RTL. 本系列文章没有针对 V2.1 的板子做过适配, 请根据实际情况操作(同时强烈谴责此种不负责任的行为, 如考虑购买此型号板子商用, 建议换个型号避坑).
  3. 本系列文章最后更新时间: 2026年11月20日, 实现了初始化 TEE 环境, 填了一个 ATF 关于GPU的坑.

编译环境

  • 主板: OrangePi-3b_V1.1.1
  • 芯片: RK3566
  • 环境: Debian:13_x86_64(Docker)

内容说明

主线 U-Boot 已经具备引导 Android 操作系统的能力. 构建指南可参考:
OrangePi-3B 移植 Linux —— 构建 U-Boot | 个人技术学习

对于适配 Android 新版本, 仍有部分修改, 源码位于:
https://github.com/lx0758/u-boot/commits/orangepi-3b

为了贴近最佳实践, 开启了 AB 分区, 所以要求 Android 系统也要开启 AB 分区:
为了节约空间并减少 AB 分区切换带来的调试问题, 默认不开启 AB 分区, 以下配置可以开启:

CONFIG_ANDROID_AB=y
CONFIG_CMD_AB_SELECT=y

调试

# 查看 A/B 信息(需要开启AB支持)
bcb ab_dump mmc 0#misc
# 选择启动槽位
bcb ab_select ab_slot mmc 0#misc
bcb ab_select ab_slot mmc 0#misc --no-dec  # 选择但不减少尝试次数

# 加载 BCB 查看
bcb load mmc 0 misc
bcb dump command                    # 查看 command 字段
bcb dump recovery                   # 查看 recovery 字段
bcb dump status                     # 查看 status 字段
# 清理 BCB 数据
bcb clear
bcb store

# 清理分区脏数据
mmc dev 0
mmc erase misc                      # 擦除 misc 分区
mmc erase metadata                  # 擦除 metadata 分区

# 查看分区表
mmc dev 0
mmc part
# 验证分区
part start mmc 0 boot_a             # 获取 boot_a 分区起始地址
part size mmc 0 boot_a              # 获取 boot_a 分区大小
part start mmc 0 vendor_boot_a      # 获取 vendor_boot_a 分区起始地址
part size mmc 0 vendor_boot_a       # 获取 vendor_boot_a 分区大小
mmc read 0x02000000 0x8000 0x20000  # 加载 boot_a 分区
mmc read 0x04000000 0x48000 0x20000 # 加载 vendor_boot_a 分区
abootimg addr 0x02000000 0x04000000 # 设置 boot.img 地址
abootimg get ver                    # 获取 header 版本
abootimg get ramdisk                # 获取 ramdisk 信息
abootimg get dtb --index=0          # 获取 DTB 信息
abootimg dump dtb --index=0         # 导出 DTB

# 设置启动方式
set bootmeth android
# 扫描并启动
bootflow scan -lb

问题

vendor_boot DTB 偏移计算错误(U-Boot Bug)

现象:启动时报 Error: Invalid FDT header for index 0,随后 panic FDT and ATAGS support not compiled in

根因:boot/image-android.c 的 android_image_get_dtb_img_addr() 使用 page_size 跳过 vendor_boot header,而非 ALIGN(header_size, page_size)。当 page_size=2048、header_size=2128 时,DTB 偏移差了 2048 字节,读到了 ramdisk 尾部数据而非 DTB。

// 错误
dtb_img_addr += v_hdr->page_size;   // 2048

// 正确
dtb_img_addr += ALIGN(ANDR_VENDOR_BOOT_V4_SIZE, v_hdr->page_size);  // 4096

Workaround(Android 侧配置,无需改 U-Boot):

设置 BOARD_KERNEL_PAGESIZE := 4096,使 ALIGN(2128, 4096) = 4096 = page_size,绕过 bug。不设置时构建系统默认 page_size=2048,会触发此 bug。

代码修复:

dtb_img_addr = vhdr_addr;
if (v_hdr->header_version > 3)
    dtb_img_addr += ALIGN(ANDR_VENDOR_BOOT_V4_SIZE, v_hdr->page_size);
else
    dtb_img_addr += ALIGN(ANDR_VENDOR_BOOT_V3_SIZE, v_hdr->page_size);

ARM64 未压缩内核 XIP 地址不满足 2MB 对齐(U-Boot Bug)

现象:Starting kernel ... 后无任何串口输出,内核立即崩溃

根因:boot/image-android.c 的 android_image_get_kernel_addr() 对未压缩内核(IH_COMP_NONE)返回原地地址(kernel_ptr),走 XIP 模式。内核位于 boot image 内的偏移地址 0x00c01800,不满足 ARM64 启动协议要求的 2MB 对齐。

// 原逻辑:未压缩 → 直接原地执行
if (comp == IH_COMP_NONE)
    return img_data->kernel_ptr;  // 0x00c01800,非 2MB 对齐

Workaround(Android 侧配置,无需改 U-Boot):

设置 BOARD_MKBOOTIMG_ARGS += --kernel_offset 0x04000000,使 vendor_boot header 的 kernel_addr = mkbootimg --base(0x10000000) + 0x04000000 = 0x14000000(非默认值 + 2MB 对齐),U-Boot 检测到非默认值后重定位内核而非原地执行。

推导过程:kernel_addr = mkbootimg --base(0x10000000) + kernel_offset

kernel_offset kernel_addr 结果
0x00008000 0x10008000 ✗ 等于 U-Boot 默认值,走 XIP
0x00000000 0x10000000 ✗ 内核 41MB 覆盖 U-Boot fdt_addr_r(0x12000000)
0x02000000 0x12000000 ✗ 等于 U-Boot fdt_addr_r,直接冲突
0x04000000 0x14000000 ✓ 2MB 对齐、无冲突、最小可用值

注:压缩内核 (LZ4/GZIP) 会自动解压到 U-Boot kernel_addr_r (0x02000000),无此问题。

代码修复:

if (comp == IH_COMP_NONE) {
    /*
     * On ARM64, the kernel must be loaded at a 2MB-aligned
     * address per the ARM64 boot protocol. If the in-place
     * address is not 2MB-aligned, fall back to kernel_addr_r
     * so that bootm relocates the kernel correctly.
     */
    if (IS_ENABLED(CONFIG_ARM64) &&
        !IS_ALIGNED(img_data->kernel_ptr, SZ_2M)) {
        ulong addr = env_get_ulong("kernel_addr_r", 16, 0);
        if (addr)
            return addr;
        log_err("kernel_addr_r not set and kernel is not 2MB-aligned\n");
    }
    return img_data->kernel_ptr;
}