source: mainline/uspace/lib/drv/include/usb_iface.h@ c280d7e

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

libdrv: usb iface callbacks joined

In addition to handle and current interface, it is good for the device
to know its address and speed. Also, it is expected to add some other
fields (stats, info tied to devices of specific speed and so on) in the
future. Instead of adding yet another call, join those two and let HC
fill a description structure.

  • Property mode set to 100644
File size: 2.2 KB
Line 
1/*
2 * Copyright (c) 2010 Vojtech Horky
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 libdrv
30 * @addtogroup usb
31 * @{
32 */
33/** @file
34 * @brief USB device interface definition.
35 */
36
37#ifndef LIBDRV_USB_IFACE_H_
38#define LIBDRV_USB_IFACE_H_
39
40#include "ddf/driver.h"
41#include <async.h>
42#include <usbhc_iface.h>
43
44typedef async_sess_t usb_dev_session_t;
45
46typedef struct {
47 usb_address_t address;
48 usb_speed_t speed;
49 devman_handle_t handle;
50 int iface;
51} usb_device_desc_t;
52
53extern usb_dev_session_t *usb_dev_connect(devman_handle_t);
54extern usb_dev_session_t *usb_dev_connect_to_self(ddf_dev_t *);
55extern void usb_dev_disconnect(usb_dev_session_t *);
56
57extern int usb_get_my_description(async_exch_t *, usb_device_desc_t *);
58
59/** USB device communication interface. */
60typedef struct {
61 int (*get_my_description)(ddf_fun_t *, usb_device_desc_t *);
62} usb_iface_t;
63
64#endif
65/**
66 * @}
67 */
Note: See TracBrowser for help on using the repository browser.