2 * MAX3421 Host Controller driver for USB.
4 * Author: David Mosberger-Tang <davidm@egauge.net>
6 * (C) Copyright 2014 David Mosberger-Tang <davidm@egauge.net>
8 * MAX3421 is a chip implementing a USB 2.0 Full-/Low-Speed host
9 * controller on a SPI bus.
12 * o MAX3421E datasheet
13 * http://datasheets.maximintegrated.com/en/ds/MAX3421E.pdf
14 * o MAX3421E Programming Guide
15 * http://www.hdl.co.jp/ftpdata/utl-001/AN3785.pdf
16 * o gadget/dummy_hcd.c
17 * For USB HCD implementation.
18 * o Arduino MAX3421 driver
19 * https://github.com/felis/USB_Host_Shield_2.0/blob/master/Usb.cpp
21 * This file is licenced under the GPL v2.
23 * Important note on worst-case (full-speed) packet size constraints
24 * (See USB 2.0 Section 5.6.3 and following):
27 * - isochronous: 1023 bytes
28 * - interrupt: 64 bytes
31 * Since the MAX3421 FIFO size is 64 bytes, we do not have to work about
32 * multi-FIFO writes/reads for a single USB packet *except* for isochronous
33 * transfers. We don't support isochronous transfers at this time, so we
34 * just assume that a USB packet always fits into a single FIFO buffer.
36 * NOTE: The June 2006 version of "MAX3421E Programming Guide"
37 * (AN3785) has conflicting info for the RCVDAVIRQ bit:
39 * The description of RCVDAVIRQ says "The CPU *must* clear
40 * this IRQ bit (by writing a 1 to it) before reading the
43 * However, the earlier section on "Programming BULK-IN
44 * Transfers" says * that:
46 * After the CPU retrieves the data, it clears the
49 * The December 2006 version has been corrected and it consistently
50 * states the second behavior is the correct one.
52 * Synchronous SPI transactions sleep so we can't perform any such
53 * transactions while holding a spin-lock (and/or while interrupts are
54 * masked). To achieve this, all SPI transactions are issued from a
55 * single thread (max3421_spi_thread).
58 #include <linux/module.h>
59 #include <linux/spi/spi.h>
60 #include <linux/usb.h>
61 #include <linux/usb/hcd.h>
63 #include <linux/platform_data/max3421-hcd.h>
65 #define DRIVER_DESC "MAX3421 USB Host-Controller Driver"
66 #define DRIVER_VERSION "1.0"
68 /* 11-bit counter that wraps around (USB 2.0 Section 8.3.3): */
69 #define USB_MAX_FRAME_NUMBER 0x7ff
70 #define USB_MAX_RETRIES 3 /* # of retries before error is reported */
73 * Max. # of times we're willing to retransmit a request immediately in
74 * resposne to a NAK. Afterwards, we fall back on trying once a frame.
76 #define NAK_MAX_FAST_RETRANSMITS 2
78 #define POWER_BUDGET 500 /* in mA; use 8 for low-power port testing */
80 /* Port-change mask: */
81 #define PORT_C_MASK ((USB_PORT_STAT_C_CONNECTION | \
82 USB_PORT_STAT_C_ENABLE | \
83 USB_PORT_STAT_C_SUSPEND | \
84 USB_PORT_STAT_C_OVERCURRENT | \
85 USB_PORT_STAT_C_RESET) << 16)
87 enum max3421_rh_state {
94 PKT_STATE_SETUP, /* waiting to send setup packet to ctrl pipe */
95 PKT_STATE_TRANSFER, /* waiting to xfer transfer_buffer */
96 PKT_STATE_TERMINATE /* waiting to terminate control transfer */
99 enum scheduling_pass {
101 SCHED_PASS_NON_PERIODIC,
108 struct task_struct *spi_thread;
110 struct max3421_hcd *next;
112 enum max3421_rh_state rh_state;
113 /* lower 16 bits contain port status, upper 16 bits the change mask: */
118 struct list_head ep_list; /* list of EP's with work */
121 * The following are owned by spi_thread (may be accessed by
122 * SPI-thread without acquiring the HCD lock:
124 u8 rev; /* chip revision */
127 * URB we're currently processing. Must not be reset to NULL
128 * unless MAX3421E chip is idle:
130 struct urb *curr_urb;
131 enum scheduling_pass sched_pass;
132 struct usb_device *loaded_dev; /* dev that's loaded into the chip */
133 int loaded_epnum; /* epnum whose toggles are loaded */
134 int urb_done; /* > 0 -> no errors, < 0: errno */
139 unsigned int do_enable_irq:1;
140 unsigned int do_reset_hcd:1;
141 unsigned int do_reset_port:1;
142 unsigned int do_check_unlink:1;
143 unsigned int do_iopin_update:1;
145 unsigned long err_stat[16];
150 struct usb_host_endpoint *ep;
151 struct list_head ep_list;
153 u16 last_active; /* frame # this ep was last active */
154 enum pkt_state pkt_state;
156 u8 retransmit; /* packet needs retransmission */
159 static struct max3421_hcd *max3421_hcd_list;
161 #define MAX3421_FIFO_SIZE 64
163 #define MAX3421_SPI_DIR_RD 0 /* read register from MAX3421 */
164 #define MAX3421_SPI_DIR_WR 1 /* write register to MAX3421 */
167 #define MAX3421_SPI_DIR_SHIFT 1
168 #define MAX3421_SPI_REG_SHIFT 3
170 #define MAX3421_REG_RCVFIFO 1
171 #define MAX3421_REG_SNDFIFO 2
172 #define MAX3421_REG_SUDFIFO 4
173 #define MAX3421_REG_RCVBC 6
174 #define MAX3421_REG_SNDBC 7
175 #define MAX3421_REG_USBIRQ 13
176 #define MAX3421_REG_USBIEN 14
177 #define MAX3421_REG_USBCTL 15
178 #define MAX3421_REG_CPUCTL 16
179 #define MAX3421_REG_PINCTL 17
180 #define MAX3421_REG_REVISION 18
181 #define MAX3421_REG_IOPINS1 20
182 #define MAX3421_REG_IOPINS2 21
183 #define MAX3421_REG_GPINIRQ 22
184 #define MAX3421_REG_GPINIEN 23
185 #define MAX3421_REG_GPINPOL 24
186 #define MAX3421_REG_HIRQ 25
187 #define MAX3421_REG_HIEN 26
188 #define MAX3421_REG_MODE 27
189 #define MAX3421_REG_PERADDR 28
190 #define MAX3421_REG_HCTL 29
191 #define MAX3421_REG_HXFR 30
192 #define MAX3421_REG_HRSL 31
195 MAX3421_USBIRQ_OSCOKIRQ_BIT = 0,
196 MAX3421_USBIRQ_NOVBUSIRQ_BIT = 5,
197 MAX3421_USBIRQ_VBUSIRQ_BIT
201 MAX3421_CPUCTL_IE_BIT = 0,
202 MAX3421_CPUCTL_PULSEWID0_BIT = 6,
203 MAX3421_CPUCTL_PULSEWID1_BIT
207 MAX3421_USBCTL_PWRDOWN_BIT = 4,
208 MAX3421_USBCTL_CHIPRES_BIT
212 MAX3421_PINCTL_GPXA_BIT = 0,
213 MAX3421_PINCTL_GPXB_BIT,
214 MAX3421_PINCTL_POSINT_BIT,
215 MAX3421_PINCTL_INTLEVEL_BIT,
216 MAX3421_PINCTL_FDUPSPI_BIT,
217 MAX3421_PINCTL_EP0INAK_BIT,
218 MAX3421_PINCTL_EP2INAK_BIT,
219 MAX3421_PINCTL_EP3INAK_BIT,
223 MAX3421_HI_BUSEVENT_BIT = 0, /* bus-reset/-resume */
224 MAX3421_HI_RWU_BIT, /* remote wakeup */
225 MAX3421_HI_RCVDAV_BIT, /* receive FIFO data available */
226 MAX3421_HI_SNDBAV_BIT, /* send buffer available */
227 MAX3421_HI_SUSDN_BIT, /* suspend operation done */
228 MAX3421_HI_CONDET_BIT, /* peripheral connect/disconnect */
229 MAX3421_HI_FRAME_BIT, /* frame generator */
230 MAX3421_HI_HXFRDN_BIT, /* host transfer done */
234 MAX3421_HCTL_BUSRST_BIT = 0,
235 MAX3421_HCTL_FRMRST_BIT,
236 MAX3421_HCTL_SAMPLEBUS_BIT,
237 MAX3421_HCTL_SIGRSM_BIT,
238 MAX3421_HCTL_RCVTOG0_BIT,
239 MAX3421_HCTL_RCVTOG1_BIT,
240 MAX3421_HCTL_SNDTOG0_BIT,
241 MAX3421_HCTL_SNDTOG1_BIT
245 MAX3421_MODE_HOST_BIT = 0,
246 MAX3421_MODE_LOWSPEED_BIT,
247 MAX3421_MODE_HUBPRE_BIT,
248 MAX3421_MODE_SOFKAENAB_BIT,
249 MAX3421_MODE_SEPIRQ_BIT,
250 MAX3421_MODE_DELAYISO_BIT,
251 MAX3421_MODE_DMPULLDN_BIT,
252 MAX3421_MODE_DPPULLDN_BIT
263 MAX3421_HRSL_WRONGPID,
270 MAX3421_HRSL_TIMEOUT,
272 MAX3421_HRSL_RESULT_MASK = 0xf,
273 MAX3421_HRSL_RCVTOGRD_BIT = 4,
274 MAX3421_HRSL_SNDTOGRD_BIT,
275 MAX3421_HRSL_KSTATUS_BIT,
276 MAX3421_HRSL_JSTATUS_BIT
279 /* Return same error-codes as ohci.h:cc_to_error: */
280 static const int hrsl_to_error[] = {
281 [MAX3421_HRSL_OK] = 0,
282 [MAX3421_HRSL_BUSY] = -EINVAL,
283 [MAX3421_HRSL_BADREQ] = -EINVAL,
284 [MAX3421_HRSL_UNDEF] = -EINVAL,
285 [MAX3421_HRSL_NAK] = -EAGAIN,
286 [MAX3421_HRSL_STALL] = -EPIPE,
287 [MAX3421_HRSL_TOGERR] = -EILSEQ,
288 [MAX3421_HRSL_WRONGPID] = -EPROTO,
289 [MAX3421_HRSL_BADBC] = -EREMOTEIO,
290 [MAX3421_HRSL_PIDERR] = -EPROTO,
291 [MAX3421_HRSL_PKTERR] = -EPROTO,
292 [MAX3421_HRSL_CRCERR] = -EILSEQ,
293 [MAX3421_HRSL_KERR] = -EIO,
294 [MAX3421_HRSL_JERR] = -EIO,
295 [MAX3421_HRSL_TIMEOUT] = -ETIME,
296 [MAX3421_HRSL_BABBLE] = -EOVERFLOW
300 * See http://www.beyondlogic.org/usbnutshell/usb4.shtml#Control for a
301 * reasonable overview of how control transfers use the the IN/OUT
304 #define MAX3421_HXFR_BULK_IN(ep) (0x00 | (ep)) /* bulk or interrupt */
305 #define MAX3421_HXFR_SETUP 0x10
306 #define MAX3421_HXFR_BULK_OUT(ep) (0x20 | (ep)) /* bulk or interrupt */
307 #define MAX3421_HXFR_ISO_IN(ep) (0x40 | (ep))
308 #define MAX3421_HXFR_ISO_OUT(ep) (0x60 | (ep))
309 #define MAX3421_HXFR_HS_IN 0x80 /* handshake in */
310 #define MAX3421_HXFR_HS_OUT 0xa0 /* handshake out */
312 #define field(val, bit) ((val) << (bit))
315 frame_diff(u16 left, u16 right)
317 return ((unsigned) (left - right)) % (USB_MAX_FRAME_NUMBER + 1);
320 static inline struct max3421_hcd *
321 hcd_to_max3421(struct usb_hcd *hcd)
323 return (struct max3421_hcd *) hcd->hcd_priv;
326 static inline struct usb_hcd *
327 max3421_to_hcd(struct max3421_hcd *max3421_hcd)
329 return container_of((void *) max3421_hcd, struct usb_hcd, hcd_priv);
333 spi_rd8(struct usb_hcd *hcd, unsigned int reg)
335 struct spi_device *spi = to_spi_device(hcd->self.controller);
336 struct spi_transfer transfer;
339 * RX data must be in its own cache-line so it stays flushed
340 * from the cache until the transfer is complete. Otherwise,
341 * we get stale data from the cache.
343 u8 rx_data[SMP_CACHE_BYTES] ____cacheline_aligned;
344 struct spi_message msg;
346 memset(&transfer, 0, sizeof(transfer));
348 spi_message_init(&msg);
350 tx_data[0] = (field(reg, MAX3421_SPI_REG_SHIFT) |
351 field(MAX3421_SPI_DIR_RD, MAX3421_SPI_DIR_SHIFT));
353 transfer.tx_buf = tx_data;
354 transfer.rx_buf = rx_data;
357 spi_message_add_tail(&transfer, &msg);
364 spi_wr8(struct usb_hcd *hcd, unsigned int reg, u8 val)
366 struct spi_device *spi = to_spi_device(hcd->self.controller);
367 struct spi_transfer transfer;
368 struct spi_message msg;
371 memset(&transfer, 0, sizeof(transfer));
373 spi_message_init(&msg);
375 tx_data[0] = (field(reg, MAX3421_SPI_REG_SHIFT) |
376 field(MAX3421_SPI_DIR_WR, MAX3421_SPI_DIR_SHIFT));
379 transfer.tx_buf = tx_data;
382 spi_message_add_tail(&transfer, &msg);
387 spi_rd_buf(struct usb_hcd *hcd, unsigned int reg, void *buf, size_t len)
389 struct spi_device *spi = to_spi_device(hcd->self.controller);
390 struct spi_transfer transfer[2];
391 struct spi_message msg;
394 memset(transfer, 0, sizeof(transfer));
396 spi_message_init(&msg);
398 cmd = (field(reg, MAX3421_SPI_REG_SHIFT) |
399 field(MAX3421_SPI_DIR_RD, MAX3421_SPI_DIR_SHIFT));
401 transfer[0].tx_buf = &cmd;
404 transfer[1].rx_buf = buf;
405 transfer[1].len = len;
407 spi_message_add_tail(&transfer[0], &msg);
408 spi_message_add_tail(&transfer[1], &msg);
413 spi_wr_buf(struct usb_hcd *hcd, unsigned int reg, void *buf, size_t len)
415 struct spi_device *spi = to_spi_device(hcd->self.controller);
416 struct spi_transfer transfer[2];
417 struct spi_message msg;
420 memset(transfer, 0, sizeof(transfer));
422 spi_message_init(&msg);
424 cmd = (field(reg, MAX3421_SPI_REG_SHIFT) |
425 field(MAX3421_SPI_DIR_WR, MAX3421_SPI_DIR_SHIFT));
427 transfer[0].tx_buf = &cmd;
430 transfer[1].tx_buf = buf;
431 transfer[1].len = len;
433 spi_message_add_tail(&transfer[0], &msg);
434 spi_message_add_tail(&transfer[1], &msg);
439 * Figure out the correct setting for the LOWSPEED and HUBPRE mode
440 * bits. The HUBPRE bit needs to be set when MAX3421E operates at
441 * full speed, but it's talking to a low-speed device (i.e., through a
442 * hub). Setting that bit ensures that every low-speed packet is
443 * preceded by a full-speed PRE PID. Possible configurations:
445 * Hub speed: Device speed: => LOWSPEED bit: HUBPRE bit:
452 max3421_set_speed(struct usb_hcd *hcd, struct usb_device *dev)
454 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
455 u8 mode_lowspeed, mode_hubpre, mode = max3421_hcd->mode;
457 mode_lowspeed = BIT(MAX3421_MODE_LOWSPEED_BIT);
458 mode_hubpre = BIT(MAX3421_MODE_HUBPRE_BIT);
459 if (max3421_hcd->port_status & USB_PORT_STAT_LOW_SPEED) {
460 mode |= mode_lowspeed;
461 mode &= ~mode_hubpre;
462 } else if (dev->speed == USB_SPEED_LOW) {
463 mode |= mode_lowspeed | mode_hubpre;
465 mode &= ~(mode_lowspeed | mode_hubpre);
467 if (mode != max3421_hcd->mode) {
468 max3421_hcd->mode = mode;
469 spi_wr8(hcd, MAX3421_REG_MODE, max3421_hcd->mode);
475 * Caller must NOT hold HCD spinlock.
478 max3421_set_address(struct usb_hcd *hcd, struct usb_device *dev, int epnum,
481 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
482 int old_epnum, same_ep, rcvtog, sndtog;
483 struct usb_device *old_dev;
486 old_dev = max3421_hcd->loaded_dev;
487 old_epnum = max3421_hcd->loaded_epnum;
489 same_ep = (dev == old_dev && epnum == old_epnum);
490 if (same_ep && !force_toggles)
493 if (old_dev && !same_ep) {
494 /* save the old end-points toggles: */
495 u8 hrsl = spi_rd8(hcd, MAX3421_REG_HRSL);
497 rcvtog = (hrsl >> MAX3421_HRSL_RCVTOGRD_BIT) & 1;
498 sndtog = (hrsl >> MAX3421_HRSL_SNDTOGRD_BIT) & 1;
500 /* no locking: HCD (i.e., we) own toggles, don't we? */
501 usb_settoggle(old_dev, old_epnum, 0, rcvtog);
502 usb_settoggle(old_dev, old_epnum, 1, sndtog);
504 /* setup new endpoint's toggle bits: */
505 rcvtog = usb_gettoggle(dev, epnum, 0);
506 sndtog = usb_gettoggle(dev, epnum, 1);
507 hctl = (BIT(rcvtog + MAX3421_HCTL_RCVTOG0_BIT) |
508 BIT(sndtog + MAX3421_HCTL_SNDTOG0_BIT));
510 max3421_hcd->loaded_epnum = epnum;
511 spi_wr8(hcd, MAX3421_REG_HCTL, hctl);
514 * Note: devnum for one and the same device can change during
515 * address-assignment so it's best to just always load the
516 * address whenever the end-point changed/was forced.
518 max3421_hcd->loaded_dev = dev;
519 spi_wr8(hcd, MAX3421_REG_PERADDR, dev->devnum);
523 max3421_ctrl_setup(struct usb_hcd *hcd, struct urb *urb)
525 spi_wr_buf(hcd, MAX3421_REG_SUDFIFO, urb->setup_packet, 8);
526 return MAX3421_HXFR_SETUP;
530 max3421_transfer_in(struct usb_hcd *hcd, struct urb *urb)
532 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
533 int epnum = usb_pipeendpoint(urb->pipe);
535 max3421_hcd->curr_len = 0;
536 max3421_hcd->hien |= BIT(MAX3421_HI_RCVDAV_BIT);
537 return MAX3421_HXFR_BULK_IN(epnum);
541 max3421_transfer_out(struct usb_hcd *hcd, struct urb *urb, int fast_retransmit)
543 struct spi_device *spi = to_spi_device(hcd->self.controller);
544 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
545 int epnum = usb_pipeendpoint(urb->pipe);
549 src = urb->transfer_buffer + urb->actual_length;
551 if (fast_retransmit) {
552 if (max3421_hcd->rev == 0x12) {
553 /* work around rev 0x12 bug: */
554 spi_wr8(hcd, MAX3421_REG_SNDBC, 0);
555 spi_wr8(hcd, MAX3421_REG_SNDFIFO, ((u8 *) src)[0]);
556 spi_wr8(hcd, MAX3421_REG_SNDBC, max3421_hcd->curr_len);
558 return MAX3421_HXFR_BULK_OUT(epnum);
561 max_packet = usb_maxpacket(urb->dev, urb->pipe, 1);
563 if (max_packet > MAX3421_FIFO_SIZE) {
565 * We do not support isochronous transfers at this
569 "%s: packet-size of %u too big (limit is %u bytes)",
570 __func__, max_packet, MAX3421_FIFO_SIZE);
571 max3421_hcd->urb_done = -EMSGSIZE;
574 max3421_hcd->curr_len = min((urb->transfer_buffer_length -
575 urb->actual_length), max_packet);
577 spi_wr_buf(hcd, MAX3421_REG_SNDFIFO, src, max3421_hcd->curr_len);
578 spi_wr8(hcd, MAX3421_REG_SNDBC, max3421_hcd->curr_len);
579 return MAX3421_HXFR_BULK_OUT(epnum);
583 * Issue the next host-transfer command.
584 * Caller must NOT hold HCD spinlock.
587 max3421_next_transfer(struct usb_hcd *hcd, int fast_retransmit)
589 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
590 struct urb *urb = max3421_hcd->curr_urb;
591 struct max3421_ep *max3421_ep;
595 return; /* nothing to do */
597 max3421_ep = urb->ep->hcpriv;
599 switch (max3421_ep->pkt_state) {
600 case PKT_STATE_SETUP:
601 cmd = max3421_ctrl_setup(hcd, urb);
604 case PKT_STATE_TRANSFER:
605 if (usb_urb_dir_in(urb))
606 cmd = max3421_transfer_in(hcd, urb);
608 cmd = max3421_transfer_out(hcd, urb, fast_retransmit);
611 case PKT_STATE_TERMINATE:
613 * IN transfers are terminated with HS_OUT token,
614 * OUT transfers with HS_IN:
616 if (usb_urb_dir_in(urb))
617 cmd = MAX3421_HXFR_HS_OUT;
619 cmd = MAX3421_HXFR_HS_IN;
626 /* issue the command and wait for host-xfer-done interrupt: */
628 spi_wr8(hcd, MAX3421_REG_HXFR, cmd);
629 max3421_hcd->hien |= BIT(MAX3421_HI_HXFRDN_BIT);
633 * Find the next URB to process and start its execution.
635 * At this time, we do not anticipate ever connecting a USB hub to the
636 * MAX3421 chip, so at most USB device can be connected and we can use
637 * a simplistic scheduler: at the start of a frame, schedule all
638 * periodic transfers. Once that is done, use the remainder of the
639 * frame to process non-periodic (bulk & control) transfers.
642 * o Caller must NOT hold HCD spinlock.
643 * o max3421_hcd->curr_urb MUST BE NULL.
644 * o MAX3421E chip must be idle.
647 max3421_select_and_start_urb(struct usb_hcd *hcd)
649 struct spi_device *spi = to_spi_device(hcd->self.controller);
650 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
651 struct urb *urb, *curr_urb = NULL;
652 struct max3421_ep *max3421_ep;
653 int epnum, force_toggles = 0;
654 struct usb_host_endpoint *ep;
655 struct list_head *pos;
658 spin_lock_irqsave(&max3421_hcd->lock, flags);
661 max3421_hcd->sched_pass < SCHED_PASS_DONE;
662 ++max3421_hcd->sched_pass)
663 list_for_each(pos, &max3421_hcd->ep_list) {
665 max3421_ep = container_of(pos, struct max3421_ep,
669 switch (usb_endpoint_type(&ep->desc)) {
670 case USB_ENDPOINT_XFER_ISOC:
671 case USB_ENDPOINT_XFER_INT:
672 if (max3421_hcd->sched_pass !=
677 case USB_ENDPOINT_XFER_CONTROL:
678 case USB_ENDPOINT_XFER_BULK:
679 if (max3421_hcd->sched_pass !=
680 SCHED_PASS_NON_PERIODIC)
685 if (list_empty(&ep->urb_list))
686 continue; /* nothing to do */
687 urb = list_first_entry(&ep->urb_list, struct urb,
690 dev_dbg(&spi->dev, "%s: URB %p unlinked=%d",
691 __func__, urb, urb->unlinked);
692 max3421_hcd->curr_urb = urb;
693 max3421_hcd->urb_done = 1;
694 spin_unlock_irqrestore(&max3421_hcd->lock,
699 switch (usb_endpoint_type(&ep->desc)) {
700 case USB_ENDPOINT_XFER_CONTROL:
702 * Allow one control transaction per
703 * frame per endpoint:
705 if (frame_diff(max3421_ep->last_active,
706 max3421_hcd->frame_number) == 0)
710 case USB_ENDPOINT_XFER_BULK:
711 if (max3421_ep->retransmit
712 && (frame_diff(max3421_ep->last_active,
713 max3421_hcd->frame_number)
716 * We already tried this EP
717 * during this frame and got a
718 * NAK or error; wait for next frame
723 case USB_ENDPOINT_XFER_ISOC:
724 case USB_ENDPOINT_XFER_INT:
725 if (frame_diff(max3421_hcd->frame_number,
726 max3421_ep->last_active)
729 * We already processed this
730 * end-point in the current
737 /* move current ep to tail: */
738 list_move_tail(pos, &max3421_hcd->ep_list);
744 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
748 urb = max3421_hcd->curr_urb = curr_urb;
749 epnum = usb_endpoint_num(&urb->ep->desc);
750 if (max3421_ep->retransmit)
751 /* restart (part of) a USB transaction: */
752 max3421_ep->retransmit = 0;
754 /* start USB transaction: */
755 if (usb_endpoint_xfer_control(&ep->desc)) {
757 * See USB 2.0 spec section 8.6.1
758 * Initialization via SETUP Token:
760 usb_settoggle(urb->dev, epnum, 0, 1);
761 usb_settoggle(urb->dev, epnum, 1, 1);
762 max3421_ep->pkt_state = PKT_STATE_SETUP;
765 max3421_ep->pkt_state = PKT_STATE_TRANSFER;
768 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
770 max3421_ep->last_active = max3421_hcd->frame_number;
771 max3421_set_address(hcd, urb->dev, epnum, force_toggles);
772 max3421_set_speed(hcd, urb->dev);
773 max3421_next_transfer(hcd, 0);
778 * Check all endpoints for URBs that got unlinked.
780 * Caller must NOT hold HCD spinlock.
783 max3421_check_unlink(struct usb_hcd *hcd)
785 struct spi_device *spi = to_spi_device(hcd->self.controller);
786 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
787 struct list_head *pos, *upos, *next_upos;
788 struct max3421_ep *max3421_ep;
789 struct usb_host_endpoint *ep;
794 spin_lock_irqsave(&max3421_hcd->lock, flags);
795 list_for_each(pos, &max3421_hcd->ep_list) {
796 max3421_ep = container_of(pos, struct max3421_ep, ep_list);
798 list_for_each_safe(upos, next_upos, &ep->urb_list) {
799 urb = container_of(upos, struct urb, urb_list);
802 dev_dbg(&spi->dev, "%s: URB %p unlinked=%d",
803 __func__, urb, urb->unlinked);
804 usb_hcd_unlink_urb_from_ep(hcd, urb);
805 spin_unlock_irqrestore(&max3421_hcd->lock,
807 usb_hcd_giveback_urb(hcd, urb, 0);
808 spin_lock_irqsave(&max3421_hcd->lock, flags);
812 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
817 * Caller must NOT hold HCD spinlock.
820 max3421_slow_retransmit(struct usb_hcd *hcd)
822 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
823 struct urb *urb = max3421_hcd->curr_urb;
824 struct max3421_ep *max3421_ep;
826 max3421_ep = urb->ep->hcpriv;
827 max3421_ep->retransmit = 1;
828 max3421_hcd->curr_urb = NULL;
832 * Caller must NOT hold HCD spinlock.
835 max3421_recv_data_available(struct usb_hcd *hcd)
837 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
838 struct urb *urb = max3421_hcd->curr_urb;
839 size_t remaining, transfer_size;
842 rcvbc = spi_rd8(hcd, MAX3421_REG_RCVBC);
844 if (rcvbc > MAX3421_FIFO_SIZE)
845 rcvbc = MAX3421_FIFO_SIZE;
846 if (urb->actual_length >= urb->transfer_buffer_length)
849 remaining = urb->transfer_buffer_length - urb->actual_length;
850 transfer_size = rcvbc;
851 if (transfer_size > remaining)
852 transfer_size = remaining;
853 if (transfer_size > 0) {
854 void *dst = urb->transfer_buffer + urb->actual_length;
856 spi_rd_buf(hcd, MAX3421_REG_RCVFIFO, dst, transfer_size);
857 urb->actual_length += transfer_size;
858 max3421_hcd->curr_len = transfer_size;
861 /* ack the RCVDAV irq now that the FIFO has been read: */
862 spi_wr8(hcd, MAX3421_REG_HIRQ, BIT(MAX3421_HI_RCVDAV_BIT));
866 max3421_handle_error(struct usb_hcd *hcd, u8 hrsl)
868 struct spi_device *spi = to_spi_device(hcd->self.controller);
869 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
870 u8 result_code = hrsl & MAX3421_HRSL_RESULT_MASK;
871 struct urb *urb = max3421_hcd->curr_urb;
872 struct max3421_ep *max3421_ep = urb->ep->hcpriv;
876 * If an OUT command results in any response other than OK
877 * (i.e., error or NAK), we have to perform a dummy-write to
878 * SNDBC so the FIFO gets switched back to us. Otherwise, we
879 * get out of sync with the SNDFIFO double buffer.
881 switch_sndfifo = (max3421_ep->pkt_state == PKT_STATE_TRANSFER &&
882 usb_urb_dir_out(urb));
884 switch (result_code) {
885 case MAX3421_HRSL_OK:
886 return; /* this shouldn't happen */
888 case MAX3421_HRSL_WRONGPID: /* received wrong PID */
889 case MAX3421_HRSL_BUSY: /* SIE busy */
890 case MAX3421_HRSL_BADREQ: /* bad val in HXFR */
891 case MAX3421_HRSL_UNDEF: /* reserved */
892 case MAX3421_HRSL_KERR: /* K-state instead of response */
893 case MAX3421_HRSL_JERR: /* J-state instead of response */
895 * packet experienced an error that we cannot recover
898 max3421_hcd->urb_done = hrsl_to_error[result_code];
899 dev_dbg(&spi->dev, "%s: unexpected error HRSL=0x%02x",
903 case MAX3421_HRSL_TOGERR:
904 if (usb_urb_dir_in(urb))
905 ; /* don't do anything (device will switch toggle) */
907 /* flip the send toggle bit: */
908 int sndtog = (hrsl >> MAX3421_HRSL_SNDTOGRD_BIT) & 1;
911 spi_wr8(hcd, MAX3421_REG_HCTL,
912 BIT(sndtog + MAX3421_HCTL_SNDTOG0_BIT));
915 case MAX3421_HRSL_BADBC: /* bad byte count */
916 case MAX3421_HRSL_PIDERR: /* received PID is corrupted */
917 case MAX3421_HRSL_PKTERR: /* packet error (stuff, EOP) */
918 case MAX3421_HRSL_CRCERR: /* CRC error */
919 case MAX3421_HRSL_BABBLE: /* device talked too long */
920 case MAX3421_HRSL_TIMEOUT:
921 if (max3421_ep->retries++ < USB_MAX_RETRIES)
922 /* retry the packet again in the next frame */
923 max3421_slow_retransmit(hcd);
925 /* Based on ohci.h cc_to_err[]: */
926 max3421_hcd->urb_done = hrsl_to_error[result_code];
927 dev_dbg(&spi->dev, "%s: unexpected error HRSL=0x%02x",
932 case MAX3421_HRSL_STALL:
933 dev_dbg(&spi->dev, "%s: unexpected error HRSL=0x%02x",
935 max3421_hcd->urb_done = hrsl_to_error[result_code];
938 case MAX3421_HRSL_NAK:
940 * Device wasn't ready for data or has no data
941 * available: retry the packet again.
943 if (max3421_ep->naks++ < NAK_MAX_FAST_RETRANSMITS) {
944 max3421_next_transfer(hcd, 1);
947 max3421_slow_retransmit(hcd);
951 spi_wr8(hcd, MAX3421_REG_SNDBC, 0);
955 * Caller must NOT hold HCD spinlock.
958 max3421_transfer_in_done(struct usb_hcd *hcd, struct urb *urb)
960 struct spi_device *spi = to_spi_device(hcd->self.controller);
961 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
964 if (urb->actual_length >= urb->transfer_buffer_length)
965 return 1; /* read is complete, so we're done */
968 * USB 2.0 Section 5.3.2 Pipes: packets must be full size
969 * except for last one.
971 max_packet = usb_maxpacket(urb->dev, urb->pipe, 0);
972 if (max_packet > MAX3421_FIFO_SIZE) {
974 * We do not support isochronous transfers at this
978 "%s: packet-size of %u too big (limit is %u bytes)",
979 __func__, max_packet, MAX3421_FIFO_SIZE);
983 if (max3421_hcd->curr_len < max_packet) {
984 if (urb->transfer_flags & URB_SHORT_NOT_OK) {
986 * remaining > 0 and received an
987 * unexpected partial packet ->
992 /* short read, but it's OK */
995 return 0; /* not done */
999 * Caller must NOT hold HCD spinlock.
1002 max3421_transfer_out_done(struct usb_hcd *hcd, struct urb *urb)
1004 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1006 urb->actual_length += max3421_hcd->curr_len;
1007 if (urb->actual_length < urb->transfer_buffer_length)
1009 if (urb->transfer_flags & URB_ZERO_PACKET) {
1011 * Some hardware needs a zero-size packet at the end
1012 * of a bulk-out transfer if the last transfer was a
1013 * full-sized packet (i.e., such hardware use <
1014 * max_packet as an indicator that the end of the
1015 * packet has been reached).
1017 u32 max_packet = usb_maxpacket(urb->dev, urb->pipe, 1);
1019 if (max3421_hcd->curr_len == max_packet)
1026 * Caller must NOT hold HCD spinlock.
1029 max3421_host_transfer_done(struct usb_hcd *hcd)
1031 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1032 struct urb *urb = max3421_hcd->curr_urb;
1033 struct max3421_ep *max3421_ep;
1034 u8 result_code, hrsl;
1037 max3421_hcd->hien &= ~(BIT(MAX3421_HI_HXFRDN_BIT) |
1038 BIT(MAX3421_HI_RCVDAV_BIT));
1040 hrsl = spi_rd8(hcd, MAX3421_REG_HRSL);
1041 result_code = hrsl & MAX3421_HRSL_RESULT_MASK;
1044 ++max3421_hcd->err_stat[result_code];
1047 max3421_ep = urb->ep->hcpriv;
1049 if (unlikely(result_code != MAX3421_HRSL_OK)) {
1050 max3421_handle_error(hcd, hrsl);
1054 max3421_ep->naks = 0;
1055 max3421_ep->retries = 0;
1056 switch (max3421_ep->pkt_state) {
1058 case PKT_STATE_SETUP:
1059 if (urb->transfer_buffer_length > 0)
1060 max3421_ep->pkt_state = PKT_STATE_TRANSFER;
1062 max3421_ep->pkt_state = PKT_STATE_TERMINATE;
1065 case PKT_STATE_TRANSFER:
1066 if (usb_urb_dir_in(urb))
1067 urb_done = max3421_transfer_in_done(hcd, urb);
1069 urb_done = max3421_transfer_out_done(hcd, urb);
1070 if (urb_done > 0 && usb_pipetype(urb->pipe) == PIPE_CONTROL) {
1072 * We aren't really done - we still need to
1073 * terminate the control transfer:
1075 max3421_hcd->urb_done = urb_done = 0;
1076 max3421_ep->pkt_state = PKT_STATE_TERMINATE;
1080 case PKT_STATE_TERMINATE:
1086 max3421_hcd->urb_done = urb_done;
1088 max3421_next_transfer(hcd, 0);
1092 * Caller must NOT hold HCD spinlock.
1095 max3421_detect_conn(struct usb_hcd *hcd)
1097 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1098 unsigned int jk, have_conn = 0;
1099 u32 old_port_status, chg;
1100 unsigned long flags;
1103 hrsl = spi_rd8(hcd, MAX3421_REG_HRSL);
1105 jk = ((((hrsl >> MAX3421_HRSL_JSTATUS_BIT) & 1) << 0) |
1106 (((hrsl >> MAX3421_HRSL_KSTATUS_BIT) & 1) << 1));
1108 mode = max3421_hcd->mode;
1111 case 0x0: /* SE0: disconnect */
1113 * Turn off SOFKAENAB bit to avoid getting interrupt
1114 * every milli-second:
1116 mode &= ~BIT(MAX3421_MODE_SOFKAENAB_BIT);
1119 case 0x1: /* J=0,K=1: low-speed (in full-speed or vice versa) */
1120 case 0x2: /* J=1,K=0: full-speed (in full-speed or vice versa) */
1122 /* need to switch to the other speed: */
1123 mode ^= BIT(MAX3421_MODE_LOWSPEED_BIT);
1124 /* turn on SOFKAENAB bit: */
1125 mode |= BIT(MAX3421_MODE_SOFKAENAB_BIT);
1129 case 0x3: /* illegal */
1133 max3421_hcd->mode = mode;
1134 spi_wr8(hcd, MAX3421_REG_MODE, max3421_hcd->mode);
1136 spin_lock_irqsave(&max3421_hcd->lock, flags);
1137 old_port_status = max3421_hcd->port_status;
1139 max3421_hcd->port_status |= USB_PORT_STAT_CONNECTION;
1141 max3421_hcd->port_status &= ~USB_PORT_STAT_CONNECTION;
1142 if (mode & BIT(MAX3421_MODE_LOWSPEED_BIT))
1143 max3421_hcd->port_status |= USB_PORT_STAT_LOW_SPEED;
1145 max3421_hcd->port_status &= ~USB_PORT_STAT_LOW_SPEED;
1146 chg = (old_port_status ^ max3421_hcd->port_status);
1147 max3421_hcd->port_status |= chg << 16;
1148 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
1152 max3421_irq_handler(int irq, void *dev_id)
1154 struct usb_hcd *hcd = dev_id;
1155 struct spi_device *spi = to_spi_device(hcd->self.controller);
1156 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1158 if (max3421_hcd->spi_thread &&
1159 max3421_hcd->spi_thread->state != TASK_RUNNING)
1160 wake_up_process(max3421_hcd->spi_thread);
1161 if (!max3421_hcd->do_enable_irq) {
1162 max3421_hcd->do_enable_irq = 1;
1163 disable_irq_nosync(spi->irq);
1171 dump_eps(struct usb_hcd *hcd)
1173 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1174 struct max3421_ep *max3421_ep;
1175 struct usb_host_endpoint *ep;
1176 struct list_head *pos, *upos;
1177 char ubuf[512], *dp, *end;
1178 unsigned long flags;
1182 spin_lock_irqsave(&max3421_hcd->lock, flags);
1183 list_for_each(pos, &max3421_hcd->ep_list) {
1184 max3421_ep = container_of(pos, struct max3421_ep, ep_list);
1185 ep = max3421_ep->ep;
1188 end = dp + sizeof(ubuf);
1190 list_for_each(upos, &ep->urb_list) {
1191 urb = container_of(upos, struct urb, urb_list);
1192 ret = snprintf(dp, end - dp, " %p(%d.%s %d/%d)", urb,
1193 usb_pipetype(urb->pipe),
1194 usb_urb_dir_in(urb) ? "IN" : "OUT",
1196 urb->transfer_buffer_length);
1197 if (ret < 0 || ret >= end - dp)
1198 break; /* error or buffer full */
1202 epnum = usb_endpoint_num(&ep->desc);
1203 pr_info("EP%0u %u lst %04u rtr %u nak %6u rxmt %u: %s\n",
1204 epnum, max3421_ep->pkt_state, max3421_ep->last_active,
1205 max3421_ep->retries, max3421_ep->naks,
1206 max3421_ep->retransmit, ubuf);
1208 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
1213 /* Return zero if no work was performed, 1 otherwise. */
1215 max3421_handle_irqs(struct usb_hcd *hcd)
1217 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1218 u32 chg, old_port_status;
1219 unsigned long flags;
1223 * Read and ack pending interrupts (CPU must never
1224 * clear SNDBAV directly and RCVDAV must be cleared by
1225 * max3421_recv_data_available()!):
1227 hirq = spi_rd8(hcd, MAX3421_REG_HIRQ);
1228 hirq &= max3421_hcd->hien;
1232 spi_wr8(hcd, MAX3421_REG_HIRQ,
1233 hirq & ~(BIT(MAX3421_HI_SNDBAV_BIT) |
1234 BIT(MAX3421_HI_RCVDAV_BIT)));
1236 if (hirq & BIT(MAX3421_HI_FRAME_BIT)) {
1237 max3421_hcd->frame_number = ((max3421_hcd->frame_number + 1)
1238 & USB_MAX_FRAME_NUMBER);
1239 max3421_hcd->sched_pass = SCHED_PASS_PERIODIC;
1242 if (hirq & BIT(MAX3421_HI_RCVDAV_BIT))
1243 max3421_recv_data_available(hcd);
1245 if (hirq & BIT(MAX3421_HI_HXFRDN_BIT))
1246 max3421_host_transfer_done(hcd);
1248 if (hirq & BIT(MAX3421_HI_CONDET_BIT))
1249 max3421_detect_conn(hcd);
1252 * Now process interrupts that may affect HCD state
1253 * other than the end-points:
1255 spin_lock_irqsave(&max3421_hcd->lock, flags);
1257 old_port_status = max3421_hcd->port_status;
1258 if (hirq & BIT(MAX3421_HI_BUSEVENT_BIT)) {
1259 if (max3421_hcd->port_status & USB_PORT_STAT_RESET) {
1260 /* BUSEVENT due to completion of Bus Reset */
1261 max3421_hcd->port_status &= ~USB_PORT_STAT_RESET;
1262 max3421_hcd->port_status |= USB_PORT_STAT_ENABLE;
1264 /* BUSEVENT due to completion of Bus Resume */
1265 pr_info("%s: BUSEVENT Bus Resume Done\n", __func__);
1268 if (hirq & BIT(MAX3421_HI_RWU_BIT))
1269 pr_info("%s: RWU\n", __func__);
1270 if (hirq & BIT(MAX3421_HI_SUSDN_BIT))
1271 pr_info("%s: SUSDN\n", __func__);
1273 chg = (old_port_status ^ max3421_hcd->port_status);
1274 max3421_hcd->port_status |= chg << 16;
1276 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
1280 static unsigned long last_time;
1281 char sbuf[16 * 16], *dp, *end;
1284 if (jiffies - last_time > 5*HZ) {
1286 end = sbuf + sizeof(sbuf);
1288 for (i = 0; i < 16; ++i) {
1289 int ret = snprintf(dp, end - dp, " %lu",
1290 max3421_hcd->err_stat[i]);
1291 if (ret < 0 || ret >= end - dp)
1292 break; /* error or buffer full */
1295 pr_info("%s: hrsl_stats %s\n", __func__, sbuf);
1296 memset(max3421_hcd->err_stat, 0,
1297 sizeof(max3421_hcd->err_stat));
1298 last_time = jiffies;
1308 max3421_reset_hcd(struct usb_hcd *hcd)
1310 struct spi_device *spi = to_spi_device(hcd->self.controller);
1311 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1314 /* perform a chip reset and wait for OSCIRQ signal to appear: */
1315 spi_wr8(hcd, MAX3421_REG_USBCTL, BIT(MAX3421_USBCTL_CHIPRES_BIT));
1317 spi_wr8(hcd, MAX3421_REG_USBCTL, 0);
1320 if (spi_rd8(hcd, MAX3421_REG_USBIRQ)
1321 & BIT(MAX3421_USBIRQ_OSCOKIRQ_BIT))
1323 if (--timeout < 0) {
1325 "timed out waiting for oscillator OK signal");
1332 * Turn on host mode, automatic generation of SOF packets, and
1333 * enable pull-down registers on DM/DP:
1335 max3421_hcd->mode = (BIT(MAX3421_MODE_HOST_BIT) |
1336 BIT(MAX3421_MODE_SOFKAENAB_BIT) |
1337 BIT(MAX3421_MODE_DMPULLDN_BIT) |
1338 BIT(MAX3421_MODE_DPPULLDN_BIT));
1339 spi_wr8(hcd, MAX3421_REG_MODE, max3421_hcd->mode);
1341 /* reset frame-number: */
1342 max3421_hcd->frame_number = USB_MAX_FRAME_NUMBER;
1343 spi_wr8(hcd, MAX3421_REG_HCTL, BIT(MAX3421_HCTL_FRMRST_BIT));
1345 /* sample the state of the D+ and D- lines */
1346 spi_wr8(hcd, MAX3421_REG_HCTL, BIT(MAX3421_HCTL_SAMPLEBUS_BIT));
1347 max3421_detect_conn(hcd);
1349 /* enable frame, connection-detected, and bus-event interrupts: */
1350 max3421_hcd->hien = (BIT(MAX3421_HI_FRAME_BIT) |
1351 BIT(MAX3421_HI_CONDET_BIT) |
1352 BIT(MAX3421_HI_BUSEVENT_BIT));
1353 spi_wr8(hcd, MAX3421_REG_HIEN, max3421_hcd->hien);
1355 /* enable interrupts: */
1356 spi_wr8(hcd, MAX3421_REG_CPUCTL, BIT(MAX3421_CPUCTL_IE_BIT));
1361 max3421_urb_done(struct usb_hcd *hcd)
1363 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1364 unsigned long flags;
1368 status = max3421_hcd->urb_done;
1369 max3421_hcd->urb_done = 0;
1372 urb = max3421_hcd->curr_urb;
1374 max3421_hcd->curr_urb = NULL;
1375 spin_lock_irqsave(&max3421_hcd->lock, flags);
1376 usb_hcd_unlink_urb_from_ep(hcd, urb);
1377 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
1379 /* must be called without the HCD spinlock: */
1380 usb_hcd_giveback_urb(hcd, urb, status);
1386 max3421_spi_thread(void *dev_id)
1388 struct usb_hcd *hcd = dev_id;
1389 struct spi_device *spi = to_spi_device(hcd->self.controller);
1390 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1391 int i, i_worked = 1;
1393 /* set full-duplex SPI mode, low-active interrupt pin: */
1394 spi_wr8(hcd, MAX3421_REG_PINCTL,
1395 (BIT(MAX3421_PINCTL_FDUPSPI_BIT) | /* full-duplex */
1396 BIT(MAX3421_PINCTL_INTLEVEL_BIT))); /* low-active irq */
1398 while (!kthread_should_stop()) {
1399 max3421_hcd->rev = spi_rd8(hcd, MAX3421_REG_REVISION);
1400 if (max3421_hcd->rev == 0x12 || max3421_hcd->rev == 0x13)
1402 dev_err(&spi->dev, "bad rev 0x%02x", max3421_hcd->rev);
1405 dev_info(&spi->dev, "rev 0x%x, SPI clk %dHz, bpw %u, irq %d\n",
1406 max3421_hcd->rev, spi->max_speed_hz, spi->bits_per_word,
1409 while (!kthread_should_stop()) {
1412 * We'll be waiting for wakeups from the hard
1413 * interrupt handler, so now is a good time to
1414 * sync our hien with the chip:
1416 spi_wr8(hcd, MAX3421_REG_HIEN, max3421_hcd->hien);
1418 set_current_state(TASK_INTERRUPTIBLE);
1419 if (max3421_hcd->do_enable_irq) {
1420 max3421_hcd->do_enable_irq = 0;
1421 enable_irq(spi->irq);
1424 __set_current_state(TASK_RUNNING);
1429 if (max3421_hcd->urb_done)
1430 i_worked |= max3421_urb_done(hcd);
1431 else if (max3421_handle_irqs(hcd))
1433 else if (!max3421_hcd->curr_urb)
1434 i_worked |= max3421_select_and_start_urb(hcd);
1436 if (max3421_hcd->do_reset_hcd) {
1437 /* reset the HCD: */
1438 max3421_hcd->do_reset_hcd = 0;
1439 i_worked |= max3421_reset_hcd(hcd);
1441 if (max3421_hcd->do_reset_port) {
1442 /* perform a USB bus reset: */
1443 max3421_hcd->do_reset_port = 0;
1444 spi_wr8(hcd, MAX3421_REG_HCTL,
1445 BIT(MAX3421_HCTL_BUSRST_BIT));
1448 if (max3421_hcd->do_check_unlink) {
1449 max3421_hcd->do_check_unlink = 0;
1450 i_worked |= max3421_check_unlink(hcd);
1452 if (max3421_hcd->do_iopin_update) {
1454 * IOPINS1/IOPINS2 do not auto-increment, so we can't
1457 for (i = 0; i < ARRAY_SIZE(max3421_hcd->iopins); ++i) {
1458 u8 val = spi_rd8(hcd, MAX3421_REG_IOPINS1);
1460 val = ((val & 0xf0) |
1461 (max3421_hcd->iopins[i] & 0x0f));
1462 spi_wr8(hcd, MAX3421_REG_IOPINS1 + i, val);
1463 max3421_hcd->iopins[i] = val;
1465 max3421_hcd->do_iopin_update = 0;
1469 set_current_state(TASK_RUNNING);
1470 dev_info(&spi->dev, "SPI thread exiting");
1475 max3421_reset_port(struct usb_hcd *hcd)
1477 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1479 max3421_hcd->port_status &= ~(USB_PORT_STAT_ENABLE |
1480 USB_PORT_STAT_LOW_SPEED);
1481 max3421_hcd->do_reset_port = 1;
1482 wake_up_process(max3421_hcd->spi_thread);
1487 max3421_reset(struct usb_hcd *hcd)
1489 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1491 hcd->self.sg_tablesize = 0;
1492 hcd->speed = HCD_USB2;
1493 hcd->self.root_hub->speed = USB_SPEED_FULL;
1494 max3421_hcd->do_reset_hcd = 1;
1495 wake_up_process(max3421_hcd->spi_thread);
1500 max3421_start(struct usb_hcd *hcd)
1502 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1504 spin_lock_init(&max3421_hcd->lock);
1505 max3421_hcd->rh_state = MAX3421_RH_RUNNING;
1507 INIT_LIST_HEAD(&max3421_hcd->ep_list);
1509 hcd->power_budget = POWER_BUDGET;
1510 hcd->state = HC_STATE_RUNNING;
1511 hcd->uses_new_polling = 1;
1516 max3421_stop(struct usb_hcd *hcd)
1521 max3421_urb_enqueue(struct usb_hcd *hcd, struct urb *urb, gfp_t mem_flags)
1523 struct spi_device *spi = to_spi_device(hcd->self.controller);
1524 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1525 struct max3421_ep *max3421_ep;
1526 unsigned long flags;
1529 switch (usb_pipetype(urb->pipe)) {
1530 case PIPE_INTERRUPT:
1531 case PIPE_ISOCHRONOUS:
1532 if (urb->interval < 0) {
1534 "%s: interval=%d for intr-/iso-pipe; expected > 0\n",
1535 __func__, urb->interval);
1542 spin_lock_irqsave(&max3421_hcd->lock, flags);
1544 max3421_ep = urb->ep->hcpriv;
1546 /* gets freed in max3421_endpoint_disable: */
1547 max3421_ep = kzalloc(sizeof(struct max3421_ep), mem_flags);
1552 max3421_ep->ep = urb->ep;
1553 max3421_ep->last_active = max3421_hcd->frame_number;
1554 urb->ep->hcpriv = max3421_ep;
1556 list_add_tail(&max3421_ep->ep_list, &max3421_hcd->ep_list);
1559 retval = usb_hcd_link_urb_to_ep(hcd, urb);
1561 /* Since we added to the queue, restart scheduling: */
1562 max3421_hcd->sched_pass = SCHED_PASS_PERIODIC;
1563 wake_up_process(max3421_hcd->spi_thread);
1567 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
1572 max3421_urb_dequeue(struct usb_hcd *hcd, struct urb *urb, int status)
1574 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1575 unsigned long flags;
1578 spin_lock_irqsave(&max3421_hcd->lock, flags);
1581 * This will set urb->unlinked which in turn causes the entry
1582 * to be dropped at the next opportunity.
1584 retval = usb_hcd_check_unlink_urb(hcd, urb, status);
1586 max3421_hcd->do_check_unlink = 1;
1587 wake_up_process(max3421_hcd->spi_thread);
1589 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
1594 max3421_endpoint_disable(struct usb_hcd *hcd, struct usb_host_endpoint *ep)
1596 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1597 unsigned long flags;
1599 spin_lock_irqsave(&max3421_hcd->lock, flags);
1602 struct max3421_ep *max3421_ep = ep->hcpriv;
1604 /* remove myself from the ep_list: */
1605 if (!list_empty(&max3421_ep->ep_list))
1606 list_del(&max3421_ep->ep_list);
1611 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
1615 max3421_get_frame_number(struct usb_hcd *hcd)
1617 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1618 return max3421_hcd->frame_number;
1622 * Should return a non-zero value when any port is undergoing a resume
1623 * transition while the root hub is suspended.
1626 max3421_hub_status_data(struct usb_hcd *hcd, char *buf)
1628 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1629 unsigned long flags;
1632 spin_lock_irqsave(&max3421_hcd->lock, flags);
1633 if (!HCD_HW_ACCESSIBLE(hcd))
1637 if ((max3421_hcd->port_status & PORT_C_MASK) != 0) {
1638 *buf = (1 << 1); /* a hub over-current condition exists */
1639 dev_dbg(hcd->self.controller,
1640 "port status 0x%08x has changes\n",
1641 max3421_hcd->port_status);
1643 if (max3421_hcd->rh_state == MAX3421_RH_SUSPENDED)
1644 usb_hcd_resume_root_hub(hcd);
1647 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
1652 hub_descriptor(struct usb_hub_descriptor *desc)
1654 memset(desc, 0, sizeof(*desc));
1656 * See Table 11-13: Hub Descriptor in USB 2.0 spec.
1658 desc->bDescriptorType = 0x29; /* hub descriptor */
1659 desc->bDescLength = 9;
1660 desc->wHubCharacteristics = cpu_to_le16(0x0001);
1661 desc->bNbrPorts = 1;
1665 * Set the MAX3421E general-purpose output with number PIN_NUMBER to
1666 * VALUE (0 or 1). PIN_NUMBER may be in the range from 1-8. For
1667 * any other value, this function acts as a no-op.
1670 max3421_gpout_set_value(struct usb_hcd *hcd, u8 pin_number, u8 value)
1672 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1679 mask = 1u << pin_number;
1680 idx = pin_number / 4;
1683 max3421_hcd->iopins[idx] |= mask;
1685 max3421_hcd->iopins[idx] &= ~mask;
1686 max3421_hcd->do_iopin_update = 1;
1687 wake_up_process(max3421_hcd->spi_thread);
1691 max3421_hub_control(struct usb_hcd *hcd, u16 type_req, u16 value, u16 index,
1692 char *buf, u16 length)
1694 struct spi_device *spi = to_spi_device(hcd->self.controller);
1695 struct max3421_hcd *max3421_hcd = hcd_to_max3421(hcd);
1696 struct max3421_hcd_platform_data *pdata;
1697 unsigned long flags;
1700 spin_lock_irqsave(&max3421_hcd->lock, flags);
1702 pdata = spi->dev.platform_data;
1705 case ClearHubFeature:
1707 case ClearPortFeature:
1709 case USB_PORT_FEAT_SUSPEND:
1711 case USB_PORT_FEAT_POWER:
1712 dev_dbg(hcd->self.controller, "power-off\n");
1713 max3421_gpout_set_value(hcd, pdata->vbus_gpout, 0);
1716 max3421_hcd->port_status &= ~(1 << value);
1719 case GetHubDescriptor:
1720 hub_descriptor((struct usb_hub_descriptor *) buf);
1723 case DeviceRequest | USB_REQ_GET_DESCRIPTOR:
1724 case GetPortErrorCount:
1730 *(__le32 *) buf = cpu_to_le32(0);
1738 ((__le16 *) buf)[0] = cpu_to_le16(max3421_hcd->port_status);
1739 ((__le16 *) buf)[1] =
1740 cpu_to_le16(max3421_hcd->port_status >> 16);
1747 case SetPortFeature:
1749 case USB_PORT_FEAT_LINK_STATE:
1750 case USB_PORT_FEAT_U1_TIMEOUT:
1751 case USB_PORT_FEAT_U2_TIMEOUT:
1752 case USB_PORT_FEAT_BH_PORT_RESET:
1754 case USB_PORT_FEAT_SUSPEND:
1755 if (max3421_hcd->active)
1756 max3421_hcd->port_status |=
1757 USB_PORT_STAT_SUSPEND;
1759 case USB_PORT_FEAT_POWER:
1760 dev_dbg(hcd->self.controller, "power-on\n");
1761 max3421_hcd->port_status |= USB_PORT_STAT_POWER;
1762 max3421_gpout_set_value(hcd, pdata->vbus_gpout, 1);
1764 case USB_PORT_FEAT_RESET:
1765 max3421_reset_port(hcd);
1768 if ((max3421_hcd->port_status & USB_PORT_STAT_POWER)
1770 max3421_hcd->port_status |= (1 << value);
1775 dev_dbg(hcd->self.controller,
1776 "hub control req%04x v%04x i%04x l%d\n",
1777 type_req, value, index, length);
1778 error: /* "protocol stall" on error */
1782 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
1787 max3421_bus_suspend(struct usb_hcd *hcd)
1793 max3421_bus_resume(struct usb_hcd *hcd)
1799 * The SPI driver already takes care of DMA-mapping/unmapping, so no
1800 * reason to do it twice.
1803 max3421_map_urb_for_dma(struct usb_hcd *hcd, struct urb *urb, gfp_t mem_flags)
1809 max3421_unmap_urb_for_dma(struct usb_hcd *hcd, struct urb *urb)
1813 static struct hc_driver max3421_hcd_desc = {
1814 .description = "max3421",
1815 .product_desc = DRIVER_DESC,
1816 .hcd_priv_size = sizeof(struct max3421_hcd),
1818 .reset = max3421_reset,
1819 .start = max3421_start,
1820 .stop = max3421_stop,
1821 .get_frame_number = max3421_get_frame_number,
1822 .urb_enqueue = max3421_urb_enqueue,
1823 .urb_dequeue = max3421_urb_dequeue,
1824 .map_urb_for_dma = max3421_map_urb_for_dma,
1825 .unmap_urb_for_dma = max3421_unmap_urb_for_dma,
1826 .endpoint_disable = max3421_endpoint_disable,
1827 .hub_status_data = max3421_hub_status_data,
1828 .hub_control = max3421_hub_control,
1829 .bus_suspend = max3421_bus_suspend,
1830 .bus_resume = max3421_bus_resume,
1834 max3421_probe(struct spi_device *spi)
1836 struct max3421_hcd *max3421_hcd;
1837 struct usb_hcd *hcd;
1840 if (spi_setup(spi) < 0) {
1841 dev_err(&spi->dev, "Unable to setup SPI bus");
1845 hcd = usb_create_hcd(&max3421_hcd_desc, &spi->dev,
1846 dev_name(&spi->dev));
1848 dev_err(&spi->dev, "failed to create HCD structure\n");
1851 set_bit(HCD_FLAG_POLL_RH, &hcd->flags);
1852 max3421_hcd = hcd_to_max3421(hcd);
1853 max3421_hcd->next = max3421_hcd_list;
1854 max3421_hcd_list = max3421_hcd;
1855 INIT_LIST_HEAD(&max3421_hcd->ep_list);
1857 max3421_hcd->spi_thread = kthread_run(max3421_spi_thread, hcd,
1858 "max3421_spi_thread");
1859 if (max3421_hcd->spi_thread == ERR_PTR(-ENOMEM)) {
1861 "failed to create SPI thread (out of memory)\n");
1865 retval = usb_add_hcd(hcd, 0, 0);
1867 dev_err(&spi->dev, "failed to add HCD\n");
1872 retval = request_irq(spi->irq, max3421_irq_handler,
1873 IRQF_TRIGGER_LOW, "max3421", hcd);
1876 dev_err(&spi->dev, "failed to request irq %d\n", spi->irq);
1883 max3421_remove(struct spi_device *spi)
1885 struct max3421_hcd *max3421_hcd = NULL, **prev;
1886 struct usb_hcd *hcd = NULL;
1887 unsigned long flags;
1889 for (prev = &max3421_hcd_list; *prev; prev = &(*prev)->next) {
1890 max3421_hcd = *prev;
1891 hcd = max3421_to_hcd(max3421_hcd);
1892 if (hcd->self.controller == &spi->dev)
1896 dev_err(&spi->dev, "no MAX3421 HCD found for SPI device %p\n",
1901 usb_remove_hcd(hcd);
1903 spin_lock_irqsave(&max3421_hcd->lock, flags);
1905 kthread_stop(max3421_hcd->spi_thread);
1906 *prev = max3421_hcd->next;
1908 spin_unlock_irqrestore(&max3421_hcd->lock, flags);
1910 free_irq(spi->irq, hcd);
1916 static struct spi_driver max3421_driver = {
1917 .probe = max3421_probe,
1918 .remove = max3421_remove,
1920 .name = "max3421-hcd",
1921 .owner = THIS_MODULE,
1926 max3421_mod_init(void)
1928 return spi_register_driver(&max3421_driver);
1932 max3421_mod_exit(void)
1934 spi_unregister_driver(&max3421_driver);
1937 module_init(max3421_mod_init);
1938 module_exit(max3421_mod_exit);
1940 MODULE_DESCRIPTION(DRIVER_DESC);
1941 MODULE_AUTHOR("David Mosberger <davidm@egauge.net>");
1942 MODULE_LICENSE("GPL");