1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-C 1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 # Copyright 2019 BayLibre, SAS 2 # Copyright 2019 BayLibre, SAS
3 %YAML 1.2 3 %YAML 1.2
4 --- 4 ---
5 $id: http://devicetree.org/schemas/net/stm32-d 5 $id: http://devicetree.org/schemas/net/stm32-dwmac.yaml#
6 $schema: http://devicetree.org/meta-schemas/co 6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 7
8 title: STMicroelectronics STM32 / MCU DWMAC gl 8 title: STMicroelectronics STM32 / MCU DWMAC glue layer controller
9 9
10 maintainers: 10 maintainers:
11 - Alexandre Torgue <alexandre.torgue@foss.st. 11 - Alexandre Torgue <alexandre.torgue@foss.st.com>
12 - Christophe Roullier <christophe.roullier@fo 12 - Christophe Roullier <christophe.roullier@foss.st.com>
13 13
14 description: 14 description:
15 This file documents platform glue layer for 15 This file documents platform glue layer for stmmac.
16 16
17 # We need a select here so we don't match all 17 # We need a select here so we don't match all nodes with 'snps,dwmac'
18 select: 18 select:
19 properties: 19 properties:
20 compatible: 20 compatible:
21 contains: 21 contains:
22 enum: 22 enum:
23 - st,stm32-dwmac 23 - st,stm32-dwmac
24 - st,stm32mp1-dwmac 24 - st,stm32mp1-dwmac
25 - st,stm32mp13-dwmac 25 - st,stm32mp13-dwmac
26 - st,stm32mp25-dwmac 26 - st,stm32mp25-dwmac
27 required: 27 required:
28 - compatible 28 - compatible
29 29
30 properties: 30 properties:
31 compatible: 31 compatible:
32 oneOf: 32 oneOf:
33 - items: 33 - items:
34 - enum: 34 - enum:
35 - st,stm32mp25-dwmac 35 - st,stm32mp25-dwmac
36 - const: snps,dwmac-5.20 36 - const: snps,dwmac-5.20
37 - items: 37 - items:
38 - enum: 38 - enum:
39 - st,stm32mp1-dwmac 39 - st,stm32mp1-dwmac
40 - st,stm32mp13-dwmac 40 - st,stm32mp13-dwmac
41 - const: snps,dwmac-4.20a 41 - const: snps,dwmac-4.20a
42 - items: 42 - items:
43 - enum: 43 - enum:
44 - st,stm32-dwmac 44 - st,stm32-dwmac
45 - const: snps,dwmac-4.10a 45 - const: snps,dwmac-4.10a
46 - items: 46 - items:
47 - enum: 47 - enum:
48 - st,stm32-dwmac 48 - st,stm32-dwmac
49 - const: snps,dwmac-3.50a 49 - const: snps,dwmac-3.50a
50 50
51 reg: true 51 reg: true
52 52
53 reg-names: 53 reg-names:
54 items: 54 items:
55 - const: stmmaceth 55 - const: stmmaceth
56 56
57 clocks: 57 clocks:
58 minItems: 3 58 minItems: 3
59 items: 59 items:
60 - description: GMAC main clock 60 - description: GMAC main clock
61 - description: MAC TX clock 61 - description: MAC TX clock
62 - description: MAC RX clock 62 - description: MAC RX clock
63 - description: For MPU family, used for 63 - description: For MPU family, used for power mode
64 - description: For MPU family, used for 64 - description: For MPU family, used for PHY without quartz
65 - description: PTP clock 65 - description: PTP clock
66 66
67 clock-names: 67 clock-names:
68 minItems: 3 68 minItems: 3
69 maxItems: 6 69 maxItems: 6
70 contains: 70 contains:
71 enum: 71 enum:
72 - stmmaceth 72 - stmmaceth
73 - mac-clk-tx 73 - mac-clk-tx
74 - mac-clk-rx 74 - mac-clk-rx
75 - ethstp 75 - ethstp
76 - eth-ck 76 - eth-ck
77 - ptp_ref 77 - ptp_ref
78 78
79 st,syscon: 79 st,syscon:
80 $ref: /schemas/types.yaml#/definitions/pha 80 $ref: /schemas/types.yaml#/definitions/phandle-array
81 items: 81 items:
82 - minItems: 2 82 - minItems: 2
83 items: 83 items:
84 - description: phandle to the syscon 84 - description: phandle to the syscon node which encompases the glue register
85 - description: offset of the control 85 - description: offset of the control register
86 - description: field to set mask in 86 - description: field to set mask in register
87 description: 87 description:
88 Should be phandle/offset pair. The phand 88 Should be phandle/offset pair. The phandle to the syscon node which
89 encompases the glue register, the offset 89 encompases the glue register, the offset of the control register and
90 the mask to set bitfield in control regi 90 the mask to set bitfield in control register
91 91
92 st,ext-phyclk: 92 st,ext-phyclk:
93 description: 93 description:
94 set this property in RMII mode when you 94 set this property in RMII mode when you have PHY without crystal 50MHz and want to
95 select RCC clock instead of ETH_REF_CLK. 95 select RCC clock instead of ETH_REF_CLK. OR in RGMII mode when you want to select
96 RCC clock instead of ETH_CLK125. 96 RCC clock instead of ETH_CLK125.
97 type: boolean 97 type: boolean
98 98
99 st,eth-clk-sel: 99 st,eth-clk-sel:
100 description: 100 description:
101 set this property in RGMII PHY when you 101 set this property in RGMII PHY when you want to select RCC clock instead of ETH_CLK125.
102 type: boolean 102 type: boolean
103 103
104 st,eth-ref-clk-sel: 104 st,eth-ref-clk-sel:
105 description: 105 description:
106 set this property in RMII mode when you 106 set this property in RMII mode when you have PHY without crystal 50MHz and want to
107 select RCC clock instead of ETH_REF_CLK. 107 select RCC clock instead of ETH_REF_CLK.
108 type: boolean 108 type: boolean
109 109
110 access-controllers: 110 access-controllers:
111 minItems: 1 111 minItems: 1
112 maxItems: 2 112 maxItems: 2
113 113
114 required: 114 required:
115 - compatible 115 - compatible
116 - clocks 116 - clocks
117 - clock-names 117 - clock-names
118 - st,syscon 118 - st,syscon
119 119
120 unevaluatedProperties: false 120 unevaluatedProperties: false
121 121
122 allOf: 122 allOf:
123 - $ref: snps,dwmac.yaml# 123 - $ref: snps,dwmac.yaml#
124 - if: 124 - if:
125 properties: 125 properties:
126 compatible: 126 compatible:
127 contains: 127 contains:
128 enum: 128 enum:
129 - st,stm32-dwmac 129 - st,stm32-dwmac
130 - st,stm32mp1-dwmac 130 - st,stm32mp1-dwmac
131 - st,stm32mp25-dwmac 131 - st,stm32mp25-dwmac
132 then: 132 then:
133 properties: 133 properties:
134 st,syscon: 134 st,syscon:
135 items: 135 items:
136 minItems: 2 136 minItems: 2
137 maxItems: 2 137 maxItems: 2
138 138
139 - if: 139 - if:
140 properties: 140 properties:
141 compatible: 141 compatible:
142 contains: 142 contains:
143 enum: 143 enum:
144 - st,stm32mp13-dwmac 144 - st,stm32mp13-dwmac
145 then: 145 then:
146 properties: 146 properties:
147 st,syscon: 147 st,syscon:
148 items: 148 items:
149 minItems: 3 149 minItems: 3
150 maxItems: 3 150 maxItems: 3
151 151
152 examples: 152 examples:
153 - | 153 - |
154 #include <dt-bindings/interrupt-controller 154 #include <dt-bindings/interrupt-controller/arm-gic.h>
155 #include <dt-bindings/clock/stm32mp1-clks. 155 #include <dt-bindings/clock/stm32mp1-clks.h>
156 //Example 1 156 //Example 1
157 ethernet0: ethernet@5800a000 { 157 ethernet0: ethernet@5800a000 {
158 compatible = "st,stm32mp1-dwmac", " 158 compatible = "st,stm32mp1-dwmac", "snps,dwmac-4.20a";
159 reg = <0x5800a000 0x2000>; 159 reg = <0x5800a000 0x2000>;
160 reg-names = "stmmaceth"; 160 reg-names = "stmmaceth";
161 interrupts = <GIC_SPI 61 IRQ_TYPE_L 161 interrupts = <GIC_SPI 61 IRQ_TYPE_LEVEL_HIGH>;
162 interrupt-names = "macirq"; 162 interrupt-names = "macirq";
163 clock-names = "stmmaceth", 163 clock-names = "stmmaceth",
164 "mac-clk-tx", 164 "mac-clk-tx",
165 "mac-clk-rx", 165 "mac-clk-rx",
166 "ethstp", 166 "ethstp",
167 "eth-ck"; 167 "eth-ck";
168 clocks = <&rcc ETHMAC>, 168 clocks = <&rcc ETHMAC>,
169 <&rcc ETHTX>, 169 <&rcc ETHTX>,
170 <&rcc ETHRX>, 170 <&rcc ETHRX>,
171 <&rcc ETHSTP>, 171 <&rcc ETHSTP>,
172 <&rcc ETHCK_K>; 172 <&rcc ETHCK_K>;
173 st,syscon = <&syscfg 0x4>; 173 st,syscon = <&syscfg 0x4>;
174 snps,pbl = <2>; 174 snps,pbl = <2>;
175 snps,axi-config = <&stmmac_axi_conf 175 snps,axi-config = <&stmmac_axi_config_0>;
176 snps,tso; 176 snps,tso;
177 phy-mode = "rgmii"; 177 phy-mode = "rgmii";
178 }; 178 };
179 179
180 - | 180 - |
181 //Example 2 (MCU example) 181 //Example 2 (MCU example)
182 ethernet1: ethernet@40028000 { 182 ethernet1: ethernet@40028000 {
183 compatible = "st,stm32-dwmac", "snp 183 compatible = "st,stm32-dwmac", "snps,dwmac-3.50a";
184 reg = <0x40028000 0x8000>; 184 reg = <0x40028000 0x8000>;
185 reg-names = "stmmaceth"; 185 reg-names = "stmmaceth";
186 interrupts = <0 61 0>, <0 62 0>; 186 interrupts = <0 61 0>, <0 62 0>;
187 interrupt-names = "macirq", "eth_wa 187 interrupt-names = "macirq", "eth_wake_irq";
188 clock-names = "stmmaceth", "mac-clk 188 clock-names = "stmmaceth", "mac-clk-tx", "mac-clk-rx";
189 clocks = <&rcc 0 25>, <&rcc 0 26>, 189 clocks = <&rcc 0 25>, <&rcc 0 26>, <&rcc 0 27>;
190 st,syscon = <&syscfg 0x4>; 190 st,syscon = <&syscfg 0x4>;
191 snps,pbl = <8>; 191 snps,pbl = <8>;
192 snps,mixed-burst; 192 snps,mixed-burst;
193 phy-mode = "mii"; 193 phy-mode = "mii";
194 }; 194 };
195 195
196 - | 196 - |
197 //Example 3 197 //Example 3
198 ethernet2: ethernet@40027000 { 198 ethernet2: ethernet@40027000 {
199 compatible = "st,stm32-dwmac", "snp 199 compatible = "st,stm32-dwmac", "snps,dwmac-4.10a";
200 reg = <0x40028000 0x8000>; 200 reg = <0x40028000 0x8000>;
201 reg-names = "stmmaceth"; 201 reg-names = "stmmaceth";
202 interrupts = <61>; 202 interrupts = <61>;
203 interrupt-names = "macirq"; 203 interrupt-names = "macirq";
204 clock-names = "stmmaceth", "mac-clk 204 clock-names = "stmmaceth", "mac-clk-tx", "mac-clk-rx";
205 clocks = <&rcc 62>, <&rcc 61>, <&rc 205 clocks = <&rcc 62>, <&rcc 61>, <&rcc 60>;
206 st,syscon = <&syscfg 0x4>; 206 st,syscon = <&syscfg 0x4>;
207 snps,pbl = <8>; 207 snps,pbl = <8>;
208 phy-mode = "mii"; 208 phy-mode = "mii";
209 }; 209 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.