uhci-q.c 42.5 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
/*
 * Universal Host Controller Interface driver for USB.
 *
 * Maintainer: Alan Stern <stern@rowland.harvard.edu>
 *
 * (C) Copyright 1999 Linus Torvalds
 * (C) Copyright 1999-2002 Johannes Erdfelt, johannes@erdfelt.com
 * (C) Copyright 1999 Randy Dunlap
 * (C) Copyright 1999 Georg Acher, acher@in.tum.de
 * (C) Copyright 1999 Deti Fliegl, deti@fliegl.de
 * (C) Copyright 1999 Thomas Sailer, sailer@ife.ee.ethz.ch
 * (C) Copyright 1999 Roman Weissgaerber, weissg@vienna.at
 * (C) Copyright 2000 Yggdrasil Computing, Inc. (port of new PCI interface
 *               support from usb-ohci.c by Adam Richter, adam@yggdrasil.com).
 * (C) Copyright 1999 Gregory P. Smith (from usb-ohci.c)
16
 * (C) Copyright 2004-2006 Alan Stern, stern@rowland.harvard.edu
L
Linus Torvalds 已提交
17 18 19 20 21 22 23 24 25 26 27
 */


/*
 * Technically, updating td->status here is a race, but it's not really a
 * problem. The worst that can happen is that we set the IOC bit again
 * generating a spurious interrupt. We could fix this by creating another
 * QH and leaving the IOC bit always set, but then we would have to play
 * games with the FSBR code to make sure we get the correct order in all
 * the cases. I don't think it's worth the effort
 */
28
static void uhci_set_next_interrupt(struct uhci_hcd *uhci)
L
Linus Torvalds 已提交
29
{
30
	if (uhci->is_stopped)
31
		mod_timer(&uhci_to_hcd(uhci)->rh_timer, jiffies);
L
Linus Torvalds 已提交
32 33 34 35 36 37 38 39
	uhci->term_td->status |= cpu_to_le32(TD_CTRL_IOC); 
}

static inline void uhci_clear_next_interrupt(struct uhci_hcd *uhci)
{
	uhci->term_td->status &= ~cpu_to_le32(TD_CTRL_IOC);
}

A
Alan Stern 已提交
40 41 42 43 44 45 46 47 48

/*
 * Full-Speed Bandwidth Reclamation (FSBR).
 * We turn on FSBR whenever a queue that wants it is advancing,
 * and leave it on for a short time thereafter.
 */
static void uhci_fsbr_on(struct uhci_hcd *uhci)
{
	uhci->fsbr_is_on = 1;
49
	uhci->skel_term_qh->link = LINK_TO_QH(uhci->skel_fs_control_qh);
A
Alan Stern 已提交
50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
}

static void uhci_fsbr_off(struct uhci_hcd *uhci)
{
	uhci->fsbr_is_on = 0;
	uhci->skel_term_qh->link = UHCI_PTR_TERM;
}

static void uhci_add_fsbr(struct uhci_hcd *uhci, struct urb *urb)
{
	struct urb_priv *urbp = urb->hcpriv;

	if (!(urb->transfer_flags & URB_NO_FSBR))
		urbp->fsbr = 1;
}

66
static void uhci_urbp_wants_fsbr(struct uhci_hcd *uhci, struct urb_priv *urbp)
A
Alan Stern 已提交
67 68
{
	if (urbp->fsbr) {
69
		uhci->fsbr_is_wanted = 1;
A
Alan Stern 已提交
70 71
		if (!uhci->fsbr_is_on)
			uhci_fsbr_on(uhci);
72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87
		else if (uhci->fsbr_expiring) {
			uhci->fsbr_expiring = 0;
			del_timer(&uhci->fsbr_timer);
		}
	}
}

static void uhci_fsbr_timeout(unsigned long _uhci)
{
	struct uhci_hcd *uhci = (struct uhci_hcd *) _uhci;
	unsigned long flags;

	spin_lock_irqsave(&uhci->lock, flags);
	if (uhci->fsbr_expiring) {
		uhci->fsbr_expiring = 0;
		uhci_fsbr_off(uhci);
A
Alan Stern 已提交
88
	}
89
	spin_unlock_irqrestore(&uhci->lock, flags);
A
Alan Stern 已提交
90 91 92
}


93
static struct uhci_td *uhci_alloc_td(struct uhci_hcd *uhci)
L
Linus Torvalds 已提交
94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110
{
	dma_addr_t dma_handle;
	struct uhci_td *td;

	td = dma_pool_alloc(uhci->td_pool, GFP_ATOMIC, &dma_handle);
	if (!td)
		return NULL;

	td->dma_handle = dma_handle;
	td->frame = -1;

	INIT_LIST_HEAD(&td->list);
	INIT_LIST_HEAD(&td->fl_list);

	return td;
}

111 112 113 114 115 116 117 118 119 120
static void uhci_free_td(struct uhci_hcd *uhci, struct uhci_td *td)
{
	if (!list_empty(&td->list))
		dev_warn(uhci_dev(uhci), "td %p still in list!\n", td);
	if (!list_empty(&td->fl_list))
		dev_warn(uhci_dev(uhci), "td %p still in fl_list!\n", td);

	dma_pool_free(uhci->td_pool, td, td->dma_handle);
}

L
Linus Torvalds 已提交
121 122 123 124 125 126 127 128
static inline void uhci_fill_td(struct uhci_td *td, u32 status,
		u32 token, u32 buffer)
{
	td->status = cpu_to_le32(status);
	td->token = cpu_to_le32(token);
	td->buffer = cpu_to_le32(buffer);
}

129 130 131 132 133 134 135 136 137 138
static void uhci_add_td_to_urbp(struct uhci_td *td, struct urb_priv *urbp)
{
	list_add_tail(&td->list, &urbp->td_list);
}

static void uhci_remove_td_from_urbp(struct uhci_td *td)
{
	list_del_init(&td->list);
}

L
Linus Torvalds 已提交
139
/*
140
 * We insert Isochronous URBs directly into the frame list at the beginning
L
Linus Torvalds 已提交
141
 */
142 143
static inline void uhci_insert_td_in_frame_list(struct uhci_hcd *uhci,
		struct uhci_td *td, unsigned framenum)
L
Linus Torvalds 已提交
144 145 146 147 148 149
{
	framenum &= (UHCI_NUMFRAMES - 1);

	td->frame = framenum;

	/* Is there a TD already mapped there? */
150
	if (uhci->frame_cpu[framenum]) {
L
Linus Torvalds 已提交
151 152
		struct uhci_td *ftd, *ltd;

153
		ftd = uhci->frame_cpu[framenum];
L
Linus Torvalds 已提交
154 155 156 157 158 159
		ltd = list_entry(ftd->fl_list.prev, struct uhci_td, fl_list);

		list_add_tail(&td->fl_list, &ftd->fl_list);

		td->link = ltd->link;
		wmb();
160
		ltd->link = LINK_TO_TD(td);
L
Linus Torvalds 已提交
161
	} else {
162
		td->link = uhci->frame[framenum];
L
Linus Torvalds 已提交
163
		wmb();
164
		uhci->frame[framenum] = LINK_TO_TD(td);
165
		uhci->frame_cpu[framenum] = td;
L
Linus Torvalds 已提交
166 167 168
	}
}

169
static inline void uhci_remove_td_from_frame_list(struct uhci_hcd *uhci,
170
		struct uhci_td *td)
L
Linus Torvalds 已提交
171 172
{
	/* If it's not inserted, don't remove it */
173 174
	if (td->frame == -1) {
		WARN_ON(!list_empty(&td->fl_list));
L
Linus Torvalds 已提交
175
		return;
176
	}
L
Linus Torvalds 已提交
177

178
	if (uhci->frame_cpu[td->frame] == td) {
L
Linus Torvalds 已提交
179
		if (list_empty(&td->fl_list)) {
180 181
			uhci->frame[td->frame] = td->link;
			uhci->frame_cpu[td->frame] = NULL;
L
Linus Torvalds 已提交
182 183 184 185
		} else {
			struct uhci_td *ntd;

			ntd = list_entry(td->fl_list.next, struct uhci_td, fl_list);
186
			uhci->frame[td->frame] = LINK_TO_TD(ntd);
187
			uhci->frame_cpu[td->frame] = ntd;
L
Linus Torvalds 已提交
188 189 190 191 192 193 194 195 196 197 198 199
		}
	} else {
		struct uhci_td *ptd;

		ptd = list_entry(td->fl_list.prev, struct uhci_td, fl_list);
		ptd->link = td->link;
	}

	list_del_init(&td->fl_list);
	td->frame = -1;
}

200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217
static inline void uhci_remove_tds_from_frame(struct uhci_hcd *uhci,
		unsigned int framenum)
{
	struct uhci_td *ftd, *ltd;

	framenum &= (UHCI_NUMFRAMES - 1);

	ftd = uhci->frame_cpu[framenum];
	if (ftd) {
		ltd = list_entry(ftd->fl_list.prev, struct uhci_td, fl_list);
		uhci->frame[framenum] = ltd->link;
		uhci->frame_cpu[framenum] = NULL;

		while (!list_empty(&ftd->fl_list))
			list_del_init(ftd->fl_list.prev);
	}
}

218 219 220 221
/*
 * Remove all the TDs for an Isochronous URB from the frame list
 */
static void uhci_unlink_isochronous_tds(struct uhci_hcd *uhci, struct urb *urb)
222 223 224 225 226
{
	struct urb_priv *urbp = (struct urb_priv *) urb->hcpriv;
	struct uhci_td *td;

	list_for_each_entry(td, &urbp->td_list, list)
227
		uhci_remove_td_from_frame_list(uhci, td);
228 229
}

230 231
static struct uhci_qh *uhci_alloc_qh(struct uhci_hcd *uhci,
		struct usb_device *udev, struct usb_host_endpoint *hep)
L
Linus Torvalds 已提交
232 233 234 235 236 237 238 239
{
	dma_addr_t dma_handle;
	struct uhci_qh *qh;

	qh = dma_pool_alloc(uhci->qh_pool, GFP_ATOMIC, &dma_handle);
	if (!qh)
		return NULL;

240
	memset(qh, 0, sizeof(*qh));
L
Linus Torvalds 已提交
241 242 243 244 245
	qh->dma_handle = dma_handle;

	qh->element = UHCI_PTR_TERM;
	qh->link = UHCI_PTR_TERM;

246 247
	INIT_LIST_HEAD(&qh->queue);
	INIT_LIST_HEAD(&qh->node);
L
Linus Torvalds 已提交
248

249
	if (udev) {		/* Normal QH */
A
Alan Stern 已提交
250 251 252 253 254 255 256
		qh->type = hep->desc.bmAttributes & USB_ENDPOINT_XFERTYPE_MASK;
		if (qh->type != USB_ENDPOINT_XFER_ISOC) {
			qh->dummy_td = uhci_alloc_td(uhci);
			if (!qh->dummy_td) {
				dma_pool_free(uhci->qh_pool, qh, dma_handle);
				return NULL;
			}
A
Alan Stern 已提交
257
		}
258 259 260 261
		qh->state = QH_STATE_IDLE;
		qh->hep = hep;
		qh->udev = udev;
		hep->hcpriv = qh;
L
Linus Torvalds 已提交
262

A
Alan Stern 已提交
263 264 265 266 267 268 269 270
		if (qh->type == USB_ENDPOINT_XFER_INT ||
				qh->type == USB_ENDPOINT_XFER_ISOC)
			qh->load = usb_calc_bus_time(udev->speed,
					usb_endpoint_dir_in(&hep->desc),
					qh->type == USB_ENDPOINT_XFER_ISOC,
					le16_to_cpu(hep->desc.wMaxPacketSize))
				/ 1000 + 1;

271 272
	} else {		/* Skeleton QH */
		qh->state = QH_STATE_ACTIVE;
273
		qh->type = -1;
274
	}
L
Linus Torvalds 已提交
275 276 277 278 279
	return qh;
}

static void uhci_free_qh(struct uhci_hcd *uhci, struct uhci_qh *qh)
{
280 281
	WARN_ON(qh->state != QH_STATE_IDLE && qh->udev);
	if (!list_empty(&qh->queue))
L
Linus Torvalds 已提交
282 283
		dev_warn(uhci_dev(uhci), "qh %p list not empty!\n", qh);

284 285 286
	list_del(&qh->node);
	if (qh->udev) {
		qh->hep->hcpriv = NULL;
A
Alan Stern 已提交
287 288
		if (qh->dummy_td)
			uhci_free_td(uhci, qh->dummy_td);
289
	}
L
Linus Torvalds 已提交
290 291 292
	dma_pool_free(uhci->qh_pool, qh, qh->dma_handle);
}

293
/*
294 295 296
 * When a queue is stopped and a dequeued URB is given back, adjust
 * the previous TD link (if the URB isn't first on the queue) or
 * save its toggle value (if it is first and is currently executing).
297 298
 *
 * Returns 0 if the URB should not yet be given back, 1 otherwise.
299
 */
300
static int uhci_cleanup_queue(struct uhci_hcd *uhci, struct uhci_qh *qh,
301
		struct urb *urb)
302
{
303
	struct urb_priv *urbp = urb->hcpriv;
304
	struct uhci_td *td;
305
	int ret = 1;
306

307
	/* Isochronous pipes don't use toggles and their TD link pointers
308 309 310 311 312 313
	 * get adjusted during uhci_urb_dequeue().  But since their queues
	 * cannot truly be stopped, we have to watch out for dequeues
	 * occurring after the nominal unlink frame. */
	if (qh->type == USB_ENDPOINT_XFER_ISOC) {
		ret = (uhci->frame_number + uhci->is_stopped !=
				qh->unlink_frame);
314
		goto done;
315
	}
316 317 318 319 320 321 322 323 324 325 326 327 328 329 330

	/* If the URB isn't first on its queue, adjust the link pointer
	 * of the last TD in the previous URB.  The toggle doesn't need
	 * to be saved since this URB can't be executing yet. */
	if (qh->queue.next != &urbp->node) {
		struct urb_priv *purbp;
		struct uhci_td *ptd;

		purbp = list_entry(urbp->node.prev, struct urb_priv, node);
		WARN_ON(list_empty(&purbp->td_list));
		ptd = list_entry(purbp->td_list.prev, struct uhci_td,
				list);
		td = list_entry(urbp->td_list.prev, struct uhci_td,
				list);
		ptd->link = td->link;
331
		goto done;
332 333
	}

334 335
	/* If the QH element pointer is UHCI_PTR_TERM then then currently
	 * executing URB has already been unlinked, so this one isn't it. */
336
	if (qh_element(qh) == UHCI_PTR_TERM)
337
		goto done;
338 339
	qh->element = UHCI_PTR_TERM;

A
Alan Stern 已提交
340
	/* Control pipes don't have to worry about toggles */
341
	if (qh->type == USB_ENDPOINT_XFER_CONTROL)
342
		goto done;
343

344
	/* Save the next toggle value */
345 346 347 348
	WARN_ON(list_empty(&urbp->td_list));
	td = list_entry(urbp->td_list.next, struct uhci_td, list);
	qh->needs_fixup = 1;
	qh->initial_toggle = uhci_toggle(td_token(td));
349 350

done:
351
	return ret;
352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377
}

/*
 * Fix up the data toggles for URBs in a queue, when one of them
 * terminates early (short transfer, error, or dequeued).
 */
static void uhci_fixup_toggles(struct uhci_qh *qh, int skip_first)
{
	struct urb_priv *urbp = NULL;
	struct uhci_td *td;
	unsigned int toggle = qh->initial_toggle;
	unsigned int pipe;

	/* Fixups for a short transfer start with the second URB in the
	 * queue (the short URB is the first). */
	if (skip_first)
		urbp = list_entry(qh->queue.next, struct urb_priv, node);

	/* When starting with the first URB, if the QH element pointer is
	 * still valid then we know the URB's toggles are okay. */
	else if (qh_element(qh) != UHCI_PTR_TERM)
		toggle = 2;

	/* Fix up the toggle for the URBs in the queue.  Normally this
	 * loop won't run more than once: When an error or short transfer
	 * occurs, the queue usually gets emptied. */
378
	urbp = list_prepare_entry(urbp, &qh->queue, node);
379 380 381 382 383 384
	list_for_each_entry_continue(urbp, &qh->queue, node) {

		/* If the first TD has the right toggle value, we don't
		 * need to change any toggles in this URB */
		td = list_entry(urbp->td_list.next, struct uhci_td, list);
		if (toggle > 1 || uhci_toggle(td_token(td)) == toggle) {
A
Alan Stern 已提交
385
			td = list_entry(urbp->td_list.prev, struct uhci_td,
386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405
					list);
			toggle = uhci_toggle(td_token(td)) ^ 1;

		/* Otherwise all the toggles in the URB have to be switched */
		} else {
			list_for_each_entry(td, &urbp->td_list, list) {
				td->token ^= __constant_cpu_to_le32(
							TD_TOKEN_TOGGLE);
				toggle ^= 1;
			}
		}
	}

	wmb();
	pipe = list_entry(qh->queue.next, struct urb_priv, node)->urb->pipe;
	usb_settoggle(qh->udev, usb_pipeendpoint(pipe),
			usb_pipeout(pipe), toggle);
	qh->needs_fixup = 0;
}

L
Linus Torvalds 已提交
406
/*
407
 * Put a QH on the schedule in both hardware and software
L
Linus Torvalds 已提交
408
 */
409
static void uhci_activate_qh(struct uhci_hcd *uhci, struct uhci_qh *qh)
L
Linus Torvalds 已提交
410
{
411
	struct uhci_qh *pqh;
L
Linus Torvalds 已提交
412

413
	WARN_ON(list_empty(&qh->queue));
L
Linus Torvalds 已提交
414

415 416 417 418 419 420 421
	/* Set the element pointer if it isn't set already.
	 * This isn't needed for Isochronous queues, but it doesn't hurt. */
	if (qh_element(qh) == UHCI_PTR_TERM) {
		struct urb_priv *urbp = list_entry(qh->queue.next,
				struct urb_priv, node);
		struct uhci_td *td = list_entry(urbp->td_list.next,
				struct uhci_td, list);
L
Linus Torvalds 已提交
422

423
		qh->element = LINK_TO_TD(td);
L
Linus Torvalds 已提交
424 425
	}

A
Alan Stern 已提交
426 427 428 429
	/* Treat the queue as if it has just advanced */
	qh->wait_expired = 0;
	qh->advance_jiffies = jiffies;

430 431 432 433 434 435
	if (qh->state == QH_STATE_ACTIVE)
		return;
	qh->state = QH_STATE_ACTIVE;

	/* Move the QH from its old list to the end of the appropriate
	 * skeleton's list */
436 437 438
	if (qh == uhci->next_qh)
		uhci->next_qh = list_entry(qh->node.next, struct uhci_qh,
				node);
439 440 441 442 443 444
	list_move_tail(&qh->node, &qh->skel->node);

	/* Link it into the schedule */
	pqh = list_entry(qh->node.prev, struct uhci_qh, node);
	qh->link = pqh->link;
	wmb();
445
	pqh->link = LINK_TO_QH(qh);
L
Linus Torvalds 已提交
446 447 448
}

/*
449
 * Take a QH off the hardware schedule
L
Linus Torvalds 已提交
450
 */
451
static void uhci_unlink_qh(struct uhci_hcd *uhci, struct uhci_qh *qh)
L
Linus Torvalds 已提交
452 453 454
{
	struct uhci_qh *pqh;

455
	if (qh->state == QH_STATE_UNLINKING)
L
Linus Torvalds 已提交
456
		return;
457 458
	WARN_ON(qh->state != QH_STATE_ACTIVE || !qh->udev);
	qh->state = QH_STATE_UNLINKING;
L
Linus Torvalds 已提交
459

460 461 462 463
	/* Unlink the QH from the schedule and record when we did it */
	pqh = list_entry(qh->node.prev, struct uhci_qh, node);
	pqh->link = qh->link;
	mb();
L
Linus Torvalds 已提交
464 465

	uhci_get_current_frame_number(uhci);
466
	qh->unlink_frame = uhci->frame_number;
L
Linus Torvalds 已提交
467

468 469
	/* Force an interrupt so we know when the QH is fully unlinked */
	if (list_empty(&uhci->skel_unlink_qh->node))
L
Linus Torvalds 已提交
470 471
		uhci_set_next_interrupt(uhci);

472
	/* Move the QH from its old list to the end of the unlinking list */
473 474 475
	if (qh == uhci->next_qh)
		uhci->next_qh = list_entry(qh->node.next, struct uhci_qh,
				node);
476
	list_move_tail(&qh->node, &uhci->skel_unlink_qh->node);
L
Linus Torvalds 已提交
477 478
}

479 480 481 482 483 484 485
/*
 * When we and the controller are through with a QH, it becomes IDLE.
 * This happens when a QH has been off the schedule (on the unlinking
 * list) for more than one frame, or when an error occurs while adding
 * the first URB onto a new QH.
 */
static void uhci_make_qh_idle(struct uhci_hcd *uhci, struct uhci_qh *qh)
L
Linus Torvalds 已提交
486
{
487
	WARN_ON(qh->state == QH_STATE_ACTIVE);
L
Linus Torvalds 已提交
488

489 490 491
	if (qh == uhci->next_qh)
		uhci->next_qh = list_entry(qh->node.next, struct uhci_qh,
				node);
492 493
	list_move(&qh->node, &uhci->idle_qh_list);
	qh->state = QH_STATE_IDLE;
L
Linus Torvalds 已提交
494

495 496 497 498 499 500
	/* Now that the QH is idle, its post_td isn't being used */
	if (qh->post_td) {
		uhci_free_td(uhci, qh->post_td);
		qh->post_td = NULL;
	}

501 502 503
	/* If anyone is waiting for a QH to become idle, wake them up */
	if (uhci->num_waiting)
		wake_up_all(&uhci->waitqh);
L
Linus Torvalds 已提交
504 505
}

A
Alan Stern 已提交
506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620
/*
 * Find the highest existing bandwidth load for a given phase and period.
 */
static int uhci_highest_load(struct uhci_hcd *uhci, int phase, int period)
{
	int highest_load = uhci->load[phase];

	for (phase += period; phase < MAX_PHASE; phase += period)
		highest_load = max_t(int, highest_load, uhci->load[phase]);
	return highest_load;
}

/*
 * Set qh->phase to the optimal phase for a periodic transfer and
 * check whether the bandwidth requirement is acceptable.
 */
static int uhci_check_bandwidth(struct uhci_hcd *uhci, struct uhci_qh *qh)
{
	int minimax_load;

	/* Find the optimal phase (unless it is already set) and get
	 * its load value. */
	if (qh->phase >= 0)
		minimax_load = uhci_highest_load(uhci, qh->phase, qh->period);
	else {
		int phase, load;
		int max_phase = min_t(int, MAX_PHASE, qh->period);

		qh->phase = 0;
		minimax_load = uhci_highest_load(uhci, qh->phase, qh->period);
		for (phase = 1; phase < max_phase; ++phase) {
			load = uhci_highest_load(uhci, phase, qh->period);
			if (load < minimax_load) {
				minimax_load = load;
				qh->phase = phase;
			}
		}
	}

	/* Maximum allowable periodic bandwidth is 90%, or 900 us per frame */
	if (minimax_load + qh->load > 900) {
		dev_dbg(uhci_dev(uhci), "bandwidth allocation failed: "
				"period %d, phase %d, %d + %d us\n",
				qh->period, qh->phase, minimax_load, qh->load);
		return -ENOSPC;
	}
	return 0;
}

/*
 * Reserve a periodic QH's bandwidth in the schedule
 */
static void uhci_reserve_bandwidth(struct uhci_hcd *uhci, struct uhci_qh *qh)
{
	int i;
	int load = qh->load;
	char *p = "??";

	for (i = qh->phase; i < MAX_PHASE; i += qh->period) {
		uhci->load[i] += load;
		uhci->total_load += load;
	}
	uhci_to_hcd(uhci)->self.bandwidth_allocated =
			uhci->total_load / MAX_PHASE;
	switch (qh->type) {
	case USB_ENDPOINT_XFER_INT:
		++uhci_to_hcd(uhci)->self.bandwidth_int_reqs;
		p = "INT";
		break;
	case USB_ENDPOINT_XFER_ISOC:
		++uhci_to_hcd(uhci)->self.bandwidth_isoc_reqs;
		p = "ISO";
		break;
	}
	qh->bandwidth_reserved = 1;
	dev_dbg(uhci_dev(uhci),
			"%s dev %d ep%02x-%s, period %d, phase %d, %d us\n",
			"reserve", qh->udev->devnum,
			qh->hep->desc.bEndpointAddress, p,
			qh->period, qh->phase, load);
}

/*
 * Release a periodic QH's bandwidth reservation
 */
static void uhci_release_bandwidth(struct uhci_hcd *uhci, struct uhci_qh *qh)
{
	int i;
	int load = qh->load;
	char *p = "??";

	for (i = qh->phase; i < MAX_PHASE; i += qh->period) {
		uhci->load[i] -= load;
		uhci->total_load -= load;
	}
	uhci_to_hcd(uhci)->self.bandwidth_allocated =
			uhci->total_load / MAX_PHASE;
	switch (qh->type) {
	case USB_ENDPOINT_XFER_INT:
		--uhci_to_hcd(uhci)->self.bandwidth_int_reqs;
		p = "INT";
		break;
	case USB_ENDPOINT_XFER_ISOC:
		--uhci_to_hcd(uhci)->self.bandwidth_isoc_reqs;
		p = "ISO";
		break;
	}
	qh->bandwidth_reserved = 0;
	dev_dbg(uhci_dev(uhci),
			"%s dev %d ep%02x-%s, period %d, phase %d, %d us\n",
			"release", qh->udev->devnum,
			qh->hep->desc.bEndpointAddress, p,
			qh->period, qh->phase, load);
}

621 622
static inline struct urb_priv *uhci_alloc_urb_priv(struct uhci_hcd *uhci,
		struct urb *urb)
L
Linus Torvalds 已提交
623 624 625
{
	struct urb_priv *urbp;

626
	urbp = kmem_cache_zalloc(uhci_up_cachep, GFP_ATOMIC);
L
Linus Torvalds 已提交
627 628 629 630
	if (!urbp)
		return NULL;

	urbp->urb = urb;
631
	urb->hcpriv = urbp;
L
Linus Torvalds 已提交
632
	
633
	INIT_LIST_HEAD(&urbp->node);
L
Linus Torvalds 已提交
634 635 636 637 638
	INIT_LIST_HEAD(&urbp->td_list);

	return urbp;
}

639 640
static void uhci_free_urb_priv(struct uhci_hcd *uhci,
		struct urb_priv *urbp)
L
Linus Torvalds 已提交
641 642 643
{
	struct uhci_td *td, *tmp;

644 645 646
	if (!list_empty(&urbp->node))
		dev_warn(uhci_dev(uhci), "urb %p still on QH's list!\n",
				urbp->urb);
L
Linus Torvalds 已提交
647 648

	list_for_each_entry_safe(td, tmp, &urbp->td_list, list) {
649 650
		uhci_remove_td_from_urbp(td);
		uhci_free_td(uhci, td);
L
Linus Torvalds 已提交
651 652
	}

653
	urbp->urb->hcpriv = NULL;
L
Linus Torvalds 已提交
654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688
	kmem_cache_free(uhci_up_cachep, urbp);
}

/*
 * Map status to standard result codes
 *
 * <status> is (td_status(td) & 0xF60000), a.k.a.
 * uhci_status_bits(td_status(td)).
 * Note: <status> does not include the TD_CTRL_NAK bit.
 * <dir_out> is True for output TDs and False for input TDs.
 */
static int uhci_map_status(int status, int dir_out)
{
	if (!status)
		return 0;
	if (status & TD_CTRL_BITSTUFF)			/* Bitstuff error */
		return -EPROTO;
	if (status & TD_CTRL_CRCTIMEO) {		/* CRC/Timeout */
		if (dir_out)
			return -EPROTO;
		else
			return -EILSEQ;
	}
	if (status & TD_CTRL_BABBLE)			/* Babble */
		return -EOVERFLOW;
	if (status & TD_CTRL_DBUFERR)			/* Buffer error */
		return -ENOSR;
	if (status & TD_CTRL_STALLED)			/* Stalled */
		return -EPIPE;
	return 0;
}

/*
 * Control transfers
 */
689 690
static int uhci_submit_control(struct uhci_hcd *uhci, struct urb *urb,
		struct uhci_qh *qh)
L
Linus Torvalds 已提交
691 692 693
{
	struct uhci_td *td;
	unsigned long destination, status;
694
	int maxsze = le16_to_cpu(qh->hep->desc.wMaxPacketSize);
L
Linus Torvalds 已提交
695 696
	int len = urb->transfer_buffer_length;
	dma_addr_t data = urb->transfer_dma;
697
	__le32 *plink;
698
	struct urb_priv *urbp = urb->hcpriv;
L
Linus Torvalds 已提交
699 700 701 702

	/* The "pipe" thing contains the destination in bits 8--18 */
	destination = (urb->pipe & PIPE_DEVEP_MASK) | USB_PID_SETUP;

A
Alan Stern 已提交
703 704
	/* 3 errors, dummy TD remains inactive */
	status = uhci_maxerr(3);
L
Linus Torvalds 已提交
705 706 707 708 709 710
	if (urb->dev->speed == USB_SPEED_LOW)
		status |= TD_CTRL_LS;

	/*
	 * Build the TD for the control request setup packet
	 */
A
Alan Stern 已提交
711
	td = qh->dummy_td;
712
	uhci_add_td_to_urbp(td, urbp);
713
	uhci_fill_td(td, status, destination | uhci_explen(8),
714 715
			urb->setup_dma);
	plink = &td->link;
A
Alan Stern 已提交
716
	status |= TD_CTRL_ACTIVE;
L
Linus Torvalds 已提交
717 718 719 720 721 722 723 724 725 726 727 728 729 730

	/*
	 * If direction is "send", change the packet ID from SETUP (0x2D)
	 * to OUT (0xE1).  Else change it from SETUP to IN (0x69) and
	 * set Short Packet Detect (SPD) for all data packets.
	 */
	if (usb_pipeout(urb->pipe))
		destination ^= (USB_PID_SETUP ^ USB_PID_OUT);
	else {
		destination ^= (USB_PID_SETUP ^ USB_PID_IN);
		status |= TD_CTRL_SPD;
	}

	/*
731
	 * Build the DATA TDs
L
Linus Torvalds 已提交
732 733
	 */
	while (len > 0) {
734
		int pktsze = min(len, maxsze);
L
Linus Torvalds 已提交
735

736
		td = uhci_alloc_td(uhci);
L
Linus Torvalds 已提交
737
		if (!td)
A
Alan Stern 已提交
738
			goto nomem;
739
		*plink = LINK_TO_TD(td);
L
Linus Torvalds 已提交
740 741 742 743

		/* Alternate Data0/1 (start with Data1) */
		destination ^= TD_TOKEN_TOGGLE;
	
744
		uhci_add_td_to_urbp(td, urbp);
745
		uhci_fill_td(td, status, destination | uhci_explen(pktsze),
746 747
				data);
		plink = &td->link;
L
Linus Torvalds 已提交
748 749 750 751 752 753 754 755

		data += pktsze;
		len -= pktsze;
	}

	/*
	 * Build the final TD for control status 
	 */
756
	td = uhci_alloc_td(uhci);
L
Linus Torvalds 已提交
757
	if (!td)
A
Alan Stern 已提交
758
		goto nomem;
759
	*plink = LINK_TO_TD(td);
L
Linus Torvalds 已提交
760 761 762 763 764 765 766 767 768 769 770 771 772 773 774

	/*
	 * It's IN if the pipe is an output pipe or we're not expecting
	 * data back.
	 */
	destination &= ~TD_TOKEN_PID_MASK;
	if (usb_pipeout(urb->pipe) || !urb->transfer_buffer_length)
		destination |= USB_PID_IN;
	else
		destination |= USB_PID_OUT;

	destination |= TD_TOKEN_TOGGLE;		/* End in Data1 */

	status &= ~TD_CTRL_SPD;

775
	uhci_add_td_to_urbp(td, urbp);
L
Linus Torvalds 已提交
776
	uhci_fill_td(td, status | TD_CTRL_IOC,
777
			destination | uhci_explen(0), 0);
A
Alan Stern 已提交
778 779 780 781 782 783 784 785
	plink = &td->link;

	/*
	 * Build the new dummy TD and activate the old one
	 */
	td = uhci_alloc_td(uhci);
	if (!td)
		goto nomem;
786
	*plink = LINK_TO_TD(td);
A
Alan Stern 已提交
787 788 789 790 791

	uhci_fill_td(td, 0, USB_PID_OUT | uhci_explen(0), 0);
	wmb();
	qh->dummy_td->status |= __constant_cpu_to_le32(TD_CTRL_ACTIVE);
	qh->dummy_td = td;
L
Linus Torvalds 已提交
792 793 794 795

	/* Low-speed transfers get a different queue, and won't hog the bus.
	 * Also, some devices enumerate better without FSBR; the easiest way
	 * to do that is to put URBs on the low-speed queue while the device
796
	 * isn't in the CONFIGURED state. */
L
Linus Torvalds 已提交
797
	if (urb->dev->speed == USB_SPEED_LOW ||
798
			urb->dev->state != USB_STATE_CONFIGURED)
799
		qh->skel = uhci->skel_ls_control_qh;
L
Linus Torvalds 已提交
800
	else {
801
		qh->skel = uhci->skel_fs_control_qh;
A
Alan Stern 已提交
802
		uhci_add_fsbr(uhci, urb);
L
Linus Torvalds 已提交
803
	}
804 805

	urb->actual_length = -8;	/* Account for the SETUP packet */
806
	return 0;
A
Alan Stern 已提交
807 808 809

nomem:
	/* Remove the dummy TD from the td_list so it doesn't get freed */
810
	uhci_remove_td_from_urbp(qh->dummy_td);
A
Alan Stern 已提交
811
	return -ENOMEM;
L
Linus Torvalds 已提交
812 813 814 815 816
}

/*
 * Common submit for bulk and interrupt
 */
817 818
static int uhci_submit_common(struct uhci_hcd *uhci, struct urb *urb,
		struct uhci_qh *qh)
L
Linus Torvalds 已提交
819 820 821
{
	struct uhci_td *td;
	unsigned long destination, status;
822
	int maxsze = le16_to_cpu(qh->hep->desc.wMaxPacketSize);
L
Linus Torvalds 已提交
823 824
	int len = urb->transfer_buffer_length;
	dma_addr_t data = urb->transfer_dma;
A
Alan Stern 已提交
825
	__le32 *plink;
826
	struct urb_priv *urbp = urb->hcpriv;
A
Alan Stern 已提交
827
	unsigned int toggle;
L
Linus Torvalds 已提交
828 829 830 831 832 833

	if (len < 0)
		return -EINVAL;

	/* The "pipe" thing contains the destination in bits 8--18 */
	destination = (urb->pipe & PIPE_DEVEP_MASK) | usb_packetid(urb->pipe);
A
Alan Stern 已提交
834 835
	toggle = usb_gettoggle(urb->dev, usb_pipeendpoint(urb->pipe),
			 usb_pipeout(urb->pipe));
L
Linus Torvalds 已提交
836

A
Alan Stern 已提交
837 838
	/* 3 errors, dummy TD remains inactive */
	status = uhci_maxerr(3);
L
Linus Torvalds 已提交
839 840 841 842 843 844
	if (urb->dev->speed == USB_SPEED_LOW)
		status |= TD_CTRL_LS;
	if (usb_pipein(urb->pipe))
		status |= TD_CTRL_SPD;

	/*
845
	 * Build the DATA TDs
L
Linus Torvalds 已提交
846
	 */
A
Alan Stern 已提交
847 848
	plink = NULL;
	td = qh->dummy_td;
L
Linus Torvalds 已提交
849 850 851
	do {	/* Allow zero length packets */
		int pktsze = maxsze;

852
		if (len <= pktsze) {		/* The last packet */
L
Linus Torvalds 已提交
853 854 855 856 857
			pktsze = len;
			if (!(urb->transfer_flags & URB_SHORT_NOT_OK))
				status &= ~TD_CTRL_SPD;
		}

A
Alan Stern 已提交
858 859 860 861
		if (plink) {
			td = uhci_alloc_td(uhci);
			if (!td)
				goto nomem;
862
			*plink = LINK_TO_TD(td);
A
Alan Stern 已提交
863
		}
864
		uhci_add_td_to_urbp(td, urbp);
865
		uhci_fill_td(td, status,
A
Alan Stern 已提交
866 867 868
				destination | uhci_explen(pktsze) |
					(toggle << TD_TOKEN_TOGGLE_SHIFT),
				data);
869
		plink = &td->link;
A
Alan Stern 已提交
870
		status |= TD_CTRL_ACTIVE;
L
Linus Torvalds 已提交
871 872 873

		data += pktsze;
		len -= maxsze;
A
Alan Stern 已提交
874
		toggle ^= 1;
L
Linus Torvalds 已提交
875 876 877 878 879 880 881 882 883
	} while (len > 0);

	/*
	 * URB_ZERO_PACKET means adding a 0-length packet, if direction
	 * is OUT and the transfer_length was an exact multiple of maxsze,
	 * hence (len = transfer_length - N * maxsze) == 0
	 * however, if transfer_length == 0, the zero packet was already
	 * prepared above.
	 */
884 885 886
	if ((urb->transfer_flags & URB_ZERO_PACKET) &&
			usb_pipeout(urb->pipe) && len == 0 &&
			urb->transfer_buffer_length > 0) {
887
		td = uhci_alloc_td(uhci);
L
Linus Torvalds 已提交
888
		if (!td)
A
Alan Stern 已提交
889
			goto nomem;
890
		*plink = LINK_TO_TD(td);
L
Linus Torvalds 已提交
891

892
		uhci_add_td_to_urbp(td, urbp);
A
Alan Stern 已提交
893 894 895 896 897
		uhci_fill_td(td, status,
				destination | uhci_explen(0) |
					(toggle << TD_TOKEN_TOGGLE_SHIFT),
				data);
		plink = &td->link;
L
Linus Torvalds 已提交
898

A
Alan Stern 已提交
899
		toggle ^= 1;
L
Linus Torvalds 已提交
900 901 902 903 904 905 906 907
	}

	/* Set the interrupt-on-completion flag on the last packet.
	 * A more-or-less typical 4 KB URB (= size of one memory page)
	 * will require about 3 ms to transfer; that's a little on the
	 * fast side but not enough to justify delaying an interrupt
	 * more than 2 or 3 URBs, so we will ignore the URB_NO_INTERRUPT
	 * flag setting. */
908
	td->status |= __constant_cpu_to_le32(TD_CTRL_IOC);
L
Linus Torvalds 已提交
909

A
Alan Stern 已提交
910 911 912 913 914 915
	/*
	 * Build the new dummy TD and activate the old one
	 */
	td = uhci_alloc_td(uhci);
	if (!td)
		goto nomem;
916
	*plink = LINK_TO_TD(td);
A
Alan Stern 已提交
917 918 919 920 921 922 923 924

	uhci_fill_td(td, 0, USB_PID_OUT | uhci_explen(0), 0);
	wmb();
	qh->dummy_td->status |= __constant_cpu_to_le32(TD_CTRL_ACTIVE);
	qh->dummy_td = td;

	usb_settoggle(urb->dev, usb_pipeendpoint(urb->pipe),
			usb_pipeout(urb->pipe), toggle);
925
	return 0;
A
Alan Stern 已提交
926 927 928

nomem:
	/* Remove the dummy TD from the td_list so it doesn't get freed */
929
	uhci_remove_td_from_urbp(qh->dummy_td);
A
Alan Stern 已提交
930
	return -ENOMEM;
L
Linus Torvalds 已提交
931 932
}

933 934
static inline int uhci_submit_bulk(struct uhci_hcd *uhci, struct urb *urb,
		struct uhci_qh *qh)
L
Linus Torvalds 已提交
935 936 937 938 939 940 941
{
	int ret;

	/* Can't have low-speed bulk transfers */
	if (urb->dev->speed == USB_SPEED_LOW)
		return -EINVAL;

942 943 944
	qh->skel = uhci->skel_bulk_qh;
	ret = uhci_submit_common(uhci, urb, qh);
	if (ret == 0)
A
Alan Stern 已提交
945
		uhci_add_fsbr(uhci, urb);
L
Linus Torvalds 已提交
946 947 948
	return ret;
}

949
static int uhci_submit_interrupt(struct uhci_hcd *uhci, struct urb *urb,
950
		struct uhci_qh *qh)
L
Linus Torvalds 已提交
951
{
A
Alan Stern 已提交
952
	int ret;
953

954 955 956
	/* USB 1.1 interrupt transfers only involve one packet per interval.
	 * Drivers can submit URBs of any length, but longer ones will need
	 * multiple intervals to complete.
L
Linus Torvalds 已提交
957
	 */
958

A
Alan Stern 已提交
959 960
	if (!qh->bandwidth_reserved) {
		int exponent;
961

A
Alan Stern 已提交
962 963 964 965 966 967 968 969
		/* Figure out which power-of-two queue to use */
		for (exponent = 7; exponent >= 0; --exponent) {
			if ((1 << exponent) <= urb->interval)
				break;
		}
		if (exponent < 0)
			return -EINVAL;
		qh->period = 1 << exponent;
970 971
		qh->skel = uhci->skelqh[UHCI_SKEL_INDEX(exponent)];

A
Alan Stern 已提交
972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987
		/* For now, interrupt phase is fixed by the layout
		 * of the QH lists. */
		qh->phase = (qh->period / 2) & (MAX_PHASE - 1);
		ret = uhci_check_bandwidth(uhci, qh);
		if (ret)
			return ret;
	} else if (qh->period > urb->interval)
		return -EINVAL;		/* Can't decrease the period */

	ret = uhci_submit_common(uhci, urb, qh);
	if (ret == 0) {
		urb->interval = qh->period;
		if (!qh->bandwidth_reserved)
			uhci_reserve_bandwidth(uhci, qh);
	}
	return ret;
L
Linus Torvalds 已提交
988 989
}

990 991 992 993
/*
 * Fix up the data structures following a short transfer
 */
static int uhci_fixup_short_transfer(struct uhci_hcd *uhci,
994
		struct uhci_qh *qh, struct urb_priv *urbp)
995 996
{
	struct uhci_td *td;
997 998
	struct list_head *tmp;
	int ret;
999 1000 1001 1002 1003 1004 1005

	td = list_entry(urbp->td_list.prev, struct uhci_td, list);
	if (qh->type == USB_ENDPOINT_XFER_CONTROL) {

		/* When a control transfer is short, we have to restart
		 * the queue at the status stage transaction, which is
		 * the last TD. */
1006
		WARN_ON(list_empty(&urbp->td_list));
1007
		qh->element = LINK_TO_TD(td);
1008
		tmp = td->list.prev;
1009 1010
		ret = -EINPROGRESS;

1011
	} else {
1012 1013 1014 1015

		/* When a bulk/interrupt transfer is short, we have to
		 * fix up the toggles of the following URBs on the queue
		 * before restarting the queue at the next URB. */
1016
		qh->initial_toggle = uhci_toggle(td_token(qh->post_td)) ^ 1;
1017 1018
		uhci_fixup_toggles(qh, 1);

1019 1020
		if (list_empty(&urbp->td_list))
			td = qh->post_td;
1021
		qh->element = td->link;
1022 1023
		tmp = urbp->td_list.prev;
		ret = 0;
1024 1025
	}

1026 1027 1028 1029 1030
	/* Remove all the TDs we skipped over, from tmp back to the start */
	while (tmp != &urbp->td_list) {
		td = list_entry(tmp, struct uhci_td, list);
		tmp = tmp->prev;

1031 1032
		uhci_remove_td_from_urbp(td);
		uhci_free_td(uhci, td);
1033
	}
1034 1035 1036 1037 1038 1039 1040 1041 1042 1043
	return ret;
}

/*
 * Common result for control, bulk, and interrupt
 */
static int uhci_result_common(struct uhci_hcd *uhci, struct urb *urb)
{
	struct urb_priv *urbp = urb->hcpriv;
	struct uhci_qh *qh = urbp->qh;
1044
	struct uhci_td *td, *tmp;
1045 1046 1047
	unsigned status;
	int ret = 0;

1048
	list_for_each_entry_safe(td, tmp, &urbp->td_list, list) {
1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064
		unsigned int ctrlstat;
		int len;

		ctrlstat = td_status(td);
		status = uhci_status_bits(ctrlstat);
		if (status & TD_CTRL_ACTIVE)
			return -EINPROGRESS;

		len = uhci_actual_length(ctrlstat);
		urb->actual_length += len;

		if (status) {
			ret = uhci_map_status(status,
					uhci_packetout(td_token(td)));
			if ((debug == 1 && ret != -EPIPE) || debug > 1) {
				/* Some debugging code */
D
David Brownell 已提交
1065
				dev_dbg(&urb->dev->dev,
1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081
						"%s: failed with status %x\n",
						__FUNCTION__, status);

				if (debug > 1 && errbuf) {
					/* Print the chain for debugging */
					uhci_show_qh(urbp->qh, errbuf,
							ERRBUF_LEN, 0);
					lprintk(errbuf);
				}
			}

		} else if (len < uhci_expected_length(td_token(td))) {

			/* We received a short packet */
			if (urb->transfer_flags & URB_SHORT_NOT_OK)
				ret = -EREMOTEIO;
1082 1083 1084

			/* Fixup needed only if this isn't the URB's last TD */
			else if (&td->list != urbp->td_list.prev)
1085 1086 1087
				ret = 1;
		}

1088
		uhci_remove_td_from_urbp(td);
1089
		if (qh->post_td)
1090
			uhci_free_td(uhci, qh->post_td);
1091 1092
		qh->post_td = td;

1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112
		if (ret != 0)
			goto err;
	}
	return ret;

err:
	if (ret < 0) {
		/* In case a control transfer gets an error
		 * during the setup stage */
		urb->actual_length = max(urb->actual_length, 0);

		/* Note that the queue has stopped and save
		 * the next toggle value */
		qh->element = UHCI_PTR_TERM;
		qh->is_stopped = 1;
		qh->needs_fixup = (qh->type != USB_ENDPOINT_XFER_CONTROL);
		qh->initial_toggle = uhci_toggle(td_token(td)) ^
				(ret == -EREMOTEIO);

	} else		/* Short packet received */
1113
		ret = uhci_fixup_short_transfer(uhci, qh, urbp);
1114 1115 1116
	return ret;
}

L
Linus Torvalds 已提交
1117 1118 1119
/*
 * Isochronous transfers
 */
1120 1121
static int uhci_submit_isochronous(struct uhci_hcd *uhci, struct urb *urb,
		struct uhci_qh *qh)
L
Linus Torvalds 已提交
1122
{
1123 1124 1125 1126
	struct uhci_td *td = NULL;	/* Since urb->number_of_packets > 0 */
	int i, frame;
	unsigned long destination, status;
	struct urb_priv *urbp = (struct urb_priv *) urb->hcpriv;
L
Linus Torvalds 已提交
1127

1128 1129 1130
	/* Values must not be too big (could overflow below) */
	if (urb->interval >= UHCI_NUMFRAMES ||
			urb->number_of_packets >= UHCI_NUMFRAMES)
L
Linus Torvalds 已提交
1131 1132
		return -EFBIG;

1133
	/* Check the period and figure out the starting frame number */
A
Alan Stern 已提交
1134 1135
	if (!qh->bandwidth_reserved) {
		qh->period = urb->interval;
1136
		if (urb->transfer_flags & URB_ISO_ASAP) {
A
Alan Stern 已提交
1137 1138 1139 1140 1141 1142
			qh->phase = -1;		/* Find the best phase */
			i = uhci_check_bandwidth(uhci, qh);
			if (i)
				return i;

			/* Allow a little time to allocate the TDs */
1143
			uhci_get_current_frame_number(uhci);
A
Alan Stern 已提交
1144 1145 1146 1147 1148 1149
			frame = uhci->frame_number + 10;

			/* Move forward to the first frame having the
			 * correct phase */
			urb->start_frame = frame + ((qh->phase - frame) &
					(qh->period - 1));
1150
		} else {
1151
			i = urb->start_frame - uhci->last_iso_frame;
1152 1153
			if (i <= 0 || i >= UHCI_NUMFRAMES)
				return -EINVAL;
A
Alan Stern 已提交
1154 1155 1156 1157
			qh->phase = urb->start_frame & (qh->period - 1);
			i = uhci_check_bandwidth(uhci, qh);
			if (i)
				return i;
1158
		}
A
Alan Stern 已提交
1159

1160 1161
	} else if (qh->period != urb->interval) {
		return -EINVAL;		/* Can't change the period */
L
Linus Torvalds 已提交
1162

1163
	} else {	/* Pick up where the last URB leaves off */
1164
		if (list_empty(&qh->queue)) {
1165
			frame = qh->iso_frame;
1166 1167
		} else {
			struct urb *lurb;
1168

1169
			lurb = list_entry(qh->queue.prev,
1170
					struct urb_priv, node)->urb;
1171 1172 1173
			frame = lurb->start_frame +
					lurb->number_of_packets *
					lurb->interval;
1174
		}
1175 1176
		if (urb->transfer_flags & URB_ISO_ASAP)
			urb->start_frame = frame;
1177 1178
		else if (urb->start_frame != frame)
			return -EINVAL;
L
Linus Torvalds 已提交
1179 1180
	}

1181
	/* Make sure we won't have to go too far into the future */
1182
	if (uhci_frame_before_eq(uhci->last_iso_frame + UHCI_NUMFRAMES,
1183 1184 1185 1186 1187 1188 1189
			urb->start_frame + urb->number_of_packets *
				urb->interval))
		return -EFBIG;

	status = TD_CTRL_ACTIVE | TD_CTRL_IOS;
	destination = (urb->pipe & PIPE_DEVEP_MASK) | usb_packetid(urb->pipe);

1190
	for (i = 0; i < urb->number_of_packets; i++) {
1191
		td = uhci_alloc_td(uhci);
L
Linus Torvalds 已提交
1192 1193 1194
		if (!td)
			return -ENOMEM;

1195
		uhci_add_td_to_urbp(td, urbp);
1196 1197 1198 1199
		uhci_fill_td(td, status, destination |
				uhci_explen(urb->iso_frame_desc[i].length),
				urb->transfer_dma +
					urb->iso_frame_desc[i].offset);
1200
	}
L
Linus Torvalds 已提交
1201

1202 1203 1204 1205
	/* Set the interrupt-on-completion flag on the last packet. */
	td->status |= __constant_cpu_to_le32(TD_CTRL_IOC);

	/* Add the TDs to the frame list */
1206 1207
	frame = urb->start_frame;
	list_for_each_entry(td, &urbp->td_list, list) {
1208
		uhci_insert_td_in_frame_list(uhci, td, frame);
1209 1210 1211 1212 1213 1214 1215
		frame += qh->period;
	}

	if (list_empty(&qh->queue)) {
		qh->iso_packet_desc = &urb->iso_frame_desc[0];
		qh->iso_frame = urb->start_frame;
		qh->iso_status = 0;
L
Linus Torvalds 已提交
1216 1217
	}

A
Alan Stern 已提交
1218 1219 1220
	qh->skel = uhci->skel_iso_qh;
	if (!qh->bandwidth_reserved)
		uhci_reserve_bandwidth(uhci, qh);
1221
	return 0;
L
Linus Torvalds 已提交
1222 1223 1224 1225
}

static int uhci_result_isochronous(struct uhci_hcd *uhci, struct urb *urb)
{
1226 1227 1228
	struct uhci_td *td, *tmp;
	struct urb_priv *urbp = urb->hcpriv;
	struct uhci_qh *qh = urbp->qh;
L
Linus Torvalds 已提交
1229

1230 1231 1232
	list_for_each_entry_safe(td, tmp, &urbp->td_list, list) {
		unsigned int ctrlstat;
		int status;
L
Linus Torvalds 已提交
1233 1234
		int actlength;

1235
		if (uhci_frame_before_eq(uhci->cur_iso_frame, qh->iso_frame))
L
Linus Torvalds 已提交
1236 1237
			return -EINPROGRESS;

1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251
		uhci_remove_tds_from_frame(uhci, qh->iso_frame);

		ctrlstat = td_status(td);
		if (ctrlstat & TD_CTRL_ACTIVE) {
			status = -EXDEV;	/* TD was added too late? */
		} else {
			status = uhci_map_status(uhci_status_bits(ctrlstat),
					usb_pipeout(urb->pipe));
			actlength = uhci_actual_length(ctrlstat);

			urb->actual_length += actlength;
			qh->iso_packet_desc->actual_length = actlength;
			qh->iso_packet_desc->status = status;
		}
L
Linus Torvalds 已提交
1252 1253 1254

		if (status) {
			urb->error_count++;
1255
			qh->iso_status = status;
L
Linus Torvalds 已提交
1256 1257
		}

1258 1259 1260 1261
		uhci_remove_td_from_urbp(td);
		uhci_free_td(uhci, td);
		qh->iso_frame += qh->period;
		++qh->iso_packet_desc;
L
Linus Torvalds 已提交
1262
	}
1263
	return qh->iso_status;
L
Linus Torvalds 已提交
1264 1265 1266
}

static int uhci_urb_enqueue(struct usb_hcd *hcd,
1267
		struct usb_host_endpoint *hep,
A
Al Viro 已提交
1268
		struct urb *urb, gfp_t mem_flags)
L
Linus Torvalds 已提交
1269 1270 1271 1272
{
	int ret;
	struct uhci_hcd *uhci = hcd_to_uhci(hcd);
	unsigned long flags;
1273 1274
	struct urb_priv *urbp;
	struct uhci_qh *qh;
L
Linus Torvalds 已提交
1275 1276 1277 1278 1279

	spin_lock_irqsave(&uhci->lock, flags);

	ret = urb->status;
	if (ret != -EINPROGRESS)		/* URB already unlinked! */
1280
		goto done;
L
Linus Torvalds 已提交
1281

1282 1283 1284 1285
	ret = -ENOMEM;
	urbp = uhci_alloc_urb_priv(uhci, urb);
	if (!urbp)
		goto done;
L
Linus Torvalds 已提交
1286

1287 1288 1289 1290 1291 1292
	if (hep->hcpriv)
		qh = (struct uhci_qh *) hep->hcpriv;
	else {
		qh = uhci_alloc_qh(uhci, urb->dev, hep);
		if (!qh)
			goto err_no_qh;
L
Linus Torvalds 已提交
1293
	}
1294
	urbp->qh = qh;
L
Linus Torvalds 已提交
1295

1296 1297
	switch (qh->type) {
	case USB_ENDPOINT_XFER_CONTROL:
1298 1299
		ret = uhci_submit_control(uhci, urb, qh);
		break;
1300
	case USB_ENDPOINT_XFER_BULK:
1301
		ret = uhci_submit_bulk(uhci, urb, qh);
L
Linus Torvalds 已提交
1302
		break;
1303
	case USB_ENDPOINT_XFER_INT:
A
Alan Stern 已提交
1304
		ret = uhci_submit_interrupt(uhci, urb, qh);
L
Linus Torvalds 已提交
1305
		break;
1306
	case USB_ENDPOINT_XFER_ISOC:
1307
		urb->error_count = 0;
1308
		ret = uhci_submit_isochronous(uhci, urb, qh);
L
Linus Torvalds 已提交
1309 1310
		break;
	}
1311 1312
	if (ret != 0)
		goto err_submit_failed;
L
Linus Torvalds 已提交
1313

1314 1315 1316
	/* Add this URB to the QH */
	urbp->qh = qh;
	list_add_tail(&urbp->node, &qh->queue);
L
Linus Torvalds 已提交
1317

1318 1319
	/* If the new URB is the first and only one on this QH then either
	 * the QH is new and idle or else it's unlinked and waiting to
1320 1321
	 * become idle, so we can activate it right away.  But only if the
	 * queue isn't stopped. */
A
Alan Stern 已提交
1322
	if (qh->queue.next == &urbp->node && !qh->is_stopped) {
1323
		uhci_activate_qh(uhci, qh);
1324
		uhci_urbp_wants_fsbr(uhci, urbp);
A
Alan Stern 已提交
1325
	}
1326 1327 1328 1329 1330
	goto done;

err_submit_failed:
	if (qh->state == QH_STATE_IDLE)
		uhci_make_qh_idle(uhci, qh);	/* Reclaim unused QH */
L
Linus Torvalds 已提交
1331

1332 1333 1334 1335
err_no_qh:
	uhci_free_urb_priv(uhci, urbp);

done:
L
Linus Torvalds 已提交
1336 1337 1338 1339
	spin_unlock_irqrestore(&uhci->lock, flags);
	return ret;
}

1340 1341 1342 1343 1344
static int uhci_urb_dequeue(struct usb_hcd *hcd, struct urb *urb)
{
	struct uhci_hcd *uhci = hcd_to_uhci(hcd);
	unsigned long flags;
	struct urb_priv *urbp;
1345
	struct uhci_qh *qh;
1346 1347 1348 1349 1350

	spin_lock_irqsave(&uhci->lock, flags);
	urbp = urb->hcpriv;
	if (!urbp)			/* URB was never linked! */
		goto done;
1351
	qh = urbp->qh;
1352 1353

	/* Remove Isochronous TDs from the frame list ASAP */
1354
	if (qh->type == USB_ENDPOINT_XFER_ISOC) {
1355
		uhci_unlink_isochronous_tds(uhci, urb);
1356 1357 1358 1359 1360 1361 1362 1363 1364
		mb();

		/* If the URB has already started, update the QH unlink time */
		uhci_get_current_frame_number(uhci);
		if (uhci_frame_before_eq(urb->start_frame, uhci->frame_number))
			qh->unlink_frame = uhci->frame_number;
	}

	uhci_unlink_qh(uhci, qh);
1365 1366 1367 1368 1369 1370

done:
	spin_unlock_irqrestore(&uhci->lock, flags);
	return 0;
}

L
Linus Torvalds 已提交
1371
/*
1372
 * Finish unlinking an URB and give it back
L
Linus Torvalds 已提交
1373
 */
1374
static void uhci_giveback_urb(struct uhci_hcd *uhci, struct uhci_qh *qh,
1375
		struct urb *urb)
1376 1377
__releases(uhci->lock)
__acquires(uhci->lock)
L
Linus Torvalds 已提交
1378
{
1379
	struct urb_priv *urbp = (struct urb_priv *) urb->hcpriv;
L
Linus Torvalds 已提交
1380

1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392
	/* When giving back the first URB in an Isochronous queue,
	 * reinitialize the QH's iso-related members for the next URB. */
	if (qh->type == USB_ENDPOINT_XFER_ISOC &&
			urbp->node.prev == &qh->queue &&
			urbp->node.next != &qh->queue) {
		struct urb *nurb = list_entry(urbp->node.next,
				struct urb_priv, node)->urb;

		qh->iso_packet_desc = &nurb->iso_frame_desc[0];
		qh->iso_frame = nurb->start_frame;
		qh->iso_status = 0;
	}
L
Linus Torvalds 已提交
1393

1394 1395 1396 1397 1398 1399 1400 1401 1402 1403
	/* Take the URB off the QH's queue.  If the queue is now empty,
	 * this is a perfect time for a toggle fixup. */
	list_del_init(&urbp->node);
	if (list_empty(&qh->queue) && qh->needs_fixup) {
		usb_settoggle(urb->dev, usb_pipeendpoint(urb->pipe),
				usb_pipeout(urb->pipe), qh->initial_toggle);
		qh->needs_fixup = 0;
	}

	uhci_free_urb_priv(uhci, urbp);
L
Linus Torvalds 已提交
1404

1405
	spin_unlock(&uhci->lock);
1406
	usb_hcd_giveback_urb(uhci_to_hcd(uhci), urb);
1407
	spin_lock(&uhci->lock);
L
Linus Torvalds 已提交
1408

1409 1410 1411 1412
	/* If the queue is now empty, we can unlink the QH and give up its
	 * reserved bandwidth. */
	if (list_empty(&qh->queue)) {
		uhci_unlink_qh(uhci, qh);
A
Alan Stern 已提交
1413 1414
		if (qh->bandwidth_reserved)
			uhci_release_bandwidth(uhci, qh);
1415
	}
1416
}
L
Linus Torvalds 已提交
1417

1418
/*
1419
 * Scan the URBs in a QH's queue
1420
 */
1421 1422 1423
#define QH_FINISHED_UNLINKING(qh)			\
		(qh->state == QH_STATE_UNLINKING &&	\
		uhci->frame_number + uhci->is_stopped != qh->unlink_frame)
L
Linus Torvalds 已提交
1424

1425
static void uhci_scan_qh(struct uhci_hcd *uhci, struct uhci_qh *qh)
L
Linus Torvalds 已提交
1426 1427
{
	struct urb_priv *urbp;
1428 1429
	struct urb *urb;
	int status;
L
Linus Torvalds 已提交
1430

1431 1432 1433
	while (!list_empty(&qh->queue)) {
		urbp = list_entry(qh->queue.next, struct urb_priv, node);
		urb = urbp->urb;
L
Linus Torvalds 已提交
1434

1435
		if (qh->type == USB_ENDPOINT_XFER_ISOC)
1436
			status = uhci_result_isochronous(uhci, urb);
1437
		else
1438 1439 1440
			status = uhci_result_common(uhci, urb);
		if (status == -EINPROGRESS)
			break;
L
Linus Torvalds 已提交
1441

1442 1443 1444 1445
		spin_lock(&urb->lock);
		if (urb->status == -EINPROGRESS)	/* Not dequeued */
			urb->status = status;
		else
1446
			status = ECONNRESET;		/* Not -ECONNRESET */
1447
		spin_unlock(&urb->lock);
L
Linus Torvalds 已提交
1448

1449 1450
		/* Dequeued but completed URBs can't be given back unless
		 * the QH is stopped or has finished unlinking. */
1451 1452 1453 1454 1455 1456
		if (status == ECONNRESET) {
			if (QH_FINISHED_UNLINKING(qh))
				qh->is_stopped = 1;
			else if (!qh->is_stopped)
				return;
		}
L
Linus Torvalds 已提交
1457

1458
		uhci_giveback_urb(uhci, qh, urb);
A
Alan Stern 已提交
1459
		if (status < 0 && qh->type != USB_ENDPOINT_XFER_ISOC)
1460 1461
			break;
	}
L
Linus Torvalds 已提交
1462

1463 1464
	/* If the QH is neither stopped nor finished unlinking (normal case),
	 * our work here is done. */
1465 1466 1467
	if (QH_FINISHED_UNLINKING(qh))
		qh->is_stopped = 1;
	else if (!qh->is_stopped)
1468
		return;
L
Linus Torvalds 已提交
1469

1470
	/* Otherwise give back each of the dequeued URBs */
1471
restart:
1472 1473 1474
	list_for_each_entry(urbp, &qh->queue, node) {
		urb = urbp->urb;
		if (urb->status != -EINPROGRESS) {
1475 1476 1477 1478 1479 1480 1481 1482

			/* Fix up the TD links and save the toggles for
			 * non-Isochronous queues.  For Isochronous queues,
			 * test for too-recent dequeues. */
			if (!uhci_cleanup_queue(uhci, qh, urb)) {
				qh->is_stopped = 0;
				return;
			}
1483
			uhci_giveback_urb(uhci, qh, urb);
1484 1485 1486 1487
			goto restart;
		}
	}
	qh->is_stopped = 0;
L
Linus Torvalds 已提交
1488

1489 1490 1491 1492 1493
	/* There are no more dequeued URBs.  If there are still URBs on the
	 * queue, the QH can now be re-activated. */
	if (!list_empty(&qh->queue)) {
		if (qh->needs_fixup)
			uhci_fixup_toggles(qh, 0);
A
Alan Stern 已提交
1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505

		/* If the first URB on the queue wants FSBR but its time
		 * limit has expired, set the next TD to interrupt on
		 * completion before reactivating the QH. */
		urbp = list_entry(qh->queue.next, struct urb_priv, node);
		if (urbp->fsbr && qh->wait_expired) {
			struct uhci_td *td = list_entry(urbp->td_list.next,
					struct uhci_td, list);

			td->status |= __cpu_to_le32(TD_CTRL_IOC);
		}

1506
		uhci_activate_qh(uhci, qh);
L
Linus Torvalds 已提交
1507 1508
	}

1509 1510 1511 1512
	/* The queue is empty.  The QH can become idle if it is fully
	 * unlinked. */
	else if (QH_FINISHED_UNLINKING(qh))
		uhci_make_qh_idle(uhci, qh);
L
Linus Torvalds 已提交
1513 1514
}

A
Alan Stern 已提交
1515 1516 1517 1518
/*
 * Check for queues that have made some forward progress.
 * Returns 0 if the queue is not Isochronous, is ACTIVE, and
 * has not advanced since last examined; 1 otherwise.
1519 1520 1521 1522 1523
 *
 * Early Intel controllers have a bug which causes qh->element sometimes
 * not to advance when a TD completes successfully.  The queue remains
 * stuck on the inactive completed TD.  We detect such cases and advance
 * the element pointer by hand.
A
Alan Stern 已提交
1524 1525 1526 1527 1528 1529 1530 1531 1532
 */
static int uhci_advance_check(struct uhci_hcd *uhci, struct uhci_qh *qh)
{
	struct urb_priv *urbp = NULL;
	struct uhci_td *td;
	int ret = 1;
	unsigned status;

	if (qh->type == USB_ENDPOINT_XFER_ISOC)
1533
		goto done;
A
Alan Stern 已提交
1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555

	/* Treat an UNLINKING queue as though it hasn't advanced.
	 * This is okay because reactivation will treat it as though
	 * it has advanced, and if it is going to become IDLE then
	 * this doesn't matter anyway.  Furthermore it's possible
	 * for an UNLINKING queue not to have any URBs at all, or
	 * for its first URB not to have any TDs (if it was dequeued
	 * just as it completed).  So it's not easy in any case to
	 * test whether such queues have advanced. */
	if (qh->state != QH_STATE_ACTIVE) {
		urbp = NULL;
		status = 0;

	} else {
		urbp = list_entry(qh->queue.next, struct urb_priv, node);
		td = list_entry(urbp->td_list.next, struct uhci_td, list);
		status = td_status(td);
		if (!(status & TD_CTRL_ACTIVE)) {

			/* We're okay, the queue has advanced */
			qh->wait_expired = 0;
			qh->advance_jiffies = jiffies;
1556
			goto done;
A
Alan Stern 已提交
1557 1558 1559 1560 1561
		}
		ret = 0;
	}

	/* The queue hasn't advanced; check for timeout */
1562 1563 1564 1565
	if (qh->wait_expired)
		goto done;

	if (time_after(jiffies, qh->advance_jiffies + QH_WAIT_TIMEOUT)) {
1566 1567

		/* Detect the Intel bug and work around it */
1568
		if (qh->post_td && qh_element(qh) == LINK_TO_TD(qh->post_td)) {
1569 1570
			qh->element = qh->post_td->link;
			qh->advance_jiffies = jiffies;
1571 1572
			ret = 1;
			goto done;
1573 1574
		}

A
Alan Stern 已提交
1575 1576 1577 1578 1579 1580 1581 1582
		qh->wait_expired = 1;

		/* If the current URB wants FSBR, unlink it temporarily
		 * so that we can safely set the next TD to interrupt on
		 * completion.  That way we'll know as soon as the queue
		 * starts moving again. */
		if (urbp && urbp->fsbr && !(status & TD_CTRL_IOC))
			uhci_unlink_qh(uhci, qh);
1583 1584 1585 1586 1587

	} else {
		/* Unmoving but not-yet-expired queues keep FSBR alive */
		if (urbp)
			uhci_urbp_wants_fsbr(uhci, urbp);
A
Alan Stern 已提交
1588
	}
1589 1590

done:
A
Alan Stern 已提交
1591 1592 1593
	return ret;
}

1594 1595 1596
/*
 * Process events in the schedule, but only in one thread at a time
 */
1597
static void uhci_scan_schedule(struct uhci_hcd *uhci)
L
Linus Torvalds 已提交
1598
{
1599 1600
	int i;
	struct uhci_qh *qh;
L
Linus Torvalds 已提交
1601 1602 1603 1604 1605 1606 1607

	/* Don't allow re-entrant calls */
	if (uhci->scan_in_progress) {
		uhci->need_rescan = 1;
		return;
	}
	uhci->scan_in_progress = 1;
A
Alan Stern 已提交
1608
rescan:
L
Linus Torvalds 已提交
1609
	uhci->need_rescan = 0;
1610
	uhci->fsbr_is_wanted = 0;
L
Linus Torvalds 已提交
1611

1612
	uhci_clear_next_interrupt(uhci);
L
Linus Torvalds 已提交
1613
	uhci_get_current_frame_number(uhci);
1614
	uhci->cur_iso_frame = uhci->frame_number;
L
Linus Torvalds 已提交
1615

1616 1617 1618 1619 1620 1621 1622
	/* Go through all the QH queues and process the URBs in each one */
	for (i = 0; i < UHCI_NUM_SKELQH - 1; ++i) {
		uhci->next_qh = list_entry(uhci->skelqh[i]->node.next,
				struct uhci_qh, node);
		while ((qh = uhci->next_qh) != uhci->skelqh[i]) {
			uhci->next_qh = list_entry(qh->node.next,
					struct uhci_qh, node);
A
Alan Stern 已提交
1623 1624

			if (uhci_advance_check(uhci, qh)) {
1625
				uhci_scan_qh(uhci, qh);
1626 1627 1628 1629
				if (qh->state == QH_STATE_ACTIVE) {
					uhci_urbp_wants_fsbr(uhci,
	list_entry(qh->queue.next, struct urb_priv, node));
				}
A
Alan Stern 已提交
1630
			}
1631
		}
L
Linus Torvalds 已提交
1632 1633
	}

1634
	uhci->last_iso_frame = uhci->cur_iso_frame;
L
Linus Torvalds 已提交
1635 1636 1637 1638
	if (uhci->need_rescan)
		goto rescan;
	uhci->scan_in_progress = 0;

1639 1640 1641 1642 1643
	if (uhci->fsbr_is_on && !uhci->fsbr_is_wanted &&
			!uhci->fsbr_expiring) {
		uhci->fsbr_expiring = 1;
		mod_timer(&uhci->fsbr_timer, jiffies + FSBR_OFF_DELAY);
	}
A
Alan Stern 已提交
1644

1645
	if (list_empty(&uhci->skel_unlink_qh->node))
L
Linus Torvalds 已提交
1646 1647 1648 1649
		uhci_clear_next_interrupt(uhci);
	else
		uhci_set_next_interrupt(uhci);
}