Skip to main content

QView visualization and monitoring

Project description

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 by QP/Spy software tracing system and can also interact with the embedded target by sending various commands.

General Requirements

The "qview" package requires Python 3 with the tkinter package, which is included in the QTools distribution for Windows and is typically included with other operating systems, such as Linux and MacOS.

To run "qview" in Python, you need to first launch the QSPY console application to 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 launch qview.py and "attach" to the QSPY UDP socket. After this communication has been established, "qview" can interact with the instrumented target and receive data from it (through QSPY).

NOTE The embedded C or C++ code running inside the target needs to be built with the QP/Spy software tracing system instrumentation enabled. This is achieved by building the "Spy" build configuration.

Installing qview

The qview monitoring must be installed in your Python distribution.

Installation from PyPi

The qview project is available on PyPi, so it can be installed with pip as follows:

pip install qview

Installation from QuantumLeaps GitHub

Alternatively, you can direct pip to install from Quantum Leaps GitHub:

pip install https://github.com/QuantumLeaps/qtools/releases/latest/download/qview.tar.gz

Installation from local package

Alternatively, you can direct pip to install from local package:

pip install /qp/qtools/qview/qview.tar.gz

Using qview

If you've installed qview with pip, you can either run it standalone:

qview [qspy_host[:udp_port]] [local_port]

Or (more commonly) import it into your script, where you customize QView. In that case, you invoke your script as usual:

pythonw my_qivew.py [qspy_host[:udp_port]] [local_port]

Command-line Options

  • 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 system will choose an open port.

Examples:

pythonw %QTOOLS%\qview\qview.py

opens the generic (not customized) "qview".

pythonw dpp.py

opens "qview" with the customization provided in the dpp.py script located in the current directory.

pythonw dpp.py localhost:7701

opens "qview" (installed with pip) with the customization provided in the dpp.py script located in the directory ..\qview. The "qview" will attach to the QSPY utility running at localhost:7701.

pythonw dpp.py 192.168.1.100:7705

opens "qview" (installed with pip) with the customization provided in the dpp.py script located in the current directory. The "qview" will attach to the QSPY utility running remotely at IP address 192.168.1.100:7705.

More Information

More information about the QView Visualization and Monitoring is available online at:

More information about the QP/QSPY software tracing system is available online at:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qview-8.0.4.tar.gz (17.8 kB view details)

Uploaded Source

Built Distribution

qview-8.0.4-py3-none-any.whl (17.6 kB view details)

Uploaded Python 3

File details

Details for the file qview-8.0.4.tar.gz.

File metadata

  • Download URL: qview-8.0.4.tar.gz
  • Upload date:
  • Size: 17.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.1

File hashes

Hashes for qview-8.0.4.tar.gz
Algorithm Hash digest
SHA256 1eca3d15ab9815038ae2b842af833b2b6ced9859033fcfa0ee60e12fa30bcf24
MD5 0724ab7ad7ebd53221c27787993f7379
BLAKE2b-256 632aea60eaeaf2163c24c0fd638630e119ffa1b6e4f3801dc93b6399d374732c

See more details on using hashes here.

File details

Details for the file qview-8.0.4-py3-none-any.whl.

File metadata

  • Download URL: qview-8.0.4-py3-none-any.whl
  • Upload date:
  • Size: 17.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.1

File hashes

Hashes for qview-8.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 5a23e254b03f9417114fc7807e520c71b1f1900f23756898d2887f2520c6d74d
MD5 a0e03c1b58f0eeec1f9197ea72867746
BLAKE2b-256 1597903613c922419ace0ccdb506e0e200716a6717f380524fdcb487466b1233

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page