mirror of
https://github.com/QuantumLeaps/qpcpp.git
synced 2025-01-28 06:02:56 +08:00
231 lines
9.1 KiB
C++
231 lines
9.1 KiB
C++
|
//****************************************************************************
|
||
|
|
// Product: Deferred Event state pattern example
|
||
|
|
// Last Updated for Version: 5.1.1
|
||
|
|
// Date of the Last Update: Oct 08, 2013
|
||
|
|
//
|
||
|
|
// Q u a n t u m L e a P s
|
||
|
|
// ---------------------------
|
||
|
|
// innovating embedded systems
|
||
|
|
//
|
||
|
|
// Copyright (C) 2002-2013 Quantum Leaps, LLC. All rights reserved.
|
||
|
|
//
|
||
|
|
// This program is open source software: you can redistribute it and/or
|
||
|
|
// modify it under the terms of the GNU General Public License as published
|
||
|
|
// by the Free Software Foundation, either version 2 of the License, or
|
||
|
|
// (at your option) any later version.
|
||
|
|
//
|
||
|
|
// Alternatively, this program may be distributed and modified under the
|
||
|
|
// terms of Quantum Leaps commercial licenses, which expressly supersede
|
||
|
|
// the GNU General Public License and are specifically designed for
|
||
|
|
// licensees interested in retaining the proprietary status of their code.
|
||
|
|
//
|
||
|
|
// This program is distributed in the hope that it will be useful,
|
||
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
|
|
// GNU General Public License for more details.
|
||
|
|
//
|
||
|
|
// You should have received a copy of the GNU General Public License
|
||
|
|
// along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||
|
|
//
|
||
|
|
// Contact information:
|
||
|
|
// Quantum Leaps Web sites: http://www.quantum-leaps.com
|
||
|
|
// http://www.state-machine.com
|
||
|
|
// e-mail: info@quantum-leaps.com
|
||
|
|
//****************************************************************************
|
||
|
|
#include "qp_port.h"
|
||
|
|
#include "bsp.h"
|
||
|
|
|
||
|
|
#include <stdio.h> // this example uses printf() to report status
|
||
|
|
|
||
|
|
Q_DEFINE_THIS_FILE
|
||
|
|
|
||
|
|
using namespace QP;
|
||
|
|
|
||
|
|
//............................................................................
|
||
|
|
enum TServerSignals {
|
||
|
|
NEW_REQUEST_SIG = Q_USER_SIG, // the new request signal
|
||
|
|
RECEIVED_SIG, // the request has been received
|
||
|
|
AUTHORIZED_SIG, // the request has been authorized
|
||
|
|
TERMINATE_SIG // terminate the application
|
||
|
|
};
|
||
|
|
//............................................................................
|
||
|
|
struct RequestEvt : public QEvt {
|
||
|
|
uint8_t ref_num; // reference number of the request
|
||
|
|
};
|
||
|
|
|
||
|
|
class TServer : public QActive { // Transaction Server active object
|
||
|
|
private:
|
||
|
|
QEQueue m_requestQueue; // native QF queue for deferred request events
|
||
|
|
QEvt const *m_requestQSto[3]; // storage for the deferred queue buffer
|
||
|
|
|
||
|
|
QTimeEvt m_receivedEvt; // private time event generator
|
||
|
|
QTimeEvt m_authorizedEvt; // private time event generator
|
||
|
|
|
||
|
|
public:
|
||
|
|
TServer() // the default ctor
|
||
|
|
: QActive((QStateHandler)&TServer::initial),
|
||
|
|
m_receivedEvt(RECEIVED_SIG),
|
||
|
|
m_authorizedEvt(AUTHORIZED_SIG)
|
||
|
|
{
|
||
|
|
m_requestQueue.init(m_requestQSto, Q_DIM(m_requestQSto));
|
||
|
|
}
|
||
|
|
|
||
|
|
private:
|
||
|
|
// hierarchical state machine ...
|
||
|
|
static QState initial (TServer *me, QEvt const *e);
|
||
|
|
static QState idle (TServer *me, QEvt const *e);
|
||
|
|
static QState busy (TServer *me, QEvt const *e);
|
||
|
|
static QState receiving (TServer *me, QEvt const *e);
|
||
|
|
static QState authorizing(TServer *me, QEvt const *e);
|
||
|
|
static QState final (TServer *me, QEvt const *e);
|
||
|
|
};
|
||
|
|
|
||
|
|
// HSM definition ------------------------------------------------------------
|
||
|
|
QState TServer::initial(TServer *me, QEvt const *) {
|
||
|
|
return Q_TRAN(&TServer::idle);
|
||
|
|
}
|
||
|
|
//............................................................................
|
||
|
|
QState TServer::final(TServer *me, QEvt const *e) {
|
||
|
|
switch (e->sig) {
|
||
|
|
case Q_ENTRY_SIG: {
|
||
|
|
printf("final-ENTRY;\nBye!Bye!\n");
|
||
|
|
QF::stop(); // terminate the application
|
||
|
|
return Q_HANDLED();
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return Q_SUPER(&QHsm::top);
|
||
|
|
}
|
||
|
|
//............................................................................
|
||
|
|
QState TServer::idle(TServer *me, QEvt const *e) {
|
||
|
|
switch (e->sig) {
|
||
|
|
case Q_ENTRY_SIG: {
|
||
|
|
printf("idle-ENTRY;\n");
|
||
|
|
// recall the request from the requestQueue
|
||
|
|
if (me->recall(&me->m_requestQueue)) {
|
||
|
|
printf("Request recalled\n");
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
printf("No deferred requests\n");
|
||
|
|
}
|
||
|
|
return Q_HANDLED();
|
||
|
|
}
|
||
|
|
case NEW_REQUEST_SIG: {
|
||
|
|
printf("Processing request #%d\n",
|
||
|
|
(int)((RequestEvt const *)e)->ref_num);
|
||
|
|
return Q_TRAN(&TServer::receiving);
|
||
|
|
}
|
||
|
|
case TERMINATE_SIG: {
|
||
|
|
return Q_TRAN(&TServer::final);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return Q_SUPER(&QHsm::top);
|
||
|
|
}
|
||
|
|
//............................................................................
|
||
|
|
QState TServer::busy(TServer *me, QEvt const *e) {
|
||
|
|
switch (e->sig) {
|
||
|
|
case NEW_REQUEST_SIG: {
|
||
|
|
if (me->defer(&me->m_requestQueue, e)) { // could defer?
|
||
|
|
printf("Request #%d deferred;\n",
|
||
|
|
(int)((RequestEvt const *)e)->ref_num);
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
printf("Request #%d IGNORED;\n",
|
||
|
|
(int)((RequestEvt const *)e)->ref_num);
|
||
|
|
// notify the request sender that his request was denied...
|
||
|
|
}
|
||
|
|
return Q_HANDLED();
|
||
|
|
}
|
||
|
|
case TERMINATE_SIG: {
|
||
|
|
return Q_TRAN(&TServer::final);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return Q_SUPER(&QHsm::top);
|
||
|
|
}
|
||
|
|
//............................................................................
|
||
|
|
QState TServer::receiving(TServer *me, QEvt const *e) {
|
||
|
|
switch (e->sig) {
|
||
|
|
case Q_ENTRY_SIG: {
|
||
|
|
printf("receiving-ENTRY;\n");
|
||
|
|
// one-shot timeout in 1 second
|
||
|
|
me->m_receivedEvt.postIn(me, BSP_TICKS_PER_SEC);
|
||
|
|
return Q_HANDLED();
|
||
|
|
}
|
||
|
|
case Q_EXIT_SIG: {
|
||
|
|
me->m_receivedEvt.disarm();
|
||
|
|
return Q_HANDLED();
|
||
|
|
}
|
||
|
|
case RECEIVED_SIG: {
|
||
|
|
return Q_TRAN(&TServer::authorizing);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return Q_SUPER(&TServer::busy);
|
||
|
|
}
|
||
|
|
//............................................................................
|
||
|
|
QState TServer::authorizing(TServer *me, QEvt const *e) {
|
||
|
|
switch (e->sig) {
|
||
|
|
case Q_ENTRY_SIG: {
|
||
|
|
printf("authorizing-ENTRY;\n");
|
||
|
|
// one-shot timeout in 2 seconds
|
||
|
|
me->m_authorizedEvt.postIn(me, 2*BSP_TICKS_PER_SEC);
|
||
|
|
return Q_HANDLED();
|
||
|
|
}
|
||
|
|
case Q_EXIT_SIG: {
|
||
|
|
me->m_authorizedEvt.disarm();
|
||
|
|
return Q_HANDLED();
|
||
|
|
}
|
||
|
|
case AUTHORIZED_SIG: {
|
||
|
|
return Q_TRAN(&TServer::idle);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return Q_SUPER(&TServer::busy);
|
||
|
|
}
|
||
|
|
|
||
|
|
// test harness ==============================================================
|
||
|
|
|
||
|
|
// Local-scope objects -------------------------------------------------------
|
||
|
|
static TServer l_tserver; // the Transaction Server active object
|
||
|
|
static QEvt const *l_tserverQSto[10]; // Event queue storage for TServer
|
||
|
|
static RequestEvt l_smlPoolSto[10]; // small event pool
|
||
|
|
|
||
|
|
//............................................................................
|
||
|
|
int main(int argc, char *argv[]) {
|
||
|
|
printf("Reminder state pattern\nQEP version: %s\nQF version: %s\n"
|
||
|
|
"Press n to generate a new request\n"
|
||
|
|
"Press ESC to quit...\n",
|
||
|
|
QEP::getVersion(), QF::getVersion());
|
||
|
|
|
||
|
|
BSP_init(argc, argv); // initialize the BSP
|
||
|
|
|
||
|
|
QF::init(); // initialize the framework and the underlying RTOS/OS
|
||
|
|
|
||
|
|
|
||
|
|
// publish-subscribe not used, no call to QF::psInit()
|
||
|
|
|
||
|
|
// initialize event pools...
|
||
|
|
QF::poolInit(l_smlPoolSto, sizeof(l_smlPoolSto), sizeof(l_smlPoolSto[0]));
|
||
|
|
|
||
|
|
// start the active objects...
|
||
|
|
l_tserver.start(1, l_tserverQSto, Q_DIM(l_tserverQSto),
|
||
|
|
(void *)0, 0, (QEvt *)0);
|
||
|
|
|
||
|
|
return QF::run(); // run the QF application
|
||
|
|
}
|
||
|
|
//............................................................................
|
||
|
|
void BSP_onKeyboardInput(uint8_t key) {
|
||
|
|
switch (key) {
|
||
|
|
case 'n': { // 'n': new request?
|
||
|
|
static uint8_t reqCtr = 0; // count the requests
|
||
|
|
RequestEvt *e = Q_NEW(RequestEvt, NEW_REQUEST_SIG);
|
||
|
|
e->ref_num = (++reqCtr); // set the reference number
|
||
|
|
// post directly to TServer active object
|
||
|
|
l_tserver.POST(e, (void *)0); // post directly to TServer AO
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
case '\33': { // ESC pressed?
|
||
|
|
static QEvt const terminateEvt = { TERMINATE_SIG, 0};
|
||
|
|
l_tserver.POST(&terminateEvt, (void *)0);
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|