netdev - [PATCH] dt-bindings: Add bindings for mdio mux consumers

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <20190221182349.4057-1-pankaj.bansal@nxp.com>
Date:   Thu, 21 Feb 2019 12:59:19 +0000
From:   Pankaj Bansal <pankaj.bansal@....com>
To:     Leo Li <leoyang.li@....com>, Peter Rosin <peda@...ntia.se>,
        Andrew Lunn <andrew@...n.ch>,
        Florian Fainelli <f.fainelli@...il.com>,
        Heiner Kallweit <hkallweit1@...il.com>,
        Rob Herring <robh+dt@...nel.org>,
        Mark Rutland <mark.rutland@....com>
CC:     "devicetree@...r.kernel.org" <devicetree@...r.kernel.org>,
        "netdev@...r.kernel.org" <netdev@...r.kernel.org>,
        Pankaj Bansal <pankaj.bansal@....com>
Subject: [PATCH] dt-bindings: Add bindings for mdio mux consumers

When we use the bindings defined in Documentation/devicetree/bindings/mux
to define mdio mux in producer and consumer terms, it results in two
devices. one is mux producer and other is mux consumer.

Add the bindings needed for Mdio mux consumer devices.

Signed-off-by: Pankaj Bansal <pankaj.bansal@....com>
---
 .../devicetree/bindings/net/mdio-mux.txt     | 73 ++++++++++++++++++
 1 file changed, 73 insertions(+)

diff --git a/Documentation/devicetree/bindings/net/mdio-mux.txt b/Documentation/devicetree/bindings/net/mdio-mux.txt
index f58571f36570..bd198d1c6f10 100644
--- a/Documentation/devicetree/bindings/net/mdio-mux.txt
+++ b/Documentation/devicetree/bindings/net/mdio-mux.txt
@@ -18,8 +18,16 @@ Required properties for child nodes:
 - #size-cells = <0>;
 - reg : The sub-bus number.
 
+Required properties when Mdio mux node is consumer of a separate mux producer
+node.
+- compatible : should be "mmio-mux"
+- mux-controls : mux controller node to use for operating the mux
+- mdio-parent-bus : phandle to the parent MDIO bus.
+for more information please refer Documentation/devicetree/bindings/mux/
+
 
 Example :
+The mux Producer and consumer nodes are same.
 
 	/* The parent MDIO bus. */
 	smi1: mdio@...0000001900 {
@@ -127,3 +135,68 @@ Example :
 			};
 		};
 	};
+
+Example 2:
+In below example the Mux producer and consumer are separate nodes.
+
+&i2c0 {
+        fpga@66 { // fpga connected to i2c
+                compatible = "fsl,lx2160aqds-fpga", "fsl,fpga-qixis-i2c",
+                             "simple-mfd";
+                reg = <0x66>;
+
+                mux: mux-controller { // Mux Producer
+                        compatible = "reg-mux";
+                        #mux-control-cells = <1>;
+                        mux-reg-masks = <0x54 0xf8>, /* 0: reg 0x54, bits 7:3 */
+                                        <0x54 0x07>; /* 1: reg 0x54, bits 2:0 */
+                };
+        };
+};
+
+mdio-mux-1 { // Mux consumer
+        compatible = "mdio-mux";
+        mux-controls = <&mux 0>;
+        mdio-parent-bus = <&emdio1>;
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        mdio@0 {
+                reg = <0x0>;
+                #address-cells = <1>;
+                #size-cells = <0>;
+        };
+
+        mdio@40 {
+                reg = <0x40>;
+                #address-cells = <1>;
+                #size-cells = <0>;
+        };
+
+        ..
+        ..
+};
+
+mdio-mux-2 { // Mux consumer
+        compatible = "mdio-mux";
+        mux-controls = <&mux 1>;
+        mdio-parent-bus = <&emdio2>;
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        mdio@0 {
+                reg = <0x0>;
+                #address-cells = <1>;
+                #size-cells = <0>;
+        };
+
+        mdio@1 {
+                reg = <0x1>;
+                #address-cells = <1>;
+                #size-cells = <0>;
+        };
+
+        ..
+        ..
+};
+
-- 
2.17.1