2 * FreeRTOS Kernel V10.1.0
\r
3 * Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
\r
5 * Permission is hereby granted, free of charge, to any person obtaining a copy of
\r
6 * this software and associated documentation files (the "Software"), to deal in
\r
7 * the Software without restriction, including without limitation the rights to
\r
8 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
\r
9 * the Software, and to permit persons to whom the Software is furnished to do so,
\r
10 * subject to the following conditions:
\r
12 * The above copyright notice and this permission notice shall be included in all
\r
13 * copies or substantial portions of the Software.
\r
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
\r
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
\r
17 * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
\r
18 * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
\r
19 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
\r
20 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
\r
22 * http://www.FreeRTOS.org
\r
23 * http://aws.amazon.com/freertos
\r
25 * 1 tab == 4 spaces!
\r
30 * Creates all the demo application tasks, then starts the scheduler. The WEB
\r
31 * documentation provides more details of the standard demo application tasks
\r
32 * (which just exist to test the kernel port and provide an example of how to use
\r
33 * each FreeRTOS API function).
\r
35 * In addition to the standard demo tasks, the following tasks and tests are
\r
36 * defined and/or created within this file:
\r
38 * "Check" hook - This only executes fully every five seconds from the tick
\r
39 * hook. Its main function is to check that all the standard demo tasks are
\r
40 * still operational. The status can be viewed using on the Task Stats page
\r
41 * served by the WEB server.
\r
43 * "uIP" task - This is the task that handles the uIP stack. All TCP/IP
\r
44 * processing is performed in this task.
\r
46 * "USB" task - Enumerates the USB device as a CDC class, then echoes back all
\r
47 * received characters with a configurable offset (for example, if the offset
\r
48 * is 1 and 'A' is received then 'B' will be sent back). A dumb terminal such
\r
49 * as Hyperterminal can be used to talk to the USB task.
\r
52 /* Scheduler includes. */
\r
53 #include "FreeRTOS.h"
\r
56 /* Demo app includes. */
\r
58 #include "integer.h"
\r
59 #include "blocktim.h"
\r
61 #include "partest.h"
\r
62 #include "semtest.h"
\r
64 #include "GenQTest.h"
\r
66 #include "recmutex.h"
\r
68 /*-----------------------------------------------------------*/
\r
70 /* The time between cycles of the 'check' functionality (defined within the
\r
72 #define mainCHECK_DELAY ( ( TickType_t ) 5000 / portTICK_PERIOD_MS )
\r
74 /* Task priorities. */
\r
75 #define mainQUEUE_POLL_PRIORITY ( tskIDLE_PRIORITY + 2 )
\r
76 #define mainSEM_TEST_PRIORITY ( tskIDLE_PRIORITY + 1 )
\r
77 #define mainBLOCK_Q_PRIORITY ( tskIDLE_PRIORITY + 2 )
\r
78 #define mainUIP_TASK_PRIORITY ( tskIDLE_PRIORITY + 3 )
\r
79 #define mainINTEGER_TASK_PRIORITY ( tskIDLE_PRIORITY )
\r
80 #define mainGEN_QUEUE_TASK_PRIORITY ( tskIDLE_PRIORITY )
\r
81 #define mainFLASH_TASK_PRIORITY ( tskIDLE_PRIORITY + 2 )
\r
83 /* The WEB server has a larger stack as it utilises stack hungry string
\r
84 handling library calls. */
\r
85 #define mainBASIC_WEB_STACK_SIZE ( configMINIMAL_STACK_SIZE * 4 )
\r
87 /* The message displayed by the WEB server when all tasks are executing
\r
88 without an error being reported. */
\r
89 #define mainPASS_STATUS_MESSAGE "All tasks are executing without error."
\r
91 /*-----------------------------------------------------------*/
\r
94 * Configure the hardware for the demo.
\r
96 static void prvSetupHardware( void );
\r
99 * The task that handles the uIP stack. All TCP/IP processing is performed in
\r
102 extern void vuIP_Task( void *pvParameters );
\r
105 * The task that handles the USB stack.
\r
107 extern void vUSBTask( void *pvParameters );
\r
110 * Simply returns the current status message for display on served WEB pages.
\r
112 char *pcGetTaskStatusMessage( void );
\r
114 /*-----------------------------------------------------------*/
\r
116 /* Holds the status message displayed by the WEB server. */
\r
117 static char *pcStatusMessage = mainPASS_STATUS_MESSAGE;
\r
119 /*-----------------------------------------------------------*/
\r
123 /* Configure the hardware for use by this demo. */
\r
124 prvSetupHardware();
\r
126 /* Start the standard demo tasks. These are just here to exercise the
\r
127 kernel port and provide examples of how the FreeRTOS API can be used. */
\r
128 vStartBlockingQueueTasks( mainBLOCK_Q_PRIORITY );
\r
129 vCreateBlockTimeTasks();
\r
130 vStartSemaphoreTasks( mainSEM_TEST_PRIORITY );
\r
131 vStartPolledQueueTasks( mainQUEUE_POLL_PRIORITY );
\r
132 vStartIntegerMathTasks( mainINTEGER_TASK_PRIORITY );
\r
133 vStartGenericQueueTasks( mainGEN_QUEUE_TASK_PRIORITY );
\r
134 vStartQueuePeekTasks();
\r
135 vStartRecursiveMutexTasks();
\r
136 vStartLEDFlashTasks( mainFLASH_TASK_PRIORITY );
\r
138 /* Create the USB task. */
\r
139 xTaskCreate( vUSBTask, "USB", configMINIMAL_STACK_SIZE, ( void * ) NULL, tskIDLE_PRIORITY, NULL );
\r
141 /* Create the uIP task. The WEB server runs in this task. */
\r
142 xTaskCreate( vuIP_Task, "uIP", mainBASIC_WEB_STACK_SIZE, ( void * ) NULL, mainUIP_TASK_PRIORITY, NULL );
\r
144 /* Start the scheduler. */
\r
145 vTaskStartScheduler();
\r
147 /* Will only get here if there was insufficient memory to create the idle
\r
148 task. The idle task is created within vTaskStartScheduler(). */
\r
151 /*-----------------------------------------------------------*/
\r
153 void vApplicationTickHook( void )
\r
155 static unsigned long ulTicksSinceLastDisplay = 0;
\r
157 /* Called from every tick interrupt as described in the comments at the top
\r
160 Have enough ticks passed to make it time to perform our health status
\r
162 ulTicksSinceLastDisplay++;
\r
163 if( ulTicksSinceLastDisplay >= mainCHECK_DELAY )
\r
165 /* Reset the counter so these checks run again in mainCHECK_DELAY
\r
167 ulTicksSinceLastDisplay = 0;
\r
169 /* Has an error been found in any task? */
\r
170 if( xAreGenericQueueTasksStillRunning() != pdTRUE )
\r
172 pcStatusMessage = "An error has been detected in the Generic Queue test/demo.";
\r
174 else if( xAreQueuePeekTasksStillRunning() != pdTRUE )
\r
176 pcStatusMessage = "An error has been detected in the Peek Queue test/demo.";
\r
178 else if( xAreBlockingQueuesStillRunning() != pdTRUE )
\r
180 pcStatusMessage = "An error has been detected in the Block Queue test/demo.";
\r
182 else if( xAreBlockTimeTestTasksStillRunning() != pdTRUE )
\r
184 pcStatusMessage = "An error has been detected in the Block Time test/demo.";
\r
186 else if( xAreSemaphoreTasksStillRunning() != pdTRUE )
\r
188 pcStatusMessage = "An error has been detected in the Semaphore test/demo.";
\r
190 else if( xArePollingQueuesStillRunning() != pdTRUE )
\r
192 pcStatusMessage = "An error has been detected in the Poll Queue test/demo.";
\r
194 else if( xAreIntegerMathsTaskStillRunning() != pdTRUE )
\r
196 pcStatusMessage = "An error has been detected in the Int Math test/demo.";
\r
198 else if( xAreRecursiveMutexTasksStillRunning() != pdTRUE )
\r
200 pcStatusMessage = "An error has been detected in the Mutex test/demo.";
\r
204 /*-----------------------------------------------------------*/
\r
206 char *pcGetTaskStatusMessage( void )
\r
208 /* Not bothered about a critical section here. */
\r
209 return pcStatusMessage;
\r
211 /*-----------------------------------------------------------*/
\r
213 void prvSetupHardware( void )
\r
215 /* Disable peripherals power. */
\r
218 /* Enable GPIO power. */
\r
219 SC->PCONP = PCONP_PCGPIO;
\r
221 /* Disable TPIU. */
\r
222 PINCON->PINSEL10 = 0;
\r
224 /* Setup the peripheral bus to be the same as the CPU output (100 MHz). */
\r
225 SC->PCLKSEL0 = 0x05555555;
\r
227 /* Configure the LEDs. */
\r
228 vParTestInitialise();
\r
230 /*-----------------------------------------------------------*/
\r
232 void vApplicationStackOverflowHook( TaskHandle_t pxTask, char *pcTaskName )
\r
234 /* This function will get called if a task overflows its stack. */
\r
237 ( void ) pcTaskName;
\r
241 /*-----------------------------------------------------------*/
\r
243 void vConfigureTimerForRunTimeStats( void )
\r
245 const unsigned long TCR_COUNT_RESET = 2, CTCR_CTM_TIMER = 0x00, TCR_COUNT_ENABLE = 0x01;
\r
247 /* This function configures a timer that is used as the time base when
\r
248 collecting run time statistical information - basically the percentage
\r
249 of CPU time that each task is utilising. It is called automatically when
\r
250 the scheduler is started (assuming configGENERATE_RUN_TIME_STATS is set
\r
253 /* Power up and feed the timer. */
\r
254 SC->PCONP |= 0x02UL;
\r
255 SC->PCLKSEL0 = (SC->PCLKSEL0 & (~(0x3<<2))) | (0x01 << 2);
\r
257 /* Reset Timer 0 */
\r
258 TIM0->TCR = TCR_COUNT_RESET;
\r
260 /* Just count up. */
\r
261 TIM0->CTCR = CTCR_CTM_TIMER;
\r
263 /* Prescale to a frequency that is good enough to get a decent resolution,
\r
264 but not too fast so as to overflow all the time. */
\r
265 TIM0->PR = ( configCPU_CLOCK_HZ / 10000UL ) - 1UL;
\r
267 /* Start the counter. */
\r
268 TIM0->TCR = TCR_COUNT_ENABLE;
\r
270 /*-----------------------------------------------------------*/
\r