瑞芯微RK3576存储系统化排障手册｜eMMC/UFS/SD/SPI Flash分介质排查

该文章基于触觉智能RK3576开发板Purple Pi OH2讲解调试，

存储排障的关键是"识别 →读写→ 容量/分区"三步：设备能不能被内核认到（mmc/ufs/mtd）、读写正不正常、容量和分区对不对。内置的触觉智能RK3576开发板还支持SD卡（&sdmmc）与 &UFS两种主流介质，本文按介质类型分段展开，含板端实测与官方文档依据。

排障共性是"先看 dmesg 里识别没识别、再看读写、再看容量"。eMMC/SD 看 mmc 日志与 mmcblk*，UFS 看 ufshcd 日志，Flash 看 mtd 节点。

eMMC/SD：识别与读写错误

本板SD卡走 &sdmmc（pinctrl sdmmc0_clk/cmd/det/bus4），驱动是 Rockchip 的 rk_sdmmc_ops.c（CONFIG_MMC_DW_ROCKCHIP=y）。

官方 FAQ_Storage_CN.pdf 覆盖 eMMC/SD 的高频问题（识别、时序、容量、写保护等），是首查清单。

UFS 排障

本板 UFS 走 &ufs，内核 ufshcd-pltfrm（CONFIG_SCSI_UFSHCD=y）。UFS 比 eMMC 复杂（多命令队列、电压更敏感），排障看 dmesg | grep -i ufs：

• 识别不了

  先看 ufshcd 初始化日志卡在哪（时钟/复位/供电/链路）；

• 读写异常

  UFS 对电源（vcc/vccq）很敏感，供电异常会表现成偶发读写失败；

• 容量

  UFS 识别后看 lsblk 容量是否与标称一致，容量减半/异常常见于供电或时序。

SPI-NOR/SPI-NAND与MTD

SPI Flash（NOR/NAND）走MTD子系统：NOR 在 drivers/mtd/spi-nor/，NAND 在 drivers/mtd/nand/spi/。排障要点：

双存储/扩容

存储"不够用/挂不上"多与分区相关：rootfs是grow分区吃剩余空间，想扩容先缩 userdata/oem；多存储（eMMC+SD、UFS+SATA）通过 /etc/fstab或 PARTLABEL 挂载。官方 Dual_Storage_CN.pdf 讲双存储方案，扩容/分区见篇章一的分区排障。

存储排障按介质走：eMMC/SD 看mmc日志与mmcblk（含vqmmc IO域）→ UFS看ufshcd 初始化（供电敏感）→ SPI Flash看mtd与支持列表→容量/挂载问题回分区排障。官方Storage FAQ是首查清单。

RK3576 板端实测记录

以下在触觉智能Purple Pi OH2开发板+ Debian Bookworm 上通过 adb 直连执行：

注意：UFS/MTD在Purple Pi OH2是"dts已配置但无器件"——遇到这类"配置对但没设备"的情况，先确认板上是否真的贴了对应介质，再查驱动日志。（配套核心板预留UFS总线）

• 官方文档依据

docs/cn/Common/NVM/Rockchip_Developer_FAQ_Storage_CN.pdf
docs/cn/Common/NVM/Rockchip_Developer_Guide_Dual_Storage_CN.pdf
docs/cn/Common/NVM/Rockchip_Developer_Guide_UFS_CN.pdf
docs/cn/Common/NVM/Rockchip_Developer_Guide_Linux_Flash_Open_Source_Solution_CN.pdf
docs/cn/Common/MMC/Rockchip_Developer_Guide_SDMMC_SDIO_eMMC_CN.pdf
docs/cn/Common/TOOL/Rockchip_Introduction_Partition_CN.pdf

• SDK源码/配置依据

kernel-6.1/drivers/mmc/host/rk_sdmmc_ops.c
drivers/ufs/host/ufshcd-pltfrm.c
drivers/mtd/spi-nor/
drivers/mtd/nand/spi/
kernel-6.1/arch/arm64/boot/dts/rockchip/ido-evb7609-v1a.dtsi（&sdmmc、&ufs 节点与 pinctrl）
kernel-6.1/arch/arm64/configs/rockchip_linux_rk3576_defconfig（CONFIG_MMC_DW_ROCKCHIP=y、CONFIG_SCSI_UFSHCD=y）
device/rockchip/.chips/rk3576/parameter.txt

Purple Pi OH2开发板，是触觉智能RK3576核心板SOM7609系列配套的评估开发板，搭载4核A72+4核A53+M0多核异构处理器，主频2.2GHz，集成6Tops算力 NPU，轻松应对AI推理、边缘计算与轻量级AI端侧学习。配套完善SDK、丰富资料与Demo，有助于项目前期快速开发验证。

触觉智能SOM7609系列核心板尺寸仅40.5×40.5mm，专为空间受限场景打造。基于RK3576/RK3576J SoC，集成高性能GPU与VPU，支持4K视频编解码与多屏异显；提供PCIe、USB3.2、双路千兆以太网、MIPI-DSI、多路MIP CSI、eDP、CAN、SPI、I2C等丰富接口，灵活扩展。支持Linux、Android、开源