Ubuntu-Rockchip项目：Orange Pi 5 SATA SSD配置指南

在Orange Pi 5单板计算机上运行Ubuntu 24.04系统时，用户可能会遇到SATA SSD无法识别的问题。本文将详细介绍如何通过修改系统配置实现SATA设备的正常访问。

问题背景

Orange Pi 5基于Rockchip RK3588S芯片设计，其SATA控制器需要特定的设备树覆盖层(Device Tree Overlay)才能被系统正确识别。在Ubuntu 24.04的官方镜像和ubuntu-rockchip定制镜像中，这一功能默认未启用。

解决方案

方法一：通过官方镜像配置

1. 准备工作：

   • 使用官方Ubuntu镜像启动系统
   • 通过orangepi-config工具启用SATA支持：

     System Settings > Hardware > ssd-sata0
     

2. 挂载SSD分区：

   sudo mount /dev/sda1 /mnt
   

3. 修改启动配置：

   • 编辑u-boot配置文件：

     sudo nano /mnt/etc/default/u-boot
     

     添加以下内容：

     U_BOOT_FDT="device-tree/rockchip/rk3588s-orangepi-5.dtb"
     U_BOOT_FDT_OVERLAYS="device-tree/rockchip/overlay/orangepi-5-sata.dtbo"
     

   • 修改extlinux启动项：

     sudo nano /mnt/boot/extlinux/extlinux.conf
     

     在对应内核条目下添加：

     fdt /lib/firmware/<内核版本>/device-tree/rockchip/rk3588s-orangepi-5.dtb
     fdtoverlays /lib/firmware/<内核版本>/device-tree/rockchip/overlay/orangepi-5-sata.dtbo
     

方法二：通过ubuntu-rockchip镜像配置

对于使用ubuntu-rockchip定制镜像的用户，系统已提供更简化的配置方式：

1. 验证当前配置：

   cat /boot/extlinux/extlinux.conf
   

   确认文件中已包含正确的设备树和覆盖层路径。

2. 内核版本注意事项：

   • 系统可能同时存在多个内核版本（如6.1.0-1013和6.1.0-1014）
   • 确保fdt和fdtoverlays路径与当前运行内核版本一致

技术原理

该解决方案的核心是通过设备树覆盖层机制动态修改硬件配置：

1. 设备树(Device Tree)：描述硬件组件的层次结构
2. 覆盖层(Overlay)：在基础设备树上动态添加或修改节点
3. u-boot集成：在启动阶段加载正确的设备树配置

常见问题排查

1. 设备未识别：

   • 检查dmesg输出确认SATA控制器初始化情况
   • 验证物理连接和电源供应

2. 挂载失败：

   • 确认设备节点存在（如/dev/sda1）
   • 检查分区格式和文件系统类型

3. 版本不匹配：

   • 确保内核版本与设备树路径一致
   • 更新系统获取最新固件

最佳实践建议

1. 在进行任何修改前备份重要配置文件
2. 建议使用最新版本的ubuntu-rockchip镜像，其已优化SATA支持
3. 对于生产环境，建议在修改后进行全面测试
4. 定期检查系统更新，获取最新的设备树支持

通过以上步骤，用户可以在Orange Pi 5上实现SATA SSD的稳定访问，充分发挥这款高性能单板计算机的存储潜力。