xref: /freebsd/sys/contrib/device-tree/Bindings/net/dsa/ksz.txt (revision cab6a39d7b343596a5823e65c0f7b426551ec22d) 
1Microchip KSZ Series Ethernet switches
2==================================
3
4Required properties:
5
6- compatible: For external switch chips, compatible string must be exactly one
7  of the following:
8  - "microchip,ksz8765"
9  - "microchip,ksz8794"
10  - "microchip,ksz8795"
11  - "microchip,ksz9477"
12  - "microchip,ksz9897"
13  - "microchip,ksz9896"
14  - "microchip,ksz9567"
15  - "microchip,ksz8565"
16  - "microchip,ksz9893"
17  - "microchip,ksz9563"
18  - "microchip,ksz8563"
19
20Optional properties:
21
22- reset-gpios		: Should be a gpio specifier for a reset line
23- microchip,synclko-125 : Set if the output SYNCLKO frequency should be set to
24			  125MHz instead of 25MHz.
25
26See Documentation/devicetree/bindings/net/dsa/dsa.txt for a list of additional
27required and optional properties.
28
29Examples:
30
31Ethernet switch connected via SPI to the host, CPU port wired to eth0:
32
33	eth0: ethernet@10001000 {
34		fixed-link {
35			speed = <1000>;
36			full-duplex;
37		};
38	};
39
40	spi1: spi@f8008000 {
41		pinctrl-0 = <&pinctrl_spi_ksz>;
42		cs-gpios = <&pioC 25 0>;
43		id = <1>;
44
45		ksz9477: ksz9477@0 {
46			compatible = "microchip,ksz9477";
47			reg = <0>;
48
49			spi-max-frequency = <44000000>;
50			spi-cpha;
51			spi-cpol;
52
53			ports {
54				#address-cells = <1>;
55				#size-cells = <0>;
56				port@0 {
57					reg = <0>;
58					label = "lan1";
59				};
60				port@1 {
61					reg = <1>;
62					label = "lan2";
63				};
64				port@2 {
65					reg = <2>;
66					label = "lan3";
67				};
68				port@3 {
69					reg = <3>;
70					label = "lan4";
71				};
72				port@4 {
73					reg = <4>;
74					label = "lan5";
75				};
76				port@5 {
77					reg = <5>;
78					label = "cpu";
79					ethernet = <&eth0>;
80					fixed-link {
81						speed = <1000>;
82						full-duplex;
83					};
84				};
85			};
86		};
87		ksz8565: ksz8565@0 {
88			compatible = "microchip,ksz8565";
89			reg = <0>;
90
91			spi-max-frequency = <44000000>;
92			spi-cpha;
93			spi-cpol;
94
95			ports {
96				#address-cells = <1>;
97				#size-cells = <0>;
98				port@0 {
99					reg = <0>;
100					label = "lan1";
101				};
102				port@1 {
103					reg = <1>;
104					label = "lan2";
105				};
106				port@2 {
107					reg = <2>;
108					label = "lan3";
109				};
110				port@3 {
111					reg = <3>;
112					label = "lan4";
113				};
114				port@6 {
115					reg = <6>;
116					label = "cpu";
117					ethernet = <&eth0>;
118					fixed-link {
119						speed = <1000>;
120						full-duplex;
121					};
122				};
123			};
124		};
125	};
126