Merge tag 'rproc-v5.3' of git://github.com/andersson/remoteproc
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / net / dsa / vitesse,vsc73xx.txt
1 Vitesse VSC73xx Switches
2 ========================
3
4 This defines device tree bindings for the Vitesse VSC73xx switch chips.
5 The Vitesse company has been acquired by Microsemi and Microsemi has
6 been acquired Microchip but retains this vendor branding.
7
8 The currently supported switch chips are:
9 Vitesse VSC7385 SparX-G5 5+1-port Integrated Gigabit Ethernet Switch
10 Vitesse VSC7388 SparX-G8 8-port Integrated Gigabit Ethernet Switch
11 Vitesse VSC7395 SparX-G5e 5+1-port Integrated Gigabit Ethernet Switch
12 Vitesse VSC7398 SparX-G8e 8-port Integrated Gigabit Ethernet Switch
13
14 This switch could have two different management interface.
15
16 If SPI interface is used, the device tree node is an SPI device so it must
17 reside inside a SPI bus device tree node, see spi/spi-bus.txt
18
19 When the chip is connected to a parallel memory bus and work in memory-mapped
20 I/O mode, a platform device is used to represent the vsc73xx. In this case it
21 must reside inside a platform bus device tree node.
22
23 Required properties:
24
25 - compatible: must be exactly one of:
26         "vitesse,vsc7385"
27         "vitesse,vsc7388"
28         "vitesse,vsc7395"
29         "vitesse,vsc7398"
30 - gpio-controller: indicates that this switch is also a GPIO controller,
31   see gpio/gpio.txt
32 - #gpio-cells: this must be set to <2> and indicates that we are a twocell
33   GPIO controller, see gpio/gpio.txt
34
35 Optional properties:
36
37 - reset-gpios: a handle to a GPIO line that can issue reset of the chip.
38   It should be tagged as active low.
39
40 Required subnodes:
41
42 See net/dsa/dsa.txt for a list of additional required and optional properties
43 and subnodes of DSA switches.
44
45 Examples:
46
47 SPI:
48 switch@0 {
49         compatible = "vitesse,vsc7395";
50         reg = <0>;
51         /* Specified for 2.5 MHz or below */
52         spi-max-frequency = <2500000>;
53         gpio-controller;
54         #gpio-cells = <2>;
55
56         ports {
57                 #address-cells = <1>;
58                 #size-cells = <0>;
59
60                 port@0 {
61                         reg = <0>;
62                         label = "lan1";
63                 };
64                 port@1 {
65                         reg = <1>;
66                         label = "lan2";
67                 };
68                 port@2 {
69                         reg = <2>;
70                         label = "lan3";
71                 };
72                 port@3 {
73                         reg = <3>;
74                         label = "lan4";
75                 };
76                 vsc: port@6 {
77                         reg = <6>;
78                         label = "cpu";
79                         ethernet = <&gmac1>;
80                         phy-mode = "rgmii";
81                         fixed-link {
82                                 speed = <1000>;
83                                 full-duplex;
84                                 pause;
85                         };
86                 };
87         };
88 };
89
90 Platform:
91 switch@2,0 {
92         #address-cells = <1>;
93         #size-cells = <1>;
94         compatible = "vitesse,vsc7385";
95         reg = <0x2 0x0 0x20000>;
96         reset-gpios = <&gpio0 12 GPIO_ACTIVE_LOW>;
97
98         ports {
99                 #address-cells = <1>;
100                 #size-cells = <0>;
101
102                 port@0 {
103                         reg = <0>;
104                         label = "lan1";
105                 };
106                 port@1 {
107                         reg = <1>;
108                         label = "lan2";
109                 };
110                 port@2 {
111                         reg = <2>;
112                         label = "lan3";
113                 };
114                 port@3 {
115                         reg = <3>;
116                         label = "lan4";
117                 };
118                 vsc: port@6 {
119                         reg = <6>;
120                         label = "cpu";
121                         ethernet = <&enet0>;
122                         phy-mode = "rgmii";
123                         fixed-link {
124                                 speed = <1000>;
125                                 full-duplex;
126                                 pause;
127                         };
128                 };
129         };
130
131 };