Package: qview
The "qview" Python package is a powerful Visualization and Monitoring
facility, which allows embedded developers to create virtual Graphical
User Interfaces in Python to monitor and control their embedded devices
from a host (desktop) computer. The interfaces created by QView can
visualize the data produced byQP/Spy software tracing systemand can also interact with the embedded target by sending various commands.General RequirementsThe "qview" package requires Python 3 with thetkinterpackage, which
is included in theQTools distributionfor Windows and is typically included with other operating systems, such as
Linux and MacOS.To run "qview" in Python, you need to first launch theQSPY console applicationto communicate with the chosen embedded target (or the host executable
if you are simulating your embedded target).Once QSPY is running, from a separate terminal you can launchqview.pyand "attach" to theQSPY UDP socket.
After this communication has been established, "qview" can interact with the
instrumented target and receive data from it (through QSPY).NOTEThe embedded C or C++ code running inside the target needs to be
built with theQP/Spy software tracing systeminstrumentation enabled. This is acheived by building the "Spy" build configuration.InstallationTheqview.pyscript can be used standalone,withoutany
installation (see Using "qview" below).Alternatively, you caninstallqview.pywithpipfrom PyPi by
executing the following command:pip install qviewOr directly from the sources directory (e.g.,/qp/qtools/qview):python setup.py install --install-dir=/qp/qtools/qviewUsing "qview"If you are usingqviewas a standalone Python script, you invoke
it as follows:python /path-to-qview-script/qview.py [<cust_script> [<qspy_host> [<qspy_port>]]]Alternatively, if you've installedqviewwithpip, you invoke
it as follows:qview [cust_script] [qspy_host[:udp_port]] [local_port]Command-line Optionscust_script- optional customization Python scripts for your specific
target sytem. If not specified, qview will provide only the generic facilities
for interacting with the target (e.g., reset, setting QS filters,
posting events, etc.)qspy_host[:udp_port]- optional host-name/IP-address:port for the host
running the QSPY host utility. If not specified, the default
is 'localhost:7701'.local_port- optional the local UDP port to be used by "qview". If not
specified, the default is '0', which means that the operating sytem will
choose an open port.Examples (for Windows):python %QTOOLS%\qview\qview.pyopens the generic (not customized) "qview".python %QTOOLS%\qview\qview.py dpp.pyopens "qview" with the customization provided in thedpp.pyscript
located in the current directory.qview ..\qview\dpp.py localhost:7701opens "qview" (installed withpip) with the customization provided in thedpp.pyscript located in the directory..\qview.  The "qview" will
attach to the QSPY utility running atlocalhost:7701.qview dpp.py 192.168.1.100:7705opens "qview" (installed withpip) with the customization provided in thedpp.pyscript located in the current directory. The "qview" will attach to
the QSPY utility running remotely at IP address192.168.1.100:7705.Examples (for Linux/macOS):python $(QTOOLS)/qview/qview.pyopens the generic (not customized) "qview".python $(QTOOLS)/qview/qview.py dpp.pyopens "qview" with the customization provided in thedpp.pyscript
located in the current directory.qview *.py ../qview/dpp.py localhost:7701opens "qview" (installed withpip) with the customization provided in thedpp.pyscript located in the directory../qview.  The "qview" will
attach to the QSPY utility running atlocalhost:7701.qview dpp.py 192.168.1.100:7705opens "qview" (installed withpip) with the customization provided in thedpp.pyscript located in the current directory. The "qview" will attach to
the QSPY utility running remotely at IP address192.168.1.100:7705.More InformationMore information about the QView Visualization and Monitoring is available
online at:https://www.state-machine.com/qtools/qview.htmlMore information about the QP/QSPY software tracing system is available
online at:https://www.state-machine.com/qtools/qpspy.html