SAMV71 Xplained Ultra Software Package 1.4

HIDMSDDriver.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  */
00032 
00033 /** \addtogroup usbd_composite_hidmsd
00034  *@{
00035  */
00036 
00037 /*---------------------------------------------------------------------------
00038  *      Headers
00039  *---------------------------------------------------------------------------*/
00040 
00041 #include <USBLib_Trace.h>
00042 
00043 #include <HIDMSDDriver.h>
00044 
00045 #include <HIDDKeyboard.h>
00046 #include <MSDFunction.h>
00047 
00048 /*---------------------------------------------------------------------------
00049  *         Defines
00050  *---------------------------------------------------------------------------*/
00051 
00052 /*---------------------------------------------------------------------------
00053  *         Types
00054  *---------------------------------------------------------------------------*/
00055 
00056 /*---------------------------------------------------------------------------
00057  *         Internal variables
00058  *---------------------------------------------------------------------------*/
00059 
00060 /*---------------------------------------------------------------------------
00061  *         Internal functions
00062  *---------------------------------------------------------------------------*/
00063 
00064 
00065 /*---------------------------------------------------------------------------
00066  *         Exported functions
00067  *---------------------------------------------------------------------------*/
00068 
00069 /**
00070  * Initializes the USB device HIDMSD device driver.
00071  */
00072 void HIDMSDDriver_Initialize(
00073     const USBDDriverDescriptors *pDescriptors,
00074     MSDLun *pLuns, uint8_t numLuns)
00075 {
00076     USBDDriver *pUsbd = USBD_GetDriver();
00077 
00078     /* Initialize the standard USB driver */
00079     USBDDriver_Initialize(pUsbd,
00080                           pDescriptors,
00081                           0);
00082 
00083     /* HID */
00084     HIDDKeyboard_Initialize(pUsbd, HIDMSDDriverDescriptors_HID_INTERFACE);
00085 
00086     /* MSD */
00087     MSDFunction_Initialize(pUsbd, HIDMSDDriverDescriptors_MSD_INTERFACE,
00088                            pLuns, numLuns);
00089 
00090     /* Initialize the USB driver */
00091     USBD_Init();
00092 }
00093 
00094 /**
00095  * Invoked whenever the configuration value of a device is changed by the host
00096  * \param cfgnum Configuration number.
00097  */
00098 void HIDMSDDriver_ConfigurationChangedHandler(uint8_t cfgnum)
00099 {
00100     USBDDriver *pUsbd = USBD_GetDriver();
00101     USBConfigurationDescriptor *pDesc;
00102     if (cfgnum > 0) {
00103         pDesc = USBDDriver_GetCfgDescriptors(pUsbd, cfgnum);
00104         /* HID */
00105         HIDDKeyboard_ConfigureFunction((USBGenericDescriptor*)pDesc,
00106                                         pDesc->wTotalLength);
00107         /* MSD */
00108         MSDFunction_Configure((USBGenericDescriptor*)pDesc,
00109                               pDesc->wTotalLength);
00110     }
00111 }
00112 
00113 /**
00114  * Handles HIDMSD-specific USB requests sent by the host, and forwards
00115  * standard ones to the USB device driver.
00116  * \param request Pointer to a USBGenericRequest instance.
00117  */
00118 void HIDMSDDriver_RequestHandler(const USBGenericRequest *request)
00119 {
00120     USBDDriver *pUsbd = USBD_GetDriver();
00121 
00122     TRACE_INFO_WP("NewReq ");
00123 
00124     if (HIDDKeyboard_RequestHandler(request) == USBRC_SUCCESS)
00125         return;
00126 
00127     if (MSDFunction_RequestHandler(request) == USBRC_SUCCESS)
00128         return;
00129 
00130     USBDDriver_RequestHandler(pUsbd, request);
00131 }
00132 
00133 /**
00134  * Starts a remote wake-up sequence if the host has explicitely enabled it
00135  * by sending the appropriate SET_FEATURE request.
00136  */
00137 void HIDMSDDriver_RemoteWakeUp(void)
00138 {
00139     USBDDriver *pUsbd = USBD_GetDriver();
00140 
00141     /* Remote wake-up has been enabled */
00142     if (USBDDriver_IsRemoteWakeUpEnabled(pUsbd)) {
00143 
00144         USBD_RemoteWakeUp();
00145     }
00146     /* Remote wake-up NOT enabled */
00147     else {
00148 
00149         TRACE_WARNING("HIDMSDDDriver_RemoteWakeUp: not enabled\n\r");
00150     }
00151 }
00152 /**@}*/
00153 
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines