API Reference

Low-Power ExampleDeprecated APIs

State Machines

The QP Framework supports event-driven, hierarchical state machines through the following bases classes:

QEvt class (see also Event Management)

• QEvt
• QEVT_INITIALIZER()
• Q_EVT_CAST()

QAsm class

• QASM_INIT()
• QASM_DISPATCH()
• QASM_IS_IN()

QHsm class (derived from QAsm)

• QHsm_ctor()
• QHsm_state()
• QHsm_top()

QMsm class (derived from QAsm)

• QMsm class (derived from QHsm)
• QMsm_ctor()
• QMsm_stateObj()
• Q_STATE_CAST()

Active Objects

The QP Framework supports Active Objects through the following base classes.

QActive class (derived from QAsm)

• QActive_ctor()
• QACTIVE_START()
• QACTIVE_POST()
• QACTIVE_POST_X()
• QACTIVE_POST_LIFO()
• QActive_defer()
• QActive_recall()
• QActive_flushDeferred()
• QActive_stop()

Publish-Subscribe

• QActive_psInit()
• QActive_subscribe()
• QActive_unsubscribe()
• QActive_unsubscribeAll()
• QACTIVE_PUBLISH()

QMActive class (derived from QActive)

• QMActive_ctor()
• QACTIVE_START() (inherited from QActive)
• QACTIVE_POST() (inherited from QActive)
• QACTIVE_POST_X() (inherited from QActive)
• QACTIVE_POST_LIFO() (inherited from QActive)
• QACTIVE_PUBLISH() (inherited from QActive)

Mutable Event Management

• QF_poolInit()
• Q_NEW()
• Q_NEW_X()
• Q_NEW_REF()
• Q_DELETE_REF()
• QF_gc()

QMPool class (memory pool, also used for mutable events)

• QMPool_init()
• QMPool_get()
• QMPool_put()

Time Management

QTimeEvt class (derived from QEvt)

• QTIMEEVT_TICK()
• QTimeEvt_ctorX()
• QTimeEvt_armX()
• QTimeEvt_disarm()
• QTimeEvt_rearm()
• QTimeEvt_currCtr()

QTicker active object (derived from QTimeEvt)

Event Queues (raw thread-safe)

QEQueue class

• QEQueue_init()
• QEQueue_post()
• QEQueue_postLIFO()
• QEQueue_get()
• QEQueue_getNFree()
• QEQueue_getNMin()
• QEQueue_isEmpty()

Software Tracing

QS is a software tracing system that enables developers to monitor live event-driven QP applications with minimal target system resources and without stopping or significantly slowing down the code. QS is an ideal tool for testing, troubleshooting, and optimizing QP applications. QS can even be used to support acceptance testing in product manufacturing.

QS-Transmit (QS-TX)

• QS_INIT()
• QS_initBuf()
• QS_getByte()
• QS_getBlock()
• QS_onStartup()
• QS_onCleanup()
• QS_onFlush()
• QS_onGetTime()

QS Filters

• QS_GLB_FILTER()
• QS_LOC_FILTER()
• QS_FILTER_AP_OBJ()

QS Dictionaries

• QS_SIG_DICTIONARY()
• QS_OBJ_DICTIONARY()
• QS_OBJ_ARR_DICTIONARY()
• QS_FUN_DICTIONARY()
• QS_USR_DICTIONARY()
• QS_ENUM_DICTIONARY()

QS Application-Specific Records

• QS_BEGIN_ID()
• QS_END()
• QS_U8() / QS_I8()
• QS_U16() / QS_I16()
• QS_U32() / QS_I32()
• QS_ENUM()
• QS_STR()
• QS_MEM()
• QS_USER enumeration

QS Receive-Channel (QS-RX)

• QS_rxInitBuf()
• QS_rxParse()
• QS_onCommand()
• QS_RX_PUT()

QV (Non-preemptive Kernel)

QV is a simple non-preemptive kernel (previously called "Vanilla" kernel). This kernel executes active objects one at a time, with priority-based scheduling performed before processing of each event. Due to naturally short duration of event processing in state machines, the simple QV kernel is often adequate for many real-time systems.

Kernel Initialization and Control

• QV_INIT()
• QF_run()
• QV_onIdle()
• QV_CPU_SLEEP()

QK (Preemptive RTC Kernel)

QK is a lightweight preemptive, priority-based, run-to-completion (RTC) kernel designed specifically for executing event-driven active objects.

Kernel Initialization and Control

• QK_INIT()
• QF_run()
• QK_onIdle()
• QK_schedLock()
• QK_schedUnlock()

QK Interrupt Management

• QK_ISR_ENTRY()
• QK_ISR_EXIT()

QXK (Dual-Mode Kernel)

QXK is a lightweight, preemptive, priority-based, dual-mode (run-to-completion/blocking) kernel that executes active objects like the QK kernel, but can also execute traditional blocking threads (extended threads). In this respect, QXK behaves exactly as a conventional RTOS (Real-Time Operating System). QXK has been designed specifically for mixing event-driven active objects with traditional blocking code, such as commercial middleware (TCP/IP stacks, UDP stacks, embedded file systems, etc.) or legacy software.

Kernel Initialization and Control

• QXK_INIT()
• QF_run()
• QXK_onIdle()
• QXK_schedLock(
• QXK_schedUnlock()
• QXK_onIdle()

QXK Interrupt Management

• QXK_ISR_ENTRY()
• QXK_ISR_EXIT()

QXThread class

• QXThread_ctor()
• QXTHREAD_START()
• QXTHREAD_POST_X()
• Q_XTHREAD_CAST()
• QXThread_delay()
• QXThread_delayCancel()
• QXThread_queueGet(
• QXK_current()
• QXK_TLS()

QXThread Message Queues

• QXTHREAD_POST_X() - posting messages to blocking threads
• QACTIVE_POST_X() - posting events to Active Objects
• QXThread_queueGet()

QXSemaphore class

• QXSemaphore_init()
• QXSemaphore_wait()
• QXSemaphore_tryWait()
• QXSemaphore_signal()

QXMutex class

• QXMutex_init()
• QXMutex_lock()
• QXMutex_tryLock()
• QXMutex_unlock()

Low-Power ExampleDeprecated APIs