QP/C: qf_new.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 05, 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("qf_new")
00032 
00033 
00039 /*..........................................................................*/
00040 QEvent *QF_new_(QEventSize evtSize, QSignal sig) {
00041     QEvent *e;
00042     QS_CRIT_STAT_
00043 
00044               /* find the pool index that fits the requested event size ... */
00045     uint8_t idx = (uint8_t)0;
00046     while (evtSize > QF_EPOOL_EVENT_SIZE_(QF_pool_[idx])) {
00047         ++idx;
00048         Q_ASSERT(idx < QF_maxPool_);  /* cannot run out of registered pools */
00049     }
00050 
00051     QS_BEGIN_(QS_QF_NEW, (void *)0, (void *)0)
00052         QS_TIME_();                                            /* timestamp */
00053         QS_EVS_(evtSize);                          /* the size of the event */
00054         QS_SIG_(sig);                            /* the signal of the event */
00055     QS_END_()
00056 
00057     QF_EPOOL_GET_(QF_pool_[idx], e);         /* get e -- platform-dependent */
00058     Q_ASSERT(e != (QEvent *)0);          /* pool must not run out of events */
00059 
00060     e->sig = sig;                              /* set signal for this event */
00061     QF_EVT_POOL_ID_(e) = (uint8_t)(idx + (uint8_t)1);  /* store the pool ID */
00062     QF_EVT_REF_CTR_(e) = (uint8_t)0;      /* set the reference counter to 0 */
00063     return e;
00064 }