SAMV71 Xplained Ultra Software Package 1.5

HIDDKeyboardDriver.c

Go to the documentation of this file.
00001 /* ---------------------------------------------------------------------------- */
00002 /*                  Atmel Microcontroller Software Support                      */
00003 /*                       SAM Software Package License                           */
00004 /* ---------------------------------------------------------------------------- */
00005 /* Copyright (c) 2015, Atmel Corporation                                        */
00006 /*                                                                              */
00007 /* All rights reserved.                                                         */
00008 /*                                                                              */
00009 /* Redistribution and use in source and binary forms, with or without           */
00010 /* modification, are permitted provided that the following condition is met:    */
00011 /*                                                                              */
00012 /* - Redistributions of source code must retain the above copyright notice,     */
00013 /* this list of conditions and the disclaimer below.                            */
00014 /*                                                                              */
00015 /* Atmel's name may not be used to endorse or promote products derived from     */
00016 /* this software without specific prior written permission.                     */
00017 /*                                                                              */
00018 /* DISCLAIMER:  THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR   */
00019 /* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF */
00020 /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE   */
00021 /* DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT,      */
00022 /* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT */
00023 /* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,  */
00024 /* OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF    */
00025 /* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING         */
00026 /* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, */
00027 /* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.                           */
00028 /* ---------------------------------------------------------------------------- */
00029 
00030 /** \file
00031  * \addtogroup usbd_hid_key
00032  *@{
00033  * Implement a USB device that only have HID Keyboard Function.
00034  */
00035 
00036 /*------------------------------------------------------------------------------
00037  *         Headers
00038  *------------------------------------------------------------------------------*/
00039 
00040 #include <HIDDKeyboardDriver.h>
00041 #include <HIDDFunction.h>
00042 
00043 #include <USBLib_Trace.h>
00044 
00045 #include <USBRequests.h>
00046 #include <HIDDescriptors.h>
00047 #include <HIDRequests.h>
00048 #include <HIDReports.h>
00049 #include <HIDUsages.h>
00050 
00051 #include "USBD.h"
00052 #include <USBD_HAL.h>
00053 #include <USBDDriver.h>
00054 
00055 /*------------------------------------------------------------------------------
00056  *         Internal types
00057  *------------------------------------------------------------------------------*/
00058 
00059 /*------------------------------------------------------------------------------
00060  *         Internal variables
00061  *------------------------------------------------------------------------------*/
00062 
00063 /*------------------------------------------------------------------------------
00064  *         Internal functions
00065  *------------------------------------------------------------------------------*/
00066 
00067 /*------------------------------------------------------------------------------
00068  *      Exported functions
00069  *------------------------------------------------------------------------------*/
00070 
00071 /**
00072  * Initializes the HID keyboard device driver.
00073  */
00074 void HIDDKeyboardDriver_Initialize(const USBDDriverDescriptors *pDescriptors)
00075 {
00076     USBDDriver *pUsbd = USBD_GetDriver();
00077     USBDDriver_Initialize(pUsbd, pDescriptors, 0);
00078     HIDDKeyboard_Initialize(pUsbd, 0);
00079     USBD_Init();
00080 }
00081 
00082 /**
00083  * Handles configureation changed event.
00084  * \param cfgnum New configuration number
00085  */
00086 void HIDDKeyboardDriver_ConfigurationChangedHandler(uint8_t cfgnum)
00087 {
00088     USBDDriver *pUsbd = USBD_GetDriver();
00089     const USBDDriverDescriptors *pDescriptors = pUsbd->pDescriptors;
00090     USBConfigurationDescriptor *pDesc;
00091 
00092     if (cfgnum > 0) {
00093         if (USBD_HAL_IsHighSpeed() && pDescriptors->pHsConfiguration)
00094             pDesc = (USBConfigurationDescriptor *)pDescriptors->pHsConfiguration;
00095         else
00096             pDesc = (USBConfigurationDescriptor *)pDescriptors->pFsConfiguration;
00097 
00098         HIDDKeyboard_ConfigureFunction((USBGenericDescriptor *)pDesc,
00099                                        pDesc->wTotalLength);
00100     }
00101 }
00102 
00103 /**
00104  * Handles HID-specific SETUP request sent by the host.
00105  * \param request Pointer to a USBGenericRequest instance.
00106  */
00107 void HIDDKeyboardDriver_RequestHandler(const USBGenericRequest *request)
00108 {
00109     USBDDriver *pUsbd = USBD_GetDriver();
00110 
00111     TRACE_INFO_WP("NewReq ");
00112 
00113     /* Process HID requests */
00114     if (USBRC_SUCCESS == HIDDKeyboard_RequestHandler(request))
00115         return;
00116     /* Process STD requests */
00117     else
00118         USBDDriver_RequestHandler(pUsbd, request);
00119 }
00120 
00121 /**@}*/
00122 
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines