xref: /freebsd/sys/contrib/device-tree/Bindings/net/dsa/vitesse,vsc73xx.txt (revision e6bfd18d21b225af6a0ed67ceeaf1293b7b9eba5)
1Vitesse VSC73xx Switches
2========================
3
4This defines device tree bindings for the Vitesse VSC73xx switch chips.
5The Vitesse company has been acquired by Microsemi and Microsemi has
6been acquired Microchip but retains this vendor branding.
7
8The currently supported switch chips are:
9Vitesse VSC7385 SparX-G5 5+1-port Integrated Gigabit Ethernet Switch
10Vitesse VSC7388 SparX-G8 8-port Integrated Gigabit Ethernet Switch
11Vitesse VSC7395 SparX-G5e 5+1-port Integrated Gigabit Ethernet Switch
12Vitesse VSC7398 SparX-G8e 8-port Integrated Gigabit Ethernet Switch
13
14This switch could have two different management interface.
15
16If SPI interface is used, the device tree node is an SPI device so it must
17reside inside a SPI bus device tree node, see spi/spi-bus.txt
18
19When the chip is connected to a parallel memory bus and work in memory-mapped
20I/O mode, a platform device is used to represent the vsc73xx. In this case it
21must reside inside a platform bus device tree node.
22
23Required 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
35Optional 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
40Required subnodes:
41
42See net/dsa/dsa.txt for a list of additional required and optional properties
43and subnodes of DSA switches.
44
45Examples:
46
47SPI:
48switch@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
90Platform:
91switch@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};
132