dt-bindings: net: dsa: Add lantiq, xrx200-gswip DT bindings
authorHauke Mehrtens <hauke@hauke-m.de>
Sun, 9 Sep 2018 20:20:27 +0000 (22:20 +0200)
committerDavid S. Miller <davem@davemloft.net>
Thu, 13 Sep 2018 15:14:33 +0000 (08:14 -0700)
This adds the binding for the GSWIP (Gigabit switch) core found in the
xrx200 / VR9 Lantiq / Intel SoC.

This part takes care of the switch, MDIO bus, and loading the FW into
the embedded GPHYs.

Signed-off-by: Hauke Mehrtens <hauke@hauke-m.de>
Cc: devicetree@vger.kernel.org
Signed-off-by: David S. Miller <davem@davemloft.net>
Documentation/devicetree/bindings/net/dsa/lantiq-gswip.txt [new file with mode: 0644]

diff --git a/Documentation/devicetree/bindings/net/dsa/lantiq-gswip.txt b/Documentation/devicetree/bindings/net/dsa/lantiq-gswip.txt
new file mode 100644 (file)
index 0000000..a089f58
--- /dev/null
@@ -0,0 +1,141 @@
+Lantiq GSWIP Ethernet switches
+==================================
+
+Required properties for GSWIP core:
+
+- compatible   : "lantiq,xrx200-gswip" for the embedded GSWIP in the
+                 xRX200 SoC
+- reg          : memory range of the GSWIP core registers
+               : memory range of the GSWIP MDIO registers
+               : memory range of the GSWIP MII registers
+
+See Documentation/devicetree/bindings/net/dsa/dsa.txt for a list of
+additional required and optional properties.
+
+
+Required properties for MDIO bus:
+- compatible   : "lantiq,xrx200-mdio" for the MDIO bus inside the GSWIP
+                 core of the xRX200 SoC and the PHYs connected to it.
+
+See Documentation/devicetree/bindings/net/mdio.txt for a list of additional
+required and optional properties.
+
+
+Required properties for GPHY firmware loading:
+- compatible   : "lantiq,gphy-fw" and "lantiq,xrx200-gphy-fw",
+                 "lantiq,xrx200a1x-gphy-fw", "lantiq,xrx200a2x-gphy-fw",
+                 "lantiq,xrx300-gphy-fw", or "lantiq,xrx330-gphy-fw"
+                 for the loading of the firmware into the embedded
+                 GPHY core of the SoC.
+- lantiq,rcu   : reference to the rcu syscon
+
+The GPHY firmware loader has a list of GPHY entries, one for each
+embedded GPHY
+
+- reg          : Offset of the GPHY firmware register in the RCU
+                 register range
+- resets       : list of resets of the embedded GPHY
+- reset-names  : list of names of the resets
+
+Example:
+
+Ethernet switch on the VRX200 SoC:
+
+gswip: gswip@E108000 {
+       #address-cells = <1>;
+       #size-cells = <0>;
+       compatible = "lantiq,xrx200-gswip";
+       reg = < 0xE108000 0x3000 /* switch */
+               0xE10B100 0x70 /* mdio */
+               0xE10B1D8 0x30 /* mii */
+               >;
+       dsa,member = <0 0>;
+
+       ports {
+               #address-cells = <1>;
+               #size-cells = <0>;
+
+               port@0 {
+                       reg = <0>;
+                       label = "lan3";
+                       phy-mode = "rgmii";
+                       phy-handle = <&phy0>;
+               };
+
+               port@1 {
+                       reg = <1>;
+                       label = "lan4";
+                       phy-mode = "rgmii";
+                       phy-handle = <&phy1>;
+               };
+
+               port@2 {
+                       reg = <2>;
+                       label = "lan2";
+                       phy-mode = "internal";
+                       phy-handle = <&phy11>;
+               };
+
+               port@4 {
+                       reg = <4>;
+                       label = "lan1";
+                       phy-mode = "internal";
+                       phy-handle = <&phy13>;
+               };
+
+               port@5 {
+                       reg = <5>;
+                       label = "wan";
+                       phy-mode = "rgmii";
+                       phy-handle = <&phy5>;
+               };
+
+               port@6 {
+                       reg = <0x6>;
+                       label = "cpu";
+                       ethernet = <&eth0>;
+               };
+       };
+
+       mdio@0 {
+               #address-cells = <1>;
+               #size-cells = <0>;
+               compatible = "lantiq,xrx200-mdio";
+               reg = <0>;
+
+               phy0: ethernet-phy@0 {
+                       reg = <0x0>;
+               };
+               phy1: ethernet-phy@1 {
+                       reg = <0x1>;
+               };
+               phy5: ethernet-phy@5 {
+                       reg = <0x5>;
+               };
+               phy11: ethernet-phy@11 {
+                       reg = <0x11>;
+               };
+               phy13: ethernet-phy@13 {
+                       reg = <0x13>;
+               };
+       };
+
+       gphy-fw {
+               compatible = "lantiq,xrx200-gphy-fw", "lantiq,gphy-fw";
+               lantiq,rcu = <&rcu0>;
+
+               gphy@20 {
+                       reg = <0x20>;
+
+                       resets = <&reset0 31 30>;
+                       reset-names = "gphy";
+               };
+
+               gphy@68 {
+                       reg = <0x68>;
+
+                       resets = <&reset0 29 28>;
+                       reset-names = "gphy";
+               };
+       };
+};