| /** | |
| * \file | |
| * | |
| * \brief USB Device Human Interface Device (HID) interface. | |
| * | |
| * Copyright (C) 2009 Atmel Corporation. All rights reserved. | |
| * | |
| * \page License | |
| * | |
| * 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. The name of Atmel may not be used to endorse or promote products derived | |
| * from this software without specific prior written permission. | |
| * | |
| * 4. This software may only be redistributed and used in connection with an | |
| * Atmel AVR product. | |
| * | |
| * THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR IMPLIED | |
| * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF | |
| * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE | |
| * EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL 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. | |
| */ | |
| #include "conf_usb.h" | |
| #include "usb_protocol.h" | |
| #include "udd.h" | |
| #include "udc.h" | |
| #include "udi_hid.h" | |
| /** | |
| * \addtogroup udi_hid_group | |
| * @{ | |
| */ | |
| /** | |
| * \name Internal routines | |
| */ | |
| //@{ | |
| /** | |
| * \brief Send the specific descriptors requested by SETUP request | |
| * | |
| * \retval true if the descriptor is supported | |
| */ | |
| static bool udi_hid_reqstdifaceget_descriptor(uint8_t *report_desc); | |
| //@} | |
| bool udi_hid_setup( uint8_t *rate, uint8_t *protocol, uint8_t *report_desc, bool (*set_report)(void) ) | |
| { | |
| if (Udd_setup_is_in()) { | |
| // Requests Interface GET | |
| if (Udd_setup_type() == USB_REQ_TYPE_STANDARD) { | |
| // Requests Standard Interface Get | |
| switch (udd_g_ctrlreq.req.bRequest) { | |
| case USB_REQ_GET_DESCRIPTOR: | |
| return udi_hid_reqstdifaceget_descriptor(report_desc); | |
| } | |
| } | |
| if (Udd_setup_type() == USB_REQ_TYPE_CLASS) { | |
| // Requests Class Interface Get | |
| switch (udd_g_ctrlreq.req.bRequest) { | |
| case USB_REQ_HID_GET_REPORT: | |
| // TODO | |
| break; | |
| case USB_REQ_HID_GET_IDLE: | |
| udd_g_ctrlreq.payload = rate; | |
| udd_g_ctrlreq.payload_size = 1; | |
| return true; | |
| case USB_REQ_HID_GET_PROTOCOL: | |
| udd_g_ctrlreq.payload = protocol; | |
| udd_g_ctrlreq.payload_size = 1; | |
| return true; | |
| } | |
| } | |
| } | |
| if (Udd_setup_is_out()) { | |
| // Requests Interface SET | |
| if (Udd_setup_type() == USB_REQ_TYPE_CLASS) { | |
| // Requests Class Interface Set | |
| switch (udd_g_ctrlreq.req.bRequest) { | |
| case USB_REQ_HID_SET_REPORT: | |
| return set_report(); | |
| case USB_REQ_HID_SET_IDLE: | |
| *rate = udd_g_ctrlreq.req.wValue >> 8; | |
| return true; | |
| case USB_REQ_HID_SET_PROTOCOL: | |
| if (0 != udd_g_ctrlreq.req.wLength) | |
| return false; | |
| *protocol = udd_g_ctrlreq.req.wValue; | |
| return true; | |
| } | |
| } | |
| } | |
| return false; // Request not supported | |
| } | |
| //--------------------------------------------- | |
| //------- Internal routines | |
| static bool udi_hid_reqstdifaceget_descriptor(uint8_t *report_desc) | |
| { | |
| usb_hid_descriptor_t UDC_DESC_STORAGE *ptr_hid_desc; | |
| // Get the USB descriptor which is located after the interface descriptor | |
| // This descriptor must be the HID descriptor | |
| ptr_hid_desc = (usb_hid_descriptor_t UDC_DESC_STORAGE *) ((uint8_t *) | |
| udc_get_interface_desc() + sizeof(usb_iface_desc_t)); | |
| if (USB_DT_HID != ptr_hid_desc->bDescriptorType) | |
| return false; | |
| // The SETUP request can ask for: | |
| // - an USB_DT_HID descriptor | |
| // - or USB_DT_HID_REPORT descriptor | |
| // - or USB_DT_HID_PHYSICAL descriptor | |
| if (USB_DT_HID == (uint8_t) (udd_g_ctrlreq.req.wValue >> 8)) { | |
| // USB_DT_HID descriptor requested then send it | |
| udd_g_ctrlreq.payload = (uint8_t *) ptr_hid_desc; | |
| udd_g_ctrlreq.payload_size = | |
| min(udd_g_ctrlreq.req.wLength, | |
| ptr_hid_desc->bLength); | |
| return true; | |
| } | |
| // The HID_X descriptor requested must correspond to report type | |
| // included in the HID descriptor | |
| if (ptr_hid_desc->bRDescriptorType == | |
| (uint8_t) (udd_g_ctrlreq.req.wValue >> 8)) { | |
| // Send HID Report descriptor given by high level | |
| udd_g_ctrlreq.payload = report_desc; | |
| udd_g_ctrlreq.payload_size = | |
| min(udd_g_ctrlreq.req.wLength, | |
| le16_to_cpu(ptr_hid_desc->wDescriptorLength)); | |
| return true; | |
| } | |
| return false; | |
| } | |
| //@} |