blob: f0421ee3c7149fe08419eda6e4657a25872771d2 [file] [log] [blame]
Tom Rini53633a82024-02-29 12:33:36 -05001Hisilicon 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 administration 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 This attribute is remained for compatible purpose. It is not recommended to
40 use it in new code.
41
42- port-idx-in-ae: is the index of port provided by AE.
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. Here is the diagram:
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 service DSAF are taken as physical
54 ports connected to a LAN Switch while the CPU side assume itself have one
55 single NIC connected to this switch. In this case, the port-idx-in-ae
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 interface
68
69Example:
70
71 ethernet@0{
72 compatible = "hisilicon,hns-nic-v1";
73 ae-handle = <&dsaf0>;
74 port-idx-in-ae = <0>;
75 local-mac-address = [a2 14 e4 4b 56 76];
76 };