git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/WIN32-MSVC-lwIP/lwIP_Apps/lwIP_Apps.c

   1 /*\r
   2     FreeRTOS V7.0.2 - Copyright (C) 2011 Real Time Engineers Ltd.\r
   3         \r
   4 \r
   5     ***************************************************************************\r
   6      *                                                                       *\r
   7      *    FreeRTOS tutorial books are available in pdf and paperback.        *\r
   8      *    Complete, revised, and edited pdf reference manuals are also       *\r
   9      *    available.                                                         *\r
  10      *                                                                       *\r
  11      *    Purchasing FreeRTOS documentation will not only help you, by       *\r
  12      *    ensuring you get running as quickly as possible and with an        *\r
  13      *    in-depth knowledge of how to use FreeRTOS, it will also help       *\r
  14      *    the FreeRTOS project to continue with its mission of providing     *\r
  15      *    professional grade, cross platform, de facto standard solutions    *\r
  16      *    for microcontrollers - completely free of charge!                  *\r
  17      *                                                                       *\r
  18      *    >>> See http://www.FreeRTOS.org/Documentation for details. <<<     *\r
  19      *                                                                       *\r
  20      *    Thank you for using FreeRTOS, and thank you for your support!      *\r
  21      *                                                                       *\r
  22     ***************************************************************************\r
  23 \r
  24 \r
  25     This file is part of the FreeRTOS distribution.\r
  26 \r
  27     FreeRTOS is free software; you can redistribute it and/or modify it under\r
  28     the terms of the GNU General Public License (version 2) as published by the\r
  29     Free Software Foundation AND MODIFIED BY the FreeRTOS exception.\r
  30     >>>NOTE<<< The modification to the GPL is included to allow you to\r
  31     distribute a combined work that includes FreeRTOS without being obliged to\r
  32     provide the source code for proprietary components outside of the FreeRTOS\r
  33     kernel.  FreeRTOS is distributed in the hope that it will be useful, but\r
  34     WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY\r
  35     or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for\r
  36     more details. You should have received a copy of the GNU General Public\r
  37     License and the FreeRTOS license exception along with FreeRTOS; if not it\r
  38     can be viewed here: http://www.freertos.org/a00114.html and also obtained\r
  39     by writing to Richard Barry, contact details for whom are available on the\r
  40     FreeRTOS WEB site.\r
  41 \r
  42     1 tab == 4 spaces!\r
  43 \r
  44     http://www.FreeRTOS.org - Documentation, latest information, license and\r
  45     contact details.\r
  46 \r
  47     http://www.SafeRTOS.com - A version that is certified for use in safety\r
  48     critical systems.\r
  49 \r
  50     http://www.OpenRTOS.com - Commercial support, development, porting,\r
  51     licensing and training services.\r
  52 */\r
  53 \r
  54 #include "FreeRTOS.h"\r
  55 #include "task.h"\r
  56 #include "semphr.h"\r
  57 \r
  58 /* lwIP core includes */\r
  59 #include "lwip/opt.h"\r
  60 #include "lwip/tcpip.h"\r
  61 \r
  62 /* applications includes */\r
  63 #include "apps/httpserver_raw_from_lwIP_download/httpd.h"\r
  64 \r
  65 /* include the port-dependent configuration */\r
  66 #include "lwipcfg_msvc.h"\r
  67 \r
  68 /* Dimensions the cTxBuffer array - which is itself used to hold replies from \r
  69 command line commands.  cTxBuffer is a shared buffer, so protected by the \r
  70 xTxBufferMutex mutex. */\r
  71 #define lwipappsTX_BUFFER_SIZE  1024\r
  72 \r
  73 /* The maximum time to block waiting to obtain the xTxBufferMutex to become\r
  74 available. */\r
  75 #define lwipappsMAX_TIME_TO_WAIT_FOR_TX_BUFFER_MS       ( 100 / portTICK_RATE_MS )\r
  76 \r
  77 /* Definitions of the various SSI callback functions within the pccSSITags \r
  78 array.  If pccSSITags is updated, then these definitions must also be updated. */\r
  79 #define ssiTASK_STATS_INDEX                     0\r
  80 #define ssiRUN_TIME_STATS_INDEX         1\r
  81 \r
  82 /*-----------------------------------------------------------*/\r
  83 \r
  84 /*\r
  85  * The function that implements the lwIP based sockets command interpreter\r
  86  * server.\r
  87  */\r
  88 extern void vBasicSocketsCommandInterpreterTask( void *pvParameters );\r
  89 \r
  90 /*\r
  91  * The SSI handler callback function passed to lwIP.\r
  92  */\r
  93 static unsigned short uslwIPAppsSSIHandler( int iIndex, char *pcBuffer, int iBufferLength );\r
  94 \r
  95 /*-----------------------------------------------------------*/\r
  96 \r
  97 /* The SSI strings that are embedded in the served html files.  If this array\r
  98 is changed, then the index position defined by the #defines such as \r
  99 ssiTASK_STATS_INDEX above must also be updated. */\r
 100 static const char *pccSSITags[] = \r
 101 {\r
 102         "rtos_stats",\r
 103         "run_stats"\r
 104 };\r
 105 \r
 106 /* Semaphore used to guard the Tx buffer. */\r
 107 static xSemaphoreHandle xTxBufferMutex = NULL;\r
 108 \r
 109 /* The Tx buffer itself.  This is used to hold the text generated by the \r
 110 execution of command line commands, and (hopefully) the execution of \r
 111 server side include callbacks.  It is a shared buffer so protected by the\r
 112 xTxBufferMutex mutex.  pcLwipAppsBlockingGetTxBuffer() and \r
 113 vLwipAppsReleaseTxBuffer() are provided to obtain and release the \r
 114 xTxBufferMutex respectively.  pcLwipAppsBlockingGetTxBuffer() must be used with\r
 115 caution as it has the potential to block. */\r
 116 static signed char cTxBuffer[ lwipappsTX_BUFFER_SIZE ];\r
 117 \r
 118 /*-----------------------------------------------------------*/\r
 119 \r
 120 \r
 121 /* Called from the TCP/IP thread. */\r
 122 void lwIPAppsInit( void *pvArgument )\r
 123 {\r
 124 ip_addr_t xIPAddr, xNetMask, xGateway;\r
 125 extern err_t ethernetif_init( struct netif *xNetIf );\r
 126 static struct netif xNetIf;\r
 127 \r
 128         ( void ) pvArgument;\r
 129 \r
 130         /* Set up the network interface. */\r
 131         ip_addr_set_zero( &xGateway );\r
 132         ip_addr_set_zero( &xIPAddr );\r
 133         ip_addr_set_zero( &xNetMask );\r
 134 \r
 135         LWIP_PORT_INIT_GW(&xGateway);\r
 136         LWIP_PORT_INIT_IPADDR(&xIPAddr);\r
 137         LWIP_PORT_INIT_NETMASK(&xNetMask);\r
 138         printf("Starting lwIP, local interface IP is %s\n", ip_ntoa(&xIPAddr));\r
 139 \r
 140         netif_set_default( netif_add( &xNetIf, &xIPAddr, &xNetMask, &xGateway, NULL, ethernetif_init, tcpip_input ) );\r
 141         netif_set_up( &xNetIf );\r
 142 \r
 143         /* Install the server side include handler. */\r
 144         http_set_ssi_handler( uslwIPAppsSSIHandler, pccSSITags, sizeof( pccSSITags ) / sizeof( char * ) );\r
 145 \r
 146         /* Create the mutex used to ensure mutual exclusive access to the Tx \r
 147         buffer. */\r
 148         xTxBufferMutex = xSemaphoreCreateMutex();\r
 149         configASSERT( xTxBufferMutex );\r
 150 \r
 151         /* Create the httpd server from the standard lwIP code.  This demonstrates\r
 152         use of the lwIP raw API. */\r
 153         httpd_init();\r
 154 \r
 155         /* Create the FreeRTOS defined basic command server.  This demonstrates use\r
 156         of the lwIP sockets API. */\r
 157         xTaskCreate( vBasicSocketsCommandInterpreterTask, ( signed char * ) "CmdInt", configMINIMAL_STACK_SIZE * 10, NULL, configMAX_PRIORITIES - 2, NULL );\r
 158 }\r
 159 /*-----------------------------------------------------------*/\r
 160 \r
 161 static unsigned short uslwIPAppsSSIHandler( int iIndex, char *pcBuffer, int iBufferLength )\r
 162 {\r
 163 static unsigned int uiUpdateCount = 0;\r
 164 static char cUpdateString[ 200 ];\r
 165 extern char *pcMainGetTaskStatusMessage( void );\r
 166 \r
 167         /* Unused parameter. */\r
 168         ( void ) iBufferLength;\r
 169 \r
 170         /* The SSI handler function that generates text depending on the index of\r
 171         the SSI tag encountered. */\r
 172         \r
 173         switch( iIndex )\r
 174         {\r
 175                 case ssiTASK_STATS_INDEX :\r
 176                         vTaskList( ( signed char * ) pcBuffer );\r
 177                         break;\r
 178 \r
 179                 case ssiRUN_TIME_STATS_INDEX :\r
 180                         vTaskGetRunTimeStats( ( signed char * ) pcBuffer );\r
 181                         break;\r
 182         }\r
 183 \r
 184         /* Include a count of the number of times an SSI function has been executed\r
 185         in the returned string. */\r
 186         uiUpdateCount++;\r
 187         sprintf( cUpdateString, "\r\n\r\n%u\r\nStatus - %s", uiUpdateCount, pcMainGetTaskStatusMessage() );\r
 188         strcat( pcBuffer, cUpdateString );\r
 189 \r
 190         return strlen( pcBuffer );\r
 191 }\r
 192 /*-----------------------------------------------------------*/\r
 193 \r
 194 signed char *pcLwipAppsBlockingGetTxBuffer( void )\r
 195 {\r
 196 signed char *pcReturn;\r
 197 \r
 198         /* Attempt to obtain the semaphore that guards the Tx buffer. */\r
 199         if( xSemaphoreTakeRecursive( xTxBufferMutex, lwipappsMAX_TIME_TO_WAIT_FOR_TX_BUFFER_MS ) == pdFAIL )\r
 200         {\r
 201                 /* The semaphore could not be obtained before timing out. */\r
 202                 pcReturn = NULL;\r
 203         }\r
 204         else\r
 205         {\r
 206                 /* The semaphore was obtained successfully.  Return a pointer to the\r
 207                 Tx buffer. */\r
 208                 pcReturn = cTxBuffer;\r
 209         }\r
 210 \r
 211         return pcReturn;\r
 212 }\r
 213 /*-----------------------------------------------------------*/\r
 214 \r
 215 void vLwipAppsReleaseTxBuffer( void )\r
 216 {\r
 217         /* Finished with the Tx buffer.  Return the mutex. */\r
 218         xSemaphoreGiveRecursive( xTxBufferMutex );\r
 219 }\r
 220 \r
 221 \r
 222 \r