GNU Linux-libre 4.19.245-gnu1
[releases.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 in turn
6 acquired by 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 The device tree node is an SPI device so it must reside inside a SPI bus
15 device tree node, see spi/spi-bus.txt
16
17 Required properties:
18
19 - compatible: must be exactly one of:
20         "vitesse,vsc7385"
21         "vitesse,vsc7388"
22         "vitesse,vsc7395"
23         "vitesse,vsc7398"
24 - gpio-controller: indicates that this switch is also a GPIO controller,
25   see gpio/gpio.txt
26 - #gpio-cells: this must be set to <2> and indicates that we are a twocell
27   GPIO controller, see gpio/gpio.txt
28
29 Optional properties:
30
31 - reset-gpios: a handle to a GPIO line that can issue reset of the chip.
32   It should be tagged as active low.
33
34 Required subnodes:
35
36 See net/dsa/dsa.txt for a list of additional required and optional properties
37 and subnodes of DSA switches.
38
39 Examples:
40
41 switch@0 {
42         compatible = "vitesse,vsc7395";
43         reg = <0>;
44         /* Specified for 2.5 MHz or below */
45         spi-max-frequency = <2500000>;
46         gpio-controller;
47         #gpio-cells = <2>;
48
49         ports {
50                 #address-cells = <1>;
51                 #size-cells = <0>;
52
53                 port@0 {
54                         reg = <0>;
55                         label = "lan1";
56                 };
57                 port@1 {
58                         reg = <1>;
59                         label = "lan2";
60                 };
61                 port@2 {
62                         reg = <2>;
63                         label = "lan3";
64                 };
65                 port@3 {
66                         reg = <3>;
67                         label = "lan4";
68                 };
69                 vsc: port@6 {
70                         reg = <6>;
71                         label = "cpu";
72                         ethernet = <&gmac1>;
73                         phy-mode = "rgmii";
74                         fixed-link {
75                                 speed = <1000>;
76                                 full-duplex;
77                                 pause;
78                         };
79                 };
80         };
81 };