/* This header file is part of the AVR Software Framework 2.0.0 release */ | |
/*This file is prepared for Doxygen automatic documentation generation.*/ | |
/*! \file ****************************************************************** | |
* | |
* \brief Processing of USB device specific enumeration requests. | |
* | |
* This file contains the specific request decoding for enumeration process. | |
* | |
* - Compiler: IAR EWAVR32 and GNU GCC for AVR32 | |
* - Supported devices: All AVR32 devices with a USB module can be used. | |
* - AppNote: | |
* | |
* \author Atmel Corporation: http://www.atmel.com \n | |
* Support and FAQ: http://support.atmel.no/ | |
* | |
***************************************************************************/ | |
/* Copyright (c) 2009 Atmel Corporation. All rights reserved. | |
* | |
* Redistribution and use in source and binary forms, with or without | |
* modification, are permitted provided that the following conditions are met: | |
* | |
* 1. Redistributions of source code must retain the above copyright notice, this | |
* list of conditions and the following disclaimer. | |
* | |
* 2. Redistributions in binary form must reproduce the above copyright notice, | |
* this list of conditions and the following disclaimer in the documentation | |
* and/or other materials provided with the distribution. | |
* | |
* 3. The name of Atmel may not be used to endorse or promote products derived | |
* from this software without specific prior written permission. | |
* | |
* 4. This software may only be redistributed and used in connection with an Atmel | |
* AVR product. | |
* | |
* THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR IMPLIED | |
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF | |
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE | |
* EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR | |
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE | |
* | |
*/ | |
#ifndef _USB_SPECIFIC_REQUEST_H_ | |
#define _USB_SPECIFIC_REQUEST_H_ | |
//_____ I N C L U D E S ____________________________________________________ | |
#include "conf_usb.h" | |
#if USB_DEVICE_FEATURE == DISABLED | |
#error usb_specific_request.h is #included although USB_DEVICE_FEATURE is disabled | |
#endif | |
//_____ M A C R O S ________________________________________________________ | |
//_____ D E F I N I T I O N S ______________________________________________ | |
extern const S_usb_device_descriptor usb_dev_desc; | |
extern const S_usb_device_qualifier_descriptor usb_qualifier_desc; | |
extern const S_usb_user_configuration_descriptor usb_conf_desc_fs; | |
extern const S_usb_user_configuration_descriptor usb_conf_desc_hs; | |
extern const S_usb_manufacturer_string_descriptor usb_user_manufacturer_string_descriptor; | |
extern const S_usb_product_string_descriptor usb_user_product_string_descriptor; | |
extern const S_usb_serial_number usb_user_serial_number; | |
extern const S_usb_language_id usb_user_language_id; | |
//! @defgroup specific_request USB device specific requests | |
//! @{ | |
//! @brief This function configures the endpoints of the device application. | |
//! This function is called when the set configuration request has been received. | |
//! | |
//! The core of this function should be correctly rewritten depending on the USB device | |
//! application characteristics (the USB device application has specific endpoints | |
//! configuration). | |
//! | |
extern void usb_user_endpoint_init(U8); | |
//! This function is called by the standard USB read request function when | |
//! the USB request is not supported. This function returns TRUE when the | |
//! request is processed. This function returns FALSE if the request is not | |
//! supported. In this case, a STALL handshake will be automatically | |
//! sent by the standard USB read request function. | |
//! | |
extern Bool usb_user_read_request(U8, U8); | |
extern Bool usb_user_get_descriptor(U8, U8); | |
//! @} | |
#endif // _USB_SPECIFIC_REQUEST_H_ |