Skip to main content

TMTC Commander Core

Project description

TMTC Commander Documentation Status ci codecov PyPI version

Overview

This is a small Python framework targeted towards the testing of remote systems like satellites and rovers. It simplifies sending and receiving TMTCs (Telemetry and Telecommands) and testing via different communication interfaces. This tool can be used either as a command line tool or as a GUI tool which requires a PyQt6 installation.

Features

  • Generic communication interface abstraction which can also be used without the other components of the library if the goal is to separate the packet logic from the communication interface. The dedicated documentation chapter contains a more information and examples.
  • Special support for Packet Utilisation Standard (PUS) packets and CCSDS Space Packets. This library uses the spacepackets library for most packet implementations.
  • Support for both CLI and GUI usage.
  • Flexibility in the way to specify telecommands to send and how to handle incoming telemetry. This is done by requiring the user to specify callbacks for both TC specification and TM handling.
  • One-Queue Mode for simple command sequences and Multi-Queue for more complex command sequences.
  • Listener mode to only listen to incoming telemetry.
  • Some components are tailored towards usage with the Flight Software Framework (FSFW) and the sat-rs framework

The framework currently supports the following communication interfaces (among others):

  1. TCP/IP with UDP and TCP. The TCP interface currently only supports sending CCSDS space packets and is able to parse those packets from the received data stream.
  2. Serial Communication with a transport layer using COBS.

It is also possible to supply custom interfaces.

Examples

The examples folder contains a simple example using a dummy communication interface. It sends a PUS ping telecommand and then reads the ping reply and the verification replies back from the dummy interface. Assuming, the package was installed in a virtual environment like shown in the installation chapter, it can be run like this for the CLI mode:

cd examples
./tmtcc.py

or like this for the GUI mode:

cd examples
./tmtcc.py -g

The EIVE and SOURCE project implementation of the TMTC commander provide more complex implementations.

Tests

To run the tests, install the test requirements first with the following command, assuming a virtual environment:

pip install .[test]

All tests are provided in the src/test folder and can be run with coverage information by running

coverage run -m pytest

provided that pytest and coverage were installed with

pip install coverage pytest

Installation

It is recommended to use a virtual environment when installing this library. The steps here assume you have set up and activated the environment.

To install the full version with GUI support, run the following command to install from the cloned source code

pip install .[gui]

You can omit [gui] for a CLI only installation. Alternatively you can also install the package from PyPI with pip install tmtccmd[gui].

Documentation

The documentation is built with Sphinx

Install the required dependencies first:

pip install -r docs/requirements.txt

Then the documentation can be built with

cd docs
make html

The doctests can be run with the following command

cd docs
make doctest

Using PyCharm

When using PyCharm and running the application from PyCharm, it is recommended to set the Emulate terminal in output console option. This is because packages like prompt-toolkit require a complete terminal for features like auto-complete to work.

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

tmtccmd-8.0.3.tar.gz (722.5 kB view details)

Uploaded Source

Built Distribution

tmtccmd-8.0.3-py3-none-any.whl (757.2 kB view details)

Uploaded Python 3

File details

Details for the file tmtccmd-8.0.3.tar.gz.

File metadata

  • Download URL: tmtccmd-8.0.3.tar.gz
  • Upload date:
  • Size: 722.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.3

File hashes

Hashes for tmtccmd-8.0.3.tar.gz
Algorithm Hash digest
SHA256 0cf3c3ea6ef11262f2e8fb5af02f438c5715d359a25dfb7850a9ce711a412bea
MD5 44effc650aa7d11501c063c36d329dbe
BLAKE2b-256 ad1648ddcb0f57598de990a5a911e1b1d676565e841bbe2f4a8c82effaeec47a

See more details on using hashes here.

File details

Details for the file tmtccmd-8.0.3-py3-none-any.whl.

File metadata

  • Download URL: tmtccmd-8.0.3-py3-none-any.whl
  • Upload date:
  • Size: 757.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.3

File hashes

Hashes for tmtccmd-8.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 93f295b3a50ea8bf83a34e3f44c77b8e25cdf15ee510a92f7eaf10a37b8f1a56
MD5 0d8d61d264c943b6c39ee1cc45f1bf22
BLAKE2b-256 3f1764b439fcd4c209a0c28f1e03bf707b96c0293abc6f704b95cad722f07838

See more details on using hashes here.

Supported by

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