2 FreeRTOS V7.0.1 - Copyright (C) 2011 Real Time Engineers Ltd.
\r
5 ***************************************************************************
\r
7 * FreeRTOS tutorial books are available in pdf and paperback. *
\r
8 * Complete, revised, and edited pdf reference manuals are also *
\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
18 * >>> See http://www.FreeRTOS.org/Documentation for details. <<< *
\r
20 * Thank you for using FreeRTOS, and thank you for your support! *
\r
22 ***************************************************************************
\r
25 This file is part of the FreeRTOS distribution.
\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
44 http://www.FreeRTOS.org - Documentation, latest information, license and
\r
47 http://www.SafeRTOS.com - A version that is certified for use in safety
\r
50 http://www.OpenRTOS.com - Commercial support, development, porting,
\r
51 licensing and training services.
\r
56 * Creates all the demo application tasks, then starts the scheduler. The WEB
\r
57 * documentation provides more details of the standard demo application tasks
\r
58 * (which just exist to test the kernel port and provide an example of how to use
\r
59 * each FreeRTOS API function).
\r
61 * In addition to the standard demo tasks, the following tasks and tests are
\r
62 * defined and/or created within this file:
\r
64 * "Check" hook - This only executes fully every five seconds from the tick
\r
65 * hook. Its main function is to check that all the standard demo tasks are
\r
66 * still operational. The status can be viewed using on the Task Stats page
\r
67 * served by the WEB server.
\r
69 * "uIP" task - This is the task that handles the uIP stack. All TCP/IP
\r
70 * processing is performed in this task.
\r
72 * "USB" task - Enumerates the USB device as a CDC class, then echoes back all
\r
73 * received characters with a configurable offset (for example, if the offset
\r
74 * is 1 and 'A' is received then 'B' will be sent back). A dumb terminal such
\r
75 * as Hyperterminal can be used to talk to the USB task.
\r
78 /* Scheduler includes. */
\r
79 #include "FreeRTOS.h"
\r
82 /* Demo app includes. */
\r
84 #include "integer.h"
\r
85 #include "blocktim.h"
\r
87 #include "partest.h"
\r
88 #include "semtest.h"
\r
90 #include "GenQTest.h"
\r
92 #include "recmutex.h"
\r
94 /*-----------------------------------------------------------*/
\r
96 /* The time between cycles of the 'check' functionality (defined within the
\r
98 #define mainCHECK_DELAY ( ( portTickType ) 5000 / portTICK_RATE_MS )
\r
100 /* Task priorities. */
\r
101 #define mainQUEUE_POLL_PRIORITY ( tskIDLE_PRIORITY + 2 )
\r
102 #define mainSEM_TEST_PRIORITY ( tskIDLE_PRIORITY + 1 )
\r
103 #define mainBLOCK_Q_PRIORITY ( tskIDLE_PRIORITY + 2 )
\r
104 #define mainUIP_TASK_PRIORITY ( tskIDLE_PRIORITY + 3 )
\r
105 #define mainINTEGER_TASK_PRIORITY ( tskIDLE_PRIORITY )
\r
106 #define mainGEN_QUEUE_TASK_PRIORITY ( tskIDLE_PRIORITY )
\r
107 #define mainFLASH_TASK_PRIORITY ( tskIDLE_PRIORITY + 2 )
\r
109 /* The WEB server has a larger stack as it utilises stack hungry string
\r
110 handling library calls. */
\r
111 #define mainBASIC_WEB_STACK_SIZE ( configMINIMAL_STACK_SIZE * 4 )
\r
113 /* The message displayed by the WEB server when all tasks are executing
\r
114 without an error being reported. */
\r
115 #define mainPASS_STATUS_MESSAGE "All tasks are executing without error."
\r
117 /*-----------------------------------------------------------*/
\r
120 * Configure the hardware for the demo.
\r
122 static void prvSetupHardware( void );
\r
125 * The task that handles the uIP stack. All TCP/IP processing is performed in
\r
128 extern void vuIP_Task( void *pvParameters );
\r
131 * The task that handles the USB stack.
\r
133 extern void vUSBTask( void *pvParameters );
\r
136 * Simply returns the current status message for display on served WEB pages.
\r
138 char *pcGetTaskStatusMessage( void );
\r
140 /*-----------------------------------------------------------*/
\r
142 /* Holds the status message displayed by the WEB server. */
\r
143 static char *pcStatusMessage = mainPASS_STATUS_MESSAGE;
\r
145 /*-----------------------------------------------------------*/
\r
149 /* Configure the hardware for use by this demo. */
\r
150 prvSetupHardware();
\r
152 /* Start the standard demo tasks. These are just here to exercise the
\r
153 kernel port and provide examples of how the FreeRTOS API can be used. */
\r
154 vStartBlockingQueueTasks( mainBLOCK_Q_PRIORITY );
\r
155 vCreateBlockTimeTasks();
\r
156 vStartSemaphoreTasks( mainSEM_TEST_PRIORITY );
\r
157 vStartPolledQueueTasks( mainQUEUE_POLL_PRIORITY );
\r
158 vStartIntegerMathTasks( mainINTEGER_TASK_PRIORITY );
\r
159 vStartGenericQueueTasks( mainGEN_QUEUE_TASK_PRIORITY );
\r
160 vStartQueuePeekTasks();
\r
161 vStartRecursiveMutexTasks();
\r
162 vStartLEDFlashTasks( mainFLASH_TASK_PRIORITY );
\r
164 /* Create the USB task. */
\r
165 xTaskCreate( vUSBTask, ( signed char * ) "USB", configMINIMAL_STACK_SIZE, ( void * ) NULL, tskIDLE_PRIORITY, NULL );
\r
167 /* Create the uIP task. The WEB server runs in this task. */
\r
168 xTaskCreate( vuIP_Task, ( signed char * ) "uIP", mainBASIC_WEB_STACK_SIZE, ( void * ) NULL, mainUIP_TASK_PRIORITY, NULL );
\r
170 /* Start the scheduler. */
\r
171 vTaskStartScheduler();
\r
173 /* Will only get here if there was insufficient memory to create the idle
\r
174 task. The idle task is created within vTaskStartScheduler(). */
\r
177 /*-----------------------------------------------------------*/
\r
179 void vApplicationTickHook( void )
\r
181 static unsigned long ulTicksSinceLastDisplay = 0;
\r
183 /* Called from every tick interrupt as described in the comments at the top
\r
186 Have enough ticks passed to make it time to perform our health status
\r
188 ulTicksSinceLastDisplay++;
\r
189 if( ulTicksSinceLastDisplay >= mainCHECK_DELAY )
\r
191 /* Reset the counter so these checks run again in mainCHECK_DELAY
\r
193 ulTicksSinceLastDisplay = 0;
\r
195 /* Has an error been found in any task? */
\r
196 if( xAreGenericQueueTasksStillRunning() != pdTRUE )
\r
198 pcStatusMessage = "An error has been detected in the Generic Queue test/demo.";
\r
200 else if( xAreQueuePeekTasksStillRunning() != pdTRUE )
\r
202 pcStatusMessage = "An error has been detected in the Peek Queue test/demo.";
\r
204 else if( xAreBlockingQueuesStillRunning() != pdTRUE )
\r
206 pcStatusMessage = "An error has been detected in the Block Queue test/demo.";
\r
208 else if( xAreBlockTimeTestTasksStillRunning() != pdTRUE )
\r
210 pcStatusMessage = "An error has been detected in the Block Time test/demo.";
\r
212 else if( xAreSemaphoreTasksStillRunning() != pdTRUE )
\r
214 pcStatusMessage = "An error has been detected in the Semaphore test/demo.";
\r
216 else if( xArePollingQueuesStillRunning() != pdTRUE )
\r
218 pcStatusMessage = "An error has been detected in the Poll Queue test/demo.";
\r
220 else if( xAreIntegerMathsTaskStillRunning() != pdTRUE )
\r
222 pcStatusMessage = "An error has been detected in the Int Math test/demo.";
\r
224 else if( xAreRecursiveMutexTasksStillRunning() != pdTRUE )
\r
226 pcStatusMessage = "An error has been detected in the Mutex test/demo.";
\r
230 /*-----------------------------------------------------------*/
\r
232 char *pcGetTaskStatusMessage( void )
\r
234 /* Not bothered about a critical section here. */
\r
235 return pcStatusMessage;
\r
237 /*-----------------------------------------------------------*/
\r
239 void prvSetupHardware( void )
\r
241 /* Disable peripherals power. */
\r
244 /* Enable GPIO power. */
\r
245 SC->PCONP = PCONP_PCGPIO;
\r
247 /* Disable TPIU. */
\r
248 PINCON->PINSEL10 = 0;
\r
250 /* Setup the peripheral bus to be the same as the PLL output (64 MHz). */
\r
251 SC->PCLKSEL0 = 0x05555555;
\r
253 /* Configure the LEDs. */
\r
254 vParTestInitialise();
\r
256 /*-----------------------------------------------------------*/
\r
258 void vApplicationStackOverflowHook( xTaskHandle *pxTask, signed char *pcTaskName )
\r
260 /* This function will get called if a task overflows its stack. */
\r
263 ( void ) pcTaskName;
\r
267 /*-----------------------------------------------------------*/
\r
269 void vConfigureTimerForRunTimeStats( void )
\r
271 const unsigned long TCR_COUNT_RESET = 2, CTCR_CTM_TIMER = 0x00, TCR_COUNT_ENABLE = 0x01;
\r
273 /* This function configures a timer that is used as the time base when
\r
274 collecting run time statistical information - basically the percentage
\r
275 of CPU time that each task is utilising. It is called automatically when
\r
276 the scheduler is started (assuming configGENERATE_RUN_TIME_STATS is set
\r
279 /* Power up and feed the timer. */
\r
280 SC->PCONP |= 0x02UL;
\r
281 SC->PCLKSEL0 = (SC->PCLKSEL0 & (~(0x3<<2))) | (0x01 << 2);
\r
283 /* Reset Timer 0 */
\r
284 TIM0->TCR = TCR_COUNT_RESET;
\r
286 /* Just count up. */
\r
287 TIM0->CTCR = CTCR_CTM_TIMER;
\r
289 /* Prescale to a frequency that is good enough to get a decent resolution,
\r
290 but not too fast so as to overflow all the time. */
\r
291 TIM0->PR = ( configCPU_CLOCK_HZ / 10000UL ) - 1UL;
\r
293 /* Start the counter. */
\r
294 TIM0->TCR = TCR_COUNT_ENABLE;
\r
296 /*-----------------------------------------------------------*/
\r