xref: /linux/Documentation/devicetree/bindings/usb/usb.yaml (revision a1c3be890440a1769ed6f822376a3e3ab0d42994)
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/usb/usb.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Generic USB Controller Device Tree Bindings
8
9maintainers:
10  - Greg Kroah-Hartman <gregkh@linuxfoundation.org>
11
12select: false
13
14properties:
15  $nodename:
16    pattern: "^usb(@.*)?"
17
18  phys:
19    $ref: /schemas/types.yaml#/definitions/phandle-array
20    description:
21      List of all the USB PHYs on this HCD
22
23  phy-names:
24    description:
25      Name specifier for the USB PHY
26
27  usb-phy:
28    $ref: /schemas/types.yaml#/definitions/phandle-array
29    description:
30      List of all the USB PHYs on this HCD to be accepted by the legacy USB
31      Physical Layer subsystem.
32    deprecated: true
33
34  phy_type:
35    description:
36      Tells USB controllers that we want to configure the core to support a
37      UTMI+ PHY with an 8- or 16-bit interface if UTMI+ is selected, UTMI+ low
38      pin interface if ULPI is specified, Serial core/PHY interconnect if
39      serial is specified and High-Speed Inter-Chip feature if HSIC is
40      selected. In case this isn't passed via DT, USB controllers should
41      default to HW capability.
42    $ref: /schemas/types.yaml#/definitions/string
43    enum: [utmi, utmi_wide, ulpi, serial, hsic]
44
45  maximum-speed:
46    description:
47      Tells USB controllers we want to work up to a certain speed. In case this
48      isn't passed via DT, USB controllers should default to their maximum HW
49      capability.
50    $ref: /schemas/types.yaml#/definitions/string
51    enum:
52      - low-speed
53      - full-speed
54      - high-speed
55      - super-speed
56      - super-speed-plus
57      - super-speed-plus-gen2x1
58      - super-speed-plus-gen1x2
59      - super-speed-plus-gen2x2
60
61additionalProperties: true
62
63...
64