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