ST DWC3 Glue Logic

STiH407 DWC3 glue logic

이 문서는 `dwc3-st` driver의 매개변수를 설명합니다. 이 driver는 STiH407 기반 platform에서 DWC3 core를 구성하는 glue logic을 제어합니다.

Glue register, reset과 pin control

`compatible`은 `st,stih407-dwc3`이어야 합니다. `reg`에는 glue logic base address와 USB syscfg control register offset을 넣고, `reg-names`는 `reg-glue`, `syscfg-reg` 순서입니다. 원문 요구 사항의 `st,syscon`은 glue register를 포함하는 system configuration node의 phandle입니다.

`resets`에는 USB3 IP의 powerdown line과 softreset line을 위한 phandle·reset specifier 쌍 두 개가 필요하며 이름은 `powerdown`, `softreset`입니다. 관련 binding 경로는 `Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml`과 `Documentation/devicetree/bindings/reset/reset.txt`입니다.

`reg`를 가진 sub-node가 있으면 `#address-cells`와 `#size-cells`는 1입니다. 원문에 적힌 `pinctl-names`의 `default` state와 `pinctrl-0` pin control group이 필요합니다. `ranges`는 child와 parent address space 사이의 유효한 1:1 translation을 허용합니다.

Required properties:
 - compatible        : must be "st,stih407-dwc3"
 - reg                : glue logic base address and USB syscfg ctrl register offset
 - reg-names        : should be "reg-glue" and "syscfg-reg"
 - st,syscon        : should be phandle to system configuration node which
                  encompasses the glue registers
 - resets        : list of phandle and reset specifier pairs. There should be two entries, one
                  for the powerdown and softreset lines of the usb3 IP
 - reset-names        : list of reset signal names. Names should be "powerdown" and "softreset"
See: Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml
See: Documentation/devicetree/bindings/reset/reset.txt

 - #address-cells, #size-cells : should be '1' if the device has sub-nodes
   with 'reg' property

 - pinctl-names        : A pinctrl state named "default" must be defined
See: Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt

 - pinctrl-0        : Pin control group
See: Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt

 - ranges        : allows valid 1:1 translation between child's address space and
                  parent's address space

DWC3 sub-node와 필수 dr_mode

ST DWC3 glue 아래에는 예제처럼 DWC3 core를 sub-node로 추가해야 하며 상세 binding은 `Documentation/devicetree/bindings/usb/snps,dwc3.yaml`에 있습니다.

이 driver에서 `dr_mode`는 선택 사항이 아닙니다. 기본값 `otg`를 이 SoC가 지원하지 않으므로 `host` 또는 `device`를 명시해야 합니다. 이 속성의 공통 정의는 `Documentation/devicetree/bindings/usb/usb-drd.yaml`을 참조합니다.

ST glue와 host-mode core 예제

예제 glue node는 두 register 영역과 `reg-glue`·`syscfg-reg` 이름, system configuration phandle, powerdown·softreset 두 reset, default pinctrl, 빈 `ranges`를 설정합니다. 예제에는 요구 사항의 `st,syscon`과 달리 원문 그대로 `st,syscfg`가 쓰였습니다.

child DWC3 core는 `snps,dwc3`, 0x100000-byte register 영역, GIC SPI 155, host mode, USB2·USB3 PHY 두 개를 사용합니다.

Example:

st_dwc3: dwc3@8f94000 {
        compatible        = "st,stih407-dwc3";
        reg                = <0x08f94000 0x1000>, <0x110 0x4>;
        reg-names        = "reg-glue", "syscfg-reg";
        st,syscfg        = <&syscfg_core>;
        resets                = <&powerdown STIH407_USB3_POWERDOWN>,
                          <&softreset STIH407_MIPHY2_SOFTRESET>;
        reset-names        = "powerdown", "softreset";
        #address-cells        = <1>;
        #size-cells        = <1>;
        pinctrl-names        = "default";
        pinctrl-0        = <&pinctrl_usb3>;
        ranges;

        dwc3: dwc3@9900000 {
                compatible        = "snps,dwc3";
                reg                = <0x09900000 0x100000>;
                interrupts        = <GIC_SPI 155 IRQ_TYPE_NONE>;
                dr_mode                = "host";
                phy-names        = "usb2-phy", "usb3-phy";
                phys                = <&usb2_picophy2>, <&phy_port2 PHY_TYPE_USB3>;
        };
};