source: mainline/uspace/drv/bus/usb/ehci/ehci_bus.h@ a8723748

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since a8723748 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.6 KB
Line 
1/*
2 * Copyright (c) 2011 Jan Vesely
3 * Copyright (c) 2017 Ondrej Hlavaty <aearsis@eideo.cz>
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 *
10 * - Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * - Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * - The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 */
29/** @addtogroup drvusbehci
30 * @{
31 */
32/** @file
33 * @brief EHCI driver
34 */
35#ifndef DRV_EHCI_HCD_BUS_H
36#define DRV_EHCI_HCD_BUS_H
37
38#include <assert.h>
39#include <adt/list.h>
40#include <usb/host/usb2_bus.h>
41#include <usb/host/endpoint.h>
42
43#include "hw_struct/queue_head.h"
44
45/** Connector structure linking ED to to prepared TD. */
46typedef struct ehci_endpoint {
47 /* Inheritance */
48 endpoint_t base;
49
50 /** EHCI endpoint descriptor */
51 qh_t *qh;
52 /** Linked list used by driver software */
53 link_t link;
54} ehci_endpoint_t;
55
56typedef struct hc hc_t;
57
58typedef struct {
59 usb2_bus_t base;
60 hc_t *hc;
61} ehci_bus_t;
62
63void ehci_bus_prepare_ops(void);
64
65int ehci_bus_init(ehci_bus_t *, hcd_t *, hc_t *);
66
67/** Get and convert assigned ehci_endpoint_t structure
68 * @param[in] ep USBD endpoint structure.
69 * @return Pointer to assigned hcd endpoint structure
70 */
71static inline ehci_endpoint_t * ehci_endpoint_get(const endpoint_t *ep)
72{
73 assert(ep);
74 return (ehci_endpoint_t *) ep;
75}
76
77static inline ehci_endpoint_t * ehci_endpoint_list_instance(link_t *l)
78{
79 return list_get_instance(l, ehci_endpoint_t, link);
80}
81
82#endif
83/**
84 * @}
85 */
Note: See TracBrowser for help on using the repository browser.