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

title: Altera Agilex5 DWC3 USB SoC Controller

maintainers:
  - Adrian Ng Ho Yin <adrian.ho.yin.ng@altera.com>

description:
  The Altera Agilex5 SoCFPGA integrates a Synopsys DesignWare USB3 (DWC3)
  controller that supports host, device and DRD modes.

allOf:
  - $ref: snps,dwc3-common.yaml#

properties:
  compatible:
    const: altr,agilex5-dwc3

  reg:
    maxItems: 1

  clocks:
    items:
      - description: Master/Core bus clock
      - description: Controller reference clock
      - description: Controller suspend clock

  clock-names:
    items:
      - const: bus_early
      - const: ref
      - const: suspend

  interrupts:
    maxItems: 1

  phys:
    minItems: 2
    maxItems: 2

  phy-names:
    items:
      - const: usb2-phy
      - const: usb3-phy

  iommus:
    maxItems: 1

  resets:
    items:
      - description: DWC3 core reset
      - description: DWC3 ECC reset

  reset-names:
    items:
      - const: core
      - const: ecc

  dr_mode: true

  maximum-speed: true

  snps,dis_u2_susphy_quirk: true

  snps,dis_u3_susphy_quirk: true

required:
  - compatible
  - reg
  - clocks
  - clock-names
  - interrupts
  - phys
  - phy-names
  - resets
  - reset-names
  - snps,dis_u2_susphy_quirk
  - snps,dis_u3_susphy_quirk

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/reset/altr,rst-mgr-s10.h>
    #include <dt-bindings/clock/intel,agilex5-clkmgr.h>

    soc {
        #address-cells = <1>;
        #size-cells = <1>;

        usb@11000000 {
            compatible = "altr,agilex5-dwc3";
            reg = <0x11000000 0x100000>;
            interrupts = <GIC_SPI 94 IRQ_TYPE_LEVEL_HIGH>;
            clocks = <&clkmgr AGILEX5_USB31_BUS_CLK_EARLY>,
                     <&clkmgr AGILEX5_USB31_SUSPEND_CLK>,
                     <&clkmgr AGILEX5_USB31_SUSPEND_CLK>;
            clock-names = "bus_early", "ref", "suspend";
            phys = <&usbphy0>, <&usbphy1>;
            phy-names = "usb2-phy", "usb3-phy";
            resets = <&rst USB1_RESET>, <&rst USB1_OCP_RESET>;
            reset-names = "core", "ecc";
            iommus = <&smmu 7>;
            snps,dis_u2_susphy_quirk;
            snps,dis_u3_susphy_quirk;
        };
    };