mirror of
https://github.com/QuantumLeaps/qpcpp.git
synced 2025-01-28 06:02:56 +08:00
86 lines
3.3 KiB
C
86 lines
3.3 KiB
C
/// @file
|
|
/// @brief QF/C++ port to PIC32, cooperative QV kernel, XC32 toolchain
|
|
/// @ingroup qep
|
|
/// @cond
|
|
///***************************************************************************
|
|
/// Last updated for version 6.5.1
|
|
/// Last updated on 2019-05-22
|
|
///
|
|
/// Q u a n t u m L e a P s
|
|
/// ------------------------
|
|
/// Modern Embedded Software
|
|
///
|
|
/// Copyright (C) 2005-2019 Quantum Leaps. All rights reserved.
|
|
///
|
|
/// This program is open source software: you can redistribute it and/or
|
|
/// modify it under the terms of the GNU General Public License as published
|
|
/// by the Free Software Foundation, either version 3 of the License, or
|
|
/// (at your option) any later version.
|
|
///
|
|
/// Alternatively, this program may be distributed and modified under the
|
|
/// terms of Quantum Leaps commercial licenses, which expressly supersede
|
|
/// the GNU General Public License and are specifically designed for
|
|
/// licensees interested in retaining the proprietary status of their code.
|
|
///
|
|
/// This program is distributed in the hope that it will be useful,
|
|
/// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
/// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
/// GNU General Public License for more details.
|
|
///
|
|
/// You should have received a copy of the GNU General Public License
|
|
/// along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
///
|
|
/// Contact information:
|
|
/// https://www.state-machine.com
|
|
/// mailto:info@state-machine.com
|
|
///***************************************************************************
|
|
/// @endcond
|
|
|
|
#ifndef qf_port_h
|
|
#define qf_port_h
|
|
|
|
// The maximum number of system clock tick rates
|
|
#define QF_MAX_TICK_RATE 2
|
|
|
|
// The maximum number of active objects in the application, see NOTE1
|
|
#define QF_MAX_ACTIVE 32
|
|
|
|
// QF interrupt disable/enable, see NOTE2
|
|
#define QF_INT_DISABLE() __asm__ volatile("DI")
|
|
#define QF_INT_ENABLE() __asm__ volatile("EI")
|
|
|
|
// QF critical section entry/exit, see NOTE2
|
|
// QF_CRIT_STAT_TYPE not defined: "unconditional interrupt disabling" policy
|
|
#define QF_CRIT_ENTRY(dummy) QF_INT_DISABLE()
|
|
#define QF_CRIT_EXIT(dummy) QF_INT_ENABLE()
|
|
|
|
// fast log-base-2 with CLZ instruction
|
|
#define QF_LOG2(n_) ((uint8_t)(32 - _clz(n_)))
|
|
|
|
#include <xc.h> // for _clz()
|
|
|
|
#include "qep_port.h" // QEP port
|
|
#include "qv_port.h" // QV cooperative kernel port
|
|
#include "qf.h" // QF platform-independent public interface
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
// NOTE1:
|
|
// The maximum number of active objects QF_MAX_ACTIVE can be increased
|
|
// up to 64, if necessary. Here it is set to a lower level to save some RAM.
|
|
//
|
|
// NOTE2:
|
|
// The DI/EI instructions are used for fast, unconditional disabling and
|
|
// enabling of interrupts.
|
|
//
|
|
// CAUTION: This QP port assumes that interrupt nesting is _enabled_,
|
|
// which is the default in the PIC32 processors. Interrupt nesting should
|
|
// never be disabled by setting the NSTDIS control bit (INTCON1<15>). If you
|
|
// don't want interrupts to nest, you can always prioritize them at the same
|
|
// level. For example, the default priority level for all interrupts is 4 out
|
|
// of reset. If you don't change this level for any interrupt the nesting of
|
|
// interrupt will not occur.
|
|
//
|
|
|
|
#endif // qf_port_h
|
|
|