1 files changed, 98 insertions, 0 deletions

diff --git a/Documentation/devicetree/bindings/net/cavium-pip.txt b/Documentation/devicetree/bindings/net/cavium-pip.txt
new file mode 100644
index 000000000000..d4c53ba04b3b
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/cavium-pip.txt
@@ -0,0 +1,98 @@
+* PIP Ethernet nexus.
+
+The PIP Ethernet nexus can control several data packet input/output
+devices.  The devices have a two level grouping scheme.  There may be
+several interfaces, and each interface may have several ports.  These
+ports might be an individual Ethernet PHY.
+
+
+Properties for the PIP nexus:
+- compatible: "cavium,octeon-3860-pip"
+
+  Compatibility with all cn3XXX, cn5XXX and cn6XXX SOCs.
+
+- reg: The base address of the PIP's register bank.
+
+- #address-cells: Must be <1>.
+
+- #size-cells: Must be <0>.
+
+Properties for PIP interfaces which is a child the PIP nexus:
+- compatible: "cavium,octeon-3860-pip-interface"
+
+  Compatibility with all cn3XXX, cn5XXX and cn6XXX SOCs.
+
+- reg: The interface number.
+
+- #address-cells: Must be <1>.
+
+- #size-cells: Must be <0>.
+
+Properties for PIP port which is a child the PIP interface:
+- compatible: "cavium,octeon-3860-pip-port"
+
+  Compatibility with all cn3XXX, cn5XXX and cn6XXX SOCs.
+
+- reg: The port number within the interface group.
+
+- mac-address: Optional, the MAC address to assign to the device.
+
+- local-mac-address: Optional, the MAC address to assign to the device
+  if mac-address is not specified.
+
+- phy-handle: Optional, a phandle for the PHY device connected to this device.
+
+Example:
+
+        pip@11800a0000000 {
+                compatible = "cavium,octeon-3860-pip";
+                #address-cells = <1>;
+                #size-cells = <0>;
+                reg = <0x11800 0xa0000000 0x0 0x2000>;
+
+                interface@0 {
+                        compatible = "cavium,octeon-3860-pip-interface";
+                        #address-cells = <1>;
+                        #size-cells = <0>;
+                        reg = <0>; /* interface */
+
+                        ethernet@0 {
+                                compatible = "cavium,octeon-3860-pip-port";
+                                reg = <0x0>; /* Port */
+                                local-mac-address = [ 00 0f b7 10 63 60 ];
+                                phy-handle = <&phy2>;
+                        };
+                        ethernet@1 {
+                                compatible = "cavium,octeon-3860-pip-port";
+                                reg = <0x1>; /* Port */
+                                local-mac-address = [ 00 0f b7 10 63 61 ];
+                                phy-handle = <&phy3>;
+                        };
+                        ethernet@2 {
+                                compatible = "cavium,octeon-3860-pip-port";
+                                reg = <0x2>; /* Port */
+                                local-mac-address = [ 00 0f b7 10 63 62 ];
+                                phy-handle = <&phy4>;
+                        };
+                        ethernet@3 {
+                                compatible = "cavium,octeon-3860-pip-port";
+                                reg = <0x3>; /* Port */
+                                local-mac-address = [ 00 0f b7 10 63 63 ];
+                                phy-handle = <&phy5>;
+                        };
+                };
+
+                interface@1 {
+                        compatible = "cavium,octeon-3860-pip-interface";
+                        #address-cells = <1>;
+                        #size-cells = <0>;
+                        reg = <1>; /* interface */
+
+                        ethernet@0 {
+                                compatible = "cavium,octeon-3860-pip-port";
+                                reg = <0x0>; /* Port */
+                                local-mac-address = [ 00 0f b7 10 63 64 ];
+                                phy-handle = <&phy6>;
+                        };
+                };
+        };