source: mainline/uspace/lib/usbhost/src/endpoint.c@ 2fd1f0c6

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 2fd1f0c6 was 48ae3ef, checked in by Jan Vesely <jano.vesely@…>, 14 years ago

libusbhost: Make interfaces more symmetric.

Make usb_endpoint_manager interface easier to use and understand.
Move ep removal hook pointer from endpoint_t to hcd_t.
  • Property mode set to 100644
File size: 4.5 KB
Line 
1/*
2 * Copyright (c) 2011 Jan Vesely
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
29/** @addtogroup drvusbuhcihc
30 * @{
31 */
32/** @file
33 * @brief UHCI host controller driver structure
34 */
35
36#include <assert.h>
37#include <stdlib.h>
38#include <errno.h>
39#include <usb/host/endpoint.h>
40
41endpoint_t * endpoint_create(usb_address_t address, usb_endpoint_t endpoint,
42 usb_direction_t direction, usb_transfer_type_t type, usb_speed_t speed,
43 size_t max_packet_size, size_t bw)
44{
45 endpoint_t *instance = malloc(sizeof(endpoint_t));
46 if (instance) {
47 instance->address = address;
48 instance->endpoint = endpoint;
49 instance->direction = direction;
50 instance->transfer_type = type;
51 instance->speed = speed;
52 instance->max_packet_size = max_packet_size;
53 instance->bandwidth = bw;
54 instance->toggle = 0;
55 instance->active = false;
56 instance->hc_data.data = NULL;
57 instance->hc_data.toggle_get = NULL;
58 instance->hc_data.toggle_set = NULL;
59 link_initialize(&instance->link);
60 fibril_mutex_initialize(&instance->guard);
61 fibril_condvar_initialize(&instance->avail);
62 endpoint_clear_hc_data(instance);
63 }
64 return instance;
65}
66/*----------------------------------------------------------------------------*/
67void endpoint_destroy(endpoint_t *instance)
68{
69 assert(instance);
70 assert(!instance->active);
71 assert(instance->hc_data.data == NULL);
72 free(instance);
73}
74/*----------------------------------------------------------------------------*/
75void endpoint_set_hc_data(endpoint_t *instance,
76 void *data, int (*toggle_get)(void *), void (*toggle_set)(void *, int))
77{
78 assert(instance);
79 instance->hc_data.data = data;
80 instance->hc_data.toggle_get = toggle_get;
81 instance->hc_data.toggle_set = toggle_set;
82}
83/*----------------------------------------------------------------------------*/
84void endpoint_clear_hc_data(endpoint_t *instance)
85{
86 assert(instance);
87 instance->hc_data.data = NULL;
88 instance->hc_data.toggle_get = NULL;
89 instance->hc_data.toggle_set = NULL;
90}
91/*----------------------------------------------------------------------------*/
92void endpoint_use(endpoint_t *instance)
93{
94 assert(instance);
95 fibril_mutex_lock(&instance->guard);
96 while (instance->active)
97 fibril_condvar_wait(&instance->avail, &instance->guard);
98 instance->active = true;
99 fibril_mutex_unlock(&instance->guard);
100}
101/*----------------------------------------------------------------------------*/
102void endpoint_release(endpoint_t *instance)
103{
104 assert(instance);
105 fibril_mutex_lock(&instance->guard);
106 instance->active = false;
107 fibril_mutex_unlock(&instance->guard);
108 fibril_condvar_signal(&instance->avail);
109}
110/*----------------------------------------------------------------------------*/
111int endpoint_toggle_get(endpoint_t *instance)
112{
113 assert(instance);
114 if (instance->hc_data.toggle_get)
115 instance->toggle =
116 instance->hc_data.toggle_get(instance->hc_data.data);
117 return (int)instance->toggle;
118}
119/*----------------------------------------------------------------------------*/
120void endpoint_toggle_set(endpoint_t *instance, int toggle)
121{
122 assert(instance);
123 assert(toggle == 0 || toggle == 1);
124 if (instance->hc_data.toggle_set)
125 instance->hc_data.toggle_set(instance->hc_data.data, toggle);
126 instance->toggle = toggle;
127}
128/**
129 * @}
130 */
Note: See TracBrowser for help on using the repository browser.