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