1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/net/etherne
5 $schema: http://devicetree.org/meta-schemas/co
6
7 title: Ethernet PHY Common Properties
8
9 maintainers:
10 - Andrew Lunn <andrew@lunn.ch>
11 - Florian Fainelli <f.fainelli@gmail.com>
12 - Heiner Kallweit <hkallweit1@gmail.com>
13
14 # The dt-schema tools will generate a select s
15 # the compatible, and second by using the node
16 # case, the node name is the one we want to ma
17 # compatible is optional.
18 select:
19 properties:
20 $nodename:
21 pattern: "^ethernet-phy(@[a-f0-9]+)?$"
22
23 required:
24 - $nodename
25
26 properties:
27 $nodename:
28 pattern: "^ethernet-phy(@[a-f0-9]+)?$"
29
30 compatible:
31 oneOf:
32 - const: ethernet-phy-ieee802.3-c22
33 description: PHYs that implement IEEE8
34 - const: ethernet-phy-ieee802.3-c45
35 description: PHYs that implement IEEE8
36 - pattern: "^ethernet-phy-id[a-f0-9]{4}\
37 description:
38 If the PHY reports an incorrect ID (
39 compatible list may contain an entry
40 in the above form.
41 The first group of digits is the 16
42 register, this is the chip vendor OU
43 second group of digits is the Phy Id
44 this is the chip vendor OUI bits 19:
45 bits of a vendor specific ID.
46 - items:
47 - pattern: "^ethernet-phy-id[a-f0-9]
48 - const: ethernet-phy-ieee802.3-c22
49 - items:
50 - pattern: "^ethernet-phy-id[a-f0-9]
51 - const: ethernet-phy-ieee802.3-c45
52
53 reg:
54 minimum: 0
55 maximum: 31
56 description:
57 The ID number for the PHY.
58
59 interrupts:
60 maxItems: 1
61
62 max-speed:
63 enum:
64 - 10
65 - 100
66 - 1000
67 - 2500
68 - 5000
69 - 10000
70 - 20000
71 - 25000
72 - 40000
73 - 50000
74 - 56000
75 - 100000
76 - 200000
77 description:
78 Maximum PHY supported speed in Mbits / s
79
80 phy-10base-t1l-2.4vpp:
81 description: |
82 tristate, request/disable 2.4 Vpp operat
83 0: Disable 2.4 Vpp operating mode.
84 1: Request 2.4 Vpp operating mode from l
85 Absence of this property will leave conf
86 $ref: /schemas/types.yaml#/definitions/uin
87 enum: [0, 1]
88
89 broken-turn-around:
90 $ref: /schemas/types.yaml#/definitions/fla
91 description:
92 If set, indicates the PHY device does no
93 the turn around line low at end of the c
94 MDIO transaction.
95
96 brr-mode:
97 $ref: /schemas/types.yaml#/definitions/fla
98 description:
99 If set, indicates the network cable inte
100 defined in the BroadR-Reach link mode sp
101 1BR-10 names. The PHY must be configured
102 by software.
103
104 clocks:
105 maxItems: 1
106 description:
107 External clock connected to the PHY. If
108 that the PHY uses a fixed crystal or an
109
110 enet-phy-lane-swap:
111 $ref: /schemas/types.yaml#/definitions/fla
112 description:
113 If set, indicates the PHY will swap the
114 compensate for the board being designed
115 swapped.
116
117 enet-phy-lane-no-swap:
118 $ref: /schemas/types.yaml#/definitions/fla
119 description:
120 If set, indicates that PHY will disable
121 TX/RX lanes. This property allows the PH
122 e.g. wrong bootstrap configuration cause
123 layout design.
124
125 eee-broken-100tx:
126 $ref: /schemas/types.yaml#/definitions/fla
127 description:
128 Mark the corresponding energy efficient
129 broken and request the ethernet to stop
130
131 eee-broken-1000t:
132 $ref: /schemas/types.yaml#/definitions/fla
133 description:
134 Mark the corresponding energy efficient
135 broken and request the ethernet to stop
136
137 eee-broken-10gt:
138 $ref: /schemas/types.yaml#/definitions/fla
139 description:
140 Mark the corresponding energy efficient
141 broken and request the ethernet to stop
142
143 eee-broken-1000kx:
144 $ref: /schemas/types.yaml#/definitions/fla
145 description:
146 Mark the corresponding energy efficient
147 broken and request the ethernet to stop
148
149 eee-broken-10gkx4:
150 $ref: /schemas/types.yaml#/definitions/fla
151 description:
152 Mark the corresponding energy efficient
153 broken and request the ethernet to stop
154
155 eee-broken-10gkr:
156 $ref: /schemas/types.yaml#/definitions/fla
157 description:
158 Mark the corresponding energy efficient
159 broken and request the ethernet to stop
160
161 pses:
162 $ref: /schemas/types.yaml#/definitions/pha
163 maxItems: 1
164 description:
165 Specifies a reference to a node represen
166
167 phy-is-integrated:
168 $ref: /schemas/types.yaml#/definitions/fla
169 description:
170 If set, indicates that the PHY is integr
171 physical package as the Ethernet MAC. If
172 should be configured to ensure the integ
173 used. The absence of this property indic
174 should be configured so that the externa
175
176 resets:
177 maxItems: 1
178
179 reset-names:
180 const: phy
181
182 reset-gpios:
183 maxItems: 1
184 description:
185 The GPIO phandle and specifier for the P
186
187 reset-assert-us:
188 description:
189 Delay after the reset was asserted in mi
190 property is missing the delay will be sk
191
192 reset-deassert-us:
193 description:
194 Delay after the reset was deasserted in
195 this property is missing the delay will
196
197 sfp:
198 $ref: /schemas/types.yaml#/definitions/pha
199 description:
200 Specifies a reference to a node represen
201
202 rx-internal-delay-ps:
203 description: |
204 RGMII Receive PHY Clock Delay defined in
205 PHY's that have configurable RX internal
206 present then the PHY applies the RX dela
207
208 tx-internal-delay-ps:
209 description: |
210 RGMII Transmit PHY Clock Delay defined i
211 PHY's that have configurable TX internal
212 present then the PHY applies the TX dela
213
214 leds:
215 type: object
216
217 properties:
218 '#address-cells':
219 const: 1
220
221 '#size-cells':
222 const: 0
223
224 patternProperties:
225 '^led@[a-f0-9]+$':
226 $ref: /schemas/leds/common.yaml#
227
228 properties:
229 reg:
230 maxItems: 1
231 description:
232 This define the LED index in the
233 driver dependent and required fo
234 LED for the same port.
235
236 required:
237 - reg
238
239 unevaluatedProperties: false
240
241 additionalProperties: false
242
243 required:
244 - reg
245
246 additionalProperties: true
247
248 examples:
249 - |
250 #include <dt-bindings/leds/common.h>
251
252 ethernet {
253 #address-cells = <1>;
254 #size-cells = <0>;
255
256 ethernet-phy@0 {
257 compatible = "ethernet-phy-id0141.
258 interrupt-parent = <&PIC>;
259 interrupts = <35 1>;
260 reg = <0>;
261
262 resets = <&rst 8>;
263 reset-names = "phy";
264 reset-gpios = <&gpio1 4 1>;
265 reset-assert-us = <1000>;
266 reset-deassert-us = <2000>;
267
268 leds {
269 #address-cells = <1>;
270 #size-cells = <0>;
271
272 led@0 {
273 reg = <0>;
274 color = <LED_COLOR_ID_WHIT
275 function = LED_FUNCTION_LA
276 default-state = "keep";
277 };
278 };
279 };
280 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.