The recommended way of obtaining QTools is by downloading the QP-bundle↑, which includes QTools as well as all QP Frameworks and also the QM modeling tool↑. The main advantage of obtaining QTools bundled together like that is that you get all components, tools and examples ready to go.
Alternatively, you can download QTools separately as described below.
On Windows, you simply unzip the qtools-windows_<x.y.z>.zip
archive to the installation folder of your choice; (C:\qp\qtools
is the recommended default). After the installation, you still need to:
<qtools>\bin
and <qtools>\MinGW\bin
directories to the global PATH
on your system, where <qtools>
denotes the directory where you have installed QTools (e.g., C:\qp\qtools\bin;C:\qp\qtools\MinGW\bin
).<qtools>\bin
and <qtools>\MinGW\bin
directories to your PATH
will enable you to invoke all QTools utilities (like QSpy or QClean) by simply typing qspy
or qclean
at the command prompt, regardless of your current directory. This will come in handy, because typically you will not invoke qspy
or qclean
from the <qtools>\bin
directory.QTOOLS
environment variable, for example:set QTOOLS=C:\qp\qtools
QTOOLS
environment variable is required to run QUTest Unit Testing and the QView Visualization and Monitoring utilities.On POSIX (Linux/MacOS), you simply unzip the qtools-posix_<x.y.z>.zip
archive to the installation folder of your choice (~/qp/qtools
is the recommended default). After the installation, you still need to:
<qtools>/bin
directory to the global PATH
on your system, where <qtools>
denotes the directory where you have installed QTools (e.g., ~/qp/qtools
).QTOOLS
environment variable, for example:export QTOOLS=~/qp/qtools
QTOOLS
environment variable is required to run QUTest Unit Testing and QView Visualization and Monitoring utilities.The following annotated directory tree in the standard QTools distribution lists the top-level directories and files:
qspy.exe
(Windows) or qspy
(POSIX) — QSPY executable qclean.exe
(Windows) or qclean
(POSIX) — QClean Code Whitespace Cleanup executable qfsgen.exe
(Windows) or qfsgen
(POSIX) — QFSGen ROM File-System Generator executable make.exe
— make utility (Windows only) rm.exe
— rm (remove) utility (Windows only) python.bat
— Batch file to call Python (Windows only)