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 * Implementation of a single CDC EEM port function for USB device. 00032 */ 00033 00034 /** \addtogroup usbd_cdc 00035 *@{ 00036 */ 00037 00038 /*------------------------------------------------------------------------------ 00039 * Headers 00040 *------------------------------------------------------------------------------*/ 00041 00042 #include "CDCDEEM.h" 00043 00044 #include <USBLib_Trace.h> 00045 #include <USBDDriver.h> 00046 #include <USBD_HAL.h> 00047 00048 /*------------------------------------------------------------------------------ 00049 * Types 00050 *------------------------------------------------------------------------------*/ 00051 00052 /*------------------------------------------------------------------------------ 00053 * Internal variables 00054 *------------------------------------------------------------------------------*/ 00055 00056 /** EEM Port instance list */ 00057 static CDCDEEMPort cdcdEEM; 00058 00059 /*------------------------------------------------------------------------------ 00060 * Internal functions 00061 *------------------------------------------------------------------------------*/ 00062 00063 /*------------------------------------------------------------------------------ 00064 * Exported functions 00065 *------------------------------------------------------------------------------*/ 00066 00067 /** 00068 * Initializes the USB Device CDC serial driver & USBD Driver. 00069 * \param pUsbd Pointer to USBDDriver instance. 00070 * \param bInterfaceNb Interface number for the function. 00071 */ 00072 void CDCDEEM_Initialize( 00073 USBDDriver *pUsbd, uint8_t bInterfaceNb) 00074 { 00075 CDCDEEMPort *pCdcd = &cdcdEEM; 00076 00077 TRACE_INFO("CDCDEEM_Initialize\n\r"); 00078 00079 /* Initialize serial port function */ 00080 CDCDEEMPort_Initialize( 00081 pCdcd, pUsbd, 00082 bInterfaceNb, 2); 00083 } 00084 00085 /** 00086 * Invoked whenever the device is changed by the 00087 * host. 00088 * \pDescriptors Pointer to the descriptors for function configure. 00089 * \wLength Length of descriptors in number of bytes. 00090 */ 00091 void CDCDEEM_ConfigureFunction(USBGenericDescriptor *pDescriptors, 00092 uint16_t wLength) 00093 { 00094 CDCDEEMPort *pCdcd = &cdcdEEM; 00095 CDCDEEMPort_ParseInterfaces(pCdcd, 00096 (USBGenericDescriptor*)pDescriptors, 00097 wLength); 00098 } 00099 00100 /** 00101 * Handles CDC-specific SETUP requests. Should be called from a 00102 * re-implementation of USBDCallbacks_RequestReceived() method. 00103 * \param request Pointer to a USBGenericRequest instance. 00104 */ 00105 uint32_t CDCDEEM_RequestHandler(const USBGenericRequest *request) 00106 { 00107 CDCDEEMPort * pCdcd = &cdcdEEM; 00108 00109 TRACE_INFO_WP("Cdcf "); 00110 return CDCDEEMPort_RequestHandler(pCdcd, request); 00111 } 00112 00113 /** 00114 * Receives data from the host through the virtual COM port created by 00115 * the CDC device serial driver. This function behaves like USBD_Read. 00116 * \param data Pointer to the data buffer to put received data. 00117 * \param size Size of the data buffer in bytes. 00118 * \param callback Optional callback function to invoke when the transfer 00119 * finishes. 00120 * \param argument Optional argument to the callback function. 00121 * \return USBD_STATUS_SUCCESS if the read operation has been started normally; 00122 * otherwise, the corresponding error code. 00123 */ 00124 uint32_t CDCDEEM_Read(void *data, 00125 uint32_t size, 00126 TransferCallback callback, 00127 void *argument) 00128 { 00129 CDCDEEMPort * pCdcd = &cdcdEEM; 00130 return CDCDEEMPort_Read(pCdcd, data, size, callback, argument); 00131 } 00132 00133 /** 00134 * Sends a data buffer through the virtual COM port created by the CDC 00135 * device serial driver. This function behaves exactly like USBD_Write. 00136 * \param data Pointer to the data buffer to send. 00137 * \param size Size of the data buffer in bytes. 00138 * \param callback Optional callback function to invoke when the transfer 00139 * finishes. 00140 * \param argument Optional argument to the callback function. 00141 * \return USBD_STATUS_SUCCESS if the read operation has been started normally; 00142 * otherwise, the corresponding error code. 00143 */ 00144 uint32_t CDCDEEM_Write(void *data, 00145 uint32_t size, 00146 TransferCallback callback, 00147 void *argument) 00148 { 00149 CDCDEEMPort * pCdcd = &cdcdEEM; 00150 return CDCDEEMPort_Write(pCdcd, data, size, callback, argument); 00151 } 00152 00153 /**@}*/