| /* |
| * 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__ */ |