sys/bus/usb/usb_port.h

   1 /*
   2  * $OpenBSD: usb_port.h,v 1.18 2000/09/06 22:42:10 rahnds Exp $
   3  * $NetBSD: usb_port.h,v 1.68 2005/07/30 06:14:50 skrll Exp $
   4  * $FreeBSD: src/sys/dev/usb/usb_port.h,v 1.65 2003/11/09 23:54:21 joe Exp $
   5  * $DragonFly: src/sys/bus/usb/usb_port.h,v 1.20 2007/07/03 19:28:16 hasso Exp $
   6  */
   7
   8 /* Also already merged from NetBSD:
   9  *      $NetBSD: usb_port.h,v 1.57 2002/09/27 20:42:01 thorpej Exp $
  10  *      $NetBSD: usb_port.h,v 1.58 2002/10/01 01:25:26 thorpej Exp $
  11  */
  12
  13 /*
  14  * Copyright (c) 1998 The NetBSD Foundation, Inc.
  15  * All rights reserved.
  16  *
  17  * This code is derived from software contributed to The NetBSD Foundation
  18  * by Lennart Augustsson (lennart@augustsson.net) at
  19  * Carlstedt Research & Technology.
  20  *
  21  * Redistribution and use in source and binary forms, with or without
  22  * modification, are permitted provided that the following conditions
  23  * are met:
  24  * 1. Redistributions of source code must retain the above copyright
  25  *    notice, this list of conditions and the following disclaimer.
  26  * 2. Redistributions in binary form must reproduce the above copyright
  27  *    notice, this list of conditions and the following disclaimer in the
  28  *    documentation and/or other materials provided with the distribution.
  29  * 3. All advertising materials mentioning features or use of this software
  30  *    must display the following acknowledgement:
  31  *        This product includes software developed by the NetBSD
  32  *        Foundation, Inc. and its contributors.
  33  * 4. Neither the name of The NetBSD Foundation nor the names of its
  34  *    contributors may be used to endorse or promote products derived
  35  *    from this software without specific prior written permission.
  36  *
  37  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  38  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  39  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  40  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  41  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  42  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  43  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  44  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  45  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  46  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  47  * POSSIBILITY OF SUCH DAMAGE.
  48  */
  49
  50 #ifndef _USB_PORT_H
  51 #define _USB_PORT_H
  52
  53 /*
  54  * Macros to ease the import of USB drivers from other BSD systems. Drivers
  55  * in the DragonFly tree don't use any of these macros.
  56  *
  57  * Driver that wants to use these can simply include <bus/usb/usb_port.h>.
  58  */
  59
  60 #include "opt_usb.h"
  61
  62 #define USBVERBOSE
  63
  64 #define Static static
  65
  66 #define device_ptr_t device_t
  67 #define USBBASEDEVICE device_t
  68 #define USBDEV(bdev) (bdev)
  69 #define USBDEVNAME(bdev) device_get_nameunit(bdev)
  70 #define USBDEVUNIT(bdev) device_get_unit(bdev)
  71 #define USBDEVPTRNAME(bdev) device_get_nameunit(bdev)
  72 #define USBGETSOFTC(bdev) (device_get_softc(bdev))
  73
  74 #define DECLARE_USB_DMA_T \
  75         struct usb_dma_block; \
  76         typedef struct { \
  77                 struct usb_dma_block *block; \
  78                 u_int offs; \
  79                 u_int len; \
  80         } usb_dma_t
  81
  82 #define PROC_LOCK(p)
  83 #define PROC_UNLOCK(p)
  84 #define uio_procp uio_td
  85
  86 #define selwakeuppri(p, pri)    selwakeup(p)
  87
  88 typedef struct thread *usb_proc_ptr;
  89
  90 #define config_pending_incr()
  91 #define config_pending_decr()
  92
  93 #define usb_kthread_create(f, s)                        \
  94                 kthread_create(f, s, NULL, "dummy")
  95 #define usb_kthread_create1(f, s, p, name, arg)         \
  96                 kthread_create(f, s, p, name, arg)
  97 #define usb_kthread_create2(f, s, p, name)              \
  98                 kthread_create(f, s, p, name)
  99
 100 typedef struct callout usb_callout_t;
 101 #define usb_callout_init(h)     callout_init(&(h))
 102 #define usb_callout(h, t, f, d) callout_reset(&(h), (t), (f), (d))
 103 #define usb_uncallout(h, f, d)  callout_stop(&(h))
 104
 105 #define clalloc(p, s, x) (clist_alloc_cblocks((p), (s), (s)), 0)
 106 #define clfree(p) clist_free_cblocks((p))
 107
 108 #define config_detach(dev, flag) device_delete_child(device_get_parent(dev), dev)
 109
 110 typedef struct malloc_type *usb_malloc_type;
 111
 112 #define USB_DECLARE_DRIVER_INIT(dname, init...) \
 113 Static device_probe_t __CONCAT(dname,_match); \
 114 Static device_attach_t __CONCAT(dname,_attach); \
 115 Static device_detach_t __CONCAT(dname,_detach); \
 116 \
 117 Static devclass_t __CONCAT(dname,_devclass); \
 118 \
 119 Static device_method_t __CONCAT(dname,_methods)[] = { \
 120         DEVMETHOD(device_probe, __CONCAT(dname,_match)), \
 121         DEVMETHOD(device_attach, __CONCAT(dname,_attach)), \
 122         DEVMETHOD(device_detach, __CONCAT(dname,_detach)), \
 123         init, \
 124         {0,0} \
 125 }; \
 126 \
 127 Static driver_t __CONCAT(dname,_driver) = { \
 128         #dname, \
 129         __CONCAT(dname,_methods), \
 130         sizeof(struct __CONCAT(dname,_softc)) \
 131 }; \
 132 MODULE_DEPEND(dname, usb, 1, 1, 1)
 133
 134
 135 #define METHODS_NONE                    {0,0}
 136 #define USB_DECLARE_DRIVER(dname)       USB_DECLARE_DRIVER_INIT(dname, METHODS_NONE)
 137
 138 #define USB_MATCH(dname) \
 139 Static int \
 140 __CONCAT(dname,_match)(device_t self)
 141
 142 #define USB_MATCH_START(dname, uaa) \
 143         struct usb_attach_arg *uaa = device_get_ivars(self)
 144
 145 #define USB_MATCH_SETUP \
 146         sc->sc_dev = self
 147
 148 #define USB_ATTACH(dname) \
 149 Static int \
 150 __CONCAT(dname,_attach)(device_t self)
 151
 152 #define USB_ATTACH_START(dname, sc, uaa) \
 153         struct __CONCAT(dname,_softc) *sc = device_get_softc(self); \
 154         struct usb_attach_arg *uaa = device_get_ivars(self)
 155
 156 /* Returns from attach */
 157 #define USB_ATTACH_ERROR_RETURN         return ENXIO
 158 #define USB_ATTACH_SUCCESS_RETURN       return 0
 159
 160 #define USB_ATTACH_SETUP \
 161         sc->sc_dev = self; \
 162         device_set_desc_copy(self, devinfo)
 163
 164 #define USB_DETACH(dname) \
 165 Static int \
 166 __CONCAT(dname,_detach)(device_t self)
 167
 168 #define USB_DETACH_START(dname, sc) \
 169         struct __CONCAT(dname,_softc) *sc = device_get_softc(self)
 170
 171 #define USB_GET_SC_OPEN(dname, unit, sc) \
 172         sc = devclass_get_softc(__CONCAT(dname,_devclass), unit); \
 173         if (sc == NULL) \
 174                 return (ENXIO)
 175
 176 #define USB_GET_SC(dname, unit, sc) \
 177         sc = devclass_get_softc(__CONCAT(dname,_devclass), unit)
 178
 179 #define USB_DO_ATTACH(dev, bdev, parent, args, print, sub) \
 180         (device_probe_and_attach((bdev)) == 0 ? (bdev) : 0)
 181
 182 /* conversion from one type of queue to the other */
 183 #define SIMPLEQ_REMOVE_HEAD     STAILQ_REMOVE_HEAD
 184 #define SIMPLEQ_INSERT_HEAD     STAILQ_INSERT_HEAD
 185 #define SIMPLEQ_INSERT_TAIL     STAILQ_INSERT_TAIL
 186 #define SIMPLEQ_NEXT            STAILQ_NEXT
 187 #define SIMPLEQ_FIRST           STAILQ_FIRST
 188 #define SIMPLEQ_HEAD            STAILQ_HEAD
 189 #define SIMPLEQ_EMPTY           STAILQ_EMPTY
 190 #define SIMPLEQ_FOREACH         STAILQ_FOREACH
 191 #define SIMPLEQ_INIT            STAILQ_INIT
 192 #define SIMPLEQ_HEAD_INITIALIZER        STAILQ_HEAD_INITIALIZER
 193 #define SIMPLEQ_ENTRY           STAILQ_ENTRY
 194
 195 #define logprintf               kprintf
 196
 197 #endif /* _USB_PORT_H */
 198