NXP i.MX8QM SoC USB Controller

NXP i.MX8QM USB3 controller

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 schema는 NXP i.MX8QM SoC USB controller를 정의합니다. 저작권자는 NXP, 관리자는 Frank Li입니다.

Platform register와 다섯 clock

`compatible`은 `fsl,imx8qm-usb3`입니다. `reg`는 i.MX USB3 Platform Control register set 하나를 기술합니다. address cell과 size cell 수는 각각 1 또는 2이며 `ranges`를 허용합니다.

clock은 다섯 개입니다. `lpm`은 ultra-low-power state에서 쓰는 standby clock, `bus`는 USB3 controller bus clock, `aclk`는 AXI interface clock, `ipg`는 register access clock, `core`는 USB3 controller core clock입니다.

power domain은 최대 하나입니다.

properties:
  compatible:
    const: fsl,imx8qm-usb3

  reg:
    items:
      - description: Register set for iMX USB3 Platform Control

  "#address-cells":
    enum: [ 1, 2 ]

  "#size-cells":
    enum: [ 1, 2 ]

  ranges: true

  clocks:
    items:
      - description: Standby clock. Used during ultra low power states.
      - description: USB bus clock for usb3 controller.
      - description: AXI clock for AXI interface.
      - description: ipg clock for register access.
      - description: Core clock for usb3 controller.

  clock-names:
    items:
      - const: lpm
      - const: bus
      - const: aclk
      - const: ipg
      - const: core

  power-domains:
    maxItems: 1

Cadence USB3 child와 필수 속성

16진 주소를 이름에 넣은 `usb@...` child node는 `cdns,usb3.yaml`을 따라야 합니다.

필수 속성은 `compatible`, `reg`, `#address-cells`, `#size-cells`, `ranges`, `clocks`, `clock-names`, `power-domains`입니다. 정의되지 않은 추가 속성은 허용하지 않습니다.

# Required child node:

patternProperties:
  "^usb@[0-9a-f]+$":
    $ref: cdns,usb3.yaml#

required:
  - compatible
  - reg
  - "#address-cells"
  - "#size-cells"
  - ranges
  - clocks
  - clock-names
  - power-domains

additionalProperties: false

i.MX8QM wrapper와 Cadence core 예제

예제 wrapper `usb@5b110000`은 0x10000-byte register 영역과 LPCG의 `lpm`·`bus`·`aclk`·`ipg`·`core` clock을 사용합니다. master bus clock은 250 MHz로 할당하고 USB 2 power domain을 연결합니다.

child `usb@5b120000`은 OTG/DRD, HOST, DEVICE용 0x10000-byte register 영역 세 개를 `otg`, `xhci`, `dev` 이름으로 지정합니다.

host, peripheral, otg, wakeup interrupt 네 개는 모두 level-high GIC SPI 271을 사용합니다. PHY는 `usb3_phy`, 이름은 `cdns3,usb3-phy`입니다.

examples:
  - |
    #include <dt-bindings/clock/imx8-lpcg.h>
    #include <dt-bindings/firmware/imx/rsrc.h>
    #include <dt-bindings/interrupt-controller/arm-gic.h>

    usb@5b110000 {
      compatible = "fsl,imx8qm-usb3";
      reg = <0x5b110000 0x10000>;
      ranges;
      clocks = <&usb3_lpcg IMX_LPCG_CLK_1>,
               <&usb3_lpcg IMX_LPCG_CLK_0>,
               <&usb3_lpcg IMX_LPCG_CLK_7>,
               <&usb3_lpcg IMX_LPCG_CLK_4>,
               <&usb3_lpcg IMX_LPCG_CLK_5>;
      clock-names = "lpm", "bus", "aclk", "ipg", "core";
      assigned-clocks = <&clk IMX_SC_R_USB_2 IMX_SC_PM_CLK_MST_BUS>;
      assigned-clock-rates = <250000000>;
      power-domains = <&pd IMX_SC_R_USB_2>;
      #address-cells = <1>;
      #size-cells = <1>;

      usb@5b120000 {
        compatible = "cdns,usb3";
        reg = <0x5b120000 0x10000>,   /* memory area for OTG/DRD registers */
              <0x5b130000 0x10000>,   /* memory area for HOST registers */
              <0x5b140000 0x10000>;   /* memory area for DEVICE registers */
        reg-names = "otg", "xhci", "dev";
        interrupt-parent = <&gic>;
        interrupts = <GIC_SPI 271 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 271 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 271 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 271 IRQ_TYPE_LEVEL_HIGH>;
        interrupt-names = "host", "peripheral", "otg", "wakeup";
        phys = <&usb3_phy>;
        phy-names = "cdns3,usb3-phy";
      };
    };