2 * SL811HS HCD (Host Controller Driver) for USB.
4 * Copyright (C) 2004 Psion Teklogix (for NetBook PRO)
5 * Copyright (C) 2004-2005 David Brownell
7 * Periodic scheduling is based on Roman's OHCI code
8 * Copyright (C) 1999 Roman Weissgaerber
10 * The SL811HS controller handles host side USB (like the SL11H, but with
11 * another register set and SOF generation) as well as peripheral side USB
12 * (like the SL811S). This driver version doesn't implement the Gadget API
13 * for the peripheral role; or OTG (that'd need much external circuitry).
15 * For documentation, see the SL811HS spec and the "SL811HS Embedded Host"
16 * document (providing significant pieces missing from that spec); plus
17 * the SL811S spec if you want peripheral side info.
21 * Status: Passed basic stress testing, works with hubs, mice, keyboards,
25 * - usb suspend/resume triggered by sl811 (with USB_SUSPEND)
26 * - various issues noted in the code
27 * - performance work; use both register banks; ...
28 * - use urb->iso_frame_desc[] with ISO transfers
34 #include <linux/module.h>
35 #include <linux/moduleparam.h>
36 #include <linux/kernel.h>
37 #include <linux/delay.h>
38 #include <linux/ioport.h>
39 #include <linux/sched.h>
40 #include <linux/slab.h>
41 #include <linux/errno.h>
42 #include <linux/init.h>
43 #include <linux/timer.h>
44 #include <linux/list.h>
45 #include <linux/interrupt.h>
46 #include <linux/usb.h>
47 #include <linux/usb/sl811.h>
48 #include <linux/platform_device.h>
52 #include <asm/system.h>
53 #include <asm/byteorder.h>
55 #include "../core/hcd.h"
59 MODULE_DESCRIPTION("SL811HS USB Host Controller Driver");
60 MODULE_LICENSE("GPL");
62 #define DRIVER_VERSION "19 May 2005"
66 # define STUB_DEBUG_FILE
69 /* for now, use only one transfer register bank */
72 /* this doesn't understand urb->iso_frame_desc[], but if you had a driver
73 * that just queued one ISO frame per URB then iso transfers "should" work
74 * using the normal urb status fields.
81 static const char hcd_name
[] = "sl811-hcd";
83 /*-------------------------------------------------------------------------*/
85 static void port_power(struct sl811
*sl811
, int is_on
)
87 struct usb_hcd
*hcd
= sl811_to_hcd(sl811
);
89 /* hub is inactive unless the port is powered */
91 if (sl811
->port1
& (1 << USB_PORT_FEAT_POWER
))
94 sl811
->port1
= (1 << USB_PORT_FEAT_POWER
);
95 sl811
->irq_enable
= SL11H_INTMASK_INSRMV
;
96 hcd
->self
.controller
->power
.power_state
= PMSG_ON
;
99 sl811
->irq_enable
= 0;
100 hcd
->state
= HC_STATE_HALT
;
101 hcd
->self
.controller
->power
.power_state
= PMSG_SUSPEND
;
104 sl811_write(sl811
, SL11H_IRQ_ENABLE
, 0);
105 sl811_write(sl811
, SL11H_IRQ_STATUS
, ~0);
107 if (sl811
->board
&& sl811
->board
->port_power
) {
108 /* switch VBUS, at 500mA unless hub power budget gets set */
109 DBG("power %s\n", is_on
? "on" : "off");
110 sl811
->board
->port_power(hcd
->self
.controller
, is_on
);
113 /* reset as thoroughly as we can */
114 if (sl811
->board
&& sl811
->board
->reset
)
115 sl811
->board
->reset(hcd
->self
.controller
);
117 sl811_write(sl811
, SL11H_CTLREG1
, SL11H_CTL1MASK_SE0
);
121 sl811_write(sl811
, SL11H_IRQ_ENABLE
, 0);
122 sl811_write(sl811
, SL11H_CTLREG1
, sl811
->ctrl1
);
123 sl811_write(sl811
, SL811HS_CTLREG2
, SL811HS_CTL2_INIT
);
124 sl811_write(sl811
, SL11H_IRQ_ENABLE
, sl811
->irq_enable
);
126 // if !is_on, put into lowpower mode now
129 /*-------------------------------------------------------------------------*/
131 /* This is a PIO-only HCD. Queueing appends URBs to the endpoint's queue,
132 * and may start I/O. Endpoint queues are scanned during completion irq
133 * handlers (one per packet: ACK, NAK, faults, etc) and urb cancellation.
135 * Using an external DMA engine to copy a packet at a time could work,
136 * though setup/teardown costs may be too big to make it worthwhile.
139 /* SETUP starts a new control request. Devices are not allowed to
140 * STALL or NAK these; they must cancel any pending control requests.
142 static void setup_packet(
144 struct sl811h_ep
*ep
,
152 void __iomem
*data_reg
;
154 addr
= SL811HS_PACKET_BUF(bank
== 0);
155 len
= sizeof(struct usb_ctrlrequest
);
156 data_reg
= sl811
->data_reg
;
157 sl811_write_buf(sl811
, addr
, urb
->setup_packet
, len
);
159 /* autoincrementing */
160 sl811_write(sl811
, bank
+ SL11H_BUFADDRREG
, addr
);
161 writeb(len
, data_reg
);
162 writeb(SL_SETUP
/* | ep->epnum */, data_reg
);
163 writeb(usb_pipedevice(urb
->pipe
), data_reg
);
165 /* always OUT/data0 */ ;
166 sl811_write(sl811
, bank
+ SL11H_HOSTCTLREG
,
167 control
| SL11H_HCTLMASK_OUT
);
169 PACKET("SETUP qh%p\n", ep
);
172 /* STATUS finishes control requests, often after IN or OUT data packets */
173 static void status_packet(
175 struct sl811h_ep
*ep
,
182 void __iomem
*data_reg
;
184 do_out
= urb
->transfer_buffer_length
&& usb_pipein(urb
->pipe
);
185 data_reg
= sl811
->data_reg
;
187 /* autoincrementing */
188 sl811_write(sl811
, bank
+ SL11H_BUFADDRREG
, 0);
190 writeb((do_out
? SL_OUT
: SL_IN
) /* | ep->epnum */, data_reg
);
191 writeb(usb_pipedevice(urb
->pipe
), data_reg
);
193 /* always data1; sometimes IN */
194 control
|= SL11H_HCTLMASK_TOGGLE
;
196 control
|= SL11H_HCTLMASK_OUT
;
197 sl811_write(sl811
, bank
+ SL11H_HOSTCTLREG
, control
);
199 PACKET("STATUS%s/%s qh%p\n", ep
->nak_count
? "/retry" : "",
200 do_out
? "out" : "in", ep
);
203 /* IN packets can be used with any type of endpoint. here we just
204 * start the transfer, data from the peripheral may arrive later.
205 * urb->iso_frame_desc is currently ignored here...
207 static void in_packet(
209 struct sl811h_ep
*ep
,
217 void __iomem
*data_reg
;
219 /* avoid losing data on overflow */
221 addr
= SL811HS_PACKET_BUF(bank
== 0);
222 if (!(control
& SL11H_HCTLMASK_ISOCH
)
223 && usb_gettoggle(urb
->dev
, ep
->epnum
, 0))
224 control
|= SL11H_HCTLMASK_TOGGLE
;
225 data_reg
= sl811
->data_reg
;
227 /* autoincrementing */
228 sl811_write(sl811
, bank
+ SL11H_BUFADDRREG
, addr
);
229 writeb(len
, data_reg
);
230 writeb(SL_IN
| ep
->epnum
, data_reg
);
231 writeb(usb_pipedevice(urb
->pipe
), data_reg
);
233 sl811_write(sl811
, bank
+ SL11H_HOSTCTLREG
, control
);
234 ep
->length
= min((int)len
,
235 urb
->transfer_buffer_length
- urb
->actual_length
);
236 PACKET("IN%s/%d qh%p len%d\n", ep
->nak_count
? "/retry" : "",
237 !!usb_gettoggle(urb
->dev
, ep
->epnum
, 0), ep
, len
);
240 /* OUT packets can be used with any type of endpoint.
241 * urb->iso_frame_desc is currently ignored here...
243 static void out_packet(
245 struct sl811h_ep
*ep
,
254 void __iomem
*data_reg
;
256 buf
= urb
->transfer_buffer
+ urb
->actual_length
;
259 len
= min((int)ep
->maxpacket
,
260 urb
->transfer_buffer_length
- urb
->actual_length
);
262 if (!(control
& SL11H_HCTLMASK_ISOCH
)
263 && usb_gettoggle(urb
->dev
, ep
->epnum
, 1))
264 control
|= SL11H_HCTLMASK_TOGGLE
;
265 addr
= SL811HS_PACKET_BUF(bank
== 0);
266 data_reg
= sl811
->data_reg
;
268 sl811_write_buf(sl811
, addr
, buf
, len
);
270 /* autoincrementing */
271 sl811_write(sl811
, bank
+ SL11H_BUFADDRREG
, addr
);
272 writeb(len
, data_reg
);
273 writeb(SL_OUT
| ep
->epnum
, data_reg
);
274 writeb(usb_pipedevice(urb
->pipe
), data_reg
);
276 sl811_write(sl811
, bank
+ SL11H_HOSTCTLREG
,
277 control
| SL11H_HCTLMASK_OUT
);
279 PACKET("OUT%s/%d qh%p len%d\n", ep
->nak_count
? "/retry" : "",
280 !!usb_gettoggle(urb
->dev
, ep
->epnum
, 1), ep
, len
);
283 /*-------------------------------------------------------------------------*/
285 /* caller updates on-chip enables later */
287 static inline void sofirq_on(struct sl811
*sl811
)
289 if (sl811
->irq_enable
& SL11H_INTMASK_SOFINTR
)
291 VDBG("sof irq on\n");
292 sl811
->irq_enable
|= SL11H_INTMASK_SOFINTR
;
295 static inline void sofirq_off(struct sl811
*sl811
)
297 if (!(sl811
->irq_enable
& SL11H_INTMASK_SOFINTR
))
299 VDBG("sof irq off\n");
300 sl811
->irq_enable
&= ~SL11H_INTMASK_SOFINTR
;
303 /*-------------------------------------------------------------------------*/
305 /* pick the next endpoint for a transaction, and issue it.
306 * frames start with periodic transfers (after whatever is pending
307 * from the previous frame), and the rest of the time is async
308 * transfers, scheduled round-robin.
310 static struct sl811h_ep
*start(struct sl811
*sl811
, u8 bank
)
312 struct sl811h_ep
*ep
;
317 /* use endpoint at schedule head */
318 if (sl811
->next_periodic
) {
319 ep
= sl811
->next_periodic
;
320 sl811
->next_periodic
= ep
->next
;
322 if (sl811
->next_async
)
323 ep
= sl811
->next_async
;
324 else if (!list_empty(&sl811
->async
))
325 ep
= container_of(sl811
->async
.next
,
326 struct sl811h_ep
, schedule
);
328 /* could set up the first fullspeed periodic
329 * transfer for the next frame ...
335 if ((bank
&& sl811
->active_b
== ep
) || sl811
->active_a
== ep
)
339 if (ep
->schedule
.next
== &sl811
->async
)
340 sl811
->next_async
= NULL
;
342 sl811
->next_async
= container_of(ep
->schedule
.next
,
343 struct sl811h_ep
, schedule
);
346 if (unlikely(list_empty(&ep
->hep
->urb_list
))) {
347 DBG("empty %p queue?\n", ep
);
351 urb
= container_of(ep
->hep
->urb_list
.next
, struct urb
, urb_list
);
352 control
= ep
->defctrl
;
354 /* if this frame doesn't have enough time left to transfer this
355 * packet, wait till the next frame. too-simple algorithm...
357 fclock
= sl811_read(sl811
, SL11H_SOFTMRREG
) << 6;
358 fclock
-= 100; /* setup takes not much time */
359 if (urb
->dev
->speed
== USB_SPEED_LOW
) {
360 if (control
& SL11H_HCTLMASK_PREAMBLE
) {
361 /* also note erratum 1: some hubs won't work */
364 fclock
-= ep
->maxpacket
<< 8;
366 /* erratum 2: AFTERSOF only works for fullspeed */
369 sl811
->stat_overrun
++;
374 fclock
-= 12000 / 19; /* 19 64byte packets/msec */
377 sl811
->stat_overrun
++;
378 control
|= SL11H_HCTLMASK_AFTERSOF
;
380 /* throttle bulk/control irq noise */
381 } else if (ep
->nak_count
)
382 control
|= SL11H_HCTLMASK_AFTERSOF
;
386 switch (ep
->nextpid
) {
388 in_packet(sl811
, ep
, urb
, bank
, control
);
391 out_packet(sl811
, ep
, urb
, bank
, control
);
394 setup_packet(sl811
, ep
, urb
, bank
, control
);
396 case USB_PID_ACK
: /* for control status */
397 status_packet(sl811
, ep
, urb
, bank
, control
);
400 DBG("bad ep%p pid %02x\n", ep
, ep
->nextpid
);
406 #define MIN_JIFFIES ((msecs_to_jiffies(2) > 1) ? msecs_to_jiffies(2) : 2)
408 static inline void start_transfer(struct sl811
*sl811
)
410 if (sl811
->port1
& (1 << USB_PORT_FEAT_SUSPEND
))
412 if (sl811
->active_a
== NULL
) {
413 sl811
->active_a
= start(sl811
, SL811_EP_A(SL811_HOST_BUF
));
414 if (sl811
->active_a
!= NULL
)
415 sl811
->jiffies_a
= jiffies
+ MIN_JIFFIES
;
418 if (sl811
->active_b
== NULL
) {
419 sl811
->active_b
= start(sl811
, SL811_EP_B(SL811_HOST_BUF
));
420 if (sl811
->active_b
!= NULL
)
421 sl811
->jiffies_b
= jiffies
+ MIN_JIFFIES
;
426 static void finish_request(
428 struct sl811h_ep
*ep
,
431 ) __releases(sl811
->lock
) __acquires(sl811
->lock
)
435 if (usb_pipecontrol(urb
->pipe
))
436 ep
->nextpid
= USB_PID_SETUP
;
438 usb_hcd_unlink_urb_from_ep(sl811_to_hcd(sl811
), urb
);
439 spin_unlock(&sl811
->lock
);
440 usb_hcd_giveback_urb(sl811_to_hcd(sl811
), urb
, status
);
441 spin_lock(&sl811
->lock
);
443 /* leave active endpoints in the schedule */
444 if (!list_empty(&ep
->hep
->urb_list
))
447 /* async deschedule? */
448 if (!list_empty(&ep
->schedule
)) {
449 list_del_init(&ep
->schedule
);
450 if (ep
== sl811
->next_async
)
451 sl811
->next_async
= NULL
;
455 /* periodic deschedule */
456 DBG("deschedule qh%d/%p branch %d\n", ep
->period
, ep
, ep
->branch
);
457 for (i
= ep
->branch
; i
< PERIODIC_SIZE
; i
+= ep
->period
) {
458 struct sl811h_ep
*temp
;
459 struct sl811h_ep
**prev
= &sl811
->periodic
[i
];
461 while (*prev
&& ((temp
= *prev
) != ep
))
465 sl811
->load
[i
] -= ep
->load
;
467 ep
->branch
= PERIODIC_SIZE
;
468 sl811
->periodic_count
--;
469 sl811_to_hcd(sl811
)->self
.bandwidth_allocated
470 -= ep
->load
/ ep
->period
;
471 if (ep
== sl811
->next_periodic
)
472 sl811
->next_periodic
= ep
->next
;
474 /* we might turn SOFs back on again for the async schedule */
475 if (sl811
->periodic_count
== 0)
480 done(struct sl811
*sl811
, struct sl811h_ep
*ep
, u8 bank
)
484 int urbstat
= -EINPROGRESS
;
489 status
= sl811_read(sl811
, bank
+ SL11H_PKTSTATREG
);
491 urb
= container_of(ep
->hep
->urb_list
.next
, struct urb
, urb_list
);
493 /* we can safely ignore NAKs */
494 if (status
& SL11H_STATMASK_NAK
) {
495 // PACKET("...NAK_%02x qh%p\n", bank, ep);
500 /* ACK advances transfer, toggle, and maybe queue */
501 } else if (status
& SL11H_STATMASK_ACK
) {
502 struct usb_device
*udev
= urb
->dev
;
506 /* urb->iso_frame_desc is currently ignored here... */
508 ep
->nak_count
= ep
->error_count
= 0;
509 switch (ep
->nextpid
) {
511 // PACKET("...ACK/out_%02x qh%p\n", bank, ep);
512 urb
->actual_length
+= ep
->length
;
513 usb_dotoggle(udev
, ep
->epnum
, 1);
514 if (urb
->actual_length
515 == urb
->transfer_buffer_length
) {
516 if (usb_pipecontrol(urb
->pipe
))
517 ep
->nextpid
= USB_PID_ACK
;
519 /* some bulk protocols terminate OUT transfers
520 * by a short packet, using ZLPs not padding.
522 else if (ep
->length
< ep
->maxpacket
523 || !(urb
->transfer_flags
529 // PACKET("...ACK/in_%02x qh%p\n", bank, ep);
530 buf
= urb
->transfer_buffer
+ urb
->actual_length
;
532 len
= ep
->maxpacket
- sl811_read(sl811
,
533 bank
+ SL11H_XFERCNTREG
);
534 if (len
> ep
->length
) {
536 urbstat
= -EOVERFLOW
;
538 urb
->actual_length
+= len
;
539 sl811_read_buf(sl811
, SL811HS_PACKET_BUF(bank
== 0),
541 usb_dotoggle(udev
, ep
->epnum
, 0);
542 if (urbstat
== -EINPROGRESS
&&
543 (len
< ep
->maxpacket
||
544 urb
->actual_length
==
545 urb
->transfer_buffer_length
)) {
546 if (usb_pipecontrol(urb
->pipe
))
547 ep
->nextpid
= USB_PID_ACK
;
553 // PACKET("...ACK/setup_%02x qh%p\n", bank, ep);
554 if (urb
->transfer_buffer_length
== urb
->actual_length
)
555 ep
->nextpid
= USB_PID_ACK
;
556 else if (usb_pipeout(urb
->pipe
)) {
557 usb_settoggle(udev
, 0, 1, 1);
558 ep
->nextpid
= USB_PID_OUT
;
560 usb_settoggle(udev
, 0, 0, 1);
561 ep
->nextpid
= USB_PID_IN
;
565 // PACKET("...ACK/status_%02x qh%p\n", bank, ep);
570 /* STALL stops all transfers */
571 } else if (status
& SL11H_STATMASK_STALL
) {
572 PACKET("...STALL_%02x qh%p\n", bank
, ep
);
573 ep
->nak_count
= ep
->error_count
= 0;
576 /* error? retry, until "3 strikes" */
577 } else if (++ep
->error_count
>= 3) {
578 if (status
& SL11H_STATMASK_TMOUT
)
580 else if (status
& SL11H_STATMASK_OVF
)
581 urbstat
= -EOVERFLOW
;
585 PACKET("...3STRIKES_%02x %02x qh%p stat %d\n",
586 bank
, status
, ep
, urbstat
);
589 if (urbstat
!= -EINPROGRESS
|| urb
->unlinked
)
590 finish_request(sl811
, ep
, urb
, urbstat
);
593 static inline u8
checkdone(struct sl811
*sl811
)
598 if (sl811
->active_a
&& time_before_eq(sl811
->jiffies_a
, jiffies
)) {
599 ctl
= sl811_read(sl811
, SL811_EP_A(SL11H_HOSTCTLREG
));
600 if (ctl
& SL11H_HCTLMASK_ARM
)
601 sl811_write(sl811
, SL811_EP_A(SL11H_HOSTCTLREG
), 0);
602 DBG("%s DONE_A: ctrl %02x sts %02x\n",
603 (ctl
& SL11H_HCTLMASK_ARM
) ? "timeout" : "lost",
605 sl811_read(sl811
, SL811_EP_A(SL11H_PKTSTATREG
)));
606 irqstat
|= SL11H_INTMASK_DONE_A
;
609 if (sl811
->active_b
&& time_before_eq(sl811
->jiffies_b
, jiffies
)) {
610 ctl
= sl811_read(sl811
, SL811_EP_B(SL11H_HOSTCTLREG
));
611 if (ctl
& SL11H_HCTLMASK_ARM
)
612 sl811_write(sl811
, SL811_EP_B(SL11H_HOSTCTLREG
), 0);
613 DBG("%s DONE_B: ctrl %02x sts %02x\n",
614 (ctl
& SL11H_HCTLMASK_ARM
) ? "timeout" : "lost",
616 sl811_read(sl811
, SL811_EP_B(SL11H_PKTSTATREG
)));
617 irqstat
|= SL11H_INTMASK_DONE_A
;
623 static irqreturn_t
sl811h_irq(struct usb_hcd
*hcd
)
625 struct sl811
*sl811
= hcd_to_sl811(hcd
);
627 irqreturn_t ret
= IRQ_NONE
;
628 unsigned retries
= 5;
630 spin_lock(&sl811
->lock
);
633 irqstat
= sl811_read(sl811
, SL11H_IRQ_STATUS
) & ~SL11H_INTMASK_DP
;
635 sl811_write(sl811
, SL11H_IRQ_STATUS
, irqstat
);
636 irqstat
&= sl811
->irq_enable
;
640 /* this may no longer be necessary ... */
642 irqstat
= checkdone(sl811
);
648 /* USB packets, not necessarily handled in the order they're
649 * issued ... that's fine if they're different endpoints.
651 if (irqstat
& SL11H_INTMASK_DONE_A
) {
652 done(sl811
, sl811
->active_a
, SL811_EP_A(SL811_HOST_BUF
));
653 sl811
->active_a
= NULL
;
657 if (irqstat
& SL11H_INTMASK_DONE_B
) {
658 done(sl811
, sl811
->active_b
, SL811_EP_B(SL811_HOST_BUF
));
659 sl811
->active_b
= NULL
;
663 if (irqstat
& SL11H_INTMASK_SOFINTR
) {
666 index
= sl811
->frame
++ % (PERIODIC_SIZE
- 1);
669 /* be graceful about almost-inevitable periodic schedule
670 * overruns: continue the previous frame's transfers iff
671 * this one has nothing scheduled.
673 if (sl811
->next_periodic
) {
674 // ERR("overrun to slot %d\n", index);
675 sl811
->stat_overrun
++;
677 if (sl811
->periodic
[index
])
678 sl811
->next_periodic
= sl811
->periodic
[index
];
681 /* khubd manages debouncing and wakeup */
682 if (irqstat
& SL11H_INTMASK_INSRMV
) {
683 sl811
->stat_insrmv
++;
685 /* most stats are reset for each VBUS session */
686 sl811
->stat_wake
= 0;
690 sl811
->stat_lost
= 0;
693 sl811_write(sl811
, SL11H_CTLREG1
, sl811
->ctrl1
);
695 sl811
->irq_enable
= SL11H_INTMASK_INSRMV
;
696 sl811_write(sl811
, SL11H_IRQ_ENABLE
, sl811
->irq_enable
);
698 /* usbcore nukes other pending transactions on disconnect */
699 if (sl811
->active_a
) {
700 sl811_write(sl811
, SL811_EP_A(SL11H_HOSTCTLREG
), 0);
701 finish_request(sl811
, sl811
->active_a
,
702 container_of(sl811
->active_a
703 ->hep
->urb_list
.next
,
704 struct urb
, urb_list
),
706 sl811
->active_a
= NULL
;
709 if (sl811
->active_b
) {
710 sl811_write(sl811
, SL811_EP_B(SL11H_HOSTCTLREG
), 0);
711 finish_request(sl811
, sl811
->active_b
,
712 container_of(sl811
->active_b
713 ->hep
->urb_list
.next
,
714 struct urb
, urb_list
),
716 sl811
->active_b
= NULL
;
720 /* port status seems weird until after reset, so
721 * force the reset and make khubd clean up later.
723 sl811
->port1
|= (1 << USB_PORT_FEAT_C_CONNECTION
)
724 | (1 << USB_PORT_FEAT_CONNECTION
);
726 } else if (irqstat
& SL11H_INTMASK_RD
) {
727 if (sl811
->port1
& (1 << USB_PORT_FEAT_SUSPEND
)) {
729 sl811
->port1
|= 1 << USB_PORT_FEAT_C_SUSPEND
;
732 irqstat
&= ~SL11H_INTMASK_RD
;
736 if (sl811
->port1
& (1 << USB_PORT_FEAT_ENABLE
))
737 start_transfer(sl811
);
743 if (sl811
->periodic_count
== 0 && list_empty(&sl811
->async
))
745 sl811_write(sl811
, SL11H_IRQ_ENABLE
, sl811
->irq_enable
);
747 spin_unlock(&sl811
->lock
);
752 /*-------------------------------------------------------------------------*/
754 /* usb 1.1 says max 90% of a frame is available for periodic transfers.
755 * this driver doesn't promise that much since it's got to handle an
756 * IRQ per packet; irq handling latencies also use up that time.
758 * NOTE: the periodic schedule is a sparse tree, with the load for
759 * each branch minimized. see fig 3.5 in the OHCI spec for example.
761 #define MAX_PERIODIC_LOAD 500 /* out of 1000 usec */
763 static int balance(struct sl811
*sl811
, u16 period
, u16 load
)
765 int i
, branch
= -ENOSPC
;
767 /* search for the least loaded schedule branch of that period
768 * which has enough bandwidth left unreserved.
770 for (i
= 0; i
< period
; i
++) {
771 if (branch
< 0 || sl811
->load
[branch
] > sl811
->load
[i
]) {
774 for (j
= i
; j
< PERIODIC_SIZE
; j
+= period
) {
775 if ((sl811
->load
[j
] + load
)
779 if (j
< PERIODIC_SIZE
)
787 /*-------------------------------------------------------------------------*/
789 static int sl811h_urb_enqueue(
794 struct sl811
*sl811
= hcd_to_sl811(hcd
);
795 struct usb_device
*udev
= urb
->dev
;
796 unsigned int pipe
= urb
->pipe
;
797 int is_out
= !usb_pipein(pipe
);
798 int type
= usb_pipetype(pipe
);
799 int epnum
= usb_pipeendpoint(pipe
);
800 struct sl811h_ep
*ep
= NULL
;
804 struct usb_host_endpoint
*hep
= urb
->ep
;
807 if (type
== PIPE_ISOCHRONOUS
)
811 /* avoid all allocations within spinlocks */
813 ep
= kzalloc(sizeof *ep
, mem_flags
);
815 spin_lock_irqsave(&sl811
->lock
, flags
);
817 /* don't submit to a dead or disabled port */
818 if (!(sl811
->port1
& (1 << USB_PORT_FEAT_ENABLE
))
819 || !HC_IS_RUNNING(hcd
->state
)) {
822 goto fail_not_linked
;
824 retval
= usb_hcd_link_urb_to_ep(hcd
, urb
);
827 goto fail_not_linked
;
838 INIT_LIST_HEAD(&ep
->schedule
);
841 ep
->maxpacket
= usb_maxpacket(udev
, urb
->pipe
, is_out
);
842 ep
->defctrl
= SL11H_HCTLMASK_ARM
| SL11H_HCTLMASK_ENABLE
;
843 usb_settoggle(udev
, epnum
, is_out
, 0);
845 if (type
== PIPE_CONTROL
)
846 ep
->nextpid
= USB_PID_SETUP
;
848 ep
->nextpid
= USB_PID_OUT
;
850 ep
->nextpid
= USB_PID_IN
;
852 if (ep
->maxpacket
> H_MAXPACKET
) {
853 /* iso packets up to 240 bytes could work... */
854 DBG("dev %d ep%d maxpacket %d\n",
855 udev
->devnum
, epnum
, ep
->maxpacket
);
860 if (udev
->speed
== USB_SPEED_LOW
) {
861 /* send preamble for external hub? */
862 if (!(sl811
->ctrl1
& SL11H_CTL1MASK_LSPD
))
863 ep
->defctrl
|= SL11H_HCTLMASK_PREAMBLE
;
866 case PIPE_ISOCHRONOUS
:
868 if (urb
->interval
> PERIODIC_SIZE
)
869 urb
->interval
= PERIODIC_SIZE
;
870 ep
->period
= urb
->interval
;
871 ep
->branch
= PERIODIC_SIZE
;
872 if (type
== PIPE_ISOCHRONOUS
)
873 ep
->defctrl
|= SL11H_HCTLMASK_ISOCH
;
874 ep
->load
= usb_calc_bus_time(udev
->speed
, !is_out
,
875 (type
== PIPE_ISOCHRONOUS
),
876 usb_maxpacket(udev
, pipe
, is_out
))
885 /* maybe put endpoint into schedule */
889 if (list_empty(&ep
->schedule
))
890 list_add_tail(&ep
->schedule
, &sl811
->async
);
892 case PIPE_ISOCHRONOUS
:
894 urb
->interval
= ep
->period
;
895 if (ep
->branch
< PERIODIC_SIZE
) {
896 /* NOTE: the phase is correct here, but the value
897 * needs offsetting by the transfer queue depth.
898 * All current drivers ignore start_frame, so this
899 * is unlikely to ever matter...
901 urb
->start_frame
= (sl811
->frame
& (PERIODIC_SIZE
- 1))
906 retval
= balance(sl811
, ep
->period
, ep
->load
);
911 urb
->start_frame
= (sl811
->frame
& (PERIODIC_SIZE
- 1))
914 /* sort each schedule branch by period (slow before fast)
915 * to share the faster parts of the tree without needing
916 * dummy/placeholder nodes
918 DBG("schedule qh%d/%p branch %d\n", ep
->period
, ep
, ep
->branch
);
919 for (i
= ep
->branch
; i
< PERIODIC_SIZE
; i
+= ep
->period
) {
920 struct sl811h_ep
**prev
= &sl811
->periodic
[i
];
921 struct sl811h_ep
*here
= *prev
;
923 while (here
&& ep
!= here
) {
924 if (ep
->period
> here
->period
)
933 sl811
->load
[i
] += ep
->load
;
935 sl811
->periodic_count
++;
936 hcd
->self
.bandwidth_allocated
+= ep
->load
/ ep
->period
;
941 start_transfer(sl811
);
942 sl811_write(sl811
, SL11H_IRQ_ENABLE
, sl811
->irq_enable
);
945 usb_hcd_unlink_urb_from_ep(hcd
, urb
);
947 spin_unlock_irqrestore(&sl811
->lock
, flags
);
951 static int sl811h_urb_dequeue(struct usb_hcd
*hcd
, struct urb
*urb
, int status
)
953 struct sl811
*sl811
= hcd_to_sl811(hcd
);
954 struct usb_host_endpoint
*hep
;
956 struct sl811h_ep
*ep
;
959 spin_lock_irqsave(&sl811
->lock
, flags
);
960 retval
= usb_hcd_check_unlink_urb(hcd
, urb
, status
);
967 /* finish right away if this urb can't be active ...
968 * note that some drivers wrongly expect delays
970 if (ep
->hep
->urb_list
.next
!= &urb
->urb_list
) {
971 /* not front of queue? never active */
973 /* for active transfers, we expect an IRQ */
974 } else if (sl811
->active_a
== ep
) {
975 if (time_before_eq(sl811
->jiffies_a
, jiffies
)) {
976 /* happens a lot with lowspeed?? */
977 DBG("giveup on DONE_A: ctrl %02x sts %02x\n",
979 SL811_EP_A(SL11H_HOSTCTLREG
)),
981 SL811_EP_A(SL11H_PKTSTATREG
)));
982 sl811_write(sl811
, SL811_EP_A(SL11H_HOSTCTLREG
),
984 sl811
->active_a
= NULL
;
988 } else if (sl811
->active_b
== ep
) {
989 if (time_before_eq(sl811
->jiffies_a
, jiffies
)) {
990 /* happens a lot with lowspeed?? */
991 DBG("giveup on DONE_B: ctrl %02x sts %02x\n",
993 SL811_EP_B(SL11H_HOSTCTLREG
)),
995 SL811_EP_B(SL11H_PKTSTATREG
)));
996 sl811_write(sl811
, SL811_EP_B(SL11H_HOSTCTLREG
),
998 sl811
->active_b
= NULL
;
1003 /* front of queue for inactive endpoint */
1007 finish_request(sl811
, ep
, urb
, 0);
1009 VDBG("dequeue, urb %p active %s; wait4irq\n", urb
,
1010 (sl811
->active_a
== ep
) ? "A" : "B");
1014 spin_unlock_irqrestore(&sl811
->lock
, flags
);
1019 sl811h_endpoint_disable(struct usb_hcd
*hcd
, struct usb_host_endpoint
*hep
)
1021 struct sl811h_ep
*ep
= hep
->hcpriv
;
1026 /* assume we'd just wait for the irq */
1027 if (!list_empty(&hep
->urb_list
))
1029 if (!list_empty(&hep
->urb_list
))
1030 WARN("ep %p not empty?\n", ep
);
1037 sl811h_get_frame(struct usb_hcd
*hcd
)
1039 struct sl811
*sl811
= hcd_to_sl811(hcd
);
1041 /* wrong except while periodic transfers are scheduled;
1042 * never matches the on-the-wire frame;
1043 * subject to overruns.
1045 return sl811
->frame
;
1049 /*-------------------------------------------------------------------------*/
1051 /* the virtual root hub timer IRQ checks for hub status */
1053 sl811h_hub_status_data(struct usb_hcd
*hcd
, char *buf
)
1055 struct sl811
*sl811
= hcd_to_sl811(hcd
);
1057 unsigned long flags
;
1059 /* non-SMP HACK: use root hub timer as i/o watchdog
1060 * this seems essential when SOF IRQs aren't in use...
1062 local_irq_save(flags
);
1063 if (!timer_pending(&sl811
->timer
)) {
1064 if (sl811h_irq( /* ~0, */ hcd
) != IRQ_NONE
)
1067 local_irq_restore(flags
);
1070 if (!(sl811
->port1
& (0xffff << 16)))
1073 /* tell khubd port 1 changed */
1079 sl811h_hub_descriptor (
1080 struct sl811
*sl811
,
1081 struct usb_hub_descriptor
*desc
1085 desc
->bDescriptorType
= 0x29;
1086 desc
->bHubContrCurrent
= 0;
1088 desc
->bNbrPorts
= 1;
1089 desc
->bDescLength
= 9;
1091 /* per-port power switching (gang of one!), or none */
1092 desc
->bPwrOn2PwrGood
= 0;
1093 if (sl811
->board
&& sl811
->board
->port_power
) {
1094 desc
->bPwrOn2PwrGood
= sl811
->board
->potpg
;
1095 if (!desc
->bPwrOn2PwrGood
)
1096 desc
->bPwrOn2PwrGood
= 10;
1101 /* no overcurrent errors detection/handling */
1104 desc
->wHubCharacteristics
= (__force __u16
)cpu_to_le16(temp
);
1106 /* two bitmaps: ports removable, and legacy PortPwrCtrlMask */
1107 desc
->bitmap
[0] = 0 << 1;
1108 desc
->bitmap
[1] = ~0;
1112 sl811h_timer(unsigned long _sl811
)
1114 struct sl811
*sl811
= (void *) _sl811
;
1115 unsigned long flags
;
1117 u8 signaling
= sl811
->ctrl1
& SL11H_CTL1MASK_FORCE
;
1118 const u32 mask
= (1 << USB_PORT_FEAT_CONNECTION
)
1119 | (1 << USB_PORT_FEAT_ENABLE
)
1120 | (1 << USB_PORT_FEAT_LOWSPEED
);
1122 spin_lock_irqsave(&sl811
->lock
, flags
);
1124 /* stop special signaling */
1125 sl811
->ctrl1
&= ~SL11H_CTL1MASK_FORCE
;
1126 sl811_write(sl811
, SL11H_CTLREG1
, sl811
->ctrl1
);
1129 irqstat
= sl811_read(sl811
, SL11H_IRQ_STATUS
);
1131 switch (signaling
) {
1132 case SL11H_CTL1MASK_SE0
:
1134 sl811
->port1
= (1 << USB_PORT_FEAT_C_RESET
)
1135 | (1 << USB_PORT_FEAT_POWER
);
1137 /* don't wrongly ack RD */
1138 if (irqstat
& SL11H_INTMASK_INSRMV
)
1139 irqstat
&= ~SL11H_INTMASK_RD
;
1141 case SL11H_CTL1MASK_K
:
1142 DBG("end resume\n");
1143 sl811
->port1
&= ~(1 << USB_PORT_FEAT_SUSPEND
);
1146 DBG("odd timer signaling: %02x\n", signaling
);
1149 sl811_write(sl811
, SL11H_IRQ_STATUS
, irqstat
);
1151 if (irqstat
& SL11H_INTMASK_RD
) {
1152 /* usbcore nukes all pending transactions on disconnect */
1153 if (sl811
->port1
& (1 << USB_PORT_FEAT_CONNECTION
))
1154 sl811
->port1
|= (1 << USB_PORT_FEAT_C_CONNECTION
)
1155 | (1 << USB_PORT_FEAT_C_ENABLE
);
1156 sl811
->port1
&= ~mask
;
1157 sl811
->irq_enable
= SL11H_INTMASK_INSRMV
;
1159 sl811
->port1
|= mask
;
1160 if (irqstat
& SL11H_INTMASK_DP
)
1161 sl811
->port1
&= ~(1 << USB_PORT_FEAT_LOWSPEED
);
1162 sl811
->irq_enable
= SL11H_INTMASK_INSRMV
| SL11H_INTMASK_RD
;
1165 if (sl811
->port1
& (1 << USB_PORT_FEAT_CONNECTION
)) {
1166 u8 ctrl2
= SL811HS_CTL2_INIT
;
1168 sl811
->irq_enable
|= SL11H_INTMASK_DONE_A
;
1170 sl811
->irq_enable
|= SL11H_INTMASK_DONE_B
;
1172 if (sl811
->port1
& (1 << USB_PORT_FEAT_LOWSPEED
)) {
1173 sl811
->ctrl1
|= SL11H_CTL1MASK_LSPD
;
1174 ctrl2
|= SL811HS_CTL2MASK_DSWAP
;
1177 /* start SOFs flowing, kickstarting with A registers */
1178 sl811
->ctrl1
|= SL11H_CTL1MASK_SOF_ENA
;
1179 sl811_write(sl811
, SL11H_SOFLOWREG
, 0xe0);
1180 sl811_write(sl811
, SL811HS_CTLREG2
, ctrl2
);
1182 /* autoincrementing */
1183 sl811_write(sl811
, SL811_EP_A(SL11H_BUFLNTHREG
), 0);
1184 writeb(SL_SOF
, sl811
->data_reg
);
1185 writeb(0, sl811
->data_reg
);
1186 sl811_write(sl811
, SL811_EP_A(SL11H_HOSTCTLREG
),
1187 SL11H_HCTLMASK_ARM
);
1189 /* khubd provides debounce delay */
1193 sl811_write(sl811
, SL11H_CTLREG1
, sl811
->ctrl1
);
1196 sl811_write(sl811
, SL11H_IRQ_ENABLE
, sl811
->irq_enable
);
1197 spin_unlock_irqrestore(&sl811
->lock
, flags
);
1202 struct usb_hcd
*hcd
,
1209 struct sl811
*sl811
= hcd_to_sl811(hcd
);
1211 unsigned long flags
;
1213 spin_lock_irqsave(&sl811
->lock
, flags
);
1216 case ClearHubFeature
:
1219 case C_HUB_OVER_CURRENT
:
1220 case C_HUB_LOCAL_POWER
:
1226 case ClearPortFeature
:
1227 if (wIndex
!= 1 || wLength
!= 0)
1231 case USB_PORT_FEAT_ENABLE
:
1232 sl811
->port1
&= (1 << USB_PORT_FEAT_POWER
);
1234 sl811_write(sl811
, SL11H_CTLREG1
, sl811
->ctrl1
);
1235 sl811
->irq_enable
= SL11H_INTMASK_INSRMV
;
1236 sl811_write(sl811
, SL11H_IRQ_ENABLE
,
1239 case USB_PORT_FEAT_SUSPEND
:
1240 if (!(sl811
->port1
& (1 << USB_PORT_FEAT_SUSPEND
)))
1243 /* 20 msec of resume/K signaling, other irqs blocked */
1244 DBG("start resume...\n");
1245 sl811
->irq_enable
= 0;
1246 sl811_write(sl811
, SL11H_IRQ_ENABLE
,
1248 sl811
->ctrl1
|= SL11H_CTL1MASK_K
;
1249 sl811_write(sl811
, SL11H_CTLREG1
, sl811
->ctrl1
);
1251 mod_timer(&sl811
->timer
, jiffies
1252 + msecs_to_jiffies(20));
1254 case USB_PORT_FEAT_POWER
:
1255 port_power(sl811
, 0);
1257 case USB_PORT_FEAT_C_ENABLE
:
1258 case USB_PORT_FEAT_C_SUSPEND
:
1259 case USB_PORT_FEAT_C_CONNECTION
:
1260 case USB_PORT_FEAT_C_OVER_CURRENT
:
1261 case USB_PORT_FEAT_C_RESET
:
1266 sl811
->port1
&= ~(1 << wValue
);
1268 case GetHubDescriptor
:
1269 sl811h_hub_descriptor(sl811
, (struct usb_hub_descriptor
*) buf
);
1272 *(__le32
*) buf
= cpu_to_le32(0);
1277 *(__le32
*) buf
= cpu_to_le32(sl811
->port1
);
1280 if (*(u16
*)(buf
+2)) /* only if wPortChange is interesting */
1282 DBG("GetPortStatus %08x\n", sl811
->port1
);
1284 case SetPortFeature
:
1285 if (wIndex
!= 1 || wLength
!= 0)
1288 case USB_PORT_FEAT_SUSPEND
:
1289 if (sl811
->port1
& (1 << USB_PORT_FEAT_RESET
))
1291 if (!(sl811
->port1
& (1 << USB_PORT_FEAT_ENABLE
)))
1294 DBG("suspend...\n");
1295 sl811
->ctrl1
&= ~SL11H_CTL1MASK_SOF_ENA
;
1296 sl811_write(sl811
, SL11H_CTLREG1
, sl811
->ctrl1
);
1298 case USB_PORT_FEAT_POWER
:
1299 port_power(sl811
, 1);
1301 case USB_PORT_FEAT_RESET
:
1302 if (sl811
->port1
& (1 << USB_PORT_FEAT_SUSPEND
))
1304 if (!(sl811
->port1
& (1 << USB_PORT_FEAT_POWER
)))
1307 /* 50 msec of reset/SE0 signaling, irqs blocked */
1308 sl811
->irq_enable
= 0;
1309 sl811_write(sl811
, SL11H_IRQ_ENABLE
,
1311 sl811
->ctrl1
= SL11H_CTL1MASK_SE0
;
1312 sl811_write(sl811
, SL11H_CTLREG1
, sl811
->ctrl1
);
1313 sl811
->port1
|= (1 << USB_PORT_FEAT_RESET
);
1314 mod_timer(&sl811
->timer
, jiffies
1315 + msecs_to_jiffies(50));
1320 sl811
->port1
|= 1 << wValue
;
1325 /* "protocol stall" on error */
1329 spin_unlock_irqrestore(&sl811
->lock
, flags
);
1336 sl811h_bus_suspend(struct usb_hcd
*hcd
)
1339 DBG("%s\n", __FUNCTION__
);
1344 sl811h_bus_resume(struct usb_hcd
*hcd
)
1347 DBG("%s\n", __FUNCTION__
);
1353 #define sl811h_bus_suspend NULL
1354 #define sl811h_bus_resume NULL
1359 /*-------------------------------------------------------------------------*/
1361 #ifdef STUB_DEBUG_FILE
1363 static inline void create_debug_file(struct sl811
*sl811
) { }
1364 static inline void remove_debug_file(struct sl811
*sl811
) { }
1368 #include <linux/proc_fs.h>
1369 #include <linux/seq_file.h>
1371 static void dump_irq(struct seq_file
*s
, char *label
, u8 mask
)
1373 seq_printf(s
, "%s %02x%s%s%s%s%s%s\n", label
, mask
,
1374 (mask
& SL11H_INTMASK_DONE_A
) ? " done_a" : "",
1375 (mask
& SL11H_INTMASK_DONE_B
) ? " done_b" : "",
1376 (mask
& SL11H_INTMASK_SOFINTR
) ? " sof" : "",
1377 (mask
& SL11H_INTMASK_INSRMV
) ? " ins/rmv" : "",
1378 (mask
& SL11H_INTMASK_RD
) ? " rd" : "",
1379 (mask
& SL11H_INTMASK_DP
) ? " dp" : "");
1382 static int proc_sl811h_show(struct seq_file
*s
, void *unused
)
1384 struct sl811
*sl811
= s
->private;
1385 struct sl811h_ep
*ep
;
1388 seq_printf(s
, "%s\n%s version %s\nportstatus[1] = %08x\n",
1389 sl811_to_hcd(sl811
)->product_desc
,
1390 hcd_name
, DRIVER_VERSION
,
1393 seq_printf(s
, "insert/remove: %ld\n", sl811
->stat_insrmv
);
1394 seq_printf(s
, "current session: done_a %ld done_b %ld "
1395 "wake %ld sof %ld overrun %ld lost %ld\n\n",
1396 sl811
->stat_a
, sl811
->stat_b
,
1397 sl811
->stat_wake
, sl811
->stat_sof
,
1398 sl811
->stat_overrun
, sl811
->stat_lost
);
1400 spin_lock_irq(&sl811
->lock
);
1402 if (sl811
->ctrl1
& SL11H_CTL1MASK_SUSPEND
)
1403 seq_printf(s
, "(suspended)\n\n");
1405 u8 t
= sl811_read(sl811
, SL11H_CTLREG1
);
1407 seq_printf(s
, "ctrl1 %02x%s%s%s%s\n", t
,
1408 (t
& SL11H_CTL1MASK_SOF_ENA
) ? " sofgen" : "",
1409 ({char *s
; switch (t
& SL11H_CTL1MASK_FORCE
) {
1410 case SL11H_CTL1MASK_NORMAL
: s
= ""; break;
1411 case SL11H_CTL1MASK_SE0
: s
= " se0/reset"; break;
1412 case SL11H_CTL1MASK_K
: s
= " k/resume"; break;
1413 default: s
= "j"; break;
1415 (t
& SL11H_CTL1MASK_LSPD
) ? " lowspeed" : "",
1416 (t
& SL11H_CTL1MASK_SUSPEND
) ? " suspend" : "");
1418 dump_irq(s
, "irq_enable",
1419 sl811_read(sl811
, SL11H_IRQ_ENABLE
));
1420 dump_irq(s
, "irq_status",
1421 sl811_read(sl811
, SL11H_IRQ_STATUS
));
1422 seq_printf(s
, "frame clocks remaining: %d\n",
1423 sl811_read(sl811
, SL11H_SOFTMRREG
) << 6);
1426 seq_printf(s
, "A: qh%p ctl %02x sts %02x\n", sl811
->active_a
,
1427 sl811_read(sl811
, SL811_EP_A(SL11H_HOSTCTLREG
)),
1428 sl811_read(sl811
, SL811_EP_A(SL11H_PKTSTATREG
)));
1429 seq_printf(s
, "B: qh%p ctl %02x sts %02x\n", sl811
->active_b
,
1430 sl811_read(sl811
, SL811_EP_B(SL11H_HOSTCTLREG
)),
1431 sl811_read(sl811
, SL811_EP_B(SL11H_PKTSTATREG
)));
1432 seq_printf(s
, "\n");
1433 list_for_each_entry (ep
, &sl811
->async
, schedule
) {
1436 seq_printf(s
, "%s%sqh%p, ep%d%s, maxpacket %d"
1438 (ep
== sl811
->active_a
) ? "(A) " : "",
1439 (ep
== sl811
->active_b
) ? "(B) " : "",
1441 ({ char *s
; switch (ep
->nextpid
) {
1442 case USB_PID_IN
: s
= "in"; break;
1443 case USB_PID_OUT
: s
= "out"; break;
1444 case USB_PID_SETUP
: s
= "setup"; break;
1445 case USB_PID_ACK
: s
= "status"; break;
1446 default: s
= "?"; break;
1449 ep
->nak_count
, ep
->error_count
);
1450 list_for_each_entry (urb
, &ep
->hep
->urb_list
, urb_list
) {
1451 seq_printf(s
, " urb%p, %d/%d\n", urb
,
1453 urb
->transfer_buffer_length
);
1456 if (!list_empty(&sl811
->async
))
1457 seq_printf(s
, "\n");
1459 seq_printf(s
, "periodic size= %d\n", PERIODIC_SIZE
);
1461 for (i
= 0; i
< PERIODIC_SIZE
; i
++) {
1462 ep
= sl811
->periodic
[i
];
1465 seq_printf(s
, "%2d [%3d]:\n", i
, sl811
->load
[i
]);
1467 /* DUMB: prints shared entries multiple times */
1470 " %s%sqh%d/%p (%sdev%d ep%d%s max %d) "
1472 (ep
== sl811
->active_a
) ? "(A) " : "",
1473 (ep
== sl811
->active_b
) ? "(B) " : "",
1475 (ep
->udev
->speed
== USB_SPEED_FULL
)
1477 ep
->udev
->devnum
, ep
->epnum
,
1478 (ep
->epnum
== 0) ? ""
1479 : ((ep
->nextpid
== USB_PID_IN
)
1482 ep
->maxpacket
, ep
->error_count
);
1487 spin_unlock_irq(&sl811
->lock
);
1488 seq_printf(s
, "\n");
1493 static int proc_sl811h_open(struct inode
*inode
, struct file
*file
)
1495 return single_open(file
, proc_sl811h_show
, PDE(inode
)->data
);
1498 static const struct file_operations proc_ops
= {
1499 .open
= proc_sl811h_open
,
1501 .llseek
= seq_lseek
,
1502 .release
= single_release
,
1505 /* expect just one sl811 per system */
1506 static const char proc_filename
[] = "driver/sl811h";
1508 static void create_debug_file(struct sl811
*sl811
)
1510 struct proc_dir_entry
*pde
;
1512 pde
= create_proc_entry(proc_filename
, 0, NULL
);
1516 pde
->proc_fops
= &proc_ops
;
1521 static void remove_debug_file(struct sl811
*sl811
)
1524 remove_proc_entry(proc_filename
, NULL
);
1529 /*-------------------------------------------------------------------------*/
1532 sl811h_stop(struct usb_hcd
*hcd
)
1534 struct sl811
*sl811
= hcd_to_sl811(hcd
);
1535 unsigned long flags
;
1537 del_timer_sync(&hcd
->rh_timer
);
1539 spin_lock_irqsave(&sl811
->lock
, flags
);
1540 port_power(sl811
, 0);
1541 spin_unlock_irqrestore(&sl811
->lock
, flags
);
1545 sl811h_start(struct usb_hcd
*hcd
)
1547 struct sl811
*sl811
= hcd_to_sl811(hcd
);
1549 /* chip has been reset, VBUS power is off */
1550 hcd
->state
= HC_STATE_RUNNING
;
1553 if (!device_can_wakeup(hcd
->self
.controller
))
1554 device_init_wakeup(hcd
->self
.controller
,
1555 sl811
->board
->can_wakeup
);
1556 hcd
->power_budget
= sl811
->board
->power
* 2;
1559 /* enable power and interrupts */
1560 port_power(sl811
, 1);
1565 /*-------------------------------------------------------------------------*/
1567 static struct hc_driver sl811h_hc_driver
= {
1568 .description
= hcd_name
,
1569 .hcd_priv_size
= sizeof(struct sl811
),
1572 * generic hardware linkage
1575 .flags
= HCD_USB11
| HCD_MEMORY
,
1577 /* Basic lifecycle operations */
1578 .start
= sl811h_start
,
1579 .stop
= sl811h_stop
,
1582 * managing i/o requests and associated device resources
1584 .urb_enqueue
= sl811h_urb_enqueue
,
1585 .urb_dequeue
= sl811h_urb_dequeue
,
1586 .endpoint_disable
= sl811h_endpoint_disable
,
1589 * periodic schedule support
1591 .get_frame_number
= sl811h_get_frame
,
1596 .hub_status_data
= sl811h_hub_status_data
,
1597 .hub_control
= sl811h_hub_control
,
1598 .bus_suspend
= sl811h_bus_suspend
,
1599 .bus_resume
= sl811h_bus_resume
,
1602 /*-------------------------------------------------------------------------*/
1604 static int __devexit
1605 sl811h_remove(struct platform_device
*dev
)
1607 struct usb_hcd
*hcd
= platform_get_drvdata(dev
);
1608 struct sl811
*sl811
= hcd_to_sl811(hcd
);
1609 struct resource
*res
;
1611 remove_debug_file(sl811
);
1612 usb_remove_hcd(hcd
);
1614 /* some platforms may use IORESOURCE_IO */
1615 res
= platform_get_resource(dev
, IORESOURCE_MEM
, 1);
1617 iounmap(sl811
->data_reg
);
1619 res
= platform_get_resource(dev
, IORESOURCE_MEM
, 0);
1621 iounmap(sl811
->addr_reg
);
1627 static int __devinit
1628 sl811h_probe(struct platform_device
*dev
)
1630 struct usb_hcd
*hcd
;
1631 struct sl811
*sl811
;
1632 struct resource
*addr
, *data
;
1634 void __iomem
*addr_reg
;
1635 void __iomem
*data_reg
;
1639 /* basic sanity checks first. board-specific init logic should
1640 * have initialized these three resources and probably board
1641 * specific platform_data. we don't probe for IRQs, and do only
1642 * minimal sanity checking.
1644 irq
= platform_get_irq(dev
, 0);
1645 if (dev
->num_resources
< 3 || irq
< 0)
1648 /* refuse to confuse usbcore */
1649 if (dev
->dev
.dma_mask
) {
1650 DBG("no we won't dma\n");
1654 /* the chip may be wired for either kind of addressing */
1655 addr
= platform_get_resource(dev
, IORESOURCE_MEM
, 0);
1656 data
= platform_get_resource(dev
, IORESOURCE_MEM
, 1);
1658 if (!addr
|| !data
) {
1659 addr
= platform_get_resource(dev
, IORESOURCE_IO
, 0);
1660 data
= platform_get_resource(dev
, IORESOURCE_IO
, 1);
1665 * NOTE: 64-bit resource->start is getting truncated
1666 * to avoid compiler warning, assuming that ->start
1667 * is always 32-bit for this case
1669 addr_reg
= (void __iomem
*) (unsigned long) addr
->start
;
1670 data_reg
= (void __iomem
*) (unsigned long) data
->start
;
1672 addr_reg
= ioremap(addr
->start
, 1);
1673 if (addr_reg
== NULL
) {
1678 data_reg
= ioremap(data
->start
, 1);
1679 if (data_reg
== NULL
) {
1685 /* allocate and initialize hcd */
1686 hcd
= usb_create_hcd(&sl811h_hc_driver
, &dev
->dev
, dev
->dev
.bus_id
);
1691 hcd
->rsrc_start
= addr
->start
;
1692 sl811
= hcd_to_sl811(hcd
);
1694 spin_lock_init(&sl811
->lock
);
1695 INIT_LIST_HEAD(&sl811
->async
);
1696 sl811
->board
= dev
->dev
.platform_data
;
1697 init_timer(&sl811
->timer
);
1698 sl811
->timer
.function
= sl811h_timer
;
1699 sl811
->timer
.data
= (unsigned long) sl811
;
1700 sl811
->addr_reg
= addr_reg
;
1701 sl811
->data_reg
= data_reg
;
1703 spin_lock_irq(&sl811
->lock
);
1704 port_power(sl811
, 0);
1705 spin_unlock_irq(&sl811
->lock
);
1708 tmp
= sl811_read(sl811
, SL11H_HWREVREG
);
1711 hcd
->product_desc
= "SL811HS v1.2";
1714 hcd
->product_desc
= "SL811HS v1.5";
1717 /* reject case 0, SL11S is less functional */
1718 DBG("chiprev %02x\n", tmp
);
1723 /* The chip's IRQ is level triggered, active high. A requirement
1724 * for platform device setup is to cope with things like signal
1725 * inverters (e.g. CF is active low) or working only with edge
1726 * triggers (e.g. most ARM CPUs). Initial driver stress testing
1727 * was on a system with single edge triggering, so most sorts of
1728 * triggering arrangement should work.
1730 retval
= usb_add_hcd(hcd
, irq
, IRQF_DISABLED
| IRQF_SHARED
);
1734 create_debug_file(sl811
);
1746 DBG("init error, %d\n", retval
);
1752 /* for this device there's no useful distinction between the controller
1753 * and its root hub, except that the root hub only gets direct PM calls
1754 * when CONFIG_USB_SUSPEND is enabled.
1758 sl811h_suspend(struct platform_device
*dev
, pm_message_t state
)
1760 struct usb_hcd
*hcd
= platform_get_drvdata(dev
);
1761 struct sl811
*sl811
= hcd_to_sl811(hcd
);
1764 switch (state
.event
) {
1765 case PM_EVENT_FREEZE
:
1766 retval
= sl811h_bus_suspend(hcd
);
1768 case PM_EVENT_SUSPEND
:
1769 case PM_EVENT_HIBERNATE
:
1770 case PM_EVENT_PRETHAW
: /* explicitly discard hw state */
1771 port_power(sl811
, 0);
1775 dev
->dev
.power
.power_state
= state
;
1780 sl811h_resume(struct platform_device
*dev
)
1782 struct usb_hcd
*hcd
= platform_get_drvdata(dev
);
1783 struct sl811
*sl811
= hcd_to_sl811(hcd
);
1785 /* with no "check to see if VBUS is still powered" board hook,
1786 * let's assume it'd only be powered to enable remote wakeup.
1788 if (dev
->dev
.power
.power_state
.event
== PM_EVENT_SUSPEND
1789 || !device_can_wakeup(&hcd
->self
.root_hub
->dev
)) {
1791 port_power(sl811
, 1);
1792 usb_root_hub_lost_power(hcd
->self
.root_hub
);
1796 dev
->dev
.power
.power_state
= PMSG_ON
;
1797 return sl811h_bus_resume(hcd
);
1802 #define sl811h_suspend NULL
1803 #define sl811h_resume NULL
1808 /* this driver is exported so sl811_cs can depend on it */
1809 struct platform_driver sl811h_driver
= {
1810 .probe
= sl811h_probe
,
1811 .remove
= __devexit_p(sl811h_remove
),
1813 .suspend
= sl811h_suspend
,
1814 .resume
= sl811h_resume
,
1816 .name
= (char *) hcd_name
,
1817 .owner
= THIS_MODULE
,
1820 EXPORT_SYMBOL(sl811h_driver
);
1822 /*-------------------------------------------------------------------------*/
1824 static int __init
sl811h_init(void)
1829 INFO("driver %s, %s\n", hcd_name
, DRIVER_VERSION
);
1830 return platform_driver_register(&sl811h_driver
);
1832 module_init(sl811h_init
);
1834 static void __exit
sl811h_cleanup(void)
1836 platform_driver_unregister(&sl811h_driver
);
1838 module_exit(sl811h_cleanup
);