]> git.sur5r.net Git - freertos/blobdiff - FreeRTOS/Demo/Common/Minimal/QPeek.c
Update version number ready for release.
[freertos] / FreeRTOS / Demo / Common / Minimal / QPeek.c
index 0397e1abeb288cc4f0da2e4b903f49e8ece0856d..fee1f63aa14f4df3626a11f02ff6ea27c84199e2 100644 (file)
@@ -1,71 +1,70 @@
 /*\r
-    FreeRTOS V7.1.1 - Copyright (C) 2012 Real Time Engineers Ltd.\r
-       \r
+    FreeRTOS V8.0.1 - Copyright (C) 2014 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 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
+     *    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
-     *    >>> See http://www.FreeRTOS.org/Documentation for details. <<<     *\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 for using FreeRTOS, and thank you for your support!      *\r
+     *    Thank you!                                                         *\r
      *                                                                       *\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
-    >>>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.  FreeRTOS is distributed in the hope that it will be useful, but\r
-    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY\r
-    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for\r
-    more details. You should have received a copy of the GNU General Public\r
-    License and the FreeRTOS license exception along with FreeRTOS; if not it\r
-    can be viewed here: http://www.freertos.org/a00114.html and also obtained\r
-    by writing to Richard Barry, contact details for whom are available on the\r
-    FreeRTOS WEB site.\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   !<<\r
+    >>!   obliged to provide the source code for proprietary components     !<<\r
+    >>!   outside of the FreeRTOS kernel.                                   !<<\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
+    link: http://www.freertos.org/a00114.html\r
 \r
     1 tab == 4 spaces!\r
-    \r
+\r
     ***************************************************************************\r
      *                                                                       *\r
      *    Having a problem?  Start by reading the FAQ "My application does   *\r
-     *    not run, what could be wrong?                                      *\r
+     *    not run, what could be wrong?"                                     *\r
      *                                                                       *\r
      *    http://www.FreeRTOS.org/FAQHelp.html                               *\r
      *                                                                       *\r
     ***************************************************************************\r
 \r
-    \r
-    http://www.FreeRTOS.org - Documentation, training, latest information, \r
-    license and contact details.\r
-    \r
+    http://www.FreeRTOS.org - Documentation, books, training, latest versions,\r
+    license and Real Time Engineers Ltd. contact details.\r
+\r
     http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,\r
-    including FreeRTOS+Trace - an indispensable productivity tool.\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
 \r
-    Real Time Engineers ltd license FreeRTOS to High Integrity Systems, who sell \r
-    the code with commercial support, indemnification, and middleware, under \r
-    the OpenRTOS brand: http://www.OpenRTOS.com.  High Integrity Systems also\r
-    provide a safety engineered and independently SIL3 certified version under \r
-    the SafeRTOS brand: http://www.SafeRTOS.com.\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
@@ -111,47 +110,47 @@ static volatile portBASE_TYPE xErrorDetected = pdFALSE;
 \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 unsigned long 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( unsigned long ) );\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
+unsigned long 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
@@ -203,7 +202,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
@@ -246,15 +245,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
+unsigned long ulValue;\r
 \r
        for( ;; )\r
        {\r
@@ -301,15 +300,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
+unsigned long ulValue;\r
 \r
        for( ;; )\r
        {\r
@@ -349,12 +348,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
+unsigned long 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
@@ -364,6 +363,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
@@ -381,6 +384,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
@@ -394,7 +401,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
@@ -408,6 +415,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
@@ -416,6 +427,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
@@ -428,7 +443,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
@@ -440,7 +455,7 @@ unsigned portLONG ulValue;
 /* This is called to check that all the created tasks are still running. */\r
 portBASE_TYPE xAreQueuePeekTasksStillRunning( void )\r
 {\r
-static unsigned portLONG ulLastLoopCounter = 0;\r
+static unsigned long 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