Ubuntu-Rockchip项目：ROC-RK3588S-PC开发板的NVMe支持优化

背景介绍

ROC-RK3588S-PC是一款基于Rockchip RK3588S处理器的开发板，其M.2接口同时支持SATA和PCIe协议。然而在默认配置下，该开发板仅启用了SATA支持，需要通过修改设备树并重新编译固件才能启用NVMe支持。本文将详细介绍如何在不重新编译固件的情况下，通过设备树覆盖技术实现NVMe支持。

技术原理分析

RK3588S处理器的M.2接口设计采用了灵活的配置方式，可以通过软件选择支持SATA或PCIe协议。这种设计带来了硬件兼容性的优势，但也增加了软件配置的复杂性。在设备树中，相关配置主要体现在以下几个方面：

1. 电源管理：NVMe设备需要稳定的3.3V供电
2. 时钟配置：PCIe接口需要特定的时钟信号
3. 引脚复用：M.2接口的引脚需要正确配置为PCIe模式

现有问题诊断

在当前的Ubuntu-Rockchip固件中，ROC-RK3588S-PC开发板的设备树默认将M.2接口配置为SATA模式。通过分析系统日志，可以观察到以下关键信息：

[   16.665514] reg-fixed-voltage vcc3v3-pcie20: Looking up vin-supply from device tree
[   19.227602] rockchip-pm-domain: Looking up pcie-supply property in node failed

这些日志表明PCIe电源管理未能正确初始化，导致NVMe设备无法被识别。

解决方案实现

方法一：使用设备树覆盖技术

1. 创建或获取预编译的SATA设备树覆盖文件(rk3588s-roc-pc-sata0.dtbo)
2. 修改u-boot配置：

sudo vi /etc/default/u-boot

添加以下内容：

U_BOOT_FDT_OVERLAYS_DIR="/lib/firmware/6.1.0-1021-rockchip/device-tree/rockchip/overlay/"
U_BOOT_FDT_OVERLAYS="rk3588s-roc-pc-sata0.dtbo"
U_BOOT_SYNC_DTBS="true"
U_BOOT_UPDATE="true"

3. 更新u-boot配置：

sudo u-boot-update

方法二：直接替换设备树二进制文件

对于需要更彻底解决方案的用户，可以直接替换设备树二进制文件：

1. 获取支持NVMe的设备树源文件(rk3588s-roc-pc.dts)
2. 编译设备树：

dtc -I dts -O dtb -o rk3588s-roc-pc.dtb rk3588s-roc-pc.dts

3. 替换系统设备树文件：

sudo cp rk3588s-roc-pc.dtb /lib/firmware/6.1.0-1021-rockchip/device-tree/rockchip/rk3588s-roc-pc.dtb

验证与测试

成功应用解决方案后，系统日志应显示PCIe链路已建立：

[   16.614772] rk-pcie fe190000.pcie: PCIe Link up, LTSSM is 0x130011
[   16.614820] rk-pcie fe190000.pcie: PCIe Gen.2 x1 link up

通过lsblk命令应能看到NVMe设备：

nvme0n1      259:0    0   1.9T  0 disk 
└─nvme0n1p1  259:1    0   1.9T  0 part 

性能优化建议

1. 对于高性能NVMe SSD，建议检查PCIe链路速度：

dmesg | grep "available PCIe bandwidth"

2. 考虑使用PCIe 3.0 x4接口的M.2转接板以获得更高性能

3. 对于需要频繁读写的大型应用，建议将根文件系统迁移到NVMe设备

总结

通过设备树覆盖或直接替换设备树二进制文件的方法，用户可以灵活地在ROC-RK3588S-PC开发板上启用NVMe支持，无需重新编译整个固件。这种解决方案不仅简化了配置过程，还保留了系统原有的SATA支持能力，用户可以根据实际需求随时切换存储接口类型。