新特性
查看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.sh
shell脚本具有可执行权限。您可以使用桌面的文件管理器或在命令行中输入以下命令:
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)的示例。这些示例不需要任何嵌入式硬件即可尝试。
所有示例位于
QM许可
QM图形建模工具是免费软件。它可以免费下载和使用,但不是开源的。在安装过程中,您需要接受基本的最终用户许可协议(请参阅https://www.state-machine.com/qm/license.html),该协议在法律上保护Quantum Leaps免受任何保修索赔,禁止从QM中删除任何版权声明、出售QM或创建类似的竞争产品。EULA还禁止通过第三方网站分发QM。QM的唯一合法来源是SourceForge.net/projects/qpc/网站。
注意:QM内部使用LGPL许可的Qt应用程序工具包。请参阅qt_lgpl子目录中的QM LGPL合规包或在线查看https://www.state-machine.com/qm/qt_lgpl.html,了解如何获取Qt工具包源代码的更多信息。
生成代码的许可
QM生成的代码与生成该代码的底层QP框架采用相同的许可条款。有关更多信息,请参阅QP许可(https://www.state-machine.com/licensing/)。
支持和问题解决
QM的支持在免费支持论坛提供:
错误报告
QM软件内部有许多断言,并且在发布版本中断言处于启用状态。当您遇到断言或任何其他错误时,请查看"Bug跟踪器":
如果您没有找到您的问题,请尝试可靠地重现该问题,并向"Bug跟踪器"提交简洁的报告。
感谢您帮助改进QM!
功能请求
此外,如果您发现任何不一致或不便的功能,请向"功能跟踪器"提交如何改进此功能的建议:
如何帮助这个项目?
如果您喜欢这个项目,请给它一个星标(在浏览器窗口的右上角):