QHsm Struct Reference

#include <qep.h>

Inheritance diagram for QHsm:

Collaboration diagram for QHsm:

Public Member Functions
#define	QHSM_INIT(me_, par_, qs_id_)
#define	QHSM_DISPATCH(me_, e_, qs_id_)    ((*(me_)->vptr->dispatch)((me_), (e_), (qs_id_)))
#define	QHsm_state(me_)   (Q_STATE_CAST(Q_HSM_UPCAST(me_)->state.fun))
#define	QHsm_childState(me_, parent_)    QHsm_childState_(Q_HSM_UPCAST(me_), Q_STATE_CAST(parent_))
bool	QHsm_isIn (QHsm *const me, QStateHandler const state)

Data Fields
struct QHsmVtable const *	vptr
union QHsmAttr	state
union QHsmAttr	temp

Protected Member Functions
void	QHsm_ctor (QHsm *const me, QStateHandler initial)
QState	QHsm_top (void const *const me, QEvt const *const e)

Private Member Functions
QStateHandler	QHsm_childState_ (QHsm *const me, QStateHandler const parent)

Detailed Description

Hierarchical State Machine class

Description

QHsm represents a Hierarchical State Machine (HSM) with full support for hierarchical nesting of states, entry/exit actions, initial transitions, and transitions to history in any composite state. This class is designed for ease of manual coding of HSMs in C, but it is also supported by the QM modeling tool.
QHsm is also the base class for the QMsm state machine, which provides a superior efficiency, but requires the use of the QM modeling tool to generate code.

Note

QHsm is not intended to be instantiated directly, but rather serves as the base structure for derivation of state machines in the application code.

Usage

The following example illustrates how to derive a state machine structure from QHsm. Please note that the QHsm member super is defined as the FIRST member of the derived struct.

typedef struct {
    QHsm super;  /* inhertits QHsm */
 
    double operand1;
    double operand2;
    char display[DISP_WIDTH + 1];
    uint8_t len;
    uint8_t opKey;
} Calc;

Definition at line 282 of file qep.h.

Member Function Documentation

QHsm_isIn()

bool QHsm_isIn	(	QHsm *const	me,
		QStateHandler const	state
	)

Tests if a given state is part of the current active state configuration in QHsm subclasses.

Definition at line 602 of file qep_hsm.c.

QHsm_ctor()

void QHsm_ctor ( QHsm *const  me, QStateHandler  initial  )

protected

Protected "constructor" of QHsm

Definition at line 133 of file qep_hsm.c.

QHsm_top()

QState QHsm_top ( void const *const  me, QEvt const *const  e  )

protected

the top-state.

Definition at line 250 of file qep_hsm.c.

QHsm_childState_()

QStateHandler QHsm_childState_ ( QHsm *const  me, QStateHandler const  parent  )

private

Helper function to obtain the current active child state of a parent

Definition at line 648 of file qep_hsm.c.

Field Documentation

vptr

struct QHsmVtable const* vptr

virtual pointer

Definition at line 283 of file qep.h.

state

union QHsmAttr state

current active state (state-variable)

Definition at line 283 of file qep.h.

temp

union QHsmAttr temp

temporary: tran. chain, target state, etc.

Definition at line 283 of file qep.h.

---

The documentation for this struct was generated from the following file:

• qep.h