内存与存储 - Qualcomm Dragonwing Documentation

Qualcomm Linux 平台支持四种主要存储类型。

存储类型	版本
通用闪存存储（UFS）	v2.1、v2.2、v3.1
嵌入式多媒体卡（eMMC）	v5.1
非易失性内存高速接口（NVMe）	v1.3
安全数字（SD）卡	v3.0

请将设备配置为仅从一个存储源启动。同时使用两个存储源存放可启动文件可能导致系统崩溃或不可预测的行为。

UFS 存储

特性

特性	说明
通道	支持 2 通道
Gear	HS Gear 1、2、3 和 4
低功耗模式	链路休眠和设备睡眠
热插拔	不支持（仅嵌入式）

电源管理状态

Auto-Hibern8（AH8） — 空闲 150 ms 后将 PHY 链路转换为休眠状态（可调整）。

cat /sys/devices/platform/soc@0/1d84000.ufs/auto_hibern8

时钟门控 — 默认启用。

cat /sys/devices/platform/soc@0/1d84000.ufs/clkgate_enable
echo 0 > /sys/devices/platform/soc@0/1d84000.ufs/clkgate_enable  # Disable for debugging

时钟调节 — 默认启用；禁用会增加功耗。

cat /sys/devices/platform/soc@0/1d84000.ufs/clkscale_enable

UFS 分区配置（Provisioning）

开发期间设置 bConfigDescrLock="0"。定型后设置为 "1" 以防止重新配置。

默认分区布局：

LUN0 — Linux 数据和文件系统镜像
LUN1 和 LUN2 — Boot WLUN（0xB0）交替使用，用于故障安全的 XBL 备份
LUN4 — 启动链的其余部分
LUN6 和 LUN7 — 默认未使用

架构图

eMMC 存储

特性

特性	说明
速率	DDR50、HS200、HS400、HS400 Enhanced
睡眠模式	时钟门控和自动挂起
命令队列	多命令并发

设备树配置

&sdhc_1 {
    status = "okay";
    pinctrl-names = "default", "sleep";
    pinctrl-0 = <&sdc1_on>;
    pinctrl-1 = <&sdc1_off>;
    vmmc-supply = <&vreg_l19a_2p9>;
    vqmmc-supply = <&vreg_l12a_1p8>;
};

SD 卡存储

特性	说明
总线宽度	4 位模式
速率	SDR50、SDR104、DDR50
热插拔	支持

NVMe 存储

特性	说明
通道	通过 PCIe 端口（PCIe1）的 4 通道
接口	高速串行

配置指南

挂载文件系统

UFS / eMMC
SD 卡
NVMe

mkdir /tmp/data
mount -t ext4 /dev/sda3 /tmp/data
df -a

mkdir sdcard
mkfs.vfat /dev/mmcblk1p1
mount -t vfat /dev/mmcblk1p1 /sdcard
df -a

fdisk /dev/nvme0n1
reboot
mkfs.ext4 /dev/nvme0n1p1
mount /dev/nvme0n1p1 /media
df -a

电源管理控制

mount -t debugfs none /sys/kernel/debug

# UFS Auto-Hibern8
echo <value_in_us> > /sys/devices/platform/soc@0/1d84000.ufs/auto_hibern8

# UFS Clock Gating
echo 0 > /sys/devices/platform/soc@0/1d84000.ufs/clkgate_enable  # Disable
echo 1 > /sys/devices/platform/soc@0/1d84000.ufs/clkgate_enable  # Enable

故障排查

设备中有待处理命令

症状： ufshcd_abort: cmd pending in the device联系 UFS 器件供应商；检查器件兼容性和供电稳定性。

设备无响应

症状： ufshcd_abort: no response from device, err -110检查物理连接、验证电源轨、检查 PHY 初始化。

物理适配层 / 数据链路错误

mount -t debugfs none /sys/kernel/debug
cat /sys/kernel/debug/ufshcd/1d84000.ufs/stats

表明信号质量差。检查 PCB 布局和 PHY 设置。

未处理的 SMMU 故障

在 SoC DTSI 文件的 ufshc_mem 节点中，将：

qcom,iommu-dma = "fastmap";

改为：

qcom,iommu-dma = "bypass";

命令参考

UFS 命令

用途	命令
查看 PA/DL 错误计数	`cat /sys/kernel/debug/ufshcd/1d84000.ufs/stats`
读取当前时钟频率	`cat /sys/devices/platform/soc@0/1d84000.ufs/devfreq/1d84000.ufs/cur_freq`
读取设备状态	`cat /sys/devices/platform/soc@0/1d84000.ufs/power_info/dev_pm`
读取链路状态	`cat /sys/devices/platform/soc@0/1d84000.ufs/power_info/link_state`
读取运行时状态	`cat /sys/devices/platform/soc@0/1d84000.ufs/power/runtime_status`

eMMC 命令

用途	命令
错误统计	`cat /sys/kernel/debug/mmc0/err_stats`
当前时钟	`cat /sys/kernel/debug/mmc0/clock`
运行时状态	`cat /sys/devices/platform/soc@0/87c4000/power/runtime_status`

对于 IQ-8275，eMMC 地址为 87c4000。

参考资料

EXT4 文件系统介绍

​UFS 存储

​特性

​电源管理状态

​UFS 分区配置（Provisioning）

​架构图

​eMMC 存储

​特性

​设备树配置

​SD 卡存储

​NVMe 存储

​配置指南

​挂载文件系统

​电源管理控制

​故障排查

​命令参考

​UFS 命令

​eMMC 命令

​参考资料

UFS 存储

特性

电源管理状态

UFS 分区配置（Provisioning）

架构图

eMMC 存储

特性

设备树配置

SD 卡存储

NVMe 存储

配置指南

挂载文件系统

电源管理控制

故障排查

命令参考

UFS 命令

eMMC 命令

参考资料