]> git.sur5r.net Git - freertos/blob - Source/portable/MemMang/heap_1.c
3289ff92cbe3046c82b61ebedfa6d551da36facc
[freertos] / Source / portable / MemMang / heap_1.c
1 /*\r
2         FreeRTOS V5.4.2 - Copyright (C) 2009 Real Time Engineers Ltd.\r
3 \r
4         This file is part of the FreeRTOS distribution.\r
5 \r
6         FreeRTOS is free software; you can redistribute it and/or modify it     under \r
7         the terms of the GNU General Public License (version 2) as published by the \r
8         Free Software Foundation and modified by the FreeRTOS exception.\r
9         **NOTE** The exception to the GPL is included to allow you to distribute a\r
10         combined work that includes FreeRTOS without being obliged to provide the \r
11         source code for proprietary components outside of the FreeRTOS kernel.  \r
12         Alternative commercial license and support terms are also available upon \r
13         request.  See the licensing section of http://www.FreeRTOS.org for full \r
14         license details.\r
15 \r
16         FreeRTOS is distributed in the hope that it will be useful,     but WITHOUT\r
17         ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or\r
18         FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for\r
19         more details.\r
20 \r
21         You should have received a copy of the GNU General Public License along\r
22         with FreeRTOS; if not, write to the Free Software Foundation, Inc., 59\r
23         Temple Place, Suite 330, Boston, MA  02111-1307  USA.\r
24 \r
25 \r
26         ***************************************************************************\r
27         *                                                                         *\r
28         * Looking for a quick start?  Then check out the FreeRTOS eBook!          *\r
29         * See http://www.FreeRTOS.org/Documentation for details                   *\r
30         *                                                                         *\r
31         ***************************************************************************\r
32 \r
33         1 tab == 4 spaces!\r
34 \r
35         Please ensure to read the configuration and relevant port sections of the\r
36         online documentation.\r
37 \r
38         http://www.FreeRTOS.org - Documentation, latest information, license and\r
39         contact details.\r
40 \r
41         http://www.SafeRTOS.com - A version that is certified for use in safety\r
42         critical systems.\r
43 \r
44         http://www.OpenRTOS.com - Commercial support, development, porting,\r
45         licensing and training services.\r
46 */\r
47 \r
48 \r
49 /*\r
50  * The simplest possible implementation of pvPortMalloc().  Note that this\r
51  * implementation does NOT allow allocated memory to be freed again.\r
52  *\r
53  * See heap_2.c and heap_3.c for alternative implementations, and the memory\r
54  * management pages of http://www.FreeRTOS.org for more information.\r
55  */\r
56 #include <stdlib.h>\r
57 #include "FreeRTOS.h"\r
58 #include "task.h"\r
59 \r
60 /* Setup the correct byte alignment mask for the defined byte alignment. */\r
61 \r
62 #if portBYTE_ALIGNMENT == 8\r
63         #define heapBYTE_ALIGNMENT_MASK ( ( size_t ) 0x0007 )\r
64 #endif\r
65 \r
66 #if portBYTE_ALIGNMENT == 4\r
67         #define heapBYTE_ALIGNMENT_MASK ( ( size_t ) 0x0003 )\r
68 #endif\r
69 \r
70 #if portBYTE_ALIGNMENT == 2\r
71         #define heapBYTE_ALIGNMENT_MASK ( ( size_t ) 0x0001 )\r
72 #endif\r
73 \r
74 #if portBYTE_ALIGNMENT == 1 \r
75         #define heapBYTE_ALIGNMENT_MASK ( ( size_t ) 0x0000 )\r
76 #endif\r
77 \r
78 #ifndef heapBYTE_ALIGNMENT_MASK\r
79         #error "Invalid portBYTE_ALIGNMENT definition"\r
80 #endif\r
81 \r
82 /* Allocate the memory for the heap.  The struct is used to force byte\r
83 alignment without using any non-portable code. */\r
84 static union xRTOS_HEAP\r
85 {\r
86         #if portBYTE_ALIGNMENT == 8\r
87                 volatile portDOUBLE dDummy;\r
88         #else\r
89                 volatile unsigned portLONG ulDummy;\r
90         #endif  \r
91         unsigned portCHAR ucHeap[ configTOTAL_HEAP_SIZE ];\r
92 } xHeap;\r
93 \r
94 static size_t xNextFreeByte = ( size_t ) 0;\r
95 /*-----------------------------------------------------------*/\r
96 \r
97 void *pvPortMalloc( size_t xWantedSize )\r
98 {\r
99 void *pvReturn = NULL; \r
100 \r
101         /* Ensure that blocks are always aligned to the required number of bytes. */\r
102         #if portBYTE_ALIGNMENT != 1\r
103                 if( xWantedSize & heapBYTE_ALIGNMENT_MASK )\r
104                 {\r
105                         /* Byte alignment required. */\r
106                         xWantedSize += ( portBYTE_ALIGNMENT - ( xWantedSize & heapBYTE_ALIGNMENT_MASK ) );\r
107                 }\r
108         #endif\r
109 \r
110         vTaskSuspendAll();\r
111         {\r
112                 /* Check there is enough room left for the allocation. */\r
113                 if( ( ( xNextFreeByte + xWantedSize ) < configTOTAL_HEAP_SIZE ) &&\r
114                         ( ( xNextFreeByte + xWantedSize ) > xNextFreeByte )     )/* Check for overflow. */\r
115                 {\r
116                         /* Return the next free byte then increment the index past this\r
117                         block. */\r
118                         pvReturn = &( xHeap.ucHeap[ xNextFreeByte ] );\r
119                         xNextFreeByte += xWantedSize;                   \r
120                 }       \r
121         }\r
122         xTaskResumeAll();\r
123         \r
124         #if( configUSE_MALLOC_FAILED_HOOK == 1 )\r
125         {\r
126                 if( pvReturn == NULL )\r
127                 {\r
128                         extern void vApplicationMallocFailedHook( void );\r
129                         vApplicationMallocFailedHook();\r
130                 }\r
131         }\r
132         #endif  \r
133 \r
134         return pvReturn;\r
135 }\r
136 /*-----------------------------------------------------------*/\r
137 \r
138 void vPortFree( void *pv )\r
139 {\r
140         /* Memory cannot be freed using this scheme.  See heap_2.c and heap_3.c \r
141         for alternative implementations, and the memory management pages of \r
142         http://www.FreeRTOS.org for more information. */\r
143         ( void ) pv;\r
144 }\r
145 /*-----------------------------------------------------------*/\r
146 \r
147 void vPortInitialiseBlocks( void )\r
148 {\r
149         /* Only required when static memory is not cleared. */\r
150         xNextFreeByte = ( size_t ) 0;\r
151 }\r
152 \r
153 \r