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

要识别状态或更新状态，请使用 <cite>sysfs</cite> 和 <cite>debugfs</cite> 节点。

挂载 <cite>debugfs</cite>，以确保调试节点可以访问 <cite>debugfs</cite> 文件系统。

> 
> 
> 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` |

Last Published: Apr 25, 2025

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