Loading...
1// SPDX-License-Identifier: GPL-2.0+
2/*
3 * Core PHY library, taken from phy.c
4 */
5#include <linux/export.h>
6#include <linux/phy.h>
7#include <linux/of.h>
8
9/**
10 * phy_speed_to_str - Return a string representing the PHY link speed
11 *
12 * @speed: Speed of the link
13 */
14const char *phy_speed_to_str(int speed)
15{
16 BUILD_BUG_ON_MSG(__ETHTOOL_LINK_MODE_MASK_NBITS != 103,
17 "Enum ethtool_link_mode_bit_indices and phylib are out of sync. "
18 "If a speed or mode has been added please update phy_speed_to_str "
19 "and the PHY settings array.\n");
20
21 switch (speed) {
22 case SPEED_10:
23 return "10Mbps";
24 case SPEED_100:
25 return "100Mbps";
26 case SPEED_1000:
27 return "1Gbps";
28 case SPEED_2500:
29 return "2.5Gbps";
30 case SPEED_5000:
31 return "5Gbps";
32 case SPEED_10000:
33 return "10Gbps";
34 case SPEED_14000:
35 return "14Gbps";
36 case SPEED_20000:
37 return "20Gbps";
38 case SPEED_25000:
39 return "25Gbps";
40 case SPEED_40000:
41 return "40Gbps";
42 case SPEED_50000:
43 return "50Gbps";
44 case SPEED_56000:
45 return "56Gbps";
46 case SPEED_100000:
47 return "100Gbps";
48 case SPEED_200000:
49 return "200Gbps";
50 case SPEED_400000:
51 return "400Gbps";
52 case SPEED_800000:
53 return "800Gbps";
54 case SPEED_UNKNOWN:
55 return "Unknown";
56 default:
57 return "Unsupported (update phy-core.c)";
58 }
59}
60EXPORT_SYMBOL_GPL(phy_speed_to_str);
61
62/**
63 * phy_duplex_to_str - Return string describing the duplex
64 *
65 * @duplex: Duplex setting to describe
66 */
67const char *phy_duplex_to_str(unsigned int duplex)
68{
69 if (duplex == DUPLEX_HALF)
70 return "Half";
71 if (duplex == DUPLEX_FULL)
72 return "Full";
73 if (duplex == DUPLEX_UNKNOWN)
74 return "Unknown";
75 return "Unsupported (update phy-core.c)";
76}
77EXPORT_SYMBOL_GPL(phy_duplex_to_str);
78
79/**
80 * phy_rate_matching_to_str - Return a string describing the rate matching
81 *
82 * @rate_matching: Type of rate matching to describe
83 */
84const char *phy_rate_matching_to_str(int rate_matching)
85{
86 switch (rate_matching) {
87 case RATE_MATCH_NONE:
88 return "none";
89 case RATE_MATCH_PAUSE:
90 return "pause";
91 case RATE_MATCH_CRS:
92 return "crs";
93 case RATE_MATCH_OPEN_LOOP:
94 return "open-loop";
95 }
96 return "Unsupported (update phy-core.c)";
97}
98EXPORT_SYMBOL_GPL(phy_rate_matching_to_str);
99
100/**
101 * phy_interface_num_ports - Return the number of links that can be carried by
102 * a given MAC-PHY physical link. Returns 0 if this is
103 * unknown, the number of links else.
104 *
105 * @interface: The interface mode we want to get the number of ports
106 */
107int phy_interface_num_ports(phy_interface_t interface)
108{
109 switch (interface) {
110 case PHY_INTERFACE_MODE_NA:
111 return 0;
112 case PHY_INTERFACE_MODE_INTERNAL:
113 case PHY_INTERFACE_MODE_MII:
114 case PHY_INTERFACE_MODE_GMII:
115 case PHY_INTERFACE_MODE_TBI:
116 case PHY_INTERFACE_MODE_REVMII:
117 case PHY_INTERFACE_MODE_RMII:
118 case PHY_INTERFACE_MODE_REVRMII:
119 case PHY_INTERFACE_MODE_RGMII:
120 case PHY_INTERFACE_MODE_RGMII_ID:
121 case PHY_INTERFACE_MODE_RGMII_RXID:
122 case PHY_INTERFACE_MODE_RGMII_TXID:
123 case PHY_INTERFACE_MODE_RTBI:
124 case PHY_INTERFACE_MODE_XGMII:
125 case PHY_INTERFACE_MODE_XLGMII:
126 case PHY_INTERFACE_MODE_MOCA:
127 case PHY_INTERFACE_MODE_TRGMII:
128 case PHY_INTERFACE_MODE_USXGMII:
129 case PHY_INTERFACE_MODE_SGMII:
130 case PHY_INTERFACE_MODE_SMII:
131 case PHY_INTERFACE_MODE_1000BASEX:
132 case PHY_INTERFACE_MODE_2500BASEX:
133 case PHY_INTERFACE_MODE_5GBASER:
134 case PHY_INTERFACE_MODE_10GBASER:
135 case PHY_INTERFACE_MODE_25GBASER:
136 case PHY_INTERFACE_MODE_10GKR:
137 case PHY_INTERFACE_MODE_100BASEX:
138 case PHY_INTERFACE_MODE_RXAUI:
139 case PHY_INTERFACE_MODE_XAUI:
140 case PHY_INTERFACE_MODE_1000BASEKX:
141 return 1;
142 case PHY_INTERFACE_MODE_QSGMII:
143 case PHY_INTERFACE_MODE_QUSGMII:
144 case PHY_INTERFACE_MODE_10G_QXGMII:
145 return 4;
146 case PHY_INTERFACE_MODE_PSGMII:
147 return 5;
148 case PHY_INTERFACE_MODE_MAX:
149 WARN_ONCE(1, "PHY_INTERFACE_MODE_MAX isn't a valid interface mode");
150 return 0;
151 }
152 return 0;
153}
154EXPORT_SYMBOL_GPL(phy_interface_num_ports);
155
156/* A mapping of all SUPPORTED settings to speed/duplex. This table
157 * must be grouped by speed and sorted in descending match priority
158 * - iow, descending speed.
159 */
160
161#define PHY_SETTING(s, d, b) { .speed = SPEED_ ## s, .duplex = DUPLEX_ ## d, \
162 .bit = ETHTOOL_LINK_MODE_ ## b ## _BIT}
163
164static const struct phy_setting settings[] = {
165 /* 800G */
166 PHY_SETTING( 800000, FULL, 800000baseCR8_Full ),
167 PHY_SETTING( 800000, FULL, 800000baseKR8_Full ),
168 PHY_SETTING( 800000, FULL, 800000baseDR8_Full ),
169 PHY_SETTING( 800000, FULL, 800000baseDR8_2_Full ),
170 PHY_SETTING( 800000, FULL, 800000baseSR8_Full ),
171 PHY_SETTING( 800000, FULL, 800000baseVR8_Full ),
172 /* 400G */
173 PHY_SETTING( 400000, FULL, 400000baseCR8_Full ),
174 PHY_SETTING( 400000, FULL, 400000baseKR8_Full ),
175 PHY_SETTING( 400000, FULL, 400000baseLR8_ER8_FR8_Full ),
176 PHY_SETTING( 400000, FULL, 400000baseDR8_Full ),
177 PHY_SETTING( 400000, FULL, 400000baseSR8_Full ),
178 PHY_SETTING( 400000, FULL, 400000baseCR4_Full ),
179 PHY_SETTING( 400000, FULL, 400000baseKR4_Full ),
180 PHY_SETTING( 400000, FULL, 400000baseLR4_ER4_FR4_Full ),
181 PHY_SETTING( 400000, FULL, 400000baseDR4_Full ),
182 PHY_SETTING( 400000, FULL, 400000baseSR4_Full ),
183 /* 200G */
184 PHY_SETTING( 200000, FULL, 200000baseCR4_Full ),
185 PHY_SETTING( 200000, FULL, 200000baseKR4_Full ),
186 PHY_SETTING( 200000, FULL, 200000baseLR4_ER4_FR4_Full ),
187 PHY_SETTING( 200000, FULL, 200000baseDR4_Full ),
188 PHY_SETTING( 200000, FULL, 200000baseSR4_Full ),
189 PHY_SETTING( 200000, FULL, 200000baseCR2_Full ),
190 PHY_SETTING( 200000, FULL, 200000baseKR2_Full ),
191 PHY_SETTING( 200000, FULL, 200000baseLR2_ER2_FR2_Full ),
192 PHY_SETTING( 200000, FULL, 200000baseDR2_Full ),
193 PHY_SETTING( 200000, FULL, 200000baseSR2_Full ),
194 /* 100G */
195 PHY_SETTING( 100000, FULL, 100000baseCR4_Full ),
196 PHY_SETTING( 100000, FULL, 100000baseKR4_Full ),
197 PHY_SETTING( 100000, FULL, 100000baseLR4_ER4_Full ),
198 PHY_SETTING( 100000, FULL, 100000baseSR4_Full ),
199 PHY_SETTING( 100000, FULL, 100000baseCR2_Full ),
200 PHY_SETTING( 100000, FULL, 100000baseKR2_Full ),
201 PHY_SETTING( 100000, FULL, 100000baseLR2_ER2_FR2_Full ),
202 PHY_SETTING( 100000, FULL, 100000baseDR2_Full ),
203 PHY_SETTING( 100000, FULL, 100000baseSR2_Full ),
204 PHY_SETTING( 100000, FULL, 100000baseCR_Full ),
205 PHY_SETTING( 100000, FULL, 100000baseKR_Full ),
206 PHY_SETTING( 100000, FULL, 100000baseLR_ER_FR_Full ),
207 PHY_SETTING( 100000, FULL, 100000baseDR_Full ),
208 PHY_SETTING( 100000, FULL, 100000baseSR_Full ),
209 /* 56G */
210 PHY_SETTING( 56000, FULL, 56000baseCR4_Full ),
211 PHY_SETTING( 56000, FULL, 56000baseKR4_Full ),
212 PHY_SETTING( 56000, FULL, 56000baseLR4_Full ),
213 PHY_SETTING( 56000, FULL, 56000baseSR4_Full ),
214 /* 50G */
215 PHY_SETTING( 50000, FULL, 50000baseCR2_Full ),
216 PHY_SETTING( 50000, FULL, 50000baseKR2_Full ),
217 PHY_SETTING( 50000, FULL, 50000baseSR2_Full ),
218 PHY_SETTING( 50000, FULL, 50000baseCR_Full ),
219 PHY_SETTING( 50000, FULL, 50000baseKR_Full ),
220 PHY_SETTING( 50000, FULL, 50000baseLR_ER_FR_Full ),
221 PHY_SETTING( 50000, FULL, 50000baseDR_Full ),
222 PHY_SETTING( 50000, FULL, 50000baseSR_Full ),
223 /* 40G */
224 PHY_SETTING( 40000, FULL, 40000baseCR4_Full ),
225 PHY_SETTING( 40000, FULL, 40000baseKR4_Full ),
226 PHY_SETTING( 40000, FULL, 40000baseLR4_Full ),
227 PHY_SETTING( 40000, FULL, 40000baseSR4_Full ),
228 /* 25G */
229 PHY_SETTING( 25000, FULL, 25000baseCR_Full ),
230 PHY_SETTING( 25000, FULL, 25000baseKR_Full ),
231 PHY_SETTING( 25000, FULL, 25000baseSR_Full ),
232 /* 20G */
233 PHY_SETTING( 20000, FULL, 20000baseKR2_Full ),
234 PHY_SETTING( 20000, FULL, 20000baseMLD2_Full ),
235 /* 10G */
236 PHY_SETTING( 10000, FULL, 10000baseCR_Full ),
237 PHY_SETTING( 10000, FULL, 10000baseER_Full ),
238 PHY_SETTING( 10000, FULL, 10000baseKR_Full ),
239 PHY_SETTING( 10000, FULL, 10000baseKX4_Full ),
240 PHY_SETTING( 10000, FULL, 10000baseLR_Full ),
241 PHY_SETTING( 10000, FULL, 10000baseLRM_Full ),
242 PHY_SETTING( 10000, FULL, 10000baseR_FEC ),
243 PHY_SETTING( 10000, FULL, 10000baseSR_Full ),
244 PHY_SETTING( 10000, FULL, 10000baseT_Full ),
245 /* 5G */
246 PHY_SETTING( 5000, FULL, 5000baseT_Full ),
247 /* 2.5G */
248 PHY_SETTING( 2500, FULL, 2500baseT_Full ),
249 PHY_SETTING( 2500, FULL, 2500baseX_Full ),
250 /* 1G */
251 PHY_SETTING( 1000, FULL, 1000baseT_Full ),
252 PHY_SETTING( 1000, HALF, 1000baseT_Half ),
253 PHY_SETTING( 1000, FULL, 1000baseT1_Full ),
254 PHY_SETTING( 1000, FULL, 1000baseX_Full ),
255 PHY_SETTING( 1000, FULL, 1000baseKX_Full ),
256 /* 100M */
257 PHY_SETTING( 100, FULL, 100baseT_Full ),
258 PHY_SETTING( 100, FULL, 100baseT1_Full ),
259 PHY_SETTING( 100, HALF, 100baseT_Half ),
260 PHY_SETTING( 100, HALF, 100baseFX_Half ),
261 PHY_SETTING( 100, FULL, 100baseFX_Full ),
262 /* 10M */
263 PHY_SETTING( 10, FULL, 10baseT_Full ),
264 PHY_SETTING( 10, HALF, 10baseT_Half ),
265 PHY_SETTING( 10, FULL, 10baseT1L_Full ),
266 PHY_SETTING( 10, FULL, 10baseT1S_Full ),
267 PHY_SETTING( 10, HALF, 10baseT1S_Half ),
268 PHY_SETTING( 10, HALF, 10baseT1S_P2MP_Half ),
269 PHY_SETTING( 10, FULL, 10baseT1BRR_Full ),
270};
271#undef PHY_SETTING
272
273/**
274 * phy_lookup_setting - lookup a PHY setting
275 * @speed: speed to match
276 * @duplex: duplex to match
277 * @mask: allowed link modes
278 * @exact: an exact match is required
279 *
280 * Search the settings array for a setting that matches the speed and
281 * duplex, and which is supported.
282 *
283 * If @exact is unset, either an exact match or %NULL for no match will
284 * be returned.
285 *
286 * If @exact is set, an exact match, the fastest supported setting at
287 * or below the specified speed, the slowest supported setting, or if
288 * they all fail, %NULL will be returned.
289 */
290const struct phy_setting *
291phy_lookup_setting(int speed, int duplex, const unsigned long *mask, bool exact)
292{
293 const struct phy_setting *p, *match = NULL, *last = NULL;
294 int i;
295
296 for (i = 0, p = settings; i < ARRAY_SIZE(settings); i++, p++) {
297 if (p->bit < __ETHTOOL_LINK_MODE_MASK_NBITS &&
298 test_bit(p->bit, mask)) {
299 last = p;
300 if (p->speed == speed && p->duplex == duplex) {
301 /* Exact match for speed and duplex */
302 match = p;
303 break;
304 } else if (!exact) {
305 if (!match && p->speed <= speed)
306 /* Candidate */
307 match = p;
308
309 if (p->speed < speed)
310 break;
311 }
312 }
313 }
314
315 if (!match && !exact)
316 match = last;
317
318 return match;
319}
320EXPORT_SYMBOL_GPL(phy_lookup_setting);
321
322size_t phy_speeds(unsigned int *speeds, size_t size,
323 unsigned long *mask)
324{
325 size_t count;
326 int i;
327
328 for (i = 0, count = 0; i < ARRAY_SIZE(settings) && count < size; i++)
329 if (settings[i].bit < __ETHTOOL_LINK_MODE_MASK_NBITS &&
330 test_bit(settings[i].bit, mask) &&
331 (count == 0 || speeds[count - 1] != settings[i].speed))
332 speeds[count++] = settings[i].speed;
333
334 return count;
335}
336
337static void __set_linkmode_max_speed(u32 max_speed, unsigned long *addr)
338{
339 const struct phy_setting *p;
340 int i;
341
342 for (i = 0, p = settings; i < ARRAY_SIZE(settings); i++, p++) {
343 if (p->speed > max_speed)
344 linkmode_clear_bit(p->bit, addr);
345 else
346 break;
347 }
348}
349
350static void __set_phy_supported(struct phy_device *phydev, u32 max_speed)
351{
352 __set_linkmode_max_speed(max_speed, phydev->supported);
353}
354
355/**
356 * phy_set_max_speed - Set the maximum speed the PHY should support
357 *
358 * @phydev: The phy_device struct
359 * @max_speed: Maximum speed
360 *
361 * The PHY might be more capable than the MAC. For example a Fast Ethernet
362 * is connected to a 1G PHY. This function allows the MAC to indicate its
363 * maximum speed, and so limit what the PHY will advertise.
364 */
365void phy_set_max_speed(struct phy_device *phydev, u32 max_speed)
366{
367 __set_phy_supported(phydev, max_speed);
368
369 phy_advertise_supported(phydev);
370}
371EXPORT_SYMBOL(phy_set_max_speed);
372
373void of_set_phy_supported(struct phy_device *phydev)
374{
375 struct device_node *node = phydev->mdio.dev.of_node;
376 u32 max_speed;
377
378 if (!IS_ENABLED(CONFIG_OF_MDIO))
379 return;
380
381 if (!node)
382 return;
383
384 if (!of_property_read_u32(node, "max-speed", &max_speed))
385 __set_phy_supported(phydev, max_speed);
386}
387
388void of_set_phy_eee_broken(struct phy_device *phydev)
389{
390 struct device_node *node = phydev->mdio.dev.of_node;
391 unsigned long *modes = phydev->eee_broken_modes;
392
393 if (!IS_ENABLED(CONFIG_OF_MDIO) || !node)
394 return;
395
396 linkmode_zero(modes);
397
398 if (of_property_read_bool(node, "eee-broken-100tx"))
399 linkmode_set_bit(ETHTOOL_LINK_MODE_100baseT_Full_BIT, modes);
400 if (of_property_read_bool(node, "eee-broken-1000t"))
401 linkmode_set_bit(ETHTOOL_LINK_MODE_1000baseT_Full_BIT, modes);
402 if (of_property_read_bool(node, "eee-broken-10gt"))
403 linkmode_set_bit(ETHTOOL_LINK_MODE_10000baseT_Full_BIT, modes);
404 if (of_property_read_bool(node, "eee-broken-1000kx"))
405 linkmode_set_bit(ETHTOOL_LINK_MODE_1000baseKX_Full_BIT, modes);
406 if (of_property_read_bool(node, "eee-broken-10gkx4"))
407 linkmode_set_bit(ETHTOOL_LINK_MODE_10000baseKX4_Full_BIT, modes);
408 if (of_property_read_bool(node, "eee-broken-10gkr"))
409 linkmode_set_bit(ETHTOOL_LINK_MODE_10000baseKR_Full_BIT, modes);
410}
411
412/**
413 * of_set_phy_timing_role - Set the master/slave mode of the PHY
414 *
415 * @phydev: The phy_device struct
416 *
417 * Set master/slave configuration of the PHY based on the device tree.
418 */
419void of_set_phy_timing_role(struct phy_device *phydev)
420{
421 struct device_node *node = phydev->mdio.dev.of_node;
422 const char *master;
423
424 if (!IS_ENABLED(CONFIG_OF_MDIO))
425 return;
426
427 if (!node)
428 return;
429
430 if (of_property_read_string(node, "timing-role", &master))
431 return;
432
433 if (strcmp(master, "forced-master") == 0)
434 phydev->master_slave_set = MASTER_SLAVE_CFG_MASTER_FORCE;
435 else if (strcmp(master, "forced-slave") == 0)
436 phydev->master_slave_set = MASTER_SLAVE_CFG_SLAVE_FORCE;
437 else if (strcmp(master, "preferred-master") == 0)
438 phydev->master_slave_set = MASTER_SLAVE_CFG_MASTER_PREFERRED;
439 else if (strcmp(master, "preferred-slave") == 0)
440 phydev->master_slave_set = MASTER_SLAVE_CFG_SLAVE_PREFERRED;
441 else
442 phydev_warn(phydev, "Unknown master-slave mode %s\n", master);
443}
444
445/**
446 * phy_resolve_aneg_pause - Determine pause autoneg results
447 *
448 * @phydev: The phy_device struct
449 *
450 * Once autoneg has completed the local pause settings can be
451 * resolved. Determine if pause and asymmetric pause should be used
452 * by the MAC.
453 */
454
455void phy_resolve_aneg_pause(struct phy_device *phydev)
456{
457 if (phydev->duplex == DUPLEX_FULL) {
458 phydev->pause = linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT,
459 phydev->lp_advertising);
460 phydev->asym_pause = linkmode_test_bit(
461 ETHTOOL_LINK_MODE_Asym_Pause_BIT,
462 phydev->lp_advertising);
463 }
464}
465EXPORT_SYMBOL_GPL(phy_resolve_aneg_pause);
466
467/**
468 * phy_resolve_aneg_linkmode - resolve the advertisements into PHY settings
469 * @phydev: The phy_device struct
470 *
471 * Resolve our and the link partner advertisements into their corresponding
472 * speed and duplex. If full duplex was negotiated, extract the pause mode
473 * from the link partner mask.
474 */
475void phy_resolve_aneg_linkmode(struct phy_device *phydev)
476{
477 __ETHTOOL_DECLARE_LINK_MODE_MASK(common);
478 int i;
479
480 linkmode_and(common, phydev->lp_advertising, phydev->advertising);
481
482 for (i = 0; i < ARRAY_SIZE(settings); i++)
483 if (test_bit(settings[i].bit, common)) {
484 phydev->speed = settings[i].speed;
485 phydev->duplex = settings[i].duplex;
486 break;
487 }
488
489 phy_resolve_aneg_pause(phydev);
490}
491EXPORT_SYMBOL_GPL(phy_resolve_aneg_linkmode);
492
493/**
494 * phy_check_downshift - check whether downshift occurred
495 * @phydev: The phy_device struct
496 *
497 * Check whether a downshift to a lower speed occurred. If this should be the
498 * case warn the user.
499 * Prerequisite for detecting downshift is that PHY driver implements the
500 * read_status callback and sets phydev->speed to the actual link speed.
501 */
502void phy_check_downshift(struct phy_device *phydev)
503{
504 __ETHTOOL_DECLARE_LINK_MODE_MASK(common);
505 int i, speed = SPEED_UNKNOWN;
506
507 phydev->downshifted_rate = 0;
508
509 if (phydev->autoneg == AUTONEG_DISABLE ||
510 phydev->speed == SPEED_UNKNOWN)
511 return;
512
513 linkmode_and(common, phydev->lp_advertising, phydev->advertising);
514
515 for (i = 0; i < ARRAY_SIZE(settings); i++)
516 if (test_bit(settings[i].bit, common)) {
517 speed = settings[i].speed;
518 break;
519 }
520
521 if (speed == SPEED_UNKNOWN || phydev->speed >= speed)
522 return;
523
524 phydev_warn(phydev, "Downshift occurred from negotiated speed %s to actual speed %s, check cabling!\n",
525 phy_speed_to_str(speed), phy_speed_to_str(phydev->speed));
526
527 phydev->downshifted_rate = 1;
528}
529EXPORT_SYMBOL_GPL(phy_check_downshift);
530
531static int phy_resolve_min_speed(struct phy_device *phydev, bool fdx_only)
532{
533 __ETHTOOL_DECLARE_LINK_MODE_MASK(common);
534 int i = ARRAY_SIZE(settings);
535
536 linkmode_and(common, phydev->lp_advertising, phydev->advertising);
537
538 while (--i >= 0) {
539 if (test_bit(settings[i].bit, common)) {
540 if (fdx_only && settings[i].duplex != DUPLEX_FULL)
541 continue;
542 return settings[i].speed;
543 }
544 }
545
546 return SPEED_UNKNOWN;
547}
548
549int phy_speed_down_core(struct phy_device *phydev)
550{
551 int min_common_speed = phy_resolve_min_speed(phydev, true);
552
553 if (min_common_speed == SPEED_UNKNOWN)
554 return -EINVAL;
555
556 __set_linkmode_max_speed(min_common_speed, phydev->advertising);
557
558 return 0;
559}
560
561static void mmd_phy_indirect(struct mii_bus *bus, int phy_addr, int devad,
562 u16 regnum)
563{
564 /* Write the desired MMD Devad */
565 __mdiobus_write(bus, phy_addr, MII_MMD_CTRL, devad);
566
567 /* Write the desired MMD register address */
568 __mdiobus_write(bus, phy_addr, MII_MMD_DATA, regnum);
569
570 /* Select the Function : DATA with no post increment */
571 __mdiobus_write(bus, phy_addr, MII_MMD_CTRL,
572 devad | MII_MMD_CTRL_NOINCR);
573}
574
575static int mmd_phy_read(struct mii_bus *bus, int phy_addr, bool is_c45,
576 int devad, u32 regnum)
577{
578 if (is_c45)
579 return __mdiobus_c45_read(bus, phy_addr, devad, regnum);
580
581 mmd_phy_indirect(bus, phy_addr, devad, regnum);
582 /* Read the content of the MMD's selected register */
583 return __mdiobus_read(bus, phy_addr, MII_MMD_DATA);
584}
585
586static int mmd_phy_write(struct mii_bus *bus, int phy_addr, bool is_c45,
587 int devad, u32 regnum, u16 val)
588{
589 if (is_c45)
590 return __mdiobus_c45_write(bus, phy_addr, devad, regnum, val);
591
592 mmd_phy_indirect(bus, phy_addr, devad, regnum);
593 /* Write the data into MMD's selected register */
594 return __mdiobus_write(bus, phy_addr, MII_MMD_DATA, val);
595}
596
597/**
598 * __phy_read_mmd - Convenience function for reading a register
599 * from an MMD on a given PHY.
600 * @phydev: The phy_device struct
601 * @devad: The MMD to read from (0..31)
602 * @regnum: The register on the MMD to read (0..65535)
603 *
604 * Same rules as for __phy_read();
605 */
606int __phy_read_mmd(struct phy_device *phydev, int devad, u32 regnum)
607{
608 if (regnum > (u16)~0 || devad > 32)
609 return -EINVAL;
610
611 if (phydev->drv && phydev->drv->read_mmd)
612 return phydev->drv->read_mmd(phydev, devad, regnum);
613
614 return mmd_phy_read(phydev->mdio.bus, phydev->mdio.addr,
615 phydev->is_c45, devad, regnum);
616}
617EXPORT_SYMBOL(__phy_read_mmd);
618
619/**
620 * phy_read_mmd - Convenience function for reading a register
621 * from an MMD on a given PHY.
622 * @phydev: The phy_device struct
623 * @devad: The MMD to read from
624 * @regnum: The register on the MMD to read
625 *
626 * Same rules as for phy_read();
627 */
628int phy_read_mmd(struct phy_device *phydev, int devad, u32 regnum)
629{
630 int ret;
631
632 phy_lock_mdio_bus(phydev);
633 ret = __phy_read_mmd(phydev, devad, regnum);
634 phy_unlock_mdio_bus(phydev);
635
636 return ret;
637}
638EXPORT_SYMBOL(phy_read_mmd);
639
640/**
641 * __phy_write_mmd - Convenience function for writing a register
642 * on an MMD on a given PHY.
643 * @phydev: The phy_device struct
644 * @devad: The MMD to read from
645 * @regnum: The register on the MMD to read
646 * @val: value to write to @regnum
647 *
648 * Same rules as for __phy_write();
649 */
650int __phy_write_mmd(struct phy_device *phydev, int devad, u32 regnum, u16 val)
651{
652 if (regnum > (u16)~0 || devad > 32)
653 return -EINVAL;
654
655 if (phydev->drv && phydev->drv->write_mmd)
656 return phydev->drv->write_mmd(phydev, devad, regnum, val);
657
658 return mmd_phy_write(phydev->mdio.bus, phydev->mdio.addr,
659 phydev->is_c45, devad, regnum, val);
660}
661EXPORT_SYMBOL(__phy_write_mmd);
662
663/**
664 * phy_write_mmd - Convenience function for writing a register
665 * on an MMD on a given PHY.
666 * @phydev: The phy_device struct
667 * @devad: The MMD to read from
668 * @regnum: The register on the MMD to read
669 * @val: value to write to @regnum
670 *
671 * Same rules as for phy_write();
672 */
673int phy_write_mmd(struct phy_device *phydev, int devad, u32 regnum, u16 val)
674{
675 int ret;
676
677 phy_lock_mdio_bus(phydev);
678 ret = __phy_write_mmd(phydev, devad, regnum, val);
679 phy_unlock_mdio_bus(phydev);
680
681 return ret;
682}
683EXPORT_SYMBOL(phy_write_mmd);
684
685/**
686 * __phy_package_read_mmd - read MMD reg relative to PHY package base addr
687 * @phydev: The phy_device struct
688 * @addr_offset: The offset to be added to PHY package base_addr
689 * @devad: The MMD to read from
690 * @regnum: The register on the MMD to read
691 *
692 * Convenience helper for reading a register of an MMD on a given PHY
693 * using the PHY package base address. The base address is added to
694 * the addr_offset value.
695 *
696 * Same calling rules as for __phy_read();
697 *
698 * NOTE: It's assumed that the entire PHY package is either C22 or C45.
699 */
700int __phy_package_read_mmd(struct phy_device *phydev,
701 unsigned int addr_offset, int devad,
702 u32 regnum)
703{
704 int addr = phy_package_address(phydev, addr_offset);
705
706 if (addr < 0)
707 return addr;
708
709 if (regnum > (u16)~0 || devad > 32)
710 return -EINVAL;
711
712 return mmd_phy_read(phydev->mdio.bus, addr, phydev->is_c45, devad,
713 regnum);
714}
715EXPORT_SYMBOL(__phy_package_read_mmd);
716
717/**
718 * phy_package_read_mmd - read MMD reg relative to PHY package base addr
719 * @phydev: The phy_device struct
720 * @addr_offset: The offset to be added to PHY package base_addr
721 * @devad: The MMD to read from
722 * @regnum: The register on the MMD to read
723 *
724 * Convenience helper for reading a register of an MMD on a given PHY
725 * using the PHY package base address. The base address is added to
726 * the addr_offset value.
727 *
728 * Same calling rules as for phy_read();
729 *
730 * NOTE: It's assumed that the entire PHY package is either C22 or C45.
731 */
732int phy_package_read_mmd(struct phy_device *phydev,
733 unsigned int addr_offset, int devad,
734 u32 regnum)
735{
736 int addr = phy_package_address(phydev, addr_offset);
737 int val;
738
739 if (addr < 0)
740 return addr;
741
742 if (regnum > (u16)~0 || devad > 32)
743 return -EINVAL;
744
745 phy_lock_mdio_bus(phydev);
746 val = mmd_phy_read(phydev->mdio.bus, addr, phydev->is_c45, devad,
747 regnum);
748 phy_unlock_mdio_bus(phydev);
749
750 return val;
751}
752EXPORT_SYMBOL(phy_package_read_mmd);
753
754/**
755 * __phy_package_write_mmd - write MMD reg relative to PHY package base addr
756 * @phydev: The phy_device struct
757 * @addr_offset: The offset to be added to PHY package base_addr
758 * @devad: The MMD to write to
759 * @regnum: The register on the MMD to write
760 * @val: value to write to @regnum
761 *
762 * Convenience helper for writing a register of an MMD on a given PHY
763 * using the PHY package base address. The base address is added to
764 * the addr_offset value.
765 *
766 * Same calling rules as for __phy_write();
767 *
768 * NOTE: It's assumed that the entire PHY package is either C22 or C45.
769 */
770int __phy_package_write_mmd(struct phy_device *phydev,
771 unsigned int addr_offset, int devad,
772 u32 regnum, u16 val)
773{
774 int addr = phy_package_address(phydev, addr_offset);
775
776 if (addr < 0)
777 return addr;
778
779 if (regnum > (u16)~0 || devad > 32)
780 return -EINVAL;
781
782 return mmd_phy_write(phydev->mdio.bus, addr, phydev->is_c45, devad,
783 regnum, val);
784}
785EXPORT_SYMBOL(__phy_package_write_mmd);
786
787/**
788 * phy_package_write_mmd - write MMD reg relative to PHY package base addr
789 * @phydev: The phy_device struct
790 * @addr_offset: The offset to be added to PHY package base_addr
791 * @devad: The MMD to write to
792 * @regnum: The register on the MMD to write
793 * @val: value to write to @regnum
794 *
795 * Convenience helper for writing a register of an MMD on a given PHY
796 * using the PHY package base address. The base address is added to
797 * the addr_offset value.
798 *
799 * Same calling rules as for phy_write();
800 *
801 * NOTE: It's assumed that the entire PHY package is either C22 or C45.
802 */
803int phy_package_write_mmd(struct phy_device *phydev,
804 unsigned int addr_offset, int devad,
805 u32 regnum, u16 val)
806{
807 int addr = phy_package_address(phydev, addr_offset);
808 int ret;
809
810 if (addr < 0)
811 return addr;
812
813 if (regnum > (u16)~0 || devad > 32)
814 return -EINVAL;
815
816 phy_lock_mdio_bus(phydev);
817 ret = mmd_phy_write(phydev->mdio.bus, addr, phydev->is_c45, devad,
818 regnum, val);
819 phy_unlock_mdio_bus(phydev);
820
821 return ret;
822}
823EXPORT_SYMBOL(phy_package_write_mmd);
824
825/**
826 * phy_modify_changed - Function for modifying a PHY register
827 * @phydev: the phy_device struct
828 * @regnum: register number to modify
829 * @mask: bit mask of bits to clear
830 * @set: new value of bits set in mask to write to @regnum
831 *
832 * NOTE: MUST NOT be called from interrupt context,
833 * because the bus read/write functions may wait for an interrupt
834 * to conclude the operation.
835 *
836 * Returns negative errno, 0 if there was no change, and 1 in case of change
837 */
838int phy_modify_changed(struct phy_device *phydev, u32 regnum, u16 mask, u16 set)
839{
840 int ret;
841
842 phy_lock_mdio_bus(phydev);
843 ret = __phy_modify_changed(phydev, regnum, mask, set);
844 phy_unlock_mdio_bus(phydev);
845
846 return ret;
847}
848EXPORT_SYMBOL_GPL(phy_modify_changed);
849
850/**
851 * __phy_modify - Convenience function for modifying a PHY register
852 * @phydev: the phy_device struct
853 * @regnum: register number to modify
854 * @mask: bit mask of bits to clear
855 * @set: new value of bits set in mask to write to @regnum
856 *
857 * NOTE: MUST NOT be called from interrupt context,
858 * because the bus read/write functions may wait for an interrupt
859 * to conclude the operation.
860 */
861int __phy_modify(struct phy_device *phydev, u32 regnum, u16 mask, u16 set)
862{
863 int ret;
864
865 ret = __phy_modify_changed(phydev, regnum, mask, set);
866
867 return ret < 0 ? ret : 0;
868}
869EXPORT_SYMBOL_GPL(__phy_modify);
870
871/**
872 * phy_modify - Convenience function for modifying a given PHY register
873 * @phydev: the phy_device struct
874 * @regnum: register number to write
875 * @mask: bit mask of bits to clear
876 * @set: new value of bits set in mask to write to @regnum
877 *
878 * NOTE: MUST NOT be called from interrupt context,
879 * because the bus read/write functions may wait for an interrupt
880 * to conclude the operation.
881 */
882int phy_modify(struct phy_device *phydev, u32 regnum, u16 mask, u16 set)
883{
884 int ret;
885
886 phy_lock_mdio_bus(phydev);
887 ret = __phy_modify(phydev, regnum, mask, set);
888 phy_unlock_mdio_bus(phydev);
889
890 return ret;
891}
892EXPORT_SYMBOL_GPL(phy_modify);
893
894/**
895 * __phy_modify_mmd_changed - Function for modifying a register on MMD
896 * @phydev: the phy_device struct
897 * @devad: the MMD containing register to modify
898 * @regnum: register number to modify
899 * @mask: bit mask of bits to clear
900 * @set: new value of bits set in mask to write to @regnum
901 *
902 * Unlocked helper function which allows a MMD register to be modified as
903 * new register value = (old register value & ~mask) | set
904 *
905 * Returns negative errno, 0 if there was no change, and 1 in case of change
906 */
907int __phy_modify_mmd_changed(struct phy_device *phydev, int devad, u32 regnum,
908 u16 mask, u16 set)
909{
910 int new, ret;
911
912 ret = __phy_read_mmd(phydev, devad, regnum);
913 if (ret < 0)
914 return ret;
915
916 new = (ret & ~mask) | set;
917 if (new == ret)
918 return 0;
919
920 ret = __phy_write_mmd(phydev, devad, regnum, new);
921
922 return ret < 0 ? ret : 1;
923}
924EXPORT_SYMBOL_GPL(__phy_modify_mmd_changed);
925
926/**
927 * phy_modify_mmd_changed - Function for modifying a register on MMD
928 * @phydev: the phy_device struct
929 * @devad: the MMD containing register to modify
930 * @regnum: register number to modify
931 * @mask: bit mask of bits to clear
932 * @set: new value of bits set in mask to write to @regnum
933 *
934 * NOTE: MUST NOT be called from interrupt context,
935 * because the bus read/write functions may wait for an interrupt
936 * to conclude the operation.
937 *
938 * Returns negative errno, 0 if there was no change, and 1 in case of change
939 */
940int phy_modify_mmd_changed(struct phy_device *phydev, int devad, u32 regnum,
941 u16 mask, u16 set)
942{
943 int ret;
944
945 phy_lock_mdio_bus(phydev);
946 ret = __phy_modify_mmd_changed(phydev, devad, regnum, mask, set);
947 phy_unlock_mdio_bus(phydev);
948
949 return ret;
950}
951EXPORT_SYMBOL_GPL(phy_modify_mmd_changed);
952
953/**
954 * __phy_modify_mmd - Convenience function for modifying a register on MMD
955 * @phydev: the phy_device struct
956 * @devad: the MMD containing register to modify
957 * @regnum: register number to modify
958 * @mask: bit mask of bits to clear
959 * @set: new value of bits set in mask to write to @regnum
960 *
961 * NOTE: MUST NOT be called from interrupt context,
962 * because the bus read/write functions may wait for an interrupt
963 * to conclude the operation.
964 */
965int __phy_modify_mmd(struct phy_device *phydev, int devad, u32 regnum,
966 u16 mask, u16 set)
967{
968 int ret;
969
970 ret = __phy_modify_mmd_changed(phydev, devad, regnum, mask, set);
971
972 return ret < 0 ? ret : 0;
973}
974EXPORT_SYMBOL_GPL(__phy_modify_mmd);
975
976/**
977 * phy_modify_mmd - Convenience function for modifying a register on MMD
978 * @phydev: the phy_device struct
979 * @devad: the MMD containing register to modify
980 * @regnum: register number to modify
981 * @mask: bit mask of bits to clear
982 * @set: new value of bits set in mask to write to @regnum
983 *
984 * NOTE: MUST NOT be called from interrupt context,
985 * because the bus read/write functions may wait for an interrupt
986 * to conclude the operation.
987 */
988int phy_modify_mmd(struct phy_device *phydev, int devad, u32 regnum,
989 u16 mask, u16 set)
990{
991 int ret;
992
993 phy_lock_mdio_bus(phydev);
994 ret = __phy_modify_mmd(phydev, devad, regnum, mask, set);
995 phy_unlock_mdio_bus(phydev);
996
997 return ret;
998}
999EXPORT_SYMBOL_GPL(phy_modify_mmd);
1000
1001static int __phy_read_page(struct phy_device *phydev)
1002{
1003 if (WARN_ONCE(!phydev->drv->read_page, "read_page callback not available, PHY driver not loaded?\n"))
1004 return -EOPNOTSUPP;
1005
1006 return phydev->drv->read_page(phydev);
1007}
1008
1009static int __phy_write_page(struct phy_device *phydev, int page)
1010{
1011 if (WARN_ONCE(!phydev->drv->write_page, "write_page callback not available, PHY driver not loaded?\n"))
1012 return -EOPNOTSUPP;
1013
1014 return phydev->drv->write_page(phydev, page);
1015}
1016
1017/**
1018 * phy_save_page() - take the bus lock and save the current page
1019 * @phydev: a pointer to a &struct phy_device
1020 *
1021 * Take the MDIO bus lock, and return the current page number. On error,
1022 * returns a negative errno. phy_restore_page() must always be called
1023 * after this, irrespective of success or failure of this call.
1024 */
1025int phy_save_page(struct phy_device *phydev)
1026{
1027 phy_lock_mdio_bus(phydev);
1028 return __phy_read_page(phydev);
1029}
1030EXPORT_SYMBOL_GPL(phy_save_page);
1031
1032/**
1033 * phy_select_page() - take the bus lock, save the current page, and set a page
1034 * @phydev: a pointer to a &struct phy_device
1035 * @page: desired page
1036 *
1037 * Take the MDIO bus lock to protect against concurrent access, save the
1038 * current PHY page, and set the current page. On error, returns a
1039 * negative errno, otherwise returns the previous page number.
1040 * phy_restore_page() must always be called after this, irrespective
1041 * of success or failure of this call.
1042 */
1043int phy_select_page(struct phy_device *phydev, int page)
1044{
1045 int ret, oldpage;
1046
1047 oldpage = ret = phy_save_page(phydev);
1048 if (ret < 0)
1049 return ret;
1050
1051 if (oldpage != page) {
1052 ret = __phy_write_page(phydev, page);
1053 if (ret < 0)
1054 return ret;
1055 }
1056
1057 return oldpage;
1058}
1059EXPORT_SYMBOL_GPL(phy_select_page);
1060
1061/**
1062 * phy_restore_page() - restore the page register and release the bus lock
1063 * @phydev: a pointer to a &struct phy_device
1064 * @oldpage: the old page, return value from phy_save_page() or phy_select_page()
1065 * @ret: operation's return code
1066 *
1067 * Release the MDIO bus lock, restoring @oldpage if it is a valid page.
1068 * This function propagates the earliest error code from the group of
1069 * operations.
1070 *
1071 * Returns:
1072 * @oldpage if it was a negative value, otherwise
1073 * @ret if it was a negative errno value, otherwise
1074 * phy_write_page()'s negative value if it were in error, otherwise
1075 * @ret.
1076 */
1077int phy_restore_page(struct phy_device *phydev, int oldpage, int ret)
1078{
1079 int r;
1080
1081 if (oldpage >= 0) {
1082 r = __phy_write_page(phydev, oldpage);
1083
1084 /* Propagate the operation return code if the page write
1085 * was successful.
1086 */
1087 if (ret >= 0 && r < 0)
1088 ret = r;
1089 } else {
1090 /* Propagate the phy page selection error code */
1091 ret = oldpage;
1092 }
1093
1094 phy_unlock_mdio_bus(phydev);
1095
1096 return ret;
1097}
1098EXPORT_SYMBOL_GPL(phy_restore_page);
1099
1100/**
1101 * phy_read_paged() - Convenience function for reading a paged register
1102 * @phydev: a pointer to a &struct phy_device
1103 * @page: the page for the phy
1104 * @regnum: register number
1105 *
1106 * Same rules as for phy_read().
1107 */
1108int phy_read_paged(struct phy_device *phydev, int page, u32 regnum)
1109{
1110 int ret = 0, oldpage;
1111
1112 oldpage = phy_select_page(phydev, page);
1113 if (oldpage >= 0)
1114 ret = __phy_read(phydev, regnum);
1115
1116 return phy_restore_page(phydev, oldpage, ret);
1117}
1118EXPORT_SYMBOL(phy_read_paged);
1119
1120/**
1121 * phy_write_paged() - Convenience function for writing a paged register
1122 * @phydev: a pointer to a &struct phy_device
1123 * @page: the page for the phy
1124 * @regnum: register number
1125 * @val: value to write
1126 *
1127 * Same rules as for phy_write().
1128 */
1129int phy_write_paged(struct phy_device *phydev, int page, u32 regnum, u16 val)
1130{
1131 int ret = 0, oldpage;
1132
1133 oldpage = phy_select_page(phydev, page);
1134 if (oldpage >= 0)
1135 ret = __phy_write(phydev, regnum, val);
1136
1137 return phy_restore_page(phydev, oldpage, ret);
1138}
1139EXPORT_SYMBOL(phy_write_paged);
1140
1141/**
1142 * phy_modify_paged_changed() - Function for modifying a paged register
1143 * @phydev: a pointer to a &struct phy_device
1144 * @page: the page for the phy
1145 * @regnum: register number
1146 * @mask: bit mask of bits to clear
1147 * @set: bit mask of bits to set
1148 *
1149 * Returns negative errno, 0 if there was no change, and 1 in case of change
1150 */
1151int phy_modify_paged_changed(struct phy_device *phydev, int page, u32 regnum,
1152 u16 mask, u16 set)
1153{
1154 int ret = 0, oldpage;
1155
1156 oldpage = phy_select_page(phydev, page);
1157 if (oldpage >= 0)
1158 ret = __phy_modify_changed(phydev, regnum, mask, set);
1159
1160 return phy_restore_page(phydev, oldpage, ret);
1161}
1162EXPORT_SYMBOL(phy_modify_paged_changed);
1163
1164/**
1165 * phy_modify_paged() - Convenience function for modifying a paged register
1166 * @phydev: a pointer to a &struct phy_device
1167 * @page: the page for the phy
1168 * @regnum: register number
1169 * @mask: bit mask of bits to clear
1170 * @set: bit mask of bits to set
1171 *
1172 * Same rules as for phy_read() and phy_write().
1173 */
1174int phy_modify_paged(struct phy_device *phydev, int page, u32 regnum,
1175 u16 mask, u16 set)
1176{
1177 int ret = phy_modify_paged_changed(phydev, page, regnum, mask, set);
1178
1179 return ret < 0 ? ret : 0;
1180}
1181EXPORT_SYMBOL(phy_modify_paged);
1// SPDX-License-Identifier: GPL-2.0+
2/*
3 * Core PHY library, taken from phy.c
4 */
5#include <linux/export.h>
6#include <linux/phy.h>
7#include <linux/of.h>
8
9const char *phy_speed_to_str(int speed)
10{
11 BUILD_BUG_ON_MSG(__ETHTOOL_LINK_MODE_MASK_NBITS != 69,
12 "Enum ethtool_link_mode_bit_indices and phylib are out of sync. "
13 "If a speed or mode has been added please update phy_speed_to_str "
14 "and the PHY settings array.\n");
15
16 switch (speed) {
17 case SPEED_10:
18 return "10Mbps";
19 case SPEED_100:
20 return "100Mbps";
21 case SPEED_1000:
22 return "1Gbps";
23 case SPEED_2500:
24 return "2.5Gbps";
25 case SPEED_5000:
26 return "5Gbps";
27 case SPEED_10000:
28 return "10Gbps";
29 case SPEED_14000:
30 return "14Gbps";
31 case SPEED_20000:
32 return "20Gbps";
33 case SPEED_25000:
34 return "25Gbps";
35 case SPEED_40000:
36 return "40Gbps";
37 case SPEED_50000:
38 return "50Gbps";
39 case SPEED_56000:
40 return "56Gbps";
41 case SPEED_100000:
42 return "100Gbps";
43 case SPEED_200000:
44 return "200Gbps";
45 case SPEED_UNKNOWN:
46 return "Unknown";
47 default:
48 return "Unsupported (update phy-core.c)";
49 }
50}
51EXPORT_SYMBOL_GPL(phy_speed_to_str);
52
53const char *phy_duplex_to_str(unsigned int duplex)
54{
55 if (duplex == DUPLEX_HALF)
56 return "Half";
57 if (duplex == DUPLEX_FULL)
58 return "Full";
59 if (duplex == DUPLEX_UNKNOWN)
60 return "Unknown";
61 return "Unsupported (update phy-core.c)";
62}
63EXPORT_SYMBOL_GPL(phy_duplex_to_str);
64
65/* A mapping of all SUPPORTED settings to speed/duplex. This table
66 * must be grouped by speed and sorted in descending match priority
67 * - iow, descending speed. */
68
69#define PHY_SETTING(s, d, b) { .speed = SPEED_ ## s, .duplex = DUPLEX_ ## d, \
70 .bit = ETHTOOL_LINK_MODE_ ## b ## _BIT}
71
72static const struct phy_setting settings[] = {
73 /* 200G */
74 PHY_SETTING( 200000, FULL, 200000baseCR4_Full ),
75 PHY_SETTING( 200000, FULL, 200000baseKR4_Full ),
76 PHY_SETTING( 200000, FULL, 200000baseLR4_ER4_FR4_Full ),
77 PHY_SETTING( 200000, FULL, 200000baseDR4_Full ),
78 PHY_SETTING( 200000, FULL, 200000baseSR4_Full ),
79 /* 100G */
80 PHY_SETTING( 100000, FULL, 100000baseCR4_Full ),
81 PHY_SETTING( 100000, FULL, 100000baseKR4_Full ),
82 PHY_SETTING( 100000, FULL, 100000baseLR4_ER4_Full ),
83 PHY_SETTING( 100000, FULL, 100000baseSR4_Full ),
84 PHY_SETTING( 100000, FULL, 100000baseCR2_Full ),
85 PHY_SETTING( 100000, FULL, 100000baseKR2_Full ),
86 PHY_SETTING( 100000, FULL, 100000baseLR2_ER2_FR2_Full ),
87 PHY_SETTING( 100000, FULL, 100000baseDR2_Full ),
88 PHY_SETTING( 100000, FULL, 100000baseSR2_Full ),
89 /* 56G */
90 PHY_SETTING( 56000, FULL, 56000baseCR4_Full ),
91 PHY_SETTING( 56000, FULL, 56000baseKR4_Full ),
92 PHY_SETTING( 56000, FULL, 56000baseLR4_Full ),
93 PHY_SETTING( 56000, FULL, 56000baseSR4_Full ),
94 /* 50G */
95 PHY_SETTING( 50000, FULL, 50000baseCR2_Full ),
96 PHY_SETTING( 50000, FULL, 50000baseKR2_Full ),
97 PHY_SETTING( 50000, FULL, 50000baseSR2_Full ),
98 PHY_SETTING( 50000, FULL, 50000baseCR_Full ),
99 PHY_SETTING( 50000, FULL, 50000baseKR_Full ),
100 PHY_SETTING( 50000, FULL, 50000baseLR_ER_FR_Full ),
101 PHY_SETTING( 50000, FULL, 50000baseDR_Full ),
102 PHY_SETTING( 50000, FULL, 50000baseSR_Full ),
103 /* 40G */
104 PHY_SETTING( 40000, FULL, 40000baseCR4_Full ),
105 PHY_SETTING( 40000, FULL, 40000baseKR4_Full ),
106 PHY_SETTING( 40000, FULL, 40000baseLR4_Full ),
107 PHY_SETTING( 40000, FULL, 40000baseSR4_Full ),
108 /* 25G */
109 PHY_SETTING( 25000, FULL, 25000baseCR_Full ),
110 PHY_SETTING( 25000, FULL, 25000baseKR_Full ),
111 PHY_SETTING( 25000, FULL, 25000baseSR_Full ),
112 /* 20G */
113 PHY_SETTING( 20000, FULL, 20000baseKR2_Full ),
114 PHY_SETTING( 20000, FULL, 20000baseMLD2_Full ),
115 /* 10G */
116 PHY_SETTING( 10000, FULL, 10000baseCR_Full ),
117 PHY_SETTING( 10000, FULL, 10000baseER_Full ),
118 PHY_SETTING( 10000, FULL, 10000baseKR_Full ),
119 PHY_SETTING( 10000, FULL, 10000baseKX4_Full ),
120 PHY_SETTING( 10000, FULL, 10000baseLR_Full ),
121 PHY_SETTING( 10000, FULL, 10000baseLRM_Full ),
122 PHY_SETTING( 10000, FULL, 10000baseR_FEC ),
123 PHY_SETTING( 10000, FULL, 10000baseSR_Full ),
124 PHY_SETTING( 10000, FULL, 10000baseT_Full ),
125 /* 5G */
126 PHY_SETTING( 5000, FULL, 5000baseT_Full ),
127 /* 2.5G */
128 PHY_SETTING( 2500, FULL, 2500baseT_Full ),
129 PHY_SETTING( 2500, FULL, 2500baseX_Full ),
130 /* 1G */
131 PHY_SETTING( 1000, FULL, 1000baseKX_Full ),
132 PHY_SETTING( 1000, FULL, 1000baseT_Full ),
133 PHY_SETTING( 1000, HALF, 1000baseT_Half ),
134 PHY_SETTING( 1000, FULL, 1000baseT1_Full ),
135 PHY_SETTING( 1000, FULL, 1000baseX_Full ),
136 /* 100M */
137 PHY_SETTING( 100, FULL, 100baseT_Full ),
138 PHY_SETTING( 100, FULL, 100baseT1_Full ),
139 PHY_SETTING( 100, HALF, 100baseT_Half ),
140 /* 10M */
141 PHY_SETTING( 10, FULL, 10baseT_Full ),
142 PHY_SETTING( 10, HALF, 10baseT_Half ),
143};
144#undef PHY_SETTING
145
146/**
147 * phy_lookup_setting - lookup a PHY setting
148 * @speed: speed to match
149 * @duplex: duplex to match
150 * @mask: allowed link modes
151 * @exact: an exact match is required
152 *
153 * Search the settings array for a setting that matches the speed and
154 * duplex, and which is supported.
155 *
156 * If @exact is unset, either an exact match or %NULL for no match will
157 * be returned.
158 *
159 * If @exact is set, an exact match, the fastest supported setting at
160 * or below the specified speed, the slowest supported setting, or if
161 * they all fail, %NULL will be returned.
162 */
163const struct phy_setting *
164phy_lookup_setting(int speed, int duplex, const unsigned long *mask, bool exact)
165{
166 const struct phy_setting *p, *match = NULL, *last = NULL;
167 int i;
168
169 for (i = 0, p = settings; i < ARRAY_SIZE(settings); i++, p++) {
170 if (p->bit < __ETHTOOL_LINK_MODE_MASK_NBITS &&
171 test_bit(p->bit, mask)) {
172 last = p;
173 if (p->speed == speed && p->duplex == duplex) {
174 /* Exact match for speed and duplex */
175 match = p;
176 break;
177 } else if (!exact) {
178 if (!match && p->speed <= speed)
179 /* Candidate */
180 match = p;
181
182 if (p->speed < speed)
183 break;
184 }
185 }
186 }
187
188 if (!match && !exact)
189 match = last;
190
191 return match;
192}
193EXPORT_SYMBOL_GPL(phy_lookup_setting);
194
195size_t phy_speeds(unsigned int *speeds, size_t size,
196 unsigned long *mask)
197{
198 size_t count;
199 int i;
200
201 for (i = 0, count = 0; i < ARRAY_SIZE(settings) && count < size; i++)
202 if (settings[i].bit < __ETHTOOL_LINK_MODE_MASK_NBITS &&
203 test_bit(settings[i].bit, mask) &&
204 (count == 0 || speeds[count - 1] != settings[i].speed))
205 speeds[count++] = settings[i].speed;
206
207 return count;
208}
209
210static int __set_linkmode_max_speed(u32 max_speed, unsigned long *addr)
211{
212 const struct phy_setting *p;
213 int i;
214
215 for (i = 0, p = settings; i < ARRAY_SIZE(settings); i++, p++) {
216 if (p->speed > max_speed)
217 linkmode_clear_bit(p->bit, addr);
218 else
219 break;
220 }
221
222 return 0;
223}
224
225static int __set_phy_supported(struct phy_device *phydev, u32 max_speed)
226{
227 return __set_linkmode_max_speed(max_speed, phydev->supported);
228}
229
230int phy_set_max_speed(struct phy_device *phydev, u32 max_speed)
231{
232 int err;
233
234 err = __set_phy_supported(phydev, max_speed);
235 if (err)
236 return err;
237
238 phy_advertise_supported(phydev);
239
240 return 0;
241}
242EXPORT_SYMBOL(phy_set_max_speed);
243
244void of_set_phy_supported(struct phy_device *phydev)
245{
246 struct device_node *node = phydev->mdio.dev.of_node;
247 u32 max_speed;
248
249 if (!IS_ENABLED(CONFIG_OF_MDIO))
250 return;
251
252 if (!node)
253 return;
254
255 if (!of_property_read_u32(node, "max-speed", &max_speed))
256 __set_phy_supported(phydev, max_speed);
257}
258
259void of_set_phy_eee_broken(struct phy_device *phydev)
260{
261 struct device_node *node = phydev->mdio.dev.of_node;
262 u32 broken = 0;
263
264 if (!IS_ENABLED(CONFIG_OF_MDIO))
265 return;
266
267 if (!node)
268 return;
269
270 if (of_property_read_bool(node, "eee-broken-100tx"))
271 broken |= MDIO_EEE_100TX;
272 if (of_property_read_bool(node, "eee-broken-1000t"))
273 broken |= MDIO_EEE_1000T;
274 if (of_property_read_bool(node, "eee-broken-10gt"))
275 broken |= MDIO_EEE_10GT;
276 if (of_property_read_bool(node, "eee-broken-1000kx"))
277 broken |= MDIO_EEE_1000KX;
278 if (of_property_read_bool(node, "eee-broken-10gkx4"))
279 broken |= MDIO_EEE_10GKX4;
280 if (of_property_read_bool(node, "eee-broken-10gkr"))
281 broken |= MDIO_EEE_10GKR;
282
283 phydev->eee_broken_modes = broken;
284}
285
286void phy_resolve_aneg_pause(struct phy_device *phydev)
287{
288 if (phydev->duplex == DUPLEX_FULL) {
289 phydev->pause = linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT,
290 phydev->lp_advertising);
291 phydev->asym_pause = linkmode_test_bit(
292 ETHTOOL_LINK_MODE_Asym_Pause_BIT,
293 phydev->lp_advertising);
294 }
295}
296EXPORT_SYMBOL_GPL(phy_resolve_aneg_pause);
297
298/**
299 * phy_resolve_aneg_linkmode - resolve the advertisements into phy settings
300 * @phydev: The phy_device struct
301 *
302 * Resolve our and the link partner advertisements into their corresponding
303 * speed and duplex. If full duplex was negotiated, extract the pause mode
304 * from the link partner mask.
305 */
306void phy_resolve_aneg_linkmode(struct phy_device *phydev)
307{
308 __ETHTOOL_DECLARE_LINK_MODE_MASK(common);
309 int i;
310
311 linkmode_and(common, phydev->lp_advertising, phydev->advertising);
312
313 for (i = 0; i < ARRAY_SIZE(settings); i++)
314 if (test_bit(settings[i].bit, common)) {
315 phydev->speed = settings[i].speed;
316 phydev->duplex = settings[i].duplex;
317 break;
318 }
319
320 phy_resolve_aneg_pause(phydev);
321}
322EXPORT_SYMBOL_GPL(phy_resolve_aneg_linkmode);
323
324static int phy_resolve_min_speed(struct phy_device *phydev, bool fdx_only)
325{
326 __ETHTOOL_DECLARE_LINK_MODE_MASK(common);
327 int i = ARRAY_SIZE(settings);
328
329 linkmode_and(common, phydev->lp_advertising, phydev->advertising);
330
331 while (--i >= 0) {
332 if (test_bit(settings[i].bit, common)) {
333 if (fdx_only && settings[i].duplex != DUPLEX_FULL)
334 continue;
335 return settings[i].speed;
336 }
337 }
338
339 return SPEED_UNKNOWN;
340}
341
342int phy_speed_down_core(struct phy_device *phydev)
343{
344 int min_common_speed = phy_resolve_min_speed(phydev, true);
345
346 if (min_common_speed == SPEED_UNKNOWN)
347 return -EINVAL;
348
349 return __set_linkmode_max_speed(min_common_speed, phydev->advertising);
350}
351
352static void mmd_phy_indirect(struct mii_bus *bus, int phy_addr, int devad,
353 u16 regnum)
354{
355 /* Write the desired MMD Devad */
356 __mdiobus_write(bus, phy_addr, MII_MMD_CTRL, devad);
357
358 /* Write the desired MMD register address */
359 __mdiobus_write(bus, phy_addr, MII_MMD_DATA, regnum);
360
361 /* Select the Function : DATA with no post increment */
362 __mdiobus_write(bus, phy_addr, MII_MMD_CTRL,
363 devad | MII_MMD_CTRL_NOINCR);
364}
365
366/**
367 * __phy_read_mmd - Convenience function for reading a register
368 * from an MMD on a given PHY.
369 * @phydev: The phy_device struct
370 * @devad: The MMD to read from (0..31)
371 * @regnum: The register on the MMD to read (0..65535)
372 *
373 * Same rules as for __phy_read();
374 */
375int __phy_read_mmd(struct phy_device *phydev, int devad, u32 regnum)
376{
377 int val;
378
379 if (regnum > (u16)~0 || devad > 32)
380 return -EINVAL;
381
382 if (phydev->drv->read_mmd) {
383 val = phydev->drv->read_mmd(phydev, devad, regnum);
384 } else if (phydev->is_c45) {
385 u32 addr = MII_ADDR_C45 | (devad << 16) | (regnum & 0xffff);
386
387 val = __mdiobus_read(phydev->mdio.bus, phydev->mdio.addr, addr);
388 } else {
389 struct mii_bus *bus = phydev->mdio.bus;
390 int phy_addr = phydev->mdio.addr;
391
392 mmd_phy_indirect(bus, phy_addr, devad, regnum);
393
394 /* Read the content of the MMD's selected register */
395 val = __mdiobus_read(bus, phy_addr, MII_MMD_DATA);
396 }
397 return val;
398}
399EXPORT_SYMBOL(__phy_read_mmd);
400
401/**
402 * phy_read_mmd - Convenience function for reading a register
403 * from an MMD on a given PHY.
404 * @phydev: The phy_device struct
405 * @devad: The MMD to read from
406 * @regnum: The register on the MMD to read
407 *
408 * Same rules as for phy_read();
409 */
410int phy_read_mmd(struct phy_device *phydev, int devad, u32 regnum)
411{
412 int ret;
413
414 mutex_lock(&phydev->mdio.bus->mdio_lock);
415 ret = __phy_read_mmd(phydev, devad, regnum);
416 mutex_unlock(&phydev->mdio.bus->mdio_lock);
417
418 return ret;
419}
420EXPORT_SYMBOL(phy_read_mmd);
421
422/**
423 * __phy_write_mmd - Convenience function for writing a register
424 * on an MMD on a given PHY.
425 * @phydev: The phy_device struct
426 * @devad: The MMD to read from
427 * @regnum: The register on the MMD to read
428 * @val: value to write to @regnum
429 *
430 * Same rules as for __phy_write();
431 */
432int __phy_write_mmd(struct phy_device *phydev, int devad, u32 regnum, u16 val)
433{
434 int ret;
435
436 if (regnum > (u16)~0 || devad > 32)
437 return -EINVAL;
438
439 if (phydev->drv->write_mmd) {
440 ret = phydev->drv->write_mmd(phydev, devad, regnum, val);
441 } else if (phydev->is_c45) {
442 u32 addr = MII_ADDR_C45 | (devad << 16) | (regnum & 0xffff);
443
444 ret = __mdiobus_write(phydev->mdio.bus, phydev->mdio.addr,
445 addr, val);
446 } else {
447 struct mii_bus *bus = phydev->mdio.bus;
448 int phy_addr = phydev->mdio.addr;
449
450 mmd_phy_indirect(bus, phy_addr, devad, regnum);
451
452 /* Write the data into MMD's selected register */
453 __mdiobus_write(bus, phy_addr, MII_MMD_DATA, val);
454
455 ret = 0;
456 }
457 return ret;
458}
459EXPORT_SYMBOL(__phy_write_mmd);
460
461/**
462 * phy_write_mmd - Convenience function for writing a register
463 * on an MMD on a given PHY.
464 * @phydev: The phy_device struct
465 * @devad: The MMD to read from
466 * @regnum: The register on the MMD to read
467 * @val: value to write to @regnum
468 *
469 * Same rules as for phy_write();
470 */
471int phy_write_mmd(struct phy_device *phydev, int devad, u32 regnum, u16 val)
472{
473 int ret;
474
475 mutex_lock(&phydev->mdio.bus->mdio_lock);
476 ret = __phy_write_mmd(phydev, devad, regnum, val);
477 mutex_unlock(&phydev->mdio.bus->mdio_lock);
478
479 return ret;
480}
481EXPORT_SYMBOL(phy_write_mmd);
482
483/**
484 * __phy_modify_changed() - Convenience function for modifying a PHY register
485 * @phydev: a pointer to a &struct phy_device
486 * @regnum: register number
487 * @mask: bit mask of bits to clear
488 * @set: bit mask of bits to set
489 *
490 * Unlocked helper function which allows a PHY register to be modified as
491 * new register value = (old register value & ~mask) | set
492 *
493 * Returns negative errno, 0 if there was no change, and 1 in case of change
494 */
495int __phy_modify_changed(struct phy_device *phydev, u32 regnum, u16 mask,
496 u16 set)
497{
498 int new, ret;
499
500 ret = __phy_read(phydev, regnum);
501 if (ret < 0)
502 return ret;
503
504 new = (ret & ~mask) | set;
505 if (new == ret)
506 return 0;
507
508 ret = __phy_write(phydev, regnum, new);
509
510 return ret < 0 ? ret : 1;
511}
512EXPORT_SYMBOL_GPL(__phy_modify_changed);
513
514/**
515 * phy_modify_changed - Function for modifying a PHY register
516 * @phydev: the phy_device struct
517 * @regnum: register number to modify
518 * @mask: bit mask of bits to clear
519 * @set: new value of bits set in mask to write to @regnum
520 *
521 * NOTE: MUST NOT be called from interrupt context,
522 * because the bus read/write functions may wait for an interrupt
523 * to conclude the operation.
524 *
525 * Returns negative errno, 0 if there was no change, and 1 in case of change
526 */
527int phy_modify_changed(struct phy_device *phydev, u32 regnum, u16 mask, u16 set)
528{
529 int ret;
530
531 mutex_lock(&phydev->mdio.bus->mdio_lock);
532 ret = __phy_modify_changed(phydev, regnum, mask, set);
533 mutex_unlock(&phydev->mdio.bus->mdio_lock);
534
535 return ret;
536}
537EXPORT_SYMBOL_GPL(phy_modify_changed);
538
539/**
540 * __phy_modify - Convenience function for modifying a PHY register
541 * @phydev: the phy_device struct
542 * @regnum: register number to modify
543 * @mask: bit mask of bits to clear
544 * @set: new value of bits set in mask to write to @regnum
545 *
546 * NOTE: MUST NOT be called from interrupt context,
547 * because the bus read/write functions may wait for an interrupt
548 * to conclude the operation.
549 */
550int __phy_modify(struct phy_device *phydev, u32 regnum, u16 mask, u16 set)
551{
552 int ret;
553
554 ret = __phy_modify_changed(phydev, regnum, mask, set);
555
556 return ret < 0 ? ret : 0;
557}
558EXPORT_SYMBOL_GPL(__phy_modify);
559
560/**
561 * phy_modify - Convenience function for modifying a given PHY register
562 * @phydev: the phy_device struct
563 * @regnum: register number to write
564 * @mask: bit mask of bits to clear
565 * @set: new value of bits set in mask to write to @regnum
566 *
567 * NOTE: MUST NOT be called from interrupt context,
568 * because the bus read/write functions may wait for an interrupt
569 * to conclude the operation.
570 */
571int phy_modify(struct phy_device *phydev, u32 regnum, u16 mask, u16 set)
572{
573 int ret;
574
575 mutex_lock(&phydev->mdio.bus->mdio_lock);
576 ret = __phy_modify(phydev, regnum, mask, set);
577 mutex_unlock(&phydev->mdio.bus->mdio_lock);
578
579 return ret;
580}
581EXPORT_SYMBOL_GPL(phy_modify);
582
583/**
584 * __phy_modify_mmd_changed - Function for modifying a register on MMD
585 * @phydev: the phy_device struct
586 * @devad: the MMD containing register to modify
587 * @regnum: register number to modify
588 * @mask: bit mask of bits to clear
589 * @set: new value of bits set in mask to write to @regnum
590 *
591 * Unlocked helper function which allows a MMD register to be modified as
592 * new register value = (old register value & ~mask) | set
593 *
594 * Returns negative errno, 0 if there was no change, and 1 in case of change
595 */
596int __phy_modify_mmd_changed(struct phy_device *phydev, int devad, u32 regnum,
597 u16 mask, u16 set)
598{
599 int new, ret;
600
601 ret = __phy_read_mmd(phydev, devad, regnum);
602 if (ret < 0)
603 return ret;
604
605 new = (ret & ~mask) | set;
606 if (new == ret)
607 return 0;
608
609 ret = __phy_write_mmd(phydev, devad, regnum, new);
610
611 return ret < 0 ? ret : 1;
612}
613EXPORT_SYMBOL_GPL(__phy_modify_mmd_changed);
614
615/**
616 * phy_modify_mmd_changed - Function for modifying a register on MMD
617 * @phydev: the phy_device struct
618 * @devad: the MMD containing register to modify
619 * @regnum: register number to modify
620 * @mask: bit mask of bits to clear
621 * @set: new value of bits set in mask to write to @regnum
622 *
623 * NOTE: MUST NOT be called from interrupt context,
624 * because the bus read/write functions may wait for an interrupt
625 * to conclude the operation.
626 *
627 * Returns negative errno, 0 if there was no change, and 1 in case of change
628 */
629int phy_modify_mmd_changed(struct phy_device *phydev, int devad, u32 regnum,
630 u16 mask, u16 set)
631{
632 int ret;
633
634 mutex_lock(&phydev->mdio.bus->mdio_lock);
635 ret = __phy_modify_mmd_changed(phydev, devad, regnum, mask, set);
636 mutex_unlock(&phydev->mdio.bus->mdio_lock);
637
638 return ret;
639}
640EXPORT_SYMBOL_GPL(phy_modify_mmd_changed);
641
642/**
643 * __phy_modify_mmd - Convenience function for modifying a register on MMD
644 * @phydev: the phy_device struct
645 * @devad: the MMD containing register to modify
646 * @regnum: register number to modify
647 * @mask: bit mask of bits to clear
648 * @set: new value of bits set in mask to write to @regnum
649 *
650 * NOTE: MUST NOT be called from interrupt context,
651 * because the bus read/write functions may wait for an interrupt
652 * to conclude the operation.
653 */
654int __phy_modify_mmd(struct phy_device *phydev, int devad, u32 regnum,
655 u16 mask, u16 set)
656{
657 int ret;
658
659 ret = __phy_modify_mmd_changed(phydev, devad, regnum, mask, set);
660
661 return ret < 0 ? ret : 0;
662}
663EXPORT_SYMBOL_GPL(__phy_modify_mmd);
664
665/**
666 * phy_modify_mmd - Convenience function for modifying a register on MMD
667 * @phydev: the phy_device struct
668 * @devad: the MMD containing register to modify
669 * @regnum: register number to modify
670 * @mask: bit mask of bits to clear
671 * @set: new value of bits set in mask to write to @regnum
672 *
673 * NOTE: MUST NOT be called from interrupt context,
674 * because the bus read/write functions may wait for an interrupt
675 * to conclude the operation.
676 */
677int phy_modify_mmd(struct phy_device *phydev, int devad, u32 regnum,
678 u16 mask, u16 set)
679{
680 int ret;
681
682 mutex_lock(&phydev->mdio.bus->mdio_lock);
683 ret = __phy_modify_mmd(phydev, devad, regnum, mask, set);
684 mutex_unlock(&phydev->mdio.bus->mdio_lock);
685
686 return ret;
687}
688EXPORT_SYMBOL_GPL(phy_modify_mmd);
689
690static int __phy_read_page(struct phy_device *phydev)
691{
692 return phydev->drv->read_page(phydev);
693}
694
695static int __phy_write_page(struct phy_device *phydev, int page)
696{
697 return phydev->drv->write_page(phydev, page);
698}
699
700/**
701 * phy_save_page() - take the bus lock and save the current page
702 * @phydev: a pointer to a &struct phy_device
703 *
704 * Take the MDIO bus lock, and return the current page number. On error,
705 * returns a negative errno. phy_restore_page() must always be called
706 * after this, irrespective of success or failure of this call.
707 */
708int phy_save_page(struct phy_device *phydev)
709{
710 mutex_lock(&phydev->mdio.bus->mdio_lock);
711 return __phy_read_page(phydev);
712}
713EXPORT_SYMBOL_GPL(phy_save_page);
714
715/**
716 * phy_select_page() - take the bus lock, save the current page, and set a page
717 * @phydev: a pointer to a &struct phy_device
718 * @page: desired page
719 *
720 * Take the MDIO bus lock to protect against concurrent access, save the
721 * current PHY page, and set the current page. On error, returns a
722 * negative errno, otherwise returns the previous page number.
723 * phy_restore_page() must always be called after this, irrespective
724 * of success or failure of this call.
725 */
726int phy_select_page(struct phy_device *phydev, int page)
727{
728 int ret, oldpage;
729
730 oldpage = ret = phy_save_page(phydev);
731 if (ret < 0)
732 return ret;
733
734 if (oldpage != page) {
735 ret = __phy_write_page(phydev, page);
736 if (ret < 0)
737 return ret;
738 }
739
740 return oldpage;
741}
742EXPORT_SYMBOL_GPL(phy_select_page);
743
744/**
745 * phy_restore_page() - restore the page register and release the bus lock
746 * @phydev: a pointer to a &struct phy_device
747 * @oldpage: the old page, return value from phy_save_page() or phy_select_page()
748 * @ret: operation's return code
749 *
750 * Release the MDIO bus lock, restoring @oldpage if it is a valid page.
751 * This function propagates the earliest error code from the group of
752 * operations.
753 *
754 * Returns:
755 * @oldpage if it was a negative value, otherwise
756 * @ret if it was a negative errno value, otherwise
757 * phy_write_page()'s negative value if it were in error, otherwise
758 * @ret.
759 */
760int phy_restore_page(struct phy_device *phydev, int oldpage, int ret)
761{
762 int r;
763
764 if (oldpage >= 0) {
765 r = __phy_write_page(phydev, oldpage);
766
767 /* Propagate the operation return code if the page write
768 * was successful.
769 */
770 if (ret >= 0 && r < 0)
771 ret = r;
772 } else {
773 /* Propagate the phy page selection error code */
774 ret = oldpage;
775 }
776
777 mutex_unlock(&phydev->mdio.bus->mdio_lock);
778
779 return ret;
780}
781EXPORT_SYMBOL_GPL(phy_restore_page);
782
783/**
784 * phy_read_paged() - Convenience function for reading a paged register
785 * @phydev: a pointer to a &struct phy_device
786 * @page: the page for the phy
787 * @regnum: register number
788 *
789 * Same rules as for phy_read().
790 */
791int phy_read_paged(struct phy_device *phydev, int page, u32 regnum)
792{
793 int ret = 0, oldpage;
794
795 oldpage = phy_select_page(phydev, page);
796 if (oldpage >= 0)
797 ret = __phy_read(phydev, regnum);
798
799 return phy_restore_page(phydev, oldpage, ret);
800}
801EXPORT_SYMBOL(phy_read_paged);
802
803/**
804 * phy_write_paged() - Convenience function for writing a paged register
805 * @phydev: a pointer to a &struct phy_device
806 * @page: the page for the phy
807 * @regnum: register number
808 * @val: value to write
809 *
810 * Same rules as for phy_write().
811 */
812int phy_write_paged(struct phy_device *phydev, int page, u32 regnum, u16 val)
813{
814 int ret = 0, oldpage;
815
816 oldpage = phy_select_page(phydev, page);
817 if (oldpage >= 0)
818 ret = __phy_write(phydev, regnum, val);
819
820 return phy_restore_page(phydev, oldpage, ret);
821}
822EXPORT_SYMBOL(phy_write_paged);
823
824/**
825 * phy_modify_paged_changed() - Function for modifying a paged register
826 * @phydev: a pointer to a &struct phy_device
827 * @page: the page for the phy
828 * @regnum: register number
829 * @mask: bit mask of bits to clear
830 * @set: bit mask of bits to set
831 *
832 * Returns negative errno, 0 if there was no change, and 1 in case of change
833 */
834int phy_modify_paged_changed(struct phy_device *phydev, int page, u32 regnum,
835 u16 mask, u16 set)
836{
837 int ret = 0, oldpage;
838
839 oldpage = phy_select_page(phydev, page);
840 if (oldpage >= 0)
841 ret = __phy_modify_changed(phydev, regnum, mask, set);
842
843 return phy_restore_page(phydev, oldpage, ret);
844}
845EXPORT_SYMBOL(phy_modify_paged_changed);
846
847/**
848 * phy_modify_paged() - Convenience function for modifying a paged register
849 * @phydev: a pointer to a &struct phy_device
850 * @page: the page for the phy
851 * @regnum: register number
852 * @mask: bit mask of bits to clear
853 * @set: bit mask of bits to set
854 *
855 * Same rules as for phy_read() and phy_write().
856 */
857int phy_modify_paged(struct phy_device *phydev, int page, u32 regnum,
858 u16 mask, u16 set)
859{
860 int ret = phy_modify_paged_changed(phydev, page, regnum, mask, set);
861
862 return ret < 0 ? ret : 0;
863}
864EXPORT_SYMBOL(phy_modify_paged);