~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/devicetree/bindings/net/snps,dwmac.yaml

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /Documentation/devicetree/bindings/net/snps,dwmac.yaml (Version linux-6.12-rc7) and /Documentation/devicetree/bindings/net/snps,dwmac.yaml (Version linux-5.18.19)


  1 # SPDX-License-Identifier: GPL-2.0                  1 # SPDX-License-Identifier: GPL-2.0
  2 %YAML 1.2                                           2 %YAML 1.2
  3 ---                                                 3 ---
  4 $id: http://devicetree.org/schemas/net/snps,dw      4 $id: http://devicetree.org/schemas/net/snps,dwmac.yaml#
  5 $schema: http://devicetree.org/meta-schemas/co      5 $schema: http://devicetree.org/meta-schemas/core.yaml#
  6                                                     6 
  7 title: Synopsys DesignWare MAC                 !!   7 title: Synopsys DesignWare MAC Device Tree Bindings
  8                                                     8 
  9 maintainers:                                        9 maintainers:
 10   - Alexandre Torgue <alexandre.torgue@foss.st.     10   - Alexandre Torgue <alexandre.torgue@foss.st.com>
 11   - Giuseppe Cavallaro <peppe.cavallaro@st.com>     11   - Giuseppe Cavallaro <peppe.cavallaro@st.com>
 12   - Jose Abreu <joabreu@synopsys.com>               12   - Jose Abreu <joabreu@synopsys.com>
 13                                                    13 
 14 # Select every compatible, including the depre     14 # Select every compatible, including the deprecated ones. This way, we
 15 # will be able to report a warning when we hav     15 # will be able to report a warning when we have that compatible, since
 16 # we will validate the node thanks to the sele     16 # we will validate the node thanks to the select, but won't report it
 17 # as a valid value in the compatible property      17 # as a valid value in the compatible property description
 18 select:                                            18 select:
 19   properties:                                      19   properties:
 20     compatible:                                    20     compatible:
 21       contains:                                    21       contains:
 22         enum:                                      22         enum:
 23           - snps,dwmac                             23           - snps,dwmac
 24           - snps,dwmac-3.40a                       24           - snps,dwmac-3.40a
 25           - snps,dwmac-3.50a                       25           - snps,dwmac-3.50a
 26           - snps,dwmac-3.610                       26           - snps,dwmac-3.610
 27           - snps,dwmac-3.70a                       27           - snps,dwmac-3.70a
 28           - snps,dwmac-3.710                       28           - snps,dwmac-3.710
 29           - snps,dwmac-4.00                        29           - snps,dwmac-4.00
 30           - snps,dwmac-4.10a                       30           - snps,dwmac-4.10a
 31           - snps,dwmac-4.20a                       31           - snps,dwmac-4.20a
 32           - snps,dwmac-5.10a                       32           - snps,dwmac-5.10a
 33           - snps,dwmac-5.20                    << 
 34           - snps,dwxgmac                           33           - snps,dwxgmac
 35           - snps,dwxgmac-2.10                      34           - snps,dwxgmac-2.10
 36                                                    35 
 37           # Deprecated                             36           # Deprecated
 38           - st,spear600-gmac                       37           - st,spear600-gmac
 39                                                    38 
 40   required:                                        39   required:
 41     - compatible                                   40     - compatible
 42                                                    41 
 43 properties:                                        42 properties:
 44                                                    43 
 45   # We need to include all the compatibles fro     44   # We need to include all the compatibles from schemas that will
 46   # include that schemas, otherwise compatible     45   # include that schemas, otherwise compatible won't validate for
 47   # those.                                         46   # those.
 48   compatible:                                      47   compatible:
 49     contains:                                      48     contains:
 50       enum:                                        49       enum:
 51         - allwinner,sun7i-a20-gmac                 50         - allwinner,sun7i-a20-gmac
 52         - allwinner,sun8i-a83t-emac                51         - allwinner,sun8i-a83t-emac
 53         - allwinner,sun8i-h3-emac                  52         - allwinner,sun8i-h3-emac
 54         - allwinner,sun8i-r40-gmac                 53         - allwinner,sun8i-r40-gmac
 55         - allwinner,sun8i-v3s-emac                 54         - allwinner,sun8i-v3s-emac
 56         - allwinner,sun50i-a64-emac                55         - allwinner,sun50i-a64-emac
 57         - amlogic,meson6-dwmac                     56         - amlogic,meson6-dwmac
 58         - amlogic,meson8b-dwmac                    57         - amlogic,meson8b-dwmac
 59         - amlogic,meson8m2-dwmac                   58         - amlogic,meson8m2-dwmac
 60         - amlogic,meson-gxbb-dwmac                 59         - amlogic,meson-gxbb-dwmac
 61         - amlogic,meson-axg-dwmac                  60         - amlogic,meson-axg-dwmac
 62         - ingenic,jz4775-mac                       61         - ingenic,jz4775-mac
 63         - ingenic,x1000-mac                        62         - ingenic,x1000-mac
 64         - ingenic,x1600-mac                        63         - ingenic,x1600-mac
 65         - ingenic,x1830-mac                        64         - ingenic,x1830-mac
 66         - ingenic,x2000-mac                        65         - ingenic,x2000-mac
 67         - loongson,ls2k-dwmac                      66         - loongson,ls2k-dwmac
 68         - loongson,ls7a-dwmac                      67         - loongson,ls7a-dwmac
 69         - qcom,qcs404-ethqos                   << 
 70         - qcom,sa8775p-ethqos                  << 
 71         - qcom,sc8280xp-ethqos                 << 
 72         - qcom,sm8150-ethqos                   << 
 73         - renesas,r9a06g032-gmac               << 
 74         - renesas,rzn1-gmac                    << 
 75         - rockchip,px30-gmac                       68         - rockchip,px30-gmac
 76         - rockchip,rk3128-gmac                     69         - rockchip,rk3128-gmac
 77         - rockchip,rk3228-gmac                     70         - rockchip,rk3228-gmac
 78         - rockchip,rk3288-gmac                     71         - rockchip,rk3288-gmac
 79         - rockchip,rk3308-gmac                 << 
 80         - rockchip,rk3328-gmac                     72         - rockchip,rk3328-gmac
 81         - rockchip,rk3366-gmac                     73         - rockchip,rk3366-gmac
 82         - rockchip,rk3368-gmac                     74         - rockchip,rk3368-gmac
 83         - rockchip,rk3576-gmac                 << 
 84         - rockchip,rk3588-gmac                 << 
 85         - rockchip,rk3399-gmac                     75         - rockchip,rk3399-gmac
 86         - rockchip,rv1108-gmac                     76         - rockchip,rv1108-gmac
 87         - snps,dwmac                               77         - snps,dwmac
 88         - snps,dwmac-3.40a                         78         - snps,dwmac-3.40a
 89         - snps,dwmac-3.50a                         79         - snps,dwmac-3.50a
 90         - snps,dwmac-3.610                         80         - snps,dwmac-3.610
 91         - snps,dwmac-3.70a                         81         - snps,dwmac-3.70a
 92         - snps,dwmac-3.710                         82         - snps,dwmac-3.710
 93         - snps,dwmac-4.00                          83         - snps,dwmac-4.00
 94         - snps,dwmac-4.10a                         84         - snps,dwmac-4.10a
 95         - snps,dwmac-4.20a                         85         - snps,dwmac-4.20a
 96         - snps,dwmac-5.10a                         86         - snps,dwmac-5.10a
 97         - snps,dwmac-5.20                      << 
 98         - snps,dwxgmac                             87         - snps,dwxgmac
 99         - snps,dwxgmac-2.10                        88         - snps,dwxgmac-2.10
100         - starfive,jh7100-dwmac                << 
101         - starfive,jh7110-dwmac                << 
102                                                    89 
103   reg:                                             90   reg:
104     minItems: 1                                    91     minItems: 1
105     maxItems: 2                                    92     maxItems: 2
106                                                    93 
107   interrupts:                                      94   interrupts:
108     minItems: 1                                    95     minItems: 1
109     items:                                         96     items:
110       - description: Combined signal for vario     97       - description: Combined signal for various interrupt events
111       - description: The interrupt to manage t     98       - description: The interrupt to manage the remote wake-up packet detection
112       - description: The interrupt that occurs     99       - description: The interrupt that occurs when Rx exits the LPI state
113       - description: The interrupt that occurs << 
114                                                   100 
115   interrupt-names:                                101   interrupt-names:
116     minItems: 1                                   102     minItems: 1
117     items:                                        103     items:
118       - const: macirq                             104       - const: macirq
119       - enum: [eth_wake_irq, eth_lpi, sfty]    !! 105       - const: eth_wake_irq
120       - enum: [eth_wake_irq, eth_lpi, sfty]    !! 106       - const: eth_lpi
121       - enum: [eth_wake_irq, eth_lpi, sfty]    << 
122                                                   107 
123   clocks:                                         108   clocks:
124     minItems: 1                                   109     minItems: 1
125     maxItems: 8                                   110     maxItems: 8
126     additionalItems: true                         111     additionalItems: true
127     items:                                        112     items:
128       - description: GMAC main clock              113       - description: GMAC main clock
129       - description: Peripheral registers inte    114       - description: Peripheral registers interface clock
130       - description:                              115       - description:
131           PTP reference clock. This clock is u    116           PTP reference clock. This clock is used for programming the
132           Timestamp Addend Register. If not pa    117           Timestamp Addend Register. If not passed then the system
133           clock will be used and this is fine     118           clock will be used and this is fine on some platforms.
134                                                   119 
135   clock-names:                                    120   clock-names:
136     minItems: 1                                   121     minItems: 1
137     maxItems: 8                                   122     maxItems: 8
138     additionalItems: true                         123     additionalItems: true
139     contains:                                     124     contains:
140       enum:                                       125       enum:
141         - stmmaceth                               126         - stmmaceth
142         - pclk                                    127         - pclk
143         - ptp_ref                                 128         - ptp_ref
144                                                   129 
145   resets:                                         130   resets:
146     minItems: 1                                !! 131     maxItems: 1
147     items:                                     !! 132     description:
148       - description: GMAC stmmaceth reset      !! 133       MAC Reset signal.
149       - description: AHB reset                 << 
150                                                   134 
151   reset-names:                                    135   reset-names:
152     oneOf:                                     !! 136     const: stmmaceth
153       - items:                                 << 
154           - enum: [stmmaceth, ahb]             << 
155       - items:                                 << 
156           - const: stmmaceth                   << 
157           - const: ahb                         << 
158                                                << 
159   power-domains:                               << 
160     maxItems: 1                                << 
161                                                   137 
162   mac-mode:                                       138   mac-mode:
163     $ref: ethernet-controller.yaml#/properties    139     $ref: ethernet-controller.yaml#/properties/phy-connection-type
164     description:                                  140     description:
165       The property is identical to 'phy-mode',    141       The property is identical to 'phy-mode', and assumes that there is mode
166       converter in-between the MAC & PHY (e.g.    142       converter in-between the MAC & PHY (e.g. GMII-to-RGMII). This converter
167       can be passive (no SW requirement), and     143       can be passive (no SW requirement), and requires that the MAC operate
168       in a different mode than the PHY in orde    144       in a different mode than the PHY in order to function.
169                                                   145 
170   snps,axi-config:                                146   snps,axi-config:
171     $ref: /schemas/types.yaml#/definitions/pha    147     $ref: /schemas/types.yaml#/definitions/phandle
172     description:                                  148     description:
173       AXI BUS Mode parameters. Phandle to a no    149       AXI BUS Mode parameters. Phandle to a node that can contain the
174       following properties                        150       following properties
175         * snps,lpi_en, enable Low Power Interf    151         * snps,lpi_en, enable Low Power Interface
176         * snps,xit_frm, unlock on WoL             152         * snps,xit_frm, unlock on WoL
177         * snps,wr_osr_lmt, max write outstandi    153         * snps,wr_osr_lmt, max write outstanding req. limit
178         * snps,rd_osr_lmt, max read outstandin    154         * snps,rd_osr_lmt, max read outstanding req. limit
179         * snps,kbbe, do not cross 1KiB boundar    155         * snps,kbbe, do not cross 1KiB boundary.
180         * snps,blen, this is a vector of suppo    156         * snps,blen, this is a vector of supported burst length.
181         * snps,fb, fixed-burst                    157         * snps,fb, fixed-burst
182         * snps,mb, mixed-burst                    158         * snps,mb, mixed-burst
183         * snps,rb, rebuild INCRx Burst            159         * snps,rb, rebuild INCRx Burst
184                                                   160 
185   snps,mtl-rx-config:                             161   snps,mtl-rx-config:
186     $ref: /schemas/types.yaml#/definitions/pha    162     $ref: /schemas/types.yaml#/definitions/phandle
187     description:                                  163     description:
188       Multiple RX Queues parameters. Phandle t !! 164       Multiple RX Queues parameters. Phandle to a node that can
189       implements the 'rx-queues-config' object !! 165       contain the following properties
190       this binding.                            !! 166         * snps,rx-queues-to-use, number of RX queues to be used in the
191                                                !! 167           driver
192   rx-queues-config:                            !! 168         * Choose one of these RX scheduling algorithms
193     type: object                               !! 169           * snps,rx-sched-sp, Strict priority
194     properties:                                !! 170           * snps,rx-sched-wsp, Weighted Strict priority
195       snps,rx-queues-to-use:                   !! 171         * For each RX queue
196         $ref: /schemas/types.yaml#/definitions !! 172           * Choose one of these modes
197         description: number of RX queues to be !! 173             * snps,dcb-algorithm, Queue to be enabled as DCB
198       snps,rx-sched-sp:                        !! 174             * snps,avb-algorithm, Queue to be enabled as AVB
199         type: boolean                          !! 175           * snps,map-to-dma-channel, Channel to map
200         description: Strict priority           !! 176           * Specifiy specific packet routing
201       snps,rx-sched-wsp:                       !! 177             * snps,route-avcp, AV Untagged Control packets
202         type: boolean                          !! 178             * snps,route-ptp, PTP Packets
203         description: Weighted Strict priority  !! 179             * snps,route-dcbcp, DCB Control Packets
204     allOf:                                     !! 180             * snps,route-up, Untagged Packets
205       - if:                                    !! 181             * snps,route-multi-broad, Multicast & Broadcast Packets
206           required:                            !! 182           * snps,priority, bitmask of the tagged frames priorities assigned to
207             - snps,rx-sched-sp                 !! 183             the queue
208         then:                                  << 
209           properties:                          << 
210             snps,rx-sched-wsp: false           << 
211       - if:                                    << 
212           required:                            << 
213             - snps,rx-sched-wsp                << 
214         then:                                  << 
215           properties:                          << 
216             snps,rx-sched-sp: false            << 
217     patternProperties:                         << 
218       "^queue[0-9]$":                          << 
219         description: Each subnode represents a << 
220         type: object                           << 
221         properties:                            << 
222           snps,dcb-algorithm:                  << 
223             type: boolean                      << 
224             description: Queue to be enabled a << 
225           snps,avb-algorithm:                  << 
226             type: boolean                      << 
227             description: Queue to be enabled a << 
228           snps,map-to-dma-channel:             << 
229             $ref: /schemas/types.yaml#/definit << 
230             description: DMA channel id to map << 
231           snps,route-avcp:                     << 
232             type: boolean                      << 
233             description: AV Untagged Control p << 
234           snps,route-ptp:                      << 
235             type: boolean                      << 
236             description: PTP Packets           << 
237           snps,route-dcbcp:                    << 
238             type: boolean                      << 
239             description: DCB Control Packets   << 
240           snps,route-up:                       << 
241             type: boolean                      << 
242             description: Untagged Packets      << 
243           snps,route-multi-broad:              << 
244             type: boolean                      << 
245             description: Multicast & Broadcast << 
246           snps,priority:                       << 
247             $ref: /schemas/types.yaml#/definit << 
248             maxItems: 1                        << 
249             description: Bitmask of the tagged << 
250         allOf:                                 << 
251           - if:                                << 
252               required:                        << 
253                 - snps,dcb-algorithm           << 
254             then:                              << 
255               properties:                      << 
256                 snps,avb-algorithm: false      << 
257           - if:                                << 
258               required:                        << 
259                 - snps,avb-algorithm           << 
260             then:                              << 
261               properties:                      << 
262                 snps,dcb-algorithm: false      << 
263           - if:                                << 
264               required:                        << 
265                 - snps,route-avcp              << 
266             then:                              << 
267               properties:                      << 
268                 snps,route-ptp: false          << 
269                 snps,route-dcbcp: false        << 
270                 snps,route-up: false           << 
271                 snps,route-multi-broad: false  << 
272           - if:                                << 
273               required:                        << 
274                 - snps,route-ptp               << 
275             then:                              << 
276               properties:                      << 
277                 snps,route-avcp: false         << 
278                 snps,route-dcbcp: false        << 
279                 snps,route-up: false           << 
280                 snps,route-multi-broad: false  << 
281           - if:                                << 
282               required:                        << 
283                 - snps,route-dcbcp             << 
284             then:                              << 
285               properties:                      << 
286                 snps,route-avcp: false         << 
287                 snps,route-ptp: false          << 
288                 snps,route-up: false           << 
289                 snps,route-multi-broad: false  << 
290           - if:                                << 
291               required:                        << 
292                 - snps,route-up                << 
293             then:                              << 
294               properties:                      << 
295                 snps,route-avcp: false         << 
296                 snps,route-ptp: false          << 
297                 snps,route-dcbcp: false        << 
298                 snps,route-multi-broad: false  << 
299           - if:                                << 
300               required:                        << 
301                 - snps,route-multi-broad       << 
302             then:                              << 
303               properties:                      << 
304                 snps,route-avcp: false         << 
305                 snps,route-ptp: false          << 
306                 snps,route-dcbcp: false        << 
307                 snps,route-up: false           << 
308         additionalProperties: false            << 
309     additionalProperties: false                << 
310                                                   184 
311   snps,mtl-tx-config:                             185   snps,mtl-tx-config:
312     $ref: /schemas/types.yaml#/definitions/pha    186     $ref: /schemas/types.yaml#/definitions/phandle
313     description:                                  187     description:
314       Multiple TX Queues parameters. Phandle t !! 188       Multiple TX Queues parameters. Phandle to a node that can
315       implements the 'tx-queues-config' object !! 189       contain the following properties
316       this binding.                            !! 190         * snps,tx-queues-to-use, number of TX queues to be used in the
317                                                !! 191           driver
318   tx-queues-config:                            !! 192         * Choose one of these TX scheduling algorithms
319     type: object                               !! 193           * snps,tx-sched-wrr, Weighted Round Robin
320     properties:                                !! 194           * snps,tx-sched-wfq, Weighted Fair Queuing
321       snps,tx-queues-to-use:                   !! 195           * snps,tx-sched-dwrr, Deficit Weighted Round Robin
322         $ref: /schemas/types.yaml#/definitions !! 196           * snps,tx-sched-sp, Strict priority
323         description: number of TX queues to be !! 197         * For each TX queue
324       snps,tx-sched-wrr:                       !! 198           * snps,weight, TX queue weight (if using a DCB weight
325         type: boolean                          !! 199             algorithm)
326         description: Weighted Round Robin      !! 200           * Choose one of these modes
327       snps,tx-sched-wfq:                       !! 201             * snps,dcb-algorithm, TX queue will be working in DCB
328         type: boolean                          !! 202             * snps,avb-algorithm, TX queue will be working in AVB
329         description: Weighted Fair Queuing     !! 203               [Attention] Queue 0 is reserved for legacy traffic
330       snps,tx-sched-dwrr:                      !! 204                           and so no AVB is available in this queue.
331         type: boolean                          !! 205           * Configure Credit Base Shaper (if AVB Mode selected)
332         description: Deficit Weighted Round Ro !! 206             * snps,send_slope, enable Low Power Interface
333     allOf:                                     !! 207             * snps,idle_slope, unlock on WoL
334       - if:                                    !! 208             * snps,high_credit, max write outstanding req. limit
335           required:                            !! 209             * snps,low_credit, max read outstanding req. limit
336             - snps,tx-sched-wrr                !! 210           * snps,priority, bitmask of the priorities assigned to the queue.
337         then:                                  !! 211             When a PFC frame is received with priorities matching the bitmask,
338           properties:                          !! 212             the queue is blocked from transmitting for the pause time specified
339             snps,tx-sched-wfq: false           !! 213             in the PFC frame.
340             snps,tx-sched-dwrr: false          << 
341       - if:                                    << 
342           required:                            << 
343             - snps,tx-sched-wfq                << 
344         then:                                  << 
345           properties:                          << 
346             snps,tx-sched-wrr: false           << 
347             snps,tx-sched-dwrr: false          << 
348       - if:                                    << 
349           required:                            << 
350             - snps,tx-sched-dwrr               << 
351         then:                                  << 
352           properties:                          << 
353             snps,tx-sched-wrr: false           << 
354             snps,tx-sched-wfq: false           << 
355     patternProperties:                         << 
356       "^queue[0-9]$":                          << 
357         description: Each subnode represents a << 
358         type: object                           << 
359         properties:                            << 
360           snps,weight:                         << 
361             $ref: /schemas/types.yaml#/definit << 
362             description: TX queue weight (if u << 
363           snps,dcb-algorithm:                  << 
364             type: boolean                      << 
365             description: TX queue will be work << 
366           snps,avb-algorithm:                  << 
367             type: boolean                      << 
368             description:                       << 
369               TX queue will be working in AVB. << 
370               Queue 0 is reserved for legacy t << 
371               available in this queue.         << 
372           snps,send_slope:                     << 
373             $ref: /schemas/types.yaml#/definit << 
374             description: enable Low Power Inte << 
375           snps,idle_slope:                     << 
376             $ref: /schemas/types.yaml#/definit << 
377             description: unlock on WoL         << 
378           snps,high_credit:                    << 
379             $ref: /schemas/types.yaml#/definit << 
380             description: max write outstanding << 
381           snps,low_credit:                     << 
382             $ref: /schemas/types.yaml#/definit << 
383             description: max read outstanding  << 
384           snps,priority:                       << 
385             $ref: /schemas/types.yaml#/definit << 
386             maxItems: 1                        << 
387             description:                       << 
388               Bitmask of the tagged frames pri << 
389               When a PFC frame is received wit << 
390               the queue is blocked from transm << 
391               in the PFC frame.                << 
392                                                << 
393           snps,coe-unsupported:                << 
394             type: boolean                      << 
395             description: TX checksum offload i << 
396                                                << 
397         allOf:                                 << 
398           - if:                                << 
399               required:                        << 
400                 - snps,dcb-algorithm           << 
401             then:                              << 
402               properties:                      << 
403                 snps,avb-algorithm: false      << 
404           - if:                                << 
405               required:                        << 
406                 - snps,avb-algorithm           << 
407             then:                              << 
408               properties:                      << 
409                 snps,dcb-algorithm: false      << 
410                 snps,weight: false             << 
411         additionalProperties: false            << 
412     additionalProperties: false                << 
413                                                   214 
414   snps,reset-gpio:                                215   snps,reset-gpio:
415     deprecated: true                              216     deprecated: true
416     maxItems: 1                                   217     maxItems: 1
417     description:                                  218     description:
418       PHY Reset GPIO                              219       PHY Reset GPIO
419                                                   220 
420   snps,reset-active-low:                          221   snps,reset-active-low:
421     deprecated: true                              222     deprecated: true
422     $ref: /schemas/types.yaml#/definitions/fla    223     $ref: /schemas/types.yaml#/definitions/flag
423     description:                                  224     description:
424       Indicates that the PHY Reset is active l    225       Indicates that the PHY Reset is active low
425                                                   226 
426   snps,reset-delays-us:                           227   snps,reset-delays-us:
427     deprecated: true                              228     deprecated: true
428     description:                                  229     description:
429       Triplet of delays. The 1st cell is reset    230       Triplet of delays. The 1st cell is reset pre-delay in micro
430       seconds. The 2nd cell is reset pulse in     231       seconds. The 2nd cell is reset pulse in micro seconds. The 3rd
431       cell is reset post-delay in micro second    232       cell is reset post-delay in micro seconds.
432     minItems: 3                                   233     minItems: 3
433     maxItems: 3                                   234     maxItems: 3
434                                                   235 
435   snps,aal:                                       236   snps,aal:
436     $ref: /schemas/types.yaml#/definitions/fla    237     $ref: /schemas/types.yaml#/definitions/flag
437     description:                                  238     description:
438       Use Address-Aligned Beats                   239       Use Address-Aligned Beats
439                                                   240 
440   snps,pbl:                                    << 
441     description:                               << 
442       Programmable Burst Length (tx and rx)    << 
443     $ref: /schemas/types.yaml#/definitions/uin << 
444     enum: [1, 2, 4, 8, 16, 32]                 << 
445                                                << 
446   snps,txpbl:                                  << 
447     description:                               << 
448       Tx Programmable Burst Length. If set, DM << 
449       value rather than snps,pbl.              << 
450     $ref: /schemas/types.yaml#/definitions/uin << 
451     enum: [1, 2, 4, 8, 16, 32]                 << 
452                                                << 
453   snps,rxpbl:                                  << 
454     description:                               << 
455       Rx Programmable Burst Length. If set, DM << 
456       value rather than snps,pbl.              << 
457     $ref: /schemas/types.yaml#/definitions/uin << 
458     enum: [1, 2, 4, 8, 16, 32]                 << 
459                                                << 
460   snps,no-pbl-x8:                              << 
461     $ref: /schemas/types.yaml#/definitions/fla << 
462     description:                               << 
463       Don\'t multiply the pbl/txpbl/rxpbl valu << 
464       rev < 3.50, don\'t multiply the values b << 
465                                                << 
466   snps,fixed-burst:                               241   snps,fixed-burst:
467     $ref: /schemas/types.yaml#/definitions/fla    242     $ref: /schemas/types.yaml#/definitions/flag
468     description:                                  243     description:
469       Program the DMA to use the fixed burst m    244       Program the DMA to use the fixed burst mode
470                                                   245 
471   snps,mixed-burst:                               246   snps,mixed-burst:
472     $ref: /schemas/types.yaml#/definitions/fla    247     $ref: /schemas/types.yaml#/definitions/flag
473     description:                                  248     description:
474       Program the DMA to use the mixed burst m    249       Program the DMA to use the mixed burst mode
475                                                   250 
476   snps,force_thresh_dma_mode:                     251   snps,force_thresh_dma_mode:
477     $ref: /schemas/types.yaml#/definitions/fla    252     $ref: /schemas/types.yaml#/definitions/flag
478     description:                                  253     description:
479       Force DMA to use the threshold mode for     254       Force DMA to use the threshold mode for both tx and rx
480                                                   255 
481   snps,force_sf_dma_mode:                         256   snps,force_sf_dma_mode:
482     $ref: /schemas/types.yaml#/definitions/fla    257     $ref: /schemas/types.yaml#/definitions/flag
483     description:                                  258     description:
484       Force DMA to use the Store and Forward m    259       Force DMA to use the Store and Forward mode for both tx and
485       rx. This flag is ignored if force_thresh    260       rx. This flag is ignored if force_thresh_dma_mode is set.
486                                                   261 
487   snps,en-tx-lpi-clockgating:                     262   snps,en-tx-lpi-clockgating:
488     $ref: /schemas/types.yaml#/definitions/fla    263     $ref: /schemas/types.yaml#/definitions/flag
489     description:                                  264     description:
490       Enable gating of the MAC TX clock during    265       Enable gating of the MAC TX clock during TX low-power mode
491                                                   266 
492   snps,multicast-filter-bins:                     267   snps,multicast-filter-bins:
493     $ref: /schemas/types.yaml#/definitions/uin    268     $ref: /schemas/types.yaml#/definitions/uint32
494     description:                                  269     description:
495       Number of multicast filter hash bins sup    270       Number of multicast filter hash bins supported by this device
496       instance                                    271       instance
497                                                   272 
498   snps,perfect-filter-entries:                    273   snps,perfect-filter-entries:
499     $ref: /schemas/types.yaml#/definitions/uin    274     $ref: /schemas/types.yaml#/definitions/uint32
500     description:                                  275     description:
501       Number of perfect filter entries support    276       Number of perfect filter entries supported by this device
502       instance                                    277       instance
503                                                   278 
504   snps,ps-speed:                                  279   snps,ps-speed:
505     $ref: /schemas/types.yaml#/definitions/uin    280     $ref: /schemas/types.yaml#/definitions/uint32
506     description:                                  281     description:
507       Port selection speed that can be passed     282       Port selection speed that can be passed to the core when PCS
508       is supported. For example, this is used     283       is supported. For example, this is used in case of SGMII and
509       MAC2MAC connection.                         284       MAC2MAC connection.
510                                                   285 
511   snps,clk-csr:                                << 
512     $ref: /schemas/types.yaml#/definitions/uin << 
513     description:                               << 
514       Frequency division factor for MDC clock. << 
515                                                << 
516   snps,tso:                                    << 
517     $ref: /schemas/types.yaml#/definitions/fla << 
518     description:                               << 
519       Enables the TSO feature otherwise it wil << 
520       register.                                << 
521                                                << 
522   mdio:                                           286   mdio:
523     $ref: mdio.yaml#                              287     $ref: mdio.yaml#
524     unevaluatedProperties: false                  288     unevaluatedProperties: false
525     description:                                  289     description:
526       Creates and registers an MDIO bus.          290       Creates and registers an MDIO bus.
527                                                   291 
528     properties:                                   292     properties:
529       compatible:                                 293       compatible:
530         const: snps,dwmac-mdio                    294         const: snps,dwmac-mdio
531                                                   295 
532     required:                                     296     required:
533       - compatible                                297       - compatible
534                                                   298 
535   stmmac-axi-config:                           << 
536     type: object                               << 
537     unevaluatedProperties: false               << 
538     description:                               << 
539       AXI BUS Mode parameters.                 << 
540                                                << 
541     properties:                                << 
542       snps,lpi_en:                             << 
543         $ref: /schemas/types.yaml#/definitions << 
544         description:                           << 
545           enable Low Power Interface           << 
546                                                << 
547       snps,xit_frm:                            << 
548         $ref: /schemas/types.yaml#/definitions << 
549         description:                           << 
550           unlock on WoL                        << 
551                                                << 
552       snps,wr_osr_lmt:                         << 
553         $ref: /schemas/types.yaml#/definitions << 
554         description:                           << 
555           max write outstanding req. limit     << 
556                                                << 
557       snps,rd_osr_lmt:                         << 
558         $ref: /schemas/types.yaml#/definitions << 
559         description:                           << 
560           max read outstanding req. limit      << 
561                                                << 
562       snps,kbbe:                               << 
563         $ref: /schemas/types.yaml#/definitions << 
564         description:                           << 
565           do not cross 1KiB boundary.          << 
566                                                << 
567       snps,blen:                               << 
568         $ref: /schemas/types.yaml#/definitions << 
569         description:                           << 
570           this is a vector of supported burst  << 
571         minItems: 7                            << 
572         maxItems: 7                            << 
573                                                << 
574       snps,fb:                                 << 
575         $ref: /schemas/types.yaml#/definitions << 
576         description:                           << 
577           fixed-burst                          << 
578                                                << 
579       snps,mb:                                 << 
580         $ref: /schemas/types.yaml#/definitions << 
581         description:                           << 
582           mixed-burst                          << 
583                                                << 
584       snps,rb:                                 << 
585         $ref: /schemas/types.yaml#/definitions << 
586         description:                           << 
587           rebuild INCRx Burst                  << 
588                                                << 
589 required:                                         299 required:
590   - compatible                                    300   - compatible
591   - reg                                           301   - reg
592   - interrupts                                    302   - interrupts
593   - interrupt-names                               303   - interrupt-names
594   - phy-mode                                      304   - phy-mode
595                                                   305 
596 dependencies:                                     306 dependencies:
597   snps,reset-active-low: ["snps,reset-gpio"]      307   snps,reset-active-low: ["snps,reset-gpio"]
598   snps,reset-delays-us: ["snps,reset-gpio"]    !! 308   snps,reset-delay-us: ["snps,reset-gpio"]
599                                                   309 
600 allOf:                                            310 allOf:
601   - $ref: ethernet-controller.yaml#            !! 311   - $ref: "ethernet-controller.yaml#"
                                                   >> 312   - if:
                                                   >> 313       properties:
                                                   >> 314         compatible:
                                                   >> 315           contains:
                                                   >> 316             enum:
                                                   >> 317               - allwinner,sun7i-a20-gmac
                                                   >> 318               - allwinner,sun8i-a83t-emac
                                                   >> 319               - allwinner,sun8i-h3-emac
                                                   >> 320               - allwinner,sun8i-r40-gmac
                                                   >> 321               - allwinner,sun8i-v3s-emac
                                                   >> 322               - allwinner,sun50i-a64-emac
                                                   >> 323               - ingenic,jz4775-mac
                                                   >> 324               - ingenic,x1000-mac
                                                   >> 325               - ingenic,x1600-mac
                                                   >> 326               - ingenic,x1830-mac
                                                   >> 327               - ingenic,x2000-mac
                                                   >> 328               - snps,dwmac-3.50a
                                                   >> 329               - snps,dwmac-4.10a
                                                   >> 330               - snps,dwmac-4.20a
                                                   >> 331               - snps,dwxgmac
                                                   >> 332               - snps,dwxgmac-2.10
                                                   >> 333               - st,spear600-gmac
                                                   >> 334 
                                                   >> 335     then:
                                                   >> 336       properties:
                                                   >> 337         snps,pbl:
                                                   >> 338           description:
                                                   >> 339             Programmable Burst Length (tx and rx)
                                                   >> 340           $ref: /schemas/types.yaml#/definitions/uint32
                                                   >> 341           enum: [1, 2, 4, 8, 16, 32]
                                                   >> 342 
                                                   >> 343         snps,txpbl:
                                                   >> 344           description:
                                                   >> 345             Tx Programmable Burst Length. If set, DMA tx will use this
                                                   >> 346             value rather than snps,pbl.
                                                   >> 347           $ref: /schemas/types.yaml#/definitions/uint32
                                                   >> 348           enum: [1, 2, 4, 8, 16, 32]
                                                   >> 349 
                                                   >> 350         snps,rxpbl:
                                                   >> 351           description:
                                                   >> 352             Rx Programmable Burst Length. If set, DMA rx will use this
                                                   >> 353             value rather than snps,pbl.
                                                   >> 354           $ref: /schemas/types.yaml#/definitions/uint32
                                                   >> 355           enum: [1, 2, 4, 8, 16, 32]
                                                   >> 356 
                                                   >> 357         snps,no-pbl-x8:
                                                   >> 358           $ref: /schemas/types.yaml#/definitions/flag
                                                   >> 359           description:
                                                   >> 360             Don\'t multiply the pbl/txpbl/rxpbl values by 8. For core
                                                   >> 361             rev < 3.50, don\'t multiply the values by 4.
                                                   >> 362 
602   - if:                                           363   - if:
603       properties:                                 364       properties:
604         compatible:                               365         compatible:
605           not:                                 !! 366           contains:
606             contains:                          !! 367             enum:
607               enum:                            !! 368               - allwinner,sun7i-a20-gmac
608                 - allwinner,sun7i-a20-gmac     !! 369               - allwinner,sun8i-a83t-emac
609                 - allwinner,sun8i-a83t-emac    !! 370               - allwinner,sun8i-h3-emac
610                 - allwinner,sun8i-h3-emac      !! 371               - allwinner,sun8i-r40-gmac
611                 - allwinner,sun8i-r40-gmac     !! 372               - allwinner,sun8i-v3s-emac
612                 - allwinner,sun8i-v3s-emac     !! 373               - allwinner,sun50i-a64-emac
613                 - allwinner,sun50i-a64-emac    !! 374               - loongson,ls2k-dwmac
614                 - loongson,ls2k-dwmac          !! 375               - loongson,ls7a-dwmac
615                 - loongson,ls7a-dwmac          !! 376               - ingenic,jz4775-mac
616                 - ingenic,jz4775-mac           !! 377               - ingenic,x1000-mac
617                 - ingenic,x1000-mac            !! 378               - ingenic,x1600-mac
618                 - ingenic,x1600-mac            !! 379               - ingenic,x1830-mac
619                 - ingenic,x1830-mac            !! 380               - ingenic,x2000-mac
620                 - ingenic,x2000-mac            !! 381               - snps,dwmac-4.00
621                 - qcom,qcs404-ethqos           !! 382               - snps,dwmac-4.10a
622                 - qcom,sa8775p-ethqos          !! 383               - snps,dwmac-4.20a
623                 - qcom,sc8280xp-ethqos         !! 384               - snps,dwmac-5.10a
624                 - qcom,sm8150-ethqos           !! 385               - snps,dwxgmac
625                 - snps,dwmac-4.00              !! 386               - snps,dwxgmac-2.10
626                 - snps,dwmac-4.10a             !! 387               - st,spear600-gmac
627                 - snps,dwmac-4.20a             << 
628                 - snps,dwmac-5.10a             << 
629                 - snps,dwmac-5.20              << 
630                 - snps,dwxgmac                 << 
631                 - snps,dwxgmac-2.10            << 
632                 - st,spear600-gmac             << 
633                                                   388 
634     then:                                         389     then:
635       properties:                                 390       properties:
636         snps,tso: false                        !! 391         snps,tso:
                                                   >> 392           $ref: /schemas/types.yaml#/definitions/flag
                                                   >> 393           description:
                                                   >> 394             Enables the TSO feature otherwise it will be managed by
                                                   >> 395             MAC HW capability register.
637                                                   396 
638 additionalProperties: true                        397 additionalProperties: true
639                                                   398 
640 examples:                                         399 examples:
641   - |                                             400   - |
                                                   >> 401     stmmac_axi_setup: stmmac-axi-config {
                                                   >> 402         snps,wr_osr_lmt = <0xf>;
                                                   >> 403         snps,rd_osr_lmt = <0xf>;
                                                   >> 404         snps,blen = <256 128 64 32 0 0 0>;
                                                   >> 405     };
                                                   >> 406 
                                                   >> 407     mtl_rx_setup: rx-queues-config {
                                                   >> 408         snps,rx-queues-to-use = <1>;
                                                   >> 409         snps,rx-sched-sp;
                                                   >> 410         queue0 {
                                                   >> 411             snps,dcb-algorithm;
                                                   >> 412             snps,map-to-dma-channel = <0x0>;
                                                   >> 413             snps,priority = <0x0>;
                                                   >> 414         };
                                                   >> 415     };
                                                   >> 416 
                                                   >> 417     mtl_tx_setup: tx-queues-config {
                                                   >> 418         snps,tx-queues-to-use = <2>;
                                                   >> 419         snps,tx-sched-wrr;
                                                   >> 420         queue0 {
                                                   >> 421             snps,weight = <0x10>;
                                                   >> 422             snps,dcb-algorithm;
                                                   >> 423             snps,priority = <0x0>;
                                                   >> 424         };
                                                   >> 425 
                                                   >> 426         queue1 {
                                                   >> 427             snps,avb-algorithm;
                                                   >> 428             snps,send_slope = <0x1000>;
                                                   >> 429             snps,idle_slope = <0x1000>;
                                                   >> 430             snps,high_credit = <0x3E800>;
                                                   >> 431             snps,low_credit = <0xFFC18000>;
                                                   >> 432             snps,priority = <0x1>;
                                                   >> 433         };
                                                   >> 434     };
                                                   >> 435 
642     gmac0: ethernet@e0800000 {                    436     gmac0: ethernet@e0800000 {
643         compatible = "snps,dwxgmac-2.10", "snp    437         compatible = "snps,dwxgmac-2.10", "snps,dwxgmac";
644         reg = <0xe0800000 0x8000>;                438         reg = <0xe0800000 0x8000>;
645         interrupt-parent = <&vic1>;               439         interrupt-parent = <&vic1>;
646         interrupts = <24 23 22>;                  440         interrupts = <24 23 22>;
647         interrupt-names = "macirq", "eth_wake_    441         interrupt-names = "macirq", "eth_wake_irq", "eth_lpi";
648         mac-address = [000000000000]; /* Fille    442         mac-address = [000000000000]; /* Filled in by U-Boot */
649         max-frame-size = <3800>;                  443         max-frame-size = <3800>;
650         phy-mode = "gmii";                        444         phy-mode = "gmii";
651         snps,multicast-filter-bins = <256>;       445         snps,multicast-filter-bins = <256>;
652         snps,perfect-filter-entries = <128>;      446         snps,perfect-filter-entries = <128>;
653         rx-fifo-depth = <16384>;                  447         rx-fifo-depth = <16384>;
654         tx-fifo-depth = <16384>;                  448         tx-fifo-depth = <16384>;
655         clocks = <&clock>;                        449         clocks = <&clock>;
656         clock-names = "stmmaceth";                450         clock-names = "stmmaceth";
657         snps,axi-config = <&stmmac_axi_setup>;    451         snps,axi-config = <&stmmac_axi_setup>;
658         snps,mtl-rx-config = <&mtl_rx_setup>;     452         snps,mtl-rx-config = <&mtl_rx_setup>;
659         snps,mtl-tx-config = <&mtl_tx_setup>;     453         snps,mtl-tx-config = <&mtl_tx_setup>;
660                                                << 
661         stmmac_axi_setup: stmmac-axi-config {  << 
662             snps,wr_osr_lmt = <0xf>;           << 
663             snps,rd_osr_lmt = <0xf>;           << 
664             snps,blen = <256 128 64 32 0 0 0>; << 
665         };                                     << 
666                                                << 
667         mtl_rx_setup: rx-queues-config {       << 
668             snps,rx-queues-to-use = <1>;       << 
669             snps,rx-sched-sp;                  << 
670             queue0 {                           << 
671                 snps,dcb-algorithm;            << 
672                 snps,map-to-dma-channel = <0x0 << 
673                 snps,priority = <0x0>;         << 
674             };                                 << 
675         };                                     << 
676                                                << 
677         mtl_tx_setup: tx-queues-config {       << 
678             snps,tx-queues-to-use = <2>;       << 
679             snps,tx-sched-wrr;                 << 
680             queue0 {                           << 
681                 snps,weight = <0x10>;          << 
682                 snps,dcb-algorithm;            << 
683                 snps,priority = <0x0>;         << 
684             };                                 << 
685                                                << 
686             queue1 {                           << 
687                 snps,avb-algorithm;            << 
688                 snps,send_slope = <0x1000>;    << 
689                 snps,idle_slope = <0x1000>;    << 
690                 snps,high_credit = <0x3E800>;  << 
691                 snps,low_credit = <0xFFC18000> << 
692                 snps,priority = <0x1>;         << 
693             };                                 << 
694         };                                     << 
695                                                << 
696         mdio0 {                                   454         mdio0 {
697             #address-cells = <1>;                 455             #address-cells = <1>;
698             #size-cells = <0>;                    456             #size-cells = <0>;
699             compatible = "snps,dwmac-mdio";       457             compatible = "snps,dwmac-mdio";
700             phy1: ethernet-phy@0 {                458             phy1: ethernet-phy@0 {
701                 reg = <0>;                        459                 reg = <0>;
702             };                                    460             };
703         };                                        461         };
704     };                                            462     };
705                                                   463 
706 # FIXME: We should set it, but it would report    464 # FIXME: We should set it, but it would report all the generic
707 # properties as additional properties.            465 # properties as additional properties.
708 # additionalProperties: false                     466 # additionalProperties: false
709                                                   467 
710 ...                                               468 ...
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php