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