mirror of
https://github.com/FreeRTOS/FreeRTOS-Kernel.git
synced 2025-11-04 11:09:01 +01:00
de276eb023
* Fix spelling --------- Co-authored-by: Rahul Kar <118818625+kar-rahul-aws@users.noreply.github.com>
115 lines
3.7 KiB
C
115 lines
3.7 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
|
|
*
|
|
*/
|
|
|
|
#ifndef __PORT_ASM_H__
|
|
#define __PORT_ASM_H__
|
|
|
|
/* Scheduler includes. */
|
|
#include "FreeRTOS.h"
|
|
|
|
/* MPU wrappers includes. */
|
|
#include "mpu_wrappers.h"
|
|
|
|
/**
|
|
* @brief Restore the context of the first task so that the first task starts
|
|
* executing.
|
|
*/
|
|
void vRestoreContextOfFirstTask( void ) __attribute__( ( naked ) ) PRIVILEGED_FUNCTION;
|
|
|
|
/**
|
|
* @brief Checks whether or not the processor is privileged.
|
|
*
|
|
* @return 1 if the processor is already privileged, 0 otherwise.
|
|
*/
|
|
BaseType_t xIsPrivileged( void ) __attribute__( ( naked ) );
|
|
|
|
/**
|
|
* @brief Raises the privilege level by clearing the bit 0 of the CONTROL
|
|
* register.
|
|
*
|
|
* @note This is a privileged function and should only be called from the kernel
|
|
* code.
|
|
*
|
|
* Bit 0 of the CONTROL register defines the privilege level of Thread Mode.
|
|
* Bit[0] = 0 --> The processor is running privileged
|
|
* Bit[0] = 1 --> The processor is running unprivileged.
|
|
*/
|
|
void vRaisePrivilege( void ) __attribute__( ( naked ) ) PRIVILEGED_FUNCTION;
|
|
|
|
/**
|
|
* @brief Lowers the privilege level by setting the bit 0 of the CONTROL
|
|
* register.
|
|
*
|
|
* Bit 0 of the CONTROL register defines the privilege level of Thread Mode.
|
|
* Bit[0] = 0 --> The processor is running privileged
|
|
* Bit[0] = 1 --> The processor is running unprivileged.
|
|
*/
|
|
void vResetPrivilege( void ) __attribute__( ( naked ) );
|
|
|
|
/**
|
|
* @brief Starts the first task.
|
|
*/
|
|
void vStartFirstTask( void ) __attribute__( ( naked ) ) PRIVILEGED_FUNCTION;
|
|
|
|
/**
|
|
* @brief Disables interrupts.
|
|
*/
|
|
uint32_t ulSetInterruptMask( void ) __attribute__( ( naked ) ) PRIVILEGED_FUNCTION;
|
|
|
|
/**
|
|
* @brief Enables interrupts.
|
|
*/
|
|
void vClearInterruptMask( uint32_t ulMask ) __attribute__( ( naked ) ) PRIVILEGED_FUNCTION;
|
|
|
|
/**
|
|
* @brief PendSV Exception handler.
|
|
*/
|
|
void PendSV_Handler( void ) __attribute__( ( naked ) ) PRIVILEGED_FUNCTION;
|
|
|
|
/**
|
|
* @brief SVC Handler.
|
|
*/
|
|
void SVC_Handler( void ) __attribute__( ( naked ) ) PRIVILEGED_FUNCTION;
|
|
|
|
/**
|
|
* @brief Allocate a Secure context for the calling task.
|
|
*
|
|
* @param[in] ulSecureStackSize The size of the stack to be allocated on the
|
|
* secure side for the calling task.
|
|
*/
|
|
void vPortAllocateSecureContext( uint32_t ulSecureStackSize ) __attribute__( ( naked ) );
|
|
|
|
/**
|
|
* @brief Free the task's secure context.
|
|
*
|
|
* @param[in] pulTCB Pointer to the Task Control Block (TCB) of the task.
|
|
*/
|
|
void vPortFreeSecureContext( uint32_t * pulTCB ) __attribute__( ( naked ) ) PRIVILEGED_FUNCTION;
|
|
|
|
#endif /* __PORT_ASM_H__ */
|