Documentation/devicetree/bindings/usb/generic-ehci.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/usb/generic-ehci.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: USB EHCI Controller Device Tree Bindings
   8
   9 allOf:
  10   - $ref: "usb-hcd.yaml"
  11
  12 maintainers:
  13   - Greg Kroah-Hartman <gregkh@linuxfoundation.org>
  14
  15 properties:
  16   compatible:
  17     contains:
  18       const: generic-ehci
  19
  20   reg:
  21     maxItems: 1
  22
  23   interrupts:
  24     maxItems: 1
  25
  26   resets:
  27     minItems: 1
  28     maxItems: 4
  29
  30   clocks:
  31     minItems: 1
  32     maxItems: 4
  33     description: |
  34       In case the Renesas R-Car Gen3 SoCs:
  35         - if a host only channel: first clock should be host.
  36         - if a USB DRD channel: first clock should be host and second
  37           one should be peripheral
  38
  39   big-endian:
  40     $ref: /schemas/types.yaml#/definitions/flag
  41     description:
  42       Set this flag for HCDs with big endian descriptors and big
  43       endian registers.
  44
  45   big-endian-desc:
  46     $ref: /schemas/types.yaml#/definitions/flag
  47     description:
  48       Set this flag for HCDs with big endian descriptors.
  49
  50   big-endian-regs:
  51     $ref: /schemas/types.yaml#/definitions/flag
  52     description:
  53       Set this flag for HCDs with big endian registers.
  54
  55   has-transaction-translator:
  56     $ref: /schemas/types.yaml#/definitions/flag
  57     description:
  58       Set this flag if EHCI has a Transaction Translator built into
  59       the root hub.
  60
  61   needs-reset-on-resume:
  62     $ref: /schemas/types.yaml#/definitions/flag
  63     description:
  64       Set this flag to force EHCI reset after resume.
  65
  66   phys:
  67     description: PHY specifier for the USB PHY
  68
  69   phy-names:
  70     const: usb
  71
  72 required:
  73   - compatible
  74   - reg
  75   - interrupts
  76
  77 additionalProperties: false
  78
  79 examples:
  80   - |
  81     usb@e0000300 {
  82         compatible = "ibm,usb-ehci-440epx", "generic-ehci";
  83         interrupt-parent = <&UIC0>;
  84         interrupts = <0x1a 4>;
  85         reg = <0 0xe0000300 90 0 0xe0000390 70>;
  86         big-endian;
  87     };
  88
  89   - |
  90     ehci0: usb@1c14000 {
  91         compatible = "allwinner,sun4i-a10-ehci", "generic-ehci";
  92         reg = <0x01c14000 0x100>;
  93         interrupts = <39>;
  94         clocks = <&ahb_gates 1>;
  95         phys = <&usbphy 1>;
  96         phy-names = "usb";
  97     };
  98
  99 ...