OrangePi-3B 适配 AOSP 系列笔记:
- OrangePi-3B 适配 AOSP —— 介绍
- OrangePi-3B 适配 AOSP —— 准备编译环境
- OrangePi-3B 适配 AOSP —— 移植 U-Boot
- OrangePi-3B 适配 AOSP —— 移植 Kernel
- OrangePi-3B 适配 AOSP —— 移植 Android
- OrangePi-3B 适配 AOSP —— 移植 OPTEE
温馨提示:
- OrangePi-3B 硬件版本 V1.1.1 的板子出现过有线网卡“无故”失灵的故障, 所以在进行操作前请确认开发板工作良好(修复这个问题需要更换 RK3566 芯片).
https://www.bilibili.com/read/cv33224126- 香橙派目前已经推出了硬件版本为 V2.1 的 OrangePi-3B, 有线网卡供应商更换为 RTL. 本系列文章没有针对 V2.1 的板子做过适配, 请根据实际情况操作(同时强烈谴责此种不负责任的行为, 如考虑购买此型号板子商用, 建议换个型号避坑).
- 本系列文章最后更新时间: 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;
}