]> git.sur5r.net Git - freertos/blobdiff - Source/list.c
Lowered the thread priorities used by the Win32 port, and added in a method to delete...
[freertos] / Source / list.c
index e77f2f13a6839939a6cbc9d42ea0860c48705e93..0b1002a634211e4f5b3873cf7b85139ae6adb174 100644 (file)
@@ -1,98 +1,56 @@
 /*\r
-       FreeRTOS.org V4.8.0 - Copyright (C) 2003-2008 Richard Barry.\r
-\r
-       This file is part of the FreeRTOS.org distribution.\r
-\r
-       FreeRTOS.org is free software; you can redistribute it and/or modify\r
-       it under the terms of the GNU General Public License as published by\r
-       the Free Software Foundation; either version 2 of the License, or\r
-       (at your option) any later version.\r
-\r
-       FreeRTOS.org is distributed in the hope that it will be useful,\r
-       but WITHOUT ANY WARRANTY; without even the implied warranty of\r
-       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\r
-       GNU General Public License for more details.\r
-\r
-       You should have received a copy of the GNU General Public License\r
-       along with FreeRTOS.org; if not, write to the Free Software\r
-       Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA\r
-\r
-       A special exception to the GPL can be applied should you wish to distribute\r
-       a combined work that includes FreeRTOS.org, without being obliged to provide\r
-       the source code for any proprietary components.  See the licensing section\r
-       of http://www.FreeRTOS.org for full details of how and when the exception\r
-       can be applied.\r
-\r
-       ***************************************************************************\r
-       ***************************************************************************\r
-       *                                                                                                                                                 *\r
-       * SAVE TIME AND MONEY!  Why not get us to quote to get FreeRTOS.org               *\r
-       * running on your hardware - or even write all or part of your application*\r
-       * for you?  See http://www.OpenRTOS.com for details.                                      *\r
-       *                                                                                                                                                 *\r
-       ***************************************************************************\r
-       ***************************************************************************\r
-\r
-       Please ensure to read the configuration and relevant port sections of the\r
-       online documentation.\r
-\r
-       http://www.FreeRTOS.org - Documentation, latest information, license and \r
-       contact details.\r
-\r
-       http://www.SafeRTOS.com - A version that is certified for use in safety \r
-       critical systems.\r
-\r
-       http://www.OpenRTOS.com - Commercial support, development, porting, \r
-       licensing and training services.\r
+    FreeRTOS V6.1.0 - Copyright (C) 2010 Real Time Engineers Ltd.\r
+\r
+    ***************************************************************************\r
+    *                                                                         *\r
+    * If you are:                                                             *\r
+    *                                                                         *\r
+    *    + New to FreeRTOS,                                                   *\r
+    *    + Wanting to learn FreeRTOS or multitasking in general quickly       *\r
+    *    + Looking for basic training,                                        *\r
+    *    + Wanting to improve your FreeRTOS skills and productivity           *\r
+    *                                                                         *\r
+    * then take a look at the FreeRTOS books - available as PDF or paperback  *\r
+    *                                                                         *\r
+    *        "Using the FreeRTOS Real Time Kernel - a Practical Guide"        *\r
+    *                  http://www.FreeRTOS.org/Documentation                  *\r
+    *                                                                         *\r
+    * A pdf reference manual is also available.  Both are usually delivered   *\r
+    * to your inbox within 20 minutes to two hours when purchased between 8am *\r
+    * and 8pm GMT (although please allow up to 24 hours in case of            *\r
+    * exceptional circumstances).  Thank you for your support!                *\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 exception to the GPL is included to allow you to distribute\r
+    a combined work that includes FreeRTOS without being obliged to provide the\r
+    source code for proprietary components outside of the FreeRTOS kernel.\r
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT\r
+    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or\r
+    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
+    http://www.FreeRTOS.org - Documentation, latest information, license and\r
+    contact details.\r
+\r
+    http://www.SafeRTOS.com - A version that is certified for use in safety\r
+    critical systems.\r
+\r
+    http://www.OpenRTOS.com - Commercial support, development, porting,\r
+    licensing and training services.\r
 */\r
 \r
-/*\r
-Changes from V1.2.0\r
-\r
-       + Removed the volatile modifier from the function parameters.  This was\r
-         only ever included to prevent compiler warnings.  Now warnings are\r
-         removed by casting parameters where the calls are made.\r
-\r
-       + prvListGetOwnerOfNextEntry() and prvListGetOwnerOfHeadEntry() have been\r
-         removed from the c file and added as macros to the h file.\r
-\r
-       + uxNumberOfItems has been added to the list structure.  This removes the\r
-         need for a pointer comparison when checking if a list is empty, and so\r
-         is slightly faster.\r
-\r
-       + Removed the NULL check in vListRemove().  This makes the call faster but\r
-         necessitates any application code utilising the list implementation to\r
-         ensure NULL pointers are not passed.\r
-\r
-Changes from V2.0.0\r
-\r
-       + Double linked the lists to allow faster removal item removal.\r
-\r
-Changes from V2.6.1\r
-\r
-       + Make use of the new portBASE_TYPE definition where ever appropriate.\r
-\r
-Changes from V3.0.0\r
-\r
-       + API changes as described on the FreeRTOS.org WEB site.\r
-\r
-Changes from V3.2.4\r
-\r
-       + Removed the pxHead member of the xList structure.  This always pointed\r
-         to the same place so has been removed to free a few bytes of RAM.\r
-\r
-       + Introduced the xMiniListItem structure that does not include the \r
-         xListItem members that are not required by the xListEnd member of a list.\r
-         Again this was done to reduce RAM usage.\r
-\r
-       + Changed the volatile definitions of some structure members to clean up\r
-         the code where the list structures are used.\r
-\r
-Changes from V4.0.4\r
-\r
-       + Optimised vListInsert() in the case when the wake time is the maximum \r
-         tick count value.\r
-*/\r
 \r
 #include <stdlib.h>\r
 #include "FreeRTOS.h"\r
@@ -173,6 +131,22 @@ portTickType xValueOfInsertion;
        }\r
        else\r
        {\r
+               /* *** NOTE ***********************************************************\r
+               If you find your application is crashing here then likely causes are:\r
+                       1) Stack overflow - \r
+                          see http://www.freertos.org/Stacks-and-stack-overflow-checking.html\r
+                       2) Incorrect interrupt priority assignment, especially on Cortex M3 \r
+                          parts where numerically high priority values denote low actual \r
+                          interrupt priories, which can seem counter intuitive.  See \r
+                          configMAX_SYSCALL_INTERRUPT_PRIORITY on http://www.freertos.org/a00110.html\r
+                       3) Calling an API function from within a critical section or when\r
+                          the scheduler is suspended.\r
+                       4) Using a queue or semaphore before it has been initialised or\r
+                          before the scheduler has been started (are interrupts firing\r
+                          before vTaskStartScheduler() has been called?).\r
+               See http://www.freertos.org/FAQHelp.html for more tips. \r
+               **********************************************************************/\r
+               \r
                for( pxIterator = ( xListItem * ) &( pxList->xListEnd ); pxIterator->pxNext->xItemValue <= xValueOfInsertion; pxIterator = pxIterator->pxNext )\r
                {\r
                        /* There is nothing to do here, we are just iterating to the\r