> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.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 设备状态（活动或休眠） | `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 主机控制器实例编号及其物理地址。

1. 枚举 MMC 主机控制器。

   ```bash theme={null}
   ls -l /sys/class/mmc_host
   ```

2. 确定 MMC 物理地址。

   ```bash theme={null}
   readlink -f /sys/class/mmc_host/mmc*
   ```

| 所需的 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 节点命令

| 描述 | 命令 |
| - | - |
| 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 物理地址更新 `<sdhci_address>` 值。

  示例：

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