qte_arm.cpp

Go to the documentation of this file.

// Product: QF/C++
// Last Updated for Version: 4.4.00
// Date of the Last Update:  Mar 28, 2012
//
//                    Q u a n t u m     L e a P s
//                    ---------------------------
//                    innovating embedded systems
//
// Copyright (C) 2002-2012 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 2 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"


QP_BEGIN_

Q_DEFINE_THIS_MODULE("qte_arm")

// Package-scope objects -----------------------------------------------------
QTimeEvt *QF_timeEvtListHead_;           // head of linked list of time events

//............................................................................
bool QF::noTimeEvtsActive(void) {
    return QF_timeEvtListHead_ == null_tevt;
}
//............................................................................
void QTimeEvt::arm_(QActive * const act, QTimeEvtCtr const nTicks) {
    Q_REQUIRE((nTicks > tc_0)                    /* cannot arm with 0 ticks */
              && (static_cast<enum_t>(sig) >= Q_USER_SIG)   /* valid signal */
              && (m_prev == null_tevt)       /* time event must NOT be used */
              && (act != null_act));         // Active object must be provided
    m_ctr  = nTicks;
    m_prev = this;                                   // mark the timer in use
    m_act  = act;
    QF_CRIT_STAT_
    QF_CRIT_ENTRY_();

    QS_BEGIN_NOCRIT_(QS_QF_TIMEEVT_ARM, QS::teObj_, this)
        QS_TIME_();                                               // timestamp
        QS_OBJ_(this);                               // this time event object
        QS_OBJ_(act);                                     // the active object
        QS_TEC_(nTicks);                                // the number of ticks
        QS_TEC_(m_interval);                                   // the interval
    QS_END_NOCRIT_()

    m_next = QF_timeEvtListHead_;
    if (QF_timeEvtListHead_ != null_tevt) {
        QF_timeEvtListHead_->m_prev = this;
    }
    QF_timeEvtListHead_ = this;
    QF_CRIT_EXIT_();
}

QP_END_