Documentation/devicetree/bindings/net/cavium-pip.txt

   1 * PIP Ethernet nexus.
   2
   3 The PIP Ethernet nexus can control several data packet input/output
   4 devices.  The devices have a two level grouping scheme.  There may be
   5 several interfaces, and each interface may have several ports.  These
   6 ports might be an individual Ethernet PHY.
   7
   8
   9 Properties 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
  20 Properties 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
  31 Properties 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
  45 Example:
  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         };