source: mainline/uspace/drv/bus/usb/xhci/bus.h@ 63431db2

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

usbhost bus: refactor the bus ops

This way, method names better represent the entity it is working with.
Their semantics was shifted a bit.

Regarding the tree of structures:

bus ← device ← endpoint ← batch

Previously, devices were kept in DDF function nodes, and endpoints had
pointer to the bus and device. Now, devices have pointer to bus,
endpoints don't.

Pointer to hcd_t in bus is WIP, and will be removed.

  • 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
54 usb_speed_t default_address_speed; /**< Used to get speed from usb hubs */
55} xhci_bus_t;
56
57int xhci_bus_init(xhci_bus_t *, xhci_hc_t *);
58void xhci_bus_fini(xhci_bus_t *);
59
60int xhci_bus_enumerate_device(xhci_bus_t *, device_t *);
61int xhci_bus_remove_device(xhci_bus_t *, device_t *);
62
63#endif
64/**
65 * @}
66 */
Note: See TracBrowser for help on using the repository browser.