xref: /linux/Documentation/devicetree/bindings/net/hisilicon-hns-nic.txt (revision cc998d8bc74341f6bbbcd63ab4449a6acfc45ee9) 
1Hisilicon Network Subsystem NIC controller
2
3Required properties:
4- compatible: "hisilicon,hns-nic-v1" or "hisilicon,hns-nic-v2".
5  "hisilicon,hns-nic-v1" is for hip05.
6  "hisilicon,hns-nic-v2" is for Hi1610 and Hi1612.
7- ae-handle: accelerator engine handle for hns,
8  specifies a reference to the associating hardware driver node.
9  see Documentation/devicetree/bindings/net/hisilicon-hns-dsaf.txt
10- port-id: is the index of port provided by DSAF (the accelerator). DSAF can
11  connect to 8 PHYs. Port 0 to 1 are both used for adminstration purpose. They
12  are called debug ports.
13
14  The remaining 6 PHYs are taken according to the mode of DSAF.
15
16  In NIC mode of DSAF, all 6 PHYs are taken as ethernet ports to the CPU. The
17  port-id can be 2 to 7. Here is the diagram:
18            +-----+---------------+
19            |            CPU      |
20            +-+-+-+---+-+-+-+-+-+-+
21              | |     | | | | | |
22             debug       service
23             port         port
24             (0,1)       (2-7)
25
26  In Switch mode of DSAF, all 6 PHYs are taken as physical ports connect to a
27  LAN Switch while the CPU side assume itself have one single NIC connect to
28  this switch. In this case, the port-id will be 2 only.
29            +-----+---------------+
30            |            CPU      |
31            +-+-+-+---+-+-+-+-+-+-+
32              | |   service| port(2)
33             debug   +------------+
34             port    |   switch   |
35             (0,1)   +-+-+-+-+-+-++
36                       | | | | | |
37                      external port
38
39- local-mac-address: mac addr of the ethernet interface
40
41Example:
42
43	ethernet@0{
44		compatible = "hisilicon,hns-nic-v1";
45		ae-handle = <&dsaf0>;
46		port-id = <0>;
47		local-mac-address = [a2 14 e4 4b 56 76];
48	};
49