git.sur5r.net Git - freertos/blob

   1 /*\r
   2  * FreeRTOS+UDP V1.0.0 (C) 2013 Real Time Engineers ltd.\r
   3  *\r
   4  * This file is part of the FreeRTOS+UDP distribution.  The FreeRTOS+UDP license\r
   5  * terms are different to the FreeRTOS license terms.\r
   6  *\r
   7  * FreeRTOS+UDP uses a dual license model that allows the software to be used\r
   8  * under a standard GPL open source license, or a commercial license.  The\r
   9  * standard GPL license (unlike the modified GPL license under which FreeRTOS\r
  10  * itself is distributed) requires that all software statically linked with\r
  11  * FreeRTOS+UDP is also distributed under the same GPL V2 license terms.\r
  12  * Details of both license options follow:\r
  13  *\r
  14  * - Open source licensing -\r
  15  * FreeRTOS+UDP is a free download and may be used, modified, evaluated and\r
  16  * distributed without charge provided the user adheres to version two of the\r
  17  * GNU General Public License (GPL) and does not remove the copyright notice or\r
  18  * this text.  The GPL V2 text is available on the gnu.org web site, and on the\r
  19  * following URL: http://www.FreeRTOS.org/gpl-2.0.txt.\r
  20  *\r
  21  * - Commercial licensing -\r
  22  * Businesses and individuals that for commercial or other reasons cannot comply\r
  23  * with the terms of the GPL V2 license must obtain a commercial license before\r
  24  * incorporating FreeRTOS+UDP into proprietary software for distribution in any\r
  25  * form.  Commercial licenses can be purchased from http://shop.freertos.org/udp\r
  26  * and do not require any source files to be changed.\r
  27  *\r
  28  * FreeRTOS+UDP is distributed in the hope that it will be useful.  You cannot\r
  29  * use FreeRTOS+UDP unless you agree that you use the software 'as is'.\r
  30  * FreeRTOS+UDP is provided WITHOUT ANY WARRANTY; without even the implied\r
  31  * warranties of NON-INFRINGEMENT, MERCHANTABILITY or FITNESS FOR A PARTICULAR\r
  32  * PURPOSE. Real Time Engineers Ltd. disclaims all conditions and terms, be they\r
  33  * implied, expressed, or statutory.\r
  34  *\r
  35  * 1 tab == 4 spaces!\r
  36  *\r
  37  * http://www.FreeRTOS.org\r
  38  * http://www.FreeRTOS.org/udp\r
  39  *\r
  40  */\r
  41 \r
  42 #ifndef LPC18xx_43xx_EMAC_H\r
  43 #define LPC18xx_43xx_EMAC_H\r
  44 \r
  45 /*\r
  46  * Initialise the MAC and PHY.\r
  47  */\r
  48 portBASE_TYPE xEMACInit( uint8_t ucMACAddress[ 6 ] );\r
  49 \r
  50 /*\r
  51  * Return pdTRUE if there is a FreeRTOS Tx descriptor.  Return pdFALSE if all\r
  52  * Tx descriptors are already in use.\r
  53  */\r
  54 portBASE_TYPE xEMACIsTxDescriptorAvailable( void );\r
  55 \r
  56 /*\r
  57  * Assign a buffer to a Tx descriptor so it is ready to be transmitted, but\r
  58  * don't start the transmission yet.\r
  59  */\r
  60 void vEMACAssignBufferToDescriptor( uint8_t * pucBuffer );\r
  61 \r
  62 /*\r
  63  * Start transmitting the buffer pointed to by the next Tx descriptor.  The\r
  64  * buffer must have first been allocated to the Tx descriptor using a call to\r
  65  * vEMACAssignBufferToDescriptor().\r
  66  */\r
  67 void vEMACStartNextTransmission( uint32_t ulLength );\r
  68 \r
  69 /*\r
  70  * The data pointed to by the Rx descriptor has been consumed, and the Rx\r
  71  * descriptor can be returned to the control of the DMS.\r
  72  */\r
  73 void vEMACReturnRxDescriptor( void );\r
  74 \r
  75 /*\r
  76  * Returns pdTRUE if the next Rx descriptor contains received data.  Returns\r
  77  * pdFLASE fi the next Rx descriptor is still under the control of the DMA.\r
  78  */\r
  79 portBASE_TYPE xEMACRxDataAvailable( void );\r
  80 void vEMACSwapEmptyBufferForRxedData( xNetworkBufferDescriptor_t *pxNetworkBuffer );\r
  81 \r
  82 #endif /* LPC18xx_43xx_EMAC_H */\r
  83 \r