qcalc.h

state machine working with rtos

/*****************************************************************************
* Product:  QCalc/C example, DOS, Turbo C++ 1.01, Large model
* Last Updated for Version:  3.1.00
* Date of the Last Update:   Sep 19, 2005
*
* Copyright (C) 2002-2005 Quantum Leaps, LLC. All rights reserved.
*
* This example is part of the Quantum Leaps QP/C software, and 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 in conjunction
* with a valid QP/C Quantum Leaps commercial license. Quantum Leaps
* commercial licenses are designed for users who want to retain proprietary
* status of their code. 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]
*****************************************************************************/
#ifndef qcalc_h
#define qcalc_h

enum QCalcSignals {
    C_SIG = Q_USER_SIG,
    CE_SIG,
    DIGIT_0_SIG,
    DIGIT_1_9_SIG,
    POINT_SIG,
    OPER_SIG,
    EQUALS_SIG,
    TERMINATE_SIG,
    IGNORE_SIG,
    MAX_SIG
};

typedef struct QCalcEvtTag QCalcEvt;
struct QCalcEvtTag {
    QEvent super_;                                  /* inhetits from QEvent */
    uint8_t keyId;                               /* ID of the key depressed */
};

#define DISP_WIDTH  14

typedef struct QCalcTag QCalc;
struct QCalcTag {
    QHsm super_;                                       /* derives from QHsm */
    double operand1_;
    double operand2_;
    char display_[DISP_WIDTH + 1];
    uint8_t len_;
    uint8_t opKey_;
};

/* public methods: */
void QCalc_ctor(QCalc *me);
char const *QCalc_getDisplay(QCalc const *me);

/* protected state machine methods: */
void QCalc_initial(QCalc *me, QEvent const *e);
QSTATE QCalc_on(QCalc *me, QEvent const *e);
QSTATE QCalc_error(QCalc *me, QEvent const *e);
QSTATE QCalc_ready(QCalc *me, QEvent const *e);
QSTATE QCalc_result(QCalc *me, QEvent const *e);
QSTATE QCalc_begin(QCalc *me, QEvent const *e);
QSTATE QCalc_negated1(QCalc *me, QEvent const *e);
QSTATE QCalc_operand1(QCalc *me, QEvent const *e);
QSTATE QCalc_zero1(QCalc *me, QEvent const *e);
QSTATE QCalc_int1(QCalc *me, QEvent const *e);
QSTATE QCalc_frac1(QCalc *me, QEvent const *e);
QSTATE QCalc_opEntered(QCalc *me, QEvent const *e);
QSTATE QCalc_negated2(QCalc *me, QEvent const *e);
QSTATE QCalc_operand2(QCalc *me, QEvent const *e);
QSTATE QCalc_zero2(QCalc *me, QEvent const *e);
QSTATE QCalc_int2(QCalc *me, QEvent const *e);
QSTATE QCalc_frac2(QCalc *me, QEvent const *e);

/* protected methods: */
void QCalc_clear_(QCalc *me);
void QCalc_insert_(QCalc *me, int keyId);
void QCalc_negate_(QCalc *me);
int QCalc_eval_(QCalc *me);

/* platform-dependent callback functions to update the state and exit */
void QCalc_updateState(QCalc *me, char const *s);
void QCalc_exit(QCalc *me);

#endif                                                           /* qcalc_h */