# SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/net/qcom,sa8255p-ethqos.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Qualcomm Ethernet ETHQOS device (firmware managed)

maintainers:
  - Bjorn Andersson <andersson@kernel.org>
  - Konrad Dybcio <konradybcio@kernel.org>
  - Bartosz Golaszewski <bartosz.golaszewski@linaro.org>

description:
  dwmac based Qualcomm ethernet devices which support Gigabit
  ethernet (version v2.3.0 and onwards) with clocks, interconnects, etc.
  managed by firmware

allOf:
  - $ref: snps,dwmac.yaml#

properties:
  compatible:
    const: qcom,sa8255p-ethqos

  reg:
    maxItems: 2

  reg-names:
    items:
      - const: stmmaceth
      - const: rgmii

  interrupts:
    items:
      - description: Combined signal for various interrupt events
      - description: The interrupt that occurs when HW safety error triggered

  interrupt-names:
    items:
      - const: macirq
      - const: sfty

  power-domains:
    minItems: 2
    maxItems: 2

  power-domain-names:
    items:
      - const: core
      - const: mdio

  phys:
    maxItems: 1

  phy-names:
    items:
      - const: serdes

  iommus:
    maxItems: 1

  dma-coherent: true

required:
  - compatible
  - reg-names
  - power-domains
  - power-domain-names

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>

    ethernet: ethernet@23040000 {
        compatible = "qcom,sa8255p-ethqos";
        reg = <0x23040000 0x10000>,
              <0x23056000 0x100>;
        reg-names = "stmmaceth", "rgmii";

        iommus = <&apps_smmu 0x120 0x7>;

        interrupts = <GIC_SPI 946 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 782 IRQ_TYPE_LEVEL_HIGH>;
        interrupt-names = "macirq", "sfty";

        dma-coherent;

        snps,tso;
        snps,pbl = <32>;
        rx-fifo-depth = <16384>;
        tx-fifo-depth = <16384>;

        phy-handle = <&ethernet_phy>;
        phy-mode = "2500base-x";

        snps,mtl-rx-config = <&mtl_rx_setup1>;
        snps,mtl-tx-config = <&mtl_tx_setup1>;

        power-domains = <&scmi8_pd 0>, <&scmi8_pd 1>;
        power-domain-names = "core", "mdio";

        phys = <&serdes1>;
        phy-names = "serdes";
    };