API Reference

Low-Power ExampleDeprecated APIs

Compile-Time Configuration

QP/C Framework supports compile-time configuration through the following mechanisms:

• command-line macros
• qp_config.h header file
• qp_port.h header file
• qs_port.h header file

Active Objects

QP/C 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()

QMActive class (derived from QActive)

• QMActive_ctor()

Publish-Subscribe

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

Events

QP/C Framework supports events, through the following bases classes:

QEvt class (see also Event Management and Time Management)

• QEvt
• QEVT_INITIALIZER() - initializer for immutable events
• Q_EVT_CAST() - event down-casting

State Machines

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

QAsm class

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

QHsm class (derived from QAsm)

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

QMsm class (derived from QAsm)

• QMsm_ctor()
• QMsm_stateObj()

Mutable Event Management

• QF_poolInit()
• Q_NEW()
• Q_NEW_X()
• QEvt_init()
• 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, which 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

• QF_run()
• QV_schedDisable()
• QV_schedEnable()
• 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

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

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

• QF_run()
• QXK_onIdle()
• QXK_schedLock(
• QXK_schedUnlock()
• QXK_onIdle()
• QXK_current()

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(

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()

QMPool class

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

Low-Power ExampleDeprecated APIs