]> git.sur5r.net Git - freertos/blobdiff - FreeRTOS/Demo/Common/Minimal/death.c
Update to MIT licensed FreeRTOS V10.0.0 - see https://www.freertos.org/History.txt
[freertos] / FreeRTOS / Demo / Common / Minimal / death.c
index 71f1f4ee6ac52c4410307d6d6a6206b848b10809..986d58a3be92bc828460cd45b8d024f245ded957 100644 (file)
@@ -1,68 +1,30 @@
 /*\r
-    FreeRTOS V7.1.1 - Copyright (C) 2012 Real Time Engineers Ltd.\r
-       \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 information, \r
-    license 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
+ * FreeRTOS Kernel V10.0.0\r
+ * Copyright (C) 2017 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. If you wish to use our Amazon\r
+ * FreeRTOS name, please do so in a fair use way that does not cause confusion.\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
  * Create a single persistent task which periodically dynamically creates another\r
  * <HR>\r
  */\r
 \r
-/*\r
-Changes from V3.0.0\r
-       + CreationCount sizes changed from unsigned portBASE_TYPE to\r
-         unsigned short to minimize the risk of overflowing.\r
-       \r
-       + Reset of usLastCreationCount added\r
-       \r
-Changes from V3.1.0\r
-       + Changed the dummy calculation to use variables of type long, rather than\r
-         float.  This allows the file to be used with ports that do not support\r
-         floating point.\r
-\r
-*/\r
 \r
 #include <stdlib.h>\r
 \r
@@ -117,67 +66,47 @@ static portTASK_FUNCTION_PROTO( vSuicidalTask, pvParameters );
 \r
 /* A variable which is incremented every time the dynamic tasks are created.  This\r
 is used to check that the task is still running. */\r
-static volatile unsigned short usCreationCount = 0;\r
+static volatile uint16_t usCreationCount = 0;\r
 \r
 /* Used to store the number of tasks that were originally running so the creator\r
 task can tell if any of the suicidal tasks have failed to die.\r
 */\r
-static volatile unsigned portBASE_TYPE uxTasksRunningAtStart = 0;\r
+static volatile UBaseType_t uxTasksRunningAtStart = 0;\r
 \r
-/* Tasks are deleted by the idle task.  Under heavy load the idle task might\r
-not get much processing time, so it would be legitimate for several tasks to\r
-remain undeleted for a short period. */\r
-static const unsigned portBASE_TYPE uxMaxNumberOfExtraTasksRunning = 2;\r
+/* When a task deletes itself, it stack and TCB are cleaned up by the Idle task.\r
+Under heavy load the idle task might not get much processing time, so it would\r
+be legitimate for several tasks to remain undeleted for a short period.  There\r
+may also be a few other unexpected tasks if, for example, the tasks that test\r
+static allocation are also being used. */\r
+static const UBaseType_t uxMaxNumberOfExtraTasksRunning = 3;\r
 \r
 /* Used to store a handle to the task that should be killed by a suicidal task,\r
 before it kills itself. */\r
-xTaskHandle xCreatedTask;\r
+TaskHandle_t xCreatedTask;\r
 \r
 /*-----------------------------------------------------------*/\r
 \r
-void vCreateSuicidalTasks( unsigned portBASE_TYPE uxPriority )\r
+void vCreateSuicidalTasks( UBaseType_t uxPriority )\r
 {\r
-unsigned portBASE_TYPE *puxPriority;\r
-\r
-       /* Create the Creator tasks - passing in as a parameter the priority at which\r
-       the suicidal tasks should be created. */\r
-       puxPriority = ( unsigned portBASE_TYPE * ) pvPortMalloc( sizeof( unsigned portBASE_TYPE ) );\r
-       *puxPriority = uxPriority;\r
-\r
-       xTaskCreate( vCreateTasks, ( signed char * ) "CREATOR", deathSTACK_SIZE, ( void * ) puxPriority, uxPriority, NULL );\r
-\r
-       /* Record the number of tasks that are running now so we know if any of the\r
-       suicidal tasks have failed to be killed. */\r
-       uxTasksRunningAtStart = ( unsigned portBASE_TYPE ) uxTaskGetNumberOfTasks();\r
-       \r
-       /* FreeRTOS.org versions before V3.0 started the idle-task as the very\r
-       first task. The idle task was then already included in uxTasksRunningAtStart.\r
-       From FreeRTOS V3.0 on, the idle task is started when the scheduler is\r
-       started. Therefore the idle task is not yet accounted for. We correct\r
-       this by increasing uxTasksRunningAtStart by 1. */\r
-       uxTasksRunningAtStart++;\r
-       \r
-       /* From FreeRTOS version 7.0.0 can optionally create a timer service task.  \r
-       If this is done, then uxTasksRunningAtStart needs incrementing again as that\r
-       too is created when the scheduler is started. */\r
-       #if configUSE_TIMERS == 1\r
-               uxTasksRunningAtStart++;\r
-       #endif\r
+       xTaskCreate( vCreateTasks, "CREATOR", deathSTACK_SIZE, ( void * ) NULL, uxPriority, NULL );\r
 }\r
 /*-----------------------------------------------------------*/\r
-                                       \r
+\r
 static portTASK_FUNCTION( vSuicidalTask, pvParameters )\r
 {\r
 volatile long l1, l2;\r
-xTaskHandle xTaskToKill;\r
-const portTickType xDelay = ( portTickType ) 200 / portTICK_RATE_MS;\r
+TaskHandle_t xTaskToKill;\r
+const TickType_t xDelay = pdMS_TO_TICKS( ( TickType_t ) 200 );\r
+\r
+       /* Test deletion of a task's secure context, if any. */\r
+       portTASK_CALLS_SECURE_FUNCTIONS();\r
 \r
        if( pvParameters != NULL )\r
        {\r
                /* This task is periodically created four times.  Two created tasks are\r
                passed a handle to the other task so it can kill it before killing itself.\r
                The other task is passed in null. */\r
-               xTaskToKill = *( xTaskHandle* )pvParameters;\r
+               xTaskToKill = *( TaskHandle_t* )pvParameters;\r
        }\r
        else\r
        {\r
@@ -195,7 +124,7 @@ const portTickType xDelay = ( portTickType ) 200 / portTICK_RATE_MS;
                if( xTaskToKill != NULL )\r
                {\r
                        /* Make sure the other task has a go before we delete it. */\r
-                       vTaskDelay( ( portTickType ) 0 );\r
+                       vTaskDelay( ( TickType_t ) 0 );\r
 \r
                        /* Kill the other task that was created by vCreateTasks(). */\r
                        vTaskDelete( xTaskToKill );\r
@@ -209,11 +138,18 @@ const portTickType xDelay = ( portTickType ) 200 / portTICK_RATE_MS;
 \r
 static portTASK_FUNCTION( vCreateTasks, pvParameters )\r
 {\r
-const portTickType xDelay = ( portTickType ) 1000 / portTICK_RATE_MS;\r
-unsigned portBASE_TYPE uxPriority;\r
+const TickType_t xDelay = pdMS_TO_TICKS( ( TickType_t ) 1000 );\r
+UBaseType_t uxPriority;\r
 \r
-       uxPriority = *( unsigned portBASE_TYPE * ) pvParameters;\r
-       vPortFree( pvParameters );\r
+       /* Remove compiler warning about unused parameter. */\r
+       ( void ) pvParameters;\r
+\r
+       /* Delay at the start to ensure tasks created by other demos have been\r
+       created before storing the current number of tasks. */\r
+       vTaskDelay( xDelay );\r
+       uxTasksRunningAtStart = ( UBaseType_t ) uxTaskGetNumberOfTasks();\r
+\r
+       uxPriority = uxTaskPriorityGet( NULL );\r
 \r
        for( ;; )\r
        {\r
@@ -222,8 +158,8 @@ unsigned portBASE_TYPE uxPriority;
 \r
                xCreatedTask = NULL;\r
 \r
-               xTaskCreate( vSuicidalTask, ( signed char * ) "SUICID1", configMINIMAL_STACK_SIZE, NULL, uxPriority, &xCreatedTask );\r
-               xTaskCreate( vSuicidalTask, ( signed char * ) "SUICID2", configMINIMAL_STACK_SIZE, &xCreatedTask, uxPriority, NULL );\r
+               xTaskCreate( vSuicidalTask, "SUICID1", configMINIMAL_STACK_SIZE, NULL, uxPriority, &xCreatedTask );\r
+               xTaskCreate( vSuicidalTask, "SUICID2", configMINIMAL_STACK_SIZE, &xCreatedTask, uxPriority, NULL );\r
 \r
                ++usCreationCount;\r
        }\r
@@ -232,11 +168,11 @@ unsigned portBASE_TYPE uxPriority;
 \r
 /* This is called to check that the creator task is still running and that there\r
 are not any more than four extra tasks. */\r
-portBASE_TYPE xIsCreateTaskStillRunning( void )\r
+BaseType_t xIsCreateTaskStillRunning( void )\r
 {\r
-static unsigned short usLastCreationCount = 0xfff;\r
-portBASE_TYPE xReturn = pdTRUE;\r
-static unsigned portBASE_TYPE uxTasksRunningNow;\r
+static uint16_t usLastCreationCount = 0xfff;\r
+BaseType_t xReturn = pdTRUE;\r
+static UBaseType_t uxTasksRunningNow;\r
 \r
        if( usLastCreationCount == usCreationCount )\r
        {\r
@@ -246,8 +182,8 @@ static unsigned portBASE_TYPE uxTasksRunningNow;
        {\r
                usLastCreationCount = usCreationCount;\r
        }\r
-       \r
-       uxTasksRunningNow = ( unsigned portBASE_TYPE ) uxTaskGetNumberOfTasks();\r
+\r
+       uxTasksRunningNow = ( UBaseType_t ) uxTaskGetNumberOfTasks();\r
 \r
        if( uxTasksRunningNow < uxTasksRunningAtStart )\r
        {\r