FreeBSD/Linux Kernel Cross Reference
sys/dev/usb/usb_hid.c

     /* $FreeBSD$ */
     /*      $NetBSD: hid.c,v 1.17 2001/11/13 06:24:53 lukem Exp $   */
     /*-
      * SPDX-License-Identifier: BSD-2-Clause-NetBSD
      *
      * Copyright (c) 1998 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.
     *
     * 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.
     */
    
    #ifdef USB_GLOBAL_INCLUDE_FILE
    #include USB_GLOBAL_INCLUDE_FILE
    #else
    #include <sys/stdint.h>
    #include <sys/stddef.h>
    #include <sys/param.h>
    #include <sys/queue.h>
    #include <sys/types.h>
    #include <sys/systm.h>
    #include <sys/kernel.h>
    #include <sys/bus.h>
    #include <sys/module.h>
    #include <sys/lock.h>
    #include <sys/mutex.h>
    #include <sys/condvar.h>
    #include <sys/sysctl.h>
    #include <sys/sx.h>
    #include <sys/unistd.h>
    #include <sys/callout.h>
    #include <sys/malloc.h>
    #include <sys/priv.h>
    
    #include <dev/usb/usb.h>
    #include <dev/usb/usbdi.h>
    #include <dev/usb/usbdi_util.h>
    #include <dev/usb/usbhid.h>
    
    #define USB_DEBUG_VAR usb_debug
    
    #include <dev/usb/usb_core.h>
    #include <dev/usb/usb_debug.h>
    #include <dev/usb/usb_process.h>
    #include <dev/usb/usb_device.h>
    #include <dev/usb/usb_request.h>
    #endif                  /* USB_GLOBAL_INCLUDE_FILE */
    
    /*------------------------------------------------------------------------*
     *      hid_get_descriptor_from_usb
     *
     * This function will search for a HID descriptor between two USB
     * interface descriptors.
     *
     * Return values:
     * NULL: No more HID descriptors.
     * Else: Pointer to HID descriptor.
     *------------------------------------------------------------------------*/
    struct usb_hid_descriptor *
    hid_get_descriptor_from_usb(struct usb_config_descriptor *cd,
        struct usb_interface_descriptor *id)
    {
            struct usb_descriptor *desc = (void *)id;
    
            if (desc == NULL) {
                    return (NULL);
            }
            while ((desc = usb_desc_foreach(cd, desc))) {
                    if ((desc->bDescriptorType == UDESC_HID) &&
                        (desc->bLength >= USB_HID_DESCRIPTOR_SIZE(0))) {
                            return (void *)desc;
                    }
                    if (desc->bDescriptorType == UDESC_INTERFACE) {
                            break;
                    }
            }
            return (NULL);
   }
   
   /*------------------------------------------------------------------------*
    *      usbd_req_get_hid_desc
    *
    * This function will read out an USB report descriptor from the USB
    * device.
    *
    * Return values:
    * NULL: Failure.
    * Else: Success. The pointer should eventually be passed to free().
    *------------------------------------------------------------------------*/
   usb_error_t
   usbd_req_get_hid_desc(struct usb_device *udev, struct mtx *mtx,
       void **descp, uint16_t *sizep,
       struct malloc_type *mem, uint8_t iface_index)
   {
           struct usb_interface *iface = usbd_get_iface(udev, iface_index);
           struct usb_hid_descriptor *hid;
           usb_error_t err;
   
           if ((iface == NULL) || (iface->idesc == NULL)) {
                   return (USB_ERR_INVAL);
           }
           hid = hid_get_descriptor_from_usb
               (usbd_get_config_descriptor(udev), iface->idesc);
   
           if (hid == NULL) {
                   return (USB_ERR_IOERROR);
           }
           *sizep = UGETW(hid->descrs[0].wDescriptorLength);
           if (*sizep == 0) {
                   return (USB_ERR_IOERROR);
           }
           if (mtx)
                   mtx_unlock(mtx);
   
           *descp = malloc(*sizep, mem, M_ZERO | M_WAITOK);
   
           if (mtx)
                   mtx_lock(mtx);
   
           if (*descp == NULL) {
                   return (USB_ERR_NOMEM);
           }
           err = usbd_req_get_report_descriptor
               (udev, mtx, *descp, *sizep, iface_index);
   
           if (err) {
                   free(*descp, mem);
                   *descp = NULL;
                   return (err);
           }
           return (USB_ERR_NORMAL_COMPLETION);
   }

Cache object: 07acc7035a3a68618554a5275e85797f