1 /* $FreeBSD: head/lib/libusb/libusb10.h 248236 2013-03-13 12:23:14Z hselasky $ */ 2 /*- 3 * Copyright (c) 2009 Sylvestre Gallon. 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 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24 * SUCH DAMAGE. 25 */ 26 27 #ifndef __LIBUSB10_H__ 28 #define __LIBUSB10_H__ 29 30 #ifndef LIBUSB_GLOBAL_INCLUDE_FILE 31 #include <sys/queue.h> 32 #endif 33 34 #define GET_CONTEXT(ctx) (((ctx) == NULL) ? usbi_default_context : (ctx)) 35 #define UNEXPORTED __attribute__((__visibility__("hidden"))) 36 #define CTX_LOCK(ctx) pthread_mutex_lock(&(ctx)->ctx_lock) 37 #define CTX_TRYLOCK(ctx) pthread_mutex_trylock(&(ctx)->ctx_lock) 38 #define CTX_UNLOCK(ctx) pthread_mutex_unlock(&(ctx)->ctx_lock) 39 #define HOTPLUG_LOCK(ctx) pthread_mutex_lock(&(ctx)->hotplug_lock) 40 #define HOTPLUG_UNLOCK(ctx) pthread_mutex_unlock(&(ctx)->hotplug_lock) 41 42 #define DPRINTF(ctx, dbg, format, args...) do { \ 43 if ((ctx)->debug == dbg) { \ 44 switch (dbg) { \ 45 case LIBUSB_DEBUG_FUNCTION: \ 46 printf("LIBUSB_FUNCTION: " \ 47 format "\n", ## args); \ 48 break; \ 49 case LIBUSB_DEBUG_TRANSFER: \ 50 printf("LIBUSB_TRANSFER: " \ 51 format "\n", ## args); \ 52 break; \ 53 default: \ 54 break; \ 55 } \ 56 } \ 57 } while(0) 58 59 /* internal structures */ 60 61 struct libusb_super_pollfd { 62 TAILQ_ENTRY(libusb_super_pollfd) entry; 63 struct libusb20_device *pdev; 64 struct libusb_pollfd pollfd; 65 }; 66 67 struct libusb_super_transfer { 68 TAILQ_ENTRY(libusb_super_transfer) entry; 69 uint8_t *curr_data; 70 uint32_t rem_len; 71 uint32_t last_len; 72 uint8_t state; 73 #define LIBUSB_SUPER_XFER_ST_NONE 0 74 #define LIBUSB_SUPER_XFER_ST_PEND 1 75 }; 76 77 struct libusb_hotplug_callback_handle_struct { 78 TAILQ_ENTRY(libusb_hotplug_callback_handle_struct) entry; 79 int events; 80 int vendor; 81 int product; 82 int devclass; 83 libusb_hotplug_callback_fn fn; 84 void *user_data; 85 }; 86 87 struct libusb_context { 88 int debug; 89 int debug_fixed; 90 int ctrl_pipe[2]; 91 int tr_done_ref; 92 int tr_done_gen; 93 94 pthread_mutex_t ctx_lock; 95 pthread_mutex_t hotplug_lock; 96 pthread_cond_t ctx_cond; 97 pthread_t hotplug_handler; 98 pthread_t ctx_handler; 99 #define NO_THREAD ((pthread_t)-1) 100 101 TAILQ_HEAD(, libusb_super_pollfd) pollfds; 102 TAILQ_HEAD(, libusb_super_transfer) tr_done; 103 TAILQ_HEAD(, libusb_hotplug_callback_handle_struct) hotplug_cbh; 104 TAILQ_HEAD(, libusb_device) hotplug_devs; 105 106 struct libusb_super_pollfd ctx_poll; 107 108 libusb_pollfd_added_cb fd_added_cb; 109 libusb_pollfd_removed_cb fd_removed_cb; 110 void *fd_cb_user_data; 111 }; 112 113 struct libusb_device { 114 int refcnt; 115 116 uint32_t claimed_interfaces; 117 118 struct libusb_super_pollfd dev_poll; 119 120 struct libusb_context *ctx; 121 122 TAILQ_ENTRY(libusb_device) hotplug_entry; 123 124 TAILQ_HEAD(, libusb_super_transfer) tr_head; 125 126 struct libusb20_device *os_priv; 127 }; 128 129 extern struct libusb_context *usbi_default_context; 130 131 void libusb10_add_pollfd(libusb_context *ctx, struct libusb_super_pollfd *pollfd, struct libusb20_device *pdev, int fd, short events); 132 void libusb10_remove_pollfd(libusb_context *ctx, struct libusb_super_pollfd *pollfd); 133 void libusb10_cancel_all_transfer(libusb_device *dev); 134 135 #endif /* __LIBUSB10_H__ */ 136