访问官网
Github
文档
论文
最新动态
查看QTools修订历史： https://www.state-machine.com/qtools/history.html
文档
此特定版本QTools的离线HTML文档位于html/文件夹中。要查看离线文档，请在网络浏览器中打开html/index.html文件。
QTools最新版本的在线HTML文档位于：https://www.state-machine.com/qtools/
关于QTools
QTools是一个开源工具集合，用于在桌面平台（如Windows、Linux和macOS）上使用QP实时嵌入式框架（RTEF）。
目前提供以下开源工具（注：以'q'开头的工具由Quantum Leaps贡献）：
-
qspy - 用于接收和显示运行QS软件跟踪的嵌入式目标的实时数据的主机应用程序。
-
qutest - QSPY主机应用程序的Python扩展，专为嵌入式系统设计的单元测试，同时支持在主机计算机上对嵌入式代码进行单元测试（"双重目标"）。
-
qview - QSPY主机应用程序的Python扩展，用于实时可视化和监控来自嵌入式目标的QS实时跟踪数据。QView使开发人员能够快速为其特定应用程序构建基于GUI和"无头"的脚本。
-
qwin - QWIN GUI工具包，用于在Windows上使用C编程语言原型化嵌入式系统。QWIN允许您构建由LCD显示器（图形和分段）、按钮和LED组成的真实嵌入式前面板。QWIN基于Win32 API。
-
qcalc - 专为嵌入式系统程序员设计的程序员计算器。
-
qclean - 用于清理源代码文件中的空白（制表符、尾随空格、行尾）。
-
qfsgen - 用于生成基于ROM的文件系统，供HTTP服务器使用的嵌入式网页使用。
-
Unity - 用于嵌入式C的传统单元测试工具（框架）（2.5.2版本）。
此外，Windows版QTools还包含以下开源第三方工具：
-
GNU-make for Windows（32位版本4.2.1）
-
cmake for Windows（版本3.29.0-rc1）
-
ninja for Windows（版本1.11.1）
-
LMFlash for Windows（32位构建1613）
另外，QP捆绑包中的QTools目录包含以下第三方工具：
-
GNU C/C++工具集for Windows（MinGW 32位版本9.2.0）
-
GNU C/C++工具集for ARM-EABI（GCC版本10.3-2021.10）
-
Python for Windows（3.10版32位）
下载和安装
获取QTools的最推荐方式是下载QP捆绑包，其中包括QTools以及所有QP框架和QM建模工具。这样捆绑在一起获取QTools的主要优势是您可以获得所有组件、工具和示例，随时可用。
注意：QP捆绑包是下载和安装QTools的最推荐方式。但是，如果您不喜欢安装程序和GUI或没有管理员权限，您也可以单独下载和安装QM，如下所述。
或者，您可以按照以下说明单独下载QTools：
Windows上的QTools
在Windows上，安装QTools包括将qtools-windows_<ver>.zip压缩包解压到您选择的目录中，尽管推荐的默认目录是C:\qp。
解压压缩包后，您需要将以下目录添加到PATH中：
\qtools\bin \qtools\mingw32\bin
此外，要使用QUTest单元测试，您需要定义环境变量QTOOLS以指向QTools的安装目录。
Linux/macOS上的QTools
在Linux/MacOS上，安装QTools包括将qtools-posix_<ver>.zip压缩包解压到您选择的目录中，尽管推荐的默认目录是~/qp。
注意：要使用QTools，您首先需要在您的机器上构建这些工具。
例如，要构建QSPY主机应用程序，您需要进入qtools/qspy/posix目录并输入make来构建可执行文件。提供的Makefile将自动将qspy可执行文件复制到qtools/bin目录。
同样，您需要构建QCLEAN和QFSGEN实用程序。
注意：要使用QUTest单元测试，您需要定义环境变量
QTOOLS以指向QTools的安装目录。
使用cmake构建
如果您的Windows或Linux计算机上有正确的C编译工具集，您可以自行构建这些工具。
在MS-Windows机器上，建议使用MSys/MinGW64设置来执行构建。使用此环境，您仍然能够生成MS-Windows可执行应用程序。
另一种选择是安装MS Visual Studio。
CMake也能够为这个开发环境生成构建系统。
但这不是本讨论的主题。有关更多详细信息，请参阅CMake文档。特别参考cmake生成器部分。
此源代码包中提供了适当的CMakeLists.txt文件以及cmake预设文件。
在qtools目录中，您可以使用cmake来构建和安装3个工具。为此，除了上面提到的工具外，您还需要以下内容：
要使用cmake构建：
- 在
qtools目录中执行cmake --preset qtools - 然后构建：
cmake --build --preset qtools一次构建所有工具，或cmake --build --preset qtools --target <tool>，工具可以是qclean、qfsgen或qspy- 要构建
Debug配置，使用cmake --build --preset qtools --config Debug Release是默认配置，如果您不指定所需的配置
- 二进制文件创建在
.../qtools/build/<config>目录中 - 安装：
- 构建
qtools预设，然后 - 调用
cmake --install build [--config <config>] - 默认安装位置在Linux机器上为
/usr/local/bin，或Windows机器上的MinGW环境中。 - 在安装命令行中添加
--prefix <directory>以选择不同的安装目标。 例如，cmake --install build --prefix /usr将把Release配置中构建的应用程序安装到/usr/bin。在Linux机器上，您可能需要使用sudo来提高访问权限，以便安装到系统目录。
- 构建
许可
分发组件的各种许可证位于此QTools分发的LICENSES/子目录中。
此集合中包含的大多数工具都是根据GNU通用公共许可证（GPL）的条款分发的，该许可证由自由软件基金会发布，可以是许可证的第2版或（根据您的选择）任何更新的版本。GPL第2版的文本包含在LICENSES/子目录中的GPL-2.0-or-later.txt文件中。
一些工具根据MIT开源许可证的条款分发。MIT许可证的完整文本包含在注释中，也包含在LICENSES/子目录中的LICENSE-MIT.txt文件中。
Python包根据PYTHON许可协议的条款分发。Python许可协议的完整文本包含在LICENSES/子目录中的LICENSE-Python.txt文件中。
Windows版LMFlash实用程序根据LMFlash许可证的条款分发，该许可证包含在LICENSES/子目录中的LICENSE-LMFlash.txt文件中。具体而言，LMFlash实用程序根据第2a节"演示许可"分发。
源代码
为遵守GPL，此分发包含Quantum Leaps贡献的实用程序的源代码，位于<qtools>\source子目录中，但QSPY源代码除外，它位于<qtools>\qspy\source目录中。所有以'q'开头的工具都由Quantum Leaps开发并拥有版权。
Windows版GCC C和C++编译器
取自MSYS2项目：
使用了mingw-get-setup.exe安装程序，安装后对文件进行了修剪以减小分发的大小。请参考MinGW项目获取源代码。
Windows版GNU-ARM嵌入式工具链
取自：
使用了gcc-arm-none-eabi-8-2018-q4-major-win32-sha1.exe安装程序。 （版本8-2018-q4-major，发布日期：2018年12月20日）
Windows版GNU make可执行文件
取自SourceForge.net的MinGW项目：
UNIX文件和目录实用程序
取自GitHub上的Gow（Gnu On Windows）项目：
Unity嵌入式C单元测试框架
取自GitHub：
如何帮助这个项目？
如果您喜欢这个项目，请给它一个星标（在浏览器窗口右上角）：
