最新动态

查看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贡献）：

1. qspy - 用于接收和显示运行QS软件跟踪的嵌入式目标的实时数据的主机应用程序。

2. qutest - QSPY主机应用程序的Python扩展，专为嵌入式系统设计的单元测试，同时支持在主机计算机上对嵌入式代码进行单元测试（"双重目标"）。

3. qview - QSPY主机应用程序的Python扩展，用于实时可视化和监控来自嵌入式目标的QS实时跟踪数据。QView使开发人员能够快速为其特定应用程序构建基于GUI和"无头"的脚本。

4. qwin - QWIN GUI工具包，用于在Windows上使用C编程语言原型化嵌入式系统。QWIN允许您构建由LCD显示器（图形和分段）、按钮和LED组成的真实嵌入式前面板。QWIN基于Win32 API。

5. qcalc - 专为嵌入式系统程序员设计的程序员计算器。

6. qclean - 用于清理源代码文件中的空白（制表符、尾随空格、行尾）。

7. qfsgen - 用于生成基于ROM的文件系统，供HTTP服务器使用的嵌入式网页使用。

8. Unity - 用于嵌入式C的传统单元测试工具（框架）（2.5.2版本）。

此外，Windows版QTools还包含以下开源第三方工具：

9. GNU-make for Windows（32位版本4.2.1）

10. cmake for Windows（版本3.29.0-rc1）

11. ninja for Windows（版本1.11.1）

12. LMFlash for Windows（32位构建1613）

另外，QP捆绑包中的QTools目录包含以下第三方工具：

13. GNU C/C++工具集for Windows（MinGW 32位版本9.2.0）

14. GNU C/C++工具集for ARM-EABI（GCC版本10.3-2021.10）

15. 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中：

• <qp>\qtools\bin
• <qp>\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个工具。为此，除了上面提到的工具外，您还需要以下内容：

1. CMake - 构建系统生成器（cmake功能）

2. Ninja - 专注于速度的小型构建系统

要使用cmake构建：

1. 在qtools目录中执行cmake --preset qtools
2. 然后构建：
   • cmake --build --preset qtools一次构建所有工具，或
   • cmake --build --preset qtools --target <tool>，工具可以是qclean、qfsgen或qspy
   • 要构建Debug配置，使用cmake --build --preset qtools --config Debug
   • Release是默认配置，如果您不指定所需的配置
3. 二进制文件创建在.../qtools/build/<config>目录中
4. 安装：
   • 构建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项目：

• https://www.msys2.org/

使用了mingw-get-setup.exe安装程序，安装后对文件进行了修剪以减小分发的大小。请参考MinGW项目获取源代码。

Windows版GNU-ARM嵌入式工具链

取自：

• https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads

使用了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）项目：

• https://github.com/bmatzelle/gow

Unity嵌入式C单元测试框架

取自GitHub：

• https://github.com/ThrowTheSwitch/Unity

如何帮助这个项目？

如果您喜欢这个项目，请给它一个星标（在浏览器窗口右上角）：

联系信息：

• https://www.state-machine.com

• info@state-machine.com