device_keeper.h

Go to the documentation of this file.
00001 /*
00002  * Copyright (c) 2011 Jan Vesely
00003  * All rights reserved.
00004  *
00005  * Redistribution and use in source and binary forms, with or without
00006  * modification, are permitted provided that the following conditions
00007  * are met:
00008  *
00009  * - Redistributions of source code must retain the above copyright
00010  *   notice, this list of conditions and the following disclaimer.
00011  * - Redistributions in binary form must reproduce the above copyright
00012  *   notice, this list of conditions and the following disclaimer in the
00013  *   documentation and/or other materials provided with the distribution.
00014  * - The name of the author may not be used to endorse or promote products
00015  *   derived from this software without specific prior written permission.
00016  *
00017  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
00018  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
00019  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
00020  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
00021  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
00022  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
00023  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
00024  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
00025  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
00026  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00027  */
00028 
00040 #ifndef LIBUSBHOST_HOST_DEVICE_KEEPER_H
00041 #define LIBUSBHOST_HOST_DEVICE_KEEPER_H
00042 
00043 #include <adt/list.h>
00044 #include <devman.h>
00045 #include <fibril_synch.h>
00046 #include <usb/usb.h>
00047 #include <usb/host/endpoint.h>
00048 
00050 #define USB_ADDRESS_COUNT (USB11_ADDRESS_MAX + 1)
00051 
00053 struct usb_device_info {
00054         usb_speed_t speed;
00055         bool occupied;
00056         devman_handle_t handle;
00057 };
00058 
00062 typedef struct {
00063         struct usb_device_info devices[USB_ADDRESS_COUNT];
00064         fibril_mutex_t guard;
00065         usb_address_t last_address;
00066 } usb_device_keeper_t;
00067 
00068 void usb_device_keeper_init(usb_device_keeper_t *instance);
00069 
00070 usb_address_t device_keeper_get_free_address(usb_device_keeper_t *instance,
00071     usb_speed_t speed);
00072 
00073 void usb_device_keeper_bind(usb_device_keeper_t *instance,
00074     usb_address_t address, devman_handle_t handle);
00075 
00076 void usb_device_keeper_release(usb_device_keeper_t *instance,
00077     usb_address_t address);
00078 
00079 usb_address_t usb_device_keeper_find(usb_device_keeper_t *instance,
00080     devman_handle_t handle);
00081 
00082 bool usb_device_keeper_find_by_address(usb_device_keeper_t *instance,
00083     usb_address_t address, devman_handle_t *handle);
00084 
00085 usb_speed_t usb_device_keeper_get_speed(usb_device_keeper_t *instance,
00086     usb_address_t address);
00087 #endif
00088 

Generated on Thu Jun 2 07:45:48 2011 for HelenOS/USB by  doxygen 1.4.7