mpu_wrappers.h
Go to the documentation of this file.
1 /*
2  FreeRTOS V9.0.0rc2 - Copyright (C) 2016 Real Time Engineers Ltd.
3  All rights reserved
4 
5  VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
6 
7  This file is part of the FreeRTOS distribution.
8 
9  FreeRTOS is free software; you can redistribute it and/or modify it under
10  the terms of the GNU General Public License (version 2) as published by the
11  Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
12 
13  ***************************************************************************
14  >>! NOTE: The modification to the GPL is included to allow you to !<<
15  >>! distribute a combined work that includes FreeRTOS without being !<<
16  >>! obliged to provide the source code for proprietary components !<<
17  >>! outside of the FreeRTOS kernel. !<<
18  ***************************************************************************
19 
20  FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
21  WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
22  FOR A PARTICULAR PURPOSE. Full license text is available on the following
23  link: http://www.freertos.org/a00114.html
24 
25  ***************************************************************************
26  * *
27  * FreeRTOS provides completely free yet professionally developed, *
28  * robust, strictly quality controlled, supported, and cross *
29  * platform software that is more than just the market leader, it *
30  * is the industry's de facto standard. *
31  * *
32  * Help yourself get started quickly while simultaneously helping *
33  * to support the FreeRTOS project by purchasing a FreeRTOS *
34  * tutorial book, reference manual, or both: *
35  * http://www.FreeRTOS.org/Documentation *
36  * *
37  ***************************************************************************
38 
39  http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading
40  the FAQ page "My application does not run, what could be wrong?". Have you
41  defined configASSERT()?
42 
43  http://www.FreeRTOS.org/support - In return for receiving this top quality
44  embedded software for free we request you assist our global community by
45  participating in the support forum.
46 
47  http://www.FreeRTOS.org/training - Investing in training allows your team to
48  be as productive as possible as early as possible. Now you can receive
49  FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
50  Ltd, and the world's leading authority on the world's leading RTOS.
51 
52  http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
53  including FreeRTOS+Trace - an indispensable productivity tool, a DOS
54  compatible FAT file system, and our tiny thread aware UDP/IP stack.
55 
56  http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
57  Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
58 
59  http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
60  Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS
61  licenses offer ticketed support, indemnification and commercial middleware.
62 
63  http://www.SafeRTOS.com - High Integrity Systems also provide a safety
64  engineered and independently SIL3 certified version for use in safety and
65  mission critical applications that require provable dependability.
66 
67  1 tab == 4 spaces!
68 */
69 
70 #ifndef MPU_WRAPPERS_H
71 #define MPU_WRAPPERS_H
72 
73 /* This file redefines API functions to be called through a wrapper macro, but
74 only for ports that are using the MPU. */
75 #ifdef portUSING_MPU_WRAPPERS
76 
77  /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE will be defined when this file is
78  included from queue.c or task.c to prevent it from having an effect within
79  those files. */
80  #ifndef MPU_WRAPPERS_INCLUDED_FROM_API_FILE
81 
82  #define xTaskGenericCreate MPU_xTaskGenericCreate
83  #define vTaskAllocateMPURegions MPU_vTaskAllocateMPURegions
84  #define vTaskDelete MPU_vTaskDelete
85  #define vTaskDelayUntil MPU_vTaskDelayUntil
86  #define vTaskDelay MPU_vTaskDelay
87  #define uxTaskPriorityGet MPU_uxTaskPriorityGet
88  #define vTaskPrioritySet MPU_vTaskPrioritySet
89  #define eTaskGetState MPU_eTaskGetState
90  #define vTaskSuspend MPU_vTaskSuspend
91  #define vTaskResume MPU_vTaskResume
92  #define vTaskSuspendAll MPU_vTaskSuspendAll
93  #define xTaskResumeAll MPU_xTaskResumeAll
94  #define xTaskGetTickCount MPU_xTaskGetTickCount
95  #define uxTaskGetNumberOfTasks MPU_uxTaskGetNumberOfTasks
96  #define vTaskList MPU_vTaskList
97  #define vTaskGetRunTimeStats MPU_vTaskGetRunTimeStats
98  #define vTaskSetApplicationTaskTag MPU_vTaskSetApplicationTaskTag
99  #define xTaskGetApplicationTaskTag MPU_xTaskGetApplicationTaskTag
100  #define xTaskCallApplicationTaskHook MPU_xTaskCallApplicationTaskHook
101  #define uxTaskGetStackHighWaterMark MPU_uxTaskGetStackHighWaterMark
102  #define xTaskGetCurrentTaskHandle MPU_xTaskGetCurrentTaskHandle
103  #define xTaskGetSchedulerState MPU_xTaskGetSchedulerState
104  #define xTaskGetIdleTaskHandle MPU_xTaskGetIdleTaskHandle
105  #define uxTaskGetSystemState MPU_uxTaskGetSystemState
106  #define xTaskGenericNotify MPU_xTaskGenericNotify
107  #define xTaskNotifyWait MPU_xTaskNotifyWait
108  #define ulTaskNotifyTake MPU_ulTaskNotifyTake
109 
110  #define xQueueGenericCreate MPU_xQueueGenericCreate
111  #define xQueueCreateMutex MPU_xQueueCreateMutex
112  #define xQueueGiveMutexRecursive MPU_xQueueGiveMutexRecursive
113  #define xQueueTakeMutexRecursive MPU_xQueueTakeMutexRecursive
114  #define xQueueCreateCountingSemaphore MPU_xQueueCreateCountingSemaphore
115  #define xQueueGenericSend MPU_xQueueGenericSend
116  #define xQueueGenericReceive MPU_xQueueGenericReceive
117  #define uxQueueMessagesWaiting MPU_uxQueueMessagesWaiting
118  #define vQueueDelete MPU_vQueueDelete
119  #define xQueueGenericReset MPU_xQueueGenericReset
120  #define xQueueCreateSet MPU_xQueueCreateSet
121  #define xQueueSelectFromSet MPU_xQueueSelectFromSet
122  #define xQueueAddToSet MPU_xQueueAddToSet
123  #define xQueueRemoveFromSet MPU_xQueueRemoveFromSet
124  #define xQueueGetMutexHolder MPU_xQueueGetMutexHolder
125 
126  #if( configSUPPORT_DYNAMIC_ALLOCATION == 1 )
127  #define pvPortMalloc MPU_pvPortMalloc
128  #define vPortFree MPU_vPortFree
129  #endif /* configSUPPORT_DYNAMIC_ALLOCATION */
130 
131  #define xPortGetFreeHeapSize MPU_xPortGetFreeHeapSize
132  #define vPortInitialiseBlocks MPU_vPortInitialiseBlocks
133  #define xPortGetMinimumEverFreeHeapSize MPU_xPortGetMinimumEverFreeHeapSize
134 
135  #if configQUEUE_REGISTRY_SIZE > 0
136  #define vQueueAddToRegistry MPU_vQueueAddToRegistry
137  #define vQueueUnregisterQueue MPU_vQueueUnregisterQueue
138  #endif
139 
140  #define xTimerCreate MPU_xTimerCreate
141  #define pvTimerGetTimerID MPU_pvTimerGetTimerID
142  #define vTimerSetTimerID MPU_vTimerSetTimerID
143  #define xTimerIsTimerActive MPU_xTimerIsTimerActive
144  #define xTimerGetTimerDaemonTaskHandle MPU_xTimerGetTimerDaemonTaskHandle
145  #define xTimerPendFunctionCall MPU_xTimerPendFunctionCall
146  #define pcTimerGetName MPU_pcTimerGetName
147  #define xTimerGenericCommand MPU_xTimerGenericCommand
148 
149  #define xEventGroupCreate MPU_xEventGroupCreate
150  #define xEventGroupWaitBits MPU_xEventGroupWaitBits
151  #define xEventGroupClearBits MPU_xEventGroupClearBits
152  #define xEventGroupSetBits MPU_xEventGroupSetBits
153  #define xEventGroupSync MPU_xEventGroupSync
154  #define vEventGroupDelete MPU_vEventGroupDelete
155 
156  /* Remove the privileged function macro. */
157  #define PRIVILEGED_FUNCTION
158 
159  #else /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE */
160 
161  /* Ensure API functions go in the privileged execution section. */
162  #define PRIVILEGED_FUNCTION __attribute__((section("privileged_functions")))
163  #define PRIVILEGED_DATA __attribute__((section("privileged_data")))
164 
165  #endif /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE */
166 
167 #else /* portUSING_MPU_WRAPPERS */
168 
169  #define PRIVILEGED_FUNCTION
170  #define PRIVILEGED_DATA
171  #define portUSING_MPU_WRAPPERS 0
172 
173 #endif /* portUSING_MPU_WRAPPERS */
174 
175 
176 #endif /* MPU_WRAPPERS_H */
177