Documentation/devicetree/bindings/usb/maxim,max3421.yaml

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

title: MAXIM MAX3421e USB Peripheral/Host Controller

maintainers:
  - David Mosberger <davidm@egauge.net>

description: |
  The controller provides USB2.0 compliant with Full Speed or Low Speed when in
  the host mode. At peripheral, it operates at Full Speed. At both cases, it
  uses a SPI interface.
  Datasheet at:
    https://www.analog.com/media/en/technical-documentation/data-sheets/max3421e.pdf

properties:
  compatible:
    const: maxim,max3421

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  spi-max-frequency:
    maximum: 26000000

  maxim,vbus-en-pin:
    $ref: /schemas/types.yaml#/definitions/uint32-array
    description:
      One of eight GPOUT pins to control external VBUS power and the polarity
      of the active level. It's an array of GPIO number and the active level of it.
    minItems: 2
    maxItems: 2

required:
  - compatible
  - reg
  - interrupts
  - maxim,vbus-en-pin

allOf:
  - $ref: /schemas/spi/spi-peripheral-props.yaml#

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/gpio/gpio.h>
    #include <dt-bindings/interrupt-controller/irq.h>
    spi {
        #address-cells = <1>;
        #size-cells = <0>;

        usb@0 {
          compatible = "maxim,max3421";
          reg = <0>;
          maxim,vbus-en-pin = <3 1>;
          spi-max-frequency = <26000000>;
          interrupt-parent = <&gpio>;
          interrupts = <42>;
        };
    };