]> git.sur5r.net Git - freertos/blobdiff - FreeRTOS/Demo/CORTEX_M0+_Atmel_SAMD20_XPlained/RTOSDemo/src/main-full.c
Update version numbers in preparation for new release.
[freertos] / FreeRTOS / Demo / CORTEX_M0+_Atmel_SAMD20_XPlained / RTOSDemo / src / main-full.c
index 618bd8a8359973332a550b78b552a06b30bbfadd..a31602ae6e3ec0a8bf52977e52c8d2e585fd8555 100644 (file)
@@ -1,59 +1,64 @@
 /*\r
-    FreeRTOS V7.5.2 - Copyright (C) 2013 Real Time Engineers Ltd.\r
+    FreeRTOS V8.2.2 - Copyright (C) 2015 Real Time Engineers Ltd.\r
+    All rights reserved\r
 \r
     VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.\r
 \r
-    ***************************************************************************\r
-     *                                                                       *\r
-     *    FreeRTOS provides completely free yet professionally developed,    *\r
-     *    robust, strictly quality controlled, supported, and cross          *\r
-     *    platform software that has become a de facto standard.             *\r
-     *                                                                       *\r
-     *    Help yourself get started quickly and support the FreeRTOS         *\r
-     *    project by purchasing a FreeRTOS tutorial book, reference          *\r
-     *    manual, or both from: http://www.FreeRTOS.org/Documentation        *\r
-     *                                                                       *\r
-     *    Thank you!                                                         *\r
-     *                                                                       *\r
-    ***************************************************************************\r
-\r
     This file is part of the FreeRTOS distribution.\r
 \r
     FreeRTOS is free software; you can redistribute it and/or modify it under\r
     the terms of the GNU General Public License (version 2) as published by the\r
     Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception.\r
 \r
-    >>! NOTE: The modification to the GPL is included to allow you to distribute\r
-    >>! a combined work that includes FreeRTOS without being obliged to provide\r
-    >>! the source code for proprietary components outside of the FreeRTOS\r
-    >>! kernel.\r
+    ***************************************************************************\r
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<\r
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<\r
+    >>!   obliged to provide the source code for proprietary components     !<<\r
+    >>!   outside of the FreeRTOS kernel.                                   !<<\r
+    ***************************************************************************\r
 \r
     FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY\r
     WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS\r
-    FOR A PARTICULAR PURPOSE.  Full license text is available from the following\r
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following\r
     link: http://www.freertos.org/a00114.html\r
 \r
-    1 tab == 4 spaces!\r
-\r
     ***************************************************************************\r
      *                                                                       *\r
-     *    Having a problem?  Start by reading the FAQ "My application does   *\r
-     *    not run, what could be wrong?"                                     *\r
+     *    FreeRTOS provides completely free yet professionally developed,    *\r
+     *    robust, strictly quality controlled, supported, and cross          *\r
+     *    platform software that is more than just the market leader, it     *\r
+     *    is the industry's de facto standard.                               *\r
      *                                                                       *\r
-     *    http://www.FreeRTOS.org/FAQHelp.html                               *\r
+     *    Help yourself get started quickly while simultaneously helping     *\r
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *\r
+     *    tutorial book, reference manual, or both:                          *\r
+     *    http://www.FreeRTOS.org/Documentation                              *\r
      *                                                                       *\r
     ***************************************************************************\r
 \r
-    http://www.FreeRTOS.org - Documentation, books, training, latest versions,\r
-    license and Real Time Engineers Ltd. contact details.\r
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading\r
+    the FAQ page "My application does not run, what could be wrong?".  Have you\r
+    defined configASSERT()?\r
+\r
+    http://www.FreeRTOS.org/support - In return for receiving this top quality\r
+    embedded software for free we request you assist our global community by\r
+    participating in the support forum.\r
+\r
+    http://www.FreeRTOS.org/training - Investing in training allows your team to\r
+    be as productive as possible as early as possible.  Now you can receive\r
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers\r
+    Ltd, and the world's leading authority on the world's leading RTOS.\r
 \r
     http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,\r
     including FreeRTOS+Trace - an indispensable productivity tool, a DOS\r
     compatible FAT file system, and our tiny thread aware UDP/IP stack.\r
 \r
-    http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High\r
-    Integrity Systems to sell under the OpenRTOS brand.  Low cost OpenRTOS\r
-    licenses offer ticketed support, indemnification and middleware.\r
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.\r
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.\r
+\r
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High\r
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS\r
+    licenses offer ticketed support, indemnification and commercial middleware.\r
 \r
     http://www.SafeRTOS.com - High Integrity Systems also provide a safety\r
     engineered and independently SIL3 certified version for use in safety and\r
  * In addition to the standard demo tasks, the following tasks and timer are\r
  * defined and/or created within this file:\r
  *\r
+ * "Command console task" - This uses the Atmel USART driver to provide the\r
+ * input and output to FreeRTOS+CLI - the FreeRTOS Command Line Interface.  To\r
+ * use the CLI:\r
+ *  - Power the SAMD20 XPlained board through the USB debugger connector.  This\r
+ *    will create a virtual COM port through the USB.\r
+ *  - Build and run the demo application.  \r
+ *  - Start a dumb terminal program such as TerraTerm or Hyper Terminal.\r
+ *  - In the dumb terminal select the UART port associated with the XPlained\r
+ *    debugger connection, using 19200 baud.\r
+ *  - Type 'help' in the terminal window to see a lit of command registered by\r
+ *    the demo.\r
+ *\r
  * "Reg test" tasks - These fill the registers with known values, then check\r
  * that each register maintains its expected value for the lifetime of the\r
  * task.  Each task uses a different set of values.  The reg test tasks execute\r
 \r
 /* The period after which the check timer will expire provided no errors have\r
 been reported by any of the standard demo tasks.  ms are converted to the\r
-equivalent in ticks using the portTICK_RATE_MS constant. */\r
-#define mainCHECK_TIMER_PERIOD_MS                      ( 3000UL / portTICK_RATE_MS )\r
+equivalent in ticks using the portTICK_PERIOD_MS constant. */\r
+#define mainCHECK_TIMER_PERIOD_MS                      ( 3000UL / portTICK_PERIOD_MS )\r
 \r
 /* The period at which the check timer will expire if an error has been\r
 reported in one of the standard demo tasks.  ms are converted to the equivalent\r
-in ticks using the portTICK_RATE_MS constant. */\r
-#define mainERROR_CHECK_TIMER_PERIOD_MS        ( 200UL / portTICK_RATE_MS )\r
+in ticks using the portTICK_PERIOD_MS constant. */\r
+#define mainERROR_CHECK_TIMER_PERIOD_MS        ( 200UL / portTICK_PERIOD_MS )\r
 \r
 /* A block time of zero simply means "don't block". */\r
 #define mainDONT_BLOCK                                         ( 0UL )\r
@@ -144,14 +161,14 @@ extern void vRegTest1Task( void *pvParameters );
 extern void vRegTest2Task( void *pvParameters );\r
 \r
 /*\r
- * Function that starts the command console.\r
+ * Function that starts the command console task.\r
  */\r
 extern void vUARTCommandConsoleStart( uint16_t usStackSize, unsigned portBASE_TYPE uxPriority );\r
 \r
 /*\r
  * The check timer callback function, as described at the top of this file.\r
  */\r
-static void prvCheckTimerCallback( xTimerHandle xTimer );\r
+static void prvCheckTimerCallback( TimerHandle_t xTimer );\r
 \r
 /*\r
  * Called by main() to create the comprehensive test/demo application if\r
@@ -163,7 +180,7 @@ void main_full( void );
 \r
 /* The following two variables are used to communicate the status of the\r
 register check tasks to the check software timer.  If the variables keep\r
-incrementing, then the register check tasks has not discovered any errors.  If\r
+incrementing, then the register check tasks have not discovered any errors.  If\r
 a variable stops incrementing, then an error has been found. */\r
 volatile unsigned long ulRegTest1LoopCounter = 0UL, ulRegTest2LoopCounter = 0UL;\r
 \r
@@ -171,7 +188,7 @@ volatile unsigned long ulRegTest1LoopCounter = 0UL, ulRegTest2LoopCounter = 0UL;
 \r
 void main_full( void )\r
 {\r
-xTimerHandle xTimer = NULL;\r
+TimerHandle_t xTimer = NULL;\r
 \r
 /* The register test tasks are asm functions that don't use a stack.  The\r
 stack allocated just has to be large enough to hold the task context, and\r
@@ -196,14 +213,14 @@ const size_t xRegTestStackSize = 25U;
        These are naked functions that don't use any stack.  A stack still has\r
        to be allocated to hold the task context. */\r
        xTaskCreate(    vRegTest1Task,                  /* Function that implements the task. */\r
-                                       ( signed char * ) "Reg1", /* Text name of the task. */\r
+                                       "Reg1",                                 /* Text name of the task. */\r
                                        xRegTestStackSize,              /* Stack allocated to the task. */\r
                                        NULL,                                   /* The task parameter is not used. */\r
                                        tskIDLE_PRIORITY,               /* The priority to assign to the task. */\r
                                        NULL );                                 /* Don't receive a handle back, it is not needed. */\r
 \r
        xTaskCreate(    vRegTest2Task,                  /* Function that implements the task. */\r
-                                       ( signed char * ) "Reg2", /* Text name of the task. */\r
+                                       "Reg2",                                 /* Text name of the task. */\r
                                        xRegTestStackSize,              /* Stack allocated to the task. */\r
                                        NULL,                                   /* The task parameter is not used. */\r
                                        tskIDLE_PRIORITY,               /* The priority to assign to the task. */\r
@@ -211,7 +228,7 @@ const size_t xRegTestStackSize = 25U;
 \r
        /* Create the software timer that performs the 'check' functionality,\r
        as described at the top of this file. */\r
-       xTimer = xTimerCreate(  ( const signed char * ) "CheckTimer",/* A text name, purely to help debugging. */\r
+       xTimer = xTimerCreate(  "CheckTimer",                                           /* A text name, purely to help debugging. */\r
                                                        ( mainCHECK_TIMER_PERIOD_MS ),          /* The timer period, in this case 3000ms (3s). */\r
                                                        pdTRUE,                                                         /* This is an auto-reload timer, so xAutoReload is set to pdTRUE. */\r
                                                        ( void * ) 0,                                           /* The ID is not used, so can be set to anything. */\r
@@ -222,6 +239,7 @@ const size_t xRegTestStackSize = 25U;
        actually start running until the scheduler starts.  A block time of\r
        zero is used in this call, although any value could be used as the block\r
        time will be ignored because the scheduler has not started yet. */\r
+       configASSERT( xTimer );\r
        if( xTimer != NULL )\r
        {\r
                xTimerStart( xTimer, mainDONT_BLOCK );\r
@@ -240,7 +258,7 @@ const size_t xRegTestStackSize = 25U;
 /*-----------------------------------------------------------*/\r
 \r
 /* See the description at the top of this file. */\r
-static void prvCheckTimerCallback( xTimerHandle xTimer )\r
+static void prvCheckTimerCallback( TimerHandle_t xTimer )\r
 {\r
 static long lChangedTimerPeriodAlready = pdFALSE;\r
 static unsigned long ulLastRegTest1Value = 0, ulLastRegTest2Value = 0;\r
@@ -250,58 +268,59 @@ unsigned long ulErrorFound = pdFALSE;
        running, and that none have detected an error. */\r
        if( xAreDynamicPriorityTasksStillRunning() != pdPASS )\r
        {\r
-               ulErrorFound |= ( 0x01UL << 0UL );\r
+               ulErrorFound = pdTRUE;\r
        }\r
 \r
        if( xAreBlockTimeTestTasksStillRunning() != pdPASS )\r
        {\r
-               ulErrorFound |= ( 0x01UL << 1UL );\r
+               ulErrorFound = pdTRUE;\r
        }\r
 \r
        if( xAreCountingSemaphoreTasksStillRunning() != pdPASS )\r
        {\r
-               ulErrorFound |= ( 0x01UL << 2UL );\r
+               ulErrorFound = pdTRUE;\r
        }\r
 \r
        if( xAreRecursiveMutexTasksStillRunning() != pdPASS )\r
        {\r
-               ulErrorFound |= ( 0x01UL << 3UL );\r
+               ulErrorFound = pdTRUE;\r
        }\r
 \r
        /* Check that the register test 1 task is still running. */\r
        if( ulLastRegTest1Value == ulRegTest1LoopCounter )\r
        {\r
-               ulErrorFound |= ( 0x01UL << 4UL );\r
+               ulErrorFound = pdTRUE;\r
        }\r
        ulLastRegTest1Value = ulRegTest1LoopCounter;\r
 \r
        /* Check that the register test 2 task is still running. */\r
        if( ulLastRegTest2Value == ulRegTest2LoopCounter )\r
        {\r
-               ulErrorFound |= ( 0x01UL << 5UL );\r
+               ulErrorFound = pdTRUE;\r
        }\r
        ulLastRegTest2Value = ulRegTest2LoopCounter;\r
 \r
+       \r
        if( xAreQueueSetTasksStillRunning() != pdPASS )\r
        {\r
-               ulErrorFound |= ( 0x01UL << 6UL );\r
+               ulErrorFound = pdTRUE;\r
        }\r
 \r
        if( xIsQueueOverwriteTaskStillRunning() != pdPASS )\r
        {\r
-               ulErrorFound |= ( 0x01UL << 7UL );\r
+               ulErrorFound = pdTRUE;\r
        }\r
        \r
        if( xAreGenericQueueTasksStillRunning() != pdPASS )\r
        {\r
-               ulErrorFound |= ( 0x01UL << 8UL );\r
+               ulErrorFound = pdTRUE;\r
        }\r
        \r
        if( xAreQueuePeekTasksStillRunning() != pdPASS )\r
        {\r
-               ulErrorFound |= ( 0x01UL << 9UL );\r
+               ulErrorFound = pdTRUE;\r
        }\r
-       \r
+\r
        /* Toggle the check LED to give an indication of the system status.  If\r
        the LED toggles every mainCHECK_TIMER_PERIOD_MS milliseconds then\r
        everything is ok.  A faster toggle indicates an error. */\r