2aadcb5f47
the device driver instead of happening automagically in the HC driver. This affects both the HC-USBD interface as well as the USBD-device interface. This change will allow DMA buffers to be reused e.g. in isochronous traffic. Add isochronous support to the UHCI driver (not for OHCI yet).
267 lines
8.5 KiB
C
267 lines
8.5 KiB
C
/* $NetBSD: usbdivar.h,v 1.29 1999/09/09 12:26:48 augustss Exp $ */
|
|
|
|
/*
|
|
* Copyright (c) 1998 The NetBSD Foundation, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This code is derived from software contributed to The NetBSD Foundation
|
|
* by Lennart Augustsson (augustss@carlstedt.se) at
|
|
* Carlstedt Research & Technology.
|
|
*
|
|
* 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:
|
|
* 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.
|
|
*
|
|
* 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
|
|
* 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)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
/* From usb_mem.h */
|
|
#if defined(__NetBSD__) || defined(__OpenBSD__)
|
|
struct usb_dma_block;
|
|
typedef struct {
|
|
struct usb_dma_block *block;
|
|
u_int offs;
|
|
} usb_dma_t;
|
|
#elif defined(__FreeBSD__)
|
|
typedef void * usb_dma_t;
|
|
#endif
|
|
|
|
struct usbd_request;
|
|
struct usbd_pipe;
|
|
|
|
struct usbd_endpoint {
|
|
usb_endpoint_descriptor_t *edesc;
|
|
int refcnt;
|
|
};
|
|
|
|
struct usbd_bus_methods {
|
|
usbd_status (*open_pipe)__P((struct usbd_pipe *pipe));
|
|
void (*do_poll)__P((struct usbd_bus *));
|
|
usbd_status (*allocm)__P((struct usbd_bus *, usb_dma_t *,
|
|
u_int32_t bufsize));
|
|
void (*freem)__P((struct usbd_bus *, usb_dma_t *));
|
|
};
|
|
|
|
struct usbd_pipe_methods {
|
|
usbd_status (*transfer)__P((usbd_request_handle reqh));
|
|
usbd_status (*start)__P((usbd_request_handle reqh));
|
|
void (*abort)__P((usbd_request_handle reqh));
|
|
void (*close)__P((usbd_pipe_handle pipe));
|
|
void (*cleartoggle)__P((usbd_pipe_handle pipe));
|
|
void (*done)__P((usbd_request_handle reqh));
|
|
};
|
|
|
|
struct usbd_port {
|
|
usb_port_status_t status;
|
|
u_int16_t power; /* mA of current on port */
|
|
u_int8_t portno;
|
|
u_int8_t restartcnt;
|
|
#define USBD_RESTART_MAX 5
|
|
struct usbd_device *device;
|
|
struct usbd_device *parent; /* The ports hub */
|
|
};
|
|
|
|
struct usbd_hub {
|
|
usbd_status (*explore)__P((usbd_device_handle hub));
|
|
void *hubsoftc;
|
|
usb_hub_descriptor_t hubdesc;
|
|
struct usbd_port ports[1];
|
|
};
|
|
|
|
struct usb_softc;
|
|
|
|
/*****/
|
|
|
|
struct usbd_bus {
|
|
/* Filled by HC driver */
|
|
USBBASEDEVICE bdev; /* base device, host adapter */
|
|
struct usbd_bus_methods *methods;
|
|
u_int32_t pipe_size; /* size of a pipe struct */
|
|
/* Filled by usb driver */
|
|
struct usbd_device *root_hub;
|
|
usbd_device_handle devices[USB_MAX_DEVICES];
|
|
char needs_explore;/* a hub a signalled a change */
|
|
char use_polling;
|
|
struct usb_softc *usbctl;
|
|
struct usb_device_stats stats;
|
|
};
|
|
|
|
struct usbd_device {
|
|
struct usbd_bus *bus;
|
|
struct usbd_pipe *default_pipe;
|
|
u_int8_t address;
|
|
u_int8_t depth;
|
|
u_int8_t lowspeed;
|
|
u_int16_t power;
|
|
u_int8_t self_powered;
|
|
int config;
|
|
int langid; /* language to use for strings */
|
|
#define USBD_NOLANG (-1)
|
|
struct usbd_port *powersrc;
|
|
struct usbd_endpoint def_ep; /* for pipe 0 */
|
|
usb_endpoint_descriptor_t def_ep_desc; /* for pipe 0 */
|
|
struct usbd_interface *ifaces;
|
|
usb_device_descriptor_t ddesc;
|
|
usb_config_descriptor_t *cdesc; /* full config descr */
|
|
struct usbd_quirks *quirks;
|
|
struct usbd_hub *hub; /* only if this is a hub */
|
|
device_ptr_t *subdevs; /* sub-devices, 0 terminated */
|
|
};
|
|
|
|
struct usbd_interface {
|
|
struct usbd_device *device;
|
|
usb_interface_descriptor_t *idesc;
|
|
int index;
|
|
int altindex;
|
|
struct usbd_endpoint *endpoints;
|
|
void *priv;
|
|
LIST_HEAD(, usbd_pipe) pipes;
|
|
};
|
|
|
|
struct usbd_pipe {
|
|
struct usbd_interface *iface;
|
|
struct usbd_device *device;
|
|
struct usbd_endpoint *endpoint;
|
|
int refcnt;
|
|
char running;
|
|
SIMPLEQ_HEAD(, usbd_request) queue;
|
|
LIST_ENTRY(usbd_pipe) next;
|
|
|
|
usbd_request_handle intrreqh; /* used for repeating requests */
|
|
char repeat;
|
|
|
|
/* Filled by HC driver. */
|
|
struct usbd_pipe_methods *methods;
|
|
};
|
|
|
|
struct usbd_request {
|
|
struct usbd_pipe *pipe;
|
|
void *priv;
|
|
void *buffer;
|
|
u_int32_t length;
|
|
u_int32_t actlen;
|
|
u_int16_t flags;
|
|
u_int32_t timeout;
|
|
usbd_status status;
|
|
usbd_callback callback;
|
|
__volatile char done;
|
|
|
|
/* For control pipe */
|
|
usb_device_request_t request;
|
|
|
|
/* For isoc */
|
|
u_int16_t *frlengths;
|
|
int nframes;
|
|
|
|
/* For memory allocation */
|
|
struct usbd_device *dev;
|
|
usb_dma_t dmabuf;
|
|
|
|
int rqflags;
|
|
#define URQ_REQUEST 0x01
|
|
#define URQ_SYSDMABUF 0x10
|
|
#define URQ_USRDMABUF 0x20
|
|
|
|
SIMPLEQ_ENTRY(usbd_request) next;
|
|
|
|
void *hcpriv; /* private use by the HC driver */
|
|
int hcprivint; /* ditto */
|
|
|
|
#if defined(__FreeBSD__)
|
|
struct callout_handle timo_handle;
|
|
#endif
|
|
};
|
|
|
|
void usbd_init __P((void));
|
|
|
|
/* Routines from usb_subr.c */
|
|
int usbctlprint __P((void *, const char *));
|
|
void usb_delay_ms __P((usbd_bus_handle, u_int));
|
|
void usbd_devinfo_vp __P((usbd_device_handle, char *, char *));
|
|
usbd_status usbd_reset_port __P((usbd_device_handle dev,
|
|
int port, usb_port_status_t *ps));
|
|
usbd_status usbd_setup_pipe __P((usbd_device_handle dev,
|
|
usbd_interface_handle iface,
|
|
struct usbd_endpoint *,
|
|
usbd_pipe_handle *pipe));
|
|
usbd_status usbd_new_device __P((device_ptr_t parent,
|
|
usbd_bus_handle bus, int depth,
|
|
int lowspeed, int port,
|
|
struct usbd_port *));
|
|
void usbd_remove_device __P((usbd_device_handle,
|
|
struct usbd_port *));
|
|
int usbd_printBCD __P((char *cp, int bcd));
|
|
usbd_status usbd_fill_iface_data __P((usbd_device_handle dev,
|
|
int i, int a));
|
|
void usb_free_device __P((usbd_device_handle));
|
|
|
|
usbd_status usb_insert_transfer __P((usbd_request_handle reqh));
|
|
void usb_transfer_complete __P((usbd_request_handle reqh));
|
|
|
|
/* Routines from usb.c */
|
|
int usb_bus_count __P((void));
|
|
void usb_needs_explore __P((usbd_bus_handle));
|
|
|
|
/* Locator stuff. */
|
|
|
|
#if defined(__NetBSD__)
|
|
#include "locators.h"
|
|
#elif defined(__FreeBSD__) || defined(__OpenBSD__)
|
|
/* XXX these values are used to statically bind some elements in the USB tree
|
|
* to specific driver instances. This should be somehow emulated in FreeBSD
|
|
* but can be done later on.
|
|
* The values are copied from the files.usb file in the NetBSD sources.
|
|
*/
|
|
#define UHUBCF_PORT_DEFAULT -1
|
|
#define UHUBCF_CONFIGURATION_DEFAULT -1
|
|
#define UHUBCF_INTERFACE_DEFAULT -1
|
|
#define UHUBCF_VENDOR_DEFAULT -1
|
|
#define UHUBCF_PRODUCT_DEFAULT -1
|
|
#define UHUBCF_RELEASE_DEFAULT -1
|
|
#endif
|
|
|
|
#if defined (__OpenBSD__)
|
|
#define UHUBCF_PORT 0
|
|
#define UHUBCF_CONFIGURATION 1
|
|
#define UHUBCF_INTERFACE 2
|
|
#define UHUBCF_VENDOR 3
|
|
#define UHUBCF_PRODUCT 4
|
|
#define UHUBCF_RELEASE 5
|
|
#endif
|
|
|
|
#define uhubcf_port cf_loc[UHUBCF_PORT]
|
|
#define uhubcf_configuration cf_loc[UHUBCF_CONFIGURATION]
|
|
#define uhubcf_interface cf_loc[UHUBCF_INTERFACE]
|
|
#define uhubcf_vendor cf_loc[UHUBCF_VENDOR]
|
|
#define uhubcf_product cf_loc[UHUBCF_PRODUCT]
|
|
#define uhubcf_release cf_loc[UHUBCF_RELEASE]
|
|
#define UHUB_UNK_PORT UHUBCF_PORT_DEFAULT /* wildcarded 'port' */
|
|
#define UHUB_UNK_CONFIGURATION UHUBCF_CONFIGURATION_DEFAULT /* wildcarded 'configuration' */
|
|
#define UHUB_UNK_INTERFACE UHUBCF_INTERFACE_DEFAULT /* wildcarded 'interface' */
|
|
#define UHUB_UNK_VENDOR UHUBCF_VENDOR_DEFAULT /* wildcarded 'vendor' */
|
|
#define UHUB_UNK_PRODUCT UHUBCF_PRODUCT_DEFAULT /* wildcarded 'product' */
|
|
#define UHUB_UNK_RELEASE UHUBCF_RELEASE_DEFAULT /* wildcarded 'release' */
|
|
|