1 /* Framework for finding and configuring PHYs.
2 * Also contains generic PHY driver
3 *
4 * Author: Andy Fleming
5 *
6 * Copyright (c) 2004 Freescale Semiconductor, Inc.
7 *
8 * This program is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU General Public License as published by the
10 * Free Software Foundation; either version 2 of the License, or (at your
11 * option) any later version.
12 *
13 */
14
15 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
16
17 #include <linux/kernel.h>
18 #include <linux/string.h>
19 #include <linux/errno.h>
20 #include <linux/unistd.h>
21 #include <linux/slab.h>
22 #include <linux/interrupt.h>
23 #include <linux/init.h>
24 #include <linux/delay.h>
25 #include <linux/netdevice.h>
26 #include <linux/etherdevice.h>
27 #include <linux/skbuff.h>
28 #include <linux/mm.h>
29 #include <linux/module.h>
30 #include <linux/mii.h>
31 #include <linux/ethtool.h>
32 #include <linux/phy.h>
33 #include <linux/mdio.h>
34 #include <linux/io.h>
35 #include <linux/uaccess.h>
36 #include <linux/of.h>
37
38 #include <asm/irq.h>
39
40 MODULE_DESCRIPTION("PHY library");
41 MODULE_AUTHOR("Andy Fleming");
42 MODULE_LICENSE("GPL");
43
phy_device_free(struct phy_device * phydev)44 void phy_device_free(struct phy_device *phydev)
45 {
46 put_device(&phydev->mdio.dev);
47 }
48 EXPORT_SYMBOL(phy_device_free);
49
phy_mdio_device_free(struct mdio_device * mdiodev)50 static void phy_mdio_device_free(struct mdio_device *mdiodev)
51 {
52 struct phy_device *phydev;
53
54 phydev = container_of(mdiodev, struct phy_device, mdio);
55 phy_device_free(phydev);
56 }
57
phy_device_release(struct device * dev)58 static void phy_device_release(struct device *dev)
59 {
60 kfree(to_phy_device(dev));
61 }
62
phy_mdio_device_remove(struct mdio_device * mdiodev)63 static void phy_mdio_device_remove(struct mdio_device *mdiodev)
64 {
65 struct phy_device *phydev;
66
67 phydev = container_of(mdiodev, struct phy_device, mdio);
68 phy_device_remove(phydev);
69 }
70
71 enum genphy_driver {
72 GENPHY_DRV_1G,
73 GENPHY_DRV_10G,
74 GENPHY_DRV_MAX
75 };
76
77 static struct phy_driver genphy_driver[GENPHY_DRV_MAX];
78
79 static LIST_HEAD(phy_fixup_list);
80 static DEFINE_MUTEX(phy_fixup_lock);
81
82 #ifdef CONFIG_PM
mdio_bus_phy_may_suspend(struct phy_device * phydev)83 static bool mdio_bus_phy_may_suspend(struct phy_device *phydev)
84 {
85 struct device_driver *drv = phydev->mdio.dev.driver;
86 struct phy_driver *phydrv = to_phy_driver(drv);
87 struct net_device *netdev = phydev->attached_dev;
88
89 if (!drv || !phydrv->suspend)
90 return false;
91
92 /* PHY not attached? May suspend if the PHY has not already been
93 * suspended as part of a prior call to phy_disconnect() ->
94 * phy_detach() -> phy_suspend() because the parent netdev might be the
95 * MDIO bus driver and clock gated at this point.
96 */
97 if (!netdev)
98 return !phydev->suspended;
99
100 /* Don't suspend PHY if the attached netdev parent may wakeup.
101 * The parent may point to a PCI device, as in tg3 driver.
102 */
103 if (netdev->dev.parent && device_may_wakeup(netdev->dev.parent))
104 return false;
105
106 /* Also don't suspend PHY if the netdev itself may wakeup. This
107 * is the case for devices w/o underlaying pwr. mgmt. aware bus,
108 * e.g. SoC devices.
109 */
110 if (device_may_wakeup(&netdev->dev))
111 return false;
112
113 return true;
114 }
115
mdio_bus_phy_suspend(struct device * dev)116 static int mdio_bus_phy_suspend(struct device *dev)
117 {
118 struct phy_device *phydev = to_phy_device(dev);
119
120 /* We must stop the state machine manually, otherwise it stops out of
121 * control, possibly with the phydev->lock held. Upon resume, netdev
122 * may call phy routines that try to grab the same lock, and that may
123 * lead to a deadlock.
124 */
125 if (phydev->attached_dev && phydev->adjust_link)
126 phy_stop_machine(phydev);
127
128 if (!mdio_bus_phy_may_suspend(phydev))
129 return 0;
130
131 return phy_suspend(phydev);
132 }
133
mdio_bus_phy_resume(struct device * dev)134 static int mdio_bus_phy_resume(struct device *dev)
135 {
136 struct phy_device *phydev = to_phy_device(dev);
137 int ret;
138
139 if (!mdio_bus_phy_may_suspend(phydev))
140 goto no_resume;
141
142 ret = phy_resume(phydev);
143 if (ret < 0)
144 return ret;
145
146 no_resume:
147 if (phydev->attached_dev && phydev->adjust_link)
148 phy_start_machine(phydev);
149
150 return 0;
151 }
152
mdio_bus_phy_restore(struct device * dev)153 static int mdio_bus_phy_restore(struct device *dev)
154 {
155 struct phy_device *phydev = to_phy_device(dev);
156 struct net_device *netdev = phydev->attached_dev;
157 int ret;
158
159 if (!netdev)
160 return 0;
161
162 ret = phy_init_hw(phydev);
163 if (ret < 0)
164 return ret;
165
166 /* The PHY needs to renegotiate. */
167 phydev->link = 0;
168 phydev->state = PHY_UP;
169
170 phy_start_machine(phydev);
171
172 return 0;
173 }
174
175 static const struct dev_pm_ops mdio_bus_phy_pm_ops = {
176 .suspend = mdio_bus_phy_suspend,
177 .resume = mdio_bus_phy_resume,
178 .freeze = mdio_bus_phy_suspend,
179 .thaw = mdio_bus_phy_resume,
180 .restore = mdio_bus_phy_restore,
181 };
182
183 #define MDIO_BUS_PHY_PM_OPS (&mdio_bus_phy_pm_ops)
184
185 #else
186
187 #define MDIO_BUS_PHY_PM_OPS NULL
188
189 #endif /* CONFIG_PM */
190
191 /**
192 * phy_register_fixup - creates a new phy_fixup and adds it to the list
193 * @bus_id: A string which matches phydev->mdio.dev.bus_id (or PHY_ANY_ID)
194 * @phy_uid: Used to match against phydev->phy_id (the UID of the PHY)
195 * It can also be PHY_ANY_UID
196 * @phy_uid_mask: Applied to phydev->phy_id and fixup->phy_uid before
197 * comparison
198 * @run: The actual code to be run when a matching PHY is found
199 */
phy_register_fixup(const char * bus_id,u32 phy_uid,u32 phy_uid_mask,int (* run)(struct phy_device *))200 int phy_register_fixup(const char *bus_id, u32 phy_uid, u32 phy_uid_mask,
201 int (*run)(struct phy_device *))
202 {
203 struct phy_fixup *fixup = kzalloc(sizeof(*fixup), GFP_KERNEL);
204
205 if (!fixup)
206 return -ENOMEM;
207
208 strlcpy(fixup->bus_id, bus_id, sizeof(fixup->bus_id));
209 fixup->phy_uid = phy_uid;
210 fixup->phy_uid_mask = phy_uid_mask;
211 fixup->run = run;
212
213 mutex_lock(&phy_fixup_lock);
214 list_add_tail(&fixup->list, &phy_fixup_list);
215 mutex_unlock(&phy_fixup_lock);
216
217 return 0;
218 }
219 EXPORT_SYMBOL(phy_register_fixup);
220
221 /* Registers a fixup to be run on any PHY with the UID in phy_uid */
phy_register_fixup_for_uid(u32 phy_uid,u32 phy_uid_mask,int (* run)(struct phy_device *))222 int phy_register_fixup_for_uid(u32 phy_uid, u32 phy_uid_mask,
223 int (*run)(struct phy_device *))
224 {
225 return phy_register_fixup(PHY_ANY_ID, phy_uid, phy_uid_mask, run);
226 }
227 EXPORT_SYMBOL(phy_register_fixup_for_uid);
228
229 /* Registers a fixup to be run on the PHY with id string bus_id */
phy_register_fixup_for_id(const char * bus_id,int (* run)(struct phy_device *))230 int phy_register_fixup_for_id(const char *bus_id,
231 int (*run)(struct phy_device *))
232 {
233 return phy_register_fixup(bus_id, PHY_ANY_UID, 0xffffffff, run);
234 }
235 EXPORT_SYMBOL(phy_register_fixup_for_id);
236
237 /* Returns 1 if fixup matches phydev in bus_id and phy_uid.
238 * Fixups can be set to match any in one or more fields.
239 */
phy_needs_fixup(struct phy_device * phydev,struct phy_fixup * fixup)240 static int phy_needs_fixup(struct phy_device *phydev, struct phy_fixup *fixup)
241 {
242 if (strcmp(fixup->bus_id, phydev_name(phydev)) != 0)
243 if (strcmp(fixup->bus_id, PHY_ANY_ID) != 0)
244 return 0;
245
246 if ((fixup->phy_uid & fixup->phy_uid_mask) !=
247 (phydev->phy_id & fixup->phy_uid_mask))
248 if (fixup->phy_uid != PHY_ANY_UID)
249 return 0;
250
251 return 1;
252 }
253
254 /* Runs any matching fixups for this phydev */
phy_scan_fixups(struct phy_device * phydev)255 static int phy_scan_fixups(struct phy_device *phydev)
256 {
257 struct phy_fixup *fixup;
258
259 mutex_lock(&phy_fixup_lock);
260 list_for_each_entry(fixup, &phy_fixup_list, list) {
261 if (phy_needs_fixup(phydev, fixup)) {
262 int err = fixup->run(phydev);
263
264 if (err < 0) {
265 mutex_unlock(&phy_fixup_lock);
266 return err;
267 }
268 phydev->has_fixups = true;
269 }
270 }
271 mutex_unlock(&phy_fixup_lock);
272
273 return 0;
274 }
275
phy_bus_match(struct device * dev,struct device_driver * drv)276 static int phy_bus_match(struct device *dev, struct device_driver *drv)
277 {
278 struct phy_device *phydev = to_phy_device(dev);
279 struct phy_driver *phydrv = to_phy_driver(drv);
280 const int num_ids = ARRAY_SIZE(phydev->c45_ids.device_ids);
281 int i;
282
283 if (!(phydrv->mdiodrv.flags & MDIO_DEVICE_IS_PHY))
284 return 0;
285
286 if (phydrv->match_phy_device)
287 return phydrv->match_phy_device(phydev);
288
289 if (phydev->is_c45) {
290 for (i = 1; i < num_ids; i++) {
291 if (!(phydev->c45_ids.devices_in_package & (1 << i)))
292 continue;
293
294 if ((phydrv->phy_id & phydrv->phy_id_mask) ==
295 (phydev->c45_ids.device_ids[i] &
296 phydrv->phy_id_mask))
297 return 1;
298 }
299 return 0;
300 } else {
301 return (phydrv->phy_id & phydrv->phy_id_mask) ==
302 (phydev->phy_id & phydrv->phy_id_mask);
303 }
304 }
305
phy_device_create(struct mii_bus * bus,int addr,int phy_id,bool is_c45,struct phy_c45_device_ids * c45_ids)306 struct phy_device *phy_device_create(struct mii_bus *bus, int addr, int phy_id,
307 bool is_c45,
308 struct phy_c45_device_ids *c45_ids)
309 {
310 struct phy_device *dev;
311 struct mdio_device *mdiodev;
312
313 /* We allocate the device, and initialize the default values */
314 dev = kzalloc(sizeof(*dev), GFP_KERNEL);
315 if (!dev)
316 return ERR_PTR(-ENOMEM);
317
318 mdiodev = &dev->mdio;
319 mdiodev->dev.release = phy_device_release;
320 mdiodev->dev.parent = &bus->dev;
321 mdiodev->dev.bus = &mdio_bus_type;
322 mdiodev->bus = bus;
323 mdiodev->pm_ops = MDIO_BUS_PHY_PM_OPS;
324 mdiodev->bus_match = phy_bus_match;
325 mdiodev->addr = addr;
326 mdiodev->flags = MDIO_DEVICE_FLAG_PHY;
327 mdiodev->device_free = phy_mdio_device_free;
328 mdiodev->device_remove = phy_mdio_device_remove;
329
330 dev->speed = 0;
331 dev->duplex = -1;
332 dev->pause = 0;
333 dev->asym_pause = 0;
334 dev->link = 1;
335 dev->interface = PHY_INTERFACE_MODE_GMII;
336
337 dev->autoneg = AUTONEG_ENABLE;
338
339 dev->is_c45 = is_c45;
340 dev->phy_id = phy_id;
341 if (c45_ids)
342 dev->c45_ids = *c45_ids;
343 dev->irq = bus->irq[addr];
344 dev_set_name(&mdiodev->dev, PHY_ID_FMT, bus->id, addr);
345
346 dev->state = PHY_DOWN;
347
348 mutex_init(&dev->lock);
349 INIT_DELAYED_WORK(&dev->state_queue, phy_state_machine);
350 INIT_WORK(&dev->phy_queue, phy_change);
351
352 /* Request the appropriate module unconditionally; don't
353 * bother trying to do so only if it isn't already loaded,
354 * because that gets complicated. A hotplug event would have
355 * done an unconditional modprobe anyway.
356 * We don't do normal hotplug because it won't work for MDIO
357 * -- because it relies on the device staying around for long
358 * enough for the driver to get loaded. With MDIO, the NIC
359 * driver will get bored and give up as soon as it finds that
360 * there's no driver _already_ loaded.
361 */
362 request_module(MDIO_MODULE_PREFIX MDIO_ID_FMT, MDIO_ID_ARGS(phy_id));
363
364 device_initialize(&mdiodev->dev);
365
366 return dev;
367 }
368 EXPORT_SYMBOL(phy_device_create);
369
370 /* get_phy_c45_devs_in_pkg - reads a MMD's devices in package registers.
371 * @bus: the target MII bus
372 * @addr: PHY address on the MII bus
373 * @dev_addr: MMD address in the PHY.
374 * @devices_in_package: where to store the devices in package information.
375 *
376 * Description: reads devices in package registers of a MMD at @dev_addr
377 * from PHY at @addr on @bus.
378 *
379 * Returns: 0 on success, -EIO on failure.
380 */
get_phy_c45_devs_in_pkg(struct mii_bus * bus,int addr,int dev_addr,u32 * devices_in_package)381 static int get_phy_c45_devs_in_pkg(struct mii_bus *bus, int addr, int dev_addr,
382 u32 *devices_in_package)
383 {
384 int phy_reg, reg_addr;
385
386 reg_addr = MII_ADDR_C45 | dev_addr << 16 | MDIO_DEVS2;
387 phy_reg = mdiobus_read(bus, addr, reg_addr);
388 if (phy_reg < 0)
389 return -EIO;
390 *devices_in_package = (phy_reg & 0xffff) << 16;
391
392 reg_addr = MII_ADDR_C45 | dev_addr << 16 | MDIO_DEVS1;
393 phy_reg = mdiobus_read(bus, addr, reg_addr);
394 if (phy_reg < 0)
395 return -EIO;
396 *devices_in_package |= (phy_reg & 0xffff);
397
398 return 0;
399 }
400
401 /**
402 * get_phy_c45_ids - reads the specified addr for its 802.3-c45 IDs.
403 * @bus: the target MII bus
404 * @addr: PHY address on the MII bus
405 * @phy_id: where to store the ID retrieved.
406 * @c45_ids: where to store the c45 ID information.
407 *
408 * If the PHY devices-in-package appears to be valid, it and the
409 * corresponding identifiers are stored in @c45_ids, zero is stored
410 * in @phy_id. Otherwise 0xffffffff is stored in @phy_id. Returns
411 * zero on success.
412 *
413 */
get_phy_c45_ids(struct mii_bus * bus,int addr,u32 * phy_id,struct phy_c45_device_ids * c45_ids)414 static int get_phy_c45_ids(struct mii_bus *bus, int addr, u32 *phy_id,
415 struct phy_c45_device_ids *c45_ids) {
416 int phy_reg;
417 int i, reg_addr;
418 const int num_ids = ARRAY_SIZE(c45_ids->device_ids);
419 u32 *devs = &c45_ids->devices_in_package;
420
421 /* Find first non-zero Devices In package. Device zero is reserved
422 * for 802.3 c45 complied PHYs, so don't probe it at first.
423 */
424 for (i = 1; i < num_ids && *devs == 0; i++) {
425 phy_reg = get_phy_c45_devs_in_pkg(bus, addr, i, devs);
426 if (phy_reg < 0)
427 return -EIO;
428
429 if ((*devs & 0x1fffffff) == 0x1fffffff) {
430 /* If mostly Fs, there is no device there,
431 * then let's continue to probe more, as some
432 * 10G PHYs have zero Devices In package,
433 * e.g. Cortina CS4315/CS4340 PHY.
434 */
435 phy_reg = get_phy_c45_devs_in_pkg(bus, addr, 0, devs);
436 if (phy_reg < 0)
437 return -EIO;
438 /* no device there, let's get out of here */
439 if ((*devs & 0x1fffffff) == 0x1fffffff) {
440 *phy_id = 0xffffffff;
441 return 0;
442 } else {
443 break;
444 }
445 }
446 }
447
448 /* Now probe Device Identifiers for each device present. */
449 for (i = 1; i < num_ids; i++) {
450 if (!(c45_ids->devices_in_package & (1 << i)))
451 continue;
452
453 reg_addr = MII_ADDR_C45 | i << 16 | MII_PHYSID1;
454 phy_reg = mdiobus_read(bus, addr, reg_addr);
455 if (phy_reg < 0)
456 return -EIO;
457 c45_ids->device_ids[i] = (phy_reg & 0xffff) << 16;
458
459 reg_addr = MII_ADDR_C45 | i << 16 | MII_PHYSID2;
460 phy_reg = mdiobus_read(bus, addr, reg_addr);
461 if (phy_reg < 0)
462 return -EIO;
463 c45_ids->device_ids[i] |= (phy_reg & 0xffff);
464 }
465 *phy_id = 0;
466 return 0;
467 }
468
469 /**
470 * get_phy_id - reads the specified addr for its ID.
471 * @bus: the target MII bus
472 * @addr: PHY address on the MII bus
473 * @phy_id: where to store the ID retrieved.
474 * @is_c45: If true the PHY uses the 802.3 clause 45 protocol
475 * @c45_ids: where to store the c45 ID information.
476 *
477 * Description: In the case of a 802.3-c22 PHY, reads the ID registers
478 * of the PHY at @addr on the @bus, stores it in @phy_id and returns
479 * zero on success.
480 *
481 * In the case of a 802.3-c45 PHY, get_phy_c45_ids() is invoked, and
482 * its return value is in turn returned.
483 *
484 */
get_phy_id(struct mii_bus * bus,int addr,u32 * phy_id,bool is_c45,struct phy_c45_device_ids * c45_ids)485 static int get_phy_id(struct mii_bus *bus, int addr, u32 *phy_id,
486 bool is_c45, struct phy_c45_device_ids *c45_ids)
487 {
488 int phy_reg;
489
490 if (is_c45)
491 return get_phy_c45_ids(bus, addr, phy_id, c45_ids);
492
493 /* Grab the bits from PHYIR1, and put them in the upper half */
494 phy_reg = mdiobus_read(bus, addr, MII_PHYSID1);
495 if (phy_reg < 0)
496 return -EIO;
497
498 *phy_id = (phy_reg & 0xffff) << 16;
499
500 /* Grab the bits from PHYIR2, and put them in the lower half */
501 phy_reg = mdiobus_read(bus, addr, MII_PHYSID2);
502 if (phy_reg < 0)
503 return -EIO;
504
505 *phy_id |= (phy_reg & 0xffff);
506
507 return 0;
508 }
509
510 /**
511 * get_phy_device - reads the specified PHY device and returns its @phy_device
512 * struct
513 * @bus: the target MII bus
514 * @addr: PHY address on the MII bus
515 * @is_c45: If true the PHY uses the 802.3 clause 45 protocol
516 *
517 * Description: Reads the ID registers of the PHY at @addr on the
518 * @bus, then allocates and returns the phy_device to represent it.
519 */
get_phy_device(struct mii_bus * bus,int addr,bool is_c45)520 struct phy_device *get_phy_device(struct mii_bus *bus, int addr, bool is_c45)
521 {
522 struct phy_c45_device_ids c45_ids = {0};
523 u32 phy_id = 0;
524 int r;
525
526 r = get_phy_id(bus, addr, &phy_id, is_c45, &c45_ids);
527 if (r)
528 return ERR_PTR(r);
529
530 /* If the phy_id is mostly Fs, there is no device there */
531 if ((phy_id & 0x1fffffff) == 0x1fffffff)
532 return ERR_PTR(-ENODEV);
533
534 return phy_device_create(bus, addr, phy_id, is_c45, &c45_ids);
535 }
536 EXPORT_SYMBOL(get_phy_device);
537
538 static ssize_t
phy_id_show(struct device * dev,struct device_attribute * attr,char * buf)539 phy_id_show(struct device *dev, struct device_attribute *attr, char *buf)
540 {
541 struct phy_device *phydev = to_phy_device(dev);
542
543 return sprintf(buf, "0x%.8lx\n", (unsigned long)phydev->phy_id);
544 }
545 static DEVICE_ATTR_RO(phy_id);
546
547 static ssize_t
phy_interface_show(struct device * dev,struct device_attribute * attr,char * buf)548 phy_interface_show(struct device *dev, struct device_attribute *attr, char *buf)
549 {
550 struct phy_device *phydev = to_phy_device(dev);
551 const char *mode = NULL;
552
553 if (phy_is_internal(phydev))
554 mode = "internal";
555 else
556 mode = phy_modes(phydev->interface);
557
558 return sprintf(buf, "%s\n", mode);
559 }
560 static DEVICE_ATTR_RO(phy_interface);
561
562 static ssize_t
phy_has_fixups_show(struct device * dev,struct device_attribute * attr,char * buf)563 phy_has_fixups_show(struct device *dev, struct device_attribute *attr,
564 char *buf)
565 {
566 struct phy_device *phydev = to_phy_device(dev);
567
568 return sprintf(buf, "%d\n", phydev->has_fixups);
569 }
570 static DEVICE_ATTR_RO(phy_has_fixups);
571
572 static struct attribute *phy_dev_attrs[] = {
573 &dev_attr_phy_id.attr,
574 &dev_attr_phy_interface.attr,
575 &dev_attr_phy_has_fixups.attr,
576 NULL,
577 };
578 ATTRIBUTE_GROUPS(phy_dev);
579
580 /**
581 * phy_device_register - Register the phy device on the MDIO bus
582 * @phydev: phy_device structure to be added to the MDIO bus
583 */
phy_device_register(struct phy_device * phydev)584 int phy_device_register(struct phy_device *phydev)
585 {
586 int err;
587
588 err = mdiobus_register_device(&phydev->mdio);
589 if (err)
590 return err;
591
592 /* Run all of the fixups for this PHY */
593 err = phy_scan_fixups(phydev);
594 if (err) {
595 pr_err("PHY %d failed to initialize\n", phydev->mdio.addr);
596 goto out;
597 }
598
599 phydev->mdio.dev.groups = phy_dev_groups;
600
601 err = device_add(&phydev->mdio.dev);
602 if (err) {
603 pr_err("PHY %d failed to add\n", phydev->mdio.addr);
604 goto out;
605 }
606
607 return 0;
608
609 out:
610 mdiobus_unregister_device(&phydev->mdio);
611 return err;
612 }
613 EXPORT_SYMBOL(phy_device_register);
614
615 /**
616 * phy_device_remove - Remove a previously registered phy device from the MDIO bus
617 * @phydev: phy_device structure to remove
618 *
619 * This doesn't free the phy_device itself, it merely reverses the effects
620 * of phy_device_register(). Use phy_device_free() to free the device
621 * after calling this function.
622 */
phy_device_remove(struct phy_device * phydev)623 void phy_device_remove(struct phy_device *phydev)
624 {
625 device_del(&phydev->mdio.dev);
626 mdiobus_unregister_device(&phydev->mdio);
627 }
628 EXPORT_SYMBOL(phy_device_remove);
629
630 /**
631 * phy_find_first - finds the first PHY device on the bus
632 * @bus: the target MII bus
633 */
phy_find_first(struct mii_bus * bus)634 struct phy_device *phy_find_first(struct mii_bus *bus)
635 {
636 struct phy_device *phydev;
637 int addr;
638
639 for (addr = 0; addr < PHY_MAX_ADDR; addr++) {
640 phydev = mdiobus_get_phy(bus, addr);
641 if (phydev)
642 return phydev;
643 }
644 return NULL;
645 }
646 EXPORT_SYMBOL(phy_find_first);
647
648 /**
649 * phy_prepare_link - prepares the PHY layer to monitor link status
650 * @phydev: target phy_device struct
651 * @handler: callback function for link status change notifications
652 *
653 * Description: Tells the PHY infrastructure to handle the
654 * gory details on monitoring link status (whether through
655 * polling or an interrupt), and to call back to the
656 * connected device driver when the link status changes.
657 * If you want to monitor your own link state, don't call
658 * this function.
659 */
phy_prepare_link(struct phy_device * phydev,void (* handler)(struct net_device *))660 static void phy_prepare_link(struct phy_device *phydev,
661 void (*handler)(struct net_device *))
662 {
663 phydev->adjust_link = handler;
664 }
665
666 /**
667 * phy_connect_direct - connect an ethernet device to a specific phy_device
668 * @dev: the network device to connect
669 * @phydev: the pointer to the phy device
670 * @handler: callback function for state change notifications
671 * @interface: PHY device's interface
672 */
phy_connect_direct(struct net_device * dev,struct phy_device * phydev,void (* handler)(struct net_device *),phy_interface_t interface)673 int phy_connect_direct(struct net_device *dev, struct phy_device *phydev,
674 void (*handler)(struct net_device *),
675 phy_interface_t interface)
676 {
677 int rc;
678
679 rc = phy_attach_direct(dev, phydev, phydev->dev_flags, interface);
680 if (rc)
681 return rc;
682
683 phy_prepare_link(phydev, handler);
684 phy_start_machine(phydev);
685 if (phydev->irq > 0)
686 phy_start_interrupts(phydev);
687
688 return 0;
689 }
690 EXPORT_SYMBOL(phy_connect_direct);
691
692 /**
693 * phy_connect - connect an ethernet device to a PHY device
694 * @dev: the network device to connect
695 * @bus_id: the id string of the PHY device to connect
696 * @handler: callback function for state change notifications
697 * @interface: PHY device's interface
698 *
699 * Description: Convenience function for connecting ethernet
700 * devices to PHY devices. The default behavior is for
701 * the PHY infrastructure to handle everything, and only notify
702 * the connected driver when the link status changes. If you
703 * don't want, or can't use the provided functionality, you may
704 * choose to call only the subset of functions which provide
705 * the desired functionality.
706 */
phy_connect(struct net_device * dev,const char * bus_id,void (* handler)(struct net_device *),phy_interface_t interface)707 struct phy_device *phy_connect(struct net_device *dev, const char *bus_id,
708 void (*handler)(struct net_device *),
709 phy_interface_t interface)
710 {
711 struct phy_device *phydev;
712 struct device *d;
713 int rc;
714
715 /* Search the list of PHY devices on the mdio bus for the
716 * PHY with the requested name
717 */
718 d = bus_find_device_by_name(&mdio_bus_type, NULL, bus_id);
719 if (!d) {
720 pr_err("PHY %s not found\n", bus_id);
721 return ERR_PTR(-ENODEV);
722 }
723 phydev = to_phy_device(d);
724
725 rc = phy_connect_direct(dev, phydev, handler, interface);
726 put_device(d);
727 if (rc)
728 return ERR_PTR(rc);
729
730 return phydev;
731 }
732 EXPORT_SYMBOL(phy_connect);
733
734 /**
735 * phy_disconnect - disable interrupts, stop state machine, and detach a PHY
736 * device
737 * @phydev: target phy_device struct
738 */
phy_disconnect(struct phy_device * phydev)739 void phy_disconnect(struct phy_device *phydev)
740 {
741 if (phydev->irq > 0)
742 phy_stop_interrupts(phydev);
743
744 phy_stop_machine(phydev);
745
746 phydev->adjust_link = NULL;
747
748 phy_detach(phydev);
749 }
750 EXPORT_SYMBOL(phy_disconnect);
751
752 /**
753 * phy_poll_reset - Safely wait until a PHY reset has properly completed
754 * @phydev: The PHY device to poll
755 *
756 * Description: According to IEEE 802.3, Section 2, Subsection 22.2.4.1.1, as
757 * published in 2008, a PHY reset may take up to 0.5 seconds. The MII BMCR
758 * register must be polled until the BMCR_RESET bit clears.
759 *
760 * Furthermore, any attempts to write to PHY registers may have no effect
761 * or even generate MDIO bus errors until this is complete.
762 *
763 * Some PHYs (such as the Marvell 88E1111) don't entirely conform to the
764 * standard and do not fully reset after the BMCR_RESET bit is set, and may
765 * even *REQUIRE* a soft-reset to properly restart autonegotiation. In an
766 * effort to support such broken PHYs, this function is separate from the
767 * standard phy_init_hw() which will zero all the other bits in the BMCR
768 * and reapply all driver-specific and board-specific fixups.
769 */
phy_poll_reset(struct phy_device * phydev)770 static int phy_poll_reset(struct phy_device *phydev)
771 {
772 /* Poll until the reset bit clears (50ms per retry == 0.6 sec) */
773 unsigned int retries = 12;
774 int ret;
775
776 do {
777 msleep(50);
778 ret = phy_read(phydev, MII_BMCR);
779 if (ret < 0)
780 return ret;
781 } while (ret & BMCR_RESET && --retries);
782 if (ret & BMCR_RESET)
783 return -ETIMEDOUT;
784
785 /* Some chips (smsc911x) may still need up to another 1ms after the
786 * BMCR_RESET bit is cleared before they are usable.
787 */
788 msleep(1);
789 return 0;
790 }
791
phy_init_hw(struct phy_device * phydev)792 int phy_init_hw(struct phy_device *phydev)
793 {
794 int ret = 0;
795
796 if (!phydev->drv || !phydev->drv->config_init)
797 return 0;
798
799 if (phydev->drv->soft_reset)
800 ret = phydev->drv->soft_reset(phydev);
801 else
802 ret = genphy_soft_reset(phydev);
803
804 if (ret < 0)
805 return ret;
806
807 ret = phy_scan_fixups(phydev);
808 if (ret < 0)
809 return ret;
810
811 return phydev->drv->config_init(phydev);
812 }
813 EXPORT_SYMBOL(phy_init_hw);
814
phy_attached_info(struct phy_device * phydev)815 void phy_attached_info(struct phy_device *phydev)
816 {
817 phy_attached_print(phydev, NULL);
818 }
819 EXPORT_SYMBOL(phy_attached_info);
820
821 #define ATTACHED_FMT "attached PHY driver [%s] (mii_bus:phy_addr=%s, irq=%d)"
phy_attached_print(struct phy_device * phydev,const char * fmt,...)822 void phy_attached_print(struct phy_device *phydev, const char *fmt, ...)
823 {
824 if (!fmt) {
825 dev_info(&phydev->mdio.dev, ATTACHED_FMT "\n",
826 phydev->drv->name, phydev_name(phydev),
827 phydev->irq);
828 } else {
829 va_list ap;
830
831 dev_info(&phydev->mdio.dev, ATTACHED_FMT,
832 phydev->drv->name, phydev_name(phydev),
833 phydev->irq);
834
835 va_start(ap, fmt);
836 vprintk(fmt, ap);
837 va_end(ap);
838 }
839 }
840 EXPORT_SYMBOL(phy_attached_print);
841
842 /**
843 * phy_attach_direct - attach a network device to a given PHY device pointer
844 * @dev: network device to attach
845 * @phydev: Pointer to phy_device to attach
846 * @flags: PHY device's dev_flags
847 * @interface: PHY device's interface
848 *
849 * Description: Called by drivers to attach to a particular PHY
850 * device. The phy_device is found, and properly hooked up
851 * to the phy_driver. If no driver is attached, then a
852 * generic driver is used. The phy_device is given a ptr to
853 * the attaching device, and given a callback for link status
854 * change. The phy_device is returned to the attaching driver.
855 * This function takes a reference on the phy device.
856 */
phy_attach_direct(struct net_device * dev,struct phy_device * phydev,u32 flags,phy_interface_t interface)857 int phy_attach_direct(struct net_device *dev, struct phy_device *phydev,
858 u32 flags, phy_interface_t interface)
859 {
860 struct module *ndev_owner = dev->dev.parent->driver->owner;
861 struct mii_bus *bus = phydev->mdio.bus;
862 struct device *d = &phydev->mdio.dev;
863 bool using_genphy = false;
864 int err;
865
866 /* For Ethernet device drivers that register their own MDIO bus, we
867 * will have bus->owner match ndev_mod, so we do not want to increment
868 * our own module->refcnt here, otherwise we would not be able to
869 * unload later on.
870 */
871 if (ndev_owner != bus->owner && !try_module_get(bus->owner)) {
872 dev_err(&dev->dev, "failed to get the bus module\n");
873 return -EIO;
874 }
875
876 get_device(d);
877
878 /* Assume that if there is no driver, that it doesn't
879 * exist, and we should use the genphy driver.
880 */
881 if (!d->driver) {
882 if (phydev->is_c45)
883 d->driver =
884 &genphy_driver[GENPHY_DRV_10G].mdiodrv.driver;
885 else
886 d->driver =
887 &genphy_driver[GENPHY_DRV_1G].mdiodrv.driver;
888
889 using_genphy = true;
890 }
891
892 if (!try_module_get(d->driver->owner)) {
893 dev_err(&dev->dev, "failed to get the device driver module\n");
894 err = -EIO;
895 goto error_put_device;
896 }
897
898 if (using_genphy) {
899 err = d->driver->probe(d);
900 if (err >= 0)
901 err = device_bind_driver(d);
902
903 if (err)
904 goto error_module_put;
905 }
906
907 if (phydev->attached_dev) {
908 dev_err(&dev->dev, "PHY already attached\n");
909 err = -EBUSY;
910 goto error;
911 }
912
913 phydev->attached_dev = dev;
914 dev->phydev = phydev;
915
916 phydev->dev_flags = flags;
917
918 phydev->interface = interface;
919
920 phydev->state = PHY_READY;
921
922 /* Initial carrier state is off as the phy is about to be
923 * (re)initialized.
924 */
925 netif_carrier_off(phydev->attached_dev);
926
927 /* Do initial configuration here, now that
928 * we have certain key parameters
929 * (dev_flags and interface)
930 */
931 err = phy_init_hw(phydev);
932 if (err)
933 phy_detach(phydev);
934 else
935 phy_resume(phydev);
936
937 return err;
938
939 error:
940 /* phy_detach() does all of the cleanup below */
941 phy_detach(phydev);
942 return err;
943
944 error_module_put:
945 module_put(d->driver->owner);
946 error_put_device:
947 put_device(d);
948 if (ndev_owner != bus->owner)
949 module_put(bus->owner);
950 return err;
951 }
952 EXPORT_SYMBOL(phy_attach_direct);
953
954 /**
955 * phy_attach - attach a network device to a particular PHY device
956 * @dev: network device to attach
957 * @bus_id: Bus ID of PHY device to attach
958 * @interface: PHY device's interface
959 *
960 * Description: Same as phy_attach_direct() except that a PHY bus_id
961 * string is passed instead of a pointer to a struct phy_device.
962 */
phy_attach(struct net_device * dev,const char * bus_id,phy_interface_t interface)963 struct phy_device *phy_attach(struct net_device *dev, const char *bus_id,
964 phy_interface_t interface)
965 {
966 struct bus_type *bus = &mdio_bus_type;
967 struct phy_device *phydev;
968 struct device *d;
969 int rc;
970
971 /* Search the list of PHY devices on the mdio bus for the
972 * PHY with the requested name
973 */
974 d = bus_find_device_by_name(bus, NULL, bus_id);
975 if (!d) {
976 pr_err("PHY %s not found\n", bus_id);
977 return ERR_PTR(-ENODEV);
978 }
979 phydev = to_phy_device(d);
980
981 rc = phy_attach_direct(dev, phydev, phydev->dev_flags, interface);
982 put_device(d);
983 if (rc)
984 return ERR_PTR(rc);
985
986 return phydev;
987 }
988 EXPORT_SYMBOL(phy_attach);
989
990 /**
991 * phy_detach - detach a PHY device from its network device
992 * @phydev: target phy_device struct
993 *
994 * This detaches the phy device from its network device and the phy
995 * driver, and drops the reference count taken in phy_attach_direct().
996 */
phy_detach(struct phy_device * phydev)997 void phy_detach(struct phy_device *phydev)
998 {
999 struct net_device *dev = phydev->attached_dev;
1000 struct module *ndev_owner = dev->dev.parent->driver->owner;
1001 struct mii_bus *bus;
1002 int i;
1003
1004 phydev->attached_dev->phydev = NULL;
1005 phydev->attached_dev = NULL;
1006 phy_suspend(phydev);
1007
1008 module_put(phydev->mdio.dev.driver->owner);
1009
1010 /* If the device had no specific driver before (i.e. - it
1011 * was using the generic driver), we unbind the device
1012 * from the generic driver so that there's a chance a
1013 * real driver could be loaded
1014 */
1015 for (i = 0; i < ARRAY_SIZE(genphy_driver); i++) {
1016 if (phydev->mdio.dev.driver ==
1017 &genphy_driver[i].mdiodrv.driver) {
1018 device_release_driver(&phydev->mdio.dev);
1019 break;
1020 }
1021 }
1022
1023 /*
1024 * The phydev might go away on the put_device() below, so avoid
1025 * a use-after-free bug by reading the underlying bus first.
1026 */
1027 bus = phydev->mdio.bus;
1028
1029 put_device(&phydev->mdio.dev);
1030 if (ndev_owner != bus->owner)
1031 module_put(bus->owner);
1032 }
1033 EXPORT_SYMBOL(phy_detach);
1034
phy_suspend(struct phy_device * phydev)1035 int phy_suspend(struct phy_device *phydev)
1036 {
1037 struct phy_driver *phydrv = to_phy_driver(phydev->mdio.dev.driver);
1038 struct ethtool_wolinfo wol = { .cmd = ETHTOOL_GWOL };
1039 int ret = 0;
1040
1041 /* If the device has WOL enabled, we cannot suspend the PHY */
1042 phy_ethtool_get_wol(phydev, &wol);
1043 if (wol.wolopts)
1044 return -EBUSY;
1045
1046 if (phydrv->suspend)
1047 ret = phydrv->suspend(phydev);
1048
1049 if (ret)
1050 return ret;
1051
1052 phydev->suspended = true;
1053
1054 return ret;
1055 }
1056 EXPORT_SYMBOL(phy_suspend);
1057
phy_resume(struct phy_device * phydev)1058 int phy_resume(struct phy_device *phydev)
1059 {
1060 struct phy_driver *phydrv = to_phy_driver(phydev->mdio.dev.driver);
1061 int ret = 0;
1062
1063 if (phydrv->resume)
1064 ret = phydrv->resume(phydev);
1065
1066 if (ret)
1067 return ret;
1068
1069 phydev->suspended = false;
1070
1071 return ret;
1072 }
1073 EXPORT_SYMBOL(phy_resume);
1074
1075 /* Generic PHY support and helper functions */
1076
1077 /**
1078 * genphy_config_advert - sanitize and advertise auto-negotiation parameters
1079 * @phydev: target phy_device struct
1080 *
1081 * Description: Writes MII_ADVERTISE with the appropriate values,
1082 * after sanitizing the values to make sure we only advertise
1083 * what is supported. Returns < 0 on error, 0 if the PHY's advertisement
1084 * hasn't changed, and > 0 if it has changed.
1085 */
genphy_config_advert(struct phy_device * phydev)1086 static int genphy_config_advert(struct phy_device *phydev)
1087 {
1088 u32 advertise;
1089 int oldadv, adv, bmsr;
1090 int err, changed = 0;
1091
1092 /* Only allow advertising what this PHY supports */
1093 phydev->advertising &= phydev->supported;
1094 advertise = phydev->advertising;
1095
1096 /* Setup standard advertisement */
1097 adv = phy_read(phydev, MII_ADVERTISE);
1098 if (adv < 0)
1099 return adv;
1100
1101 oldadv = adv;
1102 adv &= ~(ADVERTISE_ALL | ADVERTISE_100BASE4 | ADVERTISE_PAUSE_CAP |
1103 ADVERTISE_PAUSE_ASYM);
1104 adv |= ethtool_adv_to_mii_adv_t(advertise);
1105
1106 if (adv != oldadv) {
1107 err = phy_write(phydev, MII_ADVERTISE, adv);
1108
1109 if (err < 0)
1110 return err;
1111 changed = 1;
1112 }
1113
1114 bmsr = phy_read(phydev, MII_BMSR);
1115 if (bmsr < 0)
1116 return bmsr;
1117
1118 /* Per 802.3-2008, Section 22.2.4.2.16 Extended status all
1119 * 1000Mbits/sec capable PHYs shall have the BMSR_ESTATEN bit set to a
1120 * logical 1.
1121 */
1122 if (!(bmsr & BMSR_ESTATEN))
1123 return changed;
1124
1125 /* Configure gigabit if it's supported */
1126 adv = phy_read(phydev, MII_CTRL1000);
1127 if (adv < 0)
1128 return adv;
1129
1130 oldadv = adv;
1131 adv &= ~(ADVERTISE_1000FULL | ADVERTISE_1000HALF);
1132
1133 if (phydev->supported & (SUPPORTED_1000baseT_Half |
1134 SUPPORTED_1000baseT_Full)) {
1135 adv |= ethtool_adv_to_mii_ctrl1000_t(advertise);
1136 }
1137
1138 if (adv != oldadv)
1139 changed = 1;
1140
1141 err = phy_write(phydev, MII_CTRL1000, adv);
1142 if (err < 0)
1143 return err;
1144
1145 return changed;
1146 }
1147
1148 /**
1149 * genphy_config_eee_advert - disable unwanted eee mode advertisement
1150 * @phydev: target phy_device struct
1151 *
1152 * Description: Writes MDIO_AN_EEE_ADV after disabling unsupported energy
1153 * efficent ethernet modes. Returns 0 if the PHY's advertisement hasn't
1154 * changed, and 1 if it has changed.
1155 */
genphy_config_eee_advert(struct phy_device * phydev)1156 static int genphy_config_eee_advert(struct phy_device *phydev)
1157 {
1158 int broken = phydev->eee_broken_modes;
1159 int old_adv, adv;
1160
1161 /* Nothing to disable */
1162 if (!broken)
1163 return 0;
1164
1165 /* If the following call fails, we assume that EEE is not
1166 * supported by the phy. If we read 0, EEE is not advertised
1167 * In both case, we don't need to continue
1168 */
1169 adv = phy_read_mmd_indirect(phydev, MDIO_AN_EEE_ADV, MDIO_MMD_AN);
1170 if (adv <= 0)
1171 return 0;
1172
1173 old_adv = adv;
1174 adv &= ~broken;
1175
1176 /* Advertising remains unchanged with the broken mask */
1177 if (old_adv == adv)
1178 return 0;
1179
1180 phy_write_mmd_indirect(phydev, MDIO_AN_EEE_ADV, MDIO_MMD_AN, adv);
1181
1182 return 1;
1183 }
1184
1185 /**
1186 * genphy_setup_forced - configures/forces speed/duplex from @phydev
1187 * @phydev: target phy_device struct
1188 *
1189 * Description: Configures MII_BMCR to force speed/duplex
1190 * to the values in phydev. Assumes that the values are valid.
1191 * Please see phy_sanitize_settings().
1192 */
genphy_setup_forced(struct phy_device * phydev)1193 int genphy_setup_forced(struct phy_device *phydev)
1194 {
1195 int ctl = phy_read(phydev, MII_BMCR);
1196
1197 ctl &= BMCR_LOOPBACK | BMCR_ISOLATE | BMCR_PDOWN;
1198 phydev->pause = 0;
1199 phydev->asym_pause = 0;
1200
1201 if (SPEED_1000 == phydev->speed)
1202 ctl |= BMCR_SPEED1000;
1203 else if (SPEED_100 == phydev->speed)
1204 ctl |= BMCR_SPEED100;
1205
1206 if (DUPLEX_FULL == phydev->duplex)
1207 ctl |= BMCR_FULLDPLX;
1208
1209 return phy_write(phydev, MII_BMCR, ctl);
1210 }
1211 EXPORT_SYMBOL(genphy_setup_forced);
1212
1213 /**
1214 * genphy_restart_aneg - Enable and Restart Autonegotiation
1215 * @phydev: target phy_device struct
1216 */
genphy_restart_aneg(struct phy_device * phydev)1217 int genphy_restart_aneg(struct phy_device *phydev)
1218 {
1219 int ctl = phy_read(phydev, MII_BMCR);
1220
1221 if (ctl < 0)
1222 return ctl;
1223
1224 ctl |= BMCR_ANENABLE | BMCR_ANRESTART;
1225
1226 /* Don't isolate the PHY if we're negotiating */
1227 ctl &= ~BMCR_ISOLATE;
1228
1229 return phy_write(phydev, MII_BMCR, ctl);
1230 }
1231 EXPORT_SYMBOL(genphy_restart_aneg);
1232
1233 /**
1234 * genphy_config_aneg - restart auto-negotiation or write BMCR
1235 * @phydev: target phy_device struct
1236 *
1237 * Description: If auto-negotiation is enabled, we configure the
1238 * advertising, and then restart auto-negotiation. If it is not
1239 * enabled, then we write the BMCR.
1240 */
genphy_config_aneg(struct phy_device * phydev)1241 int genphy_config_aneg(struct phy_device *phydev)
1242 {
1243 int err, changed;
1244
1245 changed = genphy_config_eee_advert(phydev);
1246
1247 if (AUTONEG_ENABLE != phydev->autoneg)
1248 return genphy_setup_forced(phydev);
1249
1250 err = genphy_config_advert(phydev);
1251 if (err < 0) /* error */
1252 return err;
1253
1254 changed |= err;
1255
1256 if (changed == 0) {
1257 /* Advertisement hasn't changed, but maybe aneg was never on to
1258 * begin with? Or maybe phy was isolated?
1259 */
1260 int ctl = phy_read(phydev, MII_BMCR);
1261
1262 if (ctl < 0)
1263 return ctl;
1264
1265 if (!(ctl & BMCR_ANENABLE) || (ctl & BMCR_ISOLATE))
1266 changed = 1; /* do restart aneg */
1267 }
1268
1269 /* Only restart aneg if we are advertising something different
1270 * than we were before.
1271 */
1272 if (changed > 0)
1273 return genphy_restart_aneg(phydev);
1274
1275 return 0;
1276 }
1277 EXPORT_SYMBOL(genphy_config_aneg);
1278
1279 /**
1280 * genphy_aneg_done - return auto-negotiation status
1281 * @phydev: target phy_device struct
1282 *
1283 * Description: Reads the status register and returns 0 either if
1284 * auto-negotiation is incomplete, or if there was an error.
1285 * Returns BMSR_ANEGCOMPLETE if auto-negotiation is done.
1286 */
genphy_aneg_done(struct phy_device * phydev)1287 int genphy_aneg_done(struct phy_device *phydev)
1288 {
1289 int retval = phy_read(phydev, MII_BMSR);
1290
1291 return (retval < 0) ? retval : (retval & BMSR_ANEGCOMPLETE);
1292 }
1293 EXPORT_SYMBOL(genphy_aneg_done);
1294
gen10g_config_aneg(struct phy_device * phydev)1295 static int gen10g_config_aneg(struct phy_device *phydev)
1296 {
1297 return 0;
1298 }
1299
1300 /**
1301 * genphy_update_link - update link status in @phydev
1302 * @phydev: target phy_device struct
1303 *
1304 * Description: Update the value in phydev->link to reflect the
1305 * current link value. In order to do this, we need to read
1306 * the status register twice, keeping the second value.
1307 */
genphy_update_link(struct phy_device * phydev)1308 int genphy_update_link(struct phy_device *phydev)
1309 {
1310 int status;
1311
1312 /* Do a fake read */
1313 status = phy_read(phydev, MII_BMSR);
1314 if (status < 0)
1315 return status;
1316
1317 /* Read link and autonegotiation status */
1318 status = phy_read(phydev, MII_BMSR);
1319 if (status < 0)
1320 return status;
1321
1322 if ((status & BMSR_LSTATUS) == 0)
1323 phydev->link = 0;
1324 else
1325 phydev->link = 1;
1326
1327 return 0;
1328 }
1329 EXPORT_SYMBOL(genphy_update_link);
1330
1331 /**
1332 * genphy_read_status - check the link status and update current link state
1333 * @phydev: target phy_device struct
1334 *
1335 * Description: Check the link, then figure out the current state
1336 * by comparing what we advertise with what the link partner
1337 * advertises. Start by checking the gigabit possibilities,
1338 * then move on to 10/100.
1339 */
genphy_read_status(struct phy_device * phydev)1340 int genphy_read_status(struct phy_device *phydev)
1341 {
1342 int adv;
1343 int err;
1344 int lpa;
1345 int lpagb = 0;
1346 int common_adv;
1347 int common_adv_gb = 0;
1348
1349 /* Update the link, but return if there was an error */
1350 err = genphy_update_link(phydev);
1351 if (err)
1352 return err;
1353
1354 phydev->lp_advertising = 0;
1355
1356 if (AUTONEG_ENABLE == phydev->autoneg) {
1357 if (phydev->supported & (SUPPORTED_1000baseT_Half
1358 | SUPPORTED_1000baseT_Full)) {
1359 lpagb = phy_read(phydev, MII_STAT1000);
1360 if (lpagb < 0)
1361 return lpagb;
1362
1363 adv = phy_read(phydev, MII_CTRL1000);
1364 if (adv < 0)
1365 return adv;
1366
1367 phydev->lp_advertising =
1368 mii_stat1000_to_ethtool_lpa_t(lpagb);
1369 common_adv_gb = lpagb & adv << 2;
1370 }
1371
1372 lpa = phy_read(phydev, MII_LPA);
1373 if (lpa < 0)
1374 return lpa;
1375
1376 phydev->lp_advertising |= mii_lpa_to_ethtool_lpa_t(lpa);
1377
1378 adv = phy_read(phydev, MII_ADVERTISE);
1379 if (adv < 0)
1380 return adv;
1381
1382 common_adv = lpa & adv;
1383
1384 phydev->speed = SPEED_10;
1385 phydev->duplex = DUPLEX_HALF;
1386 phydev->pause = 0;
1387 phydev->asym_pause = 0;
1388
1389 if (common_adv_gb & (LPA_1000FULL | LPA_1000HALF)) {
1390 phydev->speed = SPEED_1000;
1391
1392 if (common_adv_gb & LPA_1000FULL)
1393 phydev->duplex = DUPLEX_FULL;
1394 } else if (common_adv & (LPA_100FULL | LPA_100HALF)) {
1395 phydev->speed = SPEED_100;
1396
1397 if (common_adv & LPA_100FULL)
1398 phydev->duplex = DUPLEX_FULL;
1399 } else
1400 if (common_adv & LPA_10FULL)
1401 phydev->duplex = DUPLEX_FULL;
1402
1403 if (phydev->duplex == DUPLEX_FULL) {
1404 phydev->pause = lpa & LPA_PAUSE_CAP ? 1 : 0;
1405 phydev->asym_pause = lpa & LPA_PAUSE_ASYM ? 1 : 0;
1406 }
1407 } else {
1408 int bmcr = phy_read(phydev, MII_BMCR);
1409
1410 if (bmcr < 0)
1411 return bmcr;
1412
1413 if (bmcr & BMCR_FULLDPLX)
1414 phydev->duplex = DUPLEX_FULL;
1415 else
1416 phydev->duplex = DUPLEX_HALF;
1417
1418 if (bmcr & BMCR_SPEED1000)
1419 phydev->speed = SPEED_1000;
1420 else if (bmcr & BMCR_SPEED100)
1421 phydev->speed = SPEED_100;
1422 else
1423 phydev->speed = SPEED_10;
1424
1425 phydev->pause = 0;
1426 phydev->asym_pause = 0;
1427 }
1428
1429 return 0;
1430 }
1431 EXPORT_SYMBOL(genphy_read_status);
1432
gen10g_read_status(struct phy_device * phydev)1433 static int gen10g_read_status(struct phy_device *phydev)
1434 {
1435 int devad, reg;
1436 u32 mmd_mask = phydev->c45_ids.devices_in_package;
1437
1438 phydev->link = 1;
1439
1440 /* For now just lie and say it's 10G all the time */
1441 phydev->speed = SPEED_10000;
1442 phydev->duplex = DUPLEX_FULL;
1443
1444 for (devad = 0; mmd_mask; devad++, mmd_mask = mmd_mask >> 1) {
1445 if (!(mmd_mask & 1))
1446 continue;
1447
1448 /* Read twice because link state is latched and a
1449 * read moves the current state into the register
1450 */
1451 phy_read_mmd(phydev, devad, MDIO_STAT1);
1452 reg = phy_read_mmd(phydev, devad, MDIO_STAT1);
1453 if (reg < 0 || !(reg & MDIO_STAT1_LSTATUS))
1454 phydev->link = 0;
1455 }
1456
1457 return 0;
1458 }
1459
1460 /**
1461 * genphy_soft_reset - software reset the PHY via BMCR_RESET bit
1462 * @phydev: target phy_device struct
1463 *
1464 * Description: Perform a software PHY reset using the standard
1465 * BMCR_RESET bit and poll for the reset bit to be cleared.
1466 *
1467 * Returns: 0 on success, < 0 on failure
1468 */
genphy_soft_reset(struct phy_device * phydev)1469 int genphy_soft_reset(struct phy_device *phydev)
1470 {
1471 int ret;
1472
1473 ret = phy_write(phydev, MII_BMCR, BMCR_RESET);
1474 if (ret < 0)
1475 return ret;
1476
1477 return phy_poll_reset(phydev);
1478 }
1479 EXPORT_SYMBOL(genphy_soft_reset);
1480
genphy_config_init(struct phy_device * phydev)1481 int genphy_config_init(struct phy_device *phydev)
1482 {
1483 int val;
1484 u32 features;
1485
1486 features = (SUPPORTED_TP | SUPPORTED_MII
1487 | SUPPORTED_AUI | SUPPORTED_FIBRE |
1488 SUPPORTED_BNC | SUPPORTED_Pause | SUPPORTED_Asym_Pause);
1489
1490 /* Do we support autonegotiation? */
1491 val = phy_read(phydev, MII_BMSR);
1492 if (val < 0)
1493 return val;
1494
1495 if (val & BMSR_ANEGCAPABLE)
1496 features |= SUPPORTED_Autoneg;
1497
1498 if (val & BMSR_100FULL)
1499 features |= SUPPORTED_100baseT_Full;
1500 if (val & BMSR_100HALF)
1501 features |= SUPPORTED_100baseT_Half;
1502 if (val & BMSR_10FULL)
1503 features |= SUPPORTED_10baseT_Full;
1504 if (val & BMSR_10HALF)
1505 features |= SUPPORTED_10baseT_Half;
1506
1507 if (val & BMSR_ESTATEN) {
1508 val = phy_read(phydev, MII_ESTATUS);
1509 if (val < 0)
1510 return val;
1511
1512 if (val & ESTATUS_1000_TFULL)
1513 features |= SUPPORTED_1000baseT_Full;
1514 if (val & ESTATUS_1000_THALF)
1515 features |= SUPPORTED_1000baseT_Half;
1516 }
1517
1518 phydev->supported &= features;
1519 phydev->advertising &= features;
1520
1521 return 0;
1522 }
1523
gen10g_soft_reset(struct phy_device * phydev)1524 static int gen10g_soft_reset(struct phy_device *phydev)
1525 {
1526 /* Do nothing for now */
1527 return 0;
1528 }
1529 EXPORT_SYMBOL(genphy_config_init);
1530
gen10g_config_init(struct phy_device * phydev)1531 static int gen10g_config_init(struct phy_device *phydev)
1532 {
1533 /* Temporarily just say we support everything */
1534 phydev->supported = SUPPORTED_10000baseT_Full;
1535 phydev->advertising = SUPPORTED_10000baseT_Full;
1536
1537 return 0;
1538 }
1539
genphy_suspend(struct phy_device * phydev)1540 int genphy_suspend(struct phy_device *phydev)
1541 {
1542 int value;
1543
1544 mutex_lock(&phydev->lock);
1545
1546 value = phy_read(phydev, MII_BMCR);
1547 phy_write(phydev, MII_BMCR, value | BMCR_PDOWN);
1548
1549 mutex_unlock(&phydev->lock);
1550
1551 return 0;
1552 }
1553 EXPORT_SYMBOL(genphy_suspend);
1554
gen10g_suspend(struct phy_device * phydev)1555 static int gen10g_suspend(struct phy_device *phydev)
1556 {
1557 return 0;
1558 }
1559
genphy_resume(struct phy_device * phydev)1560 int genphy_resume(struct phy_device *phydev)
1561 {
1562 int value;
1563
1564 mutex_lock(&phydev->lock);
1565
1566 value = phy_read(phydev, MII_BMCR);
1567 phy_write(phydev, MII_BMCR, value & ~BMCR_PDOWN);
1568
1569 mutex_unlock(&phydev->lock);
1570
1571 return 0;
1572 }
1573 EXPORT_SYMBOL(genphy_resume);
1574
gen10g_resume(struct phy_device * phydev)1575 static int gen10g_resume(struct phy_device *phydev)
1576 {
1577 return 0;
1578 }
1579
__set_phy_supported(struct phy_device * phydev,u32 max_speed)1580 static int __set_phy_supported(struct phy_device *phydev, u32 max_speed)
1581 {
1582 /* The default values for phydev->supported are provided by the PHY
1583 * driver "features" member, we want to reset to sane defaults first
1584 * before supporting higher speeds.
1585 */
1586 phydev->supported &= PHY_DEFAULT_FEATURES;
1587
1588 switch (max_speed) {
1589 default:
1590 return -ENOTSUPP;
1591 case SPEED_1000:
1592 phydev->supported |= PHY_1000BT_FEATURES;
1593 /* fall through */
1594 case SPEED_100:
1595 phydev->supported |= PHY_100BT_FEATURES;
1596 /* fall through */
1597 case SPEED_10:
1598 phydev->supported |= PHY_10BT_FEATURES;
1599 }
1600
1601 return 0;
1602 }
1603
phy_set_max_speed(struct phy_device * phydev,u32 max_speed)1604 int phy_set_max_speed(struct phy_device *phydev, u32 max_speed)
1605 {
1606 int err;
1607
1608 err = __set_phy_supported(phydev, max_speed);
1609 if (err)
1610 return err;
1611
1612 phydev->advertising = phydev->supported;
1613
1614 return 0;
1615 }
1616 EXPORT_SYMBOL(phy_set_max_speed);
1617
of_set_phy_supported(struct phy_device * phydev)1618 static void of_set_phy_supported(struct phy_device *phydev)
1619 {
1620 struct device_node *node = phydev->mdio.dev.of_node;
1621 u32 max_speed;
1622
1623 if (!IS_ENABLED(CONFIG_OF_MDIO))
1624 return;
1625
1626 if (!node)
1627 return;
1628
1629 if (!of_property_read_u32(node, "max-speed", &max_speed))
1630 __set_phy_supported(phydev, max_speed);
1631 }
1632
of_set_phy_eee_broken(struct phy_device * phydev)1633 static void of_set_phy_eee_broken(struct phy_device *phydev)
1634 {
1635 struct device_node *node = phydev->mdio.dev.of_node;
1636 u32 broken = 0;
1637
1638 if (!IS_ENABLED(CONFIG_OF_MDIO))
1639 return;
1640
1641 if (!node)
1642 return;
1643
1644 if (of_property_read_bool(node, "eee-broken-100tx"))
1645 broken |= MDIO_EEE_100TX;
1646 if (of_property_read_bool(node, "eee-broken-1000t"))
1647 broken |= MDIO_EEE_1000T;
1648 if (of_property_read_bool(node, "eee-broken-10gt"))
1649 broken |= MDIO_EEE_10GT;
1650 if (of_property_read_bool(node, "eee-broken-1000kx"))
1651 broken |= MDIO_EEE_1000KX;
1652 if (of_property_read_bool(node, "eee-broken-10gkx4"))
1653 broken |= MDIO_EEE_10GKX4;
1654 if (of_property_read_bool(node, "eee-broken-10gkr"))
1655 broken |= MDIO_EEE_10GKR;
1656
1657 phydev->eee_broken_modes = broken;
1658 }
1659
1660 /**
1661 * phy_probe - probe and init a PHY device
1662 * @dev: device to probe and init
1663 *
1664 * Description: Take care of setting up the phy_device structure,
1665 * set the state to READY (the driver's init function should
1666 * set it to STARTING if needed).
1667 */
phy_probe(struct device * dev)1668 static int phy_probe(struct device *dev)
1669 {
1670 struct phy_device *phydev = to_phy_device(dev);
1671 struct device_driver *drv = phydev->mdio.dev.driver;
1672 struct phy_driver *phydrv = to_phy_driver(drv);
1673 int err = 0;
1674
1675 phydev->drv = phydrv;
1676
1677 /* Disable the interrupt if the PHY doesn't support it
1678 * but the interrupt is still a valid one
1679 */
1680 if (!(phydrv->flags & PHY_HAS_INTERRUPT) &&
1681 phy_interrupt_is_valid(phydev))
1682 phydev->irq = PHY_POLL;
1683
1684 if (phydrv->flags & PHY_IS_INTERNAL)
1685 phydev->is_internal = true;
1686
1687 mutex_lock(&phydev->lock);
1688
1689 /* Start out supporting everything. Eventually,
1690 * a controller will attach, and may modify one
1691 * or both of these values
1692 */
1693 phydev->supported = phydrv->features;
1694 of_set_phy_supported(phydev);
1695 phydev->advertising = phydev->supported;
1696
1697 /* Get the EEE modes we want to prohibit. We will ask
1698 * the PHY stop advertising these mode later on
1699 */
1700 of_set_phy_eee_broken(phydev);
1701
1702 /* Set the state to READY by default */
1703 phydev->state = PHY_READY;
1704
1705 if (phydev->drv->probe)
1706 err = phydev->drv->probe(phydev);
1707
1708 mutex_unlock(&phydev->lock);
1709
1710 return err;
1711 }
1712
phy_remove(struct device * dev)1713 static int phy_remove(struct device *dev)
1714 {
1715 struct phy_device *phydev = to_phy_device(dev);
1716
1717 cancel_delayed_work_sync(&phydev->state_queue);
1718
1719 mutex_lock(&phydev->lock);
1720 phydev->state = PHY_DOWN;
1721 mutex_unlock(&phydev->lock);
1722
1723 if (phydev->drv->remove)
1724 phydev->drv->remove(phydev);
1725 phydev->drv = NULL;
1726
1727 return 0;
1728 }
1729
1730 /**
1731 * phy_driver_register - register a phy_driver with the PHY layer
1732 * @new_driver: new phy_driver to register
1733 * @owner: module owning this PHY
1734 */
phy_driver_register(struct phy_driver * new_driver,struct module * owner)1735 int phy_driver_register(struct phy_driver *new_driver, struct module *owner)
1736 {
1737 int retval;
1738
1739 new_driver->mdiodrv.flags |= MDIO_DEVICE_IS_PHY;
1740 new_driver->mdiodrv.driver.name = new_driver->name;
1741 new_driver->mdiodrv.driver.bus = &mdio_bus_type;
1742 new_driver->mdiodrv.driver.probe = phy_probe;
1743 new_driver->mdiodrv.driver.remove = phy_remove;
1744 new_driver->mdiodrv.driver.owner = owner;
1745
1746 retval = driver_register(&new_driver->mdiodrv.driver);
1747 if (retval) {
1748 pr_err("%s: Error %d in registering driver\n",
1749 new_driver->name, retval);
1750
1751 return retval;
1752 }
1753
1754 pr_debug("%s: Registered new driver\n", new_driver->name);
1755
1756 return 0;
1757 }
1758 EXPORT_SYMBOL(phy_driver_register);
1759
phy_drivers_register(struct phy_driver * new_driver,int n,struct module * owner)1760 int phy_drivers_register(struct phy_driver *new_driver, int n,
1761 struct module *owner)
1762 {
1763 int i, ret = 0;
1764
1765 for (i = 0; i < n; i++) {
1766 ret = phy_driver_register(new_driver + i, owner);
1767 if (ret) {
1768 while (i-- > 0)
1769 phy_driver_unregister(new_driver + i);
1770 break;
1771 }
1772 }
1773 return ret;
1774 }
1775 EXPORT_SYMBOL(phy_drivers_register);
1776
phy_driver_unregister(struct phy_driver * drv)1777 void phy_driver_unregister(struct phy_driver *drv)
1778 {
1779 driver_unregister(&drv->mdiodrv.driver);
1780 }
1781 EXPORT_SYMBOL(phy_driver_unregister);
1782
phy_drivers_unregister(struct phy_driver * drv,int n)1783 void phy_drivers_unregister(struct phy_driver *drv, int n)
1784 {
1785 int i;
1786
1787 for (i = 0; i < n; i++)
1788 phy_driver_unregister(drv + i);
1789 }
1790 EXPORT_SYMBOL(phy_drivers_unregister);
1791
1792 static struct phy_driver genphy_driver[] = {
1793 {
1794 .phy_id = 0xffffffff,
1795 .phy_id_mask = 0xffffffff,
1796 .name = "Generic PHY",
1797 .soft_reset = genphy_no_soft_reset,
1798 .config_init = genphy_config_init,
1799 .features = PHY_GBIT_FEATURES | SUPPORTED_MII |
1800 SUPPORTED_AUI | SUPPORTED_FIBRE |
1801 SUPPORTED_BNC,
1802 .config_aneg = genphy_config_aneg,
1803 .aneg_done = genphy_aneg_done,
1804 .read_status = genphy_read_status,
1805 .suspend = genphy_suspend,
1806 .resume = genphy_resume,
1807 }, {
1808 .phy_id = 0xffffffff,
1809 .phy_id_mask = 0xffffffff,
1810 .name = "Generic 10G PHY",
1811 .soft_reset = gen10g_soft_reset,
1812 .config_init = gen10g_config_init,
1813 .features = 0,
1814 .config_aneg = gen10g_config_aneg,
1815 .read_status = gen10g_read_status,
1816 .suspend = gen10g_suspend,
1817 .resume = gen10g_resume,
1818 } };
1819
phy_init(void)1820 static int __init phy_init(void)
1821 {
1822 int rc;
1823
1824 rc = mdio_bus_init();
1825 if (rc)
1826 return rc;
1827
1828 rc = phy_drivers_register(genphy_driver,
1829 ARRAY_SIZE(genphy_driver), THIS_MODULE);
1830 if (rc)
1831 mdio_bus_exit();
1832
1833 return rc;
1834 }
1835
phy_exit(void)1836 static void __exit phy_exit(void)
1837 {
1838 phy_drivers_unregister(genphy_driver,
1839 ARRAY_SIZE(genphy_driver));
1840 mdio_bus_exit();
1841 }
1842
1843 subsys_initcall(phy_init);
1844 module_exit(phy_exit);
1845