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