]> git.sur5r.net Git - freertos/blob - Demo/Common/Minimal/flash.c
Small mods, and update file headers.
[freertos] / Demo / Common / Minimal / flash.c
1 /*\r
2         FreeRTOS.org V4.8.0 - Copyright (C) 2003-2008 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     ***************************************************************************\r
28     *                                                                         *\r
29     * SAVE TIME AND MONEY!  We can port FreeRTOS.org to your own hardware,    *\r
30     * and even write all or part of your application on your behalf.          *\r
31     * See http://www.OpenRTOS.com for details of the services we provide to   *\r
32     * expedite your project.                                                  *\r
33     *                                                                         *\r
34     ***************************************************************************\r
35     ***************************************************************************\r
36 \r
37         Please ensure to read the configuration and relevant port sections of the\r
38         online documentation.\r
39 \r
40         http://www.FreeRTOS.org - Documentation, latest information, license and \r
41         contact details.\r
42 \r
43         http://www.SafeRTOS.com - A version that is certified for use in safety \r
44         critical systems.\r
45 \r
46         http://www.OpenRTOS.com - Commercial support, development, porting, \r
47         licensing and training services.\r
48 */\r
49 \r
50 /**\r
51  * This version of flash .c is for use on systems that have limited stack space\r
52  * and no display facilities.  The complete version can be found in the \r
53  * Demo/Common/Full directory.\r
54  * \r
55  * Three tasks are created, each of which flash an LED at a different rate.  The first \r
56  * LED flashes every 200ms, the second every 400ms, the third every 600ms.\r
57  *\r
58  * The LED flash tasks provide instant visual feedback.  They show that the scheduler \r
59  * is still operational.\r
60  *\r
61  * The PC port uses the standard parallel port for outputs, the Flashlite 186 port \r
62  * uses IO port F and the AVR port port B.\r
63  *\r
64  */\r
65 \r
66 /*\r
67 Changes from V2.0.0\r
68 \r
69         + Delay periods are now specified using variables and constants of\r
70           portTickType rather than unsigned portLONG.\r
71 \r
72 Changes from V2.5.5\r
73 \r
74         + Calls to vTaskDelay() have been replaced with vTaskDelayUntil().\r
75 \r
76 */\r
77 \r
78 #include <stdlib.h>\r
79 \r
80 /* Scheduler include files. */\r
81 #include "FreeRTOS.h"\r
82 #include "task.h"\r
83 \r
84 /* Demo program include files. */\r
85 #include "partest.h"\r
86 #include "flash.h"\r
87 \r
88 #define ledSTACK_SIZE           configMINIMAL_STACK_SIZE\r
89 #define ledNUMBER_OF_LEDS       ( 3 )\r
90 #define ledFLASH_RATE_BASE      ( ( portTickType ) 333 )\r
91 \r
92 /* Variable used by the created tasks to calculate the LED number to use, and\r
93 the rate at which they should flash the LED. */\r
94 static volatile unsigned portBASE_TYPE uxFlashTaskNumber = 0;\r
95 \r
96 /* The task that is created three times. */\r
97 static portTASK_FUNCTION_PROTO( vLEDFlashTask, pvParameters );\r
98 \r
99 /*-----------------------------------------------------------*/\r
100 \r
101 void vStartLEDFlashTasks( unsigned portBASE_TYPE uxPriority )\r
102 {\r
103 signed portBASE_TYPE xLEDTask;\r
104 \r
105         /* Create the three tasks. */\r
106         for( xLEDTask = 0; xLEDTask < ledNUMBER_OF_LEDS; ++xLEDTask )\r
107         {\r
108                 /* Spawn the task. */\r
109                 xTaskCreate( vLEDFlashTask, ( signed portCHAR * ) "LEDx", ledSTACK_SIZE, NULL, uxPriority, ( xTaskHandle * ) NULL );\r
110         }\r
111 }\r
112 /*-----------------------------------------------------------*/\r
113 \r
114 static portTASK_FUNCTION( vLEDFlashTask, pvParameters )\r
115 {\r
116 portTickType xFlashRate, xLastFlashTime;\r
117 unsigned portBASE_TYPE uxLED;\r
118 \r
119         /* The parameters are not used. */\r
120         ( void ) pvParameters;\r
121 \r
122         /* Calculate the LED and flash rate. */\r
123         portENTER_CRITICAL();\r
124         {\r
125                 /* See which of the eight LED's we should use. */\r
126                 uxLED = uxFlashTaskNumber;\r
127 \r
128                 /* Update so the next task uses the next LED. */\r
129                 uxFlashTaskNumber++;\r
130         }\r
131         portEXIT_CRITICAL();\r
132 \r
133         xFlashRate = ledFLASH_RATE_BASE + ( ledFLASH_RATE_BASE * ( portTickType ) uxLED );\r
134         xFlashRate /= portTICK_RATE_MS;\r
135 \r
136         /* We will turn the LED on and off again in the delay period, so each\r
137         delay is only half the total period. */\r
138         xFlashRate /= ( portTickType ) 2;\r
139 \r
140         /* We need to initialise xLastFlashTime prior to the first call to \r
141         vTaskDelayUntil(). */\r
142         xLastFlashTime = xTaskGetTickCount();\r
143 \r
144         for(;;)\r
145         {\r
146                 /* Delay for half the flash period then turn the LED on. */\r
147                 vTaskDelayUntil( &xLastFlashTime, xFlashRate );\r
148                 vParTestToggleLED( uxLED );\r
149 \r
150                 /* Delay for half the flash period then turn the LED off. */\r
151                 vTaskDelayUntil( &xLastFlashTime, xFlashRate );\r
152                 vParTestToggleLED( uxLED );\r
153         }\r
154 } /*lint !e715 !e818 !e830 Function definition must be standard for task creation. */\r
155 \r