1 // SPDX-License-Identifier: GPL-2.0
3 * MAX3421 Host Controller driver for USB.
5 * Author: David Mosberger-Tang <davidm@egauge.net>
7 * (C) Copyright 2014 David Mosberger-Tang <davidm@egauge.net>
9 * MAX3421 is a chip implementing a USB 2.0 Full-/Low-Speed host
10 * controller on a SPI bus.
13 * o MAX3421E datasheet
14 * http://datasheets.maximintegrated.com/en/ds/MAX3421E.pdf
15 * o MAX3421E Programming Guide
16 * http://www.hdl.co.jp/ftpdata/utl-001/AN3785.pdf
17 * o gadget/dummy_hcd.c
18 * For USB HCD implementation.
19 * o Arduino MAX3421 driver
20 * https://github.com/felis/USB_Host_Shield_2.0/blob/master/Usb.cpp
22 * This file is licenced under the GPL v2.
24 * Important note on worst-case (full-speed) packet size constraints
25 * (See USB 2.0 Section 5.6.3 and following):
28 * - isochronous: 1023 bytes
29 * - interrupt: 64 bytes
32 * Since the MAX3421 FIFO size is 64 bytes, we do not have to work about
33 * multi-FIFO writes/reads for a single USB packet *except* for isochronous
34 * transfers. We don't support isochronous transfers at this time, so we
35 * just assume that a USB packet always fits into a single FIFO buffer.
37 * NOTE: The June 2006 version of "MAX3421E Programming Guide"
38 * (AN3785) has conflicting info for the RCVDAVIRQ bit:
40 * The description of RCVDAVIRQ says "The CPU *must* clear
41 * this IRQ bit (by writing a 1 to it) before reading the
44 * However, the earlier section on "Programming BULK-IN
45 * Transfers" says * that:
47 * After the CPU retrieves the data, it clears the
50 * The December 2006 version has been corrected and it consistently
51 * states the second behavior is the correct one.
53 * Synchronous SPI transactions sleep so we can't perform any such
54 * transactions while holding a spin-lock (and/or while interrupts are
55 * masked). To achieve this, all SPI transactions are issued from a
56 * single thread (max3421_spi_thread).
59 #include <linux/jiffies.h>
60 #include <linux/module.h>
61 #include <linux/spi/spi.h>
62 #include <linux/usb.h>
63 #include <linux/usb/hcd.h>
66 #include <linux/platform_data/max3421-hcd.h>
68 #define DRIVER_DESC "MAX3421 USB Host-Controller Driver"
69 #define DRIVER_VERSION "1.0"
71 /* 11-bit counter that wraps around (USB 2.0 Section 8.3.3): */
72 #define USB_MAX_FRAME_NUMBER 0x7ff
73 #define USB_MAX_RETRIES 3 /* # of retries before error is reported */
76 * Max. # of times we're willing to retransmit a request immediately in
77 * resposne to a NAK. Afterwards, we fall back on trying once a frame.
79 #define NAK_MAX_FAST_RETRANSMITS 2
81 #define POWER_BUDGET 500 /* in mA; use 8 for low-power port testing */
83 /* Port-change mask: */
84 #define PORT_C_MASK ((USB_PORT_STAT_C_CONNECTION | \
85 USB_PORT_STAT_C_ENABLE | \
86 USB_PORT_STAT_C_SUSPEND | \
87 USB_PORT_STAT_C_OVERCURRENT | \
88 USB_PORT_STAT_C_RESET) << 16)
90 #define MAX3421_GPOUT_COUNT 8
92 enum max3421_rh_state
{
99 PKT_STATE_SETUP
, /* waiting to send setup packet to ctrl pipe */
100 PKT_STATE_TRANSFER
, /* waiting to xfer transfer_buffer */
101 PKT_STATE_TERMINATE
/* waiting to terminate control transfer */
104 enum scheduling_pass
{
106 SCHED_PASS_NON_PERIODIC
,
110 /* Bit numbers for max3421_hcd->todo: */
119 struct max3421_dma_buf
{
126 struct task_struct
*spi_thread
;
128 struct max3421_hcd
*next
;
130 enum max3421_rh_state rh_state
;
131 /* lower 16 bits contain port status, upper 16 bits the change mask: */
136 struct list_head ep_list
; /* list of EP's with work */
139 * The following are owned by spi_thread (may be accessed by
140 * SPI-thread without acquiring the HCD lock:
142 u8 rev
; /* chip revision */
145 * kmalloc'd buffers guaranteed to be in separate (DMA)
148 struct max3421_dma_buf
*tx
;
149 struct max3421_dma_buf
*rx
;
151 * URB we're currently processing. Must not be reset to NULL
152 * unless MAX3421E chip is idle:
154 struct urb
*curr_urb
;
155 enum scheduling_pass sched_pass
;
156 struct usb_device
*loaded_dev
; /* dev that's loaded into the chip */
157 int loaded_epnum
; /* epnum whose toggles are loaded */
158 int urb_done
; /* > 0 -> no errors, < 0: errno */
165 unsigned long err_stat
[16];
170 struct usb_host_endpoint
*ep
;
171 struct list_head ep_list
;
173 u16 last_active
; /* frame # this ep was last active */
174 enum pkt_state pkt_state
;
176 u8 retransmit
; /* packet needs retransmission */
179 static struct max3421_hcd
*max3421_hcd_list
;
181 #define MAX3421_FIFO_SIZE 64
183 #define MAX3421_SPI_DIR_RD 0 /* read register from MAX3421 */
184 #define MAX3421_SPI_DIR_WR 1 /* write register to MAX3421 */
187 #define MAX3421_SPI_DIR_SHIFT 1
188 #define MAX3421_SPI_REG_SHIFT 3
190 #define MAX3421_REG_RCVFIFO 1
191 #define MAX3421_REG_SNDFIFO 2
192 #define MAX3421_REG_SUDFIFO 4
193 #define MAX3421_REG_RCVBC 6
194 #define MAX3421_REG_SNDBC 7
195 #define MAX3421_REG_USBIRQ 13
196 #define MAX3421_REG_USBIEN 14
197 #define MAX3421_REG_USBCTL 15
198 #define MAX3421_REG_CPUCTL 16
199 #define MAX3421_REG_PINCTL 17
200 #define MAX3421_REG_REVISION 18
201 #define MAX3421_REG_IOPINS1 20
202 #define MAX3421_REG_IOPINS2 21
203 #define MAX3421_REG_GPINIRQ 22
204 #define MAX3421_REG_GPINIEN 23
205 #define MAX3421_REG_GPINPOL 24
206 #define MAX3421_REG_HIRQ 25
207 #define MAX3421_REG_HIEN 26
208 #define MAX3421_REG_MODE 27
209 #define MAX3421_REG_PERADDR 28
210 #define MAX3421_REG_HCTL 29
211 #define MAX3421_REG_HXFR 30
212 #define MAX3421_REG_HRSL 31
215 MAX3421_USBIRQ_OSCOKIRQ_BIT
= 0,
216 MAX3421_USBIRQ_NOVBUSIRQ_BIT
= 5,
217 MAX3421_USBIRQ_VBUSIRQ_BIT
221 MAX3421_CPUCTL_IE_BIT
= 0,
222 MAX3421_CPUCTL_PULSEWID0_BIT
= 6,
223 MAX3421_CPUCTL_PULSEWID1_BIT
227 MAX3421_USBCTL_PWRDOWN_BIT
= 4,
228 MAX3421_USBCTL_CHIPRES_BIT
232 MAX3421_PINCTL_GPXA_BIT
= 0,
233 MAX3421_PINCTL_GPXB_BIT
,
234 MAX3421_PINCTL_POSINT_BIT
,
235 MAX3421_PINCTL_INTLEVEL_BIT
,
236 MAX3421_PINCTL_FDUPSPI_BIT
,
237 MAX3421_PINCTL_EP0INAK_BIT
,
238 MAX3421_PINCTL_EP2INAK_BIT
,
239 MAX3421_PINCTL_EP3INAK_BIT
,
243 MAX3421_HI_BUSEVENT_BIT
= 0, /* bus-reset/-resume */
244 MAX3421_HI_RWU_BIT
, /* remote wakeup */
245 MAX3421_HI_RCVDAV_BIT
, /* receive FIFO data available */
246 MAX3421_HI_SNDBAV_BIT
, /* send buffer available */
247 MAX3421_HI_SUSDN_BIT
, /* suspend operation done */
248 MAX3421_HI_CONDET_BIT
, /* peripheral connect/disconnect */
249 MAX3421_HI_FRAME_BIT
, /* frame generator */
250 MAX3421_HI_HXFRDN_BIT
, /* host transfer done */
254 MAX3421_HCTL_BUSRST_BIT
= 0,
255 MAX3421_HCTL_FRMRST_BIT
,
256 MAX3421_HCTL_SAMPLEBUS_BIT
,
257 MAX3421_HCTL_SIGRSM_BIT
,
258 MAX3421_HCTL_RCVTOG0_BIT
,
259 MAX3421_HCTL_RCVTOG1_BIT
,
260 MAX3421_HCTL_SNDTOG0_BIT
,
261 MAX3421_HCTL_SNDTOG1_BIT
265 MAX3421_MODE_HOST_BIT
= 0,
266 MAX3421_MODE_LOWSPEED_BIT
,
267 MAX3421_MODE_HUBPRE_BIT
,
268 MAX3421_MODE_SOFKAENAB_BIT
,
269 MAX3421_MODE_SEPIRQ_BIT
,
270 MAX3421_MODE_DELAYISO_BIT
,
271 MAX3421_MODE_DMPULLDN_BIT
,
272 MAX3421_MODE_DPPULLDN_BIT
283 MAX3421_HRSL_WRONGPID
,
290 MAX3421_HRSL_TIMEOUT
,
292 MAX3421_HRSL_RESULT_MASK
= 0xf,
293 MAX3421_HRSL_RCVTOGRD_BIT
= 4,
294 MAX3421_HRSL_SNDTOGRD_BIT
,
295 MAX3421_HRSL_KSTATUS_BIT
,
296 MAX3421_HRSL_JSTATUS_BIT
299 /* Return same error-codes as ohci.h:cc_to_error: */
300 static const int hrsl_to_error
[] = {
301 [MAX3421_HRSL_OK
] = 0,
302 [MAX3421_HRSL_BUSY
] = -EINVAL
,
303 [MAX3421_HRSL_BADREQ
] = -EINVAL
,
304 [MAX3421_HRSL_UNDEF
] = -EINVAL
,
305 [MAX3421_HRSL_NAK
] = -EAGAIN
,
306 [MAX3421_HRSL_STALL
] = -EPIPE
,
307 [MAX3421_HRSL_TOGERR
] = -EILSEQ
,
308 [MAX3421_HRSL_WRONGPID
] = -EPROTO
,
309 [MAX3421_HRSL_BADBC
] = -EREMOTEIO
,
310 [MAX3421_HRSL_PIDERR
] = -EPROTO
,
311 [MAX3421_HRSL_PKTERR
] = -EPROTO
,
312 [MAX3421_HRSL_CRCERR
] = -EILSEQ
,
313 [MAX3421_HRSL_KERR
] = -EIO
,
314 [MAX3421_HRSL_JERR
] = -EIO
,
315 [MAX3421_HRSL_TIMEOUT
] = -ETIME
,
316 [MAX3421_HRSL_BABBLE
] = -EOVERFLOW
320 * See http://www.beyondlogic.org/usbnutshell/usb4.shtml#Control for a
321 * reasonable overview of how control transfers use the the IN/OUT
324 #define MAX3421_HXFR_BULK_IN(ep) (0x00 | (ep)) /* bulk or interrupt */
325 #define MAX3421_HXFR_SETUP 0x10
326 #define MAX3421_HXFR_BULK_OUT(ep) (0x20 | (ep)) /* bulk or interrupt */
327 #define MAX3421_HXFR_ISO_IN(ep) (0x40 | (ep))
328 #define MAX3421_HXFR_ISO_OUT(ep) (0x60 | (ep))
329 #define MAX3421_HXFR_HS_IN 0x80 /* handshake in */
330 #define MAX3421_HXFR_HS_OUT 0xa0 /* handshake out */
332 #define field(val, bit) ((val) << (bit))
335 frame_diff(u16 left
, u16 right
)
337 return ((unsigned) (left
- right
)) % (USB_MAX_FRAME_NUMBER
+ 1);
340 static inline struct max3421_hcd
*
341 hcd_to_max3421(struct usb_hcd
*hcd
)
343 return (struct max3421_hcd
*) hcd
->hcd_priv
;
346 static inline struct usb_hcd
*
347 max3421_to_hcd(struct max3421_hcd
*max3421_hcd
)
349 return container_of((void *) max3421_hcd
, struct usb_hcd
, hcd_priv
);
353 spi_rd8(struct usb_hcd
*hcd
, unsigned int reg
)
355 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
356 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
357 struct spi_transfer transfer
;
358 struct spi_message msg
;
360 memset(&transfer
, 0, sizeof(transfer
));
362 spi_message_init(&msg
);
364 max3421_hcd
->tx
->data
[0] =
365 (field(reg
, MAX3421_SPI_REG_SHIFT
) |
366 field(MAX3421_SPI_DIR_RD
, MAX3421_SPI_DIR_SHIFT
));
368 transfer
.tx_buf
= max3421_hcd
->tx
->data
;
369 transfer
.rx_buf
= max3421_hcd
->rx
->data
;
372 spi_message_add_tail(&transfer
, &msg
);
375 return max3421_hcd
->rx
->data
[1];
379 spi_wr8(struct usb_hcd
*hcd
, unsigned int reg
, u8 val
)
381 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
382 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
383 struct spi_transfer transfer
;
384 struct spi_message msg
;
386 memset(&transfer
, 0, sizeof(transfer
));
388 spi_message_init(&msg
);
390 max3421_hcd
->tx
->data
[0] =
391 (field(reg
, MAX3421_SPI_REG_SHIFT
) |
392 field(MAX3421_SPI_DIR_WR
, MAX3421_SPI_DIR_SHIFT
));
393 max3421_hcd
->tx
->data
[1] = val
;
395 transfer
.tx_buf
= max3421_hcd
->tx
->data
;
398 spi_message_add_tail(&transfer
, &msg
);
403 spi_rd_buf(struct usb_hcd
*hcd
, unsigned int reg
, void *buf
, size_t len
)
405 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
406 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
407 struct spi_transfer transfer
[2];
408 struct spi_message msg
;
410 memset(transfer
, 0, sizeof(transfer
));
412 spi_message_init(&msg
);
414 max3421_hcd
->tx
->data
[0] =
415 (field(reg
, MAX3421_SPI_REG_SHIFT
) |
416 field(MAX3421_SPI_DIR_RD
, MAX3421_SPI_DIR_SHIFT
));
417 transfer
[0].tx_buf
= max3421_hcd
->tx
->data
;
420 transfer
[1].rx_buf
= buf
;
421 transfer
[1].len
= len
;
423 spi_message_add_tail(&transfer
[0], &msg
);
424 spi_message_add_tail(&transfer
[1], &msg
);
429 spi_wr_buf(struct usb_hcd
*hcd
, unsigned int reg
, void *buf
, size_t len
)
431 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
432 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
433 struct spi_transfer transfer
[2];
434 struct spi_message msg
;
436 memset(transfer
, 0, sizeof(transfer
));
438 spi_message_init(&msg
);
440 max3421_hcd
->tx
->data
[0] =
441 (field(reg
, MAX3421_SPI_REG_SHIFT
) |
442 field(MAX3421_SPI_DIR_WR
, MAX3421_SPI_DIR_SHIFT
));
444 transfer
[0].tx_buf
= max3421_hcd
->tx
->data
;
447 transfer
[1].tx_buf
= buf
;
448 transfer
[1].len
= len
;
450 spi_message_add_tail(&transfer
[0], &msg
);
451 spi_message_add_tail(&transfer
[1], &msg
);
456 * Figure out the correct setting for the LOWSPEED and HUBPRE mode
457 * bits. The HUBPRE bit needs to be set when MAX3421E operates at
458 * full speed, but it's talking to a low-speed device (i.e., through a
459 * hub). Setting that bit ensures that every low-speed packet is
460 * preceded by a full-speed PRE PID. Possible configurations:
462 * Hub speed: Device speed: => LOWSPEED bit: HUBPRE bit:
469 max3421_set_speed(struct usb_hcd
*hcd
, struct usb_device
*dev
)
471 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
472 u8 mode_lowspeed
, mode_hubpre
, mode
= max3421_hcd
->mode
;
474 mode_lowspeed
= BIT(MAX3421_MODE_LOWSPEED_BIT
);
475 mode_hubpre
= BIT(MAX3421_MODE_HUBPRE_BIT
);
476 if (max3421_hcd
->port_status
& USB_PORT_STAT_LOW_SPEED
) {
477 mode
|= mode_lowspeed
;
478 mode
&= ~mode_hubpre
;
479 } else if (dev
->speed
== USB_SPEED_LOW
) {
480 mode
|= mode_lowspeed
| mode_hubpre
;
482 mode
&= ~(mode_lowspeed
| mode_hubpre
);
484 if (mode
!= max3421_hcd
->mode
) {
485 max3421_hcd
->mode
= mode
;
486 spi_wr8(hcd
, MAX3421_REG_MODE
, max3421_hcd
->mode
);
492 * Caller must NOT hold HCD spinlock.
495 max3421_set_address(struct usb_hcd
*hcd
, struct usb_device
*dev
, int epnum
,
498 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
499 int old_epnum
, same_ep
, rcvtog
, sndtog
;
500 struct usb_device
*old_dev
;
503 old_dev
= max3421_hcd
->loaded_dev
;
504 old_epnum
= max3421_hcd
->loaded_epnum
;
506 same_ep
= (dev
== old_dev
&& epnum
== old_epnum
);
507 if (same_ep
&& !force_toggles
)
510 if (old_dev
&& !same_ep
) {
511 /* save the old end-points toggles: */
512 u8 hrsl
= spi_rd8(hcd
, MAX3421_REG_HRSL
);
514 rcvtog
= (hrsl
>> MAX3421_HRSL_RCVTOGRD_BIT
) & 1;
515 sndtog
= (hrsl
>> MAX3421_HRSL_SNDTOGRD_BIT
) & 1;
517 /* no locking: HCD (i.e., we) own toggles, don't we? */
518 usb_settoggle(old_dev
, old_epnum
, 0, rcvtog
);
519 usb_settoggle(old_dev
, old_epnum
, 1, sndtog
);
521 /* setup new endpoint's toggle bits: */
522 rcvtog
= usb_gettoggle(dev
, epnum
, 0);
523 sndtog
= usb_gettoggle(dev
, epnum
, 1);
524 hctl
= (BIT(rcvtog
+ MAX3421_HCTL_RCVTOG0_BIT
) |
525 BIT(sndtog
+ MAX3421_HCTL_SNDTOG0_BIT
));
527 max3421_hcd
->loaded_epnum
= epnum
;
528 spi_wr8(hcd
, MAX3421_REG_HCTL
, hctl
);
531 * Note: devnum for one and the same device can change during
532 * address-assignment so it's best to just always load the
533 * address whenever the end-point changed/was forced.
535 max3421_hcd
->loaded_dev
= dev
;
536 spi_wr8(hcd
, MAX3421_REG_PERADDR
, dev
->devnum
);
540 max3421_ctrl_setup(struct usb_hcd
*hcd
, struct urb
*urb
)
542 spi_wr_buf(hcd
, MAX3421_REG_SUDFIFO
, urb
->setup_packet
, 8);
543 return MAX3421_HXFR_SETUP
;
547 max3421_transfer_in(struct usb_hcd
*hcd
, struct urb
*urb
)
549 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
550 int epnum
= usb_pipeendpoint(urb
->pipe
);
552 max3421_hcd
->curr_len
= 0;
553 max3421_hcd
->hien
|= BIT(MAX3421_HI_RCVDAV_BIT
);
554 return MAX3421_HXFR_BULK_IN(epnum
);
558 max3421_transfer_out(struct usb_hcd
*hcd
, struct urb
*urb
, int fast_retransmit
)
560 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
561 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
562 int epnum
= usb_pipeendpoint(urb
->pipe
);
566 src
= urb
->transfer_buffer
+ urb
->actual_length
;
568 if (fast_retransmit
) {
569 if (max3421_hcd
->rev
== 0x12) {
570 /* work around rev 0x12 bug: */
571 spi_wr8(hcd
, MAX3421_REG_SNDBC
, 0);
572 spi_wr8(hcd
, MAX3421_REG_SNDFIFO
, ((u8
*) src
)[0]);
573 spi_wr8(hcd
, MAX3421_REG_SNDBC
, max3421_hcd
->curr_len
);
575 return MAX3421_HXFR_BULK_OUT(epnum
);
578 max_packet
= usb_maxpacket(urb
->dev
, urb
->pipe
, 1);
580 if (max_packet
> MAX3421_FIFO_SIZE
) {
582 * We do not support isochronous transfers at this
586 "%s: packet-size of %u too big (limit is %u bytes)",
587 __func__
, max_packet
, MAX3421_FIFO_SIZE
);
588 max3421_hcd
->urb_done
= -EMSGSIZE
;
591 max3421_hcd
->curr_len
= min((urb
->transfer_buffer_length
-
592 urb
->actual_length
), max_packet
);
594 spi_wr_buf(hcd
, MAX3421_REG_SNDFIFO
, src
, max3421_hcd
->curr_len
);
595 spi_wr8(hcd
, MAX3421_REG_SNDBC
, max3421_hcd
->curr_len
);
596 return MAX3421_HXFR_BULK_OUT(epnum
);
600 * Issue the next host-transfer command.
601 * Caller must NOT hold HCD spinlock.
604 max3421_next_transfer(struct usb_hcd
*hcd
, int fast_retransmit
)
606 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
607 struct urb
*urb
= max3421_hcd
->curr_urb
;
608 struct max3421_ep
*max3421_ep
;
612 return; /* nothing to do */
614 max3421_ep
= urb
->ep
->hcpriv
;
616 switch (max3421_ep
->pkt_state
) {
617 case PKT_STATE_SETUP
:
618 cmd
= max3421_ctrl_setup(hcd
, urb
);
621 case PKT_STATE_TRANSFER
:
622 if (usb_urb_dir_in(urb
))
623 cmd
= max3421_transfer_in(hcd
, urb
);
625 cmd
= max3421_transfer_out(hcd
, urb
, fast_retransmit
);
628 case PKT_STATE_TERMINATE
:
630 * IN transfers are terminated with HS_OUT token,
631 * OUT transfers with HS_IN:
633 if (usb_urb_dir_in(urb
))
634 cmd
= MAX3421_HXFR_HS_OUT
;
636 cmd
= MAX3421_HXFR_HS_IN
;
643 /* issue the command and wait for host-xfer-done interrupt: */
645 spi_wr8(hcd
, MAX3421_REG_HXFR
, cmd
);
646 max3421_hcd
->hien
|= BIT(MAX3421_HI_HXFRDN_BIT
);
650 * Find the next URB to process and start its execution.
652 * At this time, we do not anticipate ever connecting a USB hub to the
653 * MAX3421 chip, so at most USB device can be connected and we can use
654 * a simplistic scheduler: at the start of a frame, schedule all
655 * periodic transfers. Once that is done, use the remainder of the
656 * frame to process non-periodic (bulk & control) transfers.
659 * o Caller must NOT hold HCD spinlock.
660 * o max3421_hcd->curr_urb MUST BE NULL.
661 * o MAX3421E chip must be idle.
664 max3421_select_and_start_urb(struct usb_hcd
*hcd
)
666 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
667 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
668 struct urb
*urb
, *curr_urb
= NULL
;
669 struct max3421_ep
*max3421_ep
;
670 int epnum
, force_toggles
= 0;
671 struct usb_host_endpoint
*ep
;
672 struct list_head
*pos
;
675 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
678 max3421_hcd
->sched_pass
< SCHED_PASS_DONE
;
679 ++max3421_hcd
->sched_pass
)
680 list_for_each(pos
, &max3421_hcd
->ep_list
) {
682 max3421_ep
= container_of(pos
, struct max3421_ep
,
686 switch (usb_endpoint_type(&ep
->desc
)) {
687 case USB_ENDPOINT_XFER_ISOC
:
688 case USB_ENDPOINT_XFER_INT
:
689 if (max3421_hcd
->sched_pass
!=
694 case USB_ENDPOINT_XFER_CONTROL
:
695 case USB_ENDPOINT_XFER_BULK
:
696 if (max3421_hcd
->sched_pass
!=
697 SCHED_PASS_NON_PERIODIC
)
702 if (list_empty(&ep
->urb_list
))
703 continue; /* nothing to do */
704 urb
= list_first_entry(&ep
->urb_list
, struct urb
,
707 dev_dbg(&spi
->dev
, "%s: URB %p unlinked=%d",
708 __func__
, urb
, urb
->unlinked
);
709 max3421_hcd
->curr_urb
= urb
;
710 max3421_hcd
->urb_done
= 1;
711 spin_unlock_irqrestore(&max3421_hcd
->lock
,
716 switch (usb_endpoint_type(&ep
->desc
)) {
717 case USB_ENDPOINT_XFER_CONTROL
:
719 * Allow one control transaction per
720 * frame per endpoint:
722 if (frame_diff(max3421_ep
->last_active
,
723 max3421_hcd
->frame_number
) == 0)
727 case USB_ENDPOINT_XFER_BULK
:
728 if (max3421_ep
->retransmit
729 && (frame_diff(max3421_ep
->last_active
,
730 max3421_hcd
->frame_number
)
733 * We already tried this EP
734 * during this frame and got a
735 * NAK or error; wait for next frame
740 case USB_ENDPOINT_XFER_ISOC
:
741 case USB_ENDPOINT_XFER_INT
:
742 if (frame_diff(max3421_hcd
->frame_number
,
743 max3421_ep
->last_active
)
746 * We already processed this
747 * end-point in the current
754 /* move current ep to tail: */
755 list_move_tail(pos
, &max3421_hcd
->ep_list
);
761 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
765 urb
= max3421_hcd
->curr_urb
= curr_urb
;
766 epnum
= usb_endpoint_num(&urb
->ep
->desc
);
767 if (max3421_ep
->retransmit
)
768 /* restart (part of) a USB transaction: */
769 max3421_ep
->retransmit
= 0;
771 /* start USB transaction: */
772 if (usb_endpoint_xfer_control(&ep
->desc
)) {
774 * See USB 2.0 spec section 8.6.1
775 * Initialization via SETUP Token:
777 usb_settoggle(urb
->dev
, epnum
, 0, 1);
778 usb_settoggle(urb
->dev
, epnum
, 1, 1);
779 max3421_ep
->pkt_state
= PKT_STATE_SETUP
;
782 max3421_ep
->pkt_state
= PKT_STATE_TRANSFER
;
785 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
787 max3421_ep
->last_active
= max3421_hcd
->frame_number
;
788 max3421_set_address(hcd
, urb
->dev
, epnum
, force_toggles
);
789 max3421_set_speed(hcd
, urb
->dev
);
790 max3421_next_transfer(hcd
, 0);
795 * Check all endpoints for URBs that got unlinked.
797 * Caller must NOT hold HCD spinlock.
800 max3421_check_unlink(struct usb_hcd
*hcd
)
802 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
803 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
804 struct max3421_ep
*max3421_ep
;
805 struct usb_host_endpoint
*ep
;
806 struct urb
*urb
, *next
;
810 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
811 list_for_each_entry(max3421_ep
, &max3421_hcd
->ep_list
, ep_list
) {
813 list_for_each_entry_safe(urb
, next
, &ep
->urb_list
, urb_list
) {
816 dev_dbg(&spi
->dev
, "%s: URB %p unlinked=%d",
817 __func__
, urb
, urb
->unlinked
);
818 usb_hcd_unlink_urb_from_ep(hcd
, urb
);
819 spin_unlock_irqrestore(&max3421_hcd
->lock
,
821 usb_hcd_giveback_urb(hcd
, urb
, 0);
822 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
826 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
831 * Caller must NOT hold HCD spinlock.
834 max3421_slow_retransmit(struct usb_hcd
*hcd
)
836 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
837 struct urb
*urb
= max3421_hcd
->curr_urb
;
838 struct max3421_ep
*max3421_ep
;
840 max3421_ep
= urb
->ep
->hcpriv
;
841 max3421_ep
->retransmit
= 1;
842 max3421_hcd
->curr_urb
= NULL
;
846 * Caller must NOT hold HCD spinlock.
849 max3421_recv_data_available(struct usb_hcd
*hcd
)
851 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
852 struct urb
*urb
= max3421_hcd
->curr_urb
;
853 size_t remaining
, transfer_size
;
856 rcvbc
= spi_rd8(hcd
, MAX3421_REG_RCVBC
);
858 if (rcvbc
> MAX3421_FIFO_SIZE
)
859 rcvbc
= MAX3421_FIFO_SIZE
;
860 if (urb
->actual_length
>= urb
->transfer_buffer_length
)
863 remaining
= urb
->transfer_buffer_length
- urb
->actual_length
;
864 transfer_size
= rcvbc
;
865 if (transfer_size
> remaining
)
866 transfer_size
= remaining
;
867 if (transfer_size
> 0) {
868 void *dst
= urb
->transfer_buffer
+ urb
->actual_length
;
870 spi_rd_buf(hcd
, MAX3421_REG_RCVFIFO
, dst
, transfer_size
);
871 urb
->actual_length
+= transfer_size
;
872 max3421_hcd
->curr_len
= transfer_size
;
875 /* ack the RCVDAV irq now that the FIFO has been read: */
876 spi_wr8(hcd
, MAX3421_REG_HIRQ
, BIT(MAX3421_HI_RCVDAV_BIT
));
880 max3421_handle_error(struct usb_hcd
*hcd
, u8 hrsl
)
882 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
883 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
884 u8 result_code
= hrsl
& MAX3421_HRSL_RESULT_MASK
;
885 struct urb
*urb
= max3421_hcd
->curr_urb
;
886 struct max3421_ep
*max3421_ep
= urb
->ep
->hcpriv
;
890 * If an OUT command results in any response other than OK
891 * (i.e., error or NAK), we have to perform a dummy-write to
892 * SNDBC so the FIFO gets switched back to us. Otherwise, we
893 * get out of sync with the SNDFIFO double buffer.
895 switch_sndfifo
= (max3421_ep
->pkt_state
== PKT_STATE_TRANSFER
&&
896 usb_urb_dir_out(urb
));
898 switch (result_code
) {
899 case MAX3421_HRSL_OK
:
900 return; /* this shouldn't happen */
902 case MAX3421_HRSL_WRONGPID
: /* received wrong PID */
903 case MAX3421_HRSL_BUSY
: /* SIE busy */
904 case MAX3421_HRSL_BADREQ
: /* bad val in HXFR */
905 case MAX3421_HRSL_UNDEF
: /* reserved */
906 case MAX3421_HRSL_KERR
: /* K-state instead of response */
907 case MAX3421_HRSL_JERR
: /* J-state instead of response */
909 * packet experienced an error that we cannot recover
912 max3421_hcd
->urb_done
= hrsl_to_error
[result_code
];
913 dev_dbg(&spi
->dev
, "%s: unexpected error HRSL=0x%02x",
917 case MAX3421_HRSL_TOGERR
:
918 if (usb_urb_dir_in(urb
))
919 ; /* don't do anything (device will switch toggle) */
921 /* flip the send toggle bit: */
922 int sndtog
= (hrsl
>> MAX3421_HRSL_SNDTOGRD_BIT
) & 1;
925 spi_wr8(hcd
, MAX3421_REG_HCTL
,
926 BIT(sndtog
+ MAX3421_HCTL_SNDTOG0_BIT
));
929 case MAX3421_HRSL_BADBC
: /* bad byte count */
930 case MAX3421_HRSL_PIDERR
: /* received PID is corrupted */
931 case MAX3421_HRSL_PKTERR
: /* packet error (stuff, EOP) */
932 case MAX3421_HRSL_CRCERR
: /* CRC error */
933 case MAX3421_HRSL_BABBLE
: /* device talked too long */
934 case MAX3421_HRSL_TIMEOUT
:
935 if (max3421_ep
->retries
++ < USB_MAX_RETRIES
)
936 /* retry the packet again in the next frame */
937 max3421_slow_retransmit(hcd
);
939 /* Based on ohci.h cc_to_err[]: */
940 max3421_hcd
->urb_done
= hrsl_to_error
[result_code
];
941 dev_dbg(&spi
->dev
, "%s: unexpected error HRSL=0x%02x",
946 case MAX3421_HRSL_STALL
:
947 dev_dbg(&spi
->dev
, "%s: unexpected error HRSL=0x%02x",
949 max3421_hcd
->urb_done
= hrsl_to_error
[result_code
];
952 case MAX3421_HRSL_NAK
:
954 * Device wasn't ready for data or has no data
955 * available: retry the packet again.
957 if (max3421_ep
->naks
++ < NAK_MAX_FAST_RETRANSMITS
) {
958 max3421_next_transfer(hcd
, 1);
961 max3421_slow_retransmit(hcd
);
965 spi_wr8(hcd
, MAX3421_REG_SNDBC
, 0);
969 * Caller must NOT hold HCD spinlock.
972 max3421_transfer_in_done(struct usb_hcd
*hcd
, struct urb
*urb
)
974 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
975 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
978 if (urb
->actual_length
>= urb
->transfer_buffer_length
)
979 return 1; /* read is complete, so we're done */
982 * USB 2.0 Section 5.3.2 Pipes: packets must be full size
983 * except for last one.
985 max_packet
= usb_maxpacket(urb
->dev
, urb
->pipe
, 0);
986 if (max_packet
> MAX3421_FIFO_SIZE
) {
988 * We do not support isochronous transfers at this
992 "%s: packet-size of %u too big (limit is %u bytes)",
993 __func__
, max_packet
, MAX3421_FIFO_SIZE
);
997 if (max3421_hcd
->curr_len
< max_packet
) {
998 if (urb
->transfer_flags
& URB_SHORT_NOT_OK
) {
1000 * remaining > 0 and received an
1001 * unexpected partial packet ->
1006 /* short read, but it's OK */
1009 return 0; /* not done */
1013 * Caller must NOT hold HCD spinlock.
1016 max3421_transfer_out_done(struct usb_hcd
*hcd
, struct urb
*urb
)
1018 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1020 urb
->actual_length
+= max3421_hcd
->curr_len
;
1021 if (urb
->actual_length
< urb
->transfer_buffer_length
)
1023 if (urb
->transfer_flags
& URB_ZERO_PACKET
) {
1025 * Some hardware needs a zero-size packet at the end
1026 * of a bulk-out transfer if the last transfer was a
1027 * full-sized packet (i.e., such hardware use <
1028 * max_packet as an indicator that the end of the
1029 * packet has been reached).
1031 u32 max_packet
= usb_maxpacket(urb
->dev
, urb
->pipe
, 1);
1033 if (max3421_hcd
->curr_len
== max_packet
)
1040 * Caller must NOT hold HCD spinlock.
1043 max3421_host_transfer_done(struct usb_hcd
*hcd
)
1045 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1046 struct urb
*urb
= max3421_hcd
->curr_urb
;
1047 struct max3421_ep
*max3421_ep
;
1048 u8 result_code
, hrsl
;
1051 max3421_hcd
->hien
&= ~(BIT(MAX3421_HI_HXFRDN_BIT
) |
1052 BIT(MAX3421_HI_RCVDAV_BIT
));
1054 hrsl
= spi_rd8(hcd
, MAX3421_REG_HRSL
);
1055 result_code
= hrsl
& MAX3421_HRSL_RESULT_MASK
;
1058 ++max3421_hcd
->err_stat
[result_code
];
1061 max3421_ep
= urb
->ep
->hcpriv
;
1063 if (unlikely(result_code
!= MAX3421_HRSL_OK
)) {
1064 max3421_handle_error(hcd
, hrsl
);
1068 max3421_ep
->naks
= 0;
1069 max3421_ep
->retries
= 0;
1070 switch (max3421_ep
->pkt_state
) {
1072 case PKT_STATE_SETUP
:
1073 if (urb
->transfer_buffer_length
> 0)
1074 max3421_ep
->pkt_state
= PKT_STATE_TRANSFER
;
1076 max3421_ep
->pkt_state
= PKT_STATE_TERMINATE
;
1079 case PKT_STATE_TRANSFER
:
1080 if (usb_urb_dir_in(urb
))
1081 urb_done
= max3421_transfer_in_done(hcd
, urb
);
1083 urb_done
= max3421_transfer_out_done(hcd
, urb
);
1084 if (urb_done
> 0 && usb_pipetype(urb
->pipe
) == PIPE_CONTROL
) {
1086 * We aren't really done - we still need to
1087 * terminate the control transfer:
1089 max3421_hcd
->urb_done
= urb_done
= 0;
1090 max3421_ep
->pkt_state
= PKT_STATE_TERMINATE
;
1094 case PKT_STATE_TERMINATE
:
1100 max3421_hcd
->urb_done
= urb_done
;
1102 max3421_next_transfer(hcd
, 0);
1106 * Caller must NOT hold HCD spinlock.
1109 max3421_detect_conn(struct usb_hcd
*hcd
)
1111 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1112 unsigned int jk
, have_conn
= 0;
1113 u32 old_port_status
, chg
;
1114 unsigned long flags
;
1117 hrsl
= spi_rd8(hcd
, MAX3421_REG_HRSL
);
1119 jk
= ((((hrsl
>> MAX3421_HRSL_JSTATUS_BIT
) & 1) << 0) |
1120 (((hrsl
>> MAX3421_HRSL_KSTATUS_BIT
) & 1) << 1));
1122 mode
= max3421_hcd
->mode
;
1125 case 0x0: /* SE0: disconnect */
1127 * Turn off SOFKAENAB bit to avoid getting interrupt
1128 * every milli-second:
1130 mode
&= ~BIT(MAX3421_MODE_SOFKAENAB_BIT
);
1133 case 0x1: /* J=0,K=1: low-speed (in full-speed or vice versa) */
1134 case 0x2: /* J=1,K=0: full-speed (in full-speed or vice versa) */
1136 /* need to switch to the other speed: */
1137 mode
^= BIT(MAX3421_MODE_LOWSPEED_BIT
);
1138 /* turn on SOFKAENAB bit: */
1139 mode
|= BIT(MAX3421_MODE_SOFKAENAB_BIT
);
1143 case 0x3: /* illegal */
1147 max3421_hcd
->mode
= mode
;
1148 spi_wr8(hcd
, MAX3421_REG_MODE
, max3421_hcd
->mode
);
1150 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
1151 old_port_status
= max3421_hcd
->port_status
;
1153 max3421_hcd
->port_status
|= USB_PORT_STAT_CONNECTION
;
1155 max3421_hcd
->port_status
&= ~USB_PORT_STAT_CONNECTION
;
1156 if (mode
& BIT(MAX3421_MODE_LOWSPEED_BIT
))
1157 max3421_hcd
->port_status
|= USB_PORT_STAT_LOW_SPEED
;
1159 max3421_hcd
->port_status
&= ~USB_PORT_STAT_LOW_SPEED
;
1160 chg
= (old_port_status
^ max3421_hcd
->port_status
);
1161 max3421_hcd
->port_status
|= chg
<< 16;
1162 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
1166 max3421_irq_handler(int irq
, void *dev_id
)
1168 struct usb_hcd
*hcd
= dev_id
;
1169 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
1170 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1172 if (max3421_hcd
->spi_thread
&&
1173 max3421_hcd
->spi_thread
->state
!= TASK_RUNNING
)
1174 wake_up_process(max3421_hcd
->spi_thread
);
1175 if (!test_and_set_bit(ENABLE_IRQ
, &max3421_hcd
->todo
))
1176 disable_irq_nosync(spi
->irq
);
1183 dump_eps(struct usb_hcd
*hcd
)
1185 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1186 struct max3421_ep
*max3421_ep
;
1187 struct usb_host_endpoint
*ep
;
1188 char ubuf
[512], *dp
, *end
;
1189 unsigned long flags
;
1193 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
1194 list_for_each_entry(max3421_ep
, &max3421_hcd
->ep_list
, ep_list
) {
1195 ep
= max3421_ep
->ep
;
1198 end
= dp
+ sizeof(ubuf
);
1200 list_for_each_entry(urb
, &ep
->urb_list
, urb_list
) {
1201 ret
= snprintf(dp
, end
- dp
, " %p(%d.%s %d/%d)", urb
,
1202 usb_pipetype(urb
->pipe
),
1203 usb_urb_dir_in(urb
) ? "IN" : "OUT",
1205 urb
->transfer_buffer_length
);
1206 if (ret
< 0 || ret
>= end
- dp
)
1207 break; /* error or buffer full */
1211 epnum
= usb_endpoint_num(&ep
->desc
);
1212 pr_info("EP%0u %u lst %04u rtr %u nak %6u rxmt %u: %s\n",
1213 epnum
, max3421_ep
->pkt_state
, max3421_ep
->last_active
,
1214 max3421_ep
->retries
, max3421_ep
->naks
,
1215 max3421_ep
->retransmit
, ubuf
);
1217 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
1222 /* Return zero if no work was performed, 1 otherwise. */
1224 max3421_handle_irqs(struct usb_hcd
*hcd
)
1226 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1227 u32 chg
, old_port_status
;
1228 unsigned long flags
;
1232 * Read and ack pending interrupts (CPU must never
1233 * clear SNDBAV directly and RCVDAV must be cleared by
1234 * max3421_recv_data_available()!):
1236 hirq
= spi_rd8(hcd
, MAX3421_REG_HIRQ
);
1237 hirq
&= max3421_hcd
->hien
;
1241 spi_wr8(hcd
, MAX3421_REG_HIRQ
,
1242 hirq
& ~(BIT(MAX3421_HI_SNDBAV_BIT
) |
1243 BIT(MAX3421_HI_RCVDAV_BIT
)));
1245 if (hirq
& BIT(MAX3421_HI_FRAME_BIT
)) {
1246 max3421_hcd
->frame_number
= ((max3421_hcd
->frame_number
+ 1)
1247 & USB_MAX_FRAME_NUMBER
);
1248 max3421_hcd
->sched_pass
= SCHED_PASS_PERIODIC
;
1251 if (hirq
& BIT(MAX3421_HI_RCVDAV_BIT
))
1252 max3421_recv_data_available(hcd
);
1254 if (hirq
& BIT(MAX3421_HI_HXFRDN_BIT
))
1255 max3421_host_transfer_done(hcd
);
1257 if (hirq
& BIT(MAX3421_HI_CONDET_BIT
))
1258 max3421_detect_conn(hcd
);
1261 * Now process interrupts that may affect HCD state
1262 * other than the end-points:
1264 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
1266 old_port_status
= max3421_hcd
->port_status
;
1267 if (hirq
& BIT(MAX3421_HI_BUSEVENT_BIT
)) {
1268 if (max3421_hcd
->port_status
& USB_PORT_STAT_RESET
) {
1269 /* BUSEVENT due to completion of Bus Reset */
1270 max3421_hcd
->port_status
&= ~USB_PORT_STAT_RESET
;
1271 max3421_hcd
->port_status
|= USB_PORT_STAT_ENABLE
;
1273 /* BUSEVENT due to completion of Bus Resume */
1274 pr_info("%s: BUSEVENT Bus Resume Done\n", __func__
);
1277 if (hirq
& BIT(MAX3421_HI_RWU_BIT
))
1278 pr_info("%s: RWU\n", __func__
);
1279 if (hirq
& BIT(MAX3421_HI_SUSDN_BIT
))
1280 pr_info("%s: SUSDN\n", __func__
);
1282 chg
= (old_port_status
^ max3421_hcd
->port_status
);
1283 max3421_hcd
->port_status
|= chg
<< 16;
1285 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
1289 static unsigned long last_time
;
1290 char sbuf
[16 * 16], *dp
, *end
;
1293 if (time_after(jiffies
, last_time
+ 5*HZ
)) {
1295 end
= sbuf
+ sizeof(sbuf
);
1297 for (i
= 0; i
< 16; ++i
) {
1298 int ret
= snprintf(dp
, end
- dp
, " %lu",
1299 max3421_hcd
->err_stat
[i
]);
1300 if (ret
< 0 || ret
>= end
- dp
)
1301 break; /* error or buffer full */
1304 pr_info("%s: hrsl_stats %s\n", __func__
, sbuf
);
1305 memset(max3421_hcd
->err_stat
, 0,
1306 sizeof(max3421_hcd
->err_stat
));
1307 last_time
= jiffies
;
1317 max3421_reset_hcd(struct usb_hcd
*hcd
)
1319 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
1320 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1323 /* perform a chip reset and wait for OSCIRQ signal to appear: */
1324 spi_wr8(hcd
, MAX3421_REG_USBCTL
, BIT(MAX3421_USBCTL_CHIPRES_BIT
));
1326 spi_wr8(hcd
, MAX3421_REG_USBCTL
, 0);
1329 if (spi_rd8(hcd
, MAX3421_REG_USBIRQ
)
1330 & BIT(MAX3421_USBIRQ_OSCOKIRQ_BIT
))
1332 if (--timeout
< 0) {
1334 "timed out waiting for oscillator OK signal");
1341 * Turn on host mode, automatic generation of SOF packets, and
1342 * enable pull-down registers on DM/DP:
1344 max3421_hcd
->mode
= (BIT(MAX3421_MODE_HOST_BIT
) |
1345 BIT(MAX3421_MODE_SOFKAENAB_BIT
) |
1346 BIT(MAX3421_MODE_DMPULLDN_BIT
) |
1347 BIT(MAX3421_MODE_DPPULLDN_BIT
));
1348 spi_wr8(hcd
, MAX3421_REG_MODE
, max3421_hcd
->mode
);
1350 /* reset frame-number: */
1351 max3421_hcd
->frame_number
= USB_MAX_FRAME_NUMBER
;
1352 spi_wr8(hcd
, MAX3421_REG_HCTL
, BIT(MAX3421_HCTL_FRMRST_BIT
));
1354 /* sample the state of the D+ and D- lines */
1355 spi_wr8(hcd
, MAX3421_REG_HCTL
, BIT(MAX3421_HCTL_SAMPLEBUS_BIT
));
1356 max3421_detect_conn(hcd
);
1358 /* enable frame, connection-detected, and bus-event interrupts: */
1359 max3421_hcd
->hien
= (BIT(MAX3421_HI_FRAME_BIT
) |
1360 BIT(MAX3421_HI_CONDET_BIT
) |
1361 BIT(MAX3421_HI_BUSEVENT_BIT
));
1362 spi_wr8(hcd
, MAX3421_REG_HIEN
, max3421_hcd
->hien
);
1364 /* enable interrupts: */
1365 spi_wr8(hcd
, MAX3421_REG_CPUCTL
, BIT(MAX3421_CPUCTL_IE_BIT
));
1370 max3421_urb_done(struct usb_hcd
*hcd
)
1372 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1373 unsigned long flags
;
1377 status
= max3421_hcd
->urb_done
;
1378 max3421_hcd
->urb_done
= 0;
1381 urb
= max3421_hcd
->curr_urb
;
1383 max3421_hcd
->curr_urb
= NULL
;
1384 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
1385 usb_hcd_unlink_urb_from_ep(hcd
, urb
);
1386 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
1388 /* must be called without the HCD spinlock: */
1389 usb_hcd_giveback_urb(hcd
, urb
, status
);
1395 max3421_spi_thread(void *dev_id
)
1397 struct usb_hcd
*hcd
= dev_id
;
1398 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
1399 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1400 int i
, i_worked
= 1;
1402 /* set full-duplex SPI mode, low-active interrupt pin: */
1403 spi_wr8(hcd
, MAX3421_REG_PINCTL
,
1404 (BIT(MAX3421_PINCTL_FDUPSPI_BIT
) | /* full-duplex */
1405 BIT(MAX3421_PINCTL_INTLEVEL_BIT
))); /* low-active irq */
1407 while (!kthread_should_stop()) {
1408 max3421_hcd
->rev
= spi_rd8(hcd
, MAX3421_REG_REVISION
);
1409 if (max3421_hcd
->rev
== 0x12 || max3421_hcd
->rev
== 0x13)
1411 dev_err(&spi
->dev
, "bad rev 0x%02x", max3421_hcd
->rev
);
1414 dev_info(&spi
->dev
, "rev 0x%x, SPI clk %dHz, bpw %u, irq %d\n",
1415 max3421_hcd
->rev
, spi
->max_speed_hz
, spi
->bits_per_word
,
1418 while (!kthread_should_stop()) {
1421 * We'll be waiting for wakeups from the hard
1422 * interrupt handler, so now is a good time to
1423 * sync our hien with the chip:
1425 spi_wr8(hcd
, MAX3421_REG_HIEN
, max3421_hcd
->hien
);
1427 set_current_state(TASK_INTERRUPTIBLE
);
1428 if (test_and_clear_bit(ENABLE_IRQ
, &max3421_hcd
->todo
))
1429 enable_irq(spi
->irq
);
1431 __set_current_state(TASK_RUNNING
);
1436 if (max3421_hcd
->urb_done
)
1437 i_worked
|= max3421_urb_done(hcd
);
1438 else if (max3421_handle_irqs(hcd
))
1440 else if (!max3421_hcd
->curr_urb
)
1441 i_worked
|= max3421_select_and_start_urb(hcd
);
1443 if (test_and_clear_bit(RESET_HCD
, &max3421_hcd
->todo
))
1444 /* reset the HCD: */
1445 i_worked
|= max3421_reset_hcd(hcd
);
1446 if (test_and_clear_bit(RESET_PORT
, &max3421_hcd
->todo
)) {
1447 /* perform a USB bus reset: */
1448 spi_wr8(hcd
, MAX3421_REG_HCTL
,
1449 BIT(MAX3421_HCTL_BUSRST_BIT
));
1452 if (test_and_clear_bit(CHECK_UNLINK
, &max3421_hcd
->todo
))
1453 i_worked
|= max3421_check_unlink(hcd
);
1454 if (test_and_clear_bit(IOPIN_UPDATE
, &max3421_hcd
->todo
)) {
1456 * IOPINS1/IOPINS2 do not auto-increment, so we can't
1459 for (i
= 0; i
< ARRAY_SIZE(max3421_hcd
->iopins
); ++i
) {
1460 u8 val
= spi_rd8(hcd
, MAX3421_REG_IOPINS1
);
1462 val
= ((val
& 0xf0) |
1463 (max3421_hcd
->iopins
[i
] & 0x0f));
1464 spi_wr8(hcd
, MAX3421_REG_IOPINS1
+ i
, val
);
1465 max3421_hcd
->iopins
[i
] = val
;
1470 set_current_state(TASK_RUNNING
);
1471 dev_info(&spi
->dev
, "SPI thread exiting");
1476 max3421_reset_port(struct usb_hcd
*hcd
)
1478 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1480 max3421_hcd
->port_status
&= ~(USB_PORT_STAT_ENABLE
|
1481 USB_PORT_STAT_LOW_SPEED
);
1482 max3421_hcd
->port_status
|= USB_PORT_STAT_RESET
;
1483 set_bit(RESET_PORT
, &max3421_hcd
->todo
);
1484 wake_up_process(max3421_hcd
->spi_thread
);
1489 max3421_reset(struct usb_hcd
*hcd
)
1491 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1493 hcd
->self
.sg_tablesize
= 0;
1494 hcd
->speed
= HCD_USB2
;
1495 hcd
->self
.root_hub
->speed
= USB_SPEED_FULL
;
1496 set_bit(RESET_HCD
, &max3421_hcd
->todo
);
1497 wake_up_process(max3421_hcd
->spi_thread
);
1502 max3421_start(struct usb_hcd
*hcd
)
1504 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1506 spin_lock_init(&max3421_hcd
->lock
);
1507 max3421_hcd
->rh_state
= MAX3421_RH_RUNNING
;
1509 INIT_LIST_HEAD(&max3421_hcd
->ep_list
);
1511 hcd
->power_budget
= POWER_BUDGET
;
1512 hcd
->state
= HC_STATE_RUNNING
;
1513 hcd
->uses_new_polling
= 1;
1518 max3421_stop(struct usb_hcd
*hcd
)
1523 max3421_urb_enqueue(struct usb_hcd
*hcd
, struct urb
*urb
, gfp_t mem_flags
)
1525 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
1526 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1527 struct max3421_ep
*max3421_ep
;
1528 unsigned long flags
;
1531 switch (usb_pipetype(urb
->pipe
)) {
1532 case PIPE_INTERRUPT
:
1533 case PIPE_ISOCHRONOUS
:
1534 if (urb
->interval
< 0) {
1536 "%s: interval=%d for intr-/iso-pipe; expected > 0\n",
1537 __func__
, urb
->interval
);
1544 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
1546 max3421_ep
= urb
->ep
->hcpriv
;
1548 /* gets freed in max3421_endpoint_disable: */
1549 max3421_ep
= kzalloc(sizeof(struct max3421_ep
), GFP_ATOMIC
);
1554 max3421_ep
->ep
= urb
->ep
;
1555 max3421_ep
->last_active
= max3421_hcd
->frame_number
;
1556 urb
->ep
->hcpriv
= max3421_ep
;
1558 list_add_tail(&max3421_ep
->ep_list
, &max3421_hcd
->ep_list
);
1561 retval
= usb_hcd_link_urb_to_ep(hcd
, urb
);
1563 /* Since we added to the queue, restart scheduling: */
1564 max3421_hcd
->sched_pass
= SCHED_PASS_PERIODIC
;
1565 wake_up_process(max3421_hcd
->spi_thread
);
1569 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
1574 max3421_urb_dequeue(struct usb_hcd
*hcd
, struct urb
*urb
, int status
)
1576 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1577 unsigned long flags
;
1580 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
1583 * This will set urb->unlinked which in turn causes the entry
1584 * to be dropped at the next opportunity.
1586 retval
= usb_hcd_check_unlink_urb(hcd
, urb
, status
);
1588 set_bit(CHECK_UNLINK
, &max3421_hcd
->todo
);
1589 wake_up_process(max3421_hcd
->spi_thread
);
1591 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
1596 max3421_endpoint_disable(struct usb_hcd
*hcd
, struct usb_host_endpoint
*ep
)
1598 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1599 unsigned long flags
;
1601 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
1604 struct max3421_ep
*max3421_ep
= ep
->hcpriv
;
1606 /* remove myself from the ep_list: */
1607 if (!list_empty(&max3421_ep
->ep_list
))
1608 list_del(&max3421_ep
->ep_list
);
1613 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
1617 max3421_get_frame_number(struct usb_hcd
*hcd
)
1619 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1620 return max3421_hcd
->frame_number
;
1624 * Should return a non-zero value when any port is undergoing a resume
1625 * transition while the root hub is suspended.
1628 max3421_hub_status_data(struct usb_hcd
*hcd
, char *buf
)
1630 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1631 unsigned long flags
;
1634 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
1635 if (!HCD_HW_ACCESSIBLE(hcd
))
1639 if ((max3421_hcd
->port_status
& PORT_C_MASK
) != 0) {
1640 *buf
= (1 << 1); /* a hub over-current condition exists */
1641 dev_dbg(hcd
->self
.controller
,
1642 "port status 0x%08x has changes\n",
1643 max3421_hcd
->port_status
);
1645 if (max3421_hcd
->rh_state
== MAX3421_RH_SUSPENDED
)
1646 usb_hcd_resume_root_hub(hcd
);
1649 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
1654 hub_descriptor(struct usb_hub_descriptor
*desc
)
1656 memset(desc
, 0, sizeof(*desc
));
1658 * See Table 11-13: Hub Descriptor in USB 2.0 spec.
1660 desc
->bDescriptorType
= USB_DT_HUB
; /* hub descriptor */
1661 desc
->bDescLength
= 9;
1662 desc
->wHubCharacteristics
= cpu_to_le16(HUB_CHAR_INDV_PORT_LPSM
|
1663 HUB_CHAR_COMMON_OCPM
);
1664 desc
->bNbrPorts
= 1;
1668 * Set the MAX3421E general-purpose output with number PIN_NUMBER to
1669 * VALUE (0 or 1). PIN_NUMBER may be in the range from 1-8. For
1670 * any other value, this function acts as a no-op.
1673 max3421_gpout_set_value(struct usb_hcd
*hcd
, u8 pin_number
, u8 value
)
1675 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1679 if (pin_number
>= MAX3421_GPOUT_COUNT
)
1682 mask
= 1u << (pin_number
% 4);
1683 idx
= pin_number
/ 4;
1686 max3421_hcd
->iopins
[idx
] |= mask
;
1688 max3421_hcd
->iopins
[idx
] &= ~mask
;
1689 set_bit(IOPIN_UPDATE
, &max3421_hcd
->todo
);
1690 wake_up_process(max3421_hcd
->spi_thread
);
1694 max3421_hub_control(struct usb_hcd
*hcd
, u16 type_req
, u16 value
, u16 index
,
1695 char *buf
, u16 length
)
1697 struct spi_device
*spi
= to_spi_device(hcd
->self
.controller
);
1698 struct max3421_hcd
*max3421_hcd
= hcd_to_max3421(hcd
);
1699 struct max3421_hcd_platform_data
*pdata
;
1700 unsigned long flags
;
1703 pdata
= spi
->dev
.platform_data
;
1705 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
1708 case ClearHubFeature
:
1710 case ClearPortFeature
:
1712 case USB_PORT_FEAT_SUSPEND
:
1714 case USB_PORT_FEAT_POWER
:
1715 dev_dbg(hcd
->self
.controller
, "power-off\n");
1716 max3421_gpout_set_value(hcd
, pdata
->vbus_gpout
,
1717 !pdata
->vbus_active_level
);
1720 max3421_hcd
->port_status
&= ~(1 << value
);
1723 case GetHubDescriptor
:
1724 hub_descriptor((struct usb_hub_descriptor
*) buf
);
1727 case DeviceRequest
| USB_REQ_GET_DESCRIPTOR
:
1728 case GetPortErrorCount
:
1734 *(__le32
*) buf
= cpu_to_le32(0);
1742 ((__le16
*) buf
)[0] = cpu_to_le16(max3421_hcd
->port_status
);
1743 ((__le16
*) buf
)[1] =
1744 cpu_to_le16(max3421_hcd
->port_status
>> 16);
1751 case SetPortFeature
:
1753 case USB_PORT_FEAT_LINK_STATE
:
1754 case USB_PORT_FEAT_U1_TIMEOUT
:
1755 case USB_PORT_FEAT_U2_TIMEOUT
:
1756 case USB_PORT_FEAT_BH_PORT_RESET
:
1758 case USB_PORT_FEAT_SUSPEND
:
1759 if (max3421_hcd
->active
)
1760 max3421_hcd
->port_status
|=
1761 USB_PORT_STAT_SUSPEND
;
1763 case USB_PORT_FEAT_POWER
:
1764 dev_dbg(hcd
->self
.controller
, "power-on\n");
1765 max3421_hcd
->port_status
|= USB_PORT_STAT_POWER
;
1766 max3421_gpout_set_value(hcd
, pdata
->vbus_gpout
,
1767 pdata
->vbus_active_level
);
1769 case USB_PORT_FEAT_RESET
:
1770 max3421_reset_port(hcd
);
1773 if ((max3421_hcd
->port_status
& USB_PORT_STAT_POWER
)
1775 max3421_hcd
->port_status
|= (1 << value
);
1780 dev_dbg(hcd
->self
.controller
,
1781 "hub control req%04x v%04x i%04x l%d\n",
1782 type_req
, value
, index
, length
);
1783 error
: /* "protocol stall" on error */
1787 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
1792 max3421_bus_suspend(struct usb_hcd
*hcd
)
1798 max3421_bus_resume(struct usb_hcd
*hcd
)
1804 * The SPI driver already takes care of DMA-mapping/unmapping, so no
1805 * reason to do it twice.
1808 max3421_map_urb_for_dma(struct usb_hcd
*hcd
, struct urb
*urb
, gfp_t mem_flags
)
1814 max3421_unmap_urb_for_dma(struct usb_hcd
*hcd
, struct urb
*urb
)
1818 static const struct hc_driver max3421_hcd_desc
= {
1819 .description
= "max3421",
1820 .product_desc
= DRIVER_DESC
,
1821 .hcd_priv_size
= sizeof(struct max3421_hcd
),
1823 .reset
= max3421_reset
,
1824 .start
= max3421_start
,
1825 .stop
= max3421_stop
,
1826 .get_frame_number
= max3421_get_frame_number
,
1827 .urb_enqueue
= max3421_urb_enqueue
,
1828 .urb_dequeue
= max3421_urb_dequeue
,
1829 .map_urb_for_dma
= max3421_map_urb_for_dma
,
1830 .unmap_urb_for_dma
= max3421_unmap_urb_for_dma
,
1831 .endpoint_disable
= max3421_endpoint_disable
,
1832 .hub_status_data
= max3421_hub_status_data
,
1833 .hub_control
= max3421_hub_control
,
1834 .bus_suspend
= max3421_bus_suspend
,
1835 .bus_resume
= max3421_bus_resume
,
1839 max3421_of_vbus_en_pin(struct device
*dev
, struct max3421_hcd_platform_data
*pdata
)
1847 retval
= of_property_read_u32_array(dev
->of_node
, "maxim,vbus-en-pin", value
, 2);
1849 dev_err(dev
, "device tree node property 'maxim,vbus-en-pin' is missing\n");
1852 dev_info(dev
, "property 'maxim,vbus-en-pin' value is <%d %d>\n", value
[0], value
[1]);
1854 pdata
->vbus_gpout
= value
[0];
1855 pdata
->vbus_active_level
= value
[1];
1861 max3421_probe(struct spi_device
*spi
)
1863 struct device
*dev
= &spi
->dev
;
1864 struct max3421_hcd
*max3421_hcd
;
1865 struct usb_hcd
*hcd
= NULL
;
1866 struct max3421_hcd_platform_data
*pdata
= NULL
;
1867 int retval
= -ENOMEM
;
1869 if (spi_setup(spi
) < 0) {
1870 dev_err(&spi
->dev
, "Unable to setup SPI bus");
1875 dev_err(dev
, "Failed to get SPI IRQ");
1879 if (IS_ENABLED(CONFIG_OF
) && dev
->of_node
) {
1880 pdata
= devm_kzalloc(&spi
->dev
, sizeof(*pdata
), GFP_KERNEL
);
1885 retval
= max3421_of_vbus_en_pin(dev
, pdata
);
1889 spi
->dev
.platform_data
= pdata
;
1892 pdata
= spi
->dev
.platform_data
;
1894 dev_err(&spi
->dev
, "driver configuration data is not provided\n");
1898 if (pdata
->vbus_active_level
> 1) {
1899 dev_err(&spi
->dev
, "vbus active level value %d is out of range (0/1)\n", pdata
->vbus_active_level
);
1903 if (pdata
->vbus_gpout
< 1 || pdata
->vbus_gpout
> MAX3421_GPOUT_COUNT
) {
1904 dev_err(&spi
->dev
, "vbus gpout value %d is out of range (1..8)\n", pdata
->vbus_gpout
);
1909 hcd
= usb_create_hcd(&max3421_hcd_desc
, &spi
->dev
,
1910 dev_name(&spi
->dev
));
1912 dev_err(&spi
->dev
, "failed to create HCD structure\n");
1915 set_bit(HCD_FLAG_POLL_RH
, &hcd
->flags
);
1916 max3421_hcd
= hcd_to_max3421(hcd
);
1917 max3421_hcd
->next
= max3421_hcd_list
;
1918 max3421_hcd_list
= max3421_hcd
;
1919 INIT_LIST_HEAD(&max3421_hcd
->ep_list
);
1921 max3421_hcd
->tx
= kmalloc(sizeof(*max3421_hcd
->tx
), GFP_KERNEL
);
1922 if (!max3421_hcd
->tx
)
1924 max3421_hcd
->rx
= kmalloc(sizeof(*max3421_hcd
->rx
), GFP_KERNEL
);
1925 if (!max3421_hcd
->rx
)
1928 max3421_hcd
->spi_thread
= kthread_run(max3421_spi_thread
, hcd
,
1929 "max3421_spi_thread");
1930 if (max3421_hcd
->spi_thread
== ERR_PTR(-ENOMEM
)) {
1932 "failed to create SPI thread (out of memory)\n");
1936 retval
= usb_add_hcd(hcd
, 0, 0);
1938 dev_err(&spi
->dev
, "failed to add HCD\n");
1942 retval
= request_irq(spi
->irq
, max3421_irq_handler
,
1943 IRQF_TRIGGER_LOW
, "max3421", hcd
);
1945 dev_err(&spi
->dev
, "failed to request irq %d\n", spi
->irq
);
1951 if (IS_ENABLED(CONFIG_OF
) && dev
->of_node
&& pdata
) {
1952 devm_kfree(&spi
->dev
, pdata
);
1953 spi
->dev
.platform_data
= NULL
;
1957 kfree(max3421_hcd
->tx
);
1958 kfree(max3421_hcd
->rx
);
1959 if (max3421_hcd
->spi_thread
)
1960 kthread_stop(max3421_hcd
->spi_thread
);
1967 max3421_remove(struct spi_device
*spi
)
1969 struct max3421_hcd
*max3421_hcd
= NULL
, **prev
;
1970 struct usb_hcd
*hcd
= NULL
;
1971 unsigned long flags
;
1973 for (prev
= &max3421_hcd_list
; *prev
; prev
= &(*prev
)->next
) {
1974 max3421_hcd
= *prev
;
1975 hcd
= max3421_to_hcd(max3421_hcd
);
1976 if (hcd
->self
.controller
== &spi
->dev
)
1980 dev_err(&spi
->dev
, "no MAX3421 HCD found for SPI device %p\n",
1985 usb_remove_hcd(hcd
);
1987 spin_lock_irqsave(&max3421_hcd
->lock
, flags
);
1989 kthread_stop(max3421_hcd
->spi_thread
);
1990 *prev
= max3421_hcd
->next
;
1992 spin_unlock_irqrestore(&max3421_hcd
->lock
, flags
);
1994 free_irq(spi
->irq
, hcd
);
2000 static const struct of_device_id max3421_of_match_table
[] = {
2001 { .compatible
= "maxim,max3421", },
2004 MODULE_DEVICE_TABLE(of
, max3421_of_match_table
);
2006 static struct spi_driver max3421_driver
= {
2007 .probe
= max3421_probe
,
2008 .remove
= max3421_remove
,
2010 .name
= "max3421-hcd",
2011 .of_match_table
= of_match_ptr(max3421_of_match_table
),
2015 module_spi_driver(max3421_driver
);
2017 MODULE_DESCRIPTION(DRIVER_DESC
);
2018 MODULE_AUTHOR("David Mosberger <davidm@egauge.net>");
2019 MODULE_LICENSE("GPL");