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