# qm

**Repository Path**: codecooko/qm

## Basic Information

- **Project Name**: qm
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-18
- **Last Updated**: 2025-02-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![QM model-based design tool](https://www.state-machine.com/img/qm_3monitors.jpg)

# What's New?

[![GitHub release (latest by date)](https://img.shields.io/github/v/release/QuantumLeaps/qm)](https://github.com/QuantumLeaps/qm/releases/latest)

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](https://www.state-machine.com/#Downloads), which includes
QM and also all [QP frameworks](https://www.state-machine.com/products/)
and the [QTools collection](https://www.state-machine.com/products/).
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](https://www.state-machine.com/#Downloads) 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 (32/64-bit)
Go to the [QM releases](https://github.com/QuantumLeaps/qm/releases) and
download the QM installer (`qm_<ver>-windows.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>-windows.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 Sheet (`qm.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](https://github.com/QuantumLeaps/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:

```sh
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](https://github.com/QuantumLeaps/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 <qp>/examples/ directory, where <qp>
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:

- https://sourceforge.net/projects/qpc/forums/forum/668726


## 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:

- https://sourceforge.net/p/qpc/bugs/

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:

- https://sourceforge.net/p/qpc/feature-requests/


# 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](doxygen/images/github-star.jpg)