1999-01-10 18:42:54 +00:00
|
|
|
/* $NetBSD: usbdivar.h,v 1.16 1999/01/08 11:58:26 augustss Exp $ */
|
1999-01-22 00:51:12 +00:00
|
|
|
/* $FreeBSD$ */
|
1998-12-14 09:32:25 +00:00
|
|
|
|
1998-11-26 23:13:13 +00:00
|
|
|
/*
|
|
|
|
* Copyright (c) 1998 The NetBSD Foundation, Inc.
|
|
|
|
* All rights reserved.
|
|
|
|
*
|
1999-01-07 23:07:57 +00:00
|
|
|
* This code is derived from software contributed to The NetBSD Foundation
|
|
|
|
* by Lennart Augustsson (augustss@carlstedt.se) at
|
|
|
|
* Carlstedt Research & Technology.
|
1998-11-26 23:13:13 +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:
|
|
|
|
* 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.
|
|
|
|
*/
|
|
|
|
|
|
|
|
struct usbd_request;
|
|
|
|
struct usbd_pipe;
|
|
|
|
|
|
|
|
struct usbd_endpoint {
|
|
|
|
usb_endpoint_descriptor_t *edesc;
|
|
|
|
usbd_endpoint_state state;
|
|
|
|
int refcnt;
|
|
|
|
int toggle; /* XXX */
|
|
|
|
};
|
|
|
|
|
|
|
|
typedef void (*usbd_xfercb)__P((usbd_request_handle req));
|
|
|
|
|
|
|
|
struct usbd_methods {
|
|
|
|
usbd_status (*transfer)__P((usbd_request_handle reqh));
|
1999-01-07 23:07:57 +00:00
|
|
|
usbd_status (*start)__P((usbd_request_handle reqh));
|
1998-11-26 23:13:13 +00:00
|
|
|
void (*abort)__P((usbd_request_handle reqh));
|
|
|
|
void (*close)__P((usbd_pipe_handle pipe));
|
|
|
|
usbd_status (*isobuf)__P((usbd_pipe_handle pipe,
|
|
|
|
u_int32_t bufsize,u_int32_t nbuf));
|
|
|
|
};
|
|
|
|
|
|
|
|
struct usbd_port {
|
|
|
|
usb_port_status_t status;
|
1999-01-07 23:07:57 +00:00
|
|
|
u_int16_t power; /* mA of current on port */
|
|
|
|
u_int8_t portno;
|
|
|
|
u_int8_t restartcnt;
|
|
|
|
#define USBD_RESTART_MAX 5
|
1998-11-26 23:13:13 +00:00
|
|
|
struct usbd_device *device;
|
|
|
|
struct usbd_device *parent; /* The ports hub */
|
|
|
|
};
|
|
|
|
|
|
|
|
struct usbd_hub {
|
|
|
|
usbd_status (*explore)__P((usbd_device_handle hub));
|
1999-01-07 23:07:57 +00:00
|
|
|
void *hubsoftc;
|
1998-11-26 23:13:13 +00:00
|
|
|
usb_hub_descriptor_t hubdesc;
|
|
|
|
struct usbd_port ports[1];
|
|
|
|
};
|
|
|
|
|
|
|
|
struct usb_softc;
|
|
|
|
|
|
|
|
/*****/
|
|
|
|
|
|
|
|
struct usbd_bus {
|
|
|
|
/* Filled by HC driver */
|
|
|
|
bdevice bdev; /* base device, host adapter */
|
|
|
|
usbd_status (*open_pipe)__P((struct usbd_pipe *pipe));
|
|
|
|
u_int32_t pipe_size; /* size of a pipe struct */
|
|
|
|
void (*do_poll)__P((struct usbd_bus *));
|
|
|
|
/* 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;
|
|
|
|
usbd_device_state state;
|
|
|
|
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;
|
1999-01-07 23:07:57 +00:00
|
|
|
int langid; /* language to use for strings */
|
|
|
|
#define USBD_NOLANG (-1)
|
1998-11-26 23:13:13 +00:00
|
|
|
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 */
|
1999-01-07 23:07:57 +00:00
|
|
|
void *softc; /* device softc if attached */
|
1998-11-26 23:13:13 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
struct usbd_interface {
|
|
|
|
struct usbd_device *device;
|
|
|
|
usbd_interface_state state;
|
|
|
|
usb_interface_descriptor_t *idesc;
|
1999-01-07 23:07:57 +00:00
|
|
|
int index;
|
|
|
|
int altindex;
|
1998-11-26 23:13:13 +00:00
|
|
|
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;
|
|
|
|
usbd_pipe_state state;
|
|
|
|
int32_t refcnt;
|
|
|
|
char running;
|
|
|
|
SIMPLEQ_HEAD(, usbd_request) queue;
|
|
|
|
LIST_ENTRY(usbd_pipe) next;
|
|
|
|
|
|
|
|
void (*disco) __P((void *));
|
|
|
|
void *discoarg;
|
|
|
|
|
|
|
|
usbd_request_handle intrreqh; /* used for repeating requests */
|
|
|
|
|
|
|
|
/* Filled by HC driver. */
|
|
|
|
struct usbd_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;
|
|
|
|
usbd_xfercb xfercb;
|
|
|
|
u_int32_t retries;
|
|
|
|
char done;
|
|
|
|
|
|
|
|
usb_device_request_t request;
|
|
|
|
u_int8_t isreq;
|
|
|
|
|
|
|
|
SIMPLEQ_ENTRY(usbd_request) next;
|
|
|
|
|
|
|
|
void *hcpriv; /* XXX private use by the HC driver */
|
|
|
|
|
|
|
|
#if defined(__FreeBSD__)
|
1999-07-25 18:54:22 +00:00
|
|
|
struct callout_handle timeout_handle;
|
1998-11-26 23:13:13 +00:00
|
|
|
#endif
|
|
|
|
};
|
|
|
|
|
|
|
|
void usbd_init __P((void));
|
|
|
|
|
|
|
|
/* Routines from usb_subr.c */
|
|
|
|
int usbctlprint __P((void *, const char *));
|
1999-01-07 23:07:57 +00:00
|
|
|
void usb_delay_ms __P((usbd_bus_handle, u_int));
|
1998-11-26 23:13:13 +00:00
|
|
|
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((bdevice *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));
|
1999-01-07 23:07:57 +00:00
|
|
|
usbd_status usb_insert_transfer __P((usbd_request_handle reqh));
|
|
|
|
void usb_start_next __P((usbd_pipe_handle pipe));
|
|
|
|
usbd_status usbd_fill_iface_data __P((usbd_device_handle dev,
|
|
|
|
int i, int a));
|
1998-11-26 23:13:13 +00:00
|
|
|
|
|
|
|
/* Routines from usb.c */
|
1999-01-07 23:07:57 +00:00
|
|
|
int usb_bus_count __P((void));
|
|
|
|
void usb_needs_explore __P((usbd_bus_handle));
|
1999-01-22 00:51:12 +00:00
|
|
|
#if 0
|
|
|
|
usbd_status usb_get_bus_handle __P((int, usbd_bus_handle *));
|
|
|
|
#endif
|
1998-11-26 23:13:13 +00:00
|
|
|
|
|
|
|
/* Locator stuff. */
|
|
|
|
|
|
|
|
#if defined(__NetBSD__)
|
|
|
|
#include "locators.h"
|
1999-01-07 23:07:57 +00:00
|
|
|
#elif defined(__FreeBSD__)
|
|
|
|
/* 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
|
1998-11-26 23:13:13 +00:00
|
|
|
#endif
|
|
|
|
|
1999-01-07 23:07:57 +00:00
|
|
|
#define uhubcf_port cf_loc[UHUBCF_PORT]
|
|
|
|
#define uhubcf_configuration cf_loc[UHUBCF_CONFIGURATION]
|
|
|
|
#define uhubcf_interface cf_loc[UHUBCF_INTERFACE]
|
|
|
|
#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' */
|
1998-11-26 23:13:13 +00:00
|
|
|
|