QP/C  7.0.0
Real-Time Embedded Framework

QP Framework is a lightweight implementation of the Active Object model of computation specifically tailored for real-time embedded (RTE) systems. QP is both a software infrastructure for building applications consisting of Active Objects (actors) and a runtime environment for executing the Active Objects in a deterministic fashion. Additionally, QP Framework supports Hierarchical State Machines with which to specify the behavior of Active Objects [ROOM:94], [UML 2.5],[Sutter:10].

The main objectives of the QP Framework are:

Context and Functional Decomposition

The following block diagram shows the context of use and the high-level functional decomposition of a system built with the QP Framework.

Context and Functional Decomposition of a System Based on QP

Event-Driven Paradigm

The essential characteristic of the QP Framework is that it is event-driven. That means that any processing is determined in QP by events, which are handled as quickly as possible without blocking (or polling).

Inversion of Control

Like most event-driven systems, QP Framework is based on inversion of control, which means that the control of code execution resides in the QP Framework rather than the QP Application based on QP. Specifically, to handle events, QP Framework calls the QP Application, and not the other way around. Of course, QP Applications can also call services provided in QP Framework, but the main flow of control always begins with the QP Framework.

Framework, NOT a Library

That inversion of control gives the event-driven infrastructure (QP) all the defining characteristics of a framework rather than a library.

The main difference between a framework and a library is that when you use a library, such as a conventional RTOS, you write the main body of each thread, and you call the library code that you want to reuse (e.g., a semaphore). When you use a framework, such as QP, you reuse the main body and write the code it calls (inversion of control).

Active Objects

The QP Application consists of Active Objects (Actors), which are strictly encapsulated software objects conceptually running in their own threads of execution and communicating with each other asynchronously by exchanging events.

State Machines

Each Active Object in QP has a state machine that specifies the event-driven behavior of the Active Object. The main effort of QP application developers goes into elaborating the internal state machines of the Active Objects as well as other (passive) event-driven components.

Portability & Configurability of QP

A reusable architecture for embedded systems, like QP, needs to be adaptable to a wide range of application areas and target hardware selections. For that, QP needs to be highly configurable. Whenever this SRS document mentions "configurability", it explicitly specifies which of the following types of configurability is required:

Compile-Time Configurability

Compile-time configurability means that the specific configuration option (out of a given range of possibilities) is chosen at compile-time and cannot be changed later (e.g., at run-time). Compile-time configurability is typically used for:

In C or C++, compile-time configurability is typically implemented with the preprocessor macros.

Run-Time Configurability

Run-time configurability means that the specific configuration option is chosen at run-time. Unlike compile-time configurability, run-time configurability is finer granularity, usually on an object-by-object basis. It is typically used for: