mirror of
https://github.com/QuantumLeaps/qpc.git
synced 2025-01-28 07:03:10 +08:00
e032055963
7.1.3 Replaced QF_EVT_REF_CTR_INC_() with QEvt_refCtr_inc_() in ports - embOS - ESP-IDF - Qt 7.1.3 7.1.3 7.1.3 7.1.3 7.1.3 7.1.3 7.1.2 first commit after fixing history Revert "7.1.2" This reverts commit 90cf4e1471b5e9c0853af97af8ec0bc67c7e19c6. 7.1.2 first commit after fixing the history 7.0.1
156 lines
6.2 KiB
C
156 lines
6.2 KiB
C
/*============================================================================
|
|
* QP/C Real-Time Embedded Framework (RTEF)
|
|
* Copyright (C) 2005 Quantum Leaps, LLC. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: GPL-3.0-or-later OR LicenseRef-QL-commercial
|
|
*
|
|
* This software is dual-licensed under the terms of the open source GNU
|
|
* General Public License version 3 (or any later version), or alternatively,
|
|
* under the terms of one of the closed source Quantum Leaps commercial
|
|
* licenses.
|
|
*
|
|
* The terms of the open source GNU General Public License version 3
|
|
* can be found at: <www.gnu.org/licenses/gpl-3.0>
|
|
*
|
|
* The terms of the closed source Quantum Leaps commercial licenses
|
|
* can be found at: <www.state-machine.com/licensing>
|
|
*
|
|
* Redistributions in source code must retain this top-level comment block.
|
|
* Plagiarizing this software to sidestep the license obligations is illegal.
|
|
*
|
|
* Contact information:
|
|
* <www.state-machine.com>
|
|
* <info@state-machine.com>
|
|
============================================================================*/
|
|
/*!
|
|
* @date Last updated on: 2022-06-30
|
|
* @version Last updated for: @ref qpc_7_0_1
|
|
*
|
|
* @file
|
|
* @brief QF/C port to Cortex-M, preemptive dual-mode QXK kernel, IAR-ARM
|
|
*/
|
|
#ifndef QF_PORT_H
|
|
#define QF_PORT_H
|
|
|
|
/* The maximum number of system clock tick rates */
|
|
#define QF_MAX_TICK_RATE 2U
|
|
|
|
/* QF interrupt disable/enable and log2()... */
|
|
#if (__ARM_ARCH == 6) /* Cortex-M0/M0+/M1(v6-M, v6S-M)? */
|
|
|
|
/* The maximum number of active objects in the application, see NOTE1 */
|
|
#define QF_MAX_ACTIVE 16U
|
|
|
|
/* Cortex-M0/M0+/M1(v6-M, v6S-M) interrupt disabling policy, see NOTE2 */
|
|
#define QF_INT_DISABLE() __disable_interrupt()
|
|
#define QF_INT_ENABLE() __enable_interrupt()
|
|
|
|
/* QF critical section entry/exit (save and restore interrupt status) */
|
|
#define QF_CRIT_STAT_TYPE unsigned long
|
|
#define QF_CRIT_ENTRY(primask_) do { \
|
|
(primask_) = __get_PRIMASK(); \
|
|
QF_INT_DISABLE(); \
|
|
} while (false)
|
|
#define QF_CRIT_EXIT(primask_) __set_PRIMASK((primask_))
|
|
|
|
/* CMSIS threshold for "QF-aware" interrupts, see NOTE2 and NOTE4 */
|
|
#define QF_AWARE_ISR_CMSIS_PRI 0
|
|
|
|
/* hand-optimized LOG2 in assembly for Cortex-M0/M0+/M1(v6-M, v6S-M) */
|
|
#define QF_LOG2(n_) QF_qlog2((uint32_t)(n_))
|
|
|
|
#else /* Cortex-M3/M4/M7 */
|
|
|
|
/* The maximum number of active objects in the application, see NOTE1 */
|
|
#define QF_MAX_ACTIVE 32U
|
|
|
|
/* Cortex-M3/M4/M7 alternative interrupt disabling with PRIMASK */
|
|
#define QF_PRIMASK_DISABLE() __disable_interrupt()
|
|
#define QF_PRIMASK_ENABLE() __enable_interrupt()
|
|
|
|
/* Cortex-M3/M4/M7 interrupt disabling policy, see NOTE3 and NOTE4 */
|
|
#define QF_INT_DISABLE() do { \
|
|
QF_PRIMASK_DISABLE(); \
|
|
__set_BASEPRI(QF_BASEPRI); \
|
|
QF_PRIMASK_ENABLE(); \
|
|
} while (false)
|
|
#define QF_INT_ENABLE() __set_BASEPRI(0U)
|
|
|
|
/* QF critical section entry/exit (save and restore interrupt status) */
|
|
#define QF_CRIT_STAT_TYPE unsigned long
|
|
#define QF_CRIT_ENTRY(basepri_) do {\
|
|
(basepri_) = __get_BASEPRI(); \
|
|
QF_INT_DISABLE(); \
|
|
} while (false)
|
|
#define QF_CRIT_EXIT(basepri_) __set_BASEPRI((basepri_))
|
|
|
|
/* BASEPRI threshold for "QF-aware" interrupts, see NOTE3 */
|
|
#define QF_BASEPRI 0x3F
|
|
|
|
/* CMSIS threshold for "QF-aware" interrupts, see NOTE5 */
|
|
#define QF_AWARE_ISR_CMSIS_PRI (QF_BASEPRI >> (8 - __NVIC_PRIO_BITS))
|
|
|
|
/* Cortex-M3/M4/M7 provide the CLZ instruction for fast LOG2 */
|
|
#define QF_LOG2(n_) ((uint_fast8_t)(32U - __CLZ((unsigned long)(n_))))
|
|
|
|
#endif
|
|
|
|
#define QF_CRIT_EXIT_NOP() __ISB()
|
|
|
|
#include <intrinsics.h> /* IAR intrinsic functions */
|
|
#include "qep_port.h" /* QEP port */
|
|
|
|
#if (__ARM_ARCH == 6) /* Cortex-M0/M0+/M1(v6-M, v6S-M)? */
|
|
/* hand-optimized quick LOG2 in assembly */
|
|
uint_fast8_t QF_qlog2(uint32_t x);
|
|
#endif /* Cortex-M0/M0+/M1(v6-M, v6S-M) */
|
|
|
|
#include "qxk_port.h" /* QXK dual-mode kernel port */
|
|
|
|
/*****************************************************************************
|
|
* NOTE1:
|
|
* The maximum number of active objects QF_MAX_ACTIVE can be increased
|
|
* up to 64U, if necessary. Here it is set to a lower level to save some RAM.
|
|
*
|
|
* NOTE2:
|
|
* On Cortex-M0/M0+/M1 (architecture v6-M, v6S-M), the interrupt disabling
|
|
* policy uses the PRIMASK register to disable interrupts globally. The
|
|
* QF_AWARE_ISR_CMSIS_PRI level is zero, meaning that all interrupts are
|
|
* "QF-aware".
|
|
*
|
|
* NOTE3:
|
|
* On Cortex-M3/M4/M7, the interrupt disable/enable policy uses the BASEPRI
|
|
* register (which is not implemented in Cortex-M0/M0+/M1) to disable
|
|
* interrupts only with priority lower than the threshold specified by the
|
|
* QF_BASEPRI macro. The interrupts with priorities above QF_BASEPRI (i.e.,
|
|
* with numerical priority values lower than QF_BASEPRI) are NOT disabled in
|
|
* this method. These free-running interrupts have very low ("zero") latency,
|
|
* but they are not allowed to call any QF services, because QF is unaware
|
|
* of them ("QF-unaware" interrutps). Consequently, only interrupts with
|
|
* numerical values of priorities eqal to or higher than QF_BASEPRI
|
|
* ("QF-aware" interrupts ), can call QF services.
|
|
*
|
|
* NOTE4:
|
|
* The QF_AWARE_ISR_CMSIS_PRI macro is useful as an offset for enumerating
|
|
* the "QF-aware" interrupt priorities in the applications, whereas the
|
|
* numerical values of the "QF-aware" interrupts must be greater or equal to
|
|
* QF_AWARE_ISR_CMSIS_PRI. The values based on QF_AWARE_ISR_CMSIS_PRI can be
|
|
* passed directly to the CMSIS function NVIC_SetPriority(), which shifts
|
|
* them by (8 - __NVIC_PRIO_BITS) into the correct bit position, while
|
|
* __NVIC_PRIO_BITS is the CMSIS macro defining the number of implemented
|
|
* priority bits in the NVIC. Please note that the macro QF_AWARE_ISR_CMSIS_PRI
|
|
* is intended only for applications and is not used inside the QF port, which
|
|
* remains generic and not dependent on the number of implemented priority bits
|
|
* implemented in the NVIC.
|
|
*
|
|
* NOTE5:
|
|
* The selective disabling of "QF-aware" interrupts with the BASEPRI register
|
|
* has a problem on ARM Cortex-M7 core r0p1 (see ARM-EPM-064408, errata
|
|
* 837070). The workaround recommended by ARM is to surround MSR BASEPRI with
|
|
* the CPSID i/CPSIE i pair, which is implemented in the QF_INT_DISABLE()
|
|
* macro. This workaround works also for Cortex-M3/M4 cores.
|
|
*/
|
|
|
|
#endif /* QF_PORT_H */
|
|
|