QP/C++  7.0.1
Real-Time Embedded Framework
QTicker Class Reference

"Ticker" Active Object class More...

#include <qf.hpp>

Inheritance diagram for QTicker:
QActive QHsm

Public Member Functions

 QTicker (std::uint_fast8_t const tickRate) noexcept
 
void init (void const *const e, std::uint_fast8_t const qs_id) noexcept override
 executes the top-most initial transition in QP::QHsm More...
 
void init (std::uint_fast8_t const qs_id) noexcept override
 overloaded init(qs_id) More...
 
void dispatch (QEvt const *const e, std::uint_fast8_t const qs_id) noexcept override
 Dispatches an event to QHsm. More...
 
bool post_ (QEvt const *const e, std::uint_fast16_t const margin, void const *const sender) noexcept override
 
void postLIFO (QEvt const *const e) noexcept override
 Posts an event directly to the event queue of the active object using the Last-In-First-Out (LIFO) policy. More...
 
- Public Member Functions inherited from QActive
virtual void start (std::uint_fast8_t const prio, QEvt const **const qSto, std::uint_fast16_t const qLen, void *const stkSto, std::uint_fast16_t const stkSize, void const *const par)
 Starts execution of an active object and registers the object with the framework. More...
 
virtual void start (std::uint_fast8_t const prio, QEvt const **const qSto, std::uint_fast16_t const qLen, void *const stkSto, std::uint_fast16_t const stkSize)
 Overloaded start function (no initialization event) More...
 
void stop (void)
 Stops execution of an active object and removes it from the framework's supervision. More...
 
virtual bool post_ (QEvt const *const e, std::uint_fast16_t const margin, void const *const sender) noexcept
 
virtual void postLIFO (QEvt const *const e) noexcept
 Posts an event directly to the event queue of the active object using the Last-In-First-Out (LIFO) policy. More...
 
void unsubscribeAll (void) const noexcept
 Un-subscribes from the delivery of all signals to the active object. More...
 
void subscribe (enum_t const sig) const noexcept
 Subscribes for delivery of signal sig to the active object. More...
 
void unsubscribe (enum_t const sig) const noexcept
 Un-subscribes from the delivery of signal sig to the active object. More...
 
bool defer (QEQueue *const eq, QEvt const *const e) const noexcept
 Defer an event to a given separate event queue. More...
 
bool recall (QEQueue *const eq) noexcept
 Recall a deferred event from a given event queue. More...
 
std::uint_fast16_t flushDeferred (QEQueue *const eq) const noexcept
 Flush the specified deferred queue 'eq'. More...
 
std::uint_fast8_t getPrio (void) const noexcept
 Get the priority of the active object. More...
 
void setPrio (std::uint_fast8_t const prio)
 Set the priority of the active object. More...
 
void setAttr (std::uint32_t attr1, void const *attr2=nullptr)
 Generic setting of additional attributes (useful in QP ports) More...
 
QEvt const * get_ (void) noexcept
 Get an event from the event queue of an active object. More...
 
- Public Member Functions inherited from QHsm
virtual ~QHsm ()
 virtual destructor More...
 
virtual void init (void const *const e, std::uint_fast8_t const qs_id)
 executes the top-most initial transition in QP::QHsm More...
 
virtual void init (std::uint_fast8_t const qs_id)
 overloaded init(qs_id) More...
 
virtual void dispatch (QEvt const *const e, std::uint_fast8_t const qs_id)
 Dispatches an event to QHsm. More...
 
bool isIn (QStateHandler const s) noexcept
 Tests if a given state is part of the current active state configuration. More...
 
QStateHandler state (void) const noexcept
 Obtain the current state (state handler function) More...
 
QStateHandler childState (QStateHandler const parent) noexcept
 Obtain the current active child state of a given parent. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from QHsm
static QState top (void *const me, QEvt const *const e) noexcept
 the top-state. More...
 
- Data Fields inherited from QActive
std::uint8_t m_prio
 QF priority (1..QF_MAX_ACTIVE) of this active object. More...
 
- Static Public Attributes inherited from QHsm
static constexpr QState Q_RET_SUPER {static_cast<QState>(0)}
 event passed to the superstate to handle More...
 
static constexpr QState Q_RET_SUPER_SUB {static_cast<QState>(1)}
 event passed to submachine superstate More...
 
static constexpr QState Q_RET_UNHANDLED {static_cast<QState>(2)}
 event unhandled due to a guard evaluating to 'false' More...
 
static constexpr QState Q_RET_HANDLED {static_cast<QState>(3)}
 event handled (internal transition) More...
 
static constexpr QState Q_RET_IGNORED {static_cast<QState>(4)}
 event silently ignored (bubbled up to top) More...
 
static constexpr QState Q_RET_ENTRY {static_cast<QState>(5)}
 state entry action executed More...
 
static constexpr QState Q_RET_EXIT {static_cast<QState>(6)}
 state exit action executed More...
 
static constexpr QState Q_RET_NULL {static_cast<QState>(7)}
 return value without any effect More...
 
static constexpr QState Q_RET_TRAN {static_cast<QState>(8)}
 regular transition taken More...
 
static constexpr QState Q_RET_TRAN_INIT {static_cast<QState>(9)}
 initial transition taken More...
 
static constexpr QState Q_RET_TRAN_EP {static_cast<QState>(10)}
 entry-point transition into a submachine More...
 
static constexpr QState Q_RET_TRAN_HIST {static_cast<QState>(11)}
 transition to history of a given state More...
 
static constexpr QState Q_RET_TRAN_XP {static_cast<QState>(12)}
 exit-point transition out of a submachine More...
 
- Protected Types inherited from QHsm
enum  ReservedHsmSignals : QSignal { Q_ENTRY_SIG = 1 , Q_EXIT_SIG , Q_INIT_SIG }
 
- Protected Member Functions inherited from QActive
 QActive (QStateHandler const initial) noexcept
 protected constructor (abstract class) More...
 
- Protected Member Functions inherited from QHsm
 QHsm (QStateHandler const initial) noexcept
 Protected constructor of QHsm. More...
 
QState tran (QStateHandler const target) noexcept
 Helper function to specify a state transition. More...
 
QState tran_hist (QStateHandler const hist) noexcept
 Helper function to specify a transition to history. More...
 
QState super (QStateHandler const superstate) noexcept
 Helper function to specify the superstate of a given state. More...
 
QState qm_tran (void const *const tatbl) noexcept
 Helper function to specify a regular state transition in a QM state-handler. More...
 
QState qm_tran_hist (QMState const *const hist, void const *const tatbl) noexcept
 Helper function to specifiy a transition to history in a QM state-handler. More...
 
QState qm_tran_init (void const *const tatbl) noexcept
 Helper function to specify an initial state transition in a QM state-handler. More...
 
QState qm_tran_ep (void const *const tatbl) noexcept
 Helper function to specify a transition to an entry point to a submachine state in a QM state-handler. More...
 
QState qm_tran_xp (QActionHandler const xp, void const *const tatbl) noexcept
 Helper function to specify a transition to an exit point from a submachine state in a QM state-handler. More...
 
QState qm_entry (QMState const *const s) noexcept
 Helper function to specify a state entry in a QM state-handler. More...
 
QState qm_exit (QMState const *const s) noexcept
 Helper function to specify a state exit in a QM state-handler. More...
 
virtual QStateHandler getStateHandler () noexcept
 Get the current state handler of the HSM. More...
 
QState qm_sm_exit (QMState const *const s) noexcept
 Helper function to specify a submachine exit in a QM state-handler. More...
 
QState qm_super_sub (QMState const *const s) noexcept
 Helper function to call in a QM state-handler when it passes the event to the host submachine state to handle an event. More...
 

Detailed Description

Description
QP::QTicker is an efficient active object specialized to process QF system clock tick at a specified tick frequency [0..QF_MAX_TICK_RATE]. Placing system clock tick processing in an active object allows you to remove the non-deterministic TICK_X() processing from the interrupt level and move it into the thread-level, where you can prioritize it as low as you wish.
Usage
The following example illustrates use of QP::QTicker active objects:
// bsp.hpp -----------------
extern QP::QTicker ticker0; // "ticker" AO for clock rate 0
extern QP::QTicker ticker1; // "ticker" AO for clock rate 1
#ifdef Q_SPY
// QS-IDs for local filtering
static QSpyId const l_SysTick_Handler = { QS_AP_ID + 5 };
static QSpyId const l_Timer0A_IRQHandler = { QS_AP_ID + 6 };
#endif
// bsp.cpp -----------------
QP::QTicker ticker0; // "ticker" AO for clock rate 0
QP::QTicker ticker1; // "ticker" AO for clock rate 1
// system clock tick ISR for clock rate 0
extern "C" void SysTick_Handler(void) {
. . .
ticker0.POST(nullptr, &l_SysTick_Handler);
. . .
}
// system clock tick ISR for clock rate 1
extern "C" void Timer0A_IRQHandler(void) {
. . .
ticker1.POST(nullptr, &l_Timer0A_IRQHandler);
. . .
}
// main.cpp ---------------
main () {
. . .
ticker0.start(1U, // priority
nullptr, 0U, nullptr, 0U); // not used
ticker1.start(2U, // priority
nullptr, 0U, nullptr, 0U); // not used
. . .
}
virtual void start(std::uint_fast8_t const prio, QEvt const **const qSto, std::uint_fast16_t const qLen, void *const stkSto, std::uint_fast16_t const stkSize, void const *const par)
Starts execution of an active object and registers the object with the framework.
Definition: qk.cpp:165
"Ticker" Active Object class
Definition: qf.hpp:635
@ QS_AP_ID
offset for Appl-spec IDs
Definition: qs.hpp:190
QS ID type for applying local filtering.
Definition: qs.hpp:203

Definition at line 635 of file qf.hpp.

Constructor & Destructor Documentation

◆ QTicker()

QTicker ( std::uint_fast8_t const  tickRate)
explicitnoexcept

Definition at line 384 of file qf_actq.cpp.

Member Function Documentation

◆ init() [1/2]

void init ( void const *const  e,
std::uint_fast8_t const  qs_id 
)
overridevirtualnoexcept
Description
Executes the top-most initial transition in a HSM.
Parameters
[in]epointer to an extra parameter (might be NULL)
[in]qs_idQS-id of this state machine (for QS local filter)
Note
Must be called exactly once before the QP::QHsm::dispatch().
Traceability:

traces to: RQP103

traces to: RQP120I

traces to: RQP120D

Precondition
ctor must have been executed and initial tran NOT taken

Reimplemented from QHsm.

Definition at line 391 of file qf_actq.cpp.

◆ init() [2/2]

void init ( std::uint_fast8_t const  qs_id)
overridevirtualnoexcept

Reimplemented from QHsm.

Definition at line 416 of file qf_actq.cpp.

◆ dispatch()

void dispatch ( QEvt const *const  e,
std::uint_fast8_t const  qs_id 
)
overridevirtualnoexcept
Description
Dispatches an event for processing to a hierarchical state machine (HSM). The processing of an event represents one run-to-completion (RTC) step.
Parameters
[in]epointer to the event to be dispatched to the HSM
[in]qs_idQS-id of this state machine (for QS local filter)
Note
This state machine must be initialized by calling QP::QHsm::init() exactly once before calling QP::QHsm::dispatch().
Traceability:

traces to: RQP103

traces to: RQP120A

traces to: RQP120B

traces to: RQP120C

traces to: RQP120D

traces to: RQP120E

Precondition
the current state must be initialized and the state configuration must be stable
Traceability:
traces to: RQP120A
Traceability:
traces to: RQP120E
Traceability:
traces to: RQP120C
Traceability:
traces to: RQP120B
Traceability:
traces to: RQP120I

Reimplemented from QHsm.

Definition at line 399 of file qf_actq.cpp.

◆ post_()

bool post_ ( QEvt const *const  e,
std::uint_fast16_t const  margin,
void const *const  sender 
)
overridevirtualnoexcept
See also
QActive::post_()

Reimplemented from QActive.

Definition at line 425 of file qf_actq.cpp.

◆ postLIFO()

void postLIFO ( QEvt const *const  e)
overridevirtualnoexcept
Description
posts an event to the event queue of the active object using the Last-In-First-Out (LIFO) policy.
Note
The LIFO policy should be used only for self-posting and with caution, because it alters order of events in the queue.
Parameters
[in]epointer to the event to post to the queue
See also
QActive::post_()

Reimplemented from QActive.

Definition at line 470 of file qf_actq.cpp.


The documentation for this class was generated from the following files: