]> git.sur5r.net Git - freertos/blobdiff - FreeRTOS/Demo/Common/Minimal/QPeek.c
Update version number in preparation for official V8.2.0 release.
[freertos] / FreeRTOS / Demo / Common / Minimal / QPeek.c
index e4bb00b306e87666b0d4ddc3bf2cd1dcb3b841b6..72f84a4037e6d85d5ef341efeb95cdea3b79c1c1 100644 (file)
@@ -1,79 +1,74 @@
 /*\r
-    FreeRTOS V7.4.0 - Copyright (C) 2013 Real Time Engineers Ltd.\r
-\r
-    FEATURES AND PORTS ARE ADDED TO FREERTOS ALL THE TIME.  PLEASE VISIT\r
-    http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.\r
-\r
-    ***************************************************************************\r
-     *                                                                       *\r
-     *    FreeRTOS tutorial books are available in pdf and paperback.        *\r
-     *    Complete, revised, and edited pdf reference manuals are also       *\r
-     *    available.                                                         *\r
-     *                                                                       *\r
-     *    Purchasing FreeRTOS documentation will not only help you, by       *\r
-     *    ensuring you get running as quickly as possible and with an        *\r
-     *    in-depth knowledge of how to use FreeRTOS, it will also help       *\r
-     *    the FreeRTOS project to continue with its mission of providing     *\r
-     *    professional grade, cross platform, de facto standard solutions    *\r
-     *    for microcontrollers - completely free of charge!                  *\r
-     *                                                                       *\r
-     *    >>> See http://www.FreeRTOS.org/Documentation for details. <<<     *\r
-     *                                                                       *\r
-     *    Thank you for using FreeRTOS, and thank you for your support!      *\r
-     *                                                                       *\r
-    ***************************************************************************\r
+    FreeRTOS V8.2.0 - 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
     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
+    Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception.\r
 \r
-    >>>>>>NOTE<<<<<< The modification to the GPL is included to allow you to\r
-    distribute a combined work that includes FreeRTOS without being obliged to\r
-    provide 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.  See the GNU General Public License for more\r
-    details. You should have received a copy of the GNU General Public License\r
-    and the FreeRTOS license exception along with FreeRTOS; if not itcan be\r
-    viewed here: http://www.freertos.org/a00114.html and also obtained by\r
-    writing to Real Time Engineers Ltd., contact details for whom are available\r
-    on the FreeRTOS WEB site.\r
-\r
-    1 tab == 4 spaces!\r
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following\r
+    link: http://www.freertos.org/a00114.html\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/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 - Documentation, books, training, latest versions, \r
-    license and Real Time Engineers Ltd. contact details.\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, and our new\r
-    fully thread aware and reentrant UDP/IP stack.\r
-\r
-    http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High \r
-    Integrity Systems, who sell the code with commercial support, \r
-    indemnification and middleware, under the OpenRTOS brand.\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
+    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.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
     mission critical applications that require provable dependability.\r
+\r
+    1 tab == 4 spaces!\r
 */\r
 \r
 \r
-/* \r
+/*\r
  * Tests the behaviour when data is peeked from a queue when there are\r
  * multiple tasks blocked on the queue.\r
  */\r
@@ -115,51 +110,51 @@ static void prvHighestPriorityPeekTask( void *pvParameters );
 \r
 /* Flag that will be latched to pdTRUE should any unexpected behaviour be\r
 detected in any of the tasks. */\r
-static volatile portBASE_TYPE xErrorDetected = pdFALSE;\r
+static volatile BaseType_t xErrorDetected = pdFALSE;\r
 \r
 /* Counter that is incremented on each cycle of a test.  This is used to\r
 detect a stalled task - a test that is no longer running. */\r
-static volatile unsigned portLONG ulLoopCounter = 0;\r
+static volatile uint32_t ulLoopCounter = 0;\r
 \r
 /* Handles to the test tasks. */\r
-xTaskHandle xMediumPriorityTask, xHighPriorityTask, xHighestPriorityTask;\r
+TaskHandle_t xMediumPriorityTask, xHighPriorityTask, xHighestPriorityTask;\r
 /*-----------------------------------------------------------*/\r
 \r
 void vStartQueuePeekTasks( void )\r
 {\r
-xQueueHandle xQueue;\r
+QueueHandle_t xQueue;\r
 \r
        /* Create the queue that we are going to use for the test/demo. */\r
-       xQueue = xQueueCreate( qpeekQUEUE_LENGTH, sizeof( unsigned portLONG ) );\r
+       xQueue = xQueueCreate( qpeekQUEUE_LENGTH, sizeof( uint32_t ) );\r
 \r
        /* vQueueAddToRegistry() adds the queue to the queue registry, if one is\r
-       in use.  The queue registry is provided as a means for kernel aware \r
+       in use.  The queue registry is provided as a means for kernel aware\r
        debuggers to locate queues and has no purpose if a kernel aware debugger\r
        is not being used.  The call to vQueueAddToRegistry() will be removed\r
-       by the pre-processor if configQUEUE_REGISTRY_SIZE is not defined or is \r
+       by the pre-processor if configQUEUE_REGISTRY_SIZE is not defined or is\r
        defined to be less than 1. */\r
-       vQueueAddToRegistry( xQueue, ( signed portCHAR * ) "QPeek_Test_Queue" );\r
+       vQueueAddToRegistry( xQueue, "QPeek_Test_Queue" );\r
 \r
        /* Create the demo tasks and pass it the queue just created.  We are\r
        passing the queue handle by value so it does not matter that it is declared\r
        on the stack here. */\r
-       xTaskCreate( prvLowPriorityPeekTask, ( signed portCHAR * )"PeekL", configMINIMAL_STACK_SIZE, ( void * ) xQueue, qpeekLOW_PRIORITY, NULL );\r
-       xTaskCreate( prvMediumPriorityPeekTask, ( signed portCHAR * )"PeekM", configMINIMAL_STACK_SIZE, ( void * ) xQueue, qpeekMEDIUM_PRIORITY, &xMediumPriorityTask );\r
-       xTaskCreate( prvHighPriorityPeekTask, ( signed portCHAR * )"PeekH1", configMINIMAL_STACK_SIZE, ( void * ) xQueue, qpeekHIGH_PRIORITY, &xHighPriorityTask );\r
-       xTaskCreate( prvHighestPriorityPeekTask, ( signed portCHAR * )"PeekH2", configMINIMAL_STACK_SIZE, ( void * ) xQueue, qpeekHIGHEST_PRIORITY, &xHighestPriorityTask );\r
+       xTaskCreate( prvLowPriorityPeekTask, "PeekL", configMINIMAL_STACK_SIZE, ( void * ) xQueue, qpeekLOW_PRIORITY, NULL );\r
+       xTaskCreate( prvMediumPriorityPeekTask, "PeekM", configMINIMAL_STACK_SIZE, ( void * ) xQueue, qpeekMEDIUM_PRIORITY, &xMediumPriorityTask );\r
+       xTaskCreate( prvHighPriorityPeekTask, "PeekH1", configMINIMAL_STACK_SIZE, ( void * ) xQueue, qpeekHIGH_PRIORITY, &xHighPriorityTask );\r
+       xTaskCreate( prvHighestPriorityPeekTask, "PeekH2", configMINIMAL_STACK_SIZE, ( void * ) xQueue, qpeekHIGHEST_PRIORITY, &xHighestPriorityTask );\r
 }\r
 /*-----------------------------------------------------------*/\r
 \r
 static void prvHighestPriorityPeekTask( void *pvParameters )\r
 {\r
-xQueueHandle xQueue = ( xQueueHandle ) pvParameters;\r
-unsigned portLONG ulValue;\r
+QueueHandle_t xQueue = ( QueueHandle_t ) pvParameters;\r
+uint32_t ulValue;\r
 \r
        #ifdef USE_STDIO\r
        {\r
-               void vPrintDisplayMessage( const portCHAR * const * ppcMessageToSend );\r
-       \r
-               const portCHAR * const pcTaskStartMsg = "Queue peek test started.\r\n";\r
+               void vPrintDisplayMessage( const char * const * ppcMessageToSend );\r
+\r
+               const char * const pcTaskStartMsg = "Queue peek test started.\r\n";\r
 \r
                /* Queue a message for printing to say the task has started. */\r
                vPrintDisplayMessage( &pcTaskStartMsg );\r
@@ -211,7 +206,7 @@ unsigned portLONG ulValue;
                        xErrorDetected = pdTRUE;\r
                }\r
 \r
-               /* Now we will block again as the queue is once more empty.  The low \r
+               /* Now we will block again as the queue is once more empty.  The low\r
                priority task can then execute again. */\r
                if( xQueuePeek( xQueue, &ulValue, portMAX_DELAY ) != pdPASS )\r
                {\r
@@ -254,15 +249,15 @@ unsigned portLONG ulValue;
                        xErrorDetected = pdTRUE;\r
                }\r
 \r
-               vTaskSuspend( NULL );           \r
+               vTaskSuspend( NULL );\r
        }\r
 }\r
 /*-----------------------------------------------------------*/\r
 \r
 static void prvHighPriorityPeekTask( void *pvParameters )\r
 {\r
-xQueueHandle xQueue = ( xQueueHandle ) pvParameters;\r
-unsigned portLONG ulValue;\r
+QueueHandle_t xQueue = ( QueueHandle_t ) pvParameters;\r
+uint32_t ulValue;\r
 \r
        for( ;; )\r
        {\r
@@ -309,15 +304,15 @@ unsigned portLONG ulValue;
                        xErrorDetected = pdTRUE;\r
                }\r
 \r
-               vTaskSuspend( NULL );                           \r
+               vTaskSuspend( NULL );\r
        }\r
 }\r
 /*-----------------------------------------------------------*/\r
 \r
 static void prvMediumPriorityPeekTask( void *pvParameters )\r
 {\r
-xQueueHandle xQueue = ( xQueueHandle ) pvParameters;\r
-unsigned portLONG ulValue;\r
+QueueHandle_t xQueue = ( QueueHandle_t ) pvParameters;\r
+uint32_t ulValue;\r
 \r
        for( ;; )\r
        {\r
@@ -357,12 +352,12 @@ unsigned portLONG ulValue;
 \r
 static void prvLowPriorityPeekTask( void *pvParameters )\r
 {\r
-xQueueHandle xQueue = ( xQueueHandle ) pvParameters;\r
-unsigned portLONG ulValue;\r
+QueueHandle_t xQueue = ( QueueHandle_t ) pvParameters;\r
+uint32_t ulValue;\r
 \r
        for( ;; )\r
        {\r
-               /* Write some data to the queue.  This should unblock the highest \r
+               /* Write some data to the queue.  This should unblock the highest\r
                priority task that is waiting to peek data from the queue. */\r
                ulValue = 0x11223344;\r
                if( xQueueSendToBack( xQueue, &ulValue, qpeekNO_BLOCK ) != pdPASS )\r
@@ -372,6 +367,10 @@ unsigned portLONG ulValue;
                        xErrorDetected = pdTRUE;\r
                }\r
 \r
+               #if configUSE_PREEMPTION == 0\r
+                       taskYIELD();\r
+               #endif\r
+\r
                /* By the time we get here the data should have been removed from\r
                the queue. */\r
                if( uxQueueMessagesWaiting( xQueue ) != 0 )\r
@@ -389,6 +388,10 @@ unsigned portLONG ulValue;
                        xErrorDetected = pdTRUE;\r
                }\r
 \r
+               #if configUSE_PREEMPTION == 0\r
+                       taskYIELD();\r
+               #endif\r
+\r
                /* All the other tasks should now have successfully peeked the data.\r
                The data is still in the queue so we should be able to receive it. */\r
                ulValue = 0;\r
@@ -402,7 +405,7 @@ unsigned portLONG ulValue;
                {\r
                        /* We did not receive the expected value. */\r
                }\r
-               \r
+\r
                /* Lets just delay a while as this is an intensive test as we don't\r
                want to starve other tests of processing time. */\r
                vTaskDelay( qpeekSHORT_DELAY );\r
@@ -416,6 +419,10 @@ unsigned portLONG ulValue;
                vTaskResume( xHighPriorityTask );\r
                vTaskResume( xHighestPriorityTask );\r
 \r
+               #if( configUSE_PREEMPTION == 0 )\r
+                       taskYIELD();\r
+               #endif\r
+\r
                ulValue = 0xaabbaabb;\r
                if( xQueueSendToFront( xQueue, &ulValue, qpeekNO_BLOCK ) != pdPASS )\r
                {\r
@@ -424,6 +431,10 @@ unsigned portLONG ulValue;
                        xErrorDetected = pdTRUE;\r
                }\r
 \r
+               #if configUSE_PREEMPTION == 0\r
+                       taskYIELD();\r
+               #endif\r
+\r
                /* This time we should find that the queue is empty.  The high priority\r
                task actually removed the data rather than just peeking it. */\r
                if( xQueuePeek( xQueue, &ulValue, qpeekNO_BLOCK ) != errQUEUE_EMPTY )\r
@@ -436,7 +447,7 @@ unsigned portLONG ulValue;
                and repeat the whole thing.  The medium priority task should not be\r
                suspended as it was not able to peek the data in this last case. */\r
                vTaskResume( xHighPriorityTask );\r
-               vTaskResume( xHighestPriorityTask );            \r
+               vTaskResume( xHighestPriorityTask );\r
 \r
                /* Lets just delay a while as this is an intensive test as we don't\r
                want to starve other tests of processing time. */\r
@@ -446,9 +457,9 @@ unsigned portLONG ulValue;
 /*-----------------------------------------------------------*/\r
 \r
 /* This is called to check that all the created tasks are still running. */\r
-portBASE_TYPE xAreQueuePeekTasksStillRunning( void )\r
+BaseType_t xAreQueuePeekTasksStillRunning( void )\r
 {\r
-static unsigned portLONG ulLastLoopCounter = 0;\r
+static uint32_t ulLastLoopCounter = 0;\r
 \r
        /* If the demo task is still running then we expect the loopcounter to\r
        have incremented since this function was last called. */\r
@@ -462,6 +473,6 @@ static unsigned portLONG ulLastLoopCounter = 0;
        /* Errors detected in the task itself will have latched xErrorDetected\r
        to true. */\r
 \r
-       return !xErrorDetected;\r
+       return ( BaseType_t ) !xErrorDetected;\r
 }\r
 \r