调试 / TSENGCHEN BLOG

2026-08-27_RK182x_OpenSBI启动Illegal_instruction修复

02_Debug · 第 8 / 16 篇

RK182x U-Boot OpenSBI 启动异常调试

本文记录 RK182x 在 SPL 跳转 OpenSBI 时触发 Illegal instruction 的原因、修复及验证方法。适用于 /home/user/SDK/rk182x_linux 的 rk182x 配置。

异常特征

串口日志显示 DDR 初始化、SPL 读取 MMC 和 FIT 哈希校验均已完成,但跳转后异常:

Jumping to U-Boot(0x540400000) via RISC-V OpenSBI(0x540200000, hart:0)
Unhandled exception: Illegal instruction
EPC: 0000000540200000
TVAL: 00000000464c457f

EPC 为 OpenSBI 加载地址 0x540200000。TVAL 的低字节序为 7f 45 4c 46,即 ELF 文件头,说明 SPL 将 ELF 文件头当作 RISC-V 指令执行。

原因

rkbin/RKTRUST/RK182XTRUST.ini 指定的 OpenSBI 文件为:

rkbin/bin/rk18/rk1820_opensbi_v1.00.elf

原 u-boot/make.sh 直接复制该 ELF 文件至 u-boot/opensbi.bin:

cp ${OPENSBI_BIN} ./opensbi.bin

随后 u-boot/uboot.its 使用该文件生成 FIT 中的 opensbi 节点。SPL 将该节点加载到 OpenSBI 地址后直接跳转,因此不能使用 ELF 容器格式,必须使用 raw binary。

修改

修改文件:u-boot/make.sh

将直接复制替换为交叉工具链的 objcopy 转换:

${CROSS_COMPILE}objcopy -O binary ${OPENSBI_BIN} ./opensbi.bin

此修改不重新编译 OpenSBI 源码,仅将 rkbin 提供的 OpenSBI ELF 转换为 raw binary 后打包进 uboot.img。

重新编译和打包

在 SDK 根目录执行:

cd /home/user/SDK/rk182x_linux
./build.sh uboot
./build.sh firmware

./build.sh uboot 更新以下 U-Boot 相关产物:

  • u-boot/uboot.img
  • u-boot/rk182x_loader_v1.00.bin

./build.sh firmware 不重新编译 kernel 或 Buildroot rootfs;它复用已有产物并重新生成:

  • output/firmware/update.img
  • output/update/Image/package-file
  • output/extra-parts/userdata.img

验证

确认 FIT 中的 OpenSBI payload 不再以 ELF 头开始:

cd /home/user/SDK/rk182x_linux
tmp=$(mktemp)
dumpimage -T flat_dt -p 1 -o "$tmp" u-boot/uboot.img
od -An -tx1 -N16 "$tmp"
rm -f "$tmp"

修复后输出应为 RISC-V 指令字节,例如:

33 04 05 00 b3 84 05 00 33 09 06 00 ef 00 c0 66

若输出以 7f 45 4c 46 开始,说明 OpenSBI 仍以 ELF 格式被打包,不能用于启动。

确认完整更新包包含所需分区镜像:

cat output/update/Image/package-file

当前配置应包含 bootloader、uboot、boot、rootfs 和 userdata。

结果

新生成的 update.img 包含修复后的 uboot.img。该修复只增加 U-Boot/OpenSBI 镜像占用,不改变 Linux 根文件系统、userdata 分区容量或 Linux 用户态进程的 RAM 占用。

02_Debug · 文档目录
上一篇2026-08-27_RK182x_内核运行时内存占用分析下一篇2026-08-27_RK182x_USB_ADB_gadget_BusyBox兼容性修复