qte_arm.cpp

00001 //////////////////////////////////////////////////////////////////////////////
00002 // Product: QF/C++
00003 // Last Updated for Version: 4.0.00
00004 // Date of the Last Update:  Apr 07, 2008
00005 //
00006 //                    Q u a n t u m     L e a P s
00007 //                    ---------------------------
00008 //                    innovating embedded systems
00009 //
00010 // Copyright (C) 2002-2008 Quantum Leaps, LLC. All rights reserved.
00011 //
00012 // This software may be distributed and modified under the terms of the GNU
00013 // General Public License version 2 (GPL) as published by the Free Software
00014 // Foundation and appearing in the file GPL.TXT included in the packaging of
00015 // this file. Please note that GPL Section 2[b] requires that all works based
00016 // on this software must also be made publicly available under the terms of
00017 // the GPL ("Copyleft").
00018 //
00019 // Alternatively, this software may be distributed and modified under the
00020 // terms of Quantum Leaps commercial licenses, which expressly supersede
00021 // the GPL and are specifically designed for licensees interested in
00022 // retaining the proprietary status of their code.
00023 //
00024 // Contact information:
00025 // Quantum Leaps Web site:  http://www.quantum-leaps.com
00026 // e-mail:                  info@quantum-leaps.com
00027 //////////////////////////////////////////////////////////////////////////////
00028 #include "qf_pkg.h"
00029 #include "qassert.h"
00030 
00031 Q_DEFINE_THIS_MODULE(qte_arm)
00032 
00033 /// \file
00034 /// \ingroup qf
00035 /// \brief QF_timeEvtListHead_ definition and QTimeEvt::arm_() implementation.
00036 
00037 // Package-scope objects -----------------------------------------------------
00038 QTimeEvt *QF_timeEvtListHead_;           // head of linked list of time events
00039 
00040 //............................................................................
00041 void QTimeEvt::arm_(QActive *act, QTimeEvtCtr nTicks) {
00042     Q_REQUIRE((nTicks > (QTimeEvtCtr)0)          /* cannot arm with 0 ticks */
00043               && (sig >= (QSignal)Q_USER_SIG)               /* valid signal */
00044               && (m_prev == (QTimeEvt *)0)   /* time event must NOT be used */
00045               && (act != (QActive *)0));  /* active object must be provided */
00046     m_ctr = nTicks;
00047     m_prev = this;                                    // mark the timer in use
00048     m_act = act;
00049     QF_INT_LOCK_KEY_
00050     QF_INT_LOCK_();
00051 
00052     QS_BEGIN_NOLOCK_(QS_QF_TIMEEVT_ARM, QS::teObj_, this)
00053         QS_TIME_();                                               // timestamp
00054         QS_OBJ_(this);                               // this time event object
00055         QS_OBJ_(act);                                     // the active object
00056         QS_TEC_(nTicks);                                // the number of ticks
00057         QS_TEC_(m_interval);                                   // the interval
00058     QS_END_NOLOCK_()
00059 
00060     m_next = QF_timeEvtListHead_;
00061     if (QF_timeEvtListHead_ != (QTimeEvt *)0) {
00062         QF_timeEvtListHead_->m_prev = this;
00063     }
00064     QF_timeEvtListHead_ = this;
00065     QF_INT_UNLOCK_();
00066 }