xref: /freebsd/sys/contrib/device-tree/Bindings/net/dsa/vitesse,vsc73xx.txt (revision 734e82fe33aa764367791a7d603b383996c6b40b)
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			ethernet = <&gmac1>;
79			phy-mode = "rgmii";
80			fixed-link {
81				speed = <1000>;
82				full-duplex;
83				pause;
84			};
85		};
86	};
87};
88
89Platform:
90switch@2,0 {
91	#address-cells = <1>;
92	#size-cells = <1>;
93	compatible = "vitesse,vsc7385";
94	reg = <0x2 0x0 0x20000>;
95	reset-gpios = <&gpio0 12 GPIO_ACTIVE_LOW>;
96
97	ports {
98		#address-cells = <1>;
99		#size-cells = <0>;
100
101		port@0 {
102			reg = <0>;
103			label = "lan1";
104		};
105		port@1 {
106			reg = <1>;
107			label = "lan2";
108		};
109		port@2 {
110			reg = <2>;
111			label = "lan3";
112		};
113		port@3 {
114			reg = <3>;
115			label = "lan4";
116		};
117		vsc: port@6 {
118			reg = <6>;
119			ethernet = <&enet0>;
120			phy-mode = "rgmii";
121			fixed-link {
122				speed = <1000>;
123				full-duplex;
124				pause;
125			};
126		};
127	};
128
129};
130