kbdmgr.c

state machine working with rtos

/*****************************************************************************
* Product: QDPP, for 80x86, uC/OS-II, Turbo C++ 1.01, Large model
* Version: Compatible with QF/C 3.1.yy
* Updated: Nov 14, 2005
*
* Copyright (C) 2002-2005 Quantum Leaps, LLC. All rights reserved.
*
* This software may be distributed and modified under the terms of the GNU
* General Public License version 2 (GPL) as published by the Free Software
* Foundation and appearing in the file GPL.TXT included in the packaging of
* this file. Please note that GPL Section 2[b] requires that all works based
* on this software must also be made publicly available under the terms of
* the GPL ("Copyleft").
*
* Alternatively, this software may be distributed and modified under the
* terms of Quantum Leaps commercial licenses, which are designed for users
* who want to retain proprietary status of their code. This "dual-licensing"
* model is possible because Quantum Leaps owns the copyright to this source
* code and as such can license its intelectual property any number of times.
* The users who license this software under one of Quantum Leaps commercial
* licenses do not use this software under the GPL and therefore are not
* subject to any of its terms.
*
* Contact information:
* Quantum Leaps Web site:  http://www.quantum-leaps.com
* Quantum Leaps licensing: http://www.quantum-leaps.com/licensing
* Quantum Leaps products:  http://www.quantum-leaps.com/products
* e-mail:                  [e-mail]
*****************************************************************************/
#include "qf_port.h"
#include "qdpp.h"
#include "qassert.h"

#include <stdlib.h>
#include <stdio.h>

Q_DEFINE_THIS_FILE

typedef struct KbdMgrTag KbdMgr;
struct KbdMgrTag {                                      /* keyboard manager */
    QActive super_;                                /* inherits from QActive */
};

void KbdMgr_ctor(KbdMgr *me);
static void KbdMgr_initial(KbdMgr *me, QEvent const *e);
static QSTATE KbdMgr_active(KbdMgr *me, QEvent const *e);

/*..........................................................................*/
void kbdMgrStart(uint8_t prio,
                 QEvent const *qSto[], uint32_t qLen,
                 void *stkSto, uint32_t stkSize)
{
    static KbdMgr kbdMgr;
    KbdMgr_ctor(&kbdMgr);                             /* explicit Ctor call */
    QActive_start((QActive *)&kbdMgr, prio,
                  qSto, qLen, stkSto, stkSize,
                  (QEvent *)0);
}
/*..........................................................................*/
void KbdMgr_ctor(KbdMgr *me) {
    QActive_ctor_(&me->super_, (QState)&KbdMgr_initial);
}
/*..........................................................................*/
void KbdMgr_initial(KbdMgr *me, QEvent const *e) {
    (void)e;                               /* suppress the compiler warning */
    QActive_subscribe_((QActive *)me, KBD_SIG);
                                          /* post a start event, see NOTE01 */
    QActive_postFIFO((QActive *)me, Q_NEW(QEvent, START_SIG));
    Q_INIT(&KbdMgr_active);
}
/*..........................................................................*/
QSTATE KbdMgr_active(KbdMgr *me, QEvent const *e) {
    (void)me;                             /* eliminate the compiler warning */
    switch (e->sig) {
        case START_SIG: {
            QF_start();                /* enable the interrupts, see NOTE01 */
            return 0;
        }
        case KBD_SIG: {
            displayKey(((KbdEvt const *)e)->key);
            return 0;
        }
    }
    return (QSTATE)&QHsm_top;
}

/*****************************************************************************
*
* NOTE01:
* uC/OS-II requires that the interrupts be not enabled until the initial
* context switch occurrs in OSInit(). To arrange for that, an event
* is posted to self and waits in the event queue until the KbdMgr task
* is scheduled in by the uC/OS-II. Only then the internal transition
* triggered by the event calls the QF::start() method that initializes
* and enables the interrupts.
*/