xref: /freebsd/sys/contrib/device-tree/Bindings/usb/parade,ps5511.yaml (revision ae5de77ed78ae54d86cead5604869212e8008e6b)

# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/usb/parade,ps5511.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Parade PS5511 4+1 Port USB 3.2 Gen 1 Hub Controller

maintainers:
  - Pin-yen Lin <treapking@chromium.org>

properties:
  compatible:
    enum:
      - usb1da0,5511
      - usb1da0,55a1

  reset-gpios:
    items:
      - description: GPIO specifier for RESETB pin.

  vddd11-supply:
    description:
      1V1 power supply to the hub

  vdd33-supply:
    description:
      3V3 power supply to the hub

  peer-hub: true

  ports:
    $ref: /schemas/graph.yaml#/properties/ports

    patternProperties:
      '^port@':
        $ref: /schemas/graph.yaml#/properties/port

        properties:
          reg:
            minimum: 1
            maximum: 5

additionalProperties:
  properties:
    reg:
      minimum: 1
      maximum: 5

required:
  - peer-hub

allOf:
  - $ref: usb-hub.yaml#
  - if:
      not:
        properties:
          compatible:
            enum:
              - usb1da0,55a1
    then:
      properties:
        ports:
          properties:
            port@5: false

      patternProperties:
        '^.*@5$': false

examples:
  - |
    usb {
        #address-cells = <1>;
        #size-cells = <0>;

        /* 2.0 hub on port 1 */
        hub_2_0: hub@1 {
            compatible = "usb1da0,55a1";
            reg = <1>;
            peer-hub = <&hub_3_0>;
            #address-cells = <1>;
            #size-cells = <0>;
            /* USB 2.0 device on port 5 */
            device@5 {
                reg = <5>;
                compatible = "usb123,4567";
            };
        };

        /* 3.0 hub on port 2 */
        hub_3_0: hub@2 {
            compatible = "usb1da0,5511";
            reg = <2>;
            peer-hub = <&hub_2_0>;

            ports {
                #address-cells = <1>;
                #size-cells = <0>;
                /* Type-A connector on port 3 */
                port@3 {
                    reg = <3>;
                    endpoint {
                        remote-endpoint = <&usb_a0_ss>;
                    };
                };
            };
        };
    };