phy_device.c 30.0 KB
Newer Older
S
Sergei Shtylyov 已提交
1
/* Framework for finding and configuring PHYs.
2 3 4 5 6 7 8 9 10 11 12 13
 * Also contains generic PHY driver
 *
 * Author: Andy Fleming
 *
 * Copyright (c) 2004 Freescale Semiconductor, Inc.
 *
 * This program is free software; you can redistribute  it and/or modify it
 * under  the terms of  the GNU General  Public License as published by the
 * Free Software Foundation;  either version 2 of the  License, or (at your
 * option) any later version.
 *
 */
J
Joe Perches 已提交
14 15 16

#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt

17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
#include <linux/kernel.h>
#include <linux/string.h>
#include <linux/errno.h>
#include <linux/unistd.h>
#include <linux/slab.h>
#include <linux/interrupt.h>
#include <linux/init.h>
#include <linux/delay.h>
#include <linux/netdevice.h>
#include <linux/etherdevice.h>
#include <linux/skbuff.h>
#include <linux/mm.h>
#include <linux/module.h>
#include <linux/mii.h>
#include <linux/ethtool.h>
#include <linux/phy.h>
S
Sergei Shtylyov 已提交
33 34
#include <linux/io.h>
#include <linux/uaccess.h>
35 36 37

#include <asm/irq.h>

38 39 40 41
MODULE_DESCRIPTION("PHY library");
MODULE_AUTHOR("Andy Fleming");
MODULE_LICENSE("GPL");

42 43
void phy_device_free(struct phy_device *phydev)
{
44
	put_device(&phydev->dev);
45
}
46
EXPORT_SYMBOL(phy_device_free);
47 48 49

static void phy_device_release(struct device *dev)
{
50
	kfree(to_phy_device(dev));
51 52
}

53 54 55 56 57 58
enum genphy_driver {
	GENPHY_DRV_1G,
	GENPHY_DRV_MAX
};

static struct phy_driver genphy_driver[GENPHY_DRV_MAX];
59

60 61 62
static LIST_HEAD(phy_fixup_list);
static DEFINE_MUTEX(phy_fixup_lock);

63 64 65
static int phy_attach_direct(struct net_device *dev, struct phy_device *phydev,
			     u32 flags, phy_interface_t interface);

S
Sergei Shtylyov 已提交
66 67
/**
 * phy_register_fixup - creates a new phy_fixup and adds it to the list
68 69
 * @bus_id: A string which matches phydev->dev.bus_id (or PHY_ANY_ID)
 * @phy_uid: Used to match against phydev->phy_id (the UID of the PHY)
S
Sergei Shtylyov 已提交
70
 *	It can also be PHY_ANY_UID
71
 * @phy_uid_mask: Applied to phydev->phy_id and fixup->phy_uid before
S
Sergei Shtylyov 已提交
72
 *	comparison
73 74 75
 * @run: The actual code to be run when a matching PHY is found
 */
int phy_register_fixup(const char *bus_id, u32 phy_uid, u32 phy_uid_mask,
S
Sergei Shtylyov 已提交
76
		       int (*run)(struct phy_device *))
77
{
S
Sergei Shtylyov 已提交
78
	struct phy_fixup *fixup = kzalloc(sizeof(*fixup), GFP_KERNEL);
79 80 81 82

	if (!fixup)
		return -ENOMEM;

83
	strlcpy(fixup->bus_id, bus_id, sizeof(fixup->bus_id));
84 85 86 87 88 89 90 91 92 93 94 95 96 97
	fixup->phy_uid = phy_uid;
	fixup->phy_uid_mask = phy_uid_mask;
	fixup->run = run;

	mutex_lock(&phy_fixup_lock);
	list_add_tail(&fixup->list, &phy_fixup_list);
	mutex_unlock(&phy_fixup_lock);

	return 0;
}
EXPORT_SYMBOL(phy_register_fixup);

/* Registers a fixup to be run on any PHY with the UID in phy_uid */
int phy_register_fixup_for_uid(u32 phy_uid, u32 phy_uid_mask,
S
Sergei Shtylyov 已提交
98
			       int (*run)(struct phy_device *))
99 100 101 102 103 104 105
{
	return phy_register_fixup(PHY_ANY_ID, phy_uid, phy_uid_mask, run);
}
EXPORT_SYMBOL(phy_register_fixup_for_uid);

/* Registers a fixup to be run on the PHY with id string bus_id */
int phy_register_fixup_for_id(const char *bus_id,
S
Sergei Shtylyov 已提交
106
			      int (*run)(struct phy_device *))
107 108 109 110 111
{
	return phy_register_fixup(bus_id, PHY_ANY_UID, 0xffffffff, run);
}
EXPORT_SYMBOL(phy_register_fixup_for_id);

S
Sergei Shtylyov 已提交
112
/* Returns 1 if fixup matches phydev in bus_id and phy_uid.
113 114 115 116
 * Fixups can be set to match any in one or more fields.
 */
static int phy_needs_fixup(struct phy_device *phydev, struct phy_fixup *fixup)
{
117
	if (strcmp(fixup->bus_id, dev_name(&phydev->dev)) != 0)
118 119 120 121
		if (strcmp(fixup->bus_id, PHY_ANY_ID) != 0)
			return 0;

	if ((fixup->phy_uid & fixup->phy_uid_mask) !=
S
Sergei Shtylyov 已提交
122
	    (phydev->phy_id & fixup->phy_uid_mask))
123 124 125 126 127 128 129
		if (fixup->phy_uid != PHY_ANY_UID)
			return 0;

	return 1;
}

/* Runs any matching fixups for this phydev */
130
static int phy_scan_fixups(struct phy_device *phydev)
131 132 133 134 135 136
{
	struct phy_fixup *fixup;

	mutex_lock(&phy_fixup_lock);
	list_for_each_entry(fixup, &phy_fixup_list, list) {
		if (phy_needs_fixup(phydev, fixup)) {
S
Sergei Shtylyov 已提交
137
			int err = fixup->run(phydev);
138

J
Jiri Slaby 已提交
139 140
			if (err < 0) {
				mutex_unlock(&phy_fixup_lock);
141
				return err;
J
Jiri Slaby 已提交
142
			}
143 144 145 146 147 148 149
		}
	}
	mutex_unlock(&phy_fixup_lock);

	return 0;
}

150
struct phy_device *phy_device_create(struct mii_bus *bus, int addr, int phy_id,
S
Sergei Shtylyov 已提交
151 152
				     bool is_c45,
				     struct phy_c45_device_ids *c45_ids)
153 154
{
	struct phy_device *dev;
155

S
Sergei Shtylyov 已提交
156
	/* We allocate the device, and initialize the default values */
157
	dev = kzalloc(sizeof(*dev), GFP_KERNEL);
158
	if (NULL == dev)
F
Florian Fainelli 已提交
159
		return (struct phy_device *)PTR_ERR((void *)-ENOMEM);
160

161 162
	dev->dev.release = phy_device_release;

163 164
	dev->speed = 0;
	dev->duplex = -1;
S
Sergei Shtylyov 已提交
165 166
	dev->pause = 0;
	dev->asym_pause = 0;
167
	dev->link = 1;
168
	dev->interface = PHY_INTERFACE_MODE_GMII;
169 170 171

	dev->autoneg = AUTONEG_ENABLE;

172
	dev->is_c45 = is_c45;
173 174
	dev->addr = addr;
	dev->phy_id = phy_id;
175 176
	if (c45_ids)
		dev->c45_ids = *c45_ids;
177
	dev->bus = bus;
178 179 180 181
	dev->dev.parent = bus->parent;
	dev->dev.bus = &mdio_bus_type;
	dev->irq = bus->irq != NULL ? bus->irq[addr] : PHY_POLL;
	dev_set_name(&dev->dev, PHY_ID_FMT, bus->id, addr);
182 183 184

	dev->state = PHY_DOWN;

185
	mutex_init(&dev->lock);
186
	INIT_DELAYED_WORK(&dev->state_queue, phy_state_machine);
187
	INIT_WORK(&dev->phy_queue, phy_change);
188

189
	/* Request the appropriate module unconditionally; don't
S
Sergei Shtylyov 已提交
190 191 192 193 194 195 196 197 198
	 * bother trying to do so only if it isn't already loaded,
	 * because that gets complicated. A hotplug event would have
	 * done an unconditional modprobe anyway.
	 * We don't do normal hotplug because it won't work for MDIO
	 * -- because it relies on the device staying around for long
	 * enough for the driver to get loaded. With MDIO, the NIC
	 * driver will get bored and give up as soon as it finds that
	 * there's no driver _already_ loaded.
	 */
199 200
	request_module(MDIO_MODULE_PREFIX MDIO_ID_FMT, MDIO_ID_ARGS(phy_id));

201 202
	device_initialize(&dev->dev);

203 204
	return dev;
}
205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272
EXPORT_SYMBOL(phy_device_create);

/**
 * get_phy_c45_ids - reads the specified addr for its 802.3-c45 IDs.
 * @bus: the target MII bus
 * @addr: PHY address on the MII bus
 * @phy_id: where to store the ID retrieved.
 * @c45_ids: where to store the c45 ID information.
 *
 *   If the PHY devices-in-package appears to be valid, it and the
 *   corresponding identifiers are stored in @c45_ids, zero is stored
 *   in @phy_id.  Otherwise 0xffffffff is stored in @phy_id.  Returns
 *   zero on success.
 *
 */
static int get_phy_c45_ids(struct mii_bus *bus, int addr, u32 *phy_id,
			   struct phy_c45_device_ids *c45_ids) {
	int phy_reg;
	int i, reg_addr;
	const int num_ids = ARRAY_SIZE(c45_ids->device_ids);

	/* Find first non-zero Devices In package.  Device
	 * zero is reserved, so don't probe it.
	 */
	for (i = 1;
	     i < num_ids && c45_ids->devices_in_package == 0;
	     i++) {
		reg_addr = MII_ADDR_C45 | i << 16 | 6;
		phy_reg = mdiobus_read(bus, addr, reg_addr);
		if (phy_reg < 0)
			return -EIO;
		c45_ids->devices_in_package = (phy_reg & 0xffff) << 16;

		reg_addr = MII_ADDR_C45 | i << 16 | 5;
		phy_reg = mdiobus_read(bus, addr, reg_addr);
		if (phy_reg < 0)
			return -EIO;
		c45_ids->devices_in_package |= (phy_reg & 0xffff);

		/* If mostly Fs, there is no device there,
		 * let's get out of here.
		 */
		if ((c45_ids->devices_in_package & 0x1fffffff) == 0x1fffffff) {
			*phy_id = 0xffffffff;
			return 0;
		}
	}

	/* Now probe Device Identifiers for each device present. */
	for (i = 1; i < num_ids; i++) {
		if (!(c45_ids->devices_in_package & (1 << i)))
			continue;

		reg_addr = MII_ADDR_C45 | i << 16 | MII_PHYSID1;
		phy_reg = mdiobus_read(bus, addr, reg_addr);
		if (phy_reg < 0)
			return -EIO;
		c45_ids->device_ids[i] = (phy_reg & 0xffff) << 16;

		reg_addr = MII_ADDR_C45 | i << 16 | MII_PHYSID2;
		phy_reg = mdiobus_read(bus, addr, reg_addr);
		if (phy_reg < 0)
			return -EIO;
		c45_ids->device_ids[i] |= (phy_reg & 0xffff);
	}
	*phy_id = 0;
	return 0;
}
273

274
/**
275
 * get_phy_id - reads the specified addr for its ID.
276 277
 * @bus: the target MII bus
 * @addr: PHY address on the MII bus
278
 * @phy_id: where to store the ID retrieved.
279 280 281 282 283 284 285 286 287
 * @is_c45: If true the PHY uses the 802.3 clause 45 protocol
 * @c45_ids: where to store the c45 ID information.
 *
 * Description: In the case of a 802.3-c22 PHY, reads the ID registers
 *   of the PHY at @addr on the @bus, stores it in @phy_id and returns
 *   zero on success.
 *
 *   In the case of a 802.3-c45 PHY, get_phy_c45_ids() is invoked, and
 *   its return value is in turn returned.
288 289
 *
 */
290 291
static int get_phy_id(struct mii_bus *bus, int addr, u32 *phy_id,
		      bool is_c45, struct phy_c45_device_ids *c45_ids)
292 293 294
{
	int phy_reg;

295 296 297
	if (is_c45)
		return get_phy_c45_ids(bus, addr, phy_id, c45_ids);

S
Sergei Shtylyov 已提交
298
	/* Grab the bits from PHYIR1, and put them in the upper half */
299
	phy_reg = mdiobus_read(bus, addr, MII_PHYSID1);
300
	if (phy_reg < 0)
301
		return -EIO;
302

303
	*phy_id = (phy_reg & 0xffff) << 16;
304 305

	/* Grab the bits from PHYIR2, and put them in the lower half */
306
	phy_reg = mdiobus_read(bus, addr, MII_PHYSID2);
307
	if (phy_reg < 0)
308 309 310 311 312 313 314 315
		return -EIO;

	*phy_id |= (phy_reg & 0xffff);

	return 0;
}

/**
S
Sergei Shtylyov 已提交
316 317
 * get_phy_device - reads the specified PHY device and returns its @phy_device
 *		    struct
318 319
 * @bus: the target MII bus
 * @addr: PHY address on the MII bus
320
 * @is_c45: If true the PHY uses the 802.3 clause 45 protocol
321 322 323 324
 *
 * Description: Reads the ID registers of the PHY at @addr on the
 *   @bus, then allocates and returns the phy_device to represent it.
 */
325
struct phy_device *get_phy_device(struct mii_bus *bus, int addr, bool is_c45)
326
{
327
	struct phy_c45_device_ids c45_ids = {0};
328
	u32 phy_id = 0;
329
	int r;
330

331
	r = get_phy_id(bus, addr, &phy_id, is_c45, &c45_ids);
332 333
	if (r)
		return ERR_PTR(r);
334

335 336 337 338
	/* If the phy_id is mostly Fs, there is no device there */
	if ((phy_id & 0x1fffffff) == 0x1fffffff)
		return NULL;

339
	return phy_device_create(bus, addr, phy_id, is_c45, &c45_ids);
340
}
341 342 343 344
EXPORT_SYMBOL(get_phy_device);

/**
 * phy_device_register - Register the phy device on the MDIO bus
345
 * @phydev: phy_device structure to be added to the MDIO bus
346 347 348 349 350
 */
int phy_device_register(struct phy_device *phydev)
{
	int err;

S
Sergei Shtylyov 已提交
351
	/* Don't register a phy if one is already registered at this address */
352 353 354 355 356
	if (phydev->bus->phy_map[phydev->addr])
		return -EINVAL;
	phydev->bus->phy_map[phydev->addr] = phydev;

	/* Run all of the fixups for this PHY */
357 358 359 360 361
	err = phy_init_hw(phydev);
	if (err) {
		pr_err("PHY %d failed to initialize\n", phydev->addr);
		goto out;
	}
362

363
	err = device_add(&phydev->dev);
364
	if (err) {
365
		pr_err("PHY %d failed to add\n", phydev->addr);
366 367 368 369 370 371 372 373 374 375
		goto out;
	}

	return 0;

 out:
	phydev->bus->phy_map[phydev->addr] = NULL;
	return err;
}
EXPORT_SYMBOL(phy_device_register);
376

J
Jiri Pirko 已提交
377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392
/**
 * phy_find_first - finds the first PHY device on the bus
 * @bus: the target MII bus
 */
struct phy_device *phy_find_first(struct mii_bus *bus)
{
	int addr;

	for (addr = 0; addr < PHY_MAX_ADDR; addr++) {
		if (bus->phy_map[addr])
			return bus->phy_map[addr];
	}
	return NULL;
}
EXPORT_SYMBOL(phy_find_first);

393 394 395 396
/**
 * phy_prepare_link - prepares the PHY layer to monitor link status
 * @phydev: target phy_device struct
 * @handler: callback function for link status change notifications
397
 *
398
 * Description: Tells the PHY infrastructure to handle the
399 400 401 402
 *   gory details on monitoring link status (whether through
 *   polling or an interrupt), and to call back to the
 *   connected device driver when the link status changes.
 *   If you want to monitor your own link state, don't call
403 404
 *   this function.
 */
405
static void phy_prepare_link(struct phy_device *phydev,
S
Sergei Shtylyov 已提交
406
			     void (*handler)(struct net_device *))
407 408 409 410
{
	phydev->adjust_link = handler;
}

411 412 413 414 415 416 417 418
/**
 * phy_connect_direct - connect an ethernet device to a specific phy_device
 * @dev: the network device to connect
 * @phydev: the pointer to the phy device
 * @handler: callback function for state change notifications
 * @interface: PHY device's interface
 */
int phy_connect_direct(struct net_device *dev, struct phy_device *phydev,
419
		       void (*handler)(struct net_device *),
420 421 422 423
		       phy_interface_t interface)
{
	int rc;

424
	rc = phy_attach_direct(dev, phydev, phydev->dev_flags, interface);
425 426 427 428
	if (rc)
		return rc;

	phy_prepare_link(phydev, handler);
429
	phy_start_machine(phydev);
430 431 432 433 434 435 436
	if (phydev->irq > 0)
		phy_start_interrupts(phydev);

	return 0;
}
EXPORT_SYMBOL(phy_connect_direct);

437 438 439
/**
 * phy_connect - connect an ethernet device to a PHY device
 * @dev: the network device to connect
440
 * @bus_id: the id string of the PHY device to connect
441 442
 * @handler: callback function for state change notifications
 * @interface: PHY device's interface
A
Andy Fleming 已提交
443
 *
444
 * Description: Convenience function for connecting ethernet
A
Andy Fleming 已提交
445 446 447 448 449 450 451
 *   devices to PHY devices.  The default behavior is for
 *   the PHY infrastructure to handle everything, and only notify
 *   the connected driver when the link status changes.  If you
 *   don't want, or can't use the provided functionality, you may
 *   choose to call only the subset of functions which provide
 *   the desired functionality.
 */
F
Florian Fainelli 已提交
452
struct phy_device *phy_connect(struct net_device *dev, const char *bus_id,
S
Sergei Shtylyov 已提交
453 454
			       void (*handler)(struct net_device *),
			       phy_interface_t interface)
A
Andy Fleming 已提交
455 456
{
	struct phy_device *phydev;
457 458
	struct device *d;
	int rc;
A
Andy Fleming 已提交
459

460
	/* Search the list of PHY devices on the mdio bus for the
S
Sergei Shtylyov 已提交
461 462
	 * PHY with the requested name
	 */
463 464 465 466 467 468
	d = bus_find_device_by_name(&mdio_bus_type, NULL, bus_id);
	if (!d) {
		pr_err("PHY %s not found\n", bus_id);
		return ERR_PTR(-ENODEV);
	}
	phydev = to_phy_device(d);
A
Andy Fleming 已提交
469

470
	rc = phy_connect_direct(dev, phydev, handler, interface);
471 472
	if (rc)
		return ERR_PTR(rc);
A
Andy Fleming 已提交
473 474 475 476 477

	return phydev;
}
EXPORT_SYMBOL(phy_connect);

478
/**
S
Sergei Shtylyov 已提交
479 480
 * phy_disconnect - disable interrupts, stop state machine, and detach a PHY
 *		    device
481 482
 * @phydev: target phy_device struct
 */
A
Andy Fleming 已提交
483 484 485 486 487 488
void phy_disconnect(struct phy_device *phydev)
{
	if (phydev->irq > 0)
		phy_stop_interrupts(phydev);

	phy_stop_machine(phydev);
F
Florian Fainelli 已提交
489

A
Andy Fleming 已提交
490 491 492 493 494 495
	phydev->adjust_link = NULL;

	phy_detach(phydev);
}
EXPORT_SYMBOL(phy_disconnect);

496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528
/**
 * phy_poll_reset - Safely wait until a PHY reset has properly completed
 * @phydev: The PHY device to poll
 *
 * Description: According to IEEE 802.3, Section 2, Subsection 22.2.4.1.1, as
 *   published in 2008, a PHY reset may take up to 0.5 seconds.  The MII BMCR
 *   register must be polled until the BMCR_RESET bit clears.
 *
 *   Furthermore, any attempts to write to PHY registers may have no effect
 *   or even generate MDIO bus errors until this is complete.
 *
 *   Some PHYs (such as the Marvell 88E1111) don't entirely conform to the
 *   standard and do not fully reset after the BMCR_RESET bit is set, and may
 *   even *REQUIRE* a soft-reset to properly restart autonegotiation.  In an
 *   effort to support such broken PHYs, this function is separate from the
 *   standard phy_init_hw() which will zero all the other bits in the BMCR
 *   and reapply all driver-specific and board-specific fixups.
 */
static int phy_poll_reset(struct phy_device *phydev)
{
	/* Poll until the reset bit clears (50ms per retry == 0.6 sec) */
	unsigned int retries = 12;
	int ret;

	do {
		msleep(50);
		ret = phy_read(phydev, MII_BMCR);
		if (ret < 0)
			return ret;
	} while (ret & BMCR_RESET && --retries);
	if (ret & BMCR_RESET)
		return -ETIMEDOUT;

S
Sergei Shtylyov 已提交
529
	/* Some chips (smsc911x) may still need up to another 1ms after the
530 531 532 533 534 535
	 * BMCR_RESET bit is cleared before they are usable.
	 */
	msleep(1);
	return 0;
}

536 537 538 539 540 541 542
int phy_init_hw(struct phy_device *phydev)
{
	int ret;

	if (!phydev->drv || !phydev->drv->config_init)
		return 0;

543 544 545 546 547 548 549 550
	ret = phy_write(phydev, MII_BMCR, BMCR_RESET);
	if (ret < 0)
		return ret;

	ret = phy_poll_reset(phydev);
	if (ret < 0)
		return ret;

551 552 553 554 555 556
	ret = phy_scan_fixups(phydev);
	if (ret < 0)
		return ret;

	return phydev->drv->config_init(phydev);
}
557
EXPORT_SYMBOL(phy_init_hw);
558

559
/**
560
 * phy_attach_direct - attach a network device to a given PHY device pointer
561
 * @dev: network device to attach
562
 * @phydev: Pointer to phy_device to attach
563 564
 * @flags: PHY device's dev_flags
 * @interface: PHY device's interface
A
Andy Fleming 已提交
565
 *
566
 * Description: Called by drivers to attach to a particular PHY
A
Andy Fleming 已提交
567 568 569 570
 *     device. The phy_device is found, and properly hooked up
 *     to the phy_driver.  If no driver is attached, then the
 *     genphy_driver is used.  The phy_device is given a ptr to
 *     the attaching device, and given a callback for link status
571
 *     change.  The phy_device is returned to the attaching driver.
A
Andy Fleming 已提交
572
 */
573 574
static int phy_attach_direct(struct net_device *dev, struct phy_device *phydev,
			     u32 flags, phy_interface_t interface)
A
Andy Fleming 已提交
575
{
576
	struct device *d = &phydev->dev;
577
	int err;
A
Andy Fleming 已提交
578 579

	/* Assume that if there is no driver, that it doesn't
S
Sergei Shtylyov 已提交
580 581
	 * exist, and we should use the genphy driver.
	 */
A
Andy Fleming 已提交
582
	if (NULL == d->driver) {
583 584 585 586 587
		if (phydev->is_c45) {
			pr_err("No driver for phy %x\n", phydev->phy_id);
			return -ENODEV;
		}

588
		d->driver = &genphy_driver[GENPHY_DRV_1G].driver;
A
Andy Fleming 已提交
589 590

		err = d->driver->probe(d);
591 592
		if (err >= 0)
			err = device_bind_driver(d);
A
Andy Fleming 已提交
593

594
		if (err)
595
			return err;
A
Andy Fleming 已提交
596 597 598
	}

	if (phydev->attached_dev) {
599 600
		dev_err(&dev->dev, "PHY already attached\n");
		return -EBUSY;
A
Andy Fleming 已提交
601 602 603
	}

	phydev->attached_dev = dev;
604
	dev->phydev = phydev;
A
Andy Fleming 已提交
605 606 607

	phydev->dev_flags = flags;

608 609
	phydev->interface = interface;

610 611
	phydev->state = PHY_READY;

612 613
	/* Do initial configuration here, now that
	 * we have certain key parameters
S
Sergei Shtylyov 已提交
614 615
	 * (dev_flags and interface)
	 */
616 617 618 619
	err = phy_init_hw(phydev);
	if (err)
		phy_detach(phydev);

620 621
	phy_resume(phydev);

622
	return err;
623 624 625 626 627 628 629 630 631 632 633
}

/**
 * phy_attach - attach a network device to a particular PHY device
 * @dev: network device to attach
 * @bus_id: Bus ID of PHY device to attach
 * @interface: PHY device's interface
 *
 * Description: Same as phy_attach_direct() except that a PHY bus_id
 *     string is passed instead of a pointer to a struct phy_device.
 */
S
Sergei Shtylyov 已提交
634 635
struct phy_device *phy_attach(struct net_device *dev, const char *bus_id,
			      phy_interface_t interface)
636 637 638 639 640 641 642
{
	struct bus_type *bus = &mdio_bus_type;
	struct phy_device *phydev;
	struct device *d;
	int rc;

	/* Search the list of PHY devices on the mdio bus for the
S
Sergei Shtylyov 已提交
643 644
	 * PHY with the requested name
	 */
645 646 647 648
	d = bus_find_device_by_name(bus, NULL, bus_id);
	if (!d) {
		pr_err("PHY %s not found\n", bus_id);
		return ERR_PTR(-ENODEV);
649
	}
650 651
	phydev = to_phy_device(d);

652
	rc = phy_attach_direct(dev, phydev, phydev->dev_flags, interface);
653 654
	if (rc)
		return ERR_PTR(rc);
655

A
Andy Fleming 已提交
656 657 658 659
	return phydev;
}
EXPORT_SYMBOL(phy_attach);

660 661 662 663
/**
 * phy_detach - detach a PHY device from its network device
 * @phydev: target phy_device struct
 */
A
Andy Fleming 已提交
664 665
void phy_detach(struct phy_device *phydev)
{
666
	int i;
667
	phydev->attached_dev->phydev = NULL;
A
Andy Fleming 已提交
668
	phydev->attached_dev = NULL;
669
	phy_suspend(phydev);
A
Andy Fleming 已提交
670 671 672 673

	/* If the device had no specific driver before (i.e. - it
	 * was using the generic driver), we unbind the device
	 * from the generic driver so that there's a chance a
S
Sergei Shtylyov 已提交
674 675
	 * real driver could be loaded
	 */
676 677 678 679 680 681
	for (i = 0; i < ARRAY_SIZE(genphy_driver); i++) {
		if (phydev->dev.driver == &genphy_driver[i].driver) {
			device_release_driver(&phydev->dev);
			break;
		}
	}
A
Andy Fleming 已提交
682 683 684
}
EXPORT_SYMBOL(phy_detach);

685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708
int phy_suspend(struct phy_device *phydev)
{
	struct phy_driver *phydrv = to_phy_driver(phydev->dev.driver);
	struct ethtool_wolinfo wol;

	/* If the device has WOL enabled, we cannot suspend the PHY */
	wol.cmd = ETHTOOL_GWOL;
	phy_ethtool_get_wol(phydev, &wol);
	if (wol.wolopts)
		return -EBUSY;

	if (phydrv->suspend)
		return phydrv->suspend(phydev);
	return 0;
}

int phy_resume(struct phy_device *phydev)
{
	struct phy_driver *phydrv = to_phy_driver(phydev->dev.driver);

	if (phydrv->resume)
		return phydrv->resume(phydev);
	return 0;
}
A
Andy Fleming 已提交
709

710 711
/* Generic PHY support and helper functions */

712
/**
L
Lucas De Marchi 已提交
713
 * genphy_config_advert - sanitize and advertise auto-negotiation parameters
714
 * @phydev: target phy_device struct
715
 *
716
 * Description: Writes MII_ADVERTISE with the appropriate values,
717
 *   after sanitizing the values to make sure we only advertise
718 719
 *   what is supported.  Returns < 0 on error, 0 if the PHY's advertisement
 *   hasn't changed, and > 0 if it has changed.
720
 */
721
static int genphy_config_advert(struct phy_device *phydev)
722 723
{
	u32 advertise;
724 725
	int oldadv, adv;
	int err, changed = 0;
726

S
Sergei Shtylyov 已提交
727
	/* Only allow advertising what this PHY supports */
728 729 730 731
	phydev->advertising &= phydev->supported;
	advertise = phydev->advertising;

	/* Setup standard advertisement */
S
Sergei Shtylyov 已提交
732
	adv = phy_read(phydev, MII_ADVERTISE);
733 734 735
	if (adv < 0)
		return adv;

S
Sergei Shtylyov 已提交
736
	oldadv = adv;
737
	adv &= ~(ADVERTISE_ALL | ADVERTISE_100BASE4 | ADVERTISE_PAUSE_CAP |
738
		 ADVERTISE_PAUSE_ASYM);
739
	adv |= ethtool_adv_to_mii_adv_t(advertise);
740

741 742
	if (adv != oldadv) {
		err = phy_write(phydev, MII_ADVERTISE, adv);
743

744 745 746 747
		if (err < 0)
			return err;
		changed = 1;
	}
748 749 750

	/* Configure gigabit if it's supported */
	if (phydev->supported & (SUPPORTED_1000baseT_Half |
S
Sergei Shtylyov 已提交
751 752
				 SUPPORTED_1000baseT_Full)) {
		adv = phy_read(phydev, MII_CTRL1000);
753 754 755
		if (adv < 0)
			return adv;

S
Sergei Shtylyov 已提交
756
		oldadv = adv;
757
		adv &= ~(ADVERTISE_1000FULL | ADVERTISE_1000HALF);
758
		adv |= ethtool_adv_to_mii_ctrl1000_t(advertise);
759

760 761 762 763 764 765 766
		if (adv != oldadv) {
			err = phy_write(phydev, MII_CTRL1000, adv);

			if (err < 0)
				return err;
			changed = 1;
		}
767 768
	}

769
	return changed;
770 771
}

772 773 774
/**
 * genphy_setup_forced - configures/forces speed/duplex from @phydev
 * @phydev: target phy_device struct
775
 *
776
 * Description: Configures MII_BMCR to force speed/duplex
777
 *   to the values in phydev. Assumes that the values are valid.
778 779
 *   Please see phy_sanitize_settings().
 */
780
int genphy_setup_forced(struct phy_device *phydev)
781
{
782
	int ctl = 0;
783

S
Sergei Shtylyov 已提交
784 785
	phydev->pause = 0;
	phydev->asym_pause = 0;
786 787 788 789 790 791 792 793

	if (SPEED_1000 == phydev->speed)
		ctl |= BMCR_SPEED1000;
	else if (SPEED_100 == phydev->speed)
		ctl |= BMCR_SPEED100;

	if (DUPLEX_FULL == phydev->duplex)
		ctl |= BMCR_FULLDPLX;
F
Florian Fainelli 已提交
794

795
	return phy_write(phydev, MII_BMCR, ctl);
796
}
797
EXPORT_SYMBOL(genphy_setup_forced);
798

799 800 801 802
/**
 * genphy_restart_aneg - Enable and Restart Autonegotiation
 * @phydev: target phy_device struct
 */
803 804
int genphy_restart_aneg(struct phy_device *phydev)
{
S
Sergei Shtylyov 已提交
805
	int ctl = phy_read(phydev, MII_BMCR);
806 807 808 809

	if (ctl < 0)
		return ctl;

S
Sergei Shtylyov 已提交
810
	ctl |= BMCR_ANENABLE | BMCR_ANRESTART;
811 812

	/* Don't isolate the PHY if we're negotiating */
S
Sergei Shtylyov 已提交
813
	ctl &= ~BMCR_ISOLATE;
814

S
Sergei Shtylyov 已提交
815
	return phy_write(phydev, MII_BMCR, ctl);
816
}
A
Adrian Bunk 已提交
817
EXPORT_SYMBOL(genphy_restart_aneg);
818

819 820 821
/**
 * genphy_config_aneg - restart auto-negotiation or write BMCR
 * @phydev: target phy_device struct
822
 *
823
 * Description: If auto-negotiation is enabled, we configure the
824
 *   advertising, and then restart auto-negotiation.  If it is not
825
 *   enabled, then we write the BMCR.
826 827 828
 */
int genphy_config_aneg(struct phy_device *phydev)
{
829
	int result;
830

831 832
	if (AUTONEG_ENABLE != phydev->autoneg)
		return genphy_setup_forced(phydev);
833

834 835 836 837
	result = genphy_config_advert(phydev);
	if (result < 0) /* error */
		return result;
	if (result == 0) {
L
Lucas De Marchi 已提交
838
		/* Advertisement hasn't changed, but maybe aneg was never on to
S
Sergei Shtylyov 已提交
839 840
		 * begin with?  Or maybe phy was isolated?
		 */
841 842 843 844 845 846 847 848 849 850
		int ctl = phy_read(phydev, MII_BMCR);

		if (ctl < 0)
			return ctl;

		if (!(ctl & BMCR_ANENABLE) || (ctl & BMCR_ISOLATE))
			result = 1; /* do restart aneg */
	}

	/* Only restart aneg if we are advertising something different
S
Sergei Shtylyov 已提交
851 852
	 * than we were before.
	 */
853 854
	if (result > 0)
		result = genphy_restart_aneg(phydev);
855

856
	return result;
857 858 859
}
EXPORT_SYMBOL(genphy_config_aneg);

860 861 862
/**
 * genphy_update_link - update link status in @phydev
 * @phydev: target phy_device struct
863
 *
864
 * Description: Update the value in phydev->link to reflect the
865
 *   current link value.  In order to do this, we need to read
866
 *   the status register twice, keeping the second value.
867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888
 */
int genphy_update_link(struct phy_device *phydev)
{
	int status;

	/* Do a fake read */
	status = phy_read(phydev, MII_BMSR);
	if (status < 0)
		return status;

	/* Read link and autonegotiation status */
	status = phy_read(phydev, MII_BMSR);
	if (status < 0)
		return status;

	if ((status & BMSR_LSTATUS) == 0)
		phydev->link = 0;
	else
		phydev->link = 1;

	return 0;
}
889
EXPORT_SYMBOL(genphy_update_link);
890

891 892 893
/**
 * genphy_read_status - check the link status and update current link state
 * @phydev: target phy_device struct
894
 *
895
 * Description: Check the link, then figure out the current state
896 897 898 899 900 901 902 903 904 905 906
 *   by comparing what we advertise with what the link partner
 *   advertises.  Start by checking the gigabit possibilities,
 *   then move on to 10/100.
 */
int genphy_read_status(struct phy_device *phydev)
{
	int adv;
	int err;
	int lpa;
	int lpagb = 0;

S
Sergei Shtylyov 已提交
907
	/* Update the link, but return if there was an error */
908 909 910 911
	err = genphy_update_link(phydev);
	if (err)
		return err;

912 913
	phydev->lp_advertising = 0;

914 915 916 917 918 919 920 921 922 923 924
	if (AUTONEG_ENABLE == phydev->autoneg) {
		if (phydev->supported & (SUPPORTED_1000baseT_Half
					| SUPPORTED_1000baseT_Full)) {
			lpagb = phy_read(phydev, MII_STAT1000);
			if (lpagb < 0)
				return lpagb;

			adv = phy_read(phydev, MII_CTRL1000);
			if (adv < 0)
				return adv;

925 926
			phydev->lp_advertising =
				mii_stat1000_to_ethtool_lpa_t(lpagb);
927 928 929 930 931 932 933
			lpagb &= adv << 2;
		}

		lpa = phy_read(phydev, MII_LPA);
		if (lpa < 0)
			return lpa;

934 935
		phydev->lp_advertising |= mii_lpa_to_ethtool_lpa_t(lpa);

936 937 938 939 940 941 942 943
		adv = phy_read(phydev, MII_ADVERTISE);
		if (adv < 0)
			return adv;

		lpa &= adv;

		phydev->speed = SPEED_10;
		phydev->duplex = DUPLEX_HALF;
S
Sergei Shtylyov 已提交
944 945
		phydev->pause = 0;
		phydev->asym_pause = 0;
946 947 948 949 950 951 952 953

		if (lpagb & (LPA_1000FULL | LPA_1000HALF)) {
			phydev->speed = SPEED_1000;

			if (lpagb & LPA_1000FULL)
				phydev->duplex = DUPLEX_FULL;
		} else if (lpa & (LPA_100FULL | LPA_100HALF)) {
			phydev->speed = SPEED_100;
F
Florian Fainelli 已提交
954

955 956 957 958 959 960
			if (lpa & LPA_100FULL)
				phydev->duplex = DUPLEX_FULL;
		} else
			if (lpa & LPA_10FULL)
				phydev->duplex = DUPLEX_FULL;

F
Florian Fainelli 已提交
961
		if (phydev->duplex == DUPLEX_FULL) {
962 963 964 965 966
			phydev->pause = lpa & LPA_PAUSE_CAP ? 1 : 0;
			phydev->asym_pause = lpa & LPA_PAUSE_ASYM ? 1 : 0;
		}
	} else {
		int bmcr = phy_read(phydev, MII_BMCR);
S
Sergei Shtylyov 已提交
967

968 969 970 971 972 973 974 975 976 977 978 979 980 981 982
		if (bmcr < 0)
			return bmcr;

		if (bmcr & BMCR_FULLDPLX)
			phydev->duplex = DUPLEX_FULL;
		else
			phydev->duplex = DUPLEX_HALF;

		if (bmcr & BMCR_SPEED1000)
			phydev->speed = SPEED_1000;
		else if (bmcr & BMCR_SPEED100)
			phydev->speed = SPEED_100;
		else
			phydev->speed = SPEED_10;

S
Sergei Shtylyov 已提交
983 984
		phydev->pause = 0;
		phydev->asym_pause = 0;
985 986 987 988 989 990 991 992
	}

	return 0;
}
EXPORT_SYMBOL(genphy_read_status);

static int genphy_config_init(struct phy_device *phydev)
{
993
	int val;
994 995 996
	u32 features;

	/* For now, I'll claim that the generic driver supports
S
Sergei Shtylyov 已提交
997 998
	 * all possible port types
	 */
999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035
	features = (SUPPORTED_TP | SUPPORTED_MII
			| SUPPORTED_AUI | SUPPORTED_FIBRE |
			SUPPORTED_BNC);

	/* Do we support autonegotiation? */
	val = phy_read(phydev, MII_BMSR);
	if (val < 0)
		return val;

	if (val & BMSR_ANEGCAPABLE)
		features |= SUPPORTED_Autoneg;

	if (val & BMSR_100FULL)
		features |= SUPPORTED_100baseT_Full;
	if (val & BMSR_100HALF)
		features |= SUPPORTED_100baseT_Half;
	if (val & BMSR_10FULL)
		features |= SUPPORTED_10baseT_Full;
	if (val & BMSR_10HALF)
		features |= SUPPORTED_10baseT_Half;

	if (val & BMSR_ESTATEN) {
		val = phy_read(phydev, MII_ESTATUS);
		if (val < 0)
			return val;

		if (val & ESTATUS_1000_TFULL)
			features |= SUPPORTED_1000baseT_Full;
		if (val & ESTATUS_1000_THALF)
			features |= SUPPORTED_1000baseT_Half;
	}

	phydev->supported = features;
	phydev->advertising = features;

	return 0;
}
G
Giuseppe Cavallaro 已提交
1036 1037 1038 1039 1040 1041 1042
int genphy_suspend(struct phy_device *phydev)
{
	int value;

	mutex_lock(&phydev->lock);

	value = phy_read(phydev, MII_BMCR);
S
Sergei Shtylyov 已提交
1043
	phy_write(phydev, MII_BMCR, value | BMCR_PDOWN);
G
Giuseppe Cavallaro 已提交
1044 1045 1046 1047 1048 1049

	mutex_unlock(&phydev->lock);

	return 0;
}
EXPORT_SYMBOL(genphy_suspend);
1050

G
Giuseppe Cavallaro 已提交
1051 1052 1053 1054 1055 1056 1057
int genphy_resume(struct phy_device *phydev)
{
	int value;

	mutex_lock(&phydev->lock);

	value = phy_read(phydev, MII_BMCR);
S
Sergei Shtylyov 已提交
1058
	phy_write(phydev, MII_BMCR, value & ~BMCR_PDOWN);
G
Giuseppe Cavallaro 已提交
1059 1060 1061 1062 1063 1064

	mutex_unlock(&phydev->lock);

	return 0;
}
EXPORT_SYMBOL(genphy_resume);
1065

1066 1067 1068
/**
 * phy_probe - probe and init a PHY device
 * @dev: device to probe and init
1069
 *
1070
 * Description: Take care of setting up the phy_device structure,
1071 1072 1073 1074 1075
 *   set the state to READY (the driver's init function should
 *   set it to STARTING if needed).
 */
static int phy_probe(struct device *dev)
{
S
Sergei Shtylyov 已提交
1076 1077 1078
	struct phy_device *phydev = to_phy_device(dev);
	struct device_driver *drv = phydev->dev.driver;
	struct phy_driver *phydrv = to_phy_driver(drv);
1079 1080 1081 1082
	int err = 0;

	phydev->drv = phydrv;

1083 1084 1085 1086
	/* Disable the interrupt if the PHY doesn't support it
	 * but the interrupt is still a valid one
	 */
	if (!(phydrv->flags & PHY_HAS_INTERRUPT) &&
S
Sergei Shtylyov 已提交
1087
	    phy_interrupt_is_valid(phydev))
1088 1089
		phydev->irq = PHY_POLL;

1090 1091 1092
	if (phydrv->flags & PHY_IS_INTERNAL)
		phydev->is_internal = true;

1093
	mutex_lock(&phydev->lock);
1094 1095 1096

	/* Start out supporting everything. Eventually,
	 * a controller will attach, and may modify one
S
Sergei Shtylyov 已提交
1097 1098
	 * or both of these values
	 */
1099 1100 1101 1102 1103 1104 1105 1106 1107
	phydev->supported = phydrv->features;
	phydev->advertising = phydrv->features;

	/* Set the state to READY by default */
	phydev->state = PHY_READY;

	if (phydev->drv->probe)
		err = phydev->drv->probe(phydev);

1108
	mutex_unlock(&phydev->lock);
1109 1110 1111 1112 1113 1114

	return err;
}

static int phy_remove(struct device *dev)
{
S
Sergei Shtylyov 已提交
1115
	struct phy_device *phydev = to_phy_device(dev);
1116

1117
	mutex_lock(&phydev->lock);
1118
	phydev->state = PHY_DOWN;
1119
	mutex_unlock(&phydev->lock);
1120 1121 1122 1123 1124 1125 1126 1127

	if (phydev->drv->remove)
		phydev->drv->remove(phydev);
	phydev->drv = NULL;

	return 0;
}

1128 1129 1130 1131
/**
 * phy_driver_register - register a phy_driver with the PHY layer
 * @new_driver: new phy_driver to register
 */
1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142
int phy_driver_register(struct phy_driver *new_driver)
{
	int retval;

	new_driver->driver.name = new_driver->name;
	new_driver->driver.bus = &mdio_bus_type;
	new_driver->driver.probe = phy_probe;
	new_driver->driver.remove = phy_remove;

	retval = driver_register(&new_driver->driver);
	if (retval) {
J
Joe Perches 已提交
1143 1144
		pr_err("%s: Error %d in registering driver\n",
		       new_driver->name, retval);
1145 1146 1147 1148

		return retval;
	}

1149
	pr_debug("%s: Registered new driver\n", new_driver->name);
1150 1151 1152 1153 1154

	return 0;
}
EXPORT_SYMBOL(phy_driver_register);

1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170
int phy_drivers_register(struct phy_driver *new_driver, int n)
{
	int i, ret = 0;

	for (i = 0; i < n; i++) {
		ret = phy_driver_register(new_driver + i);
		if (ret) {
			while (i-- > 0)
				phy_driver_unregister(new_driver + i);
			break;
		}
	}
	return ret;
}
EXPORT_SYMBOL(phy_drivers_register);

1171 1172 1173 1174 1175 1176
void phy_driver_unregister(struct phy_driver *drv)
{
	driver_unregister(&drv->driver);
}
EXPORT_SYMBOL(phy_driver_unregister);

1177 1178 1179
void phy_drivers_unregister(struct phy_driver *drv, int n)
{
	int i;
S
Sergei Shtylyov 已提交
1180 1181

	for (i = 0; i < n; i++)
1182 1183 1184 1185
		phy_driver_unregister(drv + i);
}
EXPORT_SYMBOL(phy_drivers_unregister);

1186 1187
static struct phy_driver genphy_driver[] = {
{
A
Andy Fleming 已提交
1188 1189 1190 1191 1192 1193 1194
	.phy_id		= 0xffffffff,
	.phy_id_mask	= 0xffffffff,
	.name		= "Generic PHY",
	.config_init	= genphy_config_init,
	.features	= 0,
	.config_aneg	= genphy_config_aneg,
	.read_status	= genphy_read_status,
G
Giuseppe Cavallaro 已提交
1195 1196
	.suspend	= genphy_suspend,
	.resume		= genphy_resume,
F
Florian Fainelli 已提交
1197
	.driver		= { .owner = THIS_MODULE, },
1198
} };
1199

1200
static int __init phy_init(void)
1201
{
1202 1203 1204 1205
	int rc;

	rc = mdio_bus_init();
	if (rc)
A
Andy Fleming 已提交
1206
		return rc;
1207

1208 1209
	rc = phy_drivers_register(genphy_driver,
				  ARRAY_SIZE(genphy_driver));
A
Andy Fleming 已提交
1210 1211
	if (rc)
		mdio_bus_exit();
1212 1213

	return rc;
1214 1215
}

1216
static void __exit phy_exit(void)
1217
{
1218 1219
	phy_drivers_unregister(genphy_driver,
			       ARRAY_SIZE(genphy_driver));
A
Andy Fleming 已提交
1220
	mdio_bus_exit();
1221 1222
}

A
Andy Fleming 已提交
1223
subsys_initcall(phy_init);
1224
module_exit(phy_exit);