Ubuntu-Rockchip项目在OrangePi 3B上的NVMe启动问题分析与解决方案

OrangePi 3B单板计算机在使用Ubuntu-Rockchip项目提供的系统镜像时，出现了一个典型的NVMe启动问题。本文将深入分析该问题的技术背景，并提供经过验证的解决方案。

问题现象

用户反馈在使用Ubuntu 22.04 LTS（v2.2.1）镜像时，OrangePi 3B无法从NVMe驱动器启动，系统会卡在OrangePi的LOGO界面。值得注意的是，相同的镜像在SD卡上可以正常工作。这个问题在多个硬件版本（v2.1和v2.2）上都得到了复现。

技术分析

经过社区成员的深入探索，发现问题的根源在于SPI闪存中的引导加载程序（U-Boot）与NVMe存储设备的兼容性问题。以下是关键发现：

1. SPI闪存内容差异：官方OrangePi镜像和Ubuntu-Rockchip项目镜像在SPI闪存中写入的内容存在显著差异。官方工具只写入rkspi_loader.img，而u-boot-install-mtd命令会写入完整的U-Boot环境。

2. 引导流程差异：OrangePi 3B的启动流程依赖于SPI闪存中的引导加载程序来初始化NVMe设备。不兼容的U-Boot版本会导致NVMe设备无法被正确识别和初始化。

3. 版本兼容性：较新的Armbian镜像更新SPI闪存后，可能导致旧版本系统无法启动，这表明存在版本依赖关系。

已验证的解决方案

基于社区成员的实践经验，以下是可靠的问题解决方法：

1. 初始准备：

   • 将Ubuntu-Rockchip镜像写入SD卡
   • 从SD卡启动系统

2. SPI闪存编程：

   • 在已启动的系统中执行u-boot-install-mtd命令
   • 该命令会将兼容的U-Boot环境写入SPI闪存

3. NVMe安装：

   • 将系统镜像写入NVMe驱动器
   • 移除SD卡后，系统应能正常从NVMe启动

注意事项

1. 此方法不会影响SD卡上其他系统的启动功能
2. 建议在操作前备份重要数据
3. 不同硬件版本可能需要略微调整操作步骤
4. 系统性能表现（如视频播放流畅度）可能因硬件版本而异

技术背景扩展

OrangePi 3B采用Rockchip RK3566 SoC，其启动流程与传统x86架构有显著不同。SPI闪存中的引导加载程序负责初始化关键硬件，包括存储控制器。NVMe设备的初始化需要特定的U-Boot驱动和配置，这正是导致兼容性问题的关键所在。

通过这种方法，用户可以在OrangePi 3B上充分利用NVMe存储的高性能优势，同时享受Ubuntu-Rockchip项目提供的优化系统体验。