mirror of
				https://github.com/FreeRTOS/FreeRTOS-Kernel.git
				synced 2025-11-04 11:09:01 +01:00 
			
		
		
		
	The difference between a stream buffer and a stream batching buffer is when a task performs read on a non-empty buffer: - The task reading from a non-empty stream buffer returns immediately regardless of the amount of data in the buffer. - The task reading from a non-empty steam batching buffer blocks until the amount of data in the buffer exceeds the trigger level or the block time expires.
		
			
				
	
	
		
			390 lines
		
	
	
		
			26 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			390 lines
		
	
	
		
			26 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*
 | 
						|
 * FreeRTOS Kernel <DEVELOPMENT BRANCH>
 | 
						|
 * Copyright (C) 2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 | 
						|
 *
 | 
						|
 * SPDX-License-Identifier: MIT
 | 
						|
 *
 | 
						|
 * Permission is hereby granted, free of charge, to any person obtaining a copy of
 | 
						|
 * this software and associated documentation files (the "Software"), to deal in
 | 
						|
 * the Software without restriction, including without limitation the rights to
 | 
						|
 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 | 
						|
 * the Software, and to permit persons to whom the Software is furnished to do so,
 | 
						|
 * subject to the following conditions:
 | 
						|
 *
 | 
						|
 * The above copyright notice and this permission notice shall be included in all
 | 
						|
 * copies or substantial portions of the Software.
 | 
						|
 *
 | 
						|
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 | 
						|
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
 | 
						|
 * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 | 
						|
 * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 | 
						|
 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 | 
						|
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 | 
						|
 *
 | 
						|
 * https://www.FreeRTOS.org
 | 
						|
 * https://github.com/FreeRTOS
 | 
						|
 *
 | 
						|
 */
 | 
						|
 | 
						|
/*
 | 
						|
 * When the MPU is used the standard (non MPU) API functions are mapped to
 | 
						|
 * equivalents that start "MPU_", the prototypes for which are defined in this
 | 
						|
 * header files.  This will cause the application code to call the MPU_ version
 | 
						|
 * which wraps the non-MPU version with privilege promoting then demoting code,
 | 
						|
 * so the kernel code always runs will full privileges.
 | 
						|
 */
 | 
						|
 | 
						|
 | 
						|
#ifndef MPU_PROTOTYPES_H
 | 
						|
#define MPU_PROTOTYPES_H
 | 
						|
 | 
						|
typedef struct xTaskGenericNotifyParams
 | 
						|
{
 | 
						|
    TaskHandle_t xTaskToNotify;
 | 
						|
    UBaseType_t uxIndexToNotify;
 | 
						|
    uint32_t ulValue;
 | 
						|
    eNotifyAction eAction;
 | 
						|
    uint32_t * pulPreviousNotificationValue;
 | 
						|
} xTaskGenericNotifyParams_t;
 | 
						|
 | 
						|
typedef struct xTaskGenericNotifyWaitParams
 | 
						|
{
 | 
						|
    UBaseType_t uxIndexToWaitOn;
 | 
						|
    uint32_t ulBitsToClearOnEntry;
 | 
						|
    uint32_t ulBitsToClearOnExit;
 | 
						|
    uint32_t * pulNotificationValue;
 | 
						|
    TickType_t xTicksToWait;
 | 
						|
} xTaskGenericNotifyWaitParams_t;
 | 
						|
 | 
						|
typedef struct xTimerGenericCommandFromTaskParams
 | 
						|
{
 | 
						|
    TimerHandle_t xTimer;
 | 
						|
    BaseType_t xCommandID;
 | 
						|
    TickType_t xOptionalValue;
 | 
						|
    BaseType_t * pxHigherPriorityTaskWoken;
 | 
						|
    TickType_t xTicksToWait;
 | 
						|
} xTimerGenericCommandFromTaskParams_t;
 | 
						|
 | 
						|
typedef struct xEventGroupWaitBitsParams
 | 
						|
{
 | 
						|
    EventGroupHandle_t xEventGroup;
 | 
						|
    EventBits_t uxBitsToWaitFor;
 | 
						|
    BaseType_t xClearOnExit;
 | 
						|
    BaseType_t xWaitForAllBits;
 | 
						|
    TickType_t xTicksToWait;
 | 
						|
} xEventGroupWaitBitsParams_t;
 | 
						|
 | 
						|
/* MPU versions of task.h API functions. */
 | 
						|
void MPU_vTaskDelay( const TickType_t xTicksToDelay ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTaskDelayUntil( TickType_t * const pxPreviousWakeTime,
 | 
						|
                                const TickType_t xTimeIncrement ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTaskAbortDelay( TaskHandle_t xTask ) FREERTOS_SYSTEM_CALL;
 | 
						|
UBaseType_t MPU_uxTaskPriorityGet( const TaskHandle_t xTask ) FREERTOS_SYSTEM_CALL;
 | 
						|
eTaskState MPU_eTaskGetState( TaskHandle_t xTask ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vTaskGetInfo( TaskHandle_t xTask,
 | 
						|
                       TaskStatus_t * pxTaskStatus,
 | 
						|
                       BaseType_t xGetFreeStackSpace,
 | 
						|
                       eTaskState eState ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vTaskSuspend( TaskHandle_t xTaskToSuspend ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vTaskResume( TaskHandle_t xTaskToResume ) FREERTOS_SYSTEM_CALL;
 | 
						|
TickType_t MPU_xTaskGetTickCount( void ) FREERTOS_SYSTEM_CALL;
 | 
						|
UBaseType_t MPU_uxTaskGetNumberOfTasks( void ) FREERTOS_SYSTEM_CALL;
 | 
						|
UBaseType_t MPU_uxTaskGetStackHighWaterMark( TaskHandle_t xTask ) FREERTOS_SYSTEM_CALL;
 | 
						|
configSTACK_DEPTH_TYPE MPU_uxTaskGetStackHighWaterMark2( TaskHandle_t xTask ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vTaskSetApplicationTaskTag( TaskHandle_t xTask,
 | 
						|
                                     TaskHookFunction_t pxHookFunction ) FREERTOS_SYSTEM_CALL;
 | 
						|
TaskHookFunction_t MPU_xTaskGetApplicationTaskTag( TaskHandle_t xTask ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vTaskSetThreadLocalStoragePointer( TaskHandle_t xTaskToSet,
 | 
						|
                                            BaseType_t xIndex,
 | 
						|
                                            void * pvValue ) FREERTOS_SYSTEM_CALL;
 | 
						|
void * MPU_pvTaskGetThreadLocalStoragePointer( TaskHandle_t xTaskToQuery,
 | 
						|
                                               BaseType_t xIndex ) FREERTOS_SYSTEM_CALL;
 | 
						|
TaskHandle_t MPU_xTaskGetIdleTaskHandle( void ) FREERTOS_SYSTEM_CALL;
 | 
						|
UBaseType_t MPU_uxTaskGetSystemState( TaskStatus_t * const pxTaskStatusArray,
 | 
						|
                                      const UBaseType_t uxArraySize,
 | 
						|
                                      configRUN_TIME_COUNTER_TYPE * const pulTotalRunTime ) FREERTOS_SYSTEM_CALL;
 | 
						|
configRUN_TIME_COUNTER_TYPE MPU_ulTaskGetRunTimeCounter( const TaskHandle_t xTask ) FREERTOS_SYSTEM_CALL;
 | 
						|
configRUN_TIME_COUNTER_TYPE MPU_ulTaskGetRunTimePercent( const TaskHandle_t xTask ) FREERTOS_SYSTEM_CALL;
 | 
						|
configRUN_TIME_COUNTER_TYPE MPU_ulTaskGetIdleRunTimeCounter( void ) FREERTOS_SYSTEM_CALL;
 | 
						|
configRUN_TIME_COUNTER_TYPE MPU_ulTaskGetIdleRunTimePercent( void ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTaskGenericNotify( TaskHandle_t xTaskToNotify,
 | 
						|
                                   UBaseType_t uxIndexToNotify,
 | 
						|
                                   uint32_t ulValue,
 | 
						|
                                   eNotifyAction eAction,
 | 
						|
                                   uint32_t * pulPreviousNotificationValue ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTaskGenericNotifyEntry( const xTaskGenericNotifyParams_t * pxParams ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTaskGenericNotifyWait( UBaseType_t uxIndexToWaitOn,
 | 
						|
                                       uint32_t ulBitsToClearOnEntry,
 | 
						|
                                       uint32_t ulBitsToClearOnExit,
 | 
						|
                                       uint32_t * pulNotificationValue,
 | 
						|
                                       TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTaskGenericNotifyWaitEntry( const xTaskGenericNotifyWaitParams_t * pxParams ) FREERTOS_SYSTEM_CALL;
 | 
						|
uint32_t MPU_ulTaskGenericNotifyTake( UBaseType_t uxIndexToWaitOn,
 | 
						|
                                      BaseType_t xClearCountOnExit,
 | 
						|
                                      TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTaskGenericNotifyStateClear( TaskHandle_t xTask,
 | 
						|
                                             UBaseType_t uxIndexToClear ) FREERTOS_SYSTEM_CALL;
 | 
						|
uint32_t MPU_ulTaskGenericNotifyValueClear( TaskHandle_t xTask,
 | 
						|
                                            UBaseType_t uxIndexToClear,
 | 
						|
                                            uint32_t ulBitsToClear ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vTaskSetTimeOutState( TimeOut_t * const pxTimeOut ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTaskCheckForTimeOut( TimeOut_t * const pxTimeOut,
 | 
						|
                                     TickType_t * const pxTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
TaskHandle_t MPU_xTaskGetCurrentTaskHandle( void ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTaskGetSchedulerState( void ) FREERTOS_SYSTEM_CALL;
 | 
						|
 | 
						|
/* Privileged only wrappers for Task APIs. These are needed so that
 | 
						|
 * the application can use opaque handles maintained in mpu_wrappers.c
 | 
						|
 * with all the APIs. */
 | 
						|
BaseType_t MPU_xTaskCreate( TaskFunction_t pxTaskCode,
 | 
						|
                            const char * const pcName,
 | 
						|
                            const configSTACK_DEPTH_TYPE uxStackDepth,
 | 
						|
                            void * const pvParameters,
 | 
						|
                            UBaseType_t uxPriority,
 | 
						|
                            TaskHandle_t * const pxCreatedTask ) PRIVILEGED_FUNCTION;
 | 
						|
TaskHandle_t MPU_xTaskCreateStatic( TaskFunction_t pxTaskCode,
 | 
						|
                                    const char * const pcName,
 | 
						|
                                    const configSTACK_DEPTH_TYPE uxStackDepth,
 | 
						|
                                    void * const pvParameters,
 | 
						|
                                    UBaseType_t uxPriority,
 | 
						|
                                    StackType_t * const puxStackBuffer,
 | 
						|
                                    StaticTask_t * const pxTaskBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
void MPU_vTaskDelete( TaskHandle_t xTaskToDelete ) PRIVILEGED_FUNCTION;
 | 
						|
void MPU_vTaskPrioritySet( TaskHandle_t xTask,
 | 
						|
                           UBaseType_t uxNewPriority ) PRIVILEGED_FUNCTION;
 | 
						|
TaskHandle_t MPU_xTaskGetHandle( const char * pcNameToQuery ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xTaskCallApplicationTaskHook( TaskHandle_t xTask,
 | 
						|
                                             void * pvParameter ) PRIVILEGED_FUNCTION;
 | 
						|
char * MPU_pcTaskGetName( TaskHandle_t xTaskToQuery ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xTaskCreateRestricted( const TaskParameters_t * const pxTaskDefinition,
 | 
						|
                                      TaskHandle_t * pxCreatedTask ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xTaskCreateRestrictedStatic( const TaskParameters_t * const pxTaskDefinition,
 | 
						|
                                            TaskHandle_t * pxCreatedTask ) PRIVILEGED_FUNCTION;
 | 
						|
void MPU_vTaskAllocateMPURegions( TaskHandle_t xTaskToModify,
 | 
						|
                                  const MemoryRegion_t * const xRegions ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xTaskGetStaticBuffers( TaskHandle_t xTask,
 | 
						|
                                      StackType_t ** ppuxStackBuffer,
 | 
						|
                                      StaticTask_t ** ppxTaskBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
UBaseType_t MPU_uxTaskPriorityGetFromISR( const TaskHandle_t xTask ) PRIVILEGED_FUNCTION;
 | 
						|
UBaseType_t MPU_uxTaskBasePriorityGet( const TaskHandle_t xTask ) PRIVILEGED_FUNCTION;
 | 
						|
UBaseType_t MPU_uxTaskBasePriorityGetFromISR( const TaskHandle_t xTask ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xTaskResumeFromISR( TaskHandle_t xTaskToResume ) PRIVILEGED_FUNCTION;
 | 
						|
TaskHookFunction_t MPU_xTaskGetApplicationTaskTagFromISR( TaskHandle_t xTask ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xTaskGenericNotifyFromISR( TaskHandle_t xTaskToNotify,
 | 
						|
                                          UBaseType_t uxIndexToNotify,
 | 
						|
                                          uint32_t ulValue,
 | 
						|
                                          eNotifyAction eAction,
 | 
						|
                                          uint32_t * pulPreviousNotificationValue,
 | 
						|
                                          BaseType_t * pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
 | 
						|
void MPU_vTaskGenericNotifyGiveFromISR( TaskHandle_t xTaskToNotify,
 | 
						|
                                        UBaseType_t uxIndexToNotify,
 | 
						|
                                        BaseType_t * pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
 | 
						|
 | 
						|
/* MPU versions of queue.h API functions. */
 | 
						|
BaseType_t MPU_xQueueGenericSend( QueueHandle_t xQueue,
 | 
						|
                                  const void * const pvItemToQueue,
 | 
						|
                                  TickType_t xTicksToWait,
 | 
						|
                                  const BaseType_t xCopyPosition ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xQueueReceive( QueueHandle_t xQueue,
 | 
						|
                              void * const pvBuffer,
 | 
						|
                              TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xQueuePeek( QueueHandle_t xQueue,
 | 
						|
                           void * const pvBuffer,
 | 
						|
                           TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xQueueSemaphoreTake( QueueHandle_t xQueue,
 | 
						|
                                    TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
UBaseType_t MPU_uxQueueMessagesWaiting( const QueueHandle_t xQueue ) FREERTOS_SYSTEM_CALL;
 | 
						|
UBaseType_t MPU_uxQueueSpacesAvailable( const QueueHandle_t xQueue ) FREERTOS_SYSTEM_CALL;
 | 
						|
TaskHandle_t MPU_xQueueGetMutexHolder( QueueHandle_t xSemaphore ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xQueueTakeMutexRecursive( QueueHandle_t xMutex,
 | 
						|
                                         TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xQueueGiveMutexRecursive( QueueHandle_t pxMutex ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vQueueAddToRegistry( QueueHandle_t xQueue,
 | 
						|
                              const char * pcName ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vQueueUnregisterQueue( QueueHandle_t xQueue ) FREERTOS_SYSTEM_CALL;
 | 
						|
const char * MPU_pcQueueGetName( QueueHandle_t xQueue ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xQueueAddToSet( QueueSetMemberHandle_t xQueueOrSemaphore,
 | 
						|
                               QueueSetHandle_t xQueueSet ) FREERTOS_SYSTEM_CALL;
 | 
						|
QueueSetMemberHandle_t MPU_xQueueSelectFromSet( QueueSetHandle_t xQueueSet,
 | 
						|
                                                const TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vQueueSetQueueNumber( QueueHandle_t xQueue,
 | 
						|
                               UBaseType_t uxQueueNumber ) FREERTOS_SYSTEM_CALL;
 | 
						|
UBaseType_t MPU_uxQueueGetQueueNumber( QueueHandle_t xQueue ) FREERTOS_SYSTEM_CALL;
 | 
						|
uint8_t MPU_ucQueueGetQueueType( QueueHandle_t xQueue ) FREERTOS_SYSTEM_CALL;
 | 
						|
 | 
						|
/* Privileged only wrappers for Queue APIs. These are needed so that
 | 
						|
 * the application can use opaque handles maintained in mpu_wrappers.c
 | 
						|
 * with all the APIs. */
 | 
						|
void MPU_vQueueDelete( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION;
 | 
						|
QueueHandle_t MPU_xQueueCreateMutex( const uint8_t ucQueueType ) PRIVILEGED_FUNCTION;
 | 
						|
QueueHandle_t MPU_xQueueCreateMutexStatic( const uint8_t ucQueueType,
 | 
						|
                                           StaticQueue_t * pxStaticQueue ) PRIVILEGED_FUNCTION;
 | 
						|
QueueHandle_t MPU_xQueueCreateCountingSemaphore( const UBaseType_t uxMaxCount,
 | 
						|
                                                 const UBaseType_t uxInitialCount ) PRIVILEGED_FUNCTION;
 | 
						|
QueueHandle_t MPU_xQueueCreateCountingSemaphoreStatic( const UBaseType_t uxMaxCount,
 | 
						|
                                                       const UBaseType_t uxInitialCount,
 | 
						|
                                                       StaticQueue_t * pxStaticQueue ) PRIVILEGED_FUNCTION;
 | 
						|
QueueHandle_t MPU_xQueueGenericCreate( const UBaseType_t uxQueueLength,
 | 
						|
                                       const UBaseType_t uxItemSize,
 | 
						|
                                       const uint8_t ucQueueType ) PRIVILEGED_FUNCTION;
 | 
						|
QueueHandle_t MPU_xQueueGenericCreateStatic( const UBaseType_t uxQueueLength,
 | 
						|
                                             const UBaseType_t uxItemSize,
 | 
						|
                                             uint8_t * pucQueueStorage,
 | 
						|
                                             StaticQueue_t * pxStaticQueue,
 | 
						|
                                             const uint8_t ucQueueType ) PRIVILEGED_FUNCTION;
 | 
						|
QueueSetHandle_t MPU_xQueueCreateSet( const UBaseType_t uxEventQueueLength ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xQueueRemoveFromSet( QueueSetMemberHandle_t xQueueOrSemaphore,
 | 
						|
                                    QueueSetHandle_t xQueueSet ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xQueueGenericReset( QueueHandle_t xQueue,
 | 
						|
                                   BaseType_t xNewQueue ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xQueueGenericGetStaticBuffers( QueueHandle_t xQueue,
 | 
						|
                                              uint8_t ** ppucQueueStorage,
 | 
						|
                                              StaticQueue_t ** ppxStaticQueue ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xQueueGenericSendFromISR( QueueHandle_t xQueue,
 | 
						|
                                         const void * const pvItemToQueue,
 | 
						|
                                         BaseType_t * const pxHigherPriorityTaskWoken,
 | 
						|
                                         const BaseType_t xCopyPosition ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xQueueGiveFromISR( QueueHandle_t xQueue,
 | 
						|
                                  BaseType_t * const pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xQueuePeekFromISR( QueueHandle_t xQueue,
 | 
						|
                                  void * const pvBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xQueueReceiveFromISR( QueueHandle_t xQueue,
 | 
						|
                                     void * const pvBuffer,
 | 
						|
                                     BaseType_t * const pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xQueueIsQueueEmptyFromISR( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xQueueIsQueueFullFromISR( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION;
 | 
						|
UBaseType_t MPU_uxQueueMessagesWaitingFromISR( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION;
 | 
						|
TaskHandle_t MPU_xQueueGetMutexHolderFromISR( QueueHandle_t xSemaphore ) PRIVILEGED_FUNCTION;
 | 
						|
QueueSetMemberHandle_t MPU_xQueueSelectFromSetFromISR( QueueSetHandle_t xQueueSet ) PRIVILEGED_FUNCTION;
 | 
						|
 | 
						|
/* MPU versions of timers.h API functions. */
 | 
						|
void * MPU_pvTimerGetTimerID( const TimerHandle_t xTimer ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vTimerSetTimerID( TimerHandle_t xTimer,
 | 
						|
                           void * pvNewID ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTimerIsTimerActive( TimerHandle_t xTimer ) FREERTOS_SYSTEM_CALL;
 | 
						|
TaskHandle_t MPU_xTimerGetTimerDaemonTaskHandle( void ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTimerGenericCommandFromTask( TimerHandle_t xTimer,
 | 
						|
                                             const BaseType_t xCommandID,
 | 
						|
                                             const TickType_t xOptionalValue,
 | 
						|
                                             BaseType_t * const pxHigherPriorityTaskWoken,
 | 
						|
                                             const TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTimerGenericCommandFromTaskEntry( const xTimerGenericCommandFromTaskParams_t * pxParams ) FREERTOS_SYSTEM_CALL;
 | 
						|
const char * MPU_pcTimerGetName( TimerHandle_t xTimer ) FREERTOS_SYSTEM_CALL;
 | 
						|
void MPU_vTimerSetReloadMode( TimerHandle_t xTimer,
 | 
						|
                              const BaseType_t uxAutoReload ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xTimerGetReloadMode( TimerHandle_t xTimer ) FREERTOS_SYSTEM_CALL;
 | 
						|
UBaseType_t MPU_uxTimerGetReloadMode( TimerHandle_t xTimer ) FREERTOS_SYSTEM_CALL;
 | 
						|
TickType_t MPU_xTimerGetPeriod( TimerHandle_t xTimer ) FREERTOS_SYSTEM_CALL;
 | 
						|
TickType_t MPU_xTimerGetExpiryTime( TimerHandle_t xTimer ) FREERTOS_SYSTEM_CALL;
 | 
						|
 | 
						|
/* Privileged only wrappers for Timer APIs. These are needed so that
 | 
						|
 * the application can use opaque handles maintained in mpu_wrappers.c
 | 
						|
 * with all the APIs. */
 | 
						|
TimerHandle_t MPU_xTimerCreate( const char * const pcTimerName,
 | 
						|
                                const TickType_t xTimerPeriodInTicks,
 | 
						|
                                const UBaseType_t uxAutoReload,
 | 
						|
                                void * const pvTimerID,
 | 
						|
                                TimerCallbackFunction_t pxCallbackFunction ) PRIVILEGED_FUNCTION;
 | 
						|
TimerHandle_t MPU_xTimerCreateStatic( const char * const pcTimerName,
 | 
						|
                                      const TickType_t xTimerPeriodInTicks,
 | 
						|
                                      const UBaseType_t uxAutoReload,
 | 
						|
                                      void * const pvTimerID,
 | 
						|
                                      TimerCallbackFunction_t pxCallbackFunction,
 | 
						|
                                      StaticTimer_t * pxTimerBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xTimerGetStaticBuffer( TimerHandle_t xTimer,
 | 
						|
                                      StaticTimer_t ** ppxTimerBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xTimerGenericCommandFromISR( TimerHandle_t xTimer,
 | 
						|
                                            const BaseType_t xCommandID,
 | 
						|
                                            const TickType_t xOptionalValue,
 | 
						|
                                            BaseType_t * const pxHigherPriorityTaskWoken,
 | 
						|
                                            const TickType_t xTicksToWait ) PRIVILEGED_FUNCTION;
 | 
						|
 | 
						|
/* MPU versions of event_group.h API functions. */
 | 
						|
EventBits_t MPU_xEventGroupWaitBits( EventGroupHandle_t xEventGroup,
 | 
						|
                                     const EventBits_t uxBitsToWaitFor,
 | 
						|
                                     const BaseType_t xClearOnExit,
 | 
						|
                                     const BaseType_t xWaitForAllBits,
 | 
						|
                                     TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
EventBits_t MPU_xEventGroupWaitBitsEntry( const xEventGroupWaitBitsParams_t * pxParams ) FREERTOS_SYSTEM_CALL;
 | 
						|
EventBits_t MPU_xEventGroupClearBits( EventGroupHandle_t xEventGroup,
 | 
						|
                                      const EventBits_t uxBitsToClear ) FREERTOS_SYSTEM_CALL;
 | 
						|
EventBits_t MPU_xEventGroupSetBits( EventGroupHandle_t xEventGroup,
 | 
						|
                                    const EventBits_t uxBitsToSet ) FREERTOS_SYSTEM_CALL;
 | 
						|
EventBits_t MPU_xEventGroupSync( EventGroupHandle_t xEventGroup,
 | 
						|
                                 const EventBits_t uxBitsToSet,
 | 
						|
                                 const EventBits_t uxBitsToWaitFor,
 | 
						|
                                 TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
#if ( configUSE_TRACE_FACILITY == 1 )
 | 
						|
    UBaseType_t MPU_uxEventGroupGetNumber( void * xEventGroup ) FREERTOS_SYSTEM_CALL;
 | 
						|
    void MPU_vEventGroupSetNumber( void * xEventGroup,
 | 
						|
                                   UBaseType_t uxEventGroupNumber ) FREERTOS_SYSTEM_CALL;
 | 
						|
#endif /* ( configUSE_TRACE_FACILITY == 1 )*/
 | 
						|
 | 
						|
/* Privileged only wrappers for Event Group APIs. These are needed so that
 | 
						|
 * the application can use opaque handles maintained in mpu_wrappers.c
 | 
						|
 * with all the APIs. */
 | 
						|
EventGroupHandle_t MPU_xEventGroupCreate( void ) PRIVILEGED_FUNCTION;
 | 
						|
EventGroupHandle_t MPU_xEventGroupCreateStatic( StaticEventGroup_t * pxEventGroupBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
void MPU_vEventGroupDelete( EventGroupHandle_t xEventGroup ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xEventGroupGetStaticBuffer( EventGroupHandle_t xEventGroup,
 | 
						|
                                           StaticEventGroup_t ** ppxEventGroupBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup,
 | 
						|
                                            const EventBits_t uxBitsToClear ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup,
 | 
						|
                                          const EventBits_t uxBitsToSet,
 | 
						|
                                          BaseType_t * pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
 | 
						|
EventBits_t MPU_xEventGroupGetBitsFromISR( EventGroupHandle_t xEventGroup ) PRIVILEGED_FUNCTION;
 | 
						|
 | 
						|
/* MPU versions of message/stream_buffer.h API functions. */
 | 
						|
size_t MPU_xStreamBufferSend( StreamBufferHandle_t xStreamBuffer,
 | 
						|
                              const void * pvTxData,
 | 
						|
                              size_t xDataLengthBytes,
 | 
						|
                              TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
size_t MPU_xStreamBufferReceive( StreamBufferHandle_t xStreamBuffer,
 | 
						|
                                 void * pvRxData,
 | 
						|
                                 size_t xBufferLengthBytes,
 | 
						|
                                 TickType_t xTicksToWait ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xStreamBufferIsFull( StreamBufferHandle_t xStreamBuffer ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xStreamBufferIsEmpty( StreamBufferHandle_t xStreamBuffer ) FREERTOS_SYSTEM_CALL;
 | 
						|
size_t MPU_xStreamBufferSpacesAvailable( StreamBufferHandle_t xStreamBuffer ) FREERTOS_SYSTEM_CALL;
 | 
						|
size_t MPU_xStreamBufferBytesAvailable( StreamBufferHandle_t xStreamBuffer ) FREERTOS_SYSTEM_CALL;
 | 
						|
BaseType_t MPU_xStreamBufferSetTriggerLevel( StreamBufferHandle_t xStreamBuffer,
 | 
						|
                                             size_t xTriggerLevel ) FREERTOS_SYSTEM_CALL;
 | 
						|
size_t MPU_xStreamBufferNextMessageLengthBytes( StreamBufferHandle_t xStreamBuffer ) FREERTOS_SYSTEM_CALL;
 | 
						|
 | 
						|
/* Privileged only wrappers for Stream Buffer APIs. These are needed so that
 | 
						|
 * the application can use opaque handles maintained in mpu_wrappers.c
 | 
						|
 * with all the APIs. */
 | 
						|
StreamBufferHandle_t MPU_xStreamBufferGenericCreate( size_t xBufferSizeBytes,
 | 
						|
                                                     size_t xTriggerLevelBytes,
 | 
						|
                                                     BaseType_t xStreamBufferType,
 | 
						|
                                                     StreamBufferCallbackFunction_t pxSendCompletedCallback,
 | 
						|
                                                     StreamBufferCallbackFunction_t pxReceiveCompletedCallback ) PRIVILEGED_FUNCTION;
 | 
						|
StreamBufferHandle_t MPU_xStreamBufferGenericCreateStatic( size_t xBufferSizeBytes,
 | 
						|
                                                           size_t xTriggerLevelBytes,
 | 
						|
                                                           BaseType_t xStreamBufferType,
 | 
						|
                                                           uint8_t * const pucStreamBufferStorageArea,
 | 
						|
                                                           StaticStreamBuffer_t * const pxStaticStreamBuffer,
 | 
						|
                                                           StreamBufferCallbackFunction_t pxSendCompletedCallback,
 | 
						|
                                                           StreamBufferCallbackFunction_t pxReceiveCompletedCallback ) PRIVILEGED_FUNCTION;
 | 
						|
void MPU_vStreamBufferDelete( StreamBufferHandle_t xStreamBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xStreamBufferReset( StreamBufferHandle_t xStreamBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xStreamBufferGetStaticBuffers( StreamBufferHandle_t xStreamBuffers,
 | 
						|
                                              uint8_t * ppucStreamBufferStorageArea,
 | 
						|
                                              StaticStreamBuffer_t * ppxStaticStreamBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
size_t MPU_xStreamBufferSendFromISR( StreamBufferHandle_t xStreamBuffer,
 | 
						|
                                     const void * pvTxData,
 | 
						|
                                     size_t xDataLengthBytes,
 | 
						|
                                     BaseType_t * const pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
 | 
						|
size_t MPU_xStreamBufferReceiveFromISR( StreamBufferHandle_t xStreamBuffer,
 | 
						|
                                        void * pvRxData,
 | 
						|
                                        size_t xBufferLengthBytes,
 | 
						|
                                        BaseType_t * const pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xStreamBufferSendCompletedFromISR( StreamBufferHandle_t xStreamBuffer,
 | 
						|
                                                  BaseType_t * pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xStreamBufferReceiveCompletedFromISR( StreamBufferHandle_t xStreamBuffer,
 | 
						|
                                                     BaseType_t * pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
 | 
						|
BaseType_t MPU_xStreamBufferResetFromISR( StreamBufferHandle_t xStreamBuffer ) PRIVILEGED_FUNCTION;
 | 
						|
 | 
						|
#endif /* MPU_PROTOTYPES_H */
 |