1 Hisilicon Network Subsystem NIC controller 1 Hisilicon Network Subsystem NIC controller
2 2
3 Required properties: 3 Required properties:
4 - compatible: "hisilicon,hns-nic-v1" or "hisil 4 - compatible: "hisilicon,hns-nic-v1" or "hisilicon,hns-nic-v2".
5 "hisilicon,hns-nic-v1" is for hip05. 5 "hisilicon,hns-nic-v1" is for hip05.
6 "hisilicon,hns-nic-v2" is for Hi1610 and Hi1 6 "hisilicon,hns-nic-v2" is for Hi1610 and Hi1612.
7 - ae-handle: accelerator engine handle for hns !! 7 - ae-name: accelerator name who provides this interface,
8 specifies a reference to the associating har !! 8 is simply a name referring to the name of name in the accelerator node.
9 see Documentation/devicetree/bindings/net/hi <<
10 - port-id: is the index of port provided by DS 9 - 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 !! 10 connect to 8 PHYs. Port 0 to 1 are both used for adminstration purpose. They
12 are called debug ports. 11 are called debug ports.
13 12
14 The remaining 6 PHYs are taken according to 13 The remaining 6 PHYs are taken according to the mode of DSAF.
15 14
16 In NIC mode of DSAF, all 6 PHYs are taken as 15 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: 16 port-id can be 2 to 7. Here is the diagram:
18 +-----+---------------+ 17 +-----+---------------+
19 | CPU | 18 | CPU |
20 +-+-+-+---+-+-+-+-+-+-+ 19 +-+-+-+---+-+-+-+-+-+-+
21 | | | | | | | | 20 | | | | | | | |
22 debug service 21 debug service
23 port port 22 port port
24 (0,1) (2-7) 23 (0,1) (2-7)
25 24
26 In Switch mode of DSAF, all 6 PHYs are taken 25 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 26 LAN Switch while the CPU side assume itself have one single NIC connect to
28 this switch. In this case, the port-id will 27 this switch. In this case, the port-id will be 2 only.
29 +-----+---------------+ 28 +-----+---------------+
30 | CPU | 29 | CPU |
31 +-+-+-+---+-+-+-+-+-+-+ 30 +-+-+-+---+-+-+-+-+-+-+
32 | | service| port(2) 31 | | service| port(2)
33 debug +------------+ 32 debug +------------+
34 port | switch | 33 port | switch |
35 (0,1) +-+-+-+-+-+-++ 34 (0,1) +-+-+-+-+-+-++
36 | | | | | | 35 | | | | | |
37 external port 36 external port
38 37
39 This attribute is remained for compatible pu <<
40 use it in new code. <<
41 <<
42 - port-idx-in-ae: is the index of port provide <<
43 In NIC mode of DSAF, all 6 PHYs of service D <<
44 to the CPU. The port-idx-in-ae can be 0 to 5 <<
45 +-----+---------------+ <<
46 | CPU | <<
47 +-+-+-+---+-+-+-+-+-+-+ <<
48 | | | | | | | | <<
49 debug debug service <<
50 port port port <<
51 (0) (0) (0-5) <<
52 <<
53 In Switch mode of DSAF, all 6 PHYs of servic <<
54 ports connected to a LAN Switch while the CP <<
55 single NIC connected to this switch. In this <<
56 will be 0 only. <<
57 +-----+-----+------+------+ <<
58 | CPU | <<
59 +-+-+-+-+-+-+-+-+-+-+-+-+-+ <<
60 | | service| port(0) <<
61 debug debug +------------+ <<
62 port port | switch | <<
63 (0) (0) +-+-+-+-+-+-++ <<
64 | | | | | | <<
65 external port <<
66 <<
67 - local-mac-address: mac addr of the ethernet 38 - local-mac-address: mac addr of the ethernet interface
68 39
69 Example: 40 Example:
70 41
71 ethernet@0{ 42 ethernet@0{
72 compatible = "hisilicon,hns-ni 43 compatible = "hisilicon,hns-nic-v1";
73 ae-handle = <&dsaf0>; !! 44 ae-name = "dsaf0";
74 port-idx-in-ae = <0>; !! 45 port-id = <0>;
75 local-mac-address = [a2 14 e4 46 local-mac-address = [a2 14 e4 4b 56 76];
76 }; 47 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.