qf_pool.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(qf_pool)
00032 
00033 /// \file
00034 /// \ingroup qf
00035 /// \brief QF_pool_[] and QF_maxPool_ definition, QF::poolInit()
00036 /// implementation.
00037 
00038 // Package-scope objects -----------------------------------------------------
00039 QF_EPOOL_TYPE_ QF_pool_[3];                          // allocate 3 event pools
00040 uint8_t QF_maxPool_;                      // number of initialized event pools
00041 
00042 //............................................................................
00043 void QF::poolInit(void *poolSto, uint32_t poolSize, QEventSize evtSize) {
00044                          // cannot exceed the number of available memory pools
00045     Q_REQUIRE(QF_maxPool_ < (uint8_t)Q_DIM(QF_pool_));
00046                // please initialize event pools in ascending order of evtSize:
00047     Q_REQUIRE((QF_maxPool_ == (uint8_t)0)
00048               || (QF_EPOOL_EVENT_SIZE_(QF_pool_[QF_maxPool_ - 1]) < evtSize));
00049     QF_EPOOL_INIT_(QF_pool_[QF_maxPool_], poolSto, poolSize, evtSize);
00050     ++QF_maxPool_;                                            // one more pool
00051 }