QP/C: qte_darm.c Source File

Go to the documentation of this file.
00001 /*****************************************************************************
00002 * Product: QF/C
00003 * Last Updated for Version: 4.3.00
00004 * Date of the Last Update:  Oct 30, 2011
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 
00036 /*..........................................................................*/
00037 /* NOTE: disarm a timer (no harm in disarming an already disarmed timer)    */
00038 uint8_t QTimeEvt_disarm(QTimeEvt *me) {
00039     uint8_t wasArmed;
00040     QF_CRIT_STAT_
00041     QF_CRIT_ENTRY_();
00042     if (me->prev != (QTimeEvt *)0) {   /* is the time event actually armed? */
00043         wasArmed = (uint8_t)1;
00044         if (me == QF_timeEvtListHead_) {
00045             QF_timeEvtListHead_ = me->next;
00046         }
00047         else {
00048             if (me->next != (QTimeEvt *)0) {   /* not the last in the list? */
00049                 me->next->prev = me->prev;
00050             }
00051             me->prev->next = me->next;
00052         }
00053         me->prev = (QTimeEvt *)0;        /* mark the time event as disarmed */
00054 
00055         QS_BEGIN_NOCRIT_(QS_QF_TIMEEVT_DISARM, QS_teObj_, me)
00056             QS_TIME_();                                        /* timestamp */
00057             QS_OBJ_(me);                          /* this time event object */
00058             QS_OBJ_(me->act);                          /* the active object */
00059             QS_TEC_(me->ctr);                        /* the number of ticks */
00060             QS_TEC_(me->interval);                          /* the interval */
00061         QS_END_NOCRIT_()
00062     }
00063     else {                                  /* the time event was not armed */
00064         wasArmed = (uint8_t)0;
00065 
00066         QS_BEGIN_NOCRIT_(QS_QF_TIMEEVT_DISARM_ATTEMPT, QS_teObj_, me)
00067             QS_TIME_();                                        /* timestamp */
00068             QS_OBJ_(me);                          /* this time event object */
00069             QS_OBJ_(me->act);                          /* the active object */
00070         QS_END_NOCRIT_()
00071     }
00072     QF_CRIT_EXIT_();
00073     return wasArmed;
00074 }