2023-08-30 17:31:07 +02:00
|
|
|
# SPDX-License-Identifier: GPL-2.0
|
|
|
|
|
%YAML 1.2
|
|
|
|
|
---
|
|
|
|
|
$id: http://devicetree.org/schemas/usb/usb251xb.yaml#
|
|
|
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
|
|
|
|
|
|
title: Microchip USB 2.0 Hi-Speed Hub Controller
|
|
|
|
|
|
|
|
|
|
maintainers:
|
|
|
|
|
- Richard Leitner <richard.leitner@skidata.com>
|
|
|
|
|
|
|
|
|
|
properties:
|
|
|
|
|
compatible:
|
|
|
|
|
enum:
|
|
|
|
|
- microchip,usb2422
|
|
|
|
|
- microchip,usb2512b
|
|
|
|
|
- microchip,usb2512bi
|
|
|
|
|
- microchip,usb2513b
|
|
|
|
|
- microchip,usb2513bi
|
|
|
|
|
- microchip,usb2514b
|
|
|
|
|
- microchip,usb2514bi
|
|
|
|
|
- microchip,usb2517
|
|
|
|
|
- microchip,usb2517i
|
|
|
|
|
- microchip,usb251xb
|
|
|
|
|
|
|
|
|
|
reg:
|
|
|
|
|
maxItems: 1
|
|
|
|
|
|
|
|
|
|
reset-gpios:
|
|
|
|
|
description: |
|
|
|
|
|
Should specify the gpio for hub reset
|
|
|
|
|
|
|
|
|
|
vdd-supply:
|
|
|
|
|
description: |
|
|
|
|
|
Should specify the phandle to the regulator supplying vdd
|
|
|
|
|
|
|
|
|
|
skip-config:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
Skip Hub configuration, but only send the USB-Attach command
|
|
|
|
|
|
|
|
|
|
vendor-id:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/uint16
|
|
|
|
|
default: 0x0424
|
|
|
|
|
description: |
|
|
|
|
|
Set USB Vendor ID of the hub
|
|
|
|
|
|
|
|
|
|
product-id:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/uint16
|
|
|
|
|
description: |
|
|
|
|
|
Set USB Product ID of the hub
|
|
|
|
|
|
|
|
|
|
device-id:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/uint16
|
|
|
|
|
default: 0x0bb3
|
|
|
|
|
description: |
|
|
|
|
|
Set USB Device ID of the hub
|
|
|
|
|
|
|
|
|
|
language-id:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/uint16
|
|
|
|
|
default: 0x0000
|
|
|
|
|
description: |
|
|
|
|
|
Set USB Language ID
|
|
|
|
|
|
|
|
|
|
manufacturer:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
|
|
|
description: |
|
|
|
|
|
Set USB Manufacturer string (max 31 characters long)
|
|
|
|
|
|
|
|
|
|
product:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
|
|
|
description: |
|
|
|
|
|
Set USB Product string (max 31 characters long)
|
|
|
|
|
|
|
|
|
|
serial:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
|
|
|
description: |
|
|
|
|
|
Set USB Serial string (max 31 characters long)
|
|
|
|
|
|
|
|
|
|
bus-powered:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
selects between self- and bus-powered operation
|
|
|
|
|
(boolean, default is self-powered)
|
|
|
|
|
|
|
|
|
|
self-powered:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
selects between self- and bus-powered operation
|
|
|
|
|
(boolean, default is self-powered)
|
|
|
|
|
|
|
|
|
|
disable-hi-speed:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
disable USB Hi-Speed support (boolean)
|
|
|
|
|
|
|
|
|
|
multi-tt:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
selects between multi- and single-transaction-translator
|
|
|
|
|
(boolean, default is multi-tt)
|
|
|
|
|
|
|
|
|
|
single-tt:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
selects between multi- and single-transaction-translator
|
|
|
|
|
(boolean, default is multi-tt)
|
|
|
|
|
|
|
|
|
|
disable-eop:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
disable End of Packet generation in full-speed mode (boolean)
|
|
|
|
|
|
|
|
|
|
ganged-sensing:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
select over-current sense type in self-powered mode
|
|
|
|
|
(boolean, default is individual)
|
|
|
|
|
|
|
|
|
|
individual-sensing:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
select over-current sense type in self-powered mode
|
|
|
|
|
(boolean, default is individual)
|
|
|
|
|
|
|
|
|
|
ganged-port-switching:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
select port power switching mode (boolean, default is individual)
|
|
|
|
|
|
|
|
|
|
individual-port-switching:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
select port power switching mode (boolean, default is individual)
|
|
|
|
|
|
|
|
|
|
dynamic-power-switching:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
enable auto-switching from self- to bus-powered operation if the
|
|
|
|
|
local power source is removed or unavailable (boolean)
|
|
|
|
|
|
|
|
|
|
oc-delay-us:
|
|
|
|
|
enum: [100, 4000, 8000, 16000]
|
|
|
|
|
default: 8000
|
|
|
|
|
description: |
|
|
|
|
|
Delay time (in microseconds) for filtering the over-current sense
|
|
|
|
|
inputs. If an invalid value is given, the default is used instead.
|
|
|
|
|
|
|
|
|
|
compound-device:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
indicate the hub is part of a compound device (boolean)
|
|
|
|
|
|
|
|
|
|
port-mapping-mode:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
enable port mapping mode (boolean)
|
|
|
|
|
|
|
|
|
|
led-usb-mode:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
led usb/speed indication mode selection (boolean, default is speed mode)
|
|
|
|
|
|
|
|
|
|
led-speed-mode:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
led usb/speed indication mode selection (boolean, default is speed mode)
|
|
|
|
|
|
|
|
|
|
string-support:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
|
description: |
|
|
|
|
|
enable string descriptor support (required for manufacturer, product
|
|
|
|
|
and serial string configuration)
|
|
|
|
|
|
|
|
|
|
non-removable-ports:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/uint8-array
|
|
|
|
|
description: |
|
|
|
|
|
Should specify the ports which have a non-removable device connected.
|
|
|
|
|
|
|
|
|
|
sp-disabled-ports:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/uint8-array
|
|
|
|
|
description: |
|
|
|
|
|
Specifies the ports which will be self-power disabled
|
|
|
|
|
|
|
|
|
|
bp-disabled-ports:
|
|
|
|
|
$ref: /schemas/types.yaml#/definitions/uint8-array
|
|
|
|
|
description: |
|
|
|
|
|
Specifies the ports which will be bus-power disabled
|
|
|
|
|
|
|
|
|
|
sp-max-total-current-microamp:
|
|
|
|
|
maximum: 100000
|
|
|
|
|
default: 1000
|
|
|
|
|
description: |
|
|
|
|
|
Specifies max current consumed by the hub from VBUS when
|
|
|
|
|
operating in self-powered hub. It includes the hub silicon
|
|
|
|
|
along with all associated circuitry including a permanently
|
|
|
|
|
attached peripheral.
|
|
|
|
|
|
|
|
|
|
bp-max-total-current-microamp:
|
|
|
|
|
maximum: 510000
|
|
|
|
|
default: 100000
|
|
|
|
|
description: |
|
|
|
|
|
Specifies max current consumed by the hub from VBUS when
|
|
|
|
|
operating in self-powered hub. It includes the hub silicon
|
|
|
|
|
along with all associated circuitry including a permanently
|
|
|
|
|
attached peripheral.
|
|
|
|
|
|
|
|
|
|
sp-max-removable-current-microamp:
|
|
|
|
|
maximum: 100000
|
|
|
|
|
default: 1000
|
|
|
|
|
description: |
|
|
|
|
|
Specifies max current consumed by the hub from VBUS when
|
|
|
|
|
operating in self-powered hub. It includes the hub silicon
|
|
|
|
|
along with all associated circuitry excluding a permanently
|
|
|
|
|
attached peripheral.
|
|
|
|
|
|
|
|
|
|
bp-max-removable-current-microamp:
|
|
|
|
|
maximum: 510000
|
|
|
|
|
default: 100000
|
|
|
|
|
description: |
|
|
|
|
|
Specifies max current consumed by the hub from VBUS when
|
|
|
|
|
operating in self-powered hub. It includes the hub silicon
|
|
|
|
|
along with all associated circuitry excluding a permanently
|
|
|
|
|
attached peripheral.
|
|
|
|
|
|
|
|
|
|
power-on-time-ms:
|
|
|
|
|
maximum: 510
|
|
|
|
|
default: 100
|
|
|
|
|
description: |
|
|
|
|
|
Specifies the time it takes from the time the host initiates the
|
|
|
|
|
power-on sequence to a port until the port has adequate power.
|
|
|
|
|
|
|
|
|
|
swap-dx-lanes:
|
2023-10-24 12:59:35 +02:00
|
|
|
$ref: /schemas/types.yaml#/definitions/uint32-array
|
2023-08-30 17:31:07 +02:00
|
|
|
description: |
|
|
|
|
|
Specifies the ports which will swap the differential-pair (D+/D-),
|
|
|
|
|
default is not-swapped.
|
|
|
|
|
|
|
|
|
|
additionalProperties: false
|
|
|
|
|
|
|
|
|
|
required:
|
|
|
|
|
- compatible
|
|
|
|
|
- reg
|
|
|
|
|
|
|
|
|
|
examples:
|
|
|
|
|
- |
|
|
|
|
|
#include <dt-bindings/gpio/gpio.h>
|
|
|
|
|
|
|
|
|
|
i2c {
|
|
|
|
|
#address-cells = <1>;
|
|
|
|
|
#size-cells = <0>;
|
|
|
|
|
|
|
|
|
|
usb-hub@2c {
|
|
|
|
|
compatible = "microchip,usb2512b";
|
|
|
|
|
reg = <0x2c>;
|
|
|
|
|
reset-gpios = <&gpio1 4 GPIO_ACTIVE_LOW>;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
usb-hub@2d {
|
|
|
|
|
compatible = "microchip,usb2514b";
|
|
|
|
|
reg = <0x2d>;
|
|
|
|
|
vendor-id = /bits/ 16 <0x0000>;
|
|
|
|
|
product-id = /bits/ 16 <0x0000>;
|
|
|
|
|
string-support;
|
|
|
|
|
manufacturer = "Foo";
|
|
|
|
|
product = "Foo-Bar";
|
|
|
|
|
serial = "1234567890A";
|
|
|
|
|
/* correct misplaced usb connectors on port 1,2 */
|
|
|
|
|
swap-dx-lanes = <1 2>;
|
|
|
|
|
};
|
|
|
|
|
};
|
