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

TOMOYO Linux Cross Reference
Linux/Documentation/devicetree/bindings/net/ethernet-controller.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/ethernet-controller.yaml (Version linux-6.12-rc7) and /Documentation/devicetree/bindings/net/ethernet-controller.yaml (Version linux-5.4.285)


  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/etherne      4 $id: http://devicetree.org/schemas/net/ethernet-controller.yaml#
  5 $schema: http://devicetree.org/meta-schemas/co      5 $schema: http://devicetree.org/meta-schemas/core.yaml#
  6                                                     6 
  7 title: Ethernet Controller Common Properties   !!   7 title: Ethernet Controller Generic Binding
  8                                                     8 
  9 maintainers:                                        9 maintainers:
 10   - David S. Miller <davem@davemloft.net>           10   - David S. Miller <davem@davemloft.net>
 11                                                    11 
 12 properties:                                        12 properties:
 13   $nodename:                                       13   $nodename:
 14     pattern: "^ethernet(@.*)?$"                    14     pattern: "^ethernet(@.*)?$"
 15                                                    15 
 16   label:                                       << 
 17     description: Human readable label on a por << 
 18                                                << 
 19   local-mac-address:                               16   local-mac-address:
                                                   >>  17     allOf:
                                                   >>  18       - $ref: /schemas/types.yaml#definitions/uint8-array
                                                   >>  19       - items:
                                                   >>  20           - minItems: 6
                                                   >>  21             maxItems: 6
 20     description:                                   22     description:
 21       Specifies the MAC address that was assig     23       Specifies the MAC address that was assigned to the network device.
 22     $ref: /schemas/types.yaml#/definitions/uin << 
 23     minItems: 6                                << 
 24     maxItems: 6                                << 
 25                                                    24 
 26   mac-address:                                     25   mac-address:
                                                   >>  26     allOf:
                                                   >>  27       - $ref: /schemas/types.yaml#definitions/uint8-array
                                                   >>  28       - items:
                                                   >>  29           - minItems: 6
                                                   >>  30             maxItems: 6
 27     description:                                   31     description:
 28       Specifies the MAC address that was last      32       Specifies the MAC address that was last used by the boot
 29       program; should be used in cases where t     33       program; should be used in cases where the MAC address assigned
 30       to the device by the boot program is dif     34       to the device by the boot program is different from the
 31       local-mac-address property.                  35       local-mac-address property.
 32     $ref: /schemas/types.yaml#/definitions/uin << 
 33     minItems: 6                                << 
 34     maxItems: 6                                << 
 35                                                    36 
 36   max-frame-size:                                  37   max-frame-size:
 37     $ref: /schemas/types.yaml#/definitions/uin !!  38     $ref: /schemas/types.yaml#definitions/uint32
 38     description:                                   39     description:
 39       Maximum transfer unit (IEEE defined MTU)     40       Maximum transfer unit (IEEE defined MTU), rather than the
 40       maximum frame size (there\'s contradicti     41       maximum frame size (there\'s contradiction in the Devicetree
 41       Specification).                              42       Specification).
 42                                                    43 
 43   max-speed:                                       44   max-speed:
 44     $ref: /schemas/types.yaml#/definitions/uin !!  45     $ref: /schemas/types.yaml#definitions/uint32
 45     description:                                   46     description:
 46       Specifies maximum speed in Mbit/s suppor     47       Specifies maximum speed in Mbit/s supported by the device.
 47                                                    48 
 48   nvmem-cells:                                     49   nvmem-cells:
 49     maxItems: 1                                    50     maxItems: 1
 50     description:                                   51     description:
 51       Reference to an nvmem node for the MAC a     52       Reference to an nvmem node for the MAC address
 52                                                    53 
 53   nvmem-cell-names:                                54   nvmem-cell-names:
 54     const: mac-address                             55     const: mac-address
 55                                                    56 
 56   phy-connection-type:                             57   phy-connection-type:
 57     description:                                   58     description:
 58       Specifies interface type between the Eth !!  59       Operation mode of the PHY interface
 59       layer (PHY) device.                      << 
 60     enum:                                          60     enum:
 61       # There is not a standard bus between th     61       # There is not a standard bus between the MAC and the PHY,
 62       # something proprietary is being used to     62       # something proprietary is being used to embed the PHY in the
 63       # MAC.                                       63       # MAC.
 64       - internal                                   64       - internal
 65       - mii                                        65       - mii
 66       - gmii                                       66       - gmii
 67       - sgmii                                      67       - sgmii
 68       - psgmii                                 << 
 69       - qsgmii                                     68       - qsgmii
 70       - qusgmii                                << 
 71       - tbi                                        69       - tbi
 72       - rev-mii                                    70       - rev-mii
 73       - rmii                                       71       - rmii
 74       - rev-rmii                               << 
 75       - moca                                   << 
 76                                                    72 
 77       # RX and TX delays are added by the MAC      73       # RX and TX delays are added by the MAC when required
 78       - rgmii                                      74       - rgmii
 79                                                    75 
 80       # RGMII with internal RX and TX delays p     76       # RGMII with internal RX and TX delays provided by the PHY,
 81       # the MAC should not add the RX or TX de     77       # the MAC should not add the RX or TX delays in this case
 82       - rgmii-id                                   78       - rgmii-id
 83                                                    79 
 84       # RGMII with internal RX delay provided      80       # RGMII with internal RX delay provided by the PHY, the MAC
 85       # should not add an RX delay in this cas     81       # should not add an RX delay in this case
 86       - rgmii-rxid                                 82       - rgmii-rxid
 87                                                    83 
 88       # RGMII with internal TX delay provided      84       # RGMII with internal TX delay provided by the PHY, the MAC
 89       # should not add an TX delay in this cas     85       # should not add an TX delay in this case
 90       - rgmii-txid                                 86       - rgmii-txid
 91       - rtbi                                       87       - rtbi
 92       - smii                                       88       - smii
 93       - xgmii                                      89       - xgmii
 94       - trgmii                                     90       - trgmii
 95       - 1000base-x                                 91       - 1000base-x
 96       - 2500base-x                                 92       - 2500base-x
 97       - 5gbase-r                               << 
 98       - rxaui                                      93       - rxaui
 99       - xaui                                       94       - xaui
100                                                    95 
101       # 10GBASE-KR, XFI, SFI                       96       # 10GBASE-KR, XFI, SFI
102       - 10gbase-kr                                 97       - 10gbase-kr
103       - usxgmii                                    98       - usxgmii
104       - 10gbase-r                              << 
105       - 25gbase-r                              << 
106       - 10g-qxgmii                             << 
107                                                    99 
108   phy-mode:                                       100   phy-mode:
109     $ref: "#/properties/phy-connection-type"      101     $ref: "#/properties/phy-connection-type"
110                                                   102 
111   pcs-handle:                                  << 
112     $ref: /schemas/types.yaml#/definitions/pha << 
113     items:                                     << 
114       maxItems: 1                              << 
115     description:                               << 
116       Specifies a reference to a node represen << 
117       bus to link with an external PHY (phy-ha << 
118                                                << 
119   pcs-handle-names:                            << 
120     description:                               << 
121       The name of each PCS in pcs-handle.      << 
122                                                << 
123   phy-handle:                                     103   phy-handle:
124     $ref: /schemas/types.yaml#/definitions/pha !! 104     $ref: /schemas/types.yaml#definitions/phandle
125     description:                                  105     description:
126       Specifies a reference to a node represen    106       Specifies a reference to a node representing a PHY device.
127                                                   107 
128   phy:                                            108   phy:
129     $ref: "#/properties/phy-handle"               109     $ref: "#/properties/phy-handle"
130     deprecated: true                              110     deprecated: true
131                                                   111 
132   phy-device:                                     112   phy-device:
133     $ref: "#/properties/phy-handle"               113     $ref: "#/properties/phy-handle"
134     deprecated: true                              114     deprecated: true
135                                                   115 
136   rx-fifo-depth:                                  116   rx-fifo-depth:
137     $ref: /schemas/types.yaml#/definitions/uin !! 117     $ref: /schemas/types.yaml#definitions/uint32
138     description:                                  118     description:
139       The size of the controller\'s receive fi    119       The size of the controller\'s receive fifo in bytes. This is used
140       for components that can have configurabl    120       for components that can have configurable receive fifo sizes,
141       and is useful for determining certain co    121       and is useful for determining certain configuration settings
142       such as flow control thresholds.            122       such as flow control thresholds.
143                                                   123 
144   sfp:                                         << 
145     $ref: /schemas/types.yaml#/definitions/pha << 
146     description:                               << 
147       Specifies a reference to a node represen << 
148                                                << 
149   tx-fifo-depth:                                  124   tx-fifo-depth:
150     $ref: /schemas/types.yaml#/definitions/uin !! 125     $ref: /schemas/types.yaml#definitions/uint32
151     description:                                  126     description:
152       The size of the controller\'s transmit f    127       The size of the controller\'s transmit fifo in bytes. This
153       is used for components that can have con    128       is used for components that can have configurable fifo sizes.
154                                                   129 
155   managed:                                        130   managed:
                                                   >> 131     allOf:
                                                   >> 132       - $ref: /schemas/types.yaml#definitions/string
                                                   >> 133       - default: auto
                                                   >> 134         enum:
                                                   >> 135           - auto
                                                   >> 136           - in-band-status
156     description:                                  137     description:
157       Specifies the PHY management type. If au    138       Specifies the PHY management type. If auto is set and fixed-link
158       is not specified, it uses MDIO for manag    139       is not specified, it uses MDIO for management.
159     $ref: /schemas/types.yaml#/definitions/str << 
160     default: auto                              << 
161     enum:                                      << 
162       - auto                                   << 
163       - in-band-status                         << 
164                                                   140 
165   fixed-link:                                     141   fixed-link:
166     oneOf:                                     !! 142     allOf:
167       - $ref: /schemas/types.yaml#/definitions !! 143       - if:
168         deprecated: true                       !! 144           type: array
169         items:                                 !! 145         then:
170           - minimum: 0                         !! 146           deprecated: true
171             maximum: 31                        !! 147           minItems: 1
172             description:                       !! 148           maxItems: 1
173               Emulated PHY ID, choose any but  !! 149           items:
174               specified fixed-links            !! 150             items:
175                                                !! 151               - minimum: 0
176           - enum: [0, 1]                       !! 152                 maximum: 31
177             description:                       !! 153                 description:
178               Duplex configuration. 0 for half !! 154                   Emulated PHY ID, choose any but unique to the all
179               full duplex                      !! 155                   specified fixed-links
180                                                !! 156 
181           - enum: [10, 100, 1000, 2500, 10000] !! 157               - enum: [0, 1]
182             description:                       !! 158                 description:
183               Link speed in Mbits/sec.         !! 159                   Duplex configuration. 0 for half duplex or 1 for
184                                                !! 160                   full duplex
185           - enum: [0, 1]                       !! 161 
186             description:                       !! 162               - enum: [10, 100, 1000]
187               Pause configuration. 0 for no pa !! 163                 description:
188                                                !! 164                   Link speed in Mbits/sec.
189           - enum: [0, 1]                       !! 165 
190             description:                       !! 166               - enum: [0, 1]
191               Asymmetric pause configuration.  !! 167                 description:
192               pause, 1 for asymmetric pause    !! 168                   Pause configuration. 0 for no pause, 1 for pause
193       - type: object                           !! 169 
194         additionalProperties: false            !! 170               - enum: [0, 1]
195         properties:                            !! 171                 description:
196           speed:                               !! 172                   Asymmetric pause configuration. 0 for no asymmetric
197             description:                       !! 173                   pause, 1 for asymmetric pause
198               Link speed.                      !! 174 
199             $ref: /schemas/types.yaml#/definit !! 175 
200             enum: [10, 100, 1000, 2500, 10000] !! 176       - if:
201                                                !! 177           type: object
202           full-duplex:                         !! 178         then:
203             $ref: /schemas/types.yaml#/definit !! 179           properties:
204             description:                       !! 180             speed:
205               Indicates that full-duplex is us !! 181               allOf:
206               duplex is assumed.               !! 182                 - $ref: /schemas/types.yaml#definitions/uint32
207                                                !! 183                 - enum: [10, 100, 1000]
208           pause:                               !! 184               description:
209             $ref: /schemas/types.yaml#/definit !! 185                 Link speed.
210             description:                       !! 186 
211               Indicates that pause should be e !! 187             full-duplex:
212                                                !! 188               $ref: /schemas/types.yaml#definitions/flag
213           asym-pause:                          !! 189               description:
214             $ref: /schemas/types.yaml#/definit !! 190                 Indicates that full-duplex is used. When absent, half
215             description:                       !! 191                 duplex is assumed.
216               Indicates that asym_pause should !! 192 
217                                                !! 193             pause:
218           link-gpios:                          !! 194               $ref: /schemas/types.yaml#definitions/flag
219             maxItems: 1                        !! 195               description:
220             description:                       !! 196                 Indicates that pause should be enabled.
221               GPIO to determine if the link is !! 197 
222                                                !! 198             asym-pause:
223         required:                              !! 199               $ref: /schemas/types.yaml#definitions/flag
224           - speed                              !! 200               description:
225                                                !! 201                 Indicates that asym_pause should be enabled.
226   leds:                                        !! 202 
227     description:                               !! 203             link-gpios:
228       Describes the LEDs associated by Etherne !! 204               maxItems: 1
229       These LEDs are not integrated in the PHY !! 205               description:
230       control on them. Ethernet Controller reg !! 206                 GPIO to determine if the link is up
231       these defined LEDs.                      << 
232                                                << 
233     type: object                               << 
234                                                << 
235     properties:                                << 
236       '#address-cells':                        << 
237         const: 1                               << 
238                                                << 
239       '#size-cells':                           << 
240         const: 0                               << 
241                                                << 
242     patternProperties:                         << 
243       '^led@[a-f0-9]+$':                       << 
244         $ref: /schemas/leds/common.yaml#       << 
245                                                << 
246         properties:                            << 
247           reg:                                 << 
248             maxItems: 1                        << 
249             description:                       << 
250               This define the LED index in the << 
251               driver dependent and required fo << 
252               LED for the same port.           << 
253                                                << 
254         required:                              << 
255           - reg                                << 
256                                                << 
257         unevaluatedProperties: false           << 
258                                                << 
259     additionalProperties: false                << 
260                                                << 
261 dependencies:                                  << 
262   pcs-handle-names: [pcs-handle]               << 
263                                                << 
264 allOf:                                         << 
265   - if:                                        << 
266       properties:                              << 
267         phy-mode:                              << 
268           contains:                            << 
269             enum:                              << 
270               - rgmii                          << 
271               - rgmii-rxid                     << 
272               - rgmii-txid                     << 
273               - rgmii-id                       << 
274     then:                                      << 
275       properties:                              << 
276         rx-internal-delay-ps:                  << 
277           description:                         << 
278             RGMII Receive Clock Delay defined  << 
279             controllers that have configurable << 
280             property is present then the MAC a << 
281         tx-internal-delay-ps:                  << 
282           description:                         << 
283             RGMII Transmit Clock Delay defined << 
284             controllers that have configurable << 
285             property is present then the MAC a << 
286                                                   207 
287 additionalProperties: true                     !! 208           required:
                                                   >> 209             - speed
288                                                   210 
289 ...                                               211 ...
                                                      

~ [ 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