272 lines · yaml
1# SPDX-License-Identifier: GPL-2.02%YAML 1.23---4$id: http://devicetree.org/schemas/usb/usb251xb.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: Microchip USB 2.0 Hi-Speed Hub Controller8 9maintainers:10 - Richard Leitner <richard.leitner@skidata.com>11 12properties:13 compatible:14 enum:15 - microchip,usb242216 - microchip,usb2512b17 - microchip,usb2512bi18 - microchip,usb2513b19 - microchip,usb2513bi20 - microchip,usb2514b21 - microchip,usb2514bi22 - microchip,usb251723 - microchip,usb2517i24 - microchip,usb251xb25 26 reg:27 maxItems: 128 29 reset-gpios:30 description: |31 Should specify the gpio for hub reset32 33 vdd-supply:34 description: |35 Should specify the phandle to the regulator supplying vdd36 37 skip-config:38 $ref: /schemas/types.yaml#/definitions/flag39 description: |40 Skip Hub configuration, but only send the USB-Attach command41 42 vendor-id:43 $ref: /schemas/types.yaml#/definitions/uint1644 default: 0x042445 description: |46 Set USB Vendor ID of the hub47 48 product-id:49 $ref: /schemas/types.yaml#/definitions/uint1650 description: |51 Set USB Product ID of the hub52 53 device-id:54 $ref: /schemas/types.yaml#/definitions/uint1655 default: 0x0bb356 description: |57 Set USB Device ID of the hub58 59 language-id:60 $ref: /schemas/types.yaml#/definitions/uint1661 default: 0x000062 description: |63 Set USB Language ID64 65 manufacturer:66 $ref: /schemas/types.yaml#/definitions/string67 description: |68 Set USB Manufacturer string (max 31 characters long)69 70 product:71 $ref: /schemas/types.yaml#/definitions/string72 description: |73 Set USB Product string (max 31 characters long)74 75 serial:76 $ref: /schemas/types.yaml#/definitions/string77 description: |78 Set USB Serial string (max 31 characters long)79 80 bus-powered:81 $ref: /schemas/types.yaml#/definitions/flag82 description: |83 selects between self- and bus-powered operation84 (boolean, default is self-powered)85 86 self-powered:87 $ref: /schemas/types.yaml#/definitions/flag88 description: |89 selects between self- and bus-powered operation90 (boolean, default is self-powered)91 92 disable-hi-speed:93 $ref: /schemas/types.yaml#/definitions/flag94 description: |95 disable USB Hi-Speed support (boolean)96 97 multi-tt:98 $ref: /schemas/types.yaml#/definitions/flag99 description: |100 selects between multi- and single-transaction-translator101 (boolean, default is multi-tt)102 103 single-tt:104 $ref: /schemas/types.yaml#/definitions/flag105 description: |106 selects between multi- and single-transaction-translator107 (boolean, default is multi-tt)108 109 disable-eop:110 $ref: /schemas/types.yaml#/definitions/flag111 description: |112 disable End of Packet generation in full-speed mode (boolean)113 114 ganged-sensing:115 $ref: /schemas/types.yaml#/definitions/flag116 description: |117 select over-current sense type in self-powered mode118 (boolean, default is individual)119 120 individual-sensing:121 $ref: /schemas/types.yaml#/definitions/flag122 description: |123 select over-current sense type in self-powered mode124 (boolean, default is individual)125 126 ganged-port-switching:127 $ref: /schemas/types.yaml#/definitions/flag128 description: |129 select port power switching mode (boolean, default is individual)130 131 individual-port-switching:132 $ref: /schemas/types.yaml#/definitions/flag133 description: |134 select port power switching mode (boolean, default is individual)135 136 dynamic-power-switching:137 $ref: /schemas/types.yaml#/definitions/flag138 description: |139 enable auto-switching from self- to bus-powered operation if the140 local power source is removed or unavailable (boolean)141 142 oc-delay-us:143 enum: [100, 4000, 8000, 16000]144 default: 8000145 description: |146 Delay time (in microseconds) for filtering the over-current sense147 inputs. If an invalid value is given, the default is used instead.148 149 compound-device:150 $ref: /schemas/types.yaml#/definitions/flag151 description: |152 indicate the hub is part of a compound device (boolean)153 154 port-mapping-mode:155 $ref: /schemas/types.yaml#/definitions/flag156 description: |157 enable port mapping mode (boolean)158 159 led-usb-mode:160 $ref: /schemas/types.yaml#/definitions/flag161 description: |162 led usb/speed indication mode selection (boolean, default is speed mode)163 164 led-speed-mode:165 $ref: /schemas/types.yaml#/definitions/flag166 description: |167 led usb/speed indication mode selection (boolean, default is speed mode)168 169 string-support:170 $ref: /schemas/types.yaml#/definitions/flag171 description: |172 enable string descriptor support (required for manufacturer, product173 and serial string configuration)174 175 non-removable-ports:176 $ref: /schemas/types.yaml#/definitions/uint8-array177 description: |178 Should specify the ports which have a non-removable device connected.179 180 sp-disabled-ports:181 $ref: /schemas/types.yaml#/definitions/uint8-array182 description: |183 Specifies the ports which will be self-power disabled184 185 bp-disabled-ports:186 $ref: /schemas/types.yaml#/definitions/uint8-array187 description: |188 Specifies the ports which will be bus-power disabled189 190 sp-max-total-current-microamp:191 maximum: 100000192 default: 1000193 description: |194 Specifies max current consumed by the hub from VBUS when195 operating in self-powered hub. It includes the hub silicon196 along with all associated circuitry including a permanently197 attached peripheral.198 199 bp-max-total-current-microamp:200 maximum: 510000201 default: 100000202 description: |203 Specifies max current consumed by the hub from VBUS when204 operating in self-powered hub. It includes the hub silicon205 along with all associated circuitry including a permanently206 attached peripheral.207 208 sp-max-removable-current-microamp:209 maximum: 100000210 default: 1000211 description: |212 Specifies max current consumed by the hub from VBUS when213 operating in self-powered hub. It includes the hub silicon214 along with all associated circuitry excluding a permanently215 attached peripheral.216 217 bp-max-removable-current-microamp:218 maximum: 510000219 default: 100000220 description: |221 Specifies max current consumed by the hub from VBUS when222 operating in self-powered hub. It includes the hub silicon223 along with all associated circuitry excluding a permanently224 attached peripheral.225 226 power-on-time-ms:227 maximum: 510228 default: 100229 description: |230 Specifies the time it takes from the time the host initiates the231 power-on sequence to a port until the port has adequate power.232 233 swap-dx-lanes:234 $ref: /schemas/types.yaml#/definitions/uint32-array235 description: |236 Specifies the ports which will swap the differential-pair (D+/D-),237 default is not-swapped.238 239additionalProperties: false240 241required:242 - compatible243 - reg244 245examples:246 - |247 #include <dt-bindings/gpio/gpio.h>248 249 i2c {250 #address-cells = <1>;251 #size-cells = <0>;252 253 usb-hub@2c {254 compatible = "microchip,usb2512b";255 reg = <0x2c>;256 reset-gpios = <&gpio1 4 GPIO_ACTIVE_LOW>;257 };258 259 usb-hub@2d {260 compatible = "microchip,usb2514b";261 reg = <0x2d>;262 vendor-id = /bits/ 16 <0x0000>;263 product-id = /bits/ 16 <0x0000>;264 string-support;265 manufacturer = "Foo";266 product = "Foo-Bar";267 serial = "1234567890A";268 /* correct misplaced usb connectors on port 1,2 */269 swap-dx-lanes = <1 2>;270 };271 };272