]> git.sur5r.net Git - freertos/blob - Demo/Common/Minimal/flash.c
Change comments only.
[freertos] / Demo / Common / Minimal / flash.c
1 /*\r
2         FreeRTOS.org V5.0.3 - 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  */\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, ( signed portCHAR * ) "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