Introduce different autoconf interface attributes for USB drivers
matching (and handling) a whole device and those which match an
interface only. This will allow to enforce some rules, eg that
the former don't use interface information for matching or that the
latter don't modify global device state.
The previous way left too much freedom do the drivers which led to
inconsistencies and abuse.
For now, I've not changed locators and submatch rules, this will
happen later.
There should not be any change in behaviour, except in the case of
some drivers which did behave inconsistently:
if_atu, if_axe, uep: matched the configured device in the interface
stage, but did configuration again. I've converted them to match
in the device stage.
ustir, utoppy: matched in the interface stage, but only against
vendor/device information, and used any configuration/interface
without checking. Changed to match in device stage, and added
some simple code to configure and use the first interface.
If you have one of those devices, please test!
2007-03-13 16:51:53 +03:00
|
|
|
/* $NetBSD: uhidev.h,v 1.7 2007/03/13 13:51:55 drochner Exp $ */
|
2001-12-28 20:32:36 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Copyright (c) 2001 The NetBSD Foundation, Inc.
|
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* This code is derived from software contributed to The NetBSD Foundation
|
|
|
|
* by Lennart Augustsson (lennart@augustsson.net) 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.
|
|
|
|
*/
|
|
|
|
|
2002-10-08 13:56:17 +04:00
|
|
|
#include "rnd.h"
|
|
|
|
#if NRND > 0
|
|
|
|
#include <sys/rnd.h>
|
|
|
|
#endif
|
|
|
|
|
2001-12-28 20:32:36 +03:00
|
|
|
struct uhidev_softc {
|
|
|
|
USBBASEDEVICE sc_dev; /* base device */
|
|
|
|
usbd_device_handle sc_udev;
|
|
|
|
usbd_interface_handle sc_iface; /* interface */
|
2005-05-08 10:19:10 +04:00
|
|
|
usbd_pipe_handle sc_ipipe; /* input interrupt pipe */
|
|
|
|
int sc_iep_addr;
|
2001-12-28 20:32:36 +03:00
|
|
|
|
|
|
|
u_char *sc_ibuf;
|
|
|
|
u_int sc_isize;
|
|
|
|
|
2005-05-08 10:19:10 +04:00
|
|
|
usbd_pipe_handle sc_opipe; /* output interrupt pipe */
|
|
|
|
usbd_xfer_handle sc_oxfer; /* write request */
|
|
|
|
int sc_oep_addr;
|
|
|
|
|
2001-12-28 20:32:36 +03:00
|
|
|
void *sc_repdesc;
|
|
|
|
int sc_repdesc_size;
|
|
|
|
|
|
|
|
u_int sc_nrepid;
|
|
|
|
struct uhidev **sc_subdevs;
|
|
|
|
|
|
|
|
int sc_refcnt;
|
|
|
|
u_char sc_dying;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct uhidev {
|
|
|
|
USBBASEDEVICE sc_dev; /* base device */
|
|
|
|
struct uhidev_softc *sc_parent;
|
|
|
|
uByte sc_report_id;
|
|
|
|
u_int8_t sc_state;
|
2001-12-29 21:56:52 +03:00
|
|
|
int sc_in_rep_size;
|
2001-12-28 20:32:36 +03:00
|
|
|
#define UHIDEV_OPEN 0x01 /* device is open */
|
|
|
|
void (*sc_intr)(struct uhidev *, void *, u_int);
|
2002-10-08 13:56:17 +04:00
|
|
|
#if NRND > 0
|
|
|
|
rndsource_element_t rnd_source;
|
|
|
|
#endif
|
2001-12-28 20:32:36 +03:00
|
|
|
};
|
|
|
|
|
|
|
|
struct uhidev_attach_arg {
|
Introduce different autoconf interface attributes for USB drivers
matching (and handling) a whole device and those which match an
interface only. This will allow to enforce some rules, eg that
the former don't use interface information for matching or that the
latter don't modify global device state.
The previous way left too much freedom do the drivers which led to
inconsistencies and abuse.
For now, I've not changed locators and submatch rules, this will
happen later.
There should not be any change in behaviour, except in the case of
some drivers which did behave inconsistently:
if_atu, if_axe, uep: matched the configured device in the interface
stage, but did configuration again. I've converted them to match
in the device stage.
ustir, utoppy: matched in the interface stage, but only against
vendor/device information, and used any configuration/interface
without checking. Changed to match in device stage, and added
some simple code to configure and use the first interface.
If you have one of those devices, please test!
2007-03-13 16:51:53 +03:00
|
|
|
struct usbif_attach_arg *uaa;
|
2001-12-28 20:32:36 +03:00
|
|
|
struct uhidev_softc *parent;
|
|
|
|
int reportid;
|
2001-12-29 21:56:52 +03:00
|
|
|
int reportsize;
|
2001-12-28 20:32:36 +03:00
|
|
|
};
|
|
|
|
|
|
|
|
void uhidev_get_report_desc(struct uhidev_softc *, void **, int *);
|
|
|
|
int uhidev_open(struct uhidev *);
|
|
|
|
void uhidev_close(struct uhidev *);
|
|
|
|
usbd_status uhidev_set_report(struct uhidev *scd, int type, void *data,int len);
|
|
|
|
void uhidev_set_report_async(struct uhidev *scd, int type, void *data, int len);
|
|
|
|
usbd_status uhidev_get_report(struct uhidev *scd, int type, void *data,int len);
|
2005-05-08 10:19:10 +04:00
|
|
|
usbd_status uhidev_write(struct uhidev_softc *, void *, int);
|