TCG: remove broken stack allocation for call arguments
[qemu/mdroth.git] / hw / usb-uhci.c
blob405fa7b65ee695cbd260dcbfc01602dc65834ac3
1 /*
2 * USB UHCI controller emulation
4 * Copyright (c) 2005 Fabrice Bellard
6 * Copyright (c) 2008 Max Krasnyansky
7 * Magor rewrite of the UHCI data structures parser and frame processor
8 * Support for fully async operation and multiple outstanding transactions
10 * Permission is hereby granted, free of charge, to any person obtaining a copy
11 * of this software and associated documentation files (the "Software"), to deal
12 * in the Software without restriction, including without limitation the rights
13 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14 * copies of the Software, and to permit persons to whom the Software is
15 * furnished to do so, subject to the following conditions:
17 * The above copyright notice and this permission notice shall be included in
18 * all copies or substantial portions of the Software.
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
23 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
26 * THE SOFTWARE.
28 #include "hw.h"
29 #include "usb.h"
30 #include "pci.h"
31 #include "qemu-timer.h"
32 #include "usb-uhci.h"
34 //#define DEBUG
35 //#define DEBUG_DUMP_DATA
37 #define UHCI_CMD_FGR (1 << 4)
38 #define UHCI_CMD_EGSM (1 << 3)
39 #define UHCI_CMD_GRESET (1 << 2)
40 #define UHCI_CMD_HCRESET (1 << 1)
41 #define UHCI_CMD_RS (1 << 0)
43 #define UHCI_STS_HCHALTED (1 << 5)
44 #define UHCI_STS_HCPERR (1 << 4)
45 #define UHCI_STS_HSERR (1 << 3)
46 #define UHCI_STS_RD (1 << 2)
47 #define UHCI_STS_USBERR (1 << 1)
48 #define UHCI_STS_USBINT (1 << 0)
50 #define TD_CTRL_SPD (1 << 29)
51 #define TD_CTRL_ERROR_SHIFT 27
52 #define TD_CTRL_IOS (1 << 25)
53 #define TD_CTRL_IOC (1 << 24)
54 #define TD_CTRL_ACTIVE (1 << 23)
55 #define TD_CTRL_STALL (1 << 22)
56 #define TD_CTRL_BABBLE (1 << 20)
57 #define TD_CTRL_NAK (1 << 19)
58 #define TD_CTRL_TIMEOUT (1 << 18)
60 #define UHCI_PORT_SUSPEND (1 << 12)
61 #define UHCI_PORT_RESET (1 << 9)
62 #define UHCI_PORT_LSDA (1 << 8)
63 #define UHCI_PORT_RD (1 << 6)
64 #define UHCI_PORT_ENC (1 << 3)
65 #define UHCI_PORT_EN (1 << 2)
66 #define UHCI_PORT_CSC (1 << 1)
67 #define UHCI_PORT_CCS (1 << 0)
69 #define UHCI_PORT_READ_ONLY (0x1bb)
70 #define UHCI_PORT_WRITE_CLEAR (UHCI_PORT_CSC | UHCI_PORT_ENC)
72 #define FRAME_TIMER_FREQ 1000
74 #define FRAME_MAX_LOOPS 100
76 #define NB_PORTS 2
78 #ifdef DEBUG
79 #define DPRINTF printf
81 static const char *pid2str(int pid)
83 switch (pid) {
84 case USB_TOKEN_SETUP: return "SETUP";
85 case USB_TOKEN_IN: return "IN";
86 case USB_TOKEN_OUT: return "OUT";
88 return "?";
91 #else
92 #define DPRINTF(...)
93 #endif
95 #ifdef DEBUG_DUMP_DATA
96 static void dump_data(const uint8_t *data, int len)
98 int i;
100 printf("uhci: data: ");
101 for(i = 0; i < len; i++)
102 printf(" %02x", data[i]);
103 printf("\n");
105 #else
106 static void dump_data(const uint8_t *data, int len) {}
107 #endif
109 typedef struct UHCIState UHCIState;
112 * Pending async transaction.
113 * 'packet' must be the first field because completion
114 * handler does "(UHCIAsync *) pkt" cast.
116 typedef struct UHCIAsync {
117 USBPacket packet;
118 UHCIState *uhci;
119 QTAILQ_ENTRY(UHCIAsync) next;
120 uint32_t td;
121 uint32_t token;
122 int8_t valid;
123 uint8_t isoc;
124 uint8_t done;
125 uint8_t buffer[2048];
126 } UHCIAsync;
128 typedef struct UHCIPort {
129 USBPort port;
130 uint16_t ctrl;
131 } UHCIPort;
133 struct UHCIState {
134 PCIDevice dev;
135 USBBus bus;
136 uint16_t cmd; /* cmd register */
137 uint16_t status;
138 uint16_t intr; /* interrupt enable register */
139 uint16_t frnum; /* frame number */
140 uint32_t fl_base_addr; /* frame list base address */
141 uint8_t sof_timing;
142 uint8_t status2; /* bit 0 and 1 are used to generate UHCI_STS_USBINT */
143 int64_t expire_time;
144 QEMUTimer *frame_timer;
145 UHCIPort ports[NB_PORTS];
147 /* Interrupts that should be raised at the end of the current frame. */
148 uint32_t pending_int_mask;
150 /* Active packets */
151 QTAILQ_HEAD(,UHCIAsync) async_pending;
152 uint8_t num_ports_vmstate;
155 typedef struct UHCI_TD {
156 uint32_t link;
157 uint32_t ctrl; /* see TD_CTRL_xxx */
158 uint32_t token;
159 uint32_t buffer;
160 } UHCI_TD;
162 typedef struct UHCI_QH {
163 uint32_t link;
164 uint32_t el_link;
165 } UHCI_QH;
167 static UHCIAsync *uhci_async_alloc(UHCIState *s)
169 UHCIAsync *async = qemu_malloc(sizeof(UHCIAsync));
171 memset(&async->packet, 0, sizeof(async->packet));
172 async->uhci = s;
173 async->valid = 0;
174 async->td = 0;
175 async->token = 0;
176 async->done = 0;
177 async->isoc = 0;
179 return async;
182 static void uhci_async_free(UHCIState *s, UHCIAsync *async)
184 qemu_free(async);
187 static void uhci_async_link(UHCIState *s, UHCIAsync *async)
189 QTAILQ_INSERT_HEAD(&s->async_pending, async, next);
192 static void uhci_async_unlink(UHCIState *s, UHCIAsync *async)
194 QTAILQ_REMOVE(&s->async_pending, async, next);
197 static void uhci_async_cancel(UHCIState *s, UHCIAsync *async)
199 DPRINTF("uhci: cancel td 0x%x token 0x%x done %u\n",
200 async->td, async->token, async->done);
202 if (!async->done)
203 usb_cancel_packet(&async->packet);
204 uhci_async_free(s, async);
208 * Mark all outstanding async packets as invalid.
209 * This is used for canceling them when TDs are removed by the HCD.
211 static UHCIAsync *uhci_async_validate_begin(UHCIState *s)
213 UHCIAsync *async;
215 QTAILQ_FOREACH(async, &s->async_pending, next) {
216 async->valid--;
218 return NULL;
222 * Cancel async packets that are no longer valid
224 static void uhci_async_validate_end(UHCIState *s)
226 UHCIAsync *curr, *n;
228 QTAILQ_FOREACH_SAFE(curr, &s->async_pending, next, n) {
229 if (curr->valid > 0) {
230 continue;
232 uhci_async_unlink(s, curr);
233 uhci_async_cancel(s, curr);
237 static void uhci_async_cancel_device(UHCIState *s, USBDevice *dev)
239 UHCIAsync *curr, *n;
241 QTAILQ_FOREACH_SAFE(curr, &s->async_pending, next, n) {
242 if (curr->packet.owner != dev) {
243 continue;
245 uhci_async_unlink(s, curr);
246 uhci_async_cancel(s, curr);
250 static void uhci_async_cancel_all(UHCIState *s)
252 UHCIAsync *curr, *n;
254 QTAILQ_FOREACH_SAFE(curr, &s->async_pending, next, n) {
255 uhci_async_unlink(s, curr);
256 uhci_async_cancel(s, curr);
260 static UHCIAsync *uhci_async_find_td(UHCIState *s, uint32_t addr, uint32_t token)
262 UHCIAsync *async;
263 UHCIAsync *match = NULL;
264 int count = 0;
267 * We're looking for the best match here. ie both td addr and token.
268 * Otherwise we return last good match. ie just token.
269 * It's ok to match just token because it identifies the transaction
270 * rather well, token includes: device addr, endpoint, size, etc.
272 * Also since we queue async transactions in reverse order by returning
273 * last good match we restores the order.
275 * It's expected that we wont have a ton of outstanding transactions.
276 * If we ever do we'd want to optimize this algorithm.
279 QTAILQ_FOREACH(async, &s->async_pending, next) {
280 if (async->token == token) {
281 /* Good match */
282 match = async;
284 if (async->td == addr) {
285 /* Best match */
286 break;
289 count++;
292 if (count > 64)
293 fprintf(stderr, "uhci: warning lots of async transactions\n");
295 return match;
298 static void uhci_update_irq(UHCIState *s)
300 int level;
301 if (((s->status2 & 1) && (s->intr & (1 << 2))) ||
302 ((s->status2 & 2) && (s->intr & (1 << 3))) ||
303 ((s->status & UHCI_STS_USBERR) && (s->intr & (1 << 0))) ||
304 ((s->status & UHCI_STS_RD) && (s->intr & (1 << 1))) ||
305 (s->status & UHCI_STS_HSERR) ||
306 (s->status & UHCI_STS_HCPERR)) {
307 level = 1;
308 } else {
309 level = 0;
311 qemu_set_irq(s->dev.irq[3], level);
314 static void uhci_reset(void *opaque)
316 UHCIState *s = opaque;
317 uint8_t *pci_conf;
318 int i;
319 UHCIPort *port;
321 DPRINTF("uhci: full reset\n");
323 pci_conf = s->dev.config;
325 pci_conf[0x6a] = 0x01; /* usb clock */
326 pci_conf[0x6b] = 0x00;
327 s->cmd = 0;
328 s->status = 0;
329 s->status2 = 0;
330 s->intr = 0;
331 s->fl_base_addr = 0;
332 s->sof_timing = 64;
334 for(i = 0; i < NB_PORTS; i++) {
335 port = &s->ports[i];
336 port->ctrl = 0x0080;
337 if (port->port.dev) {
338 usb_attach(&port->port, port->port.dev);
342 uhci_async_cancel_all(s);
345 static void uhci_pre_save(void *opaque)
347 UHCIState *s = opaque;
349 uhci_async_cancel_all(s);
352 static const VMStateDescription vmstate_uhci_port = {
353 .name = "uhci port",
354 .version_id = 1,
355 .minimum_version_id = 1,
356 .minimum_version_id_old = 1,
357 .fields = (VMStateField []) {
358 VMSTATE_UINT16(ctrl, UHCIPort),
359 VMSTATE_END_OF_LIST()
363 static const VMStateDescription vmstate_uhci = {
364 .name = "uhci",
365 .version_id = 2,
366 .minimum_version_id = 1,
367 .minimum_version_id_old = 1,
368 .pre_save = uhci_pre_save,
369 .fields = (VMStateField []) {
370 VMSTATE_PCI_DEVICE(dev, UHCIState),
371 VMSTATE_UINT8_EQUAL(num_ports_vmstate, UHCIState),
372 VMSTATE_STRUCT_ARRAY(ports, UHCIState, NB_PORTS, 1,
373 vmstate_uhci_port, UHCIPort),
374 VMSTATE_UINT16(cmd, UHCIState),
375 VMSTATE_UINT16(status, UHCIState),
376 VMSTATE_UINT16(intr, UHCIState),
377 VMSTATE_UINT16(frnum, UHCIState),
378 VMSTATE_UINT32(fl_base_addr, UHCIState),
379 VMSTATE_UINT8(sof_timing, UHCIState),
380 VMSTATE_UINT8(status2, UHCIState),
381 VMSTATE_TIMER(frame_timer, UHCIState),
382 VMSTATE_INT64_V(expire_time, UHCIState, 2),
383 VMSTATE_END_OF_LIST()
387 static void uhci_ioport_writeb(void *opaque, uint32_t addr, uint32_t val)
389 UHCIState *s = opaque;
391 addr &= 0x1f;
392 switch(addr) {
393 case 0x0c:
394 s->sof_timing = val;
395 break;
399 static uint32_t uhci_ioport_readb(void *opaque, uint32_t addr)
401 UHCIState *s = opaque;
402 uint32_t val;
404 addr &= 0x1f;
405 switch(addr) {
406 case 0x0c:
407 val = s->sof_timing;
408 break;
409 default:
410 val = 0xff;
411 break;
413 return val;
416 static void uhci_ioport_writew(void *opaque, uint32_t addr, uint32_t val)
418 UHCIState *s = opaque;
420 addr &= 0x1f;
421 DPRINTF("uhci: writew port=0x%04x val=0x%04x\n", addr, val);
423 switch(addr) {
424 case 0x00:
425 if ((val & UHCI_CMD_RS) && !(s->cmd & UHCI_CMD_RS)) {
426 /* start frame processing */
427 s->expire_time = qemu_get_clock_ns(vm_clock) +
428 (get_ticks_per_sec() / FRAME_TIMER_FREQ);
429 qemu_mod_timer(s->frame_timer, qemu_get_clock_ns(vm_clock));
430 s->status &= ~UHCI_STS_HCHALTED;
431 } else if (!(val & UHCI_CMD_RS)) {
432 s->status |= UHCI_STS_HCHALTED;
434 if (val & UHCI_CMD_GRESET) {
435 UHCIPort *port;
436 USBDevice *dev;
437 int i;
439 /* send reset on the USB bus */
440 for(i = 0; i < NB_PORTS; i++) {
441 port = &s->ports[i];
442 dev = port->port.dev;
443 if (dev) {
444 usb_send_msg(dev, USB_MSG_RESET);
447 uhci_reset(s);
448 return;
450 if (val & UHCI_CMD_HCRESET) {
451 uhci_reset(s);
452 return;
454 s->cmd = val;
455 break;
456 case 0x02:
457 s->status &= ~val;
458 /* XXX: the chip spec is not coherent, so we add a hidden
459 register to distinguish between IOC and SPD */
460 if (val & UHCI_STS_USBINT)
461 s->status2 = 0;
462 uhci_update_irq(s);
463 break;
464 case 0x04:
465 s->intr = val;
466 uhci_update_irq(s);
467 break;
468 case 0x06:
469 if (s->status & UHCI_STS_HCHALTED)
470 s->frnum = val & 0x7ff;
471 break;
472 case 0x10 ... 0x1f:
474 UHCIPort *port;
475 USBDevice *dev;
476 int n;
478 n = (addr >> 1) & 7;
479 if (n >= NB_PORTS)
480 return;
481 port = &s->ports[n];
482 dev = port->port.dev;
483 if (dev) {
484 /* port reset */
485 if ( (val & UHCI_PORT_RESET) &&
486 !(port->ctrl & UHCI_PORT_RESET) ) {
487 usb_send_msg(dev, USB_MSG_RESET);
490 port->ctrl &= UHCI_PORT_READ_ONLY;
491 port->ctrl |= (val & ~UHCI_PORT_READ_ONLY);
492 /* some bits are reset when a '1' is written to them */
493 port->ctrl &= ~(val & UHCI_PORT_WRITE_CLEAR);
495 break;
499 static uint32_t uhci_ioport_readw(void *opaque, uint32_t addr)
501 UHCIState *s = opaque;
502 uint32_t val;
504 addr &= 0x1f;
505 switch(addr) {
506 case 0x00:
507 val = s->cmd;
508 break;
509 case 0x02:
510 val = s->status;
511 break;
512 case 0x04:
513 val = s->intr;
514 break;
515 case 0x06:
516 val = s->frnum;
517 break;
518 case 0x10 ... 0x1f:
520 UHCIPort *port;
521 int n;
522 n = (addr >> 1) & 7;
523 if (n >= NB_PORTS)
524 goto read_default;
525 port = &s->ports[n];
526 val = port->ctrl;
528 break;
529 default:
530 read_default:
531 val = 0xff7f; /* disabled port */
532 break;
535 DPRINTF("uhci: readw port=0x%04x val=0x%04x\n", addr, val);
537 return val;
540 static void uhci_ioport_writel(void *opaque, uint32_t addr, uint32_t val)
542 UHCIState *s = opaque;
544 addr &= 0x1f;
545 DPRINTF("uhci: writel port=0x%04x val=0x%08x\n", addr, val);
547 switch(addr) {
548 case 0x08:
549 s->fl_base_addr = val & ~0xfff;
550 break;
554 static uint32_t uhci_ioport_readl(void *opaque, uint32_t addr)
556 UHCIState *s = opaque;
557 uint32_t val;
559 addr &= 0x1f;
560 switch(addr) {
561 case 0x08:
562 val = s->fl_base_addr;
563 break;
564 default:
565 val = 0xffffffff;
566 break;
568 return val;
571 /* signal resume if controller suspended */
572 static void uhci_resume (void *opaque)
574 UHCIState *s = (UHCIState *)opaque;
576 if (!s)
577 return;
579 if (s->cmd & UHCI_CMD_EGSM) {
580 s->cmd |= UHCI_CMD_FGR;
581 s->status |= UHCI_STS_RD;
582 uhci_update_irq(s);
586 static void uhci_attach(USBPort *port1)
588 UHCIState *s = port1->opaque;
589 UHCIPort *port = &s->ports[port1->index];
591 /* set connect status */
592 port->ctrl |= UHCI_PORT_CCS | UHCI_PORT_CSC;
594 /* update speed */
595 if (port->port.dev->speed == USB_SPEED_LOW) {
596 port->ctrl |= UHCI_PORT_LSDA;
597 } else {
598 port->ctrl &= ~UHCI_PORT_LSDA;
601 uhci_resume(s);
604 static void uhci_detach(USBPort *port1)
606 UHCIState *s = port1->opaque;
607 UHCIPort *port = &s->ports[port1->index];
609 /* set connect status */
610 if (port->ctrl & UHCI_PORT_CCS) {
611 port->ctrl &= ~UHCI_PORT_CCS;
612 port->ctrl |= UHCI_PORT_CSC;
614 /* disable port */
615 if (port->ctrl & UHCI_PORT_EN) {
616 port->ctrl &= ~UHCI_PORT_EN;
617 port->ctrl |= UHCI_PORT_ENC;
620 uhci_resume(s);
623 static void uhci_wakeup(USBDevice *dev)
625 USBBus *bus = usb_bus_from_device(dev);
626 UHCIState *s = container_of(bus, UHCIState, bus);
627 UHCIPort *port = s->ports + dev->port->index;
629 if (port->ctrl & UHCI_PORT_SUSPEND && !(port->ctrl & UHCI_PORT_RD)) {
630 port->ctrl |= UHCI_PORT_RD;
631 uhci_resume(s);
635 static int uhci_broadcast_packet(UHCIState *s, USBPacket *p)
637 int i, ret;
639 DPRINTF("uhci: packet enter. pid %s addr 0x%02x ep %d len %d\n",
640 pid2str(p->pid), p->devaddr, p->devep, p->len);
641 if (p->pid == USB_TOKEN_OUT || p->pid == USB_TOKEN_SETUP)
642 dump_data(p->data, p->len);
644 ret = USB_RET_NODEV;
645 for (i = 0; i < NB_PORTS && ret == USB_RET_NODEV; i++) {
646 UHCIPort *port = &s->ports[i];
647 USBDevice *dev = port->port.dev;
649 if (dev && (port->ctrl & UHCI_PORT_EN))
650 ret = usb_handle_packet(dev, p);
653 DPRINTF("uhci: packet exit. ret %d len %d\n", ret, p->len);
654 if (p->pid == USB_TOKEN_IN && ret > 0)
655 dump_data(p->data, ret);
657 return ret;
660 static void uhci_async_complete(USBDevice *dev, USBPacket *packet);
661 static void uhci_process_frame(UHCIState *s);
663 /* return -1 if fatal error (frame must be stopped)
664 0 if TD successful
665 1 if TD unsuccessful or inactive
667 static int uhci_complete_td(UHCIState *s, UHCI_TD *td, UHCIAsync *async, uint32_t *int_mask)
669 int len = 0, max_len, err, ret;
670 uint8_t pid;
672 max_len = ((td->token >> 21) + 1) & 0x7ff;
673 pid = td->token & 0xff;
675 ret = async->packet.len;
677 if (td->ctrl & TD_CTRL_IOS)
678 td->ctrl &= ~TD_CTRL_ACTIVE;
680 if (ret < 0)
681 goto out;
683 len = async->packet.len;
684 td->ctrl = (td->ctrl & ~0x7ff) | ((len - 1) & 0x7ff);
686 /* The NAK bit may have been set by a previous frame, so clear it
687 here. The docs are somewhat unclear, but win2k relies on this
688 behavior. */
689 td->ctrl &= ~(TD_CTRL_ACTIVE | TD_CTRL_NAK);
690 if (td->ctrl & TD_CTRL_IOC)
691 *int_mask |= 0x01;
693 if (pid == USB_TOKEN_IN) {
694 if (len > max_len) {
695 ret = USB_RET_BABBLE;
696 goto out;
699 if (len > 0) {
700 /* write the data back */
701 cpu_physical_memory_write(td->buffer, async->buffer, len);
704 if ((td->ctrl & TD_CTRL_SPD) && len < max_len) {
705 *int_mask |= 0x02;
706 /* short packet: do not update QH */
707 DPRINTF("uhci: short packet. td 0x%x token 0x%x\n", async->td, async->token);
708 return 1;
712 /* success */
713 return 0;
715 out:
716 switch(ret) {
717 case USB_RET_STALL:
718 td->ctrl |= TD_CTRL_STALL;
719 td->ctrl &= ~TD_CTRL_ACTIVE;
720 s->status |= UHCI_STS_USBERR;
721 uhci_update_irq(s);
722 return 1;
724 case USB_RET_BABBLE:
725 td->ctrl |= TD_CTRL_BABBLE | TD_CTRL_STALL;
726 td->ctrl &= ~TD_CTRL_ACTIVE;
727 s->status |= UHCI_STS_USBERR;
728 uhci_update_irq(s);
729 /* frame interrupted */
730 return -1;
732 case USB_RET_NAK:
733 td->ctrl |= TD_CTRL_NAK;
734 if (pid == USB_TOKEN_SETUP)
735 break;
736 return 1;
738 case USB_RET_NODEV:
739 default:
740 break;
743 /* Retry the TD if error count is not zero */
745 td->ctrl |= TD_CTRL_TIMEOUT;
746 err = (td->ctrl >> TD_CTRL_ERROR_SHIFT) & 3;
747 if (err != 0) {
748 err--;
749 if (err == 0) {
750 td->ctrl &= ~TD_CTRL_ACTIVE;
751 s->status |= UHCI_STS_USBERR;
752 if (td->ctrl & TD_CTRL_IOC)
753 *int_mask |= 0x01;
754 uhci_update_irq(s);
757 td->ctrl = (td->ctrl & ~(3 << TD_CTRL_ERROR_SHIFT)) |
758 (err << TD_CTRL_ERROR_SHIFT);
759 return 1;
762 static int uhci_handle_td(UHCIState *s, uint32_t addr, UHCI_TD *td, uint32_t *int_mask)
764 UHCIAsync *async;
765 int len = 0, max_len;
766 uint8_t pid, isoc;
767 uint32_t token;
769 /* Is active ? */
770 if (!(td->ctrl & TD_CTRL_ACTIVE))
771 return 1;
773 /* token field is not unique for isochronous requests,
774 * so use the destination buffer
776 if (td->ctrl & TD_CTRL_IOS) {
777 token = td->buffer;
778 isoc = 1;
779 } else {
780 token = td->token;
781 isoc = 0;
784 async = uhci_async_find_td(s, addr, token);
785 if (async) {
786 /* Already submitted */
787 async->valid = 32;
789 if (!async->done)
790 return 1;
792 uhci_async_unlink(s, async);
793 goto done;
796 /* Allocate new packet */
797 async = uhci_async_alloc(s);
798 if (!async)
799 return 1;
801 /* valid needs to be large enough to handle 10 frame delay
802 * for initial isochronous requests
804 async->valid = 32;
805 async->td = addr;
806 async->token = token;
807 async->isoc = isoc;
809 max_len = ((td->token >> 21) + 1) & 0x7ff;
810 pid = td->token & 0xff;
812 async->packet.pid = pid;
813 async->packet.devaddr = (td->token >> 8) & 0x7f;
814 async->packet.devep = (td->token >> 15) & 0xf;
815 async->packet.data = async->buffer;
816 async->packet.len = max_len;
818 switch(pid) {
819 case USB_TOKEN_OUT:
820 case USB_TOKEN_SETUP:
821 cpu_physical_memory_read(td->buffer, async->buffer, max_len);
822 len = uhci_broadcast_packet(s, &async->packet);
823 if (len >= 0)
824 len = max_len;
825 break;
827 case USB_TOKEN_IN:
828 len = uhci_broadcast_packet(s, &async->packet);
829 break;
831 default:
832 /* invalid pid : frame interrupted */
833 uhci_async_free(s, async);
834 s->status |= UHCI_STS_HCPERR;
835 uhci_update_irq(s);
836 return -1;
839 if (len == USB_RET_ASYNC) {
840 uhci_async_link(s, async);
841 return 2;
844 async->packet.len = len;
846 done:
847 len = uhci_complete_td(s, td, async, int_mask);
848 uhci_async_free(s, async);
849 return len;
852 static void uhci_async_complete(USBDevice *dev, USBPacket *packet)
854 UHCIAsync *async = container_of(packet, UHCIAsync, packet);
855 UHCIState *s = async->uhci;
857 DPRINTF("uhci: async complete. td 0x%x token 0x%x\n", async->td, async->token);
859 if (async->isoc) {
860 UHCI_TD td;
861 uint32_t link = async->td;
862 uint32_t int_mask = 0, val;
864 cpu_physical_memory_read(link & ~0xf, (uint8_t *) &td, sizeof(td));
865 le32_to_cpus(&td.link);
866 le32_to_cpus(&td.ctrl);
867 le32_to_cpus(&td.token);
868 le32_to_cpus(&td.buffer);
870 uhci_async_unlink(s, async);
871 uhci_complete_td(s, &td, async, &int_mask);
872 s->pending_int_mask |= int_mask;
874 /* update the status bits of the TD */
875 val = cpu_to_le32(td.ctrl);
876 cpu_physical_memory_write((link & ~0xf) + 4,
877 (const uint8_t *)&val, sizeof(val));
878 uhci_async_free(s, async);
879 } else {
880 async->done = 1;
881 uhci_process_frame(s);
885 static int is_valid(uint32_t link)
887 return (link & 1) == 0;
890 static int is_qh(uint32_t link)
892 return (link & 2) != 0;
895 static int depth_first(uint32_t link)
897 return (link & 4) != 0;
900 /* QH DB used for detecting QH loops */
901 #define UHCI_MAX_QUEUES 128
902 typedef struct {
903 uint32_t addr[UHCI_MAX_QUEUES];
904 int count;
905 } QhDb;
907 static void qhdb_reset(QhDb *db)
909 db->count = 0;
912 /* Add QH to DB. Returns 1 if already present or DB is full. */
913 static int qhdb_insert(QhDb *db, uint32_t addr)
915 int i;
916 for (i = 0; i < db->count; i++)
917 if (db->addr[i] == addr)
918 return 1;
920 if (db->count >= UHCI_MAX_QUEUES)
921 return 1;
923 db->addr[db->count++] = addr;
924 return 0;
927 static void uhci_process_frame(UHCIState *s)
929 uint32_t frame_addr, link, old_td_ctrl, val, int_mask;
930 uint32_t curr_qh;
931 int cnt, ret;
932 UHCI_TD td;
933 UHCI_QH qh;
934 QhDb qhdb;
936 frame_addr = s->fl_base_addr + ((s->frnum & 0x3ff) << 2);
938 DPRINTF("uhci: processing frame %d addr 0x%x\n" , s->frnum, frame_addr);
940 cpu_physical_memory_read(frame_addr, (uint8_t *)&link, 4);
941 le32_to_cpus(&link);
943 int_mask = 0;
944 curr_qh = 0;
946 qhdb_reset(&qhdb);
948 for (cnt = FRAME_MAX_LOOPS; is_valid(link) && cnt; cnt--) {
949 if (is_qh(link)) {
950 /* QH */
952 if (qhdb_insert(&qhdb, link)) {
954 * We're going in circles. Which is not a bug because
955 * HCD is allowed to do that as part of the BW management.
956 * In our case though it makes no sense to spin here. Sync transations
957 * are already done, and async completion handler will re-process
958 * the frame when something is ready.
960 DPRINTF("uhci: detected loop. qh 0x%x\n", link);
961 break;
964 cpu_physical_memory_read(link & ~0xf, (uint8_t *) &qh, sizeof(qh));
965 le32_to_cpus(&qh.link);
966 le32_to_cpus(&qh.el_link);
968 DPRINTF("uhci: QH 0x%x load. link 0x%x elink 0x%x\n",
969 link, qh.link, qh.el_link);
971 if (!is_valid(qh.el_link)) {
972 /* QH w/o elements */
973 curr_qh = 0;
974 link = qh.link;
975 } else {
976 /* QH with elements */
977 curr_qh = link;
978 link = qh.el_link;
980 continue;
983 /* TD */
984 cpu_physical_memory_read(link & ~0xf, (uint8_t *) &td, sizeof(td));
985 le32_to_cpus(&td.link);
986 le32_to_cpus(&td.ctrl);
987 le32_to_cpus(&td.token);
988 le32_to_cpus(&td.buffer);
990 DPRINTF("uhci: TD 0x%x load. link 0x%x ctrl 0x%x token 0x%x qh 0x%x\n",
991 link, td.link, td.ctrl, td.token, curr_qh);
993 old_td_ctrl = td.ctrl;
994 ret = uhci_handle_td(s, link, &td, &int_mask);
995 if (old_td_ctrl != td.ctrl) {
996 /* update the status bits of the TD */
997 val = cpu_to_le32(td.ctrl);
998 cpu_physical_memory_write((link & ~0xf) + 4,
999 (const uint8_t *)&val, sizeof(val));
1002 if (ret < 0) {
1003 /* interrupted frame */
1004 break;
1007 if (ret == 2 || ret == 1) {
1008 DPRINTF("uhci: TD 0x%x %s. link 0x%x ctrl 0x%x token 0x%x qh 0x%x\n",
1009 link, ret == 2 ? "pend" : "skip",
1010 td.link, td.ctrl, td.token, curr_qh);
1012 link = curr_qh ? qh.link : td.link;
1013 continue;
1016 /* completed TD */
1018 DPRINTF("uhci: TD 0x%x done. link 0x%x ctrl 0x%x token 0x%x qh 0x%x\n",
1019 link, td.link, td.ctrl, td.token, curr_qh);
1021 link = td.link;
1023 if (curr_qh) {
1024 /* update QH element link */
1025 qh.el_link = link;
1026 val = cpu_to_le32(qh.el_link);
1027 cpu_physical_memory_write((curr_qh & ~0xf) + 4,
1028 (const uint8_t *)&val, sizeof(val));
1030 if (!depth_first(link)) {
1031 /* done with this QH */
1033 DPRINTF("uhci: QH 0x%x done. link 0x%x elink 0x%x\n",
1034 curr_qh, qh.link, qh.el_link);
1036 curr_qh = 0;
1037 link = qh.link;
1041 /* go to the next entry */
1044 s->pending_int_mask |= int_mask;
1047 static void uhci_frame_timer(void *opaque)
1049 UHCIState *s = opaque;
1051 /* prepare the timer for the next frame */
1052 s->expire_time += (get_ticks_per_sec() / FRAME_TIMER_FREQ);
1054 if (!(s->cmd & UHCI_CMD_RS)) {
1055 /* Full stop */
1056 qemu_del_timer(s->frame_timer);
1057 /* set hchalted bit in status - UHCI11D 2.1.2 */
1058 s->status |= UHCI_STS_HCHALTED;
1060 DPRINTF("uhci: halted\n");
1061 return;
1064 /* Complete the previous frame */
1065 if (s->pending_int_mask) {
1066 s->status2 |= s->pending_int_mask;
1067 s->status |= UHCI_STS_USBINT;
1068 uhci_update_irq(s);
1070 s->pending_int_mask = 0;
1072 /* Start new frame */
1073 s->frnum = (s->frnum + 1) & 0x7ff;
1075 DPRINTF("uhci: new frame #%u\n" , s->frnum);
1077 uhci_async_validate_begin(s);
1079 uhci_process_frame(s);
1081 uhci_async_validate_end(s);
1083 qemu_mod_timer(s->frame_timer, s->expire_time);
1086 static void uhci_map(PCIDevice *pci_dev, int region_num,
1087 pcibus_t addr, pcibus_t size, int type)
1089 UHCIState *s = (UHCIState *)pci_dev;
1091 register_ioport_write(addr, 32, 2, uhci_ioport_writew, s);
1092 register_ioport_read(addr, 32, 2, uhci_ioport_readw, s);
1093 register_ioport_write(addr, 32, 4, uhci_ioport_writel, s);
1094 register_ioport_read(addr, 32, 4, uhci_ioport_readl, s);
1095 register_ioport_write(addr, 32, 1, uhci_ioport_writeb, s);
1096 register_ioport_read(addr, 32, 1, uhci_ioport_readb, s);
1099 static void uhci_device_destroy(USBBus *bus, USBDevice *dev)
1101 UHCIState *s = container_of(bus, UHCIState, bus);
1103 uhci_async_cancel_device(s, dev);
1106 static USBPortOps uhci_port_ops = {
1107 .attach = uhci_attach,
1108 .detach = uhci_detach,
1109 .wakeup = uhci_wakeup,
1110 .complete = uhci_async_complete,
1113 static USBBusOps uhci_bus_ops = {
1114 .device_destroy = uhci_device_destroy,
1117 static int usb_uhci_common_initfn(PCIDevice *dev)
1119 UHCIState *s = DO_UPCAST(UHCIState, dev, dev);
1120 uint8_t *pci_conf = s->dev.config;
1121 int i;
1123 pci_conf[PCI_CLASS_PROG] = 0x00;
1124 /* TODO: reset value should be 0. */
1125 pci_conf[PCI_INTERRUPT_PIN] = 4; // interrupt pin 3
1126 pci_conf[USB_SBRN] = USB_RELEASE_1; // release number
1128 usb_bus_new(&s->bus, &uhci_bus_ops, &s->dev.qdev);
1129 for(i = 0; i < NB_PORTS; i++) {
1130 usb_register_port(&s->bus, &s->ports[i].port, s, i, &uhci_port_ops,
1131 USB_SPEED_MASK_LOW | USB_SPEED_MASK_FULL);
1132 usb_port_location(&s->ports[i].port, NULL, i+1);
1134 s->frame_timer = qemu_new_timer_ns(vm_clock, uhci_frame_timer, s);
1135 s->num_ports_vmstate = NB_PORTS;
1136 QTAILQ_INIT(&s->async_pending);
1138 qemu_register_reset(uhci_reset, s);
1140 /* Use region 4 for consistency with real hardware. BSD guests seem
1141 to rely on this. */
1142 pci_register_bar(&s->dev, 4, 0x20,
1143 PCI_BASE_ADDRESS_SPACE_IO, uhci_map);
1145 return 0;
1148 static int usb_uhci_vt82c686b_initfn(PCIDevice *dev)
1150 UHCIState *s = DO_UPCAST(UHCIState, dev, dev);
1151 uint8_t *pci_conf = s->dev.config;
1153 /* USB misc control 1/2 */
1154 pci_set_long(pci_conf + 0x40,0x00001000);
1155 /* PM capability */
1156 pci_set_long(pci_conf + 0x80,0x00020001);
1157 /* USB legacy support */
1158 pci_set_long(pci_conf + 0xc0,0x00002000);
1160 return usb_uhci_common_initfn(dev);
1163 static PCIDeviceInfo uhci_info[] = {
1165 .qdev.name = "piix3-usb-uhci",
1166 .qdev.size = sizeof(UHCIState),
1167 .qdev.vmsd = &vmstate_uhci,
1168 .init = usb_uhci_common_initfn,
1169 .vendor_id = PCI_VENDOR_ID_INTEL,
1170 .device_id = PCI_DEVICE_ID_INTEL_82371SB_2,
1171 .revision = 0x01,
1172 .class_id = PCI_CLASS_SERIAL_USB,
1174 .qdev.name = "piix4-usb-uhci",
1175 .qdev.size = sizeof(UHCIState),
1176 .qdev.vmsd = &vmstate_uhci,
1177 .init = usb_uhci_common_initfn,
1178 .vendor_id = PCI_VENDOR_ID_INTEL,
1179 .device_id = PCI_DEVICE_ID_INTEL_82371AB_2,
1180 .revision = 0x01,
1181 .class_id = PCI_CLASS_SERIAL_USB,
1183 .qdev.name = "vt82c686b-usb-uhci",
1184 .qdev.size = sizeof(UHCIState),
1185 .qdev.vmsd = &vmstate_uhci,
1186 .init = usb_uhci_vt82c686b_initfn,
1187 .vendor_id = PCI_VENDOR_ID_VIA,
1188 .device_id = PCI_DEVICE_ID_VIA_UHCI,
1189 .revision = 0x01,
1190 .class_id = PCI_CLASS_SERIAL_USB,
1192 /* end of list */
1196 static void uhci_register(void)
1198 pci_qdev_register_many(uhci_info);
1200 device_init(uhci_register);
1202 void usb_uhci_piix3_init(PCIBus *bus, int devfn)
1204 pci_create_simple(bus, devfn, "piix3-usb-uhci");
1207 void usb_uhci_piix4_init(PCIBus *bus, int devfn)
1209 pci_create_simple(bus, devfn, "piix4-usb-uhci");
1212 void usb_uhci_vt82c686b_init(PCIBus *bus, int devfn)
1214 pci_create_simple(bus, devfn, "vt82c686b-usb-uhci");