• Stars
    star
    107
  • Rank 323,523 (Top 7 %)
  • Language
    Shell
  • License
    Other
  • Created almost 8 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

QM model-based design tool and code generator based on UML state machines

QM model-based design tool

What's New?

GitHub release (latest by date)

View QM Revision History at: https://www.state-machine.com/qm/history.html

Documentation

The online HTML documention for the latest version of QM is located at: https://www.state-machine.com/qm/

The offline HTML documentation for this particular version of QM is located in the folder html/. To view the offline documentation, open the file html/index.html in your web browser.

About QM

QM (QP Modeler) is a freeware graphical modeling tool for designing and implementing real-time embedded software based on the UML state machines and the lightweight [QP Real-Time Embedded Frameworks (RTEFs)][QP]. QM is available for Windows 32/64-bit, Linux 64-bit, and MacOS.

NOTE: For more information, please refer to the online QM Manual at: https://www.state-machine.com/qm/

Downloading and Installing QM

The most recommended way of obtaining QM is by downloading the QP-bundle, which includes QM and also all QP frameworks and the QTools collection. The main advantage of obtaining QM bundled together like that is that you get all components, tools and examples ready to go.

NOTE: QP-bundle is the most recommended way of downloading and installing QM. However, if you are allergic to installers and GUIs or don't have administrator privileges you can also download and install QM separately as described below.

CAUTION: If you have any previous version of QM installed on your system, please uninstall it before installing the new version.

Installing QM on Windows (64-bit)

Go to the QM releases and download the QM installer (qm_<ver>-win64.exe), which is digitally signed by Quantum Leaps. The installer will create a desktop shortcut for QM and will also associate QM model files (*.qm and *.qmp)

Alternatively, if you are allergic to installers, you can download QM zip archive for Windows (qm_<ver>-win64.zip). Installation consists of unzipping the archive into any directory, although the C:\qp\ folder is the recommended default.

NOTE: It is generally not recommended to install QM in such standard locations as "Program Files" or "Program Files (x86)", because these directories have access limitations and don't allow you to modify the QM Style Sheets (qm_dark.qss and qm_light.qss) or the model templates.

If you intalled QM via the installer program, the unistaller will be provided and you can uninstall QM via the standard "Apps and Features".

If you intalled QM from the zip archive, you unistall QM by simply deleting the installation directory.

Installing QM on Linux (64-bit)

Go to the QM releases and download the QM zip archive for Linux (qm_<ver>-linux64.zip). You can unzip the archive into any directory, although the ~/qp/ folder is the recommended default.

After unzipping the archive, go to the qm/bin/ directory and make sure that the qm executable and the qm.sh shell script have executable permissions. You can either do this with your desktop's file manager or at the command line, type:

chmod u+x qm
chmod u+x qm.sh

NOTE: To run the QM application on Linux, you need to run the qm/bin/qm.sh script. Make sure that the file has executable permissions.

Installing QM on macOS

Go to the QM releases and download the disk image for MacOS (qm_<ver>-macos.dmg). Double click on .dmg file. This will mount and open the disk image. To install the QM tool, you simply drag the qm.app image into the Applications folder (typically visible in the Dock). If you wish, you might also create the alias of the qm.app and place it on your Desktop.

To uninstall QM, simply delete the qm.app file and the examples.

Example Projects

The QM example models are included in the QP baseline distributions. The console-type examples are available for Windows (MinGW and Visual C++), Linux, and macOS. GUI-based simulations are available for Windows with the raw Win32 API. Cross-platform GUI examples based on the Qt framework are available in QP/C++.

Embedded examples are available for a number of boards, such as ARM Cortex-M, AVR, MSP430 with the IAR, ARM/KEIL, and GNU compilers.

Additionally, a number of examples are provided for the desktop (Windows and POSIX). These examples don't require any embedded hardware to try.

All examples are located in the /examples/ directory, where denotes the folder where you have installed the specific version of the QP framework (QP/C, QP/C++, or QP-nano).

Licensing QM

The QM graphical modeling tool is freeware. It is free to download and free use, but is not open source. During the installation you will need to accept a basic End-User License Agreement (see https://www.state-machine.com/qm/license.html ), which legally protects Quantum Leaps from any warranty claims, prohibits removing any copyright notices from QM, selling it, and creating similar competitive products. The EULA also prohibits distributing QM from third-party websites. The only legitimate source of QM is the SourceForge.net/projects/qpc/ website.

NOTE: QM uses internally the Qt application toolkit under LGPL Please refer to the LGPL Compliance Package for QM in the sub-directory qt_lgpl or online at https://www.state-machine.com/qm/qt_lgpl.html for more information how to obtain the source code for the Qt toolkit.

Licensing Generated Code

The code generated by QM is licensed under the same terms as the underlying QP framework, for which the code has been generated. Please refer to the QP licensing (https://www.state-machine.com/licensing/ ) for more information.

Support and Issue Resolution

Support for QM is provided in the Free Support forum at:

Bug Reports

The QM software has many assertions inside, and the assertions are ENABLED in the release version. When you hit an assertion, or any other error, please check the "Bug Tracker" available at:

If you don't find your problem, please try to reliably reproduce the problem, and submit a concise report to the "Bug Tracker"

Thank you for your help in improving QM!

Feature Requests

Also, if you find inconsistencies or any awkward features, please submit a suggestion how to improve this functionality to the "Feature Tracker" at:

How to Help this Project?

If you like this project, please give it a star (in the upper-right corner of your browser window):

GitHub star

More Repositories

1

qpc

QP/C Real-Time Embedded Framework/RTOS for embedded systems based on active objects (actors) and hierarchical state machines
C
788
star
2

modern-embedded-programming-course

Companion repository to the "Modern Embedded Systems Programming" video course.
C
358
star
3

qpcpp

QP/C++ Real-Time Embedded Framework/RTOS for embedded systems based on active objects (actors) and hierarchical state machines
C++
316
star
4

OOP-in-C

Simple and efficient implementation of OOP in C suitable for real-time embedded systems.
C
159
star
5

qpn

QP-nano real-time embedded framework/RTOS for embedded systems based on active objects (actors) and hierarchical state machines
C
148
star
6

qtools

QTools collection of open source tools for embedded systems development on Windows, Linux and MacOS
C
113
star
7

Super-Simple-Tasker

Event-driven, preemptive, priority-based, hardware RTOS for ARM Cortex-M.
C
111
star
8

MiROS

MiROS (Minimal Real-Time Operating System) for ARM Cortex-M
C
65
star
9

FreeAct

FreeAct is a minimal Active Object (Actor) framework for FreeRTOS
C
65
star
10

lock-free-ring-buffer

"Lock-Free Ring Buffer" (LFRB) is a minimal, customizable implementation of a ring buffer (a.k.a. circular buffer) in C, specifically suitable for embedded systems.
C
60
star
11

qp-arduino

QP real-time embedded frameworks/RTOS for Arduino (AVR and SAM)
C++
41
star
12

State-Oriented-Programming

State-Oriented Programming: was a cover story article about Hierarchical State Machines in C and C++ published originally in "Embedded Systems Programming" magazine in August 2000. This repository contains the article PDF and the updated code.
C
25
star
13

embedded-coding-style

Embedded C and C++ Coding Style
CSS
14
star
14

Embedded-Test

Embedded Test (ET) -- The Super-Simple Embedded Test
C
8
star
15

DBC-for-embedded-C

Design By Contract (DBC) for embedded C and C++
C
4
star
16

qpc-zephyr-app

Example project and starting point for creating QP/C-Zephyr applications.
C
4
star
17

contributed

Software contributed to the QP framework ecosystem
3
star
18

qpcpp-zephyr-app

Example project and starting point for creating QP/C++-Zephyr applications.
C++
3
star
19

3rd_party

3rd-party code used in the QP/C and QP/C++ examples
C
2
star
20

cmsis-packs

CMSIS packs released by Quantum Leaps
2
star
21

spexygen

Traceable specifications based on Doxygen
CSS
2
star
22

ql-doxygen

Doxygen customization based on doxygen-awesome-css
CSS
2
star
23

spexygen1

Traceable specifications based on Doxygen.
CSS
2
star
24

ET

ET (Embedded Test) -- The Super-Simple Embedded Test
C
1
star
25

.github

Quantum Leaps' profile
1
star