# 使用 sysfs 或 debugfs 节点进行调试

要识别状态或更新状态，请使用 `sysfs` 和 `debugfs` 节点。

挂载 `debugfs` 以确保调试节点可以访问 `debugfs` 文件系统。

> 
> 
> mount -t debugfs none /sys/kernel/debug
>     Copy to clipboard

UFS 设备状态命令

| 所需的 UFS 设备状态信息 | 命令 |
| --- | --- |
| 检查 PA/DL 错误计数 | `cat /sys/kernel/debug/ufshcd/1d84000.ufs/stats` |
| 读取 UFS 设备门控延迟，单位为 ms | `cat /sys/devices/platform/soc@0/1d84000.ufs/clkgate_delay_ms` |
| 读取 UFS 设备时钟在给定点的当前频率 | `cat /sys/devices/platform/soc@0/1d84000.ufs/devfreq/1d84000.ufs/cur_freq` |
| 读取 UFS 设备 I/O 调度程序详细信息 | `cat /sys/devices/platform/soc@0/1d84000.ufs/devfreq/1d84000.ufs/governor` |
| 读取时钟降低期间的 UFS 设备最小频率 | `cat /sys/devices/platform/soc@0/1d84000.ufs/devfreq/1d84000.ufs/min_freq` |
| 读取时钟增加期间的 UFS 设备最大频率 | `cat /sys/devices/platform/soc@0/1d84000.ufs/devfreq/1d84000.ufs/max_freq` |
| 读取 UFS 设备状态 ACTIVE 或 SLEEP | `cat /sys/devices/platform/soc@0/1d84000.ufs/power_info/dev_pm` |
| 读取 UFS 设备档位信息，例如 HS\_G3、HS\_G4 | `cat /sys/devices/platform/soc@0/1d84000.ufs/power_info/gear` |
| 读取 UFS 设备通道数 | `cat /sys/devices/platform/soc@0/1d84000.ufs/power_info/lane` |
| 读取 UFS 设备链路状态，例如 ACTIVE 或 HIBERN8 | `cat /sys/devices/platform/soc@0/1d84000.ufs/power_info/link_state` |
| 读取 UFS 设备速率信息，例如 Rate A 或 B | `cat /sys/devices/platform/soc@0/1d84000.ufs/power_info/rate` |
| 读取 UFS 设备描述符信息 | `ls /sys/devices/platform/soc@0/1d84000.ufs/device_descriptor` |
| 读取 UFS 设备健康描述符信息 | `ls /sys/devices/platform/soc@0/1d84000.ufs/health_descriptor` |
| 读取 UFS 设备处于活动状态或 suspend 状态下的 runtime 状态信息。 | `cat /sys/devices/platform/soc@0/1d84000.ufs/power/runtime_status` |
| 查找和/或修改 SPM/RPM 级别 | `cat /sys/devices/platform/soc@0/1d84000.ufs/rpm_lvl`<br><br><br>`cat /sys/devices/platform/soc@0/1d84000.ufs/spm_lvl` |

SD 卡状态命令

| 所需的 SD 卡状态信息 | 命令 |
| --- | --- |
| 读取 SD 卡错误统计信息 | `cat /sys/kernel/debug/mmc1/err_stats` |
| 读取 SD 卡最新错误状态详情 | `cat /sys/kernel/debug/mmc1/err_state` |
| 检查当前运行时钟的详细信息 | `cat /sys/kernel/debug/mmc1/clock` |
| 读取 SD 卡 runtime 状态信息（active 或 suspend） | `cat /sys/devices/platform/soc@0/8804000.mmc/power/runtime_status` |
| 读取 SD 卡自动 suspend 延迟时间 | `cat /sys/devices/platform/soc@0/8804000.mmc/power/autosuspend_delay_ms` |
| 读取 SD 卡 runtime active 时间 | `cat /sys/devices/platform/soc@0/8804000.mmc/power/runtime_active_time` |
| 读取 SD 卡 runtime suspend 时间 | `cat /sys/devices/platform/soc@0/8804000.mmc/power/runtime_suspended_time` |
| 读取 SD 卡 uevent 详细信息 | `cat /sys/devices/platform/soc@0/8804000.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 节点命令

| 说明 | 命令 |
| --- | --- |
| eMMC 错误统计信息 | `cat /sys/kernel/debug/mmc0/err_stats` |
| eMMC 最新错误状态详细信息 | `cat /sys/kernel/debug/mmc0/err_state` |
| eMMC 当前运行时钟详细信息 | `cat /sys/kernel/debug/mmc0/clock` |
| eMMC runtime 状态信息 | `cat /sys/devices/platform/soc@0/<sdhc1_address>/power/runtime_status` |
| eMMC 自动挂起延迟时间 | `cat /sys/devices/platform/soc@0/<sdhc1_address>/power/autosuspend_delay_ms` |
| eMMC runtime 活动时间 | `cat /sys/devices/platform/soc@0/<sdhc1_address>/power/runtime_active_time` |
| eMMC runtime 挂起时间 | `cat /sys/devices/platform/soc@0/<sdhc1_address>/power/runtime_suspended_time` |
| eMMC uevent 详细信息 | `cat /sys/devices/platform/soc@0/<sdhc1_address>/uevent` |

Note

对于以下芯片产品，使用相应的 `<sdhc1_address>` 值：

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

Last Published: Jul 23, 2025

[Previous Topic
UFS 设备问题](https://docs.qualcomm.com/bundle/publicresource/80-70020-6SC/topics/ufs-debugging.md) [Next Topic
参考资料](https://docs.qualcomm.com/bundle/publicresource/80-70020-6SC/topics/references.md)