git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/CORTEX_A5_SAMA5D3x_Xplained_IAR/AtmelFiles/usb/device/core/USBDCallbacks.c

   1 /* ----------------------------------------------------------------------------\r
   2  *         ATMEL Microcontroller Software Support\r
   3  * ----------------------------------------------------------------------------\r
   4  * Copyright (c) 2008, Atmel Corporation\r
   5  *\r
   6  * All rights reserved.\r
   7  *\r
   8  * Redistribution and use in source and binary forms, with or without\r
   9  * modification, are permitted provided that the following conditions are met:\r
  10  *\r
  11  * - Redistributions of source code must retain the above copyright notice,\r
  12  * this list of conditions and the disclaimer below.\r
  13  *\r
  14  * Atmel's name may not be used to endorse or promote products derived from\r
  15  * this software without specific prior written permission.\r
  16  *\r
  17  * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR\r
  18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF\r
  19  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE\r
  20  * DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT,\r
  21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\r
  22  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,\r
  23  * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\r
  24  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\r
  25  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\r
  26  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
  27  * ----------------------------------------------------------------------------\r
  28  */\r
  29 \r
  30 /** \file\r
  31  *    Definitions of callbacks used by the USBD API to notify the user\r
  32  *    application of incoming events. These functions are declared as 'weak',\r
  33  *    so they can be re-implemented elsewhere in the application in a\r
  34  *    transparent way.\r
  35  *\r
  36  * \addtogroup usbd_interface\r
  37  *@{\r
  38  */\r
  39 \r
  40 /*------------------------------------------------------------------------------\r
  41  *         Headers\r
  42  *------------------------------------------------------------------------------*/\r
  43 \r
  44 #include "USBD.h"\r
  45 #include "USBDDriver.h"\r
  46 \r
  47 /*------------------------------------------------------------------------------\r
  48  *         Exported function\r
  49  *------------------------------------------------------------------------------*/\r
  50 \r
  51 /**\r
  52  * Invoked after the USB driver has been initialized. By default, do nothing.\r
  53  */\r
  54 WEAK void USBDCallbacks_Initialized(void)\r
  55 {\r
  56     /* Does nothing */\r
  57         __asm volatile( "NOP" );\r
  58 }\r
  59 \r
  60 /**\r
  61  * Invoked when the USB driver is reset. Does nothing by default.\r
  62  */\r
  63 WEAK void USBDCallbacks_Reset(void)\r
  64 {\r
  65     /* Does nothing*/\r
  66 }\r
  67 \r
  68 /**\r
  69  * Invoked when the USB device gets suspended. By default, do nothing.\r
  70  */\r
  71 WEAK void USBDCallbacks_Suspended(void) {}\r
  72 \r
  73 /**\r
  74  * Invoked when the USB device leaves the Suspended state. By default,\r
  75  * Do nothing.\r
  76  */\r
  77 WEAK void USBDCallbacks_Resumed(void) {}\r
  78 \r
  79 /**\r
  80  * USBDCallbacks_RequestReceived - Invoked when a new SETUP request is\r
  81  * received. Does nothing by default.\r
  82  * \param request Pointer to the request to handle.\r
  83  */\r
  84 WEAK void USBDCallbacks_RequestReceived(const USBGenericRequest *request)\r
  85 {\r
  86     /* Does basic enumeration */\r
  87     USBDDriver_RequestHandler(USBD_GetDriver(), request);\r
  88 }\r
  89 \r
  90 /**@}*/\r