begriffs open source - freertos/blob - include/mpu_wrappers.h

   1 /*\r
   2  * FreeRTOS Kernel V10.4.3 LTS Patch 3\r
   3  * Copyright (C) 2020 Amazon.com, Inc. or its affiliates.  All Rights Reserved.\r
   4  *\r
   5  * Permission is hereby granted, free of charge, to any person obtaining a copy of\r
   6  * this software and associated documentation files (the "Software"), to deal in\r
   7  * the Software without restriction, including without limitation the rights to\r
   8  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\r
   9  * the Software, and to permit persons to whom the Software is furnished to do so,\r
  10  * subject to the following conditions:\r
  11  *\r
  12  * The above copyright notice and this permission notice shall be included in all\r
  13  * copies or substantial portions of the Software.\r
  14  *\r
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\r
  17  * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\r
  18  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\r
  19  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\r
  20  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
  21  *\r
  22  * https://www.FreeRTOS.org\r
  23  * https://github.com/FreeRTOS\r
  24  *\r
  25  */\r
  26 \r
  27 #ifndef MPU_WRAPPERS_H\r
  28 #define MPU_WRAPPERS_H\r
  29 \r
  30 /* This file redefines API functions to be called through a wrapper macro, but\r
  31  * only for ports that are using the MPU. */\r
  32 #ifdef portUSING_MPU_WRAPPERS\r
  33 \r
  34 /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE will be defined when this file is\r
  35  * included from queue.c or task.c to prevent it from having an effect within\r
  36  * those files. */\r
  37     #ifndef MPU_WRAPPERS_INCLUDED_FROM_API_FILE\r
  38 \r
  39 /*\r
  40  * Map standard (non MPU) API functions to equivalents that start\r
  41  * "MPU_".  This will cause the application code to call the MPU_\r
  42  * version, which wraps the non-MPU version with privilege promoting\r
  43  * then demoting code, so the kernel code always runs will full\r
  44  * privileges.\r
  45  */\r
  46 \r
  47 /* Map standard tasks.h API functions to the MPU equivalents. */\r
  48         #define xTaskCreate                            MPU_xTaskCreate\r
  49         #define xTaskCreateStatic                      MPU_xTaskCreateStatic\r
  50         #define vTaskDelete                            MPU_vTaskDelete\r
  51         #define vTaskDelay                             MPU_vTaskDelay\r
  52         #define xTaskDelayUntil                        MPU_xTaskDelayUntil\r
  53         #define xTaskAbortDelay                        MPU_xTaskAbortDelay\r
  54         #define uxTaskPriorityGet                      MPU_uxTaskPriorityGet\r
  55         #define eTaskGetState                          MPU_eTaskGetState\r
  56         #define vTaskGetInfo                           MPU_vTaskGetInfo\r
  57         #define vTaskPrioritySet                       MPU_vTaskPrioritySet\r
  58         #define vTaskSuspend                           MPU_vTaskSuspend\r
  59         #define vTaskResume                            MPU_vTaskResume\r
  60         #define vTaskSuspendAll                        MPU_vTaskSuspendAll\r
  61         #define xTaskResumeAll                         MPU_xTaskResumeAll\r
  62         #define xTaskGetTickCount                      MPU_xTaskGetTickCount\r
  63         #define uxTaskGetNumberOfTasks                 MPU_uxTaskGetNumberOfTasks\r
  64         #define pcTaskGetName                          MPU_pcTaskGetName\r
  65         #define xTaskGetHandle                         MPU_xTaskGetHandle\r
  66         #define uxTaskGetStackHighWaterMark            MPU_uxTaskGetStackHighWaterMark\r
  67         #define uxTaskGetStackHighWaterMark2           MPU_uxTaskGetStackHighWaterMark2\r
  68         #define vTaskSetApplicationTaskTag             MPU_vTaskSetApplicationTaskTag\r
  69         #define xTaskGetApplicationTaskTag             MPU_xTaskGetApplicationTaskTag\r
  70         #define vTaskSetThreadLocalStoragePointer      MPU_vTaskSetThreadLocalStoragePointer\r
  71         #define pvTaskGetThreadLocalStoragePointer     MPU_pvTaskGetThreadLocalStoragePointer\r
  72         #define xTaskCallApplicationTaskHook           MPU_xTaskCallApplicationTaskHook\r
  73         #define xTaskGetIdleTaskHandle                 MPU_xTaskGetIdleTaskHandle\r
  74         #define uxTaskGetSystemState                   MPU_uxTaskGetSystemState\r
  75         #define vTaskList                              MPU_vTaskList\r
  76         #define vTaskGetRunTimeStats                   MPU_vTaskGetRunTimeStats\r
  77         #define ulTaskGetIdleRunTimeCounter            MPU_ulTaskGetIdleRunTimeCounter\r
  78         #define xTaskGenericNotify                     MPU_xTaskGenericNotify\r
  79         #define xTaskGenericNotifyWait                 MPU_xTaskGenericNotifyWait\r
  80         #define ulTaskGenericNotifyTake                MPU_ulTaskGenericNotifyTake\r
  81         #define xTaskGenericNotifyStateClear           MPU_xTaskGenericNotifyStateClear\r
  82         #define ulTaskGenericNotifyValueClear          MPU_ulTaskGenericNotifyValueClear\r
  83         #define xTaskCatchUpTicks                      MPU_xTaskCatchUpTicks\r
  84 \r
  85         #define xTaskGetCurrentTaskHandle              MPU_xTaskGetCurrentTaskHandle\r
  86         #define vTaskSetTimeOutState                   MPU_vTaskSetTimeOutState\r
  87         #define xTaskCheckForTimeOut                   MPU_xTaskCheckForTimeOut\r
  88         #define xTaskGetSchedulerState                 MPU_xTaskGetSchedulerState\r
  89 \r
  90 /* Map standard queue.h API functions to the MPU equivalents. */\r
  91         #define xQueueGenericSend                      MPU_xQueueGenericSend\r
  92         #define xQueueReceive                          MPU_xQueueReceive\r
  93         #define xQueuePeek                             MPU_xQueuePeek\r
  94         #define xQueueSemaphoreTake                    MPU_xQueueSemaphoreTake\r
  95         #define uxQueueMessagesWaiting                 MPU_uxQueueMessagesWaiting\r
  96         #define uxQueueSpacesAvailable                 MPU_uxQueueSpacesAvailable\r
  97         #define vQueueDelete                           MPU_vQueueDelete\r
  98         #define xQueueCreateMutex                      MPU_xQueueCreateMutex\r
  99         #define xQueueCreateMutexStatic                MPU_xQueueCreateMutexStatic\r
 100         #define xQueueCreateCountingSemaphore          MPU_xQueueCreateCountingSemaphore\r
 101         #define xQueueCreateCountingSemaphoreStatic    MPU_xQueueCreateCountingSemaphoreStatic\r
 102         #define xQueueGetMutexHolder                   MPU_xQueueGetMutexHolder\r
 103         #define xQueueTakeMutexRecursive               MPU_xQueueTakeMutexRecursive\r
 104         #define xQueueGiveMutexRecursive               MPU_xQueueGiveMutexRecursive\r
 105         #define xQueueGenericCreate                    MPU_xQueueGenericCreate\r
 106         #define xQueueGenericCreateStatic              MPU_xQueueGenericCreateStatic\r
 107         #define xQueueCreateSet                        MPU_xQueueCreateSet\r
 108         #define xQueueAddToSet                         MPU_xQueueAddToSet\r
 109         #define xQueueRemoveFromSet                    MPU_xQueueRemoveFromSet\r
 110         #define xQueueSelectFromSet                    MPU_xQueueSelectFromSet\r
 111         #define xQueueGenericReset                     MPU_xQueueGenericReset\r
 112 \r
 113         #if ( configQUEUE_REGISTRY_SIZE > 0 )\r
 114             #define vQueueAddToRegistry                MPU_vQueueAddToRegistry\r
 115             #define vQueueUnregisterQueue              MPU_vQueueUnregisterQueue\r
 116             #define pcQueueGetName                     MPU_pcQueueGetName\r
 117         #endif\r
 118 \r
 119 /* Map standard timer.h API functions to the MPU equivalents. */\r
 120         #define pvTimerGetTimerID                      MPU_pvTimerGetTimerID\r
 121         #define vTimerSetTimerID                       MPU_vTimerSetTimerID\r
 122         #define xTimerIsTimerActive                    MPU_xTimerIsTimerActive\r
 123         #define xTimerGetTimerDaemonTaskHandle         MPU_xTimerGetTimerDaemonTaskHandle\r
 124         #define pcTimerGetName                         MPU_pcTimerGetName\r
 125         #define vTimerSetReloadMode                    MPU_vTimerSetReloadMode\r
 126         #define uxTimerGetReloadMode                   MPU_uxTimerGetReloadMode\r
 127         #define xTimerGetPeriod                        MPU_xTimerGetPeriod\r
 128         #define xTimerGetExpiryTime                    MPU_xTimerGetExpiryTime\r
 129         #define xTimerGenericCommand                   MPU_xTimerGenericCommand\r
 130 \r
 131 /* Map standard event_group.h API functions to the MPU equivalents. */\r
 132         #define xEventGroupCreate                      MPU_xEventGroupCreate\r
 133         #define xEventGroupCreateStatic                MPU_xEventGroupCreateStatic\r
 134         #define xEventGroupWaitBits                    MPU_xEventGroupWaitBits\r
 135         #define xEventGroupClearBits                   MPU_xEventGroupClearBits\r
 136         #define xEventGroupSetBits                     MPU_xEventGroupSetBits\r
 137         #define xEventGroupSync                        MPU_xEventGroupSync\r
 138         #define vEventGroupDelete                      MPU_vEventGroupDelete\r
 139 \r
 140 /* Map standard message/stream_buffer.h API functions to the MPU\r
 141  * equivalents. */\r
 142         #define xStreamBufferSend                      MPU_xStreamBufferSend\r
 143         #define xStreamBufferReceive                   MPU_xStreamBufferReceive\r
 144         #define xStreamBufferNextMessageLengthBytes    MPU_xStreamBufferNextMessageLengthBytes\r
 145         #define vStreamBufferDelete                    MPU_vStreamBufferDelete\r
 146         #define xStreamBufferIsFull                    MPU_xStreamBufferIsFull\r
 147         #define xStreamBufferIsEmpty                   MPU_xStreamBufferIsEmpty\r
 148         #define xStreamBufferReset                     MPU_xStreamBufferReset\r
 149         #define xStreamBufferSpacesAvailable           MPU_xStreamBufferSpacesAvailable\r
 150         #define xStreamBufferBytesAvailable            MPU_xStreamBufferBytesAvailable\r
 151         #define xStreamBufferSetTriggerLevel           MPU_xStreamBufferSetTriggerLevel\r
 152         #define xStreamBufferGenericCreate             MPU_xStreamBufferGenericCreate\r
 153         #define xStreamBufferGenericCreateStatic       MPU_xStreamBufferGenericCreateStatic\r
 154 \r
 155 \r
 156 /* Remove the privileged function macro, but keep the PRIVILEGED_DATA\r
 157  * macro so applications can place data in privileged access sections\r
 158  * (useful when using statically allocated objects). */\r
 159         #define PRIVILEGED_FUNCTION\r
 160         #define PRIVILEGED_DATA    __attribute__( ( section( "privileged_data" ) ) )\r
 161         #define FREERTOS_SYSTEM_CALL\r
 162 \r
 163     #else /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE */\r
 164 \r
 165         /* Ensure API functions go in the privileged execution section. */\r
 166         #define PRIVILEGED_FUNCTION     __attribute__( ( section( "privileged_functions" ) ) )\r
 167         #define PRIVILEGED_DATA         __attribute__( ( section( "privileged_data" ) ) )\r
 168         #define FREERTOS_SYSTEM_CALL    __attribute__( ( section( "freertos_system_calls" ) ) )\r
 169 \r
 170     #endif /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE */\r
 171 \r
 172 #else /* portUSING_MPU_WRAPPERS */\r
 173 \r
 174     #define PRIVILEGED_FUNCTION\r
 175     #define PRIVILEGED_DATA\r
 176     #define FREERTOS_SYSTEM_CALL\r
 177     #define portUSING_MPU_WRAPPERS    0\r
 178 \r
 179 #endif /* portUSING_MPU_WRAPPERS */\r
 180 \r
 181 \r
 182 #endif /* MPU_WRAPPERS_H */\r