2 FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
5 VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
7 This file is part of the FreeRTOS distribution.
9 FreeRTOS is free software; you can redistribute it and/or modify it under
10 the terms of the GNU General Public License (version 2) as published by the
11 Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
13 ***************************************************************************
14 >>! NOTE: The modification to the GPL is included to allow you to !<<
15 >>! distribute a combined work that includes FreeRTOS without being !<<
16 >>! obliged to provide the source code for proprietary components !<<
17 >>! outside of the FreeRTOS kernel. !<<
18 ***************************************************************************
20 FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
21 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
22 FOR A PARTICULAR PURPOSE. Full license text is available on the following
23 link: http://www.freertos.org/a00114.html
25 ***************************************************************************
27 * FreeRTOS provides completely free yet professionally developed, *
28 * robust, strictly quality controlled, supported, and cross *
29 * platform software that is more than just the market leader, it *
30 * is the industry's de facto standard. *
32 * Help yourself get started quickly while simultaneously helping *
33 * to support the FreeRTOS project by purchasing a FreeRTOS *
34 * tutorial book, reference manual, or both: *
35 * http://www.FreeRTOS.org/Documentation *
37 ***************************************************************************
39 http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading
40 the FAQ page "My application does not run, what could be wrong?". Have you
41 defined configASSERT()?
43 http://www.FreeRTOS.org/support - In return for receiving this top quality
44 embedded software for free we request you assist our global community by
45 participating in the support forum.
47 http://www.FreeRTOS.org/training - Investing in training allows your team to
48 be as productive as possible as early as possible. Now you can receive
49 FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
50 Ltd, and the world's leading authority on the world's leading RTOS.
52 http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
53 including FreeRTOS+Trace - an indispensable productivity tool, a DOS
54 compatible FAT file system, and our tiny thread aware UDP/IP stack.
56 http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
57 Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
59 http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
60 Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS
61 licenses offer ticketed support, indemnification and commercial middleware.
63 http://www.SafeRTOS.com - High Integrity Systems also provide a safety
64 engineered and independently SIL3 certified version for use in safety and
65 mission critical applications that require provable dependability.
72 * Creates all the demo application tasks, then starts the scheduler. The WEB
73 * documentation provides more details of the standard demo application tasks
74 * (which just exist to test the kernel port and provide an example of how to use
75 * each FreeRTOS API function).
77 * In addition to the standard demo tasks, the following tasks and tests are
78 * defined and/or created within this file:
80 * "Check" hook - This only executes fully every five seconds from the tick
81 * hook. Its main function is to check that all the standard demo tasks are
82 * still operational. The status can be viewed using on the Task Stats page
83 * served by the WEB server.
85 * "uIP" task - This is the task that handles the uIP stack. All TCP/IP
86 * processing is performed in this task.
88 * "USB" task - Enumerates the USB device as a CDC class, then echoes back all
89 * received characters with a configurable offset (for example, if the offset
90 * is 1 and 'A' is received then 'B' will be sent back). A dumb terminal such
91 * as Hyperterminal can be used to talk to the USB task.
94 /* Scheduler includes. */
98 /* Demo app includes. */
101 #include "blocktim.h"
106 #include "GenQTest.h"
108 #include "recmutex.h"
110 /*-----------------------------------------------------------*/
112 /* The time between cycles of the 'check' functionality (defined within the
114 #define mainCHECK_DELAY ( ( TickType_t ) 5000 / portTICK_PERIOD_MS )
116 /* Task priorities. */
117 #define mainQUEUE_POLL_PRIORITY ( tskIDLE_PRIORITY + 2 )
118 #define mainSEM_TEST_PRIORITY ( tskIDLE_PRIORITY + 1 )
119 #define mainBLOCK_Q_PRIORITY ( tskIDLE_PRIORITY + 2 )
120 #define mainUIP_TASK_PRIORITY ( tskIDLE_PRIORITY + 3 )
121 #define mainINTEGER_TASK_PRIORITY ( tskIDLE_PRIORITY )
122 #define mainGEN_QUEUE_TASK_PRIORITY ( tskIDLE_PRIORITY )
123 #define mainFLASH_TASK_PRIORITY ( tskIDLE_PRIORITY + 2 )
125 /* The WEB server has a larger stack as it utilises stack hungry string
126 handling library calls. */
127 #define mainBASIC_WEB_STACK_SIZE ( configMINIMAL_STACK_SIZE * 4 )
129 /* The message displayed by the WEB server when all tasks are executing
130 without an error being reported. */
131 #define mainPASS_STATUS_MESSAGE "All tasks are executing without error."
133 /*-----------------------------------------------------------*/
136 * Configure the hardware for the demo.
138 static void prvSetupHardware( void );
141 * The task that handles the uIP stack. All TCP/IP processing is performed in
144 extern void vuIP_Task( void *pvParameters );
147 * The task that handles the USB stack.
149 extern void vUSBTask( void *pvParameters );
152 * Simply returns the current status message for display on served WEB pages.
154 char *pcGetTaskStatusMessage( void );
156 /*-----------------------------------------------------------*/
158 /* Holds the status message displayed by the WEB server. */
159 static char *pcStatusMessage = mainPASS_STATUS_MESSAGE;
161 /*-----------------------------------------------------------*/
165 /* Configure the hardware for use by this demo. */
168 /* Start the standard demo tasks. These are just here to exercise the
169 kernel port and provide examples of how the FreeRTOS API can be used. */
170 vStartBlockingQueueTasks( mainBLOCK_Q_PRIORITY );
171 vCreateBlockTimeTasks();
172 vStartSemaphoreTasks( mainSEM_TEST_PRIORITY );
173 vStartPolledQueueTasks( mainQUEUE_POLL_PRIORITY );
174 vStartIntegerMathTasks( mainINTEGER_TASK_PRIORITY );
175 vStartGenericQueueTasks( mainGEN_QUEUE_TASK_PRIORITY );
176 vStartQueuePeekTasks();
177 vStartRecursiveMutexTasks();
178 vStartLEDFlashTasks( mainFLASH_TASK_PRIORITY );
180 /* Create the USB task. */
181 xTaskCreate( vUSBTask, "USB", configMINIMAL_STACK_SIZE, ( void * ) NULL, tskIDLE_PRIORITY, NULL );
183 /* Create the uIP task. The WEB server runs in this task. */
184 xTaskCreate( vuIP_Task, "uIP", mainBASIC_WEB_STACK_SIZE, ( void * ) NULL, mainUIP_TASK_PRIORITY, NULL );
186 /* Start the scheduler. */
187 vTaskStartScheduler();
189 /* Will only get here if there was insufficient memory to create the idle
190 task. The idle task is created within vTaskStartScheduler(). */
193 /*-----------------------------------------------------------*/
195 void vApplicationTickHook( void )
197 static unsigned long ulTicksSinceLastDisplay = 0;
199 /* Called from every tick interrupt as described in the comments at the top
202 Have enough ticks passed to make it time to perform our health status
204 ulTicksSinceLastDisplay++;
205 if( ulTicksSinceLastDisplay >= mainCHECK_DELAY )
207 /* Reset the counter so these checks run again in mainCHECK_DELAY
209 ulTicksSinceLastDisplay = 0;
211 /* Has an error been found in any task? */
212 if( xAreGenericQueueTasksStillRunning() != pdTRUE )
214 pcStatusMessage = "An error has been detected in the Generic Queue test/demo.";
216 else if( xAreQueuePeekTasksStillRunning() != pdTRUE )
218 pcStatusMessage = "An error has been detected in the Peek Queue test/demo.";
220 else if( xAreBlockingQueuesStillRunning() != pdTRUE )
222 pcStatusMessage = "An error has been detected in the Block Queue test/demo.";
224 else if( xAreBlockTimeTestTasksStillRunning() != pdTRUE )
226 pcStatusMessage = "An error has been detected in the Block Time test/demo.";
228 else if( xAreSemaphoreTasksStillRunning() != pdTRUE )
230 pcStatusMessage = "An error has been detected in the Semaphore test/demo.";
232 else if( xArePollingQueuesStillRunning() != pdTRUE )
234 pcStatusMessage = "An error has been detected in the Poll Queue test/demo.";
236 else if( xAreIntegerMathsTaskStillRunning() != pdTRUE )
238 pcStatusMessage = "An error has been detected in the Int Math test/demo.";
240 else if( xAreRecursiveMutexTasksStillRunning() != pdTRUE )
242 pcStatusMessage = "An error has been detected in the Mutex test/demo.";
246 /*-----------------------------------------------------------*/
248 char *pcGetTaskStatusMessage( void )
250 /* Not bothered about a critical section here. */
251 return pcStatusMessage;
253 /*-----------------------------------------------------------*/
255 void prvSetupHardware( void )
257 /* Disable peripherals power. */
260 /* Enable GPIO power. */
261 SC->PCONP = PCONP_PCGPIO;
264 PINCON->PINSEL10 = 0;
266 /* Setup the peripheral bus to be the same as the CPU output (100 MHz). */
267 SC->PCLKSEL0 = 0x05555555;
269 /* Configure the LEDs. */
270 vParTestInitialise();
272 /*-----------------------------------------------------------*/
274 void vApplicationStackOverflowHook( TaskHandle_t pxTask, char *pcTaskName )
276 /* This function will get called if a task overflows its stack. */
283 /*-----------------------------------------------------------*/
285 void vConfigureTimerForRunTimeStats( void )
287 const unsigned long TCR_COUNT_RESET = 2, CTCR_CTM_TIMER = 0x00, TCR_COUNT_ENABLE = 0x01;
289 /* This function configures a timer that is used as the time base when
290 collecting run time statistical information - basically the percentage
291 of CPU time that each task is utilising. It is called automatically when
292 the scheduler is started (assuming configGENERATE_RUN_TIME_STATS is set
295 /* Power up and feed the timer. */
297 SC->PCLKSEL0 = (SC->PCLKSEL0 & (~(0x3<<2))) | (0x01 << 2);
300 TIM0->TCR = TCR_COUNT_RESET;
303 TIM0->CTCR = CTCR_CTM_TIMER;
305 /* Prescale to a frequency that is good enough to get a decent resolution,
306 but not too fast so as to overflow all the time. */
307 TIM0->PR = ( configCPU_CLOCK_HZ / 10000UL ) - 1UL;
309 /* Start the counter. */
310 TIM0->TCR = TCR_COUNT_ENABLE;
312 /*-----------------------------------------------------------*/