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

title: Atmel High-Speed USB Device Controller (USBA)

maintainers:
  - Nicolas Ferre <nicolas.ferre@microchip.com>
  - Alexandre Belloni <alexandre.belloni@bootlin.com>

description:
  The Atmel High-Speed USB Device Controller (USBA) provides USB 2.0
  high-speed gadget functionality on several Atmel and Microchip SoCs.
  The controller requires a peripheral clock and a host clock for operation
  and may optionally use a GPIO to detect VBUS presence.

properties:
  compatible:
    oneOf:
      - enum:
          - atmel,at91sam9rl-udc
          - atmel,at91sam9g45-udc
          - atmel,sama5d3-udc
      - items:
          - const: microchip,lan9662-udc
          - const: atmel,sama5d3-udc
      - const: microchip,sam9x60-udc

  reg:
    maxItems: 2

  interrupts:
    maxItems: 1

  clocks:
    maxItems: 2

  clock-names:
    minItems: 2
    maxItems: 2
    items:
      enum: [pclk, hclk]

  atmel,vbus-gpio:
    description: GPIO used to detect the presence of VBUS, indicating that
      the USB cable is connected.
    maxItems: 1

required:
  - compatible
  - reg
  - interrupts
  - clocks
  - clock-names

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>
    #include <dt-bindings/clock/at91.h>
    #include <dt-bindings/gpio/gpio.h>
    gadget@fff78000 {
        compatible = "atmel,at91sam9g45-udc";
        reg = <0x00600000 0x80000
               0xfff78000 0x400>;
        interrupts = <27 IRQ_TYPE_LEVEL_HIGH 0>;
        clocks = <&pmc PMC_TYPE_PERIPHERAL 27>, <&pmc PMC_TYPE_CORE PMC_UTMI>;
        clock-names = "pclk", "hclk";
        atmel,vbus-gpio = <&pioC 15 GPIO_ACTIVE_HIGH>;
    };
...