git.sur5r.net Git - freertos/blob - Demo/Common/Minimal/flash.c

   1 /*\r
   2         FreeRTOS.org V4.6.0 - Copyright (C) 2003-2007 Richard Barry.\r
   3 \r
   4         This file is part of the FreeRTOS.org distribution.\r
   5 \r
   6         FreeRTOS.org is free software; you can redistribute it and/or modify\r
   7         it under the terms of the GNU General Public License as published by\r
   8         the Free Software Foundation; either version 2 of the License, or\r
   9         (at your option) any later version.\r
  10 \r
  11         FreeRTOS.org is distributed in the hope that it will be useful,\r
  12         but WITHOUT ANY WARRANTY; without even the implied warranty of\r
  13         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\r
  14         GNU General Public License for more details.\r
  15 \r
  16         You should have received a copy of the GNU General Public License\r
  17         along with FreeRTOS.org; if not, write to the Free Software\r
  18         Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA\r
  19 \r
  20         A special exception to the GPL can be applied should you wish to distribute\r
  21         a combined work that includes FreeRTOS.org, without being obliged to provide\r
  22         the source code for any proprietary components.  See the licensing section \r
  23         of http://www.FreeRTOS.org for full details of how and when the exception\r
  24         can be applied.\r
  25 \r
  26         ***************************************************************************\r
  27         See http://www.FreeRTOS.org for documentation, latest information, license \r
  28         and contact details.  Please ensure to read the configuration and relevant \r
  29         port sections of the online documentation.\r
  30 \r
  31         Also see http://www.SafeRTOS.com for an IEC 61508 compliant version along\r
  32         with commercial development and support options.\r
  33         ***************************************************************************\r
  34 */\r
  35 \r
  36 /**\r
  37  * This version of flash .c is for use on systems that have limited stack space\r
  38  * and no display facilities.  The complete version can be found in the \r
  39  * Demo/Common/Full directory.\r
  40  * \r
  41  * Three tasks are created, each of which flash an LED at a different rate.  The first \r
  42  * LED flashes every 200ms, the second every 400ms, the third every 600ms.\r
  43  *\r
  44  * The LED flash tasks provide instant visual feedback.  They show that the scheduler \r
  45  * is still operational.\r
  46  *\r
  47  * The PC port uses the standard parallel port for outputs, the Flashlite 186 port \r
  48  * uses IO port F and the AVR port port B.\r
  49  *\r
  50  */\r
  51 \r
  52 /*\r
  53 Changes from V2.0.0\r
  54 \r
  55         + Delay periods are now specified using variables and constants of\r
  56           portTickType rather than unsigned portLONG.\r
  57 \r
  58 Changes from V2.5.5\r
  59 \r
  60         + Calls to vTaskDelay() have been replaced with vTaskDelayUntil().\r
  61 \r
  62 */\r
  63 \r
  64 #include <stdlib.h>\r
  65 \r
  66 /* Scheduler include files. */\r
  67 #include "FreeRTOS.h"\r
  68 #include "task.h"\r
  69 \r
  70 /* Demo program include files. */\r
  71 #include "partest.h"\r
  72 #include "flash.h"\r
  73 \r
  74 #define ledSTACK_SIZE           configMINIMAL_STACK_SIZE\r
  75 #define ledNUMBER_OF_LEDS       ( 3 )\r
  76 #define ledFLASH_RATE_BASE      ( ( portTickType ) 333 )\r
  77 \r
  78 /* Variable used by the created tasks to calculate the LED number to use, and\r
  79 the rate at which they should flash the LED. */\r
  80 static volatile unsigned portBASE_TYPE uxFlashTaskNumber = 0;\r
  81 \r
  82 /* The task that is created three times. */\r
  83 static portTASK_FUNCTION_PROTO( vLEDFlashTask, pvParameters );\r
  84 \r
  85 /*-----------------------------------------------------------*/\r
  86 \r
  87 void vStartLEDFlashTasks( unsigned portBASE_TYPE uxPriority )\r
  88 {\r
  89 signed portBASE_TYPE xLEDTask;\r
  90 \r
  91         /* Create the three tasks. */\r
  92         for( xLEDTask = 0; xLEDTask < ledNUMBER_OF_LEDS; ++xLEDTask )\r
  93         {\r
  94                 /* Spawn the task. */\r
  95                 xTaskCreate( vLEDFlashTask, ( const signed portCHAR * const ) "LEDx", ledSTACK_SIZE, NULL, uxPriority, ( xTaskHandle * ) NULL );\r
  96         }\r
  97 }\r
  98 /*-----------------------------------------------------------*/\r
  99 \r
 100 static portTASK_FUNCTION( vLEDFlashTask, pvParameters )\r
 101 {\r
 102 portTickType xFlashRate, xLastFlashTime;\r
 103 unsigned portBASE_TYPE uxLED;\r
 104 \r
 105         /* The parameters are not used. */\r
 106         ( void ) pvParameters;\r
 107 \r
 108         /* Calculate the LED and flash rate. */\r
 109         portENTER_CRITICAL();\r
 110         {\r
 111                 /* See which of the eight LED's we should use. */\r
 112                 uxLED = uxFlashTaskNumber;\r
 113 \r
 114                 /* Update so the next task uses the next LED. */\r
 115                 uxFlashTaskNumber++;\r
 116         }\r
 117         portEXIT_CRITICAL();\r
 118 \r
 119         xFlashRate = ledFLASH_RATE_BASE + ( ledFLASH_RATE_BASE * ( portTickType ) uxLED );\r
 120         xFlashRate /= portTICK_RATE_MS;\r
 121 \r
 122         /* We will turn the LED on and off again in the delay period, so each\r
 123         delay is only half the total period. */\r
 124         xFlashRate /= ( portTickType ) 2;\r
 125 \r
 126         /* We need to initialise xLastFlashTime prior to the first call to \r
 127         vTaskDelayUntil(). */\r
 128         xLastFlashTime = xTaskGetTickCount();\r
 129 \r
 130         for(;;)\r
 131         {\r
 132                 /* Delay for half the flash period then turn the LED on. */\r
 133                 vTaskDelayUntil( &xLastFlashTime, xFlashRate );\r
 134                 vParTestToggleLED( uxLED );\r
 135 \r
 136                 /* Delay for half the flash period then turn the LED off. */\r
 137                 vTaskDelayUntil( &xLastFlashTime, xFlashRate );\r
 138                 vParTestToggleLED( uxLED );\r
 139         }\r
 140 } /*lint !e715 !e818 !e830 Function definition must be standard for task creation. */\r
 141 \r