Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/phy/renesas,usb2-phy.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Renesas R-Car generation 3 USB 2.0 PHY
   8
   9 maintainers:
  10   - Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
  11
  12 properties:
  13   compatible:
  14     oneOf:
  15       - items:
  16           - const: renesas,usb2-phy-r8a77470 # RZ/G1C
  17
  18       - items:
  19           - enum:
  20               - renesas,usb2-phy-r7s9210  # RZ/A2
  21               - renesas,usb2-phy-r8a774a1 # RZ/G2M
  22               - renesas,usb2-phy-r8a774b1 # RZ/G2N
  23               - renesas,usb2-phy-r8a774c0 # RZ/G2E
  24               - renesas,usb2-phy-r8a774e1 # RZ/G2H
  25               - renesas,usb2-phy-r8a7795  # R-Car H3
  26               - renesas,usb2-phy-r8a7796  # R-Car M3-W
  27               - renesas,usb2-phy-r8a77961 # R-Car M3-W+
  28               - renesas,usb2-phy-r8a77965 # R-Car M3-N
  29               - renesas,usb2-phy-r8a77990 # R-Car E3
  30               - renesas,usb2-phy-r8a77995 # R-Car D3
  31           - const: renesas,rcar-gen3-usb2-phy
  32
  33   reg:
  34     maxItems: 1
  35
  36   clocks:
  37     minItems: 1
  38     maxItems: 2
  39
  40   clock-names:
  41     minItems: 1
  42     items:
  43       - const: fck
  44       - const: usb_x1
  45
  46   '#phy-cells':
  47     enum: [0, 1]  # and 0 is deprecated.
  48     description: |
  49       The phandle's argument in the PHY specifier is the INT_STATUS bit of
  50       controller.
  51       - 1 = USBH_INTA (OHCI)
  52       - 2 = USBH_INTB (EHCI)
  53       - 3 = UCOM_INT (OTG and BC)
  54
  55   interrupts:
  56     maxItems: 1
  57
  58   power-domains:
  59     maxItems: 1
  60
  61   resets:
  62     minItems: 1
  63     items:
  64       - description: reset of USB 2.0 host side
  65       - description: reset of USB 2.0 peripheral side
  66
  67   vbus-supply:
  68     description: |
  69       Phandle to a regulator that provides power to the VBUS. This regulator
  70       will be managed during the PHY power on/off sequence.
  71
  72   renesas,no-otg-pins:
  73     $ref: /schemas/types.yaml#/definitions/flag
  74     description: |
  75       specify when a board does not provide proper otg pins.
  76
  77   dr_mode: true
  78
  79 if:
  80   properties:
  81     compatible:
  82       contains:
  83         const: renesas,usb2-phy-r7s9210
  84 then:
  85   required:
  86     - clock-names
  87
  88 required:
  89   - compatible
  90   - reg
  91   - clocks
  92   - '#phy-cells'
  93
  94 additionalProperties: false
  95
  96 examples:
  97   - |
  98     #include <dt-bindings/clock/r8a7795-cpg-mssr.h>
  99     #include <dt-bindings/interrupt-controller/arm-gic.h>
 100     #include <dt-bindings/power/r8a7795-sysc.h>
 101
 102     usb-phy@ee080200 {
 103         compatible = "renesas,usb2-phy-r8a7795", "renesas,rcar-gen3-usb2-phy";
 104         reg = <0xee080200 0x700>;
 105         interrupts = <GIC_SPI 108 IRQ_TYPE_LEVEL_HIGH>;
 106         clocks = <&cpg CPG_MOD 703>;
 107         #phy-cells = <1>;
 108     };
 109
 110     usb-phy@ee0a0200 {
 111         compatible = "renesas,usb2-phy-r8a7795", "renesas,rcar-gen3-usb2-phy";
 112         reg = <0xee0a0200 0x700>;
 113         clocks = <&cpg CPG_MOD 702>;
 114         #phy-cells = <1>;
 115     };