source: mainline/uspace/drv/bus/usb/xhci/bus.h@ 61e27e80

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 61e27e80 was 708d8fcd, checked in by Ondřej Hlavatý <aearsis@…>, 8 years ago

xhci: rewritten isochronous transfers

There was a fundamental problem with relying on hardware to send
RING_OVERRUN/UNDERRUN events, which QEMU (and possibly others) do not
send. That resulted in not knowing if the transfer is still on schedule,
and having to ring the doorbell every time. That is not feasible,
because then the transfer can be more frequent than it should be.
Furthermore, it ignored the fact that isochronous TRBs are to be
scheduled not too late, but also not too soon (see 4.11.2.5 of the xHCI
spec).

Now, scheduling the TRBs to hardware is called feeding, and can be
delayed by setting a timer. Ring overruns/underruns are detected also at
the end of handling an event.

  • Property mode set to 100644
File size: 2.4 KB
Line 
1/*
2 * Copyright (c) 2017 Ondrej Hlavaty <aearsis@eideo.cz>
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28/** @addtogroup libusbhost
29 * @{
30 */
31/** @file
32 *
33 * An implementation of bus keeper for xHCI. The (physical) HC itself takes
34 * care about addressing devices, so this implementation is actually simpler
35 * than those of [OUE]HCI.
36 */
37#ifndef XHCI_BUS_H
38#define XHCI_BUS_H
39
40#include <usb/usb.h>
41#include <usb/host/bus.h>
42
43typedef struct xhci_hc xhci_hc_t;
44typedef struct xhci_device xhci_device_t;
45
46/** Endpoint management structure */
47typedef struct xhci_bus {
48 bus_t base; /**< Inheritance. Keep this first. */
49
50 xhci_hc_t *hc; /**< Pointer to managing HC (to issue commands) */
51
52 xhci_device_t **devices_by_slot; /**< Devices by Slot ID */
53} xhci_bus_t;
54
55int xhci_bus_init(xhci_bus_t *, xhci_hc_t *);
56void xhci_bus_fini(xhci_bus_t *);
57
58int xhci_bus_enumerate_device(xhci_bus_t *, device_t *);
59int xhci_bus_remove_device(xhci_bus_t *, device_t *);
60
61static inline xhci_bus_t *bus_to_xhci_bus(bus_t *bus_base)
62{
63 assert(bus_base);
64 return (xhci_bus_t *) bus_base;
65}
66
67#endif
68/**
69 * @}
70 */
Note: See TracBrowser for help on using the repository browser.