QP/C++ 8.1.2
Real-Time Event Framework
Loading...
Searching...
No Matches
Overview

Remarks

Getting Started

What is it?

QP/C++ real-time event framework (RTEF) is a lightweight implementation of the asynchronous, event-driven, and non-blocking Active Object (a.k.a. Actor) model of computation specifically designed for real-time embedded systems, such as microcontrollers (MCUs). QP/C++ 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, real-time fashion. Additionally, QP/C++ Framework supports Hierarchical State Machines with which to specify the behavior of Active Objects [UML 2.5], [Sutter:10], [ROOM:94]. The QP/C++ Framework can be viewed as a modern, asynchronous, and truly event-driven real-time operating system.

What's special about it?

The QP/C++ RTEF provides a reusable, event-driven software architecture, which combines the model of concurrency, known as Active Objects (Actors) with Hierarchical State Machines. This approach offers numerous advantages over the traditional "shared state concurrency" based on a conventional Real-Time Operating System (RTOS)↑:

  • Modern, event-driven, asynchronous architecture based on the best practices of concurrent programming collectively known as the Active Object (a.k.a. Actor) model of computation;
  • Non-blocking architecture more extensible and maitanable than conventional RTOS by avoiding hard-coded blocking calls;
  • Inherently safer concurrency architecture than the traditional "shared-state concurrency" approach of a conventional RTOS by replacing direct resource sharing with event exchanges.
  • Efficient, responsive, real-time architecture, easier to analyze and provably meet hard real-time deadlines (e.g., Rate-Monotonic Scheduling↑ method);
  • Higher-level of abstraction closer to the problem domain than the "naked" RTOS threads
  • The right abstractions for applying modern techniques like hierarchical state machines, visual modeling, and automatic code generation (see QM Graphical Modeling Tool↑);
  • Highly readable and efficient implementation of Hierarchical State Machines↑ for specifying the internal behavior of Active Objects;
  • Built-in, configurable, and flexible Software Tracing for troubleshooting (debugging), profiling, monitoring, and optimizing embedded applications with minimal impact on the real-time performance.
  • Built-in, Trace-Based Testing↑ for testing event-driven applications.
  • SafeQP editions specifically designed for safety-critical applications requiring functional-safety certification.

Functional Safety

All QP editions are a natural fit for safety-related applications because they implement several best practices highly recommended by the functional safety standards, such as strictly modular design (Active Objects) or hierarchical state machines (semi-formal methods). Indeed, for decades, the QP/C and QP/C++ Frameworks have been widely used in safety-related applications↑, such as medical, aerospace, and industrial.

Regulatory background
In functional safety standards, such as IEC 61508, the designations HR (highly recommended) and NR (not recommended) have a specific technical meaning. For a given safety integrity level (SIL), techniques marked as HR are expected to be applied unless a documented and justified rationale demonstrates that they are unnecessary or that an alternative measure provides equivalent risk reduction. Conversely, techniques marked as NR are generally not suitable for use at that SIL; if they are applied, the development team must provide a documented justification demonstrating that their use does not compromise the required safety integrity.

QP/C++ Framework Editions

QP real-time event frameworks form a family consisting of the following QP editions:

QP Edition Programming
Language
API Compatibility Safety Functions Certification Artifacts Licensing
Standard QP editions
QP/C C (C11) Same as
SafeQP/C
Assertions Requirements, Architecture
& Design Specifications
Open-source & Commercial
(dual licensing)↑
QP/C++ C++ (C++17) Same as
SafeQP/C++
Assertions Requirements, Architecture
& Design Specifications
Open-source & Commercial
(dual licensing)↑
SafeQP editions engineered for functional safety
SafeQP/C C (C11) Same as
QP/C
All identified
Safety Functions
Complete Certification Kit Commercial only↑
SafeQP/C++ C++ (C++17) Same as
QP/C++
All identified
Safety Functions
Complete Certification Kit Commercial only↑
Remarks
All QP editions are accompanied by the Requirements Specification, Architecture Specification, and Design Specification, which are the best source of information about the underlying concepts, functionality, architecture, and design of the QP Frameworks and the QP Applications based on the frameworks.

SafeQP Editions

The SafeQP/C and SafeQP/C++ frameworks were initially derived from QP/C and QP/C++, respectively, but were extensively reengineered for the safety market using compliant Software Safety Lifecycle (SSL). In this process, the QP framework functional model has been subjected to a full Hazard and Risk Assessment, which identified all areas of weakness within the functional model and API. These findings led to the creation of Safety Requirements Specification and risk mitigation by Safety Functions, which were subsequently implemented, verified, and validated in the SafeQP editions.

Note
The SafeQP editions remain entirely API- and functionally compatible with the corresponding standard QP frameworks. This ensures existing QP Applications can transition seamlessly to SafeQP without requiring any modifications. SafeQP retains QP Frameworks' hallmark features, including a small memory footprint, excellent efficiency, and complex real-time functionality.

SafeQP Certification Kits

The SafeQP frameworks are accompanied by the SafeQP Certification Kits, which provide developers with ready-to-use artifacts, enabling them to save time, mitigate risk, and reduce costs during application certification for safety-critical devices in the industrial, medical, aerospace, and automotive industries.

Object Orientation

QP/C++ is fundamentally an object-oriented framework, which means that the framework itself and your applications derived from the framework are composed of classes and only classes can have state machines associated with them.

Hierarchical State Machines

The behavior of active objects is specified in QP/C++ by means of hierarchical state machines (UML statecharts)↑. The framework supports manual coding of UML state machines in C as well as fully automatic code generation using the free graphical QM model-based design (MBD) tool↑.

Built-in Kernels

The QP/C++ framework can run on bare-metal single-chip microcontrollers, completely replacing a traditional RTOS. The framework contains a selection of built-in real-time kernels, such as the non-preemptive QV kernel, the preemptive non-blocking QK kernel, and the preemptive, dual-mode, blocking QXK kernel (available as one of the QP/C++ Extras). "Native QP/C++ ports" and ready-to-use examples are provided for prominent embedded CPU families, such as ARM Cortex-M, ARM Cortex-R, and MSP430.

3rd-Party Kernels

QP/C++ can also work with many traditional Real-Time Operating Systems (RTOSes) and General-Purpose OSes (GPOSes) (such as Linux (POSIX) and Windows).

Size and Efficiency

Even though QP/C++ offers a higher level of abstraction than a traditional RTOS, when combined with the native built-in kernels, it typically outperforms equivalent traditional RTOS applications both in RAM/ROM footprint and in CPU efficiency. The specific measurements and results are reported in the Application Note: "QP/C++ Performance Tests and Results"↑:

Software Tracing

Software tracing is a method of capturing and recording information about the execution of a software program. Software tracing is particularly effective and powerful in combination with the event-driven Active Object model of computation due to its inherent inversion of control. A running application built of Active Objects is a highly structured affair where all meaningful system interactions funnel through the underlying event-driven framework. This arrangement offers a unique opportunity for applying Software Tracing in a framework like QP.

Documentation Traceability

QP/C++ offers unprecedented, bidirectional traceability among all work artifacts, which gives teams complete visibility from requirements through architecture, design, source code, tests, and back again.

Popularity & Maturity

With 20 years of continuous development, over 400 commercial licensees↑, and many times more open source users worldwide, QP Frameworks are the most popular such offering on the market. They power countless electronic products across a wide variety of markets↑, such as medical, consumer, IoT, defense, robotics, industrial, communication, transportation, semiconductor IP, and many others.

Books

The two editions of the book, Practical Statecharts in C/C++, provide a detailed design study of the QP/C and QP/C++ frameworks and explain the related concepts.

Practical UML Statecharts in C/C++, 2nd Edition

Practical Statecharts in C/C++, 1st Edition

How is it licensed?

The QP/C and QP/C++ frameworks are licensed under the dual licensing model↑, in which both the open source software distribution mechanism and traditional closed source software distribution models are combined.

Note
If your company has a policy forbidding open source in your product, the QP/C and QP/C++ frameworks can be licensed commercially↑, in which case you don't use any open source license, and you do not violate your policy.

Open Source Applications

If you are developing and distributing open source applications, you are free to use the QP™ framework software under the GPL version 3↑, or (at your option) any later GPL version.

Note
Please note that GPL requires that all modifications to the original code, as well as your application code (Derivative Works as defined in the Copyright Law), must also be released under the terms of the GPL open source license.

Closed Source Applications

If you are developing and distributing closed source applications, you can purchase one of the Quantum Leaps commercial licenses↑, which are specifically designed for users interested in retaining the proprietary status of their code. All Quantum Leaps commercial licenses expressly supersede the GPL open source license. This means that when you license Quantum Leaps software under a commercial license, you specifically do not use the software under the open source license, and therefore, you are not subject to any of its terms.

Commercial licensees also gain access to the QP/C++ Extras, which include:

How to get help?

Please post any technical questions to the Free Support Forum↑ hosted on SourceForge.net. Posts to this forum benefit the whole community and are typically answered the same day.

Direct Commercial Support is available to the commercial licensees. Every commercial license includes one year of Technical Support for the licensed software. The support term can be extended annually.

Training and consulting services are also available from Quantum Leaps. Please refer to the Contact web-page↑ for more information.

Note
The features of this online help and tips for using it are described in Section Using Online Help.

Contact Information