> ## 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.

# 配置 UFS Linux 内核设备树

SoC DTSI 节点指定寄存器地址空间、时钟、中断和复位信息。平台 DTSI 节点指定电源、电压和电流级别。

描述片上 UFS 设备主机控制器的 `Ufs_mem_hc` 节点通常位于 SoC DTSI 文件中。例如 `<workspace_root_path>/sources/kernel/kernel_platform/kernel/arch/arm64/boot/dts/qcom/sc7280.dtsi`。

关于 Dragonwing IQ-9075 中的 `Ufs_mem_hc` 节点，请参见 `<workspace_root_path>/sources/kernel/kernel_platform/kernel/arch/arm64/boot/dts/qcom/sa8775p.dtsi`。

<Note>
  这些参数仅供参考。请勿更改。
</Note>

| 属性 | 描述 |
| - | - |
| `Compatible` | Qualcomm SoC 必须包含诸如 `qcom`、`ufshc` 之类的字符串。 |
| `Interrupts` | UFS 主机控制器 IRQ 的中断映射。 |
| `Reg` | UFS 主机寄存器地址映射。 |
| `Phys` | 指向 UFS 设备 PHY 节点的 `phandle`。 |
| `lanes-per-direction` | 指定每个方向可用的通道数量。取值为 1 或 2。 |
| `clock-names` | 时钟输入名称字符串列表。 |
| `Clocks` | `phandle` 和时钟说明符对的列表。 |
| `freq-table-hz` | 以与 clocks 属性相同的顺序存储的 \<最小 最大> 工作频率数组。 |
| `reset-gpios` | 表示所连接 GPIO 的 `phandle` 和 GPIO 说明符。 |
| `Resets` | 复位节点寄存器。 |

`Ufs_mem_phy` 节点描述片上 UFS 设备 PHY 硬件，通常位于 SoC DTSI 文件中。例如 `<workspace_root_path>/sources/kernel/kernel_platform/kernel/arch/arm64/boot/dts/qcom/sc7280.dtsi` 文件。

| 属性 | 描述 |
| - | - |
| `Compatible` | 指定兼容字符串，例如 `qcom`、`qmp-ufs-phy`。 |
| `#phy-cells` | 将该属性设置为 0。 |
| `Reg` | 应包含 PHY 寄存器地址空间。 |
| `reg-names` | 按名称指示传递给驱动程序的各种资源（通过 reg 属性）。所需的 `reg-names` 为 `phy_mem`。 |
| `lanes-per-direction` | 每个方向可用的通道数量；取值为 1 或 2。 |
| `clock-names` | 时钟输入名称字符串列表。 |
| `clocks` | phandle 和时钟说明符对的列表。 |
| `vdda-phy-supply` | 指向模拟域主 PHY 电源的 `phandle`。 |
| `vdda-pll-supply` | 指向 PHY PLL 和 Power-Gen 模块电源的 `phandle`。 |
| `Resets` | 指定 UFS 设备控制器中的 PHY 复位。 |

有关 DTS 参数的更多信息，请参见 `/kernel_platform/msm-kernel/Documentation/devicetree/bindings/ufs/qcom,ufs.yaml`。