SAMV71 Xplained Ultra Software Package 1.3

HIDDKeyboardDriver.c

Go to the documentation of this file.
00001 /* ----------------------------------------------------------------------------
00002  *         ATMEL Microcontroller Software Support
00003  * ----------------------------------------------------------------------------
00004  * Copyright (c) 2008, Atmel Corporation
00005  *
00006  * All rights reserved.
00007  *
00008  * Redistribution and use in source and binary forms, with or without
00009  * modification, are permitted provided that the following conditions are met:
00010  *
00011  * - Redistributions of source code must retain the above copyright notice,
00012  * this list of conditions and the disclaimer below.
00013  *
00014  * Atmel's name may not be used to endorse or promote products derived from
00015  * this software without specific prior written permission.
00016  *
00017  * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR
00018  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
00019  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE
00020  * DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT,
00021  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
00022  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
00023  * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
00024  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
00025  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
00026  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00027  * ----------------------------------------------------------------------------
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         HIDDKeyboard_ConfigureFunction((USBGenericDescriptor*)pDesc,
00098                                        pDesc->wTotalLength);
00099     }
00100 }
00101 
00102 /**
00103  * Handles HID-specific SETUP request sent by the host.
00104  * \param request Pointer to a USBGenericRequest instance.
00105  */
00106 void HIDDKeyboardDriver_RequestHandler(const USBGenericRequest *request)
00107 {
00108     USBDDriver *pUsbd = USBD_GetDriver();
00109 
00110     TRACE_INFO_WP("NewReq ");
00111 
00112     /* Process HID requests */
00113     if (USBRC_SUCCESS == HIDDKeyboard_RequestHandler(request)) {
00114         return;
00115     }
00116     /* Process STD requests */
00117     else {
00118         USBDDriver_RequestHandler(pUsbd, request);
00119     }
00120 }
00121 
00122 /**@}*/
00123 
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines