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 * \section Purpose 00033 * 00034 * Definition of several callbacks which are triggered by the USB software 00035 * driver after receiving specific requests. 00036 * 00037 * \section Usage 00038 * 00039 * -# Re-implement the USBDDriverCallbacks_ConfigurationChanged 00040 * callback to know when the hosts changes the active configuration of 00041 * the device. 00042 * -# Re-implement the USBDDriverCallbacks_InterfaceSettingChanged 00043 * callback to get notified whenever the active setting of an interface 00044 * is changed by the host. 00045 * 00046 * \addtogroup usbd_interface 00047 *@{ 00048 */ 00049 00050 /*------------------------------------------------------------------------------ 00051 * Headers 00052 *------------------------------------------------------------------------------*/ 00053 00054 #include "USBDDriver.h" 00055 #include <USBLib_Trace.h> 00056 00057 /*------------------------------------------------------------------------------ 00058 * Global functions 00059 *------------------------------------------------------------------------------*/ 00060 00061 /** 00062 * Indicates that the current configuration of the device has changed. 00063 * \param cfgnum New device configuration index. 00064 */ 00065 WEAK void USBDDriverCallbacks_ConfigurationChanged(uint8_t cfgnum) 00066 { 00067 cfgnum = cfgnum; 00068 TRACE_INFO_WP("cfgChanged%d ", cfgnum); 00069 } 00070 00071 /** 00072 * Notifies of a change in the currently active setting of an interface. 00073 * \param interface Number of the interface whose setting has changed. 00074 * \param setting New interface setting. 00075 */ 00076 WEAK void USBDDriverCallbacks_InterfaceSettingChanged( 00077 uint8_t interface, 00078 uint8_t setting) 00079 { 00080 interface = interface; setting = setting; 00081 TRACE_INFO_WP("ifSettingChanged%d.%d ", interface, setting); 00082 } 00083 00084 /**@}*/