blob: 2cbb239e63f8863688df8562805816d101b33754 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * Universal Host Controller Interface driver for USB.
3 *
4 * Maintainer: Alan Stern <stern@rowland.harvard.edu>
5 *
6 * (C) Copyright 1999 Linus Torvalds
7 * (C) Copyright 1999-2002 Johannes Erdfelt, johannes@erdfelt.com
8 * (C) Copyright 1999 Randy Dunlap
9 * (C) Copyright 1999 Georg Acher, acher@in.tum.de
10 * (C) Copyright 1999 Deti Fliegl, deti@fliegl.de
11 * (C) Copyright 1999 Thomas Sailer, sailer@ife.ee.ethz.ch
12 * (C) Copyright 1999 Roman Weissgaerber, weissg@vienna.at
13 * (C) Copyright 2000 Yggdrasil Computing, Inc. (port of new PCI interface
14 * support from usb-ohci.c by Adam Richter, adam@yggdrasil.com).
15 * (C) Copyright 1999 Gregory P. Smith (from usb-ohci.c)
Alan Sternb761d9d2006-05-12 11:41:59 -040016 * (C) Copyright 2004-2006 Alan Stern, stern@rowland.harvard.edu
Linus Torvalds1da177e2005-04-16 15:20:36 -070017 */
18
Linus Torvalds1da177e2005-04-16 15:20:36 -070019
20/*
21 * Technically, updating td->status here is a race, but it's not really a
22 * problem. The worst that can happen is that we set the IOC bit again
23 * generating a spurious interrupt. We could fix this by creating another
24 * QH and leaving the IOC bit always set, but then we would have to play
25 * games with the FSBR code to make sure we get the correct order in all
26 * the cases. I don't think it's worth the effort
27 */
Alan Sterndccf4a42005-12-17 17:58:46 -050028static void uhci_set_next_interrupt(struct uhci_hcd *uhci)
Linus Torvalds1da177e2005-04-16 15:20:36 -070029{
Alan Stern6c1b4452005-04-21 16:04:58 -040030 if (uhci->is_stopped)
Alan Stern1f09df82005-09-05 13:59:51 -040031 mod_timer(&uhci_to_hcd(uhci)->rh_timer, jiffies);
Linus Torvalds1da177e2005-04-16 15:20:36 -070032 uhci->term_td->status |= cpu_to_le32(TD_CTRL_IOC);
33}
34
35static inline void uhci_clear_next_interrupt(struct uhci_hcd *uhci)
36{
37 uhci->term_td->status &= ~cpu_to_le32(TD_CTRL_IOC);
38}
39
Alan Stern84afddd2006-05-12 11:35:45 -040040
41/*
42 * Full-Speed Bandwidth Reclamation (FSBR).
43 * We turn on FSBR whenever a queue that wants it is advancing,
44 * and leave it on for a short time thereafter.
45 */
46static void uhci_fsbr_on(struct uhci_hcd *uhci)
47{
48 uhci->fsbr_is_on = 1;
49 uhci->skel_term_qh->link = cpu_to_le32(
50 uhci->skel_fs_control_qh->dma_handle) | UHCI_PTR_QH;
51}
52
53static void uhci_fsbr_off(struct uhci_hcd *uhci)
54{
55 uhci->fsbr_is_on = 0;
56 uhci->skel_term_qh->link = UHCI_PTR_TERM;
57}
58
59static void uhci_add_fsbr(struct uhci_hcd *uhci, struct urb *urb)
60{
61 struct urb_priv *urbp = urb->hcpriv;
62
63 if (!(urb->transfer_flags & URB_NO_FSBR))
64 urbp->fsbr = 1;
65}
66
Alan Sternc5e3b742006-06-05 12:28:57 -040067static void uhci_urbp_wants_fsbr(struct uhci_hcd *uhci, struct urb_priv *urbp)
Alan Stern84afddd2006-05-12 11:35:45 -040068{
Alan Stern84afddd2006-05-12 11:35:45 -040069 if (urbp->fsbr) {
Alan Sternc5e3b742006-06-05 12:28:57 -040070 uhci->fsbr_is_wanted = 1;
Alan Stern84afddd2006-05-12 11:35:45 -040071 if (!uhci->fsbr_is_on)
72 uhci_fsbr_on(uhci);
Alan Sternc5e3b742006-06-05 12:28:57 -040073 else if (uhci->fsbr_expiring) {
74 uhci->fsbr_expiring = 0;
75 del_timer(&uhci->fsbr_timer);
76 }
Alan Stern84afddd2006-05-12 11:35:45 -040077 }
78}
79
Alan Sternc5e3b742006-06-05 12:28:57 -040080static void uhci_fsbr_timeout(unsigned long _uhci)
81{
82 struct uhci_hcd *uhci = (struct uhci_hcd *) _uhci;
83 unsigned long flags;
84
85 spin_lock_irqsave(&uhci->lock, flags);
86 if (uhci->fsbr_expiring) {
87 uhci->fsbr_expiring = 0;
88 uhci_fsbr_off(uhci);
89 }
90 spin_unlock_irqrestore(&uhci->lock, flags);
91}
92
Alan Stern84afddd2006-05-12 11:35:45 -040093
Alan Stern25321782005-04-25 11:14:31 -040094static struct uhci_td *uhci_alloc_td(struct uhci_hcd *uhci)
Linus Torvalds1da177e2005-04-16 15:20:36 -070095{
96 dma_addr_t dma_handle;
97 struct uhci_td *td;
98
99 td = dma_pool_alloc(uhci->td_pool, GFP_ATOMIC, &dma_handle);
100 if (!td)
101 return NULL;
102
103 td->dma_handle = dma_handle;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700104 td->frame = -1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700105
106 INIT_LIST_HEAD(&td->list);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700107 INIT_LIST_HEAD(&td->fl_list);
108
Linus Torvalds1da177e2005-04-16 15:20:36 -0700109 return td;
110}
111
Alan Sterndccf4a42005-12-17 17:58:46 -0500112static void uhci_free_td(struct uhci_hcd *uhci, struct uhci_td *td)
113{
114 if (!list_empty(&td->list))
115 dev_warn(uhci_dev(uhci), "td %p still in list!\n", td);
Alan Sterndccf4a42005-12-17 17:58:46 -0500116 if (!list_empty(&td->fl_list))
117 dev_warn(uhci_dev(uhci), "td %p still in fl_list!\n", td);
118
119 dma_pool_free(uhci->td_pool, td, td->dma_handle);
120}
121
Linus Torvalds1da177e2005-04-16 15:20:36 -0700122static inline void uhci_fill_td(struct uhci_td *td, u32 status,
123 u32 token, u32 buffer)
124{
125 td->status = cpu_to_le32(status);
126 td->token = cpu_to_le32(token);
127 td->buffer = cpu_to_le32(buffer);
128}
129
Alan Stern04538a22006-05-12 11:29:04 -0400130static void uhci_add_td_to_urbp(struct uhci_td *td, struct urb_priv *urbp)
131{
132 list_add_tail(&td->list, &urbp->td_list);
133}
134
135static void uhci_remove_td_from_urbp(struct uhci_td *td)
136{
137 list_del_init(&td->list);
138}
139
Linus Torvalds1da177e2005-04-16 15:20:36 -0700140/*
Alan Stern687f5f32005-11-30 17:16:19 -0500141 * We insert Isochronous URBs directly into the frame list at the beginning
Linus Torvalds1da177e2005-04-16 15:20:36 -0700142 */
Alan Sterndccf4a42005-12-17 17:58:46 -0500143static inline void uhci_insert_td_in_frame_list(struct uhci_hcd *uhci,
144 struct uhci_td *td, unsigned framenum)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700145{
146 framenum &= (UHCI_NUMFRAMES - 1);
147
148 td->frame = framenum;
149
150 /* Is there a TD already mapped there? */
Alan Sterna1d59ce2005-09-16 14:22:51 -0400151 if (uhci->frame_cpu[framenum]) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700152 struct uhci_td *ftd, *ltd;
153
Alan Sterna1d59ce2005-09-16 14:22:51 -0400154 ftd = uhci->frame_cpu[framenum];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700155 ltd = list_entry(ftd->fl_list.prev, struct uhci_td, fl_list);
156
157 list_add_tail(&td->fl_list, &ftd->fl_list);
158
159 td->link = ltd->link;
160 wmb();
161 ltd->link = cpu_to_le32(td->dma_handle);
162 } else {
Alan Sterna1d59ce2005-09-16 14:22:51 -0400163 td->link = uhci->frame[framenum];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700164 wmb();
Alan Sterna1d59ce2005-09-16 14:22:51 -0400165 uhci->frame[framenum] = cpu_to_le32(td->dma_handle);
166 uhci->frame_cpu[framenum] = td;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700167 }
168}
169
Alan Sterndccf4a42005-12-17 17:58:46 -0500170static inline void uhci_remove_td_from_frame_list(struct uhci_hcd *uhci,
Alan Sternb81d3432005-10-13 17:00:24 -0400171 struct uhci_td *td)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700172{
173 /* If it's not inserted, don't remove it */
Alan Sternb81d3432005-10-13 17:00:24 -0400174 if (td->frame == -1) {
175 WARN_ON(!list_empty(&td->fl_list));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700176 return;
Alan Sternb81d3432005-10-13 17:00:24 -0400177 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700178
Alan Sternb81d3432005-10-13 17:00:24 -0400179 if (uhci->frame_cpu[td->frame] == td) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700180 if (list_empty(&td->fl_list)) {
Alan Sterna1d59ce2005-09-16 14:22:51 -0400181 uhci->frame[td->frame] = td->link;
182 uhci->frame_cpu[td->frame] = NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700183 } else {
184 struct uhci_td *ntd;
185
186 ntd = list_entry(td->fl_list.next, struct uhci_td, fl_list);
Alan Sterna1d59ce2005-09-16 14:22:51 -0400187 uhci->frame[td->frame] = cpu_to_le32(ntd->dma_handle);
188 uhci->frame_cpu[td->frame] = ntd;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700189 }
190 } else {
191 struct uhci_td *ptd;
192
193 ptd = list_entry(td->fl_list.prev, struct uhci_td, fl_list);
194 ptd->link = td->link;
195 }
196
Linus Torvalds1da177e2005-04-16 15:20:36 -0700197 list_del_init(&td->fl_list);
198 td->frame = -1;
199}
200
Alan Sternc8155cc2006-05-19 16:52:35 -0400201static inline void uhci_remove_tds_from_frame(struct uhci_hcd *uhci,
202 unsigned int framenum)
203{
204 struct uhci_td *ftd, *ltd;
205
206 framenum &= (UHCI_NUMFRAMES - 1);
207
208 ftd = uhci->frame_cpu[framenum];
209 if (ftd) {
210 ltd = list_entry(ftd->fl_list.prev, struct uhci_td, fl_list);
211 uhci->frame[framenum] = ltd->link;
212 uhci->frame_cpu[framenum] = NULL;
213
214 while (!list_empty(&ftd->fl_list))
215 list_del_init(ftd->fl_list.prev);
216 }
217}
218
Alan Sterndccf4a42005-12-17 17:58:46 -0500219/*
220 * Remove all the TDs for an Isochronous URB from the frame list
221 */
222static void uhci_unlink_isochronous_tds(struct uhci_hcd *uhci, struct urb *urb)
Alan Sternb81d3432005-10-13 17:00:24 -0400223{
224 struct urb_priv *urbp = (struct urb_priv *) urb->hcpriv;
225 struct uhci_td *td;
226
227 list_for_each_entry(td, &urbp->td_list, list)
Alan Sterndccf4a42005-12-17 17:58:46 -0500228 uhci_remove_td_from_frame_list(uhci, td);
Alan Sternb81d3432005-10-13 17:00:24 -0400229}
230
Alan Sterndccf4a42005-12-17 17:58:46 -0500231static struct uhci_qh *uhci_alloc_qh(struct uhci_hcd *uhci,
232 struct usb_device *udev, struct usb_host_endpoint *hep)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700233{
234 dma_addr_t dma_handle;
235 struct uhci_qh *qh;
236
237 qh = dma_pool_alloc(uhci->qh_pool, GFP_ATOMIC, &dma_handle);
238 if (!qh)
239 return NULL;
240
Alan Stern59e29ed2006-05-12 11:19:19 -0400241 memset(qh, 0, sizeof(*qh));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700242 qh->dma_handle = dma_handle;
243
244 qh->element = UHCI_PTR_TERM;
245 qh->link = UHCI_PTR_TERM;
246
Alan Sterndccf4a42005-12-17 17:58:46 -0500247 INIT_LIST_HEAD(&qh->queue);
248 INIT_LIST_HEAD(&qh->node);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700249
Alan Sterndccf4a42005-12-17 17:58:46 -0500250 if (udev) { /* Normal QH */
Alan Stern85a975d2007-01-08 12:01:43 -0500251 qh->type = hep->desc.bmAttributes & USB_ENDPOINT_XFERTYPE_MASK;
252 if (qh->type != USB_ENDPOINT_XFER_ISOC) {
253 qh->dummy_td = uhci_alloc_td(uhci);
254 if (!qh->dummy_td) {
255 dma_pool_free(uhci->qh_pool, qh, dma_handle);
256 return NULL;
257 }
Alan Sternaf0bb592005-12-17 18:00:12 -0500258 }
Alan Sterndccf4a42005-12-17 17:58:46 -0500259 qh->state = QH_STATE_IDLE;
260 qh->hep = hep;
261 qh->udev = udev;
262 hep->hcpriv = qh;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700263
Alan Stern3ca2a322007-01-16 11:56:32 -0500264 if (qh->type == USB_ENDPOINT_XFER_INT ||
265 qh->type == USB_ENDPOINT_XFER_ISOC)
266 qh->load = usb_calc_bus_time(udev->speed,
267 usb_endpoint_dir_in(&hep->desc),
268 qh->type == USB_ENDPOINT_XFER_ISOC,
269 le16_to_cpu(hep->desc.wMaxPacketSize))
270 / 1000 + 1;
271
Alan Sterndccf4a42005-12-17 17:58:46 -0500272 } else { /* Skeleton QH */
273 qh->state = QH_STATE_ACTIVE;
Alan Stern4de7d2c2006-05-05 16:26:58 -0400274 qh->type = -1;
Alan Sterndccf4a42005-12-17 17:58:46 -0500275 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700276 return qh;
277}
278
279static void uhci_free_qh(struct uhci_hcd *uhci, struct uhci_qh *qh)
280{
Alan Sterndccf4a42005-12-17 17:58:46 -0500281 WARN_ON(qh->state != QH_STATE_IDLE && qh->udev);
282 if (!list_empty(&qh->queue))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700283 dev_warn(uhci_dev(uhci), "qh %p list not empty!\n", qh);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700284
Alan Sterndccf4a42005-12-17 17:58:46 -0500285 list_del(&qh->node);
286 if (qh->udev) {
287 qh->hep->hcpriv = NULL;
Alan Stern85a975d2007-01-08 12:01:43 -0500288 if (qh->dummy_td)
289 uhci_free_td(uhci, qh->dummy_td);
Alan Sterndccf4a42005-12-17 17:58:46 -0500290 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700291 dma_pool_free(uhci->qh_pool, qh, qh->dma_handle);
292}
293
294/*
Alan Sterna0b458b2006-05-12 11:23:19 -0400295 * When a queue is stopped and a dequeued URB is given back, adjust
296 * the previous TD link (if the URB isn't first on the queue) or
297 * save its toggle value (if it is first and is currently executing).
Alan Stern10b8e472006-05-19 16:39:52 -0400298 *
299 * Returns 0 if the URB should not yet be given back, 1 otherwise.
Alan Stern0ed8fee2005-12-17 18:02:38 -0500300 */
Alan Stern10b8e472006-05-19 16:39:52 -0400301static int uhci_cleanup_queue(struct uhci_hcd *uhci, struct uhci_qh *qh,
Alan Sterna0b458b2006-05-12 11:23:19 -0400302 struct urb *urb)
Alan Stern0ed8fee2005-12-17 18:02:38 -0500303{
Alan Sterna0b458b2006-05-12 11:23:19 -0400304 struct urb_priv *urbp = urb->hcpriv;
Alan Stern0ed8fee2005-12-17 18:02:38 -0500305 struct uhci_td *td;
Alan Stern10b8e472006-05-19 16:39:52 -0400306 int ret = 1;
Alan Stern0ed8fee2005-12-17 18:02:38 -0500307
Alan Sterna0b458b2006-05-12 11:23:19 -0400308 /* Isochronous pipes don't use toggles and their TD link pointers
Alan Stern10b8e472006-05-19 16:39:52 -0400309 * get adjusted during uhci_urb_dequeue(). But since their queues
310 * cannot truly be stopped, we have to watch out for dequeues
311 * occurring after the nominal unlink frame. */
312 if (qh->type == USB_ENDPOINT_XFER_ISOC) {
313 ret = (uhci->frame_number + uhci->is_stopped !=
314 qh->unlink_frame);
Alan Sternc5e3b742006-06-05 12:28:57 -0400315 goto done;
Alan Stern10b8e472006-05-19 16:39:52 -0400316 }
Alan Sterna0b458b2006-05-12 11:23:19 -0400317
318 /* If the URB isn't first on its queue, adjust the link pointer
319 * of the last TD in the previous URB. The toggle doesn't need
320 * to be saved since this URB can't be executing yet. */
321 if (qh->queue.next != &urbp->node) {
322 struct urb_priv *purbp;
323 struct uhci_td *ptd;
324
325 purbp = list_entry(urbp->node.prev, struct urb_priv, node);
326 WARN_ON(list_empty(&purbp->td_list));
327 ptd = list_entry(purbp->td_list.prev, struct uhci_td,
328 list);
329 td = list_entry(urbp->td_list.prev, struct uhci_td,
330 list);
331 ptd->link = td->link;
Alan Sternc5e3b742006-06-05 12:28:57 -0400332 goto done;
Alan Sterna0b458b2006-05-12 11:23:19 -0400333 }
334
Alan Stern0ed8fee2005-12-17 18:02:38 -0500335 /* If the QH element pointer is UHCI_PTR_TERM then then currently
336 * executing URB has already been unlinked, so this one isn't it. */
Alan Sterna0b458b2006-05-12 11:23:19 -0400337 if (qh_element(qh) == UHCI_PTR_TERM)
Alan Sternc5e3b742006-06-05 12:28:57 -0400338 goto done;
Alan Stern0ed8fee2005-12-17 18:02:38 -0500339 qh->element = UHCI_PTR_TERM;
340
Alan Stern85a975d2007-01-08 12:01:43 -0500341 /* Control pipes don't have to worry about toggles */
Alan Sterna0b458b2006-05-12 11:23:19 -0400342 if (qh->type == USB_ENDPOINT_XFER_CONTROL)
Alan Sternc5e3b742006-06-05 12:28:57 -0400343 goto done;
Alan Stern0ed8fee2005-12-17 18:02:38 -0500344
Alan Sterna0b458b2006-05-12 11:23:19 -0400345 /* Save the next toggle value */
Alan Stern59e29ed2006-05-12 11:19:19 -0400346 WARN_ON(list_empty(&urbp->td_list));
347 td = list_entry(urbp->td_list.next, struct uhci_td, list);
348 qh->needs_fixup = 1;
349 qh->initial_toggle = uhci_toggle(td_token(td));
Alan Sternc5e3b742006-06-05 12:28:57 -0400350
351done:
Alan Stern10b8e472006-05-19 16:39:52 -0400352 return ret;
Alan Stern0ed8fee2005-12-17 18:02:38 -0500353}
354
355/*
356 * Fix up the data toggles for URBs in a queue, when one of them
357 * terminates early (short transfer, error, or dequeued).
358 */
359static void uhci_fixup_toggles(struct uhci_qh *qh, int skip_first)
360{
361 struct urb_priv *urbp = NULL;
362 struct uhci_td *td;
363 unsigned int toggle = qh->initial_toggle;
364 unsigned int pipe;
365
366 /* Fixups for a short transfer start with the second URB in the
367 * queue (the short URB is the first). */
368 if (skip_first)
369 urbp = list_entry(qh->queue.next, struct urb_priv, node);
370
371 /* When starting with the first URB, if the QH element pointer is
372 * still valid then we know the URB's toggles are okay. */
373 else if (qh_element(qh) != UHCI_PTR_TERM)
374 toggle = 2;
375
376 /* Fix up the toggle for the URBs in the queue. Normally this
377 * loop won't run more than once: When an error or short transfer
378 * occurs, the queue usually gets emptied. */
Alan Stern1393adb2006-01-31 10:02:55 -0500379 urbp = list_prepare_entry(urbp, &qh->queue, node);
Alan Stern0ed8fee2005-12-17 18:02:38 -0500380 list_for_each_entry_continue(urbp, &qh->queue, node) {
381
382 /* If the first TD has the right toggle value, we don't
383 * need to change any toggles in this URB */
384 td = list_entry(urbp->td_list.next, struct uhci_td, list);
385 if (toggle > 1 || uhci_toggle(td_token(td)) == toggle) {
Alan Sterndb59b462006-08-31 14:18:39 -0400386 td = list_entry(urbp->td_list.prev, struct uhci_td,
Alan Stern0ed8fee2005-12-17 18:02:38 -0500387 list);
388 toggle = uhci_toggle(td_token(td)) ^ 1;
389
390 /* Otherwise all the toggles in the URB have to be switched */
391 } else {
392 list_for_each_entry(td, &urbp->td_list, list) {
393 td->token ^= __constant_cpu_to_le32(
394 TD_TOKEN_TOGGLE);
395 toggle ^= 1;
396 }
397 }
398 }
399
400 wmb();
401 pipe = list_entry(qh->queue.next, struct urb_priv, node)->urb->pipe;
402 usb_settoggle(qh->udev, usb_pipeendpoint(pipe),
403 usb_pipeout(pipe), toggle);
404 qh->needs_fixup = 0;
405}
406
407/*
Alan Sterndccf4a42005-12-17 17:58:46 -0500408 * Put a QH on the schedule in both hardware and software
Linus Torvalds1da177e2005-04-16 15:20:36 -0700409 */
Alan Sterndccf4a42005-12-17 17:58:46 -0500410static void uhci_activate_qh(struct uhci_hcd *uhci, struct uhci_qh *qh)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700411{
Alan Sterndccf4a42005-12-17 17:58:46 -0500412 struct uhci_qh *pqh;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700413
Alan Sterndccf4a42005-12-17 17:58:46 -0500414 WARN_ON(list_empty(&qh->queue));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700415
Alan Sterndccf4a42005-12-17 17:58:46 -0500416 /* Set the element pointer if it isn't set already.
417 * This isn't needed for Isochronous queues, but it doesn't hurt. */
418 if (qh_element(qh) == UHCI_PTR_TERM) {
419 struct urb_priv *urbp = list_entry(qh->queue.next,
420 struct urb_priv, node);
421 struct uhci_td *td = list_entry(urbp->td_list.next,
422 struct uhci_td, list);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700423
Alan Sterndccf4a42005-12-17 17:58:46 -0500424 qh->element = cpu_to_le32(td->dma_handle);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700425 }
426
Alan Stern84afddd2006-05-12 11:35:45 -0400427 /* Treat the queue as if it has just advanced */
428 qh->wait_expired = 0;
429 qh->advance_jiffies = jiffies;
430
Alan Sterndccf4a42005-12-17 17:58:46 -0500431 if (qh->state == QH_STATE_ACTIVE)
432 return;
433 qh->state = QH_STATE_ACTIVE;
434
435 /* Move the QH from its old list to the end of the appropriate
436 * skeleton's list */
Alan Stern0ed8fee2005-12-17 18:02:38 -0500437 if (qh == uhci->next_qh)
438 uhci->next_qh = list_entry(qh->node.next, struct uhci_qh,
439 node);
Alan Sterndccf4a42005-12-17 17:58:46 -0500440 list_move_tail(&qh->node, &qh->skel->node);
441
442 /* Link it into the schedule */
443 pqh = list_entry(qh->node.prev, struct uhci_qh, node);
444 qh->link = pqh->link;
445 wmb();
446 pqh->link = UHCI_PTR_QH | cpu_to_le32(qh->dma_handle);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700447}
448
449/*
Alan Sterndccf4a42005-12-17 17:58:46 -0500450 * Take a QH off the hardware schedule
Linus Torvalds1da177e2005-04-16 15:20:36 -0700451 */
Alan Sterndccf4a42005-12-17 17:58:46 -0500452static void uhci_unlink_qh(struct uhci_hcd *uhci, struct uhci_qh *qh)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700453{
454 struct uhci_qh *pqh;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700455
Alan Sterndccf4a42005-12-17 17:58:46 -0500456 if (qh->state == QH_STATE_UNLINKING)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700457 return;
Alan Sterndccf4a42005-12-17 17:58:46 -0500458 WARN_ON(qh->state != QH_STATE_ACTIVE || !qh->udev);
459 qh->state = QH_STATE_UNLINKING;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700460
Alan Sterndccf4a42005-12-17 17:58:46 -0500461 /* Unlink the QH from the schedule and record when we did it */
462 pqh = list_entry(qh->node.prev, struct uhci_qh, node);
463 pqh->link = qh->link;
464 mb();
Linus Torvalds1da177e2005-04-16 15:20:36 -0700465
466 uhci_get_current_frame_number(uhci);
Alan Sterndccf4a42005-12-17 17:58:46 -0500467 qh->unlink_frame = uhci->frame_number;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700468
Alan Sterndccf4a42005-12-17 17:58:46 -0500469 /* Force an interrupt so we know when the QH is fully unlinked */
470 if (list_empty(&uhci->skel_unlink_qh->node))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700471 uhci_set_next_interrupt(uhci);
472
Alan Sterndccf4a42005-12-17 17:58:46 -0500473 /* Move the QH from its old list to the end of the unlinking list */
Alan Stern0ed8fee2005-12-17 18:02:38 -0500474 if (qh == uhci->next_qh)
475 uhci->next_qh = list_entry(qh->node.next, struct uhci_qh,
476 node);
Alan Sterndccf4a42005-12-17 17:58:46 -0500477 list_move_tail(&qh->node, &uhci->skel_unlink_qh->node);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700478}
479
Alan Sterndccf4a42005-12-17 17:58:46 -0500480/*
481 * When we and the controller are through with a QH, it becomes IDLE.
482 * This happens when a QH has been off the schedule (on the unlinking
483 * list) for more than one frame, or when an error occurs while adding
484 * the first URB onto a new QH.
485 */
486static void uhci_make_qh_idle(struct uhci_hcd *uhci, struct uhci_qh *qh)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700487{
Alan Sterndccf4a42005-12-17 17:58:46 -0500488 WARN_ON(qh->state == QH_STATE_ACTIVE);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700489
Alan Stern0ed8fee2005-12-17 18:02:38 -0500490 if (qh == uhci->next_qh)
491 uhci->next_qh = list_entry(qh->node.next, struct uhci_qh,
492 node);
Alan Sterndccf4a42005-12-17 17:58:46 -0500493 list_move(&qh->node, &uhci->idle_qh_list);
494 qh->state = QH_STATE_IDLE;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700495
Alan Stern59e29ed2006-05-12 11:19:19 -0400496 /* Now that the QH is idle, its post_td isn't being used */
497 if (qh->post_td) {
498 uhci_free_td(uhci, qh->post_td);
499 qh->post_td = NULL;
500 }
501
Alan Sterndccf4a42005-12-17 17:58:46 -0500502 /* If anyone is waiting for a QH to become idle, wake them up */
503 if (uhci->num_waiting)
504 wake_up_all(&uhci->waitqh);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700505}
506
Alan Stern3ca2a322007-01-16 11:56:32 -0500507/*
508 * Find the highest existing bandwidth load for a given phase and period.
509 */
510static int uhci_highest_load(struct uhci_hcd *uhci, int phase, int period)
511{
512 int highest_load = uhci->load[phase];
513
514 for (phase += period; phase < MAX_PHASE; phase += period)
515 highest_load = max_t(int, highest_load, uhci->load[phase]);
516 return highest_load;
517}
518
519/*
520 * Set qh->phase to the optimal phase for a periodic transfer and
521 * check whether the bandwidth requirement is acceptable.
522 */
523static int uhci_check_bandwidth(struct uhci_hcd *uhci, struct uhci_qh *qh)
524{
525 int minimax_load;
526
527 /* Find the optimal phase (unless it is already set) and get
528 * its load value. */
529 if (qh->phase >= 0)
530 minimax_load = uhci_highest_load(uhci, qh->phase, qh->period);
531 else {
532 int phase, load;
533 int max_phase = min_t(int, MAX_PHASE, qh->period);
534
535 qh->phase = 0;
536 minimax_load = uhci_highest_load(uhci, qh->phase, qh->period);
537 for (phase = 1; phase < max_phase; ++phase) {
538 load = uhci_highest_load(uhci, phase, qh->period);
539 if (load < minimax_load) {
540 minimax_load = load;
541 qh->phase = phase;
542 }
543 }
544 }
545
546 /* Maximum allowable periodic bandwidth is 90%, or 900 us per frame */
547 if (minimax_load + qh->load > 900) {
548 dev_dbg(uhci_dev(uhci), "bandwidth allocation failed: "
549 "period %d, phase %d, %d + %d us\n",
550 qh->period, qh->phase, minimax_load, qh->load);
551 return -ENOSPC;
552 }
553 return 0;
554}
555
556/*
557 * Reserve a periodic QH's bandwidth in the schedule
558 */
559static void uhci_reserve_bandwidth(struct uhci_hcd *uhci, struct uhci_qh *qh)
560{
561 int i;
562 int load = qh->load;
563 char *p = "??";
564
565 for (i = qh->phase; i < MAX_PHASE; i += qh->period) {
566 uhci->load[i] += load;
567 uhci->total_load += load;
568 }
569 uhci_to_hcd(uhci)->self.bandwidth_allocated =
570 uhci->total_load / MAX_PHASE;
571 switch (qh->type) {
572 case USB_ENDPOINT_XFER_INT:
573 ++uhci_to_hcd(uhci)->self.bandwidth_int_reqs;
574 p = "INT";
575 break;
576 case USB_ENDPOINT_XFER_ISOC:
577 ++uhci_to_hcd(uhci)->self.bandwidth_isoc_reqs;
578 p = "ISO";
579 break;
580 }
581 qh->bandwidth_reserved = 1;
582 dev_dbg(uhci_dev(uhci),
583 "%s dev %d ep%02x-%s, period %d, phase %d, %d us\n",
584 "reserve", qh->udev->devnum,
585 qh->hep->desc.bEndpointAddress, p,
586 qh->period, qh->phase, load);
587}
588
589/*
590 * Release a periodic QH's bandwidth reservation
591 */
592static void uhci_release_bandwidth(struct uhci_hcd *uhci, struct uhci_qh *qh)
593{
594 int i;
595 int load = qh->load;
596 char *p = "??";
597
598 for (i = qh->phase; i < MAX_PHASE; i += qh->period) {
599 uhci->load[i] -= load;
600 uhci->total_load -= load;
601 }
602 uhci_to_hcd(uhci)->self.bandwidth_allocated =
603 uhci->total_load / MAX_PHASE;
604 switch (qh->type) {
605 case USB_ENDPOINT_XFER_INT:
606 --uhci_to_hcd(uhci)->self.bandwidth_int_reqs;
607 p = "INT";
608 break;
609 case USB_ENDPOINT_XFER_ISOC:
610 --uhci_to_hcd(uhci)->self.bandwidth_isoc_reqs;
611 p = "ISO";
612 break;
613 }
614 qh->bandwidth_reserved = 0;
615 dev_dbg(uhci_dev(uhci),
616 "%s dev %d ep%02x-%s, period %d, phase %d, %d us\n",
617 "release", qh->udev->devnum,
618 qh->hep->desc.bEndpointAddress, p,
619 qh->period, qh->phase, load);
620}
621
Alan Sterndccf4a42005-12-17 17:58:46 -0500622static inline struct urb_priv *uhci_alloc_urb_priv(struct uhci_hcd *uhci,
623 struct urb *urb)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700624{
625 struct urb_priv *urbp;
626
Christoph Lameter54e6ecb2006-12-06 20:33:16 -0800627 urbp = kmem_cache_alloc(uhci_up_cachep, GFP_ATOMIC);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700628 if (!urbp)
629 return NULL;
630
631 memset((void *)urbp, 0, sizeof(*urbp));
632
Linus Torvalds1da177e2005-04-16 15:20:36 -0700633 urbp->urb = urb;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700634 urb->hcpriv = urbp;
Alan Sterndccf4a42005-12-17 17:58:46 -0500635
636 INIT_LIST_HEAD(&urbp->node);
637 INIT_LIST_HEAD(&urbp->td_list);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700638
639 return urbp;
640}
641
Alan Sterndccf4a42005-12-17 17:58:46 -0500642static void uhci_free_urb_priv(struct uhci_hcd *uhci,
643 struct urb_priv *urbp)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700644{
645 struct uhci_td *td, *tmp;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700646
Alan Sterndccf4a42005-12-17 17:58:46 -0500647 if (!list_empty(&urbp->node))
648 dev_warn(uhci_dev(uhci), "urb %p still on QH's list!\n",
649 urbp->urb);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700650
Linus Torvalds1da177e2005-04-16 15:20:36 -0700651 list_for_each_entry_safe(td, tmp, &urbp->td_list, list) {
Alan Stern04538a22006-05-12 11:29:04 -0400652 uhci_remove_td_from_urbp(td);
653 uhci_free_td(uhci, td);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700654 }
655
Alan Sterndccf4a42005-12-17 17:58:46 -0500656 urbp->urb->hcpriv = NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700657 kmem_cache_free(uhci_up_cachep, urbp);
658}
659
Linus Torvalds1da177e2005-04-16 15:20:36 -0700660/*
661 * Map status to standard result codes
662 *
663 * <status> is (td_status(td) & 0xF60000), a.k.a.
664 * uhci_status_bits(td_status(td)).
665 * Note: <status> does not include the TD_CTRL_NAK bit.
666 * <dir_out> is True for output TDs and False for input TDs.
667 */
668static int uhci_map_status(int status, int dir_out)
669{
670 if (!status)
671 return 0;
672 if (status & TD_CTRL_BITSTUFF) /* Bitstuff error */
673 return -EPROTO;
674 if (status & TD_CTRL_CRCTIMEO) { /* CRC/Timeout */
675 if (dir_out)
676 return -EPROTO;
677 else
678 return -EILSEQ;
679 }
680 if (status & TD_CTRL_BABBLE) /* Babble */
681 return -EOVERFLOW;
682 if (status & TD_CTRL_DBUFERR) /* Buffer error */
683 return -ENOSR;
684 if (status & TD_CTRL_STALLED) /* Stalled */
685 return -EPIPE;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700686 return 0;
687}
688
689/*
690 * Control transfers
691 */
Alan Sterndccf4a42005-12-17 17:58:46 -0500692static int uhci_submit_control(struct uhci_hcd *uhci, struct urb *urb,
693 struct uhci_qh *qh)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700694{
Linus Torvalds1da177e2005-04-16 15:20:36 -0700695 struct uhci_td *td;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700696 unsigned long destination, status;
Alan Sterndccf4a42005-12-17 17:58:46 -0500697 int maxsze = le16_to_cpu(qh->hep->desc.wMaxPacketSize);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700698 int len = urb->transfer_buffer_length;
699 dma_addr_t data = urb->transfer_dma;
Alan Sterndccf4a42005-12-17 17:58:46 -0500700 __le32 *plink;
Alan Stern04538a22006-05-12 11:29:04 -0400701 struct urb_priv *urbp = urb->hcpriv;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700702
703 /* The "pipe" thing contains the destination in bits 8--18 */
704 destination = (urb->pipe & PIPE_DEVEP_MASK) | USB_PID_SETUP;
705
Alan Sternaf0bb592005-12-17 18:00:12 -0500706 /* 3 errors, dummy TD remains inactive */
707 status = uhci_maxerr(3);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700708 if (urb->dev->speed == USB_SPEED_LOW)
709 status |= TD_CTRL_LS;
710
711 /*
712 * Build the TD for the control request setup packet
713 */
Alan Sternaf0bb592005-12-17 18:00:12 -0500714 td = qh->dummy_td;
Alan Stern04538a22006-05-12 11:29:04 -0400715 uhci_add_td_to_urbp(td, urbp);
Alan Sternfa346562005-11-30 11:57:51 -0500716 uhci_fill_td(td, status, destination | uhci_explen(8),
Alan Sterndccf4a42005-12-17 17:58:46 -0500717 urb->setup_dma);
718 plink = &td->link;
Alan Sternaf0bb592005-12-17 18:00:12 -0500719 status |= TD_CTRL_ACTIVE;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700720
721 /*
722 * If direction is "send", change the packet ID from SETUP (0x2D)
723 * to OUT (0xE1). Else change it from SETUP to IN (0x69) and
724 * set Short Packet Detect (SPD) for all data packets.
725 */
726 if (usb_pipeout(urb->pipe))
727 destination ^= (USB_PID_SETUP ^ USB_PID_OUT);
728 else {
729 destination ^= (USB_PID_SETUP ^ USB_PID_IN);
730 status |= TD_CTRL_SPD;
731 }
732
733 /*
Alan Stern687f5f32005-11-30 17:16:19 -0500734 * Build the DATA TDs
Linus Torvalds1da177e2005-04-16 15:20:36 -0700735 */
736 while (len > 0) {
Alan Sterndccf4a42005-12-17 17:58:46 -0500737 int pktsze = min(len, maxsze);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700738
Alan Stern25321782005-04-25 11:14:31 -0400739 td = uhci_alloc_td(uhci);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700740 if (!td)
Alan Sternaf0bb592005-12-17 18:00:12 -0500741 goto nomem;
Alan Sterndccf4a42005-12-17 17:58:46 -0500742 *plink = cpu_to_le32(td->dma_handle);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700743
744 /* Alternate Data0/1 (start with Data1) */
745 destination ^= TD_TOKEN_TOGGLE;
746
Alan Stern04538a22006-05-12 11:29:04 -0400747 uhci_add_td_to_urbp(td, urbp);
Alan Sternfa346562005-11-30 11:57:51 -0500748 uhci_fill_td(td, status, destination | uhci_explen(pktsze),
Alan Sterndccf4a42005-12-17 17:58:46 -0500749 data);
750 plink = &td->link;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700751
752 data += pktsze;
753 len -= pktsze;
754 }
755
756 /*
757 * Build the final TD for control status
758 */
Alan Stern25321782005-04-25 11:14:31 -0400759 td = uhci_alloc_td(uhci);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700760 if (!td)
Alan Sternaf0bb592005-12-17 18:00:12 -0500761 goto nomem;
Alan Sterndccf4a42005-12-17 17:58:46 -0500762 *plink = cpu_to_le32(td->dma_handle);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700763
764 /*
765 * It's IN if the pipe is an output pipe or we're not expecting
766 * data back.
767 */
768 destination &= ~TD_TOKEN_PID_MASK;
769 if (usb_pipeout(urb->pipe) || !urb->transfer_buffer_length)
770 destination |= USB_PID_IN;
771 else
772 destination |= USB_PID_OUT;
773
774 destination |= TD_TOKEN_TOGGLE; /* End in Data1 */
775
776 status &= ~TD_CTRL_SPD;
777
Alan Stern04538a22006-05-12 11:29:04 -0400778 uhci_add_td_to_urbp(td, urbp);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700779 uhci_fill_td(td, status | TD_CTRL_IOC,
Alan Sterndccf4a42005-12-17 17:58:46 -0500780 destination | uhci_explen(0), 0);
Alan Sternaf0bb592005-12-17 18:00:12 -0500781 plink = &td->link;
782
783 /*
784 * Build the new dummy TD and activate the old one
785 */
786 td = uhci_alloc_td(uhci);
787 if (!td)
788 goto nomem;
789 *plink = cpu_to_le32(td->dma_handle);
790
791 uhci_fill_td(td, 0, USB_PID_OUT | uhci_explen(0), 0);
792 wmb();
793 qh->dummy_td->status |= __constant_cpu_to_le32(TD_CTRL_ACTIVE);
794 qh->dummy_td = td;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700795
796 /* Low-speed transfers get a different queue, and won't hog the bus.
797 * Also, some devices enumerate better without FSBR; the easiest way
798 * to do that is to put URBs on the low-speed queue while the device
Alan Stern630aa3c2006-01-23 17:17:21 -0500799 * isn't in the CONFIGURED state. */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700800 if (urb->dev->speed == USB_SPEED_LOW ||
Alan Stern630aa3c2006-01-23 17:17:21 -0500801 urb->dev->state != USB_STATE_CONFIGURED)
Alan Sterndccf4a42005-12-17 17:58:46 -0500802 qh->skel = uhci->skel_ls_control_qh;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700803 else {
Alan Sterndccf4a42005-12-17 17:58:46 -0500804 qh->skel = uhci->skel_fs_control_qh;
Alan Stern84afddd2006-05-12 11:35:45 -0400805 uhci_add_fsbr(uhci, urb);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700806 }
Alan Stern59e29ed2006-05-12 11:19:19 -0400807
808 urb->actual_length = -8; /* Account for the SETUP packet */
Alan Sterndccf4a42005-12-17 17:58:46 -0500809 return 0;
Alan Sternaf0bb592005-12-17 18:00:12 -0500810
811nomem:
812 /* Remove the dummy TD from the td_list so it doesn't get freed */
Alan Stern04538a22006-05-12 11:29:04 -0400813 uhci_remove_td_from_urbp(qh->dummy_td);
Alan Sternaf0bb592005-12-17 18:00:12 -0500814 return -ENOMEM;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700815}
816
817/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700818 * Common submit for bulk and interrupt
819 */
Alan Sterndccf4a42005-12-17 17:58:46 -0500820static int uhci_submit_common(struct uhci_hcd *uhci, struct urb *urb,
821 struct uhci_qh *qh)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700822{
823 struct uhci_td *td;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700824 unsigned long destination, status;
Alan Sterndccf4a42005-12-17 17:58:46 -0500825 int maxsze = le16_to_cpu(qh->hep->desc.wMaxPacketSize);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700826 int len = urb->transfer_buffer_length;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700827 dma_addr_t data = urb->transfer_dma;
Alan Sternaf0bb592005-12-17 18:00:12 -0500828 __le32 *plink;
Alan Stern04538a22006-05-12 11:29:04 -0400829 struct urb_priv *urbp = urb->hcpriv;
Alan Sternaf0bb592005-12-17 18:00:12 -0500830 unsigned int toggle;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700831
832 if (len < 0)
833 return -EINVAL;
834
835 /* The "pipe" thing contains the destination in bits 8--18 */
836 destination = (urb->pipe & PIPE_DEVEP_MASK) | usb_packetid(urb->pipe);
Alan Sternaf0bb592005-12-17 18:00:12 -0500837 toggle = usb_gettoggle(urb->dev, usb_pipeendpoint(urb->pipe),
838 usb_pipeout(urb->pipe));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700839
Alan Sternaf0bb592005-12-17 18:00:12 -0500840 /* 3 errors, dummy TD remains inactive */
841 status = uhci_maxerr(3);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700842 if (urb->dev->speed == USB_SPEED_LOW)
843 status |= TD_CTRL_LS;
844 if (usb_pipein(urb->pipe))
845 status |= TD_CTRL_SPD;
846
847 /*
Alan Stern687f5f32005-11-30 17:16:19 -0500848 * Build the DATA TDs
Linus Torvalds1da177e2005-04-16 15:20:36 -0700849 */
Alan Sternaf0bb592005-12-17 18:00:12 -0500850 plink = NULL;
851 td = qh->dummy_td;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700852 do { /* Allow zero length packets */
853 int pktsze = maxsze;
854
Alan Sterndccf4a42005-12-17 17:58:46 -0500855 if (len <= pktsze) { /* The last packet */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700856 pktsze = len;
857 if (!(urb->transfer_flags & URB_SHORT_NOT_OK))
858 status &= ~TD_CTRL_SPD;
859 }
860
Alan Sternaf0bb592005-12-17 18:00:12 -0500861 if (plink) {
862 td = uhci_alloc_td(uhci);
863 if (!td)
864 goto nomem;
865 *plink = cpu_to_le32(td->dma_handle);
866 }
Alan Stern04538a22006-05-12 11:29:04 -0400867 uhci_add_td_to_urbp(td, urbp);
Alan Sterndccf4a42005-12-17 17:58:46 -0500868 uhci_fill_td(td, status,
Alan Sternaf0bb592005-12-17 18:00:12 -0500869 destination | uhci_explen(pktsze) |
870 (toggle << TD_TOKEN_TOGGLE_SHIFT),
871 data);
Alan Sterndccf4a42005-12-17 17:58:46 -0500872 plink = &td->link;
Alan Sternaf0bb592005-12-17 18:00:12 -0500873 status |= TD_CTRL_ACTIVE;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700874
875 data += pktsze;
876 len -= maxsze;
Alan Sternaf0bb592005-12-17 18:00:12 -0500877 toggle ^= 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700878 } while (len > 0);
879
880 /*
881 * URB_ZERO_PACKET means adding a 0-length packet, if direction
882 * is OUT and the transfer_length was an exact multiple of maxsze,
883 * hence (len = transfer_length - N * maxsze) == 0
884 * however, if transfer_length == 0, the zero packet was already
885 * prepared above.
886 */
Alan Sterndccf4a42005-12-17 17:58:46 -0500887 if ((urb->transfer_flags & URB_ZERO_PACKET) &&
888 usb_pipeout(urb->pipe) && len == 0 &&
889 urb->transfer_buffer_length > 0) {
Alan Stern25321782005-04-25 11:14:31 -0400890 td = uhci_alloc_td(uhci);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700891 if (!td)
Alan Sternaf0bb592005-12-17 18:00:12 -0500892 goto nomem;
Alan Sterndccf4a42005-12-17 17:58:46 -0500893 *plink = cpu_to_le32(td->dma_handle);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700894
Alan Stern04538a22006-05-12 11:29:04 -0400895 uhci_add_td_to_urbp(td, urbp);
Alan Sternaf0bb592005-12-17 18:00:12 -0500896 uhci_fill_td(td, status,
897 destination | uhci_explen(0) |
898 (toggle << TD_TOKEN_TOGGLE_SHIFT),
899 data);
900 plink = &td->link;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700901
Alan Sternaf0bb592005-12-17 18:00:12 -0500902 toggle ^= 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700903 }
904
905 /* Set the interrupt-on-completion flag on the last packet.
906 * A more-or-less typical 4 KB URB (= size of one memory page)
907 * will require about 3 ms to transfer; that's a little on the
908 * fast side but not enough to justify delaying an interrupt
909 * more than 2 or 3 URBs, so we will ignore the URB_NO_INTERRUPT
910 * flag setting. */
Alan Sterndccf4a42005-12-17 17:58:46 -0500911 td->status |= __constant_cpu_to_le32(TD_CTRL_IOC);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700912
Alan Sternaf0bb592005-12-17 18:00:12 -0500913 /*
914 * Build the new dummy TD and activate the old one
915 */
916 td = uhci_alloc_td(uhci);
917 if (!td)
918 goto nomem;
919 *plink = cpu_to_le32(td->dma_handle);
920
921 uhci_fill_td(td, 0, USB_PID_OUT | uhci_explen(0), 0);
922 wmb();
923 qh->dummy_td->status |= __constant_cpu_to_le32(TD_CTRL_ACTIVE);
924 qh->dummy_td = td;
925
926 usb_settoggle(urb->dev, usb_pipeendpoint(urb->pipe),
927 usb_pipeout(urb->pipe), toggle);
Alan Sterndccf4a42005-12-17 17:58:46 -0500928 return 0;
Alan Sternaf0bb592005-12-17 18:00:12 -0500929
930nomem:
931 /* Remove the dummy TD from the td_list so it doesn't get freed */
Alan Stern04538a22006-05-12 11:29:04 -0400932 uhci_remove_td_from_urbp(qh->dummy_td);
Alan Sternaf0bb592005-12-17 18:00:12 -0500933 return -ENOMEM;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700934}
935
Alan Sterndccf4a42005-12-17 17:58:46 -0500936static inline int uhci_submit_bulk(struct uhci_hcd *uhci, struct urb *urb,
937 struct uhci_qh *qh)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700938{
939 int ret;
940
941 /* Can't have low-speed bulk transfers */
942 if (urb->dev->speed == USB_SPEED_LOW)
943 return -EINVAL;
944
Alan Sterndccf4a42005-12-17 17:58:46 -0500945 qh->skel = uhci->skel_bulk_qh;
946 ret = uhci_submit_common(uhci, urb, qh);
947 if (ret == 0)
Alan Stern84afddd2006-05-12 11:35:45 -0400948 uhci_add_fsbr(uhci, urb);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700949 return ret;
950}
951
Alan Sterncaf38272006-05-19 16:44:55 -0400952static int uhci_submit_interrupt(struct uhci_hcd *uhci, struct urb *urb,
Alan Sterndccf4a42005-12-17 17:58:46 -0500953 struct uhci_qh *qh)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700954{
Alan Stern3ca2a322007-01-16 11:56:32 -0500955 int ret;
Alan Sterncaf38272006-05-19 16:44:55 -0400956
Alan Sterndccf4a42005-12-17 17:58:46 -0500957 /* USB 1.1 interrupt transfers only involve one packet per interval.
958 * Drivers can submit URBs of any length, but longer ones will need
959 * multiple intervals to complete.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700960 */
Alan Sterncaf38272006-05-19 16:44:55 -0400961
Alan Stern3ca2a322007-01-16 11:56:32 -0500962 if (!qh->bandwidth_reserved) {
963 int exponent;
Alan Sterncaf38272006-05-19 16:44:55 -0400964
Alan Stern3ca2a322007-01-16 11:56:32 -0500965 /* Figure out which power-of-two queue to use */
966 for (exponent = 7; exponent >= 0; --exponent) {
967 if ((1 << exponent) <= urb->interval)
968 break;
969 }
970 if (exponent < 0)
971 return -EINVAL;
972 qh->period = 1 << exponent;
Alan Sterncaf38272006-05-19 16:44:55 -0400973 qh->skel = uhci->skelqh[UHCI_SKEL_INDEX(exponent)];
Alan Sterncaf38272006-05-19 16:44:55 -0400974
Alan Stern3ca2a322007-01-16 11:56:32 -0500975 /* For now, interrupt phase is fixed by the layout
976 * of the QH lists. */
977 qh->phase = (qh->period / 2) & (MAX_PHASE - 1);
978 ret = uhci_check_bandwidth(uhci, qh);
979 if (ret)
980 return ret;
981 } else if (qh->period > urb->interval)
982 return -EINVAL; /* Can't decrease the period */
983
984 ret = uhci_submit_common(uhci, urb, qh);
985 if (ret == 0) {
986 urb->interval = qh->period;
987 if (!qh->bandwidth_reserved)
988 uhci_reserve_bandwidth(uhci, qh);
989 }
990 return ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700991}
992
993/*
Alan Sternb1869002006-05-12 11:14:25 -0400994 * Fix up the data structures following a short transfer
995 */
996static int uhci_fixup_short_transfer(struct uhci_hcd *uhci,
Alan Stern59e29ed2006-05-12 11:19:19 -0400997 struct uhci_qh *qh, struct urb_priv *urbp)
Alan Sternb1869002006-05-12 11:14:25 -0400998{
999 struct uhci_td *td;
Alan Stern59e29ed2006-05-12 11:19:19 -04001000 struct list_head *tmp;
1001 int ret;
Alan Sternb1869002006-05-12 11:14:25 -04001002
1003 td = list_entry(urbp->td_list.prev, struct uhci_td, list);
1004 if (qh->type == USB_ENDPOINT_XFER_CONTROL) {
Alan Sternb1869002006-05-12 11:14:25 -04001005
1006 /* When a control transfer is short, we have to restart
1007 * the queue at the status stage transaction, which is
1008 * the last TD. */
Alan Stern59e29ed2006-05-12 11:19:19 -04001009 WARN_ON(list_empty(&urbp->td_list));
Alan Sternb1869002006-05-12 11:14:25 -04001010 qh->element = cpu_to_le32(td->dma_handle);
Alan Stern59e29ed2006-05-12 11:19:19 -04001011 tmp = td->list.prev;
Alan Sternb1869002006-05-12 11:14:25 -04001012 ret = -EINPROGRESS;
1013
Alan Stern59e29ed2006-05-12 11:19:19 -04001014 } else {
Alan Sternb1869002006-05-12 11:14:25 -04001015
1016 /* When a bulk/interrupt transfer is short, we have to
1017 * fix up the toggles of the following URBs on the queue
1018 * before restarting the queue at the next URB. */
Alan Stern59e29ed2006-05-12 11:19:19 -04001019 qh->initial_toggle = uhci_toggle(td_token(qh->post_td)) ^ 1;
Alan Sternb1869002006-05-12 11:14:25 -04001020 uhci_fixup_toggles(qh, 1);
1021
Alan Stern59e29ed2006-05-12 11:19:19 -04001022 if (list_empty(&urbp->td_list))
1023 td = qh->post_td;
Alan Sternb1869002006-05-12 11:14:25 -04001024 qh->element = td->link;
Alan Stern59e29ed2006-05-12 11:19:19 -04001025 tmp = urbp->td_list.prev;
1026 ret = 0;
Alan Sternb1869002006-05-12 11:14:25 -04001027 }
1028
Alan Stern59e29ed2006-05-12 11:19:19 -04001029 /* Remove all the TDs we skipped over, from tmp back to the start */
1030 while (tmp != &urbp->td_list) {
1031 td = list_entry(tmp, struct uhci_td, list);
1032 tmp = tmp->prev;
1033
Alan Stern04538a22006-05-12 11:29:04 -04001034 uhci_remove_td_from_urbp(td);
1035 uhci_free_td(uhci, td);
Alan Stern59e29ed2006-05-12 11:19:19 -04001036 }
Alan Sternb1869002006-05-12 11:14:25 -04001037 return ret;
1038}
1039
1040/*
1041 * Common result for control, bulk, and interrupt
1042 */
1043static int uhci_result_common(struct uhci_hcd *uhci, struct urb *urb)
1044{
1045 struct urb_priv *urbp = urb->hcpriv;
1046 struct uhci_qh *qh = urbp->qh;
Alan Stern59e29ed2006-05-12 11:19:19 -04001047 struct uhci_td *td, *tmp;
Alan Sternb1869002006-05-12 11:14:25 -04001048 unsigned status;
1049 int ret = 0;
1050
Alan Stern59e29ed2006-05-12 11:19:19 -04001051 list_for_each_entry_safe(td, tmp, &urbp->td_list, list) {
Alan Sternb1869002006-05-12 11:14:25 -04001052 unsigned int ctrlstat;
1053 int len;
1054
Alan Sternb1869002006-05-12 11:14:25 -04001055 ctrlstat = td_status(td);
1056 status = uhci_status_bits(ctrlstat);
1057 if (status & TD_CTRL_ACTIVE)
1058 return -EINPROGRESS;
1059
1060 len = uhci_actual_length(ctrlstat);
1061 urb->actual_length += len;
1062
1063 if (status) {
1064 ret = uhci_map_status(status,
1065 uhci_packetout(td_token(td)));
1066 if ((debug == 1 && ret != -EPIPE) || debug > 1) {
1067 /* Some debugging code */
David Brownellbe3cbc52006-06-05 12:16:39 -04001068 dev_dbg(&urb->dev->dev,
Alan Sternb1869002006-05-12 11:14:25 -04001069 "%s: failed with status %x\n",
1070 __FUNCTION__, status);
1071
1072 if (debug > 1 && errbuf) {
1073 /* Print the chain for debugging */
1074 uhci_show_qh(urbp->qh, errbuf,
1075 ERRBUF_LEN, 0);
1076 lprintk(errbuf);
1077 }
1078 }
1079
1080 } else if (len < uhci_expected_length(td_token(td))) {
1081
1082 /* We received a short packet */
1083 if (urb->transfer_flags & URB_SHORT_NOT_OK)
1084 ret = -EREMOTEIO;
Alan Sternf443ddf2006-07-31 10:16:24 -04001085
1086 /* Fixup needed only if this isn't the URB's last TD */
1087 else if (&td->list != urbp->td_list.prev)
Alan Sternb1869002006-05-12 11:14:25 -04001088 ret = 1;
1089 }
1090
Alan Stern04538a22006-05-12 11:29:04 -04001091 uhci_remove_td_from_urbp(td);
Alan Stern59e29ed2006-05-12 11:19:19 -04001092 if (qh->post_td)
Alan Stern04538a22006-05-12 11:29:04 -04001093 uhci_free_td(uhci, qh->post_td);
Alan Stern59e29ed2006-05-12 11:19:19 -04001094 qh->post_td = td;
1095
Alan Sternb1869002006-05-12 11:14:25 -04001096 if (ret != 0)
1097 goto err;
1098 }
1099 return ret;
1100
1101err:
1102 if (ret < 0) {
1103 /* In case a control transfer gets an error
1104 * during the setup stage */
1105 urb->actual_length = max(urb->actual_length, 0);
1106
1107 /* Note that the queue has stopped and save
1108 * the next toggle value */
1109 qh->element = UHCI_PTR_TERM;
1110 qh->is_stopped = 1;
1111 qh->needs_fixup = (qh->type != USB_ENDPOINT_XFER_CONTROL);
1112 qh->initial_toggle = uhci_toggle(td_token(td)) ^
1113 (ret == -EREMOTEIO);
1114
1115 } else /* Short packet received */
Alan Stern59e29ed2006-05-12 11:19:19 -04001116 ret = uhci_fixup_short_transfer(uhci, qh, urbp);
Alan Sternb1869002006-05-12 11:14:25 -04001117 return ret;
1118}
1119
1120/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07001121 * Isochronous transfers
1122 */
Alan Sterndccf4a42005-12-17 17:58:46 -05001123static int uhci_submit_isochronous(struct uhci_hcd *uhci, struct urb *urb,
1124 struct uhci_qh *qh)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001125{
Alan Sterndccf4a42005-12-17 17:58:46 -05001126 struct uhci_td *td = NULL; /* Since urb->number_of_packets > 0 */
Alan Stern0ed8fee2005-12-17 18:02:38 -05001127 int i, frame;
Alan Sterndccf4a42005-12-17 17:58:46 -05001128 unsigned long destination, status;
Alan Sternb81d3432005-10-13 17:00:24 -04001129 struct urb_priv *urbp = (struct urb_priv *) urb->hcpriv;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001130
Alan Sterncaf38272006-05-19 16:44:55 -04001131 /* Values must not be too big (could overflow below) */
1132 if (urb->interval >= UHCI_NUMFRAMES ||
1133 urb->number_of_packets >= UHCI_NUMFRAMES)
1134 return -EFBIG;
1135
1136 /* Check the period and figure out the starting frame number */
Alan Stern3ca2a322007-01-16 11:56:32 -05001137 if (!qh->bandwidth_reserved) {
1138 qh->period = urb->interval;
Alan Sterncaf38272006-05-19 16:44:55 -04001139 if (urb->transfer_flags & URB_ISO_ASAP) {
Alan Stern3ca2a322007-01-16 11:56:32 -05001140 qh->phase = -1; /* Find the best phase */
1141 i = uhci_check_bandwidth(uhci, qh);
1142 if (i)
1143 return i;
1144
1145 /* Allow a little time to allocate the TDs */
Alan Sternc8155cc2006-05-19 16:52:35 -04001146 uhci_get_current_frame_number(uhci);
Alan Stern3ca2a322007-01-16 11:56:32 -05001147 frame = uhci->frame_number + 10;
1148
1149 /* Move forward to the first frame having the
1150 * correct phase */
1151 urb->start_frame = frame + ((qh->phase - frame) &
1152 (qh->period - 1));
Alan Sterncaf38272006-05-19 16:44:55 -04001153 } else {
Alan Sternc8155cc2006-05-19 16:52:35 -04001154 i = urb->start_frame - uhci->last_iso_frame;
Alan Sterncaf38272006-05-19 16:44:55 -04001155 if (i <= 0 || i >= UHCI_NUMFRAMES)
1156 return -EINVAL;
Alan Stern3ca2a322007-01-16 11:56:32 -05001157 qh->phase = urb->start_frame & (qh->period - 1);
1158 i = uhci_check_bandwidth(uhci, qh);
1159 if (i)
1160 return i;
Alan Sterncaf38272006-05-19 16:44:55 -04001161 }
Alan Stern3ca2a322007-01-16 11:56:32 -05001162
Alan Sterncaf38272006-05-19 16:44:55 -04001163 } else if (qh->period != urb->interval) {
1164 return -EINVAL; /* Can't change the period */
1165
1166 } else { /* Pick up where the last URB leaves off */
1167 if (list_empty(&qh->queue)) {
Alan Sternc8155cc2006-05-19 16:52:35 -04001168 frame = qh->iso_frame;
Alan Sterncaf38272006-05-19 16:44:55 -04001169 } else {
1170 struct urb *lurb;
1171
1172 lurb = list_entry(qh->queue.prev,
1173 struct urb_priv, node)->urb;
1174 frame = lurb->start_frame +
1175 lurb->number_of_packets *
1176 lurb->interval;
1177 }
1178 if (urb->transfer_flags & URB_ISO_ASAP)
1179 urb->start_frame = frame;
Alan Sternc8155cc2006-05-19 16:52:35 -04001180 else if (urb->start_frame != frame)
1181 return -EINVAL;
Alan Sterncaf38272006-05-19 16:44:55 -04001182 }
1183
1184 /* Make sure we won't have to go too far into the future */
Alan Sternc8155cc2006-05-19 16:52:35 -04001185 if (uhci_frame_before_eq(uhci->last_iso_frame + UHCI_NUMFRAMES,
Alan Sterncaf38272006-05-19 16:44:55 -04001186 urb->start_frame + urb->number_of_packets *
1187 urb->interval))
Alan Stern0ed8fee2005-12-17 18:02:38 -05001188 return -EFBIG;
1189
Linus Torvalds1da177e2005-04-16 15:20:36 -07001190 status = TD_CTRL_ACTIVE | TD_CTRL_IOS;
1191 destination = (urb->pipe & PIPE_DEVEP_MASK) | usb_packetid(urb->pipe);
1192
Alan Sternb81d3432005-10-13 17:00:24 -04001193 for (i = 0; i < urb->number_of_packets; i++) {
Alan Stern25321782005-04-25 11:14:31 -04001194 td = uhci_alloc_td(uhci);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001195 if (!td)
1196 return -ENOMEM;
1197
Alan Stern04538a22006-05-12 11:29:04 -04001198 uhci_add_td_to_urbp(td, urbp);
Alan Sterndccf4a42005-12-17 17:58:46 -05001199 uhci_fill_td(td, status, destination |
1200 uhci_explen(urb->iso_frame_desc[i].length),
1201 urb->transfer_dma +
1202 urb->iso_frame_desc[i].offset);
Alan Sternb81d3432005-10-13 17:00:24 -04001203 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001204
Alan Sterndccf4a42005-12-17 17:58:46 -05001205 /* Set the interrupt-on-completion flag on the last packet. */
1206 td->status |= __constant_cpu_to_le32(TD_CTRL_IOC);
1207
Alan Sterndccf4a42005-12-17 17:58:46 -05001208 /* Add the TDs to the frame list */
Alan Sternb81d3432005-10-13 17:00:24 -04001209 frame = urb->start_frame;
1210 list_for_each_entry(td, &urbp->td_list, list) {
Alan Sterndccf4a42005-12-17 17:58:46 -05001211 uhci_insert_td_in_frame_list(uhci, td, frame);
Alan Sternc8155cc2006-05-19 16:52:35 -04001212 frame += qh->period;
1213 }
1214
1215 if (list_empty(&qh->queue)) {
1216 qh->iso_packet_desc = &urb->iso_frame_desc[0];
1217 qh->iso_frame = urb->start_frame;
1218 qh->iso_status = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001219 }
1220
Alan Stern3ca2a322007-01-16 11:56:32 -05001221 qh->skel = uhci->skel_iso_qh;
1222 if (!qh->bandwidth_reserved)
1223 uhci_reserve_bandwidth(uhci, qh);
Alan Sterndccf4a42005-12-17 17:58:46 -05001224 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001225}
1226
1227static int uhci_result_isochronous(struct uhci_hcd *uhci, struct urb *urb)
1228{
Alan Sternc8155cc2006-05-19 16:52:35 -04001229 struct uhci_td *td, *tmp;
1230 struct urb_priv *urbp = urb->hcpriv;
1231 struct uhci_qh *qh = urbp->qh;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001232
Alan Sternc8155cc2006-05-19 16:52:35 -04001233 list_for_each_entry_safe(td, tmp, &urbp->td_list, list) {
1234 unsigned int ctrlstat;
1235 int status;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001236 int actlength;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001237
Alan Sternc8155cc2006-05-19 16:52:35 -04001238 if (uhci_frame_before_eq(uhci->cur_iso_frame, qh->iso_frame))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001239 return -EINPROGRESS;
1240
Alan Sternc8155cc2006-05-19 16:52:35 -04001241 uhci_remove_tds_from_frame(uhci, qh->iso_frame);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001242
Alan Sternc8155cc2006-05-19 16:52:35 -04001243 ctrlstat = td_status(td);
1244 if (ctrlstat & TD_CTRL_ACTIVE) {
1245 status = -EXDEV; /* TD was added too late? */
1246 } else {
1247 status = uhci_map_status(uhci_status_bits(ctrlstat),
1248 usb_pipeout(urb->pipe));
1249 actlength = uhci_actual_length(ctrlstat);
1250
1251 urb->actual_length += actlength;
1252 qh->iso_packet_desc->actual_length = actlength;
1253 qh->iso_packet_desc->status = status;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001254 }
1255
Alan Sternc8155cc2006-05-19 16:52:35 -04001256 if (status) {
1257 urb->error_count++;
1258 qh->iso_status = status;
1259 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001260
Alan Sternc8155cc2006-05-19 16:52:35 -04001261 uhci_remove_td_from_urbp(td);
1262 uhci_free_td(uhci, td);
1263 qh->iso_frame += qh->period;
1264 ++qh->iso_packet_desc;
1265 }
1266 return qh->iso_status;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001267}
1268
Linus Torvalds1da177e2005-04-16 15:20:36 -07001269static int uhci_urb_enqueue(struct usb_hcd *hcd,
Alan Sterndccf4a42005-12-17 17:58:46 -05001270 struct usb_host_endpoint *hep,
Al Viro55016f12005-10-21 03:21:58 -04001271 struct urb *urb, gfp_t mem_flags)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001272{
1273 int ret;
1274 struct uhci_hcd *uhci = hcd_to_uhci(hcd);
1275 unsigned long flags;
Alan Sterndccf4a42005-12-17 17:58:46 -05001276 struct urb_priv *urbp;
1277 struct uhci_qh *qh;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001278
1279 spin_lock_irqsave(&uhci->lock, flags);
1280
1281 ret = urb->status;
1282 if (ret != -EINPROGRESS) /* URB already unlinked! */
Alan Sterndccf4a42005-12-17 17:58:46 -05001283 goto done;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001284
Alan Sterndccf4a42005-12-17 17:58:46 -05001285 ret = -ENOMEM;
1286 urbp = uhci_alloc_urb_priv(uhci, urb);
1287 if (!urbp)
1288 goto done;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001289
Alan Sterndccf4a42005-12-17 17:58:46 -05001290 if (hep->hcpriv)
1291 qh = (struct uhci_qh *) hep->hcpriv;
1292 else {
1293 qh = uhci_alloc_qh(uhci, urb->dev, hep);
1294 if (!qh)
1295 goto err_no_qh;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001296 }
Alan Sterndccf4a42005-12-17 17:58:46 -05001297 urbp->qh = qh;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001298
Alan Stern4de7d2c2006-05-05 16:26:58 -04001299 switch (qh->type) {
1300 case USB_ENDPOINT_XFER_CONTROL:
Alan Sterndccf4a42005-12-17 17:58:46 -05001301 ret = uhci_submit_control(uhci, urb, qh);
1302 break;
Alan Stern4de7d2c2006-05-05 16:26:58 -04001303 case USB_ENDPOINT_XFER_BULK:
Alan Sterndccf4a42005-12-17 17:58:46 -05001304 ret = uhci_submit_bulk(uhci, urb, qh);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001305 break;
Alan Stern4de7d2c2006-05-05 16:26:58 -04001306 case USB_ENDPOINT_XFER_INT:
Alan Stern3ca2a322007-01-16 11:56:32 -05001307 ret = uhci_submit_interrupt(uhci, urb, qh);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001308 break;
Alan Stern4de7d2c2006-05-05 16:26:58 -04001309 case USB_ENDPOINT_XFER_ISOC:
Alan Sternc8155cc2006-05-19 16:52:35 -04001310 urb->error_count = 0;
Alan Sterndccf4a42005-12-17 17:58:46 -05001311 ret = uhci_submit_isochronous(uhci, urb, qh);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001312 break;
1313 }
Alan Sterndccf4a42005-12-17 17:58:46 -05001314 if (ret != 0)
1315 goto err_submit_failed;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001316
Alan Sterndccf4a42005-12-17 17:58:46 -05001317 /* Add this URB to the QH */
1318 urbp->qh = qh;
1319 list_add_tail(&urbp->node, &qh->queue);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001320
Alan Sterndccf4a42005-12-17 17:58:46 -05001321 /* If the new URB is the first and only one on this QH then either
1322 * the QH is new and idle or else it's unlinked and waiting to
Alan Stern27755622006-05-05 16:32:02 -04001323 * become idle, so we can activate it right away. But only if the
1324 * queue isn't stopped. */
Alan Stern84afddd2006-05-12 11:35:45 -04001325 if (qh->queue.next == &urbp->node && !qh->is_stopped) {
Alan Sterndccf4a42005-12-17 17:58:46 -05001326 uhci_activate_qh(uhci, qh);
Alan Sternc5e3b742006-06-05 12:28:57 -04001327 uhci_urbp_wants_fsbr(uhci, urbp);
Alan Stern84afddd2006-05-12 11:35:45 -04001328 }
Alan Sterndccf4a42005-12-17 17:58:46 -05001329 goto done;
1330
1331err_submit_failed:
1332 if (qh->state == QH_STATE_IDLE)
1333 uhci_make_qh_idle(uhci, qh); /* Reclaim unused QH */
1334
1335err_no_qh:
1336 uhci_free_urb_priv(uhci, urbp);
1337
1338done:
Linus Torvalds1da177e2005-04-16 15:20:36 -07001339 spin_unlock_irqrestore(&uhci->lock, flags);
1340 return ret;
1341}
1342
Linus Torvalds1da177e2005-04-16 15:20:36 -07001343static int uhci_urb_dequeue(struct usb_hcd *hcd, struct urb *urb)
1344{
1345 struct uhci_hcd *uhci = hcd_to_uhci(hcd);
1346 unsigned long flags;
1347 struct urb_priv *urbp;
Alan Stern10b8e472006-05-19 16:39:52 -04001348 struct uhci_qh *qh;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001349
1350 spin_lock_irqsave(&uhci->lock, flags);
1351 urbp = urb->hcpriv;
1352 if (!urbp) /* URB was never linked! */
1353 goto done;
Alan Stern10b8e472006-05-19 16:39:52 -04001354 qh = urbp->qh;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001355
Alan Sterndccf4a42005-12-17 17:58:46 -05001356 /* Remove Isochronous TDs from the frame list ASAP */
Alan Stern10b8e472006-05-19 16:39:52 -04001357 if (qh->type == USB_ENDPOINT_XFER_ISOC) {
Alan Sterndccf4a42005-12-17 17:58:46 -05001358 uhci_unlink_isochronous_tds(uhci, urb);
Alan Stern10b8e472006-05-19 16:39:52 -04001359 mb();
1360
1361 /* If the URB has already started, update the QH unlink time */
1362 uhci_get_current_frame_number(uhci);
1363 if (uhci_frame_before_eq(urb->start_frame, uhci->frame_number))
1364 qh->unlink_frame = uhci->frame_number;
1365 }
1366
1367 uhci_unlink_qh(uhci, qh);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001368
1369done:
1370 spin_unlock_irqrestore(&uhci->lock, flags);
1371 return 0;
1372}
1373
Alan Stern0ed8fee2005-12-17 18:02:38 -05001374/*
1375 * Finish unlinking an URB and give it back
1376 */
1377static void uhci_giveback_urb(struct uhci_hcd *uhci, struct uhci_qh *qh,
David Howells7d12e782006-10-05 14:55:46 +01001378 struct urb *urb)
Alan Stern0ed8fee2005-12-17 18:02:38 -05001379__releases(uhci->lock)
1380__acquires(uhci->lock)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001381{
Alan Stern0ed8fee2005-12-17 18:02:38 -05001382 struct urb_priv *urbp = (struct urb_priv *) urb->hcpriv;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001383
Alan Sternc8155cc2006-05-19 16:52:35 -04001384 /* When giving back the first URB in an Isochronous queue,
1385 * reinitialize the QH's iso-related members for the next URB. */
1386 if (qh->type == USB_ENDPOINT_XFER_ISOC &&
1387 urbp->node.prev == &qh->queue &&
1388 urbp->node.next != &qh->queue) {
1389 struct urb *nurb = list_entry(urbp->node.next,
1390 struct urb_priv, node)->urb;
1391
1392 qh->iso_packet_desc = &nurb->iso_frame_desc[0];
1393 qh->iso_frame = nurb->start_frame;
1394 qh->iso_status = 0;
1395 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001396
Alan Stern0ed8fee2005-12-17 18:02:38 -05001397 /* Take the URB off the QH's queue. If the queue is now empty,
1398 * this is a perfect time for a toggle fixup. */
1399 list_del_init(&urbp->node);
1400 if (list_empty(&qh->queue) && qh->needs_fixup) {
1401 usb_settoggle(urb->dev, usb_pipeendpoint(urb->pipe),
1402 usb_pipeout(urb->pipe), qh->initial_toggle);
1403 qh->needs_fixup = 0;
1404 }
1405
Alan Stern0ed8fee2005-12-17 18:02:38 -05001406 uhci_free_urb_priv(uhci, urbp);
1407
Alan Stern0ed8fee2005-12-17 18:02:38 -05001408 spin_unlock(&uhci->lock);
David Howells7d12e782006-10-05 14:55:46 +01001409 usb_hcd_giveback_urb(uhci_to_hcd(uhci), urb);
Alan Stern0ed8fee2005-12-17 18:02:38 -05001410 spin_lock(&uhci->lock);
1411
1412 /* If the queue is now empty, we can unlink the QH and give up its
1413 * reserved bandwidth. */
1414 if (list_empty(&qh->queue)) {
1415 uhci_unlink_qh(uhci, qh);
Alan Stern3ca2a322007-01-16 11:56:32 -05001416 if (qh->bandwidth_reserved)
1417 uhci_release_bandwidth(uhci, qh);
Alan Stern0ed8fee2005-12-17 18:02:38 -05001418 }
1419}
1420
1421/*
1422 * Scan the URBs in a QH's queue
1423 */
1424#define QH_FINISHED_UNLINKING(qh) \
1425 (qh->state == QH_STATE_UNLINKING && \
1426 uhci->frame_number + uhci->is_stopped != qh->unlink_frame)
1427
David Howells7d12e782006-10-05 14:55:46 +01001428static void uhci_scan_qh(struct uhci_hcd *uhci, struct uhci_qh *qh)
Alan Stern0ed8fee2005-12-17 18:02:38 -05001429{
1430 struct urb_priv *urbp;
1431 struct urb *urb;
1432 int status;
1433
1434 while (!list_empty(&qh->queue)) {
1435 urbp = list_entry(qh->queue.next, struct urb_priv, node);
1436 urb = urbp->urb;
1437
Alan Sternb1869002006-05-12 11:14:25 -04001438 if (qh->type == USB_ENDPOINT_XFER_ISOC)
Alan Stern0ed8fee2005-12-17 18:02:38 -05001439 status = uhci_result_isochronous(uhci, urb);
Alan Sternb1869002006-05-12 11:14:25 -04001440 else
Alan Stern0ed8fee2005-12-17 18:02:38 -05001441 status = uhci_result_common(uhci, urb);
Alan Stern0ed8fee2005-12-17 18:02:38 -05001442 if (status == -EINPROGRESS)
1443 break;
1444
1445 spin_lock(&urb->lock);
1446 if (urb->status == -EINPROGRESS) /* Not dequeued */
1447 urb->status = status;
1448 else
Alan Stern27755622006-05-05 16:32:02 -04001449 status = ECONNRESET; /* Not -ECONNRESET */
Alan Stern0ed8fee2005-12-17 18:02:38 -05001450 spin_unlock(&urb->lock);
1451
1452 /* Dequeued but completed URBs can't be given back unless
1453 * the QH is stopped or has finished unlinking. */
Alan Stern27755622006-05-05 16:32:02 -04001454 if (status == ECONNRESET) {
1455 if (QH_FINISHED_UNLINKING(qh))
1456 qh->is_stopped = 1;
1457 else if (!qh->is_stopped)
1458 return;
1459 }
Alan Stern0ed8fee2005-12-17 18:02:38 -05001460
David Howells7d12e782006-10-05 14:55:46 +01001461 uhci_giveback_urb(uhci, qh, urb);
Alan Stern7ceb9322006-08-21 11:58:50 -04001462 if (status < 0 && qh->type != USB_ENDPOINT_XFER_ISOC)
Alan Stern0ed8fee2005-12-17 18:02:38 -05001463 break;
1464 }
1465
1466 /* If the QH is neither stopped nor finished unlinking (normal case),
1467 * our work here is done. */
Alan Stern27755622006-05-05 16:32:02 -04001468 if (QH_FINISHED_UNLINKING(qh))
1469 qh->is_stopped = 1;
1470 else if (!qh->is_stopped)
Alan Stern0ed8fee2005-12-17 18:02:38 -05001471 return;
1472
1473 /* Otherwise give back each of the dequeued URBs */
Alan Stern27755622006-05-05 16:32:02 -04001474restart:
Alan Stern0ed8fee2005-12-17 18:02:38 -05001475 list_for_each_entry(urbp, &qh->queue, node) {
1476 urb = urbp->urb;
1477 if (urb->status != -EINPROGRESS) {
Alan Stern10b8e472006-05-19 16:39:52 -04001478
1479 /* Fix up the TD links and save the toggles for
1480 * non-Isochronous queues. For Isochronous queues,
1481 * test for too-recent dequeues. */
1482 if (!uhci_cleanup_queue(uhci, qh, urb)) {
1483 qh->is_stopped = 0;
1484 return;
1485 }
David Howells7d12e782006-10-05 14:55:46 +01001486 uhci_giveback_urb(uhci, qh, urb);
Alan Stern0ed8fee2005-12-17 18:02:38 -05001487 goto restart;
1488 }
1489 }
1490 qh->is_stopped = 0;
1491
1492 /* There are no more dequeued URBs. If there are still URBs on the
1493 * queue, the QH can now be re-activated. */
1494 if (!list_empty(&qh->queue)) {
1495 if (qh->needs_fixup)
1496 uhci_fixup_toggles(qh, 0);
Alan Stern84afddd2006-05-12 11:35:45 -04001497
1498 /* If the first URB on the queue wants FSBR but its time
1499 * limit has expired, set the next TD to interrupt on
1500 * completion before reactivating the QH. */
1501 urbp = list_entry(qh->queue.next, struct urb_priv, node);
1502 if (urbp->fsbr && qh->wait_expired) {
1503 struct uhci_td *td = list_entry(urbp->td_list.next,
1504 struct uhci_td, list);
1505
1506 td->status |= __cpu_to_le32(TD_CTRL_IOC);
1507 }
1508
Alan Stern0ed8fee2005-12-17 18:02:38 -05001509 uhci_activate_qh(uhci, qh);
1510 }
1511
1512 /* The queue is empty. The QH can become idle if it is fully
1513 * unlinked. */
1514 else if (QH_FINISHED_UNLINKING(qh))
1515 uhci_make_qh_idle(uhci, qh);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001516}
1517
Alan Stern0ed8fee2005-12-17 18:02:38 -05001518/*
Alan Stern84afddd2006-05-12 11:35:45 -04001519 * Check for queues that have made some forward progress.
1520 * Returns 0 if the queue is not Isochronous, is ACTIVE, and
1521 * has not advanced since last examined; 1 otherwise.
Alan Sternb761d9d2006-05-12 11:41:59 -04001522 *
1523 * Early Intel controllers have a bug which causes qh->element sometimes
1524 * not to advance when a TD completes successfully. The queue remains
1525 * stuck on the inactive completed TD. We detect such cases and advance
1526 * the element pointer by hand.
Alan Stern84afddd2006-05-12 11:35:45 -04001527 */
1528static int uhci_advance_check(struct uhci_hcd *uhci, struct uhci_qh *qh)
1529{
1530 struct urb_priv *urbp = NULL;
1531 struct uhci_td *td;
1532 int ret = 1;
1533 unsigned status;
1534
1535 if (qh->type == USB_ENDPOINT_XFER_ISOC)
Alan Sternc5e3b742006-06-05 12:28:57 -04001536 goto done;
Alan Stern84afddd2006-05-12 11:35:45 -04001537
1538 /* Treat an UNLINKING queue as though it hasn't advanced.
1539 * This is okay because reactivation will treat it as though
1540 * it has advanced, and if it is going to become IDLE then
1541 * this doesn't matter anyway. Furthermore it's possible
1542 * for an UNLINKING queue not to have any URBs at all, or
1543 * for its first URB not to have any TDs (if it was dequeued
1544 * just as it completed). So it's not easy in any case to
1545 * test whether such queues have advanced. */
1546 if (qh->state != QH_STATE_ACTIVE) {
1547 urbp = NULL;
1548 status = 0;
1549
1550 } else {
1551 urbp = list_entry(qh->queue.next, struct urb_priv, node);
1552 td = list_entry(urbp->td_list.next, struct uhci_td, list);
1553 status = td_status(td);
1554 if (!(status & TD_CTRL_ACTIVE)) {
1555
1556 /* We're okay, the queue has advanced */
1557 qh->wait_expired = 0;
1558 qh->advance_jiffies = jiffies;
Alan Sternc5e3b742006-06-05 12:28:57 -04001559 goto done;
Alan Stern84afddd2006-05-12 11:35:45 -04001560 }
1561 ret = 0;
1562 }
1563
1564 /* The queue hasn't advanced; check for timeout */
Alan Sternc5e3b742006-06-05 12:28:57 -04001565 if (qh->wait_expired)
1566 goto done;
1567
1568 if (time_after(jiffies, qh->advance_jiffies + QH_WAIT_TIMEOUT)) {
Alan Sternb761d9d2006-05-12 11:41:59 -04001569
1570 /* Detect the Intel bug and work around it */
1571 if (qh->post_td && qh_element(qh) ==
1572 cpu_to_le32(qh->post_td->dma_handle)) {
1573 qh->element = qh->post_td->link;
1574 qh->advance_jiffies = jiffies;
Alan Sternc5e3b742006-06-05 12:28:57 -04001575 ret = 1;
1576 goto done;
Alan Sternb761d9d2006-05-12 11:41:59 -04001577 }
1578
Alan Stern84afddd2006-05-12 11:35:45 -04001579 qh->wait_expired = 1;
1580
1581 /* If the current URB wants FSBR, unlink it temporarily
1582 * so that we can safely set the next TD to interrupt on
1583 * completion. That way we'll know as soon as the queue
1584 * starts moving again. */
1585 if (urbp && urbp->fsbr && !(status & TD_CTRL_IOC))
1586 uhci_unlink_qh(uhci, qh);
Alan Sternc5e3b742006-06-05 12:28:57 -04001587
1588 } else {
1589 /* Unmoving but not-yet-expired queues keep FSBR alive */
1590 if (urbp)
1591 uhci_urbp_wants_fsbr(uhci, urbp);
Alan Stern84afddd2006-05-12 11:35:45 -04001592 }
Alan Sternc5e3b742006-06-05 12:28:57 -04001593
1594done:
Alan Stern84afddd2006-05-12 11:35:45 -04001595 return ret;
1596}
1597
1598/*
Alan Stern0ed8fee2005-12-17 18:02:38 -05001599 * Process events in the schedule, but only in one thread at a time
1600 */
David Howells7d12e782006-10-05 14:55:46 +01001601static void uhci_scan_schedule(struct uhci_hcd *uhci)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001602{
Alan Stern0ed8fee2005-12-17 18:02:38 -05001603 int i;
1604 struct uhci_qh *qh;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001605
1606 /* Don't allow re-entrant calls */
1607 if (uhci->scan_in_progress) {
1608 uhci->need_rescan = 1;
1609 return;
1610 }
1611 uhci->scan_in_progress = 1;
Alan Stern84afddd2006-05-12 11:35:45 -04001612rescan:
Linus Torvalds1da177e2005-04-16 15:20:36 -07001613 uhci->need_rescan = 0;
Alan Sternc5e3b742006-06-05 12:28:57 -04001614 uhci->fsbr_is_wanted = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001615
Alan Stern6c1b4452005-04-21 16:04:58 -04001616 uhci_clear_next_interrupt(uhci);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001617 uhci_get_current_frame_number(uhci);
Alan Sternc8155cc2006-05-19 16:52:35 -04001618 uhci->cur_iso_frame = uhci->frame_number;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001619
Alan Stern0ed8fee2005-12-17 18:02:38 -05001620 /* Go through all the QH queues and process the URBs in each one */
1621 for (i = 0; i < UHCI_NUM_SKELQH - 1; ++i) {
1622 uhci->next_qh = list_entry(uhci->skelqh[i]->node.next,
1623 struct uhci_qh, node);
1624 while ((qh = uhci->next_qh) != uhci->skelqh[i]) {
1625 uhci->next_qh = list_entry(qh->node.next,
1626 struct uhci_qh, node);
Alan Stern84afddd2006-05-12 11:35:45 -04001627
1628 if (uhci_advance_check(uhci, qh)) {
David Howells7d12e782006-10-05 14:55:46 +01001629 uhci_scan_qh(uhci, qh);
Alan Sternc5e3b742006-06-05 12:28:57 -04001630 if (qh->state == QH_STATE_ACTIVE) {
1631 uhci_urbp_wants_fsbr(uhci,
1632 list_entry(qh->queue.next, struct urb_priv, node));
1633 }
Alan Stern84afddd2006-05-12 11:35:45 -04001634 }
Alan Stern0ed8fee2005-12-17 18:02:38 -05001635 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001636 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001637
Alan Sternc8155cc2006-05-19 16:52:35 -04001638 uhci->last_iso_frame = uhci->cur_iso_frame;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001639 if (uhci->need_rescan)
1640 goto rescan;
1641 uhci->scan_in_progress = 0;
1642
Alan Sternc5e3b742006-06-05 12:28:57 -04001643 if (uhci->fsbr_is_on && !uhci->fsbr_is_wanted &&
1644 !uhci->fsbr_expiring) {
1645 uhci->fsbr_expiring = 1;
1646 mod_timer(&uhci->fsbr_timer, jiffies + FSBR_OFF_DELAY);
1647 }
Alan Stern84afddd2006-05-12 11:35:45 -04001648
Alan Stern04538a22006-05-12 11:29:04 -04001649 if (list_empty(&uhci->skel_unlink_qh->node))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001650 uhci_clear_next_interrupt(uhci);
1651 else
1652 uhci_set_next_interrupt(uhci);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001653}