> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 sysfs 或 debugfs 节点调试

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

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

```bash theme={null}
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 设备状态（active 或 sleep）              | `cat /sys/devices/platform/soc@0/1d84000.ufshc/power_info/dev_pm`                                               |
| 读取 UFS 设备 gear 信息，例如 HS\_GEAR3、HS\_GEAR4 | `cat /sys/devices/platform/soc@0/1d84000.ufshc/power_info/gear`                                                 |
| 读取 UFS 设备 lane 数量                        | `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 信息，例如 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 设备运行时状态信息（active 或 suspended）     | `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 卡状态信息                       | 命令                                                                           |
| ---------------------------------- | ---------------------------------------------------------------------------- |
| 读取 SD 卡错误统计信息                      | `cat /sys/kernel/debug/mmc1/err_stats`                                       |
| 读取 SD 卡最新错误状态详情                    | `cat /sys/kernel/debug/mmc1/err_state`                                       |
| 检查当前运行时钟详情                         | `cat /sys/kernel/debug/mmc1/clock`                                           |
| 读取 SD 卡运行时状态信息（active 或 suspended） | `cat /sys/devices/platform/soc@0/87c4000.sdhci/power/runtime_status`         |
| 读取 SD 卡自动挂起延迟时间                    | `cat /sys/devices/platform/soc@0/87c4000.sdhci/power/autosuspend_delay_ms`   |
| 读取 SD 卡运行时活动时间                     | `cat /sys/devices/platform/soc@0/87c4000.sdhci/power/runtime_active_time`    |
| 读取 SD 卡运行时挂起时间                     | `cat /sys/devices/platform/soc@0/87c4000.sdhci/power/runtime_suspended_time` |
| 读取 SD 卡 uevent 详情                  | `cat /sys/devices/platform/soc@0/87c4000.sdhci/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 运行时状态信息   | `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`                       |

<Note>
  请根据芯片产品的 SDHCI 物理地址更新 `<sdhc1_address>` 的值。

  示例：

  * Qualcomm Dragonwing™ IQ-615：`7c4000`
  * Qualcomm Dragonwing™ IQ-8275：`87c4000`
  * Qualcomm Dragonwing™ IQ-9075：`7c4000`
</Note>