2002-05-09 21:55:47 +00:00
|
|
|
/* $OpenBSD: usb_port.h,v 1.18 2000/09/06 22:42:10 rahnds Exp $ */
|
2007-06-21 14:36:22 +00:00
|
|
|
/* $NetBSD: usb_port.h,v 1.54 2002/03/28 21:49:19 ichiro Exp $ */
|
2002-05-09 21:55:47 +00:00
|
|
|
/* $FreeBSD$ */
|
2003-07-04 01:50:39 +00:00
|
|
|
|
2003-07-14 18:33:55 +00:00
|
|
|
/* Also already merged from NetBSD:
|
|
|
|
* $NetBSD: usb_port.h,v 1.57 2002/09/27 20:42:01 thorpej Exp $
|
|
|
|
* $NetBSD: usb_port.h,v 1.58 2002/10/01 01:25:26 thorpej Exp $
|
|
|
|
*/
|
|
|
|
|
2005-01-06 01:43:34 +00:00
|
|
|
/*-
|
1999-01-07 23:07:57 +00:00
|
|
|
* Copyright (c) 1998 The NetBSD Foundation, Inc.
|
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* This code is derived from software contributed to The NetBSD Foundation
|
2000-05-14 16:43:10 +00:00
|
|
|
* by Lennart Augustsson (lennart@augustsson.net) at
|
1999-01-07 23:07:57 +00:00
|
|
|
* Carlstedt Research & Technology.
|
1998-12-14 09:13:29 +00:00
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions
|
|
|
|
* are met:
|
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer.
|
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
|
|
* documentation and/or other materials provided with the distribution.
|
|
|
|
* 3. All advertising materials mentioning features or use of this software
|
|
|
|
* must display the following acknowledgement:
|
1999-01-07 23:07:57 +00:00
|
|
|
* This product includes software developed by the NetBSD
|
|
|
|
* Foundation, Inc. and its contributors.
|
|
|
|
* 4. Neither the name of The NetBSD Foundation nor the names of its
|
|
|
|
* contributors may be used to endorse or promote products derived
|
|
|
|
* from this software without specific prior written permission.
|
1998-12-14 09:13:29 +00:00
|
|
|
*
|
1999-01-07 23:07:57 +00:00
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
|
|
|
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
|
|
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
1998-12-14 09:13:29 +00:00
|
|
|
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
1999-01-07 23:07:57 +00:00
|
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
1998-12-14 09:13:29 +00:00
|
|
|
*/
|
|
|
|
|
2002-01-02 16:33:53 +00:00
|
|
|
#ifndef _USB_PORT_H
|
|
|
|
#define _USB_PORT_H
|
1999-01-10 18:42:54 +00:00
|
|
|
|
2003-07-04 01:50:39 +00:00
|
|
|
/*
|
1999-01-10 18:42:54 +00:00
|
|
|
* Macro's to cope with the differences between operating systems.
|
1998-11-26 23:13:13 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
/*
|
1999-01-07 23:07:57 +00:00
|
|
|
* FreeBSD
|
1998-11-26 23:13:13 +00:00
|
|
|
*/
|
|
|
|
|
2002-09-30 19:12:43 +00:00
|
|
|
/* We don't use the soft interrupt code in FreeBSD. */
|
2002-09-30 17:50:18 +00:00
|
|
|
#if 0
|
2002-05-09 12:49:25 +00:00
|
|
|
#define USB_USE_SOFTINTR
|
2002-09-30 17:50:18 +00:00
|
|
|
#endif
|
2002-05-09 12:49:25 +00:00
|
|
|
|
2007-06-21 14:36:22 +00:00
|
|
|
#define Static static
|
|
|
|
|
|
|
|
#define device_ptr_t device_t
|
|
|
|
#define USBBASEDEVICE device_t
|
|
|
|
#define USBDEV(bdev) (bdev)
|
|
|
|
#define USBDEVNAME(bdev) device_get_nameunit(bdev)
|
|
|
|
#define USBDEVPTRNAME(bdev) device_get_nameunit(bdev)
|
|
|
|
#define USBDEVUNIT(bdev) device_get_unit(bdev)
|
2002-04-06 20:50:21 +00:00
|
|
|
#define USBGETSOFTC(bdev) (device_get_softc(bdev))
|
1999-10-07 19:26:38 +00:00
|
|
|
|
2007-06-21 14:36:22 +00:00
|
|
|
#define DECLARE_USB_DMA_T \
|
|
|
|
struct usb_dma_block; \
|
|
|
|
typedef struct { \
|
|
|
|
struct usb_dma_block *block; \
|
|
|
|
u_int offs; \
|
|
|
|
u_int len; \
|
|
|
|
} usb_dma_t
|
|
|
|
|
|
|
|
typedef struct thread *usb_proc_ptr;
|
|
|
|
|
|
|
|
#define uio_procp uio_td
|
|
|
|
|
|
|
|
#define usb_kthread_create1(f, s, p, a0, a1) \
|
|
|
|
kthread_create((f), (s), (p), RFHIGHPID, 0, (a0), (a1))
|
|
|
|
#define usb_kthread_create2(f, s, p, a0) \
|
|
|
|
kthread_create((f), (s), (p), RFHIGHPID, 0, (a0))
|
|
|
|
#define usb_kthread_create kthread_create
|
|
|
|
|
2002-01-24 20:21:17 +00:00
|
|
|
#define config_pending_incr()
|
|
|
|
#define config_pending_decr()
|
|
|
|
|
Huge merge from NetBSD:
usbdi.c (1.61):
===================================================================
revision 1.61
date: 2000/01/31 20:13:07; author: augustss; lines: +20 -4
Change the way the HC done method is invoked a little.
===================================================================
usbdi.c (1.65):
===================================================================
revision 1.65
date: 2000/03/08 15:34:10; author: augustss; lines: +4 -2
Get the status right when a polled transfer times out.
===================================================================
ohci.c (1.79), uhci.c (1.89), uhcivar.h (1.24), usb_port.h (1.22),
usbdivar.h (1.48):
===================================================================
date: 2000/03/23 07:01:46; author: thorpej;
New callout mechanism with two major improvements over the old
timeout()/untimeout() API:
- Clients supply callout handle storage, thus eliminating problems of
resource allocation.
- Insertion and removal of callouts is constant time, important as
this facility is used quite a lot in the kernel.
The old timeout()/untimeout() API has been removed from the kernel.
===================================================================
uhci.c (1.80), usbdi.c (1.66):
===================================================================
date: 2000/03/23 18:59:10; author: thorpej;
Shake out some bugs from the callout changes.
===================================================================
ohci.c (1.80), uhci.c (1.91), uhcivar.h (1.25), usb_port.h (1.23),
usbdi.c (1.67), usbdivar.h (1.49):
===================================================================
date: 2000/03/24 22:03:30; author: augustss;
Some cleanup and renaming of the callouts used in USB drivers.
===================================================================
uhci.c (1.92), uhcivar.h (1.26):
===================================================================
date: 2000/03/24 22:57:58; author: augustss;
Two major changes:
Make each xfer have its own intr_info. This is necessary if we want
to queue multiple xfers on an endpoint. This should get rid of the
(mostly harmless) DIAGNOSTICs about intr_infos (not) being done.
Change (again!) how xfers are aborted. Aborting a TD is a nightmare
on the braindead UHCI controller. (Unless you stop the HC, thereby
losing isoc traffic.) Hopefully I got it right this time.
===================================================================
usbdivar.h (1.50):
===================================================================
revision 1.50
date: 2000/03/25 00:10:19; author: augustss; lines: +4 -2
GC an unsued field and add some DIAGNOSTIC in xfer.
===================================================================
ums.c: Use the callout functions instead of the timeout ones.
uhci.c (1.93):
===================================================================
revision 1.93
date: 2000/03/25 00:11:21; author: augustss;
lines: +26 -1
Add more DIAGNOSTIC when aborting isoc.
===================================================================
uhci.c (1.94), usbdivar.h (1.51):
===================================================================
date: 2000/03/25 07:13:05; author: augustss;
More DIAGNOSTIC.
Initialize a callout handle I forgot.
===================================================================
uhci.c (1.95):
===================================================================
revision 1.95
date: 2000/03/25 07:23:12; author: augustss;
Exp; lines: +24 -7
Improve uhci_dump_ii().
===================================================================
ohci.c (1.81), uhci.c (1.96), uhcivar.h (1.27), usb_subr.c (1.68),
usbdi.c (1.68), usbdivar.h (1.52):
===================================================================
date: 2000/03/25 18:02:33; author: augustss;
Rename and move around callout handles to make it more sane.
Add some DIAGNOSTIC.
Fix buglet in isoc abort on UHCI.
===================================================================
uhci.c (1.98):
===================================================================
revision 1.98
date: 2000/03/27 07:39:48; author: augustss; lines: +12 -4
Make it compile without DIAGNOSTIC.
===================================================================
uhci.c (1.99):
===================================================================
revision 1.99
date: 2000/03/27 08:01:09; author: augustss; lines: +1 -5
Remove some debug nonsense.
===================================================================
uhci.c (1.100):
===================================================================
revision 1.100
date: 2000/03/27 09:41:36; author: augustss; lines: +13 -3
Don't mess with QH in bulk abort for the moment.
===================================================================
uhci.c (1.102):
===================================================================
revision 1.102
date: 2000/03/27 22:42:57; author: augustss; lines: +66 -26
Be a little more careful when aborting.
Preallocate some TDs for large buffers.
===================================================================
uhci.c (1.103):
===================================================================
date: 2000/03/28 09:47:10; author: augustss; lines: +11 -1
Another patch for xfer abort...
XXX The current xfer queueing and aborting semantics should really
XXX be changed. It cannot be implemented in a sane way on UHCI.
XXX One day when I have lots of time I'll redesign it...
===================================================================
uhci.c (1.104): Correct a debug message.
uhci.c (1.105): Be more defensive in a DIAGNOSTIC test.
uhci.c (1.106):
===================================================================
revision 1.106
date: 2000/03/29 01:49:13; author: augustss; lines: +14 -309
*SIGH* Revert back to the old method of aborting xfers.
I had tested the new stuff for two months now, but as soon as I commited
it the problems started to appear. Murphy, no doubt...
===================================================================
usb_subr.c (1.70), usbdi.c (1.71), usbdivar.h (1.53):
===================================================================
revision 1.70
date: 2000/03/29 01:45:20; author: augustss; lines: +2 -1
Do not accept new xfers for queuing while a pipe is aborting.
===================================================================
2002-03-16 12:06:01 +00:00
|
|
|
typedef struct callout usb_callout_t;
|
|
|
|
#define usb_callout_init(h) callout_init(&(h), 0)
|
|
|
|
#define usb_callout(h, t, f, d) callout_reset(&(h), (t), (f), (d))
|
|
|
|
#define usb_uncallout(h, f, d) callout_stop(&(h))
|
2004-11-12 03:24:12 +00:00
|
|
|
#define usb_uncallout_drain(h, f, d) callout_drain(&(h))
|
1999-01-07 23:07:57 +00:00
|
|
|
|
2007-06-21 14:36:22 +00:00
|
|
|
#define clalloc(p, s, x) (clist_alloc_cblocks((p), (s), (s)), 0)
|
|
|
|
#define clfree(p) clist_free_cblocks((p))
|
|
|
|
|
|
|
|
#define config_detach(dev, flag) \
|
|
|
|
do { \
|
|
|
|
device_detach(dev); \
|
|
|
|
free(device_get_ivars(dev), M_USB); \
|
|
|
|
device_delete_child(device_get_parent(dev), dev); \
|
|
|
|
} while (0);
|
|
|
|
|
|
|
|
typedef struct malloc_type *usb_malloc_type;
|
|
|
|
|
2000-08-04 19:05:49 +00:00
|
|
|
#define USB_DECLARE_DRIVER_INIT(dname, init...) \
|
2006-09-06 23:44:25 +00:00
|
|
|
static device_probe_t __CONCAT(dname,_match); \
|
|
|
|
static device_attach_t __CONCAT(dname,_attach); \
|
|
|
|
static device_detach_t __CONCAT(dname,_detach); \
|
1999-01-07 23:07:57 +00:00
|
|
|
\
|
2006-09-06 23:44:25 +00:00
|
|
|
static devclass_t __CONCAT(dname,_devclass); \
|
1999-01-07 23:07:57 +00:00
|
|
|
\
|
2006-09-06 23:44:25 +00:00
|
|
|
static device_method_t __CONCAT(dname,_methods)[] = { \
|
1999-01-07 23:07:57 +00:00
|
|
|
DEVMETHOD(device_probe, __CONCAT(dname,_match)), \
|
|
|
|
DEVMETHOD(device_attach, __CONCAT(dname,_attach)), \
|
|
|
|
DEVMETHOD(device_detach, __CONCAT(dname,_detach)), \
|
|
|
|
init, \
|
|
|
|
{0,0} \
|
|
|
|
}; \
|
|
|
|
\
|
2006-09-06 23:44:25 +00:00
|
|
|
static driver_t __CONCAT(dname,_driver) = { \
|
1999-11-08 21:12:25 +00:00
|
|
|
#dname, \
|
1999-01-07 23:07:57 +00:00
|
|
|
__CONCAT(dname,_methods), \
|
|
|
|
sizeof(struct __CONCAT(dname,_softc)) \
|
2000-08-04 19:05:49 +00:00
|
|
|
}; \
|
|
|
|
MODULE_DEPEND(dname, usb, 1, 1, 1)
|
2000-06-15 13:51:30 +00:00
|
|
|
|
2000-05-08 15:10:05 +00:00
|
|
|
|
2007-06-21 14:36:22 +00:00
|
|
|
#define METHODS_NONE {0,0}
|
|
|
|
#define USB_DECLARE_DRIVER(dname) USB_DECLARE_DRIVER_INIT(dname, METHODS_NONE)
|
1999-01-07 23:07:57 +00:00
|
|
|
|
|
|
|
#define USB_MATCH(dname) \
|
2006-09-06 23:44:25 +00:00
|
|
|
static int \
|
1999-06-26 12:55:25 +00:00
|
|
|
__CONCAT(dname,_match)(device_t self)
|
1999-01-07 23:07:57 +00:00
|
|
|
|
|
|
|
#define USB_MATCH_START(dname, uaa) \
|
1999-06-26 12:55:25 +00:00
|
|
|
struct usb_attach_arg *uaa = device_get_ivars(self)
|
1999-01-07 23:07:57 +00:00
|
|
|
|
2007-06-21 14:36:22 +00:00
|
|
|
#define USB_MATCH_SETUP \
|
|
|
|
sc->sc_dev = self
|
|
|
|
|
1999-01-07 23:07:57 +00:00
|
|
|
#define USB_ATTACH(dname) \
|
2006-09-06 23:44:25 +00:00
|
|
|
static int \
|
1999-01-07 23:07:57 +00:00
|
|
|
__CONCAT(dname,_attach)(device_t self)
|
|
|
|
|
|
|
|
#define USB_ATTACH_START(dname, sc, uaa) \
|
|
|
|
struct __CONCAT(dname,_softc) *sc = device_get_softc(self); \
|
|
|
|
struct usb_attach_arg *uaa = device_get_ivars(self)
|
|
|
|
|
2007-06-21 14:36:22 +00:00
|
|
|
/* Returns from attach */
|
|
|
|
#define USB_ATTACH_ERROR_RETURN return ENXIO
|
|
|
|
#define USB_ATTACH_SUCCESS_RETURN return 0
|
|
|
|
|
|
|
|
#define USB_ATTACH_SETUP \
|
2007-07-06 20:02:37 +00:00
|
|
|
sc->sc_dev = self; \
|
2007-06-21 14:36:22 +00:00
|
|
|
|
1999-10-07 19:26:38 +00:00
|
|
|
#define USB_DETACH(dname) \
|
2006-09-06 23:44:25 +00:00
|
|
|
static int \
|
1999-10-07 19:26:38 +00:00
|
|
|
__CONCAT(dname,_detach)(device_t self)
|
|
|
|
|
|
|
|
#define USB_DETACH_START(dname, sc) \
|
|
|
|
struct __CONCAT(dname,_softc) *sc = device_get_softc(self)
|
|
|
|
|
1999-01-07 23:07:57 +00:00
|
|
|
#define USB_GET_SC_OPEN(dname, unit, sc) \
|
1999-11-17 22:33:51 +00:00
|
|
|
sc = devclass_get_softc(__CONCAT(dname,_devclass), unit); \
|
2002-04-06 22:06:16 +00:00
|
|
|
if (sc == NULL) \
|
1999-01-07 23:07:57 +00:00
|
|
|
return (ENXIO)
|
|
|
|
|
|
|
|
#define USB_GET_SC(dname, unit, sc) \
|
1999-11-17 22:33:51 +00:00
|
|
|
sc = devclass_get_softc(__CONCAT(dname,_devclass), unit)
|
1999-01-07 23:07:57 +00:00
|
|
|
|
2007-06-21 14:36:22 +00:00
|
|
|
#define USB_DO_ATTACH(dev, bdev, parent, args, print, sub) \
|
|
|
|
(device_probe_and_attach((bdev)) == 0 ? (bdev) : 0)
|
|
|
|
|
|
|
|
/* conversion from one type of queue to the other */
|
|
|
|
#define SIMPLEQ_REMOVE_HEAD STAILQ_REMOVE_HEAD
|
|
|
|
#define SIMPLEQ_INSERT_HEAD STAILQ_INSERT_HEAD
|
|
|
|
#define SIMPLEQ_INSERT_TAIL STAILQ_INSERT_TAIL
|
|
|
|
#define SIMPLEQ_NEXT STAILQ_NEXT
|
|
|
|
#define SIMPLEQ_FIRST STAILQ_FIRST
|
|
|
|
#define SIMPLEQ_HEAD STAILQ_HEAD
|
|
|
|
#define SIMPLEQ_EMPTY STAILQ_EMPTY
|
|
|
|
#define SIMPLEQ_FOREACH STAILQ_FOREACH
|
|
|
|
#define SIMPLEQ_INIT STAILQ_INIT
|
|
|
|
#define SIMPLEQ_HEAD_INITIALIZER STAILQ_HEAD_INITIALIZER
|
|
|
|
#define SIMPLEQ_ENTRY STAILQ_ENTRY
|
|
|
|
|
1999-04-07 17:07:07 +00:00
|
|
|
#include <sys/syslog.h>
|
1999-10-07 19:26:38 +00:00
|
|
|
/*
|
2007-06-21 14:36:22 +00:00
|
|
|
#define logprintf(args...) log(LOG_DEBUG, args)
|
1999-10-07 19:26:38 +00:00
|
|
|
*/
|
2007-06-21 14:36:22 +00:00
|
|
|
#define logprintf printf
|
1999-04-07 17:07:07 +00:00
|
|
|
|
2002-01-02 16:33:53 +00:00
|
|
|
#endif /* _USB_PORT_H */
|