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

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