Commit c639a708 authored by Pranavi Somisetty's avatar Pranavi Somisetty Committed by David S. Miller
Browse files

dt-bindings: net: xilinx_gmii2rgmii: Convert to json schema 



Convert the Xilinx GMII to RGMII Converter device tree binding
documentation to json schema.
This converter is usually used as gem <---> gmii2rgmii <---> external phy
and, it's phy-handle should point to the phandle of the external phy.

Signed-off-by: default avatarPranavi Somisetty <pranavi.somisetty@amd.com>
Signed-off-by: default avatarHarini Katakam <harini.katakam@amd.com>
Reviewed-by: default avatarConor Dooley <conor.dooley@microchip.com>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent 4367d760

Documentation/devicetree/bindings/net/xilinx_gmii2rgmii.txt

deleted100644 → 0
+0 −35
Original line number Diff line number Diff line 
XILINX GMIITORGMII Converter Driver Device Tree Bindings

--------------------------------------------------------



The Gigabit Media Independent Interface (GMII) to Reduced Gigabit Media

Independent Interface (RGMII) core provides the RGMII between RGMII-compliant

Ethernet physical media devices (PHY) and the Gigabit Ethernet controller.

This core can be used in all three modes of operation(10/100/1000 Mb/s).

The Management Data Input/Output (MDIO) interface is used to configure the

Speed of operation. This core can switch dynamically between the three

Different speed modes by configuring the conveter register through mdio write.



This converter sits between the ethernet MAC and the external phy.

MAC <==> GMII2RGMII <==> RGMII_PHY



For more details about mdio please refer phy.txt file in the same directory.



Required properties:

- compatible	: Should be "xlnx,gmii-to-rgmii-1.0"

- reg		: The ID number for the phy, usually a small integer

- phy-handle	: Should point to the external phy device.

		  See ethernet.txt file in the same directory.



Example:

	mdio {

		#address-cells = <1>;

		#size-cells = <0>;

		phy: ethernet-phy@0 {

			......

		};

		gmiitorgmii: gmiitorgmii@8 {

			compatible = "xlnx,gmii-to-rgmii-1.0";

			reg = <8>;

			phy-handle = <&phy>;

		};

	};

Documentation/devicetree/bindings/net/xlnx,gmii-to-rgmii.yaml

0 → 100644
+55 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/net/xlnx,gmii-to-rgmii.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Xilinx GMII to RGMII Converter



maintainers:

  - Harini Katakam <harini.katakam@amd.com>



description:

  The Gigabit Media Independent Interface (GMII) to Reduced Gigabit Media

  Independent Interface (RGMII) core provides the RGMII between RGMII-compliant

  ethernet physical media devices (PHY) and the Gigabit Ethernet controller.

  This core can be used in all three modes of operation(10/100/1000 Mb/s).

  The Management Data Input/Output (MDIO) interface is used to configure the

  speed of operation. This core can switch dynamically between the three

  different speed modes by configuring the converter register through mdio write.

  The core cannot function without an external phy connected to it.



properties:

  compatible:

    const: xlnx,gmii-to-rgmii-1.0



  reg:

    minimum: 0

    maximum: 31

    description: The ID number for the phy.



  phy-handle:

    $ref: ethernet-controller.yaml#/properties/phy-handle



required:

  - compatible

  - reg

  - phy-handle



unevaluatedProperties: false



examples:

  - |

    mdio {

        #address-cells = <1>;

        #size-cells = <0>;



        phy: ethernet-phy@0 {

            reg = <0>;

        };

        gmiitorgmii@8 {

            compatible = "xlnx,gmii-to-rgmii-1.0";

            reg = <8>;

            phy-handle = <&phy>;

        };

    };