QP/C: qte_arm.c Source File

Go to the documentation of this file.
00001 /*****************************************************************************
00002 * Product: QF/C
00003 * Last Updated for Version: 4.4.00
00004 * Date of the Last Update:  Jan 04, 2012
00005 *
00006 *                    Q u a n t u m     L e a P s
00007 *                    ---------------------------
00008 *                    innovating embedded systems
00009 *
00010 * Copyright (C) 2002-2012 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 
00039 /* Package-scope objects ---------------------------------------------------*/
00040 QTimeEvt *QF_timeEvtListHead_;        /* head of linked list of time events */
00041 
00042 /*..........................................................................*/
00043 void QTimeEvt_arm_(QTimeEvt *me, QActive *act, QTimeEvtCtr nTicks) {
00044     QF_CRIT_STAT_
00045     Q_REQUIRE((nTicks > (QTimeEvtCtr)0)  /* cannot arm a timer with 0 ticks */
00046               && (me->super.sig >= (QSignal)Q_USER_SIG)     /* valid signal */
00047               && (me->prev == (QTimeEvt *)0)   /* time evt must NOT be used */
00048               && (act != (QActive *)0));  /* active object must be provided */
00049     me->ctr = nTicks;
00050     me->prev = me;                                 /* mark the timer in use */
00051     me->act = act;
00052 
00053     QF_CRIT_ENTRY_();
00054 
00055     QS_BEGIN_NOCRIT_(QS_QF_TIMEEVT_ARM, QS_teObj_, me)
00056         QS_TIME_();                                            /* timestamp */
00057         QS_OBJ_(me);                              /* this time event object */
00058         QS_OBJ_(act);                                  /* the active object */
00059         QS_TEC_(nTicks);                             /* the number of ticks */
00060         QS_TEC_(me->interval);                              /* the interval */
00061     QS_END_NOCRIT_()
00062 
00063     me->next = QF_timeEvtListHead_;
00064     if (QF_timeEvtListHead_ != (QTimeEvt *)0) {
00065         QF_timeEvtListHead_->prev = me;
00066     }
00067     QF_timeEvtListHead_ = me;
00068     QF_CRIT_EXIT_();
00069 }