mirror of
https://github.com/QuantumLeaps/qpcpp.git
synced 2025-01-28 06:02:56 +08:00
101 lines
4.2 KiB
C++
101 lines
4.2 KiB
C++
//****************************************************************************
|
|
// Product: QF/C++
|
|
// Last Updated for Version: 5.1.0
|
|
// Date of the Last Update: Sep 28, 2013
|
|
//
|
|
// Q u a n t u m L e a P s
|
|
// ---------------------------
|
|
// innovating embedded systems
|
|
//
|
|
// Copyright (C) 2002-2013 Quantum Leaps, LLC. 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:
|
|
// Quantum Leaps Web sites: http://www.quantum-leaps.com
|
|
// http://www.state-machine.com
|
|
// e-mail: info@quantum-leaps.com
|
|
//****************************************************************************
|
|
#include "qf_pkg.h"
|
|
#include "qassert.h"
|
|
|
|
/// \file
|
|
/// \ingroup qf
|
|
/// \brief QTimeEvt::rearm() implementation.
|
|
|
|
namespace QP {
|
|
|
|
Q_DEFINE_THIS_MODULE("qte_rarm")
|
|
|
|
//............................................................................
|
|
bool QTimeEvt::rearm(QTimeEvtCtr const nTicks) {
|
|
uint8_t tickRate = static_cast<uint8_t>(refCtr_ & u8_0x7F);
|
|
QF_CRIT_STAT_
|
|
|
|
Q_REQUIRE((m_act != null_void) /* AO must be valid */
|
|
&& (tickRate < static_cast<uint8_t>(QF_MAX_TICK_RATE))
|
|
&& (nTicks != tc_0) /* cannot arm with 0 ticks */
|
|
&& (static_cast<enum_t>(sig) >= Q_USER_SIG)); // valid signal
|
|
|
|
QF_CRIT_ENTRY_();
|
|
bool isArmed;
|
|
if (m_ctr == tc_0) { // is the time evt not running?
|
|
isArmed = false;
|
|
if ((refCtr_ & u8_0x80) == u8_0) { // is the timer unlinked? NOTE01
|
|
refCtr_ |= u8_0x80; // mark as linked
|
|
m_next = QF::timeEvtHead_[tickRate].toTimeEvt(); // see NOTE02
|
|
QF::timeEvtHead_[tickRate].m_act = this;
|
|
}
|
|
}
|
|
else { // the time event is armed
|
|
isArmed = true;
|
|
}
|
|
m_ctr = nTicks; // re-load the tick counter (shift the phasing)
|
|
|
|
QS_BEGIN_NOCRIT_(QS_QF_TIMEEVT_REARM, QS::priv_.teObjFilter, this)
|
|
QS_TIME_(); // timestamp
|
|
QS_OBJ_(this); // this time event object
|
|
QS_OBJ_(m_act); // the target AO
|
|
QS_TEC_(m_ctr); // the number of ticks
|
|
QS_TEC_(m_interval); // the interval
|
|
QS_2U8_(tickRate, (isArmed ? u8_1 : u8_0));// tick rate & armed status
|
|
QS_END_NOCRIT_()
|
|
|
|
QF_CRIT_EXIT_();
|
|
return isArmed;
|
|
}
|
|
|
|
} // namespace QP
|
|
|
|
//****************************************************************************
|
|
// NOTE01:
|
|
// For a duration of a single clock tick of the specified tick rate a time
|
|
// event can be disarmed and yet still linked into the list, because unlinking
|
|
// is performed exclusively in the QF::tickX() function.
|
|
//
|
|
// NOTE02:
|
|
// The time event is initially inserted into the separate "freshly armed"
|
|
// link list based on QF::timeEvtHead_[tickRate].m_act. Only later, inside
|
|
// the QF::tickX() function, the "freshly armed" list is appended to the
|
|
// main list of armed time events based on QF::timeEvtHead_[tickRate].m_next.
|
|
// Again, this is to keep any changes to the main list exclusively inside
|
|
// the QF::tickX() function.
|
|
//
|
|
|