source: mainline/uspace/drv/vhc/vhcd.h@ b08ef1fd

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since b08ef1fd was 79ae36dd, checked in by Martin Decky <martin@…>, 14 years ago

new async framework with integrated exchange tracking

  • strict isolation between low-level IPC and high-level async framework with integrated exchange tracking
    • each IPC connection is represented by an async_sess_t structure
    • each IPC exchange is represented by an async_exch_t structure
    • exchange management is either based on atomic messages (EXCHANGE_ATOMIC), locking (EXCHANGE_SERIALIZE) or connection cloning (EXCHANGE_CLONE)
  • async_obsolete: temporary compatibility layer to keep old async clients working (several pieces of code are currently broken, but only non-essential functionality)
  • IPC_M_PHONE_HANGUP is now method no. 0 (for elegant boolean evaluation)
  • IPC_M_DEBUG_ALL has been renamed to IPC_M_DEBUG
  • IPC_M_PING has been removed (VFS protocol now has VFS_IN_PING)
  • console routines in libc have been rewritten for better abstraction
  • additional use for libc-private header files (FILE structure opaque to the client)
  • various cstyle changes (typos, indentation, missing externs in header files, improved comments, etc.)
  • Property mode set to 100644
File size: 3.1 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 drvusbvhc
30 * @{
31 */
32/** @file
33 * @brief Virtual USB host controller common definitions.
34 */
35#ifndef VHCD_VHCD_H_
36#define VHCD_VHCD_H_
37
38#include <usb/debug.h>
39#include <usbvirt/device.h>
40#include <usb/host/usb_endpoint_manager.h>
41#include <usb/host/device_keeper.h>
42#include <usbhc_iface.h>
43#include <async.h>
44
45#define NAME "vhc"
46
47typedef struct {
48 link_t link;
49 async_sess_t *dev_sess;
50 usbvirt_device_t *dev_local;
51 bool plugged;
52 usb_address_t address;
53 fibril_mutex_t guard;
54 link_t transfer_queue;
55} vhc_virtdev_t;
56
57typedef struct {
58 uint32_t magic;
59 link_t devices;
60 fibril_mutex_t guard;
61 usb_endpoint_manager_t ep_manager;
62 usb_device_keeper_t dev_keeper;
63 usbvirt_device_t *hub;
64 ddf_fun_t *hc_fun;
65} vhc_data_t;
66
67typedef struct {
68 link_t link;
69 usb_address_t address;
70 usb_endpoint_t endpoint;
71 usb_direction_t direction;
72 usb_transfer_type_t transfer_type;
73 void *setup_buffer;
74 size_t setup_buffer_size;
75 void *data_buffer;
76 size_t data_buffer_size;
77 ddf_fun_t *ddf_fun;
78 void *callback_arg;
79 usbhc_iface_transfer_in_callback_t callback_in;
80 usbhc_iface_transfer_out_callback_t callback_out;
81} vhc_transfer_t;
82
83vhc_transfer_t *vhc_transfer_create(usb_address_t, usb_endpoint_t,
84 usb_direction_t, usb_transfer_type_t, ddf_fun_t *, void *);
85int vhc_virtdev_plug(vhc_data_t *, async_sess_t *, uintptr_t *);
86int vhc_virtdev_plug_local(vhc_data_t *, usbvirt_device_t *, uintptr_t *);
87int vhc_virtdev_plug_hub(vhc_data_t *, usbvirt_device_t *, uintptr_t *);
88void vhc_virtdev_unplug(vhc_data_t *, uintptr_t);
89int vhc_virtdev_add_transfer(vhc_data_t *, vhc_transfer_t *);
90
91int vhc_transfer_queue_processor(void *arg);
92
93
94#endif
95/**
96 * @}
97 */
Note: See TracBrowser for help on using the repository browser.