linux/Documentation/devicetree/bindings/net/cavium-pip.txt
<<
>>
Prefs
   1* PIP Ethernet nexus.
   2
   3The PIP Ethernet nexus can control several data packet input/output
   4devices.  The devices have a two level grouping scheme.  There may be
   5several interfaces, and each interface may have several ports.  These
   6ports might be an individual Ethernet PHY.
   7
   8
   9Properties for the PIP nexus:
  10- compatible: "cavium,octeon-3860-pip"
  11
  12  Compatibility with all cn3XXX, cn5XXX and cn6XXX SOCs.
  13
  14- reg: The base address of the PIP's register bank.
  15
  16- #address-cells: Must be <1>.
  17
  18- #size-cells: Must be <0>.
  19
  20Properties for PIP interfaces which is a child the PIP nexus:
  21- compatible: "cavium,octeon-3860-pip-interface"
  22
  23  Compatibility with all cn3XXX, cn5XXX and cn6XXX SOCs.
  24
  25- reg: The interface number.
  26
  27- #address-cells: Must be <1>.
  28
  29- #size-cells: Must be <0>.
  30
  31Properties for PIP port which is a child the PIP interface:
  32- compatible: "cavium,octeon-3860-pip-port"
  33
  34  Compatibility with all cn3XXX, cn5XXX and cn6XXX SOCs.
  35
  36- reg: The port number within the interface group.
  37
  38- mac-address: Optional, the MAC address to assign to the device.
  39
  40- local-mac-address: Optional, the MAC address to assign to the device
  41  if mac-address is not specified.
  42
  43- phy-handle: Optional, a phandle for the PHY device connected to this device.
  44
  45Example:
  46
  47        pip@11800a0000000 {
  48                compatible = "cavium,octeon-3860-pip";
  49                #address-cells = <1>;
  50                #size-cells = <0>;
  51                reg = <0x11800 0xa0000000 0x0 0x2000>;
  52
  53                interface@0 {
  54                        compatible = "cavium,octeon-3860-pip-interface";
  55                        #address-cells = <1>;
  56                        #size-cells = <0>;
  57                        reg = <0>; /* interface */
  58
  59                        ethernet@0 {
  60                                compatible = "cavium,octeon-3860-pip-port";
  61                                reg = <0x0>; /* Port */
  62                                local-mac-address = [ 00 0f b7 10 63 60 ];
  63                                phy-handle = <&phy2>;
  64                        };
  65                        ethernet@1 {
  66                                compatible = "cavium,octeon-3860-pip-port";
  67                                reg = <0x1>; /* Port */
  68                                local-mac-address = [ 00 0f b7 10 63 61 ];
  69                                phy-handle = <&phy3>;
  70                        };
  71                        ethernet@2 {
  72                                compatible = "cavium,octeon-3860-pip-port";
  73                                reg = <0x2>; /* Port */
  74                                local-mac-address = [ 00 0f b7 10 63 62 ];
  75                                phy-handle = <&phy4>;
  76                        };
  77                        ethernet@3 {
  78                                compatible = "cavium,octeon-3860-pip-port";
  79                                reg = <0x3>; /* Port */
  80                                local-mac-address = [ 00 0f b7 10 63 63 ];
  81                                phy-handle = <&phy5>;
  82                        };
  83                };
  84
  85                interface@1 {
  86                        compatible = "cavium,octeon-3860-pip-interface";
  87                        #address-cells = <1>;
  88                        #size-cells = <0>;
  89                        reg = <1>; /* interface */
  90
  91                        ethernet@0 {
  92                                compatible = "cavium,octeon-3860-pip-port";
  93                                reg = <0x0>; /* Port */
  94                                local-mac-address = [ 00 0f b7 10 63 64 ];
  95                                phy-handle = <&phy6>;
  96                        };
  97                };
  98        };
  99