Skip to main content

Shows multiple serial text streams in a single window with individual highlighting options.

Project description

multiserialviewer

See multiple serial text streams in a single window

What you can do with it

  • evaluate the output of one or more serial ports
  • automatically highlight text, e.g. in color, according to user-defined patterns
  • open and close all serial ports with a single click
  • search the output of a serial port and navigate between the findings
  • watch key-value pairs and display the last value
  • count text while the data is being received
  • get insights into your serial port bandwidth utilization
  • keep all your settings and window sizes until next time

Screenshots

example with two serial connections

Installation

You can install this tool using the package installer for Python (pypi/multiserialviewer).

pip install multiserialviewer

If already installed, run the following command to install the latest version:

pip install multiserialviewer --upgrade

Start

After installation using pip, you can start it by running

multiserialviewer

in a console.

Start it using a Windows batch file

Create a batch file, e.g. multiserialviewer.bat, with the following content (enter your python path accordingly):

start /B pythonw "C:\myPythonInstallDir\Python311\Scripts\multiserialviewer.exe"

With this, you will not get a console window in the background.

Usage

Set up your serial port connections

Click the button "Create Viewer" and enter your connection details. You can give the window a name and set your autoscroll preferences. The latter may be changed at any time later (but not the connection details).

It is not possible to create a viewer for the same port multiple times.

create serial viewer connection

Open your serial ports and receive data

After you created all SerialViewers you need, start receiving your data by clicking "Start Capture".

You can close all serial ports by clicking "Stop Capture".

If one of your serial ports can not be opened, you will see an error message in the corresponding SerialView window. In this case all other connections will be closed again automatically.

What data is displayed?

You will only see printable characters in the output window, meaning every character with a value between (including) 32 and 126. LineFeed and CarriageReturn will cause a line break/new line.

If you want to see non-printable characters (in hex), you can enable this in the settings dialog. E.g. '\0' will then be printed as [00].

Work with the data you received (while you receive it)

Specify text patterns to highlight information

If you want to highlight specific text, you can define text patterns using regular expression syntax. If you just want to highlight certain words, just enter them as normal text.

Search for a word and jump to the next/previous occurrence

Watch values of key-value pairs

If you receive a lot of data and want to keep track of single values, e.g. temperature=88, you can create a watch and display these values in a separate table. In this table, the last received value will be displayed.

Count the occurrence of text patterns

If you are just interested in the number of occurrences of a word (or text pattern), you can create counter.

Get an idea of how much data you received and bandwidth is left

In the statistics tab you find basic information about the received data.

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

multiserialviewer-25.8.0.tar.gz (165.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

multiserialviewer-25.8.0-py3-none-any.whl (193.5 kB view details)

Uploaded Python 3

File details

Details for the file multiserialviewer-25.8.0.tar.gz.

File metadata

  • Download URL: multiserialviewer-25.8.0.tar.gz
  • Upload date:
  • Size: 165.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for multiserialviewer-25.8.0.tar.gz
Algorithm Hash digest
SHA256 be1b6bf6458a1fe3d5d3bde878ec4ee699c500ed4df1cc1e413039a891ba8e03
MD5 9da1619956a339f81469b49e7d09512f
BLAKE2b-256 729649889a479074acee41076fcb22e4e4c893c6745b87627c687dcb916b9d82

See more details on using hashes here.

Provenance

The following attestation bundles were made for multiserialviewer-25.8.0.tar.gz:

Publisher: python-publish.yml on shaag7967/multiserialviewer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file multiserialviewer-25.8.0-py3-none-any.whl.

File metadata

File hashes

Hashes for multiserialviewer-25.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 82aad73b1c36ea2bb4d56e5ccea29c8709e443cae2a04161b69d7d709357843e
MD5 be9a46cdfe75ba8f41ad03149e378b77
BLAKE2b-256 242e7ae6b94717c71a47dc2eb4f0c4f41a856786c6975abc458f16fa0b4b04e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for multiserialviewer-25.8.0-py3-none-any.whl:

Publisher: python-publish.yml on shaag7967/multiserialviewer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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