使用 sysfs 或 debugfs 节点进行调试

要识别状态或更新状态，请使用 sysfs 和 debugfs 节点。挂载 debugfs 以确保 debugfs 文件系统对调试节点可访问。

mount -t debugfs none /sys/kernel/debug

UFS 设备状态命令

所需的 UFS 设备状态信息	命令
检查 PA/DL 错误计数	`cat /sys/kernel/debug/ufshcd/1d84000.ufshc/stats`
读取 UFS 设备门控延迟（单位 ms）	`cat /sys/devices/platform/soc@0/1d84000.ufshc/clkgate_delay_ms`
读取 UFS 设备时钟在给定时刻的当前频率	`cat /sys/devices/platform/soc@0/1d84000.ufshc/devfreq/1d84000.ufshc/cur_freq`
读取 UFS 设备 I/O 调度器详细信息	`cat /sys/devices/platform/soc@0/1d84000.ufshc/devfreq/1d84000.ufshc/governor`
读取时钟下调期间 UFS 设备的最小频率	`cat /sys/devices/platform/soc@0/1d84000.ufshc/devfreq/1d84000.ufshc/min_freq`
读取时钟上调期间 UFS 设备的最大频率	`cat /sys/devices/platform/soc@0/1d84000.ufshc/devfreq/1d84000.ufshc/max_freq`
读取 UFS 设备状态（活动或休眠）	`cat /sys/devices/platform/soc@0/1d84000.ufshc/power_info/dev_pm`
读取 UFS 设备挡位信息，例如 HS_GEAR3、HS_GEAR4	`cat /sys/devices/platform/soc@0/1d84000.ufshc/power_info/gear`
读取 UFS 设备通道数量	`cat /sys/devices/platform/soc@0/1d84000.ufshc/power_info/lane`
读取 UFS 设备链路状态，ACTIVE 或 HIBERN8	`cat /sys/devices/platform/soc@0/1d84000.ufshc/power_info/link_state`
读取 UFS 设备速率信息，例如 Rate A 或 B	`cat /sys/devices/platform/soc@0/1d84000.ufshc/power_info/rate`
读取 UFS 设备描述符信息	`ls /sys/devices/platform/soc@0/1d84000.ufshc/device_descriptor`
读取 UFS 设备健康描述符信息	`ls /sys/devices/platform/soc@0/1d84000.ufshc/health_descriptor`
读取 UFS 设备运行时状态信息（活动或已挂起）	`cat /sys/devices/platform/soc@0/1d84000.ufshc/power/runtime_status`
查找和/或修改 SPM/RPM 级别	`cat /sys/devices/platform/soc@0/1d84000.ufshc/rpm_lvl` `cat /sys/devices/platform/soc@0/1d84000.ufshc/spm_lvl`

SD 卡状态命令

在运行 SD 卡状态命令之前，请先确定 MMC 主机控制器实例编号及其物理地址。

确定 MMC 实例编号

debugfs 路径（例如 /sys/kernel/debug/mmc1/err_stats）中使用的 mmc<N> 索引由 Linux 内核 MMC 子系统在启动时分配。该索引直接从板级设备树（DTSI/DTS）中的 aliases 节点读取。板级 DTSI 为每个 SDHCI 控制器分配固定索引：

/ {
    aliases {
        mmc0 = &sdhc_1;   /* eMMC controller  → /sys/kernel/debug/mmc0/ */
        mmc1 = &sdhc_2;   /* SD card controller → /sys/kernel/debug/mmc1/ */
    };
};

内核在探测时通过 mmc_alloc_host()（drivers/mmc/core/host.c）中的 of_alias_get_id(dev->of_node, "mmc") 读取此别名，并使用 dev_set_name(&host->class_dev, "mmc%d", index) 设置主机设备名称。该名称即成为 /sys/kernel/debug/ 下的 debugfs 目录。要在运行中的系统上验证 mmc<N> 索引：

枚举 MMC 主机控制器。
ls -l /sys/class/mmc_host
确定 MMC 物理地址。
readlink -f /sys/class/mmc_host/mmc*
通过检查符号链接目标确认索引。例如，如果 SD 卡 SDHCI 控制器的物理地址为 8804000，则步骤 2 的输出会在 mmc1 符号链接下显示包含 8804000.mmc 的路径，从而确认索引为 1。

mmc<N> 索引因平台而异，并在板级 DTSI 的 aliases 节点中定义。在使用以下 debugfs 命令之前，请务必验证目标平台的索引。

所需的 SD 卡状态信息	命令
读取 SD 卡错误统计信息	`cat /sys/kernel/debug/mmc1/err_stats`
读取 SD 卡最新错误状态详情	`cat /sys/kernel/debug/mmc1/err_state`
检查当前运行的时钟详情	`cat /sys/kernel/debug/mmc1/clock`
读取 SD 卡运行时状态信息（活动或已挂起）	`cat /sys/devices/platform/soc@0/<mmc_addr>.mmc/power/runtime_status`
读取 SD 卡自动挂起延迟时间	`cat /sys/devices/platform/soc@0/<mmc_addr>.mmc/power/autosuspend_delay_ms`
读取 SD 卡运行时活动时间	`cat /sys/devices/platform/soc@0/<mmc_addr>.mmc/power/runtime_active_time`
读取 SD 卡运行时挂起时间	`cat /sys/devices/platform/soc@0/<mmc_addr>.mmc/power/runtime_suspended_time`
读取 SD 卡 uevent 详情	`cat /sys/devices/platform/soc@0/<mmc_addr>.mmc/uevent`

NVMe 状态命令

所需的 NVMe 卡状态信息	命令
查看设备型号名称	`cat /sys/class/nvme/nvme0/model`
查看设备序列号	`cat /sys/class/nvme/nvme0/serial`
查看当前固件版本	`cat /sys/class/nvme/nvme0/firmware_rev`
查看命名空间标识符	`cat /sys/class/nvme/nvme0/nvme0n1/nsid`
查看命名空间大小	`cat /sys/class/nvme/nvme0/nvme0n1/size`
查看将 NVMe 命名空间起始位置对齐到最佳 I/O 边界的字节偏移量	`cat /sys/class/nvme/nvme0/nvme0n1/alignment_offset`
查看队列深度	`cat /sys/class/nvme/nvme0/queue_count`

eMMC 节点命令

/sys/kernel/debug/mmc0/ 中的 mmc0 索引由板级 DTSI 中的 aliases 节点分配，其中 mmc0 = &sdhc_1 将 eMMC SDHCI 控制器映射到索引 0。有关详细信息，请参见确定 MMC 实例编号。

描述	命令
eMMC 错误统计信息	`cat /sys/kernel/debug/mmc0/err_stats`
eMMC 最新错误状态详情	`cat /sys/kernel/debug/mmc0/err_state`
eMMC 当前运行的时钟详情	`cat /sys/kernel/debug/mmc0/clock`
eMMC 运行时状态信息	`cat /sys/devices/platform/soc@0/<sdhci_addr>.mmc/power/runtime_status`
eMMC 自动挂起延迟时间	`cat /sys/devices/platform/soc@0/<sdhci_addr>.mmc/power/autosuspend_delay_ms`
eMMC 运行时活动时间	`cat /sys/devices/platform/soc@0/<sdhci_addr>.mmc/power/runtime_active_time`
eMMC 运行时挂起时间	`cat /sys/devices/platform/soc@0/<sdhci_addr>.mmc/power/runtime_suspended_time`
eMMC uevent 详情	`cat /sys/devices/platform/soc@0/<sdhci_addr>.mmc/uevent`

根据芯片产品的 SDHCI 物理地址更新 <sdhci_addr> 值。示例：

Qualcomm Dragonwing™ IQ-615：7c4000
Qualcomm Dragonwing™ IQ-8275：87c4000
Qualcomm Dragonwing™ IQ-9075：7c4000

简介

架构

关键文档

技术

系统

发布说明

UFS 设备状态命令

SD 卡状态命令

确定 MMC 实例编号

NVMe 状态命令

eMMC 节点命令

简介

架构

关键文档

技术

系统

发布说明

​UFS 设备状态命令

​SD 卡状态命令

​确定 MMC 实例编号

​NVMe 状态命令

​eMMC 节点命令

UFS 设备状态命令

SD 卡状态命令

确定 MMC 实例编号

NVMe 状态命令

eMMC 节点命令