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 * Definitions of callbacks used by the USBD API to notify the user 00032 * application of incoming events. These functions are declared as 'weak', 00033 * so they can be re-implemented elsewhere in the application in a 00034 * transparent way. 00035 * 00036 * \addtogroup usbd_interface 00037 *@{ 00038 */ 00039 00040 /*------------------------------------------------------------------------------ 00041 * Headers 00042 *------------------------------------------------------------------------------*/ 00043 00044 #include "USBD.h" 00045 #include "USBDDriver.h" 00046 00047 /*------------------------------------------------------------------------------ 00048 * Exported function 00049 *------------------------------------------------------------------------------*/ 00050 00051 /** 00052 * Invoked after the USB driver has been initialized. By default, do nothing. 00053 */ 00054 WEAK void USBDCallbacks_Initialized(void) 00055 { 00056 /* Does nothing */ 00057 } 00058 00059 /** 00060 * Invoked when the USB driver is reset. Does nothing by default. 00061 */ 00062 WEAK void USBDCallbacks_Reset(void) 00063 { 00064 /* Does nothing*/ 00065 } 00066 00067 /** 00068 * Invoked when the USB device gets suspended. By default, do nothing. 00069 */ 00070 WEAK void USBDCallbacks_Suspended(void) {} 00071 00072 /** 00073 * Invoked when the USB device leaves the Suspended state. By default, 00074 * Do nothing. 00075 */ 00076 WEAK void USBDCallbacks_Resumed(void) {} 00077 00078 /** 00079 * USBDCallbacks_RequestReceived - Invoked when a new SETUP request is 00080 * received. Does nothing by default. 00081 * \param request Pointer to the request to handle. 00082 */ 00083 WEAK void USBDCallbacks_RequestReceived(const USBGenericRequest *request) 00084 { 00085 /* Does basic enumeration */ 00086 USBDDriver_RequestHandler(USBD_GetDriver(), request); 00087 } 00088 00089 /**@}*/