QM基于模型的设计工具

新特性

查看QM修订历史： https://www.state-machine.com/qm/history.html

文档

最新版本QM的在线HTML文档位于： https://www.state-machine.com/qm/

此特定版本QM的离线HTML文档位于html/文件夹。要查看离线文档，请在网页浏览器中打开html/index.html文件。

关于QM

QM（QP建模器）是一款免费的图形化建模工具，用于设计和实现基于UML状态机和轻量级QP实时嵌入式框架(RTEF)的实时嵌入式软件。QM适用于Windows 64位、Linux 64位和MacOS。

注意：更多信息请参阅在线QM手册： https://www.state-machine.com/qm/

下载和安装QM

获取QM的最推荐方式是下载QP捆绑包，其中包含QM以及所有QP框架和QTools集合。这样获取QM的主要优势是您可以获得所有组件、工具和示例，随时可用。

注意：QP捆绑包是最推荐的下载和安装QM的方式。但是，如果您不喜欢安装程序和图形界面，或没有管理员权限，您也可以按照下面的说明单独下载和安装QM。

注意：如果您的系统上安装了任何先前版本的QM，请在安装新版本之前卸载它。

在Windows（64位）上安装QM

前往QM发布页面并下载QM安装程序（qm_<ver>-win64.exe），该程序由Quantum Leaps进行数字签名。安装程序将创建QM的桌面快捷方式，并关联QM模型文件（*.qm和*.qmp）。

或者，如果您不喜欢安装程序，可以下载Windows版QM的zip压缩包（qm_<ver>-win64.zip）。安装只需将压缩包解压到任意目录，不过推荐使用默认的C:\qp\文件夹。

注意：通常不建议将QM安装在"Program Files"或"Program Files (x86)"等标准位置，因为这些目录有访问限制，不允许您修改QM样式表（qm_dark.qss和qm_light.qss）或模型模板。

如果您通过安装程序安装QM，将提供卸载程序，您可以通过标准的"应用和功能"卸载QM。

如果您从zip压缩包安装QM，只需删除安装目录即可卸载QM。

在Linux（64位）上安装QM

前往QM发布页面并下载Linux版QM的zip压缩包（qm_<ver>-linux64.zip）。您可以将压缩包解压到任意目录，不过推荐使用默认的~/qp/文件夹。

解压压缩包后，进入qm/bin/目录，确保qm可执行文件和qm.shshell脚本具有可执行权限。您可以使用桌面的文件管理器或在命令行中输入以下命令：

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

注意：要在Linux上运行QM应用程序，您需要运行qm/bin/qm.sh脚本。请确保该文件具有可执行权限。

在macOS上安装QM

前往QM发布页面并下载macOS版的磁盘镜像（qm_<ver>-macos.dmg）。由于.dmg文件不是来自Apple Store，下载后您需要启动控制台并更改此文件的属性：

xattr -c qm_<ver>-macos.dmg

只有在更改文件属性后，您才能在macOS上安装QM。双击.dmg文件，这将挂载并打开磁盘镜像。要安装QM工具，只需将qm.app图标拖到Applications文件夹（通常在Dock中可见）。如果需要，您还可以创建qm.app的别名并将其放在桌面上。

要卸载QM，只需删除qm.app文件和示例即可。

示例项目

QM示例模型包含在QP基线发行版中。控制台类型的示例适用于Windows（MinGW和Visual C++）、Linux和macOS。基于GUI的模拟适用于使用原生Win32 API的Windows。基于Qt框架的跨平台GUI示例在QP/C++中可用。

嵌入式示例适用于多种开发板，如ARM Cortex-M、AVR、MSP430，并支持IAR、ARM/KEIL和GNU编译器。

此外，还提供了一些适用于桌面（Windows和POSIX）的示例。这些示例不需要任何嵌入式硬件即可尝试。

所有示例位于<qp>/examples/目录中，其中<qp>表示您安装特定版本QP框架（QP/C、QP/C++或QP-nano）的文件夹。

QM许可

QM图形建模工具是免费软件。它可以免费下载和使用，但不是开源的。在安装过程中，您需要接受基本的最终用户许可协议（请参阅https://www.state-machine.com/qm/license.html），该协议在法律上保护Quantum Leaps免受任何保修索赔，禁止从QM中删除任何版权声明、出售QM或创建类似的竞争产品。EULA还禁止通过第三方网站分发QM。QM的唯一合法来源是SourceForge.net/projects/qpc/网站。