1/* $FreeBSD$ */ 2/* $NetBSD: hid.c,v 1.17 2001/11/13 06:24:53 lukem Exp $ */ 3/*- 4 * SPDX-License-Identifier: BSD-2-Clause-NetBSD 5 * 6 * Copyright (c) 1998 The NetBSD Foundation, Inc. 7 * All rights reserved. 8 * 9 * This code is derived from software contributed to The NetBSD Foundation 10 * by Lennart Augustsson (lennart@augustsson.net) at 11 * Carlstedt Research & Technology. 12 * 13 * Redistribution and use in source and binary forms, with or without 14 * modification, are permitted provided that the following conditions 15 * are met: 16 * 1. Redistributions of source code must retain the above copyright 17 * notice, this list of conditions and the following disclaimer. 18 * 2. Redistributions in binary form must reproduce the above copyright 19 * notice, this list of conditions and the following disclaimer in the 20 * documentation and/or other materials provided with the distribution. 21 * 22 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 23 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 24 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 25 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 26 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 27 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 28 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 29 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 30 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 31 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 32 * POSSIBILITY OF SUCH DAMAGE. 33 */ 34 35#ifdef USB_GLOBAL_INCLUDE_FILE 36#include USB_GLOBAL_INCLUDE_FILE 37#else 38#include <sys/stdint.h> 39#include <sys/stddef.h> 40#include <sys/param.h> 41#include <sys/queue.h> 42#include <sys/types.h> 43#include <sys/systm.h> 44#include <sys/kernel.h> 45#include <sys/bus.h> 46#include <sys/module.h> 47#include <sys/lock.h> 48#include <sys/mutex.h> 49#include <sys/condvar.h> 50#include <sys/sysctl.h> 51#include <sys/sx.h> 52#include <sys/unistd.h> 53#include <sys/callout.h> 54#include <sys/malloc.h> 55#include <sys/priv.h> 56 57#include <dev/usb/usb.h> 58#include <dev/usb/usbdi.h> 59#include <dev/usb/usbdi_util.h> 60#include <dev/usb/usbhid.h> 61 62#define USB_DEBUG_VAR usb_debug 63 64#include <dev/usb/usb_core.h> 65#include <dev/usb/usb_debug.h> 66#include <dev/usb/usb_process.h> 67#include <dev/usb/usb_device.h> 68#include <dev/usb/usb_request.h> 69#endif /* USB_GLOBAL_INCLUDE_FILE */ 70 71/*------------------------------------------------------------------------* 72 * hid_get_descriptor_from_usb 73 * 74 * This function will search for a HID descriptor between two USB 75 * interface descriptors. 76 * 77 * Return values: 78 * NULL: No more HID descriptors. 79 * Else: Pointer to HID descriptor. 80 *------------------------------------------------------------------------*/ 81struct usb_hid_descriptor * 82hid_get_descriptor_from_usb(struct usb_config_descriptor *cd, 83 struct usb_interface_descriptor *id) 84{ 85 struct usb_descriptor *desc = (void *)id; 86 87 if (desc == NULL) { 88 return (NULL); 89 } 90 while ((desc = usb_desc_foreach(cd, desc))) { 91 if ((desc->bDescriptorType == UDESC_HID) && 92 (desc->bLength >= USB_HID_DESCRIPTOR_SIZE(0))) { 93 return (void *)desc; 94 } 95 if (desc->bDescriptorType == UDESC_INTERFACE) { 96 break; 97 } 98 } 99 return (NULL); 100} 101 102/*------------------------------------------------------------------------* 103 * usbd_req_get_hid_desc 104 * 105 * This function will read out an USB report descriptor from the USB 106 * device. 107 * 108 * Return values: 109 * NULL: Failure. 110 * Else: Success. The pointer should eventually be passed to free(). 111 *------------------------------------------------------------------------*/ 112usb_error_t 113usbd_req_get_hid_desc(struct usb_device *udev, struct mtx *mtx, 114 void **descp, uint16_t *sizep, 115 struct malloc_type *mem, uint8_t iface_index) 116{ 117 struct usb_interface *iface = usbd_get_iface(udev, iface_index); 118 struct usb_hid_descriptor *hid; 119 usb_error_t err; 120 121 if ((iface == NULL) || (iface->idesc == NULL)) { 122 return (USB_ERR_INVAL); 123 } 124 hid = hid_get_descriptor_from_usb 125 (usbd_get_config_descriptor(udev), iface->idesc); 126 127 if (hid == NULL) { 128 return (USB_ERR_IOERROR); 129 } 130 *sizep = UGETW(hid->descrs[0].wDescriptorLength); 131 if (*sizep == 0) { 132 return (USB_ERR_IOERROR); 133 } 134 if (mtx) 135 mtx_unlock(mtx); 136 137 *descp = malloc(*sizep, mem, M_ZERO | M_WAITOK); 138 139 if (mtx) 140 mtx_lock(mtx); 141 142 if (*descp == NULL) { 143 return (USB_ERR_NOMEM); 144 } 145 err = usbd_req_get_report_descriptor 146 (udev, mtx, *descp, *sizep, iface_index); 147 148 if (err) { 149 free(*descp, mem); 150 *descp = NULL; 151 return (err); 152 } 153 return (USB_ERR_NORMAL_COMPLETION); 154} 155