]> git.sur5r.net Git - freertos/blobdiff - FreeRTOS/Demo/Common/Minimal/QPeek.c
Update version numbers ready for release.
[freertos] / FreeRTOS / Demo / Common / Minimal / QPeek.c
index 18a50ee1358eb04db71a9156fd5d53f279a89714..91946e983d9d1fb3a03242b7de8d5ebf349db2d3 100644 (file)
@@ -1,73 +1,32 @@
 /*\r
-    FreeRTOS V7.3.0 - Copyright (C) 2012 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
-\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
-\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
-     *                                                                       *\r
-     *    http://www.FreeRTOS.org/FAQHelp.html                               *\r
-     *                                                                       *\r
-    ***************************************************************************\r
-\r
-    \r
-    http://www.FreeRTOS.org - Documentation, training, latest versions, license \r
-    and contact details.  \r
-    \r
-    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,\r
-    including FreeRTOS+Trace - an indispensable productivity tool.\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
-*/\r
-\r
-\r
-/* \r
+ * FreeRTOS Kernel V10.1.1\r
+ * Copyright (C) 2018 Amazon.com, Inc. or its affiliates.  All Rights Reserved.\r
+ *\r
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of\r
+ * this software and associated documentation files (the "Software"), to deal in\r
+ * the Software without restriction, including without limitation the rights to\r
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\r
+ * the Software, and to permit persons to whom the Software is furnished to do so,\r
+ * subject to the following conditions:\r
+ *\r
+ * The above copyright notice and this permission notice shall be included in all\r
+ * copies or substantial portions of the Software.\r
+ *\r
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\r
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\r
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\r
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\r
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
+ *\r
+ * http://www.FreeRTOS.org\r
+ * http://aws.amazon.com/freertos\r
+ *\r
+ * 1 tab == 4 spaces!\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
@@ -109,51 +68,54 @@ 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
-\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
-       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
-       defined to be less than 1. */\r
-       vQueueAddToRegistry( xQueue, ( signed portCHAR * ) "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
+       xQueue = xQueueCreate( qpeekQUEUE_LENGTH, sizeof( uint32_t ) );\r
+\r
+       if( xQueue != NULL )\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
+               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
+               defined to be less than 1. */\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, "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
 \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
@@ -205,7 +167,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
@@ -248,15 +210,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
@@ -303,15 +265,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
@@ -351,12 +313,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
@@ -366,6 +328,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
@@ -383,6 +349,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
@@ -396,7 +366,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
@@ -410,6 +380,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
@@ -418,6 +392,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
@@ -430,7 +408,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,9 +418,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
@@ -456,6 +434,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