QP/C
qf_act.c
Go to the documentation of this file.
00001 /*****************************************************************************
00002 * Product: QF/C
00003 * Last Updated for Version: 4.5.04
00004 * Date of the Last Update:  Feb 02, 2013
00005 *
00006 *                    Q u a n t u m     L e a P s
00007 *                    ---------------------------
00008 *                    innovating embedded systems
00009 *
00010 * Copyright (C) 2002-2013 Quantum Leaps, LLC. All rights reserved.
00011 *
00012 * This program is open source software: you can redistribute it and/or
00013 * modify it under the terms of the GNU General Public License as published
00014 * by the Free Software Foundation, either version 2 of the License, or
00015 * (at your option) any later version.
00016 *
00017 * Alternatively, this program may be distributed and modified under the
00018 * terms of Quantum Leaps commercial licenses, which expressly supersede
00019 * the GNU General Public License and are specifically designed for
00020 * licensees interested in retaining the proprietary status of their code.
00021 *
00022 * This program is distributed in the hope that it will be useful,
00023 * but WITHOUT ANY WARRANTY; without even the implied warranty of
00024 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
00025 * GNU General Public License for more details.
00026 *
00027 * You should have received a copy of the GNU General Public License
00028 * along with this program. If not, see <http://www.gnu.org/licenses/>.
00029 *
00030 * Contact information:
00031 * Quantum Leaps Web sites: http://www.quantum-leaps.com
00032 *                          http://www.state-machine.com
00033 * e-mail:                  info@quantum-leaps.com
00034 *****************************************************************************/
00035 #include "qf_pkg.h"
00036 #include "qassert.h"
00037 
00038 Q_DEFINE_THIS_MODULE("qf_act")
00039 
00040 
00047 /* public objects ----------------------------------------------------------*/
00048 QActive *QF_active_[QF_MAX_ACTIVE + 1];      /* to be used by QF ports only */
00049 uint8_t QF_intLockNest_;                    /* interrupt-lock nesting level */
00050 
00051 /*..........................................................................*/
00052 char_t const Q_ROM * Q_ROM_VAR QF_getVersion(void) {
00053     static char_t const Q_ROM Q_ROM_VAR version[] = {
00054         (char_t)((uint8_t)((QP_VERSION >> 12) & 0xFU) + (uint8_t)'0'),
00055         (char_t)'.',
00056         (char_t)((uint8_t)((QP_VERSION >>  8) & 0xFU) + (uint8_t)'0'),
00057         (char_t)'.',
00058         (char_t)((uint8_t)((QP_VERSION >>  4) & 0xFU) + (uint8_t)'0'),
00059         (char_t)((uint8_t)(QP_VERSION         & 0xFU) + (uint8_t)'0'),
00060         (char_t)'\0'
00061     };
00062     return version;
00063 }
00064 /*..........................................................................*/
00065 void QF_add_(QActive * const a) {
00066     uint8_t p = a->prio;
00067     QF_CRIT_STAT_
00068 
00069     Q_REQUIRE(((uint8_t)0 < p) && (p <= (uint8_t)QF_MAX_ACTIVE)
00070               && (QF_active_[p] == (QActive *)0));
00071 
00072     QF_CRIT_ENTRY_();
00073 
00074     QF_active_[p] = a;       /* register the active object at this priority */
00075 
00076     QS_BEGIN_NOCRIT_(QS_QF_ACTIVE_ADD, QS_aoObj_, a)
00077         QS_TIME_();                                            /* timestamp */
00078         QS_OBJ_(a);                                    /* the active object */
00079         QS_U8_(p);                     /* the priority of the active object */
00080     QS_END_NOCRIT_()
00081 
00082     QF_CRIT_EXIT_();
00083 }
00084 /*..........................................................................*/
00085 void QF_remove_(QActive const * const a) {
00086     uint8_t p = a->prio;
00087     QF_CRIT_STAT_
00088 
00089     Q_REQUIRE(((uint8_t)0 < p) && (p <= (uint8_t)QF_MAX_ACTIVE)
00090               && (QF_active_[p] == a));
00091 
00092     QF_CRIT_ENTRY_();
00093 
00094     QF_active_[p] = (QActive *)0;             /* free-up the priority level */
00095 
00096     QS_BEGIN_NOCRIT_(QS_QF_ACTIVE_REMOVE, QS_aoObj_, a)
00097         QS_TIME_();                                            /* timestamp */
00098         QS_OBJ_(a);                                    /* the active object */
00099         QS_U8_(p);                     /* the priority of the active object */
00100     QS_END_NOCRIT_()
00101 
00102     QF_CRIT_EXIT_();
00103 }