USBPHYC device tree configuration

Article purpose

本文介绍了将USBPHYC internal peripheral 分配给 Linux^® 时如何配置。 在这种情况下，它由PHY framework控制。

使用 device tree机制执行配置。

“USBPHYC Linux驱动程序” 它将相关信息注册在 PHY framework中。

DT bindings documentation

“ USBPHYC设备树绑定” 描述了所有必需和可选功能。

USBPHYC
      |_ PLL
      |
      |_ PHY port#1 _________________ HOST controller
      |                    _                 |
      |                  / 1|________________|
      |_ PHY port#2 ----|   |________________
      |                  \_0|                |
      |_ UTMI switch_______|          OTG controller

DT configuration

该硬件描述是“STM32微处理器”设备树文件（扩展名为.dtsi）和“板子”设备树文件（扩展名为.dts）的组合。 有关设备树文件分割的说明，请参见 Device tree。

STM32CubeMX可用于生成板卡设备树。 有关更多详细信息，请参考 How to configure the DT using STM32CubeMX 。

DT configuration (STM32 level)

USBPHYC节点在stm32mp157c.dtsi中声明。

• 根节点 usbphyc描述了USBPHYC硬件模块的参数，例如寄存器，时钟，复位和电源。
• 子节点，例如 usbphyc_port0和usbphyc_port1描述了两个高速PHY端口：“端口＃1”和“端口＃2”。

usbphyc: usbphyc@address {
	compatible = "st,stm32mp1-usbphyc";
	...                                         /* usbphyc resources: registers, clocks, resets and supplies */
	usbphyc_port0: usb-phy@0 {
		...                                 /* usbphyc HS PHY port#1 */
	};
	usbphyc_port1: usb-phy@1 {
		...                                 /* usbphyc HS PHY port#2 */
	};
};

该设备树部分与STM32微处理器有关。它必须保持原样，而不能由最终用户修改。

DT configuration (board level)

请按照以下章节中描述的顺序在板上配置和启用USBPHYC。

' usbphyc' 根节点必须填写：

• 通过设置status =“ okay”。来启用USBPHYC模块。
• 通过设置vdd3v3-supply = <＆your_regulator>来配置USBPHYC 3V3稳压器Regulator overview</ref>。

USB HS PHY端口需要在VDD3V3_USBHS引脚上提供外部3V3电源。

可以调整每个端口的“子节点”：

• 可选：创建一个usb_phy_tuning节点，该节点可以在DT根文件夹（'/'）中采用可选参数
• 可选：在 usbphyc_port0和/或 usbphyc_port1节点中添加st，phy-tuning = <＆usb_phy_tuning>以使用此调整。

可能有必要调整phy设置以补偿寄生效应，这可能是由于USB连接器/插座，布线，ESD保护组件引起的。 ``USBPHYC设备树绑定中提供了可选的调整参数列表.

DT configuration example

以下示例显示了如何在板文件中启用和配置USBPHYC端口

&usbphyc {
	vdd3v3-supply = <&vdd_usb>;                 /* references the 3V3 voltage regulator on the user board */
	status = "okay";                            /* enable USB HS PHY controller */
};

&usbphyc_port0 {
	st,phy-tuning = <&usb_phy_tuning>;          /* Optional USB HS PHY port#1 tuning */
};

&usbphyc_port1 {
	st,phy-tuning = <&usb_phy_tuning>;          /* Optional USB HS PHY port#2 tuning */
};

/ {                                                 /* Optional USB HS PHY tuning example, to be added in DT root node, e.g. '/' */
	usb_phy_tuning: usb-phy-tuning {
		st,current-boost = <2>;
		st,no-lfs-fb-cap;
		st,hs-dc-level = <2>;
		st,hs-rftime-reduction;
		st,hs-current-trim = <5>;
		st,hs-impedance-trim = <0>;
		st,squelch-level = <1>;
		st,no-hs-ftime-ctrl;
		st,hs-tx-staggering;
	};
};

UTMI开关的静态配置将'“端口＃2”'分配给USBH or OTG ，这是通过PHY用户节点: 请参阅 USBH_device_tree_configuration 请参阅 OTG_device_tree_configuration usbphyc_port1用户必须为UTMI开关配置其他说明符：0以选择OTG，1以选择USBH

配置要分配给USBH的端口#2的示例摘要：

&usbh_ehci {
	phys = <&usbphyc_port0>, <&usbphyc_port1 1>; /* 1: UTMI switch selects the USBH */
	phy-names = "usb", "usb";
	...
}

将端口2分配给OTG的示例摘要：

&usbotg_hs {
	phys = <&usbphyc_port1 0>;                  /* 0: UTMI switch selects the OTG */
	phy-names = "usb2-phy";
	...
}

How to configure the DT using STM32CubeMX

STM32CubeMX工具可用于配置STM32MPU设备并获取相应的platform configuration device tree 文件。
STM32CubeMX可能不支持以上 DT bindings documentation段中描述的所有属性。 如果是这样，该工具会在生成的设备树中插入用户部分。 然后可以编辑这些部分以添加一些属性，并将它们一代一代地保留下来。 有关更多信息，请参见 STM32CubeMX用户手册。

References

Please refer to the following links for additional information:

<securetransclude src="ProtectedTemplate:PublicationRequestId" params="10329 | 2019-01-15 | AlainF"></securetransclude> <securetransclude src="ProtectedTemplate:ArticleBasedOnModel" params="Peripheral or framework device tree configuration model"></securetransclude>