xref: /openbmc/u-boot/drivers/usb/eth/mcs7830.c (revision 193f6fb9)
1 /*
2  * Copyright (c) 2013 Gerhard Sittig <gsi@denx.de>
3  * based on the U-Boot Asix driver as well as information
4  * from the Linux Moschip driver
5  *
6  * SPDX-License-Identifier:	GPL-2.0+
7  */
8 
9 /*
10  * MOSCHIP MCS7830 based (7730/7830/7832) USB 2.0 Ethernet Devices
11  */
12 
13 #include <common.h>
14 #include <dm.h>
15 #include <errno.h>
16 #include <linux/mii.h>
17 #include <malloc.h>
18 #include <memalign.h>
19 #include <usb.h>
20 
21 #include "usb_ether.h"
22 
23 #define MCS7830_BASE_NAME	"mcs"
24 
25 #define USBCALL_TIMEOUT		1000
26 #define LINKSTATUS_TIMEOUT	5000	/* link status, connect timeout */
27 #define LINKSTATUS_TIMEOUT_RES	50	/* link status, resolution in msec */
28 
29 #define MCS7830_RX_URB_SIZE	2048
30 
31 /* command opcodes */
32 #define MCS7830_WR_BREQ		0x0d
33 #define MCS7830_RD_BREQ		0x0e
34 
35 /* register layout, numerical offset specs for USB API calls */
36 struct mcs7830_regs {
37 	uint8_t multicast_hashes[8];
38 	uint8_t packet_gap[2];
39 	uint8_t phy_data[2];
40 	uint8_t phy_command[2];
41 	uint8_t configuration;
42 	uint8_t ether_address[6];
43 	uint8_t frame_drop_count;
44 	uint8_t pause_threshold;
45 };
46 #define REG_MULTICAST_HASH	offsetof(struct mcs7830_regs, multicast_hashes)
47 #define REG_PHY_DATA		offsetof(struct mcs7830_regs, phy_data)
48 #define REG_PHY_CMD		offsetof(struct mcs7830_regs, phy_command)
49 #define REG_CONFIG		offsetof(struct mcs7830_regs, configuration)
50 #define REG_ETHER_ADDR		offsetof(struct mcs7830_regs, ether_address)
51 #define REG_FRAME_DROP_COUNTER	offsetof(struct mcs7830_regs, frame_drop_count)
52 #define REG_PAUSE_THRESHOLD	offsetof(struct mcs7830_regs, pause_threshold)
53 
54 /* bit masks and default values for the above registers */
55 #define PHY_CMD1_READ		0x40
56 #define PHY_CMD1_WRITE		0x20
57 #define PHY_CMD1_PHYADDR	0x01
58 
59 #define PHY_CMD2_PEND		0x80
60 #define PHY_CMD2_READY		0x40
61 
62 #define CONF_CFG		0x80
63 #define CONF_SPEED100		0x40
64 #define CONF_FDX_ENABLE		0x20
65 #define CONF_RXENABLE		0x10
66 #define CONF_TXENABLE		0x08
67 #define CONF_SLEEPMODE		0x04
68 #define CONF_ALLMULTICAST	0x02
69 #define CONF_PROMISCUOUS	0x01
70 
71 #define PAUSE_THRESHOLD_DEFAULT	0
72 
73 /* bit masks for the status byte which follows received ethernet frames */
74 #define STAT_RX_FRAME_CORRECT	0x20
75 #define STAT_RX_LARGE_FRAME	0x10
76 #define STAT_RX_CRC_ERROR	0x08
77 #define STAT_RX_ALIGNMENT_ERROR	0x04
78 #define STAT_RX_LENGTH_ERROR	0x02
79 #define STAT_RX_SHORT_FRAME	0x01
80 
81 /*
82  * struct mcs7830_private - private driver data for an individual adapter
83  * @config:	shadow for the network adapter's configuration register
84  * @mchash:	shadow for the network adapter's multicast hash registers
85  */
86 struct mcs7830_private {
87 #ifdef CONFIG_DM_ETH
88 	uint8_t rx_buf[MCS7830_RX_URB_SIZE];
89 	struct ueth_data ueth;
90 #endif
91 	uint8_t config;
92 	uint8_t mchash[8];
93 };
94 
95 /*
96  * mcs7830_read_reg() - read a register of the network adapter
97  * @udev:	network device to read from
98  * @idx:	index of the register to start reading from
99  * @size:	number of bytes to read
100  * @data:	buffer to read into
101  * Return: zero upon success, negative upon error
102  */
103 static int mcs7830_read_reg(struct usb_device *udev, uint8_t idx,
104 			    uint16_t size, void *data)
105 {
106 	int len;
107 	ALLOC_CACHE_ALIGN_BUFFER(uint8_t, buf, size);
108 
109 	debug("%s() idx=0x%04X sz=%d\n", __func__, idx, size);
110 
111 	len = usb_control_msg(udev,
112 			      usb_rcvctrlpipe(udev, 0),
113 			      MCS7830_RD_BREQ,
114 			      USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
115 			      0, idx, buf, size,
116 			      USBCALL_TIMEOUT);
117 	if (len != size) {
118 		debug("%s() len=%d != sz=%d\n", __func__, len, size);
119 		return -EIO;
120 	}
121 	memcpy(data, buf, size);
122 	return 0;
123 }
124 
125 /*
126  * mcs7830_write_reg() - write a register of the network adapter
127  * @udev:	network device to write to
128  * @idx:	index of the register to start writing to
129  * @size:	number of bytes to write
130  * @data:	buffer holding the data to write
131  * Return: zero upon success, negative upon error
132  */
133 static int mcs7830_write_reg(struct usb_device *udev, uint8_t idx,
134 			     uint16_t size, void *data)
135 {
136 	int len;
137 	ALLOC_CACHE_ALIGN_BUFFER(uint8_t, buf, size);
138 
139 	debug("%s() idx=0x%04X sz=%d\n", __func__, idx, size);
140 
141 	memcpy(buf, data, size);
142 	len = usb_control_msg(udev,
143 			      usb_sndctrlpipe(udev, 0),
144 			      MCS7830_WR_BREQ,
145 			      USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
146 			      0, idx, buf, size,
147 			      USBCALL_TIMEOUT);
148 	if (len != size) {
149 		debug("%s() len=%d != sz=%d\n", __func__, len, size);
150 		return -EIO;
151 	}
152 	return 0;
153 }
154 
155 /*
156  * mcs7830_phy_emit_wait() - emit PHY read/write access, wait for its execution
157  * @udev:	network device to talk to
158  * @rwflag:	PHY_CMD1_READ or PHY_CMD1_WRITE opcode
159  * @index:	number of the PHY register to read or write
160  * Return: zero upon success, negative upon error
161  */
162 static int mcs7830_phy_emit_wait(struct usb_device *udev,
163 				 uint8_t rwflag, uint8_t index)
164 {
165 	int rc;
166 	int retry;
167 	uint8_t cmd[2];
168 
169 	/* send the PHY read/write request */
170 	cmd[0] = rwflag | PHY_CMD1_PHYADDR;
171 	cmd[1] = PHY_CMD2_PEND | (index & 0x1f);
172 	rc = mcs7830_write_reg(udev, REG_PHY_CMD, sizeof(cmd), cmd);
173 	if (rc < 0)
174 		return rc;
175 
176 	/* wait for the response to become available (usually < 1ms) */
177 	retry = 10;
178 	do {
179 		rc = mcs7830_read_reg(udev, REG_PHY_CMD, sizeof(cmd), cmd);
180 		if (rc < 0)
181 			return rc;
182 		if (cmd[1] & PHY_CMD2_READY)
183 			return 0;
184 		if (!retry--)
185 			return -ETIMEDOUT;
186 		mdelay(1);
187 	} while (1);
188 	/* UNREACH */
189 }
190 
191 /*
192  * mcs7830_read_phy() - read a PHY register of the network adapter
193  * @udev:	network device to read from
194  * @index:	index of the PHY register to read from
195  * Return: non-negative 16bit register content, negative upon error
196  */
197 static int mcs7830_read_phy(struct usb_device *udev, uint8_t index)
198 {
199 	int rc;
200 	uint16_t val;
201 
202 	/* issue the PHY read request and wait for its execution */
203 	rc = mcs7830_phy_emit_wait(udev, PHY_CMD1_READ, index);
204 	if (rc < 0)
205 		return rc;
206 
207 	/* fetch the PHY data which was read */
208 	rc = mcs7830_read_reg(udev, REG_PHY_DATA, sizeof(val), &val);
209 	if (rc < 0)
210 		return rc;
211 	rc = le16_to_cpu(val);
212 	debug("%s(%d) => 0x%04X\n", __func__, index, rc);
213 	return rc;
214 }
215 
216 /*
217  * mcs7830_write_phy() - write a PHY register of the network adapter
218  * @udev:	network device to write to
219  * @index:	index of the PHY register to write to
220  * @val:	value to write to the PHY register
221  * Return: zero upon success, negative upon error
222  */
223 static int mcs7830_write_phy(struct usb_device *udev, uint8_t index,
224 			     uint16_t val)
225 {
226 	int rc;
227 
228 	debug("%s(%d, 0x%04X)\n", __func__, index, val);
229 
230 	/* setup the PHY data which is to get written */
231 	val = cpu_to_le16(val);
232 	rc = mcs7830_write_reg(udev, REG_PHY_DATA, sizeof(val), &val);
233 	if (rc < 0)
234 		return rc;
235 
236 	/* issue the PHY write request and wait for its execution */
237 	rc = mcs7830_phy_emit_wait(udev, PHY_CMD1_WRITE, index);
238 	if (rc < 0)
239 		return rc;
240 
241 	return 0;
242 }
243 
244 /*
245  * mcs7830_write_config() - write to the network adapter's config register
246  * @udev:	network device to write to
247  * @priv:	private data
248  * Return: zero upon success, negative upon error
249  *
250  * the data which gets written is taken from the shadow config register
251  * within the device driver's private data
252  */
253 static int mcs7830_write_config(struct usb_device *udev,
254 				struct mcs7830_private *priv)
255 {
256 	int rc;
257 
258 	debug("%s()\n", __func__);
259 
260 	rc = mcs7830_write_reg(udev, REG_CONFIG,
261 			       sizeof(priv->config), &priv->config);
262 	if (rc < 0) {
263 		debug("writing config to adapter failed\n");
264 		return rc;
265 	}
266 
267 	return 0;
268 }
269 
270 /*
271  * mcs7830_write_mchash() - write the network adapter's multicast filter
272  * @udev:	network device to write to
273  * @priv:	private data
274  * Return: zero upon success, negative upon error
275  *
276  * the data which gets written is taken from the shadow multicast hashes
277  * within the device driver's private data
278  */
279 static int mcs7830_write_mchash(struct usb_device *udev,
280 				struct mcs7830_private *priv)
281 {
282 	int rc;
283 
284 	debug("%s()\n", __func__);
285 
286 	rc = mcs7830_write_reg(udev, REG_MULTICAST_HASH,
287 			       sizeof(priv->mchash), &priv->mchash);
288 	if (rc < 0) {
289 		debug("writing multicast hash to adapter failed\n");
290 		return rc;
291 	}
292 
293 	return 0;
294 }
295 
296 /*
297  * mcs7830_set_autoneg() - setup and trigger ethernet link autonegotiation
298  * @udev:	network device to run link negotiation on
299  * Return: zero upon success, negative upon error
300  *
301  * the routine advertises available media and starts autonegotiation
302  */
303 static int mcs7830_set_autoneg(struct usb_device *udev)
304 {
305 	int adv, flg;
306 	int rc;
307 
308 	debug("%s()\n", __func__);
309 
310 	/*
311 	 * algorithm taken from the Linux driver, which took it from
312 	 * "the original mcs7830 version 1.4 driver":
313 	 *
314 	 * enable all media, reset BMCR, enable auto neg, restart
315 	 * auto neg while keeping the enable auto neg flag set
316 	 */
317 
318 	adv = ADVERTISE_PAUSE_CAP | ADVERTISE_ALL | ADVERTISE_CSMA;
319 	rc = mcs7830_write_phy(udev, MII_ADVERTISE, adv);
320 
321 	flg = 0;
322 	if (!rc)
323 		rc = mcs7830_write_phy(udev, MII_BMCR, flg);
324 
325 	flg |= BMCR_ANENABLE;
326 	if (!rc)
327 		rc = mcs7830_write_phy(udev, MII_BMCR, flg);
328 
329 	flg |= BMCR_ANRESTART;
330 	if (!rc)
331 		rc = mcs7830_write_phy(udev, MII_BMCR, flg);
332 
333 	return rc;
334 }
335 
336 /*
337  * mcs7830_get_rev() - identify a network adapter's chip revision
338  * @udev:	network device to identify
339  * Return: non-negative number, reflecting the revision number
340  *
341  * currently, only "rev C and higher" and "below rev C" are needed, so
342  * the return value is #1 for "below rev C", and #2 for "rev C and above"
343  */
344 static int mcs7830_get_rev(struct usb_device *udev)
345 {
346 	uint8_t buf[2];
347 	int rc;
348 	int rev;
349 
350 	/* register 22 is readable in rev C and higher */
351 	rc = mcs7830_read_reg(udev, REG_FRAME_DROP_COUNTER, sizeof(buf), buf);
352 	if (rc < 0)
353 		rev = 1;
354 	else
355 		rev = 2;
356 	debug("%s() rc=%d, rev=%d\n", __func__, rc, rev);
357 	return rev;
358 }
359 
360 /*
361  * mcs7830_apply_fixup() - identify an adapter and potentially apply fixups
362  * @udev:	network device to identify and apply fixups to
363  * Return: zero upon success (no errors emitted from here)
364  *
365  * this routine identifies the network adapter's chip revision, and applies
366  * fixups for known issues
367  */
368 static int mcs7830_apply_fixup(struct usb_device *udev)
369 {
370 	int rev;
371 	int i;
372 	uint8_t thr;
373 
374 	rev = mcs7830_get_rev(udev);
375 	debug("%s() rev=%d\n", __func__, rev);
376 
377 	/*
378 	 * rev C requires setting the pause threshold (the Linux driver
379 	 * is inconsistent, the implementation does it for "rev C
380 	 * exactly", the introductory comment says "rev C and above")
381 	 */
382 	if (rev == 2) {
383 		debug("%s: applying rev C fixup\n", __func__);
384 		thr = PAUSE_THRESHOLD_DEFAULT;
385 		for (i = 0; i < 2; i++) {
386 			(void)mcs7830_write_reg(udev, REG_PAUSE_THRESHOLD,
387 						sizeof(thr), &thr);
388 			mdelay(1);
389 		}
390 	}
391 
392 	return 0;
393 }
394 
395 /*
396  * mcs7830_basic_reset() - bring the network adapter into a known first state
397  * @eth:	network device to act upon
398  * Return: zero upon success, negative upon error
399  *
400  * this routine initializes the network adapter such that subsequent invocations
401  * of the interface callbacks can exchange ethernet frames; link negotiation is
402  * triggered from here already and continues in background
403  */
404 static int mcs7830_basic_reset(struct usb_device *udev,
405 			       struct mcs7830_private *priv)
406 {
407 	int rc;
408 
409 	debug("%s()\n", __func__);
410 
411 	/*
412 	 * comment from the respective Linux driver, which
413 	 * unconditionally sets the ALLMULTICAST flag as well:
414 	 * should not be needed, but does not work otherwise
415 	 */
416 	priv->config = CONF_TXENABLE;
417 	priv->config |= CONF_ALLMULTICAST;
418 
419 	rc = mcs7830_set_autoneg(udev);
420 	if (rc < 0) {
421 		pr_err("setting autoneg failed\n");
422 		return rc;
423 	}
424 
425 	rc = mcs7830_write_mchash(udev, priv);
426 	if (rc < 0) {
427 		pr_err("failed to set multicast hash\n");
428 		return rc;
429 	}
430 
431 	rc = mcs7830_write_config(udev, priv);
432 	if (rc < 0) {
433 		pr_err("failed to set configuration\n");
434 		return rc;
435 	}
436 
437 	rc = mcs7830_apply_fixup(udev);
438 	if (rc < 0) {
439 		pr_err("fixup application failed\n");
440 		return rc;
441 	}
442 
443 	return 0;
444 }
445 
446 /*
447  * mcs7830_read_mac() - read an ethernet adapter's MAC address
448  * @udev:	network device to read from
449  * @enetaddr:	place to put ethernet MAC address
450  * Return: zero upon success, negative upon error
451  *
452  * this routine fetches the MAC address stored within the ethernet adapter,
453  * and stores it in the ethernet interface's data structure
454  */
455 static int mcs7830_read_mac(struct usb_device *udev, unsigned char enetaddr[])
456 {
457 	int rc;
458 	uint8_t buf[ETH_ALEN];
459 
460 	debug("%s()\n", __func__);
461 
462 	rc = mcs7830_read_reg(udev, REG_ETHER_ADDR, ETH_ALEN, buf);
463 	if (rc < 0) {
464 		debug("reading MAC from adapter failed\n");
465 		return rc;
466 	}
467 
468 	memcpy(enetaddr, buf, ETH_ALEN);
469 	return 0;
470 }
471 
472 static int mcs7830_write_mac_common(struct usb_device *udev,
473 				    unsigned char enetaddr[])
474 {
475 	int rc;
476 
477 	debug("%s()\n", __func__);
478 
479 	rc = mcs7830_write_reg(udev, REG_ETHER_ADDR, ETH_ALEN, enetaddr);
480 	if (rc < 0) {
481 		debug("writing MAC to adapter failed\n");
482 		return rc;
483 	}
484 	return 0;
485 }
486 
487 static int mcs7830_init_common(struct usb_device *udev)
488 {
489 	int timeout;
490 	int have_link;
491 
492 	debug("%s()\n", __func__);
493 
494 	timeout = 0;
495 	do {
496 		have_link = mcs7830_read_phy(udev, MII_BMSR) & BMSR_LSTATUS;
497 		if (have_link)
498 			break;
499 		udelay(LINKSTATUS_TIMEOUT_RES * 1000);
500 		timeout += LINKSTATUS_TIMEOUT_RES;
501 	} while (timeout < LINKSTATUS_TIMEOUT);
502 	if (!have_link) {
503 		debug("ethernet link is down\n");
504 		return -ETIMEDOUT;
505 	}
506 	return 0;
507 }
508 
509 static int mcs7830_send_common(struct ueth_data *ueth, void *packet,
510 			       int length)
511 {
512 	struct usb_device *udev = ueth->pusb_dev;
513 	int rc;
514 	int gotlen;
515 	/* there is a status byte after the ethernet frame */
516 	ALLOC_CACHE_ALIGN_BUFFER(uint8_t, buf, PKTSIZE + sizeof(uint8_t));
517 
518 	memcpy(buf, packet, length);
519 	rc = usb_bulk_msg(udev,
520 			  usb_sndbulkpipe(udev, ueth->ep_out),
521 			  &buf[0], length, &gotlen,
522 			  USBCALL_TIMEOUT);
523 	debug("%s() TX want len %d, got len %d, rc %d\n",
524 	      __func__, length, gotlen, rc);
525 	return rc;
526 }
527 
528 static int mcs7830_recv_common(struct ueth_data *ueth, uint8_t *buf)
529 {
530 	int rc, wantlen, gotlen;
531 	uint8_t sts;
532 
533 	debug("%s()\n", __func__);
534 
535 	/* fetch input data from the adapter */
536 	wantlen = MCS7830_RX_URB_SIZE;
537 	rc = usb_bulk_msg(ueth->pusb_dev,
538 			  usb_rcvbulkpipe(ueth->pusb_dev, ueth->ep_in),
539 			  &buf[0], wantlen, &gotlen,
540 			  USBCALL_TIMEOUT);
541 	debug("%s() RX want len %d, got len %d, rc %d\n",
542 	      __func__, wantlen, gotlen, rc);
543 	if (rc != 0) {
544 		pr_err("RX: failed to receive\n");
545 		return rc;
546 	}
547 	if (gotlen > wantlen) {
548 		pr_err("RX: got too many bytes (%d)\n", gotlen);
549 		return -EIO;
550 	}
551 
552 	/*
553 	 * the bulk message that we received from USB contains exactly
554 	 * one ethernet frame and a trailing status byte
555 	 */
556 	if (gotlen < sizeof(sts))
557 		return -EIO;
558 	gotlen -= sizeof(sts);
559 	sts = buf[gotlen];
560 
561 	if (sts == STAT_RX_FRAME_CORRECT) {
562 		debug("%s() got a frame, len=%d\n", __func__, gotlen);
563 		return gotlen;
564 	}
565 
566 	debug("RX: frame error (sts 0x%02X, %s %s %s %s %s)\n",
567 	      sts,
568 	      (sts & STAT_RX_LARGE_FRAME) ? "large" : "-",
569 	      (sts & STAT_RX_LENGTH_ERROR) ?  "length" : "-",
570 	      (sts & STAT_RX_SHORT_FRAME) ? "short" : "-",
571 	      (sts & STAT_RX_CRC_ERROR) ? "crc" : "-",
572 	      (sts & STAT_RX_ALIGNMENT_ERROR) ?  "align" : "-");
573 	return -EIO;
574 }
575 
576 #ifndef CONFIG_DM_ETH
577 /*
578  * mcs7830_init() - network interface's init callback
579  * @udev:	network device to initialize
580  * @bd:		board information
581  * Return: zero upon success, negative upon error
582  *
583  * after initial setup during probe() and get_info(), this init() callback
584  * ensures that the link is up and subsequent send() and recv() calls can
585  * exchange ethernet frames
586  */
587 static int mcs7830_init(struct eth_device *eth, bd_t *bd)
588 {
589 	struct ueth_data *dev = eth->priv;
590 
591 	return mcs7830_init_common(dev->pusb_dev);
592 }
593 
594 /*
595  * mcs7830_send() - network interface's send callback
596  * @eth:	network device to send the frame from
597  * @packet:	ethernet frame content
598  * @length:	ethernet frame length
599  * Return: zero upon success, negative upon error
600  *
601  * this routine send an ethernet frame out of the network interface
602  */
603 static int mcs7830_send(struct eth_device *eth, void *packet, int length)
604 {
605 	struct ueth_data *dev = eth->priv;
606 
607 	return mcs7830_send_common(dev, packet, length);
608 }
609 
610 /*
611  * mcs7830_recv() - network interface's recv callback
612  * @eth:	network device to receive frames from
613  * Return: zero upon success, negative upon error
614  *
615  * this routine checks for available ethernet frames that the network
616  * interface might have received, and notifies the network stack
617  */
618 static int mcs7830_recv(struct eth_device *eth)
619 {
620 	ALLOC_CACHE_ALIGN_BUFFER(uint8_t, buf, MCS7830_RX_URB_SIZE);
621 	struct ueth_data *ueth = eth->priv;
622 	int len;
623 
624 	len = mcs7830_recv_common(ueth, buf);
625 	if (len >= 0) {
626 		net_process_received_packet(buf, len);
627 		return 0;
628 	}
629 
630 	return len;
631 }
632 
633 /*
634  * mcs7830_halt() - network interface's halt callback
635  * @eth:	network device to cease operation of
636  * Return: none
637  *
638  * this routine is supposed to undo the effect of previous initialization and
639  * ethernet frames exchange; in this implementation it's a NOP
640  */
641 static void mcs7830_halt(struct eth_device *eth)
642 {
643 	debug("%s()\n", __func__);
644 }
645 
646 /*
647  * mcs7830_write_mac() - write an ethernet adapter's MAC address
648  * @eth:	network device to write to
649  * Return: zero upon success, negative upon error
650  *
651  * this routine takes the MAC address from the ethernet interface's data
652  * structure, and writes it into the ethernet adapter such that subsequent
653  * exchange of ethernet frames uses this address
654  */
655 static int mcs7830_write_mac(struct eth_device *eth)
656 {
657 	struct ueth_data *ueth = eth->priv;
658 
659 	return mcs7830_write_mac_common(ueth->pusb_dev, eth->enetaddr);
660 }
661 
662 /*
663  * mcs7830_iface_idx - index of detected network interfaces
664  *
665  * this counter keeps track of identified supported interfaces,
666  * to assign unique names as more interfaces are found
667  */
668 static int mcs7830_iface_idx;
669 
670 /*
671  * mcs7830_eth_before_probe() - network driver's before_probe callback
672  * Return: none
673  *
674  * this routine initializes driver's internal data in preparation of
675  * subsequent probe callbacks
676  */
677 void mcs7830_eth_before_probe(void)
678 {
679 	mcs7830_iface_idx = 0;
680 }
681 
682 /*
683  * struct mcs7830_dongle - description of a supported Moschip ethernet dongle
684  * @vendor:	16bit USB vendor identification
685  * @product:	16bit USB product identification
686  *
687  * this structure describes a supported USB ethernet dongle by means of the
688  * vendor and product codes found during USB enumeration; no flags are held
689  * here since all supported dongles have identical behaviour, and required
690  * fixups get determined at runtime, such that no manual configuration is
691  * needed
692  */
693 struct mcs7830_dongle {
694 	uint16_t vendor;
695 	uint16_t product;
696 };
697 
698 /*
699  * mcs7830_dongles - the list of supported Moschip based USB ethernet dongles
700  */
701 static const struct mcs7830_dongle mcs7830_dongles[] = {
702 	{ 0x9710, 0x7832, },	/* Moschip 7832 */
703 	{ 0x9710, 0x7830, },	/* Moschip 7830 */
704 	{ 0x9710, 0x7730, },	/* Moschip 7730 */
705 	{ 0x0df6, 0x0021, },	/* Sitecom LN 30 */
706 };
707 
708 /*
709  * mcs7830_eth_probe() - network driver's probe callback
710  * @dev:	detected USB device to check
711  * @ifnum:	detected USB interface to check
712  * @ss:		USB ethernet data structure to fill in upon match
713  * Return: #1 upon match, #0 upon mismatch or error
714  *
715  * this routine checks whether the found USB device is supported by
716  * this ethernet driver, and upon match fills in the USB ethernet
717  * data structure which later is passed to the get_info callback
718  */
719 int mcs7830_eth_probe(struct usb_device *dev, unsigned int ifnum,
720 		      struct ueth_data *ss)
721 {
722 	struct usb_interface *iface;
723 	struct usb_interface_descriptor *iface_desc;
724 	int i;
725 	struct mcs7830_private *priv;
726 	int ep_in_found, ep_out_found, ep_intr_found;
727 
728 	debug("%s()\n", __func__);
729 
730 	/* iterate the list of supported dongles */
731 	iface = &dev->config.if_desc[ifnum];
732 	iface_desc = &iface->desc;
733 	for (i = 0; i < ARRAY_SIZE(mcs7830_dongles); i++) {
734 		if (dev->descriptor.idVendor == mcs7830_dongles[i].vendor &&
735 		    dev->descriptor.idProduct == mcs7830_dongles[i].product)
736 			break;
737 	}
738 	if (i == ARRAY_SIZE(mcs7830_dongles))
739 		return 0;
740 	debug("detected USB ethernet device: %04X:%04X\n",
741 	      dev->descriptor.idVendor, dev->descriptor.idProduct);
742 
743 	/* fill in driver private data */
744 	priv = calloc(1, sizeof(*priv));
745 	if (!priv)
746 		return 0;
747 
748 	/* fill in the ueth_data structure, attach private data */
749 	memset(ss, 0, sizeof(*ss));
750 	ss->ifnum = ifnum;
751 	ss->pusb_dev = dev;
752 	ss->subclass = iface_desc->bInterfaceSubClass;
753 	ss->protocol = iface_desc->bInterfaceProtocol;
754 	ss->dev_priv = priv;
755 
756 	/*
757 	 * a minimum of three endpoints is expected: in (bulk),
758 	 * out (bulk), and interrupt; ignore all others
759 	 */
760 	ep_in_found = ep_out_found = ep_intr_found = 0;
761 	for (i = 0; i < iface_desc->bNumEndpoints; i++) {
762 		uint8_t eptype, epaddr;
763 		bool is_input;
764 
765 		eptype = iface->ep_desc[i].bmAttributes;
766 		eptype &= USB_ENDPOINT_XFERTYPE_MASK;
767 
768 		epaddr = iface->ep_desc[i].bEndpointAddress;
769 		is_input = epaddr & USB_DIR_IN;
770 		epaddr &= USB_ENDPOINT_NUMBER_MASK;
771 
772 		if (eptype == USB_ENDPOINT_XFER_BULK) {
773 			if (is_input && !ep_in_found) {
774 				ss->ep_in = epaddr;
775 				ep_in_found++;
776 			}
777 			if (!is_input && !ep_out_found) {
778 				ss->ep_out = epaddr;
779 				ep_out_found++;
780 			}
781 		}
782 
783 		if (eptype == USB_ENDPOINT_XFER_INT) {
784 			if (is_input && !ep_intr_found) {
785 				ss->ep_int = epaddr;
786 				ss->irqinterval = iface->ep_desc[i].bInterval;
787 				ep_intr_found++;
788 			}
789 		}
790 	}
791 	debug("endpoints: in %d, out %d, intr %d\n",
792 	      ss->ep_in, ss->ep_out, ss->ep_int);
793 
794 	/* apply basic sanity checks */
795 	if (usb_set_interface(dev, iface_desc->bInterfaceNumber, 0) ||
796 	    !ss->ep_in || !ss->ep_out || !ss->ep_int) {
797 		debug("device probe incomplete\n");
798 		return 0;
799 	}
800 
801 	dev->privptr = ss;
802 	return 1;
803 }
804 
805 /*
806  * mcs7830_eth_get_info() - network driver's get_info callback
807  * @dev:	detected USB device
808  * @ss:		USB ethernet data structure filled in at probe()
809  * @eth:	ethernet interface data structure to fill in
810  * Return: #1 upon success, #0 upon error
811  *
812  * this routine registers the mandatory init(), send(), recv(), and
813  * halt() callbacks with the ethernet interface, can register the
814  * optional write_hwaddr() callback with the ethernet interface,
815  * and initiates configuration of the interface such that subsequent
816  * calls to those callbacks results in network communication
817  */
818 int mcs7830_eth_get_info(struct usb_device *dev, struct ueth_data *ss,
819 			 struct eth_device *eth)
820 {
821 	debug("%s()\n", __func__);
822 	if (!eth) {
823 		debug("%s: missing parameter.\n", __func__);
824 		return 0;
825 	}
826 
827 	snprintf(eth->name, sizeof(eth->name), "%s%d",
828 		 MCS7830_BASE_NAME, mcs7830_iface_idx++);
829 	eth->init = mcs7830_init;
830 	eth->send = mcs7830_send;
831 	eth->recv = mcs7830_recv;
832 	eth->halt = mcs7830_halt;
833 	eth->write_hwaddr = mcs7830_write_mac;
834 	eth->priv = ss;
835 
836 	if (mcs7830_basic_reset(ss->pusb_dev, ss->dev_priv))
837 		return 0;
838 
839 	if (mcs7830_read_mac(ss->pusb_dev, eth->enetaddr))
840 		return 0;
841 	debug("MAC %pM\n", eth->enetaddr);
842 
843 	return 1;
844 }
845 #endif
846 
847 
848 #ifdef CONFIG_DM_ETH
849 static int mcs7830_eth_start(struct udevice *dev)
850 {
851 	struct usb_device *udev = dev_get_parent_priv(dev);
852 
853 	return mcs7830_init_common(udev);
854 }
855 
856 void mcs7830_eth_stop(struct udevice *dev)
857 {
858 	debug("** %s()\n", __func__);
859 }
860 
861 int mcs7830_eth_send(struct udevice *dev, void *packet, int length)
862 {
863 	struct mcs7830_private *priv = dev_get_priv(dev);
864 	struct ueth_data *ueth = &priv->ueth;
865 
866 	return mcs7830_send_common(ueth, packet, length);
867 }
868 
869 int mcs7830_eth_recv(struct udevice *dev, int flags, uchar **packetp)
870 {
871 	struct mcs7830_private *priv = dev_get_priv(dev);
872 	struct ueth_data *ueth = &priv->ueth;
873 	int len;
874 
875 	len = mcs7830_recv_common(ueth, priv->rx_buf);
876 	*packetp = priv->rx_buf;
877 
878 	return len;
879 }
880 
881 static int mcs7830_free_pkt(struct udevice *dev, uchar *packet, int packet_len)
882 {
883 	struct mcs7830_private *priv = dev_get_priv(dev);
884 
885 	packet_len = ALIGN(packet_len, 4);
886 	usb_ether_advance_rxbuf(&priv->ueth, sizeof(u32) + packet_len);
887 
888 	return 0;
889 }
890 
891 int mcs7830_write_hwaddr(struct udevice *dev)
892 {
893 	struct usb_device *udev = dev_get_parent_priv(dev);
894 	struct eth_pdata *pdata = dev_get_platdata(dev);
895 
896 	return mcs7830_write_mac_common(udev, pdata->enetaddr);
897 }
898 
899 static int mcs7830_eth_probe(struct udevice *dev)
900 {
901 	struct usb_device *udev = dev_get_parent_priv(dev);
902 	struct mcs7830_private *priv = dev_get_priv(dev);
903 	struct eth_pdata *pdata = dev_get_platdata(dev);
904 	struct ueth_data *ueth = &priv->ueth;
905 
906 	if (mcs7830_basic_reset(udev, priv))
907 		return 0;
908 
909 	if (mcs7830_read_mac(udev, pdata->enetaddr))
910 		return 0;
911 
912 	return usb_ether_register(dev, ueth, MCS7830_RX_URB_SIZE);
913 }
914 
915 static const struct eth_ops mcs7830_eth_ops = {
916 	.start	= mcs7830_eth_start,
917 	.send	= mcs7830_eth_send,
918 	.recv	= mcs7830_eth_recv,
919 	.free_pkt = mcs7830_free_pkt,
920 	.stop	= mcs7830_eth_stop,
921 	.write_hwaddr = mcs7830_write_hwaddr,
922 };
923 
924 U_BOOT_DRIVER(mcs7830_eth) = {
925 	.name	= "mcs7830_eth",
926 	.id	= UCLASS_ETH,
927 	.probe = mcs7830_eth_probe,
928 	.ops	= &mcs7830_eth_ops,
929 	.priv_auto_alloc_size = sizeof(struct mcs7830_private),
930 	.platdata_auto_alloc_size = sizeof(struct eth_pdata),
931 	.flags	= DM_FLAG_ALLOC_PRIV_DMA,
932 };
933 
934 static const struct usb_device_id mcs7830_eth_id_table[] = {
935 	{ USB_DEVICE(0x9710, 0x7832) },		/* Moschip 7832 */
936 	{ USB_DEVICE(0x9710, 0x7830), },	/* Moschip 7830 */
937 	{ USB_DEVICE(0x9710, 0x7730), },	/* Moschip 7730 */
938 	{ USB_DEVICE(0x0df6, 0x0021), },	/* Sitecom LN 30 */
939 	{ }		/* Terminating entry */
940 };
941 
942 U_BOOT_USB_DEVICE(mcs7830_eth, mcs7830_eth_id_table);
943 #endif
944