qhsm_ini.cpp

00001 //////////////////////////////////////////////////////////////////////////////
00002 // Product: QEP/C++
00003 // Last Updated for Version: 4.0.04
00004 // Date of the Last Update:  Apr 08, 2009
00005 //
00006 //                    Q u a n t u m     L e a P s
00007 //                    ---------------------------
00008 //                    innovating embedded systems
00009 //
00010 // Copyright (C) 2002-2009 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 "qep_pkg.h"
00029 #include "qassert.h"
00030 
00031 Q_DEFINE_THIS_MODULE(qhsm_ini)
00032 
00033 /// \file
00034 /// \ingroup qep
00035 /// \brief QHsm::init() implementation.
00036 
00037 //............................................................................
00038 QHsm::~QHsm() {
00039 }
00040 //............................................................................
00041 void QHsm::init(QEvent const *e) {
00042     QStateHandler t;
00043     QS_INT_LOCK_KEY_
00044 
00045                               // the top-most initial transition must be taken
00046     Q_ALLEGE((*m_state)(this, e) == Q_RET_TRAN);
00047 
00048     t = (QStateHandler)&QHsm::top;              // HSM starts in the top state
00049     do {                                           // drill into the target...
00050         QStateHandler path[QEP_MAX_NEST_DEPTH_];
00051         int8_t ip = (int8_t)0;                  // transition entry path index
00052 
00053 
00054         QS_BEGIN_(QS_QEP_STATE_INIT, QS::smObj_, this)
00055             QS_OBJ_(this);                        // this state machine object
00056             QS_FUN_(t);                                    // the source state
00057             QS_FUN_(m_state);          // the target of the initial transition
00058         QS_END_()
00059 
00060         path[0] = m_state;
00061         (void)QEP_TRIG_(m_state, QEP_EMPTY_SIG_);
00062         while (m_state != t) {
00063             path[++ip] = m_state;
00064             (void)QEP_TRIG_(m_state, QEP_EMPTY_SIG_);
00065         }
00066         m_state = path[0];
00067                                                // entry path must not overflow
00068         Q_ASSERT(ip < (int8_t)QEP_MAX_NEST_DEPTH_);
00069 
00070         do {           // retrace the entry path in reverse (desired) order...
00071             QEP_ENTER_(path[ip]);                            // enter path[ip]
00072         } while ((--ip) >= (int8_t)0);
00073 
00074         t = path[0];                   // current state becomes the new source
00075     } while (QEP_TRIG_(t, Q_INIT_SIG) == Q_RET_TRAN);
00076     m_state = t;
00077 
00078     QS_BEGIN_(QS_QEP_INIT_TRAN, QS::smObj_, this)
00079         QS_TIME_();                                              // time stamp
00080         QS_OBJ_(this);                            // this state machine object
00081         QS_FUN_(m_state);                              // the new active state
00082     QS_END_()
00083 }