SAMV71 Xplained Ultra Software Package 1.5

HIDMSDDriver.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  */
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 
00103     if (cfgnum > 0) {
00104         pDesc = USBDDriver_GetCfgDescriptors(pUsbd, cfgnum);
00105         /* HID */
00106         HIDDKeyboard_ConfigureFunction((USBGenericDescriptor *)pDesc,
00107                                         pDesc->wTotalLength);
00108         /* MSD */
00109         MSDFunction_Configure((USBGenericDescriptor *)pDesc,
00110                                 pDesc->wTotalLength);
00111     }
00112 }
00113 
00114 /**
00115  * Handles HIDMSD-specific USB requests sent by the host, and forwards
00116  * standard ones to the USB device driver.
00117  * \param request Pointer to a USBGenericRequest instance.
00118  */
00119 void HIDMSDDriver_RequestHandler(const USBGenericRequest *request)
00120 {
00121     USBDDriver *pUsbd = USBD_GetDriver();
00122 
00123     TRACE_INFO_WP("NewReq ");
00124 
00125     if (HIDDKeyboard_RequestHandler(request) == USBRC_SUCCESS)
00126         return;
00127 
00128     if (MSDFunction_RequestHandler(request) == USBRC_SUCCESS)
00129         return;
00130 
00131     USBDDriver_RequestHandler(pUsbd, request);
00132 }
00133 
00134 /**
00135  * Starts a remote wake-up sequence if the host has explicitly enabled it
00136  * by sending the appropriate SET_FEATURE request.
00137  */
00138 void HIDMSDDriver_RemoteWakeUp(void)
00139 {
00140     USBDDriver *pUsbd = USBD_GetDriver();
00141 
00142     /* Remote wake-up has been enabled */
00143     if (USBDDriver_IsRemoteWakeUpEnabled(pUsbd))
00144 
00145         USBD_RemoteWakeUp();
00146     /* Remote wake-up NOT enabled */
00147     else
00148 
00149         TRACE_WARNING("HIDMSDDDriver_RemoteWakeUp: not enabled\n\r");
00150 }
00151 /**@}*/
00152 
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines