xref: /openbmc/u-boot/common/miiphyutil.c (revision cd8c8775)
1 /*
2  * (C) Copyright 2001
3  * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com.
4  *
5  * See file CREDITS for list of people who contributed to this
6  * project.
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License as
10  * published by the Free Software Foundation; either version 2 of
11  * the License, or (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
21  * MA 02111-1307 USA
22  */
23 
24 /*
25  * This provides a bit-banged interface to the ethernet MII management
26  * channel.
27  */
28 
29 #include <common.h>
30 #include <miiphy.h>
31 #include <phy.h>
32 
33 #include <asm/types.h>
34 #include <linux/list.h>
35 #include <malloc.h>
36 #include <net.h>
37 
38 /* local debug macro */
39 #undef MII_DEBUG
40 
41 #undef debug
42 #ifdef MII_DEBUG
43 #define debug(fmt, args...)	printf(fmt, ##args)
44 #else
45 #define debug(fmt, args...)
46 #endif /* MII_DEBUG */
47 
48 static struct list_head mii_devs;
49 static struct mii_dev *current_mii;
50 
51 /*
52  * Lookup the mii_dev struct by the registered device name.
53  */
54 struct mii_dev *miiphy_get_dev_by_name(const char *devname)
55 {
56 	struct list_head *entry;
57 	struct mii_dev *dev;
58 
59 	if (!devname) {
60 		printf("NULL device name!\n");
61 		return NULL;
62 	}
63 
64 	list_for_each(entry, &mii_devs) {
65 		dev = list_entry(entry, struct mii_dev, link);
66 		if (strcmp(dev->name, devname) == 0)
67 			return dev;
68 	}
69 
70 	return NULL;
71 }
72 
73 /*****************************************************************************
74  *
75  * Initialize global data. Need to be called before any other miiphy routine.
76  */
77 void miiphy_init(void)
78 {
79 	INIT_LIST_HEAD(&mii_devs);
80 	current_mii = NULL;
81 }
82 
83 static int legacy_miiphy_read(struct mii_dev *bus, int addr, int devad, int reg)
84 {
85 	unsigned short val;
86 	int ret;
87 	struct legacy_mii_dev *ldev = bus->priv;
88 
89 	ret = ldev->read(bus->name, addr, reg, &val);
90 
91 	return ret ? -1 : (int)val;
92 }
93 
94 static int legacy_miiphy_write(struct mii_dev *bus, int addr, int devad,
95 				int reg, u16 val)
96 {
97 	struct legacy_mii_dev *ldev = bus->priv;
98 
99 	return ldev->write(bus->name, addr, reg, val);
100 }
101 
102 /*****************************************************************************
103  *
104  * Register read and write MII access routines for the device <name>.
105  */
106 void miiphy_register(const char *name,
107 		      int (*read)(const char *devname, unsigned char addr,
108 				   unsigned char reg, unsigned short *value),
109 		      int (*write)(const char *devname, unsigned char addr,
110 				    unsigned char reg, unsigned short value))
111 {
112 	struct mii_dev *new_dev;
113 	struct legacy_mii_dev *ldev;
114 	unsigned int name_len;
115 
116 	/* check if we have unique name */
117 	new_dev = miiphy_get_dev_by_name(name);
118 	if (new_dev) {
119 		printf("miiphy_register: non unique device name '%s'\n", name);
120 		return;
121 	}
122 
123 	/* allocate memory */
124 	name_len = strlen(name);
125 	if (name_len > MDIO_NAME_LEN - 1) {
126 		/* Hopefully this won't happen, but if it does, we'll know */
127 		printf("miiphy_register: MDIO name was longer than %d\n",
128 			MDIO_NAME_LEN);
129 		return;
130 	}
131 
132 	new_dev = mdio_alloc();
133 	ldev = malloc(sizeof(*ldev));
134 
135 	if (new_dev == NULL || ldev == NULL) {
136 		printf("miiphy_register: cannot allocate memory for '%s'\n",
137 			name);
138 		return;
139 	}
140 
141 	/* initalize mii_dev struct fields */
142 	new_dev->read = legacy_miiphy_read;
143 	new_dev->write = legacy_miiphy_write;
144 	sprintf(new_dev->name, name);
145 	ldev->read = read;
146 	ldev->write = write;
147 	new_dev->priv = ldev;
148 
149 	debug("miiphy_register: added '%s', read=0x%08lx, write=0x%08lx\n",
150 	       new_dev->name, ldev->read, ldev->write);
151 
152 	/* add it to the list */
153 	list_add_tail(&new_dev->link, &mii_devs);
154 
155 	if (!current_mii)
156 		current_mii = new_dev;
157 }
158 
159 struct mii_dev *mdio_alloc(void)
160 {
161 	struct mii_dev *bus;
162 
163 	bus = malloc(sizeof(*bus));
164 	if (!bus)
165 		return bus;
166 
167 	memset(bus, 0, sizeof(*bus));
168 
169 	/* initalize mii_dev struct fields */
170 	INIT_LIST_HEAD(&bus->link);
171 
172 	return bus;
173 }
174 
175 int mdio_register(struct mii_dev *bus)
176 {
177 	if (!bus || !bus->name || !bus->read || !bus->write)
178 		return -1;
179 
180 	/* check if we have unique name */
181 	if (miiphy_get_dev_by_name(bus->name)) {
182 		printf("mdio_register: non unique device name '%s'\n",
183 			bus->name);
184 		return -1;
185 	}
186 
187 	/* add it to the list */
188 	list_add_tail(&bus->link, &mii_devs);
189 
190 	if (!current_mii)
191 		current_mii = bus;
192 
193 	return 0;
194 }
195 
196 void mdio_list_devices(void)
197 {
198 	struct list_head *entry;
199 
200 	list_for_each(entry, &mii_devs) {
201 		int i;
202 		struct mii_dev *bus = list_entry(entry, struct mii_dev, link);
203 
204 		printf("%s:\n", bus->name);
205 
206 		for (i = 0; i < PHY_MAX_ADDR; i++) {
207 			struct phy_device *phydev = bus->phymap[i];
208 
209 			if (phydev) {
210 				printf("%d - %s", i, phydev->drv->name);
211 
212 				if (phydev->dev)
213 					printf(" <--> %s\n", phydev->dev->name);
214 				else
215 					printf("\n");
216 			}
217 		}
218 	}
219 }
220 
221 int miiphy_set_current_dev(const char *devname)
222 {
223 	struct mii_dev *dev;
224 
225 	dev = miiphy_get_dev_by_name(devname);
226 	if (dev) {
227 		current_mii = dev;
228 		return 0;
229 	}
230 
231 	printf("No such device: %s\n", devname);
232 
233 	return 1;
234 }
235 
236 struct mii_dev *mdio_get_current_dev(void)
237 {
238 	return current_mii;
239 }
240 
241 struct phy_device *mdio_phydev_for_ethname(const char *ethname)
242 {
243 	struct list_head *entry;
244 	struct mii_dev *bus;
245 
246 	list_for_each(entry, &mii_devs) {
247 		int i;
248 		bus = list_entry(entry, struct mii_dev, link);
249 
250 		for (i = 0; i < PHY_MAX_ADDR; i++) {
251 			if (!bus->phymap[i] || !bus->phymap[i]->dev)
252 				continue;
253 
254 			if (strcmp(bus->phymap[i]->dev->name, ethname) == 0)
255 				return bus->phymap[i];
256 		}
257 	}
258 
259 	printf("%s is not a known ethernet\n", ethname);
260 	return NULL;
261 }
262 
263 const char *miiphy_get_current_dev(void)
264 {
265 	if (current_mii)
266 		return current_mii->name;
267 
268 	return NULL;
269 }
270 
271 static struct mii_dev *miiphy_get_active_dev(const char *devname)
272 {
273 	/* If the current mii is the one we want, return it */
274 	if (current_mii)
275 		if (strcmp(current_mii->name, devname) == 0)
276 			return current_mii;
277 
278 	/* Otherwise, set the active one to the one we want */
279 	if (miiphy_set_current_dev(devname))
280 		return NULL;
281 	else
282 		return current_mii;
283 }
284 
285 /*****************************************************************************
286  *
287  * Read to variable <value> from the PHY attached to device <devname>,
288  * use PHY address <addr> and register <reg>.
289  *
290  * Returns:
291  *   0 on success
292  */
293 int miiphy_read(const char *devname, unsigned char addr, unsigned char reg,
294 		 unsigned short *value)
295 {
296 	struct mii_dev *bus;
297 	int ret;
298 
299 	bus = miiphy_get_active_dev(devname);
300 	if (!bus)
301 		return 1;
302 
303 	ret = bus->read(bus, addr, MDIO_DEVAD_NONE, reg);
304 	if (ret < 0)
305 		return 1;
306 
307 	*value = (unsigned short)ret;
308 	return 0;
309 }
310 
311 /*****************************************************************************
312  *
313  * Write <value> to the PHY attached to device <devname>,
314  * use PHY address <addr> and register <reg>.
315  *
316  * Returns:
317  *   0 on success
318  */
319 int miiphy_write(const char *devname, unsigned char addr, unsigned char reg,
320 		  unsigned short value)
321 {
322 	struct mii_dev *bus;
323 
324 	bus = miiphy_get_active_dev(devname);
325 	if (bus)
326 		return bus->write(bus, addr, MDIO_DEVAD_NONE, reg, value);
327 
328 	return 1;
329 }
330 
331 /*****************************************************************************
332  *
333  * Print out list of registered MII capable devices.
334  */
335 void miiphy_listdev(void)
336 {
337 	struct list_head *entry;
338 	struct mii_dev *dev;
339 
340 	puts("MII devices: ");
341 	list_for_each(entry, &mii_devs) {
342 		dev = list_entry(entry, struct mii_dev, link);
343 		printf("'%s' ", dev->name);
344 	}
345 	puts("\n");
346 
347 	if (current_mii)
348 		printf("Current device: '%s'\n", current_mii->name);
349 }
350 
351 /*****************************************************************************
352  *
353  * Read the OUI, manufacture's model number, and revision number.
354  *
355  * OUI:     22 bits (unsigned int)
356  * Model:    6 bits (unsigned char)
357  * Revision: 4 bits (unsigned char)
358  *
359  * Returns:
360  *   0 on success
361  */
362 int miiphy_info(const char *devname, unsigned char addr, unsigned int *oui,
363 		 unsigned char *model, unsigned char *rev)
364 {
365 	unsigned int reg = 0;
366 	unsigned short tmp;
367 
368 	if (miiphy_read(devname, addr, MII_PHYSID2, &tmp) != 0) {
369 		debug("PHY ID register 2 read failed\n");
370 		return -1;
371 	}
372 	reg = tmp;
373 
374 	debug("MII_PHYSID2 @ 0x%x = 0x%04x\n", addr, reg);
375 
376 	if (reg == 0xFFFF) {
377 		/* No physical device present at this address */
378 		return -1;
379 	}
380 
381 	if (miiphy_read(devname, addr, MII_PHYSID1, &tmp) != 0) {
382 		debug("PHY ID register 1 read failed\n");
383 		return -1;
384 	}
385 	reg |= tmp << 16;
386 	debug("PHY_PHYIDR[1,2] @ 0x%x = 0x%08x\n", addr, reg);
387 
388 	*oui = (reg >> 10);
389 	*model = (unsigned char)((reg >> 4) & 0x0000003F);
390 	*rev = (unsigned char)(reg & 0x0000000F);
391 	return 0;
392 }
393 
394 #ifndef CONFIG_PHYLIB
395 /*****************************************************************************
396  *
397  * Reset the PHY.
398  * Returns:
399  *   0 on success
400  */
401 int miiphy_reset(const char *devname, unsigned char addr)
402 {
403 	unsigned short reg;
404 	int timeout = 500;
405 
406 	if (miiphy_read(devname, addr, MII_BMCR, &reg) != 0) {
407 		debug("PHY status read failed\n");
408 		return -1;
409 	}
410 	if (miiphy_write(devname, addr, MII_BMCR, reg | BMCR_RESET) != 0) {
411 		debug("PHY reset failed\n");
412 		return -1;
413 	}
414 #ifdef CONFIG_PHY_RESET_DELAY
415 	udelay(CONFIG_PHY_RESET_DELAY);	/* Intel LXT971A needs this */
416 #endif
417 	/*
418 	 * Poll the control register for the reset bit to go to 0 (it is
419 	 * auto-clearing).  This should happen within 0.5 seconds per the
420 	 * IEEE spec.
421 	 */
422 	reg = 0x8000;
423 	while (((reg & 0x8000) != 0) && timeout--) {
424 		if (miiphy_read(devname, addr, MII_BMCR, &reg) != 0) {
425 			debug("PHY status read failed\n");
426 			return -1;
427 		}
428 		udelay(1000);
429 	}
430 	if ((reg & 0x8000) == 0) {
431 		return 0;
432 	} else {
433 		puts("PHY reset timed out\n");
434 		return -1;
435 	}
436 	return 0;
437 }
438 #endif /* !PHYLIB */
439 
440 /*****************************************************************************
441  *
442  * Determine the ethernet speed (10/100/1000).  Return 10 on error.
443  */
444 int miiphy_speed(const char *devname, unsigned char addr)
445 {
446 	u16 bmcr, anlpar;
447 
448 #if defined(CONFIG_PHY_GIGE)
449 	u16 btsr;
450 
451 	/*
452 	 * Check for 1000BASE-X.  If it is supported, then assume that the speed
453 	 * is 1000.
454 	 */
455 	if (miiphy_is_1000base_x(devname, addr))
456 		return _1000BASET;
457 
458 	/*
459 	 * No 1000BASE-X, so assume 1000BASE-T/100BASE-TX/10BASE-T register set.
460 	 */
461 	/* Check for 1000BASE-T. */
462 	if (miiphy_read(devname, addr, MII_STAT1000, &btsr)) {
463 		printf("PHY 1000BT status");
464 		goto miiphy_read_failed;
465 	}
466 	if (btsr != 0xFFFF &&
467 			(btsr & (PHY_1000BTSR_1000FD | PHY_1000BTSR_1000HD)))
468 		return _1000BASET;
469 #endif /* CONFIG_PHY_GIGE */
470 
471 	/* Check Basic Management Control Register first. */
472 	if (miiphy_read(devname, addr, MII_BMCR, &bmcr)) {
473 		printf("PHY speed");
474 		goto miiphy_read_failed;
475 	}
476 	/* Check if auto-negotiation is on. */
477 	if (bmcr & BMCR_ANENABLE) {
478 		/* Get auto-negotiation results. */
479 		if (miiphy_read(devname, addr, MII_LPA, &anlpar)) {
480 			printf("PHY AN speed");
481 			goto miiphy_read_failed;
482 		}
483 		return (anlpar & LPA_100) ? _100BASET : _10BASET;
484 	}
485 	/* Get speed from basic control settings. */
486 	return (bmcr & BMCR_SPEED100) ? _100BASET : _10BASET;
487 
488 miiphy_read_failed:
489 	printf(" read failed, assuming 10BASE-T\n");
490 	return _10BASET;
491 }
492 
493 /*****************************************************************************
494  *
495  * Determine full/half duplex.  Return half on error.
496  */
497 int miiphy_duplex(const char *devname, unsigned char addr)
498 {
499 	u16 bmcr, anlpar;
500 
501 #if defined(CONFIG_PHY_GIGE)
502 	u16 btsr;
503 
504 	/* Check for 1000BASE-X. */
505 	if (miiphy_is_1000base_x(devname, addr)) {
506 		/* 1000BASE-X */
507 		if (miiphy_read(devname, addr, MII_LPA, &anlpar)) {
508 			printf("1000BASE-X PHY AN duplex");
509 			goto miiphy_read_failed;
510 		}
511 	}
512 	/*
513 	 * No 1000BASE-X, so assume 1000BASE-T/100BASE-TX/10BASE-T register set.
514 	 */
515 	/* Check for 1000BASE-T. */
516 	if (miiphy_read(devname, addr, MII_STAT1000, &btsr)) {
517 		printf("PHY 1000BT status");
518 		goto miiphy_read_failed;
519 	}
520 	if (btsr != 0xFFFF) {
521 		if (btsr & PHY_1000BTSR_1000FD) {
522 			return FULL;
523 		} else if (btsr & PHY_1000BTSR_1000HD) {
524 			return HALF;
525 		}
526 	}
527 #endif /* CONFIG_PHY_GIGE */
528 
529 	/* Check Basic Management Control Register first. */
530 	if (miiphy_read(devname, addr, MII_BMCR, &bmcr)) {
531 		puts("PHY duplex");
532 		goto miiphy_read_failed;
533 	}
534 	/* Check if auto-negotiation is on. */
535 	if (bmcr & BMCR_ANENABLE) {
536 		/* Get auto-negotiation results. */
537 		if (miiphy_read(devname, addr, MII_LPA, &anlpar)) {
538 			puts("PHY AN duplex");
539 			goto miiphy_read_failed;
540 		}
541 		return (anlpar & (LPA_10FULL | LPA_100FULL)) ?
542 		    FULL : HALF;
543 	}
544 	/* Get speed from basic control settings. */
545 	return (bmcr & BMCR_FULLDPLX) ? FULL : HALF;
546 
547 miiphy_read_failed:
548 	printf(" read failed, assuming half duplex\n");
549 	return HALF;
550 }
551 
552 /*****************************************************************************
553  *
554  * Return 1 if PHY supports 1000BASE-X, 0 if PHY supports 10BASE-T/100BASE-TX/
555  * 1000BASE-T, or on error.
556  */
557 int miiphy_is_1000base_x(const char *devname, unsigned char addr)
558 {
559 #if defined(CONFIG_PHY_GIGE)
560 	u16 exsr;
561 
562 	if (miiphy_read(devname, addr, MII_ESTATUS, &exsr)) {
563 		printf("PHY extended status read failed, assuming no "
564 			"1000BASE-X\n");
565 		return 0;
566 	}
567 	return 0 != (exsr & (ESTATUS_1000XF | ESTATUS_1000XH));
568 #else
569 	return 0;
570 #endif
571 }
572 
573 #ifdef CONFIG_SYS_FAULT_ECHO_LINK_DOWN
574 /*****************************************************************************
575  *
576  * Determine link status
577  */
578 int miiphy_link(const char *devname, unsigned char addr)
579 {
580 	unsigned short reg;
581 
582 	/* dummy read; needed to latch some phys */
583 	(void)miiphy_read(devname, addr, MII_BMSR, &reg);
584 	if (miiphy_read(devname, addr, MII_BMSR, &reg)) {
585 		puts("MII_BMSR read failed, assuming no link\n");
586 		return 0;
587 	}
588 
589 	/* Determine if a link is active */
590 	if ((reg & BMSR_LSTATUS) != 0) {
591 		return 1;
592 	} else {
593 		return 0;
594 	}
595 }
596 #endif
597