# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/net/pcs/rockchip,rk3568-xpcs.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Rockchip RK3568 Synopsys DesignWare Ethernet PCS

maintainers:
  - Coia Prant <coiaprant@gmail.com>

description: |
  Rockchip RK3568 SoC integrates a Synopsys DesignWare Ethernet Physical
  Coding Sublayer (XPCS).
  The PCS provides an interface between the Media Access Control (MAC)
  and the Physical Medium Attachment (PMA) sublayer through a Media
  Independent Interface (GMII).

  The XPCS is accessed over the APB3 bus and internally connected to a
  Naneng Combo SerDes PHY.
  It supports 1000BASE-X, SGMII and QSGMII modes.

properties:
  compatible:
    const: rockchip,rk3568-xpcs

  reg:
    maxItems: 1

  clocks:
    items:
      - description: APB3 bus interface clock (clk_csr_i), required for register access
      - description: EEE clock (clk_eee_i), required for Energy Efficient Ethernet operation

  clock-names:
    items:
      - const: csr
      - const: eee

  phys:
    maxItems: 1

  power-domains:
    maxItems: 1

required:
  - compatible
  - reg
  - clocks
  - clock-names
  - phys
  - power-domains

additionalProperties: false

examples:
  - |
    #include <dt-bindings/clock/rk3568-cru.h>
    #include <dt-bindings/power/rk3568-power.h>
    #include <dt-bindings/phy/phy.h>

    ethernet-pcs@fda00000 {
      compatible = "rockchip,rk3568-xpcs";
      reg = <0xfda00000 0x200000>;
      clocks = <&cru PCLK_XPCS>, <&cru CLK_XPCS_EEE>;
      clock-names = "csr", "eee";
      phys = <&combphy2 PHY_TYPE_SGMII>;
      power-domains = <&power RK3568_PD_PIPE>;
    };