README.md

TMTC Client

Cloning the repository

Clone the repository with following command:

git clone https://git.ksat-stuttgart.de/source/tmtc.git

Initiate the core components by initiating and updating the submodules

git submodule init
git submodule sync
git submoduke update

Install all require packages by running

pip install -r requirements.txt

Now the script can be tested by running

python3 obsw_tmtc_client.py -h

It is recommended to use and setup PyCharm to also use the preconfigured run configurations.

Prerequisites

Runs with Python 3.8. Don't use Python 2.x! Manual installation of crcmod and pyserial might be needed. It is recommended to install use PyCharm to run this client. Students of the Uni Stuttgart usually have access to PyCharm Professional.

1. Install pip for used Python distribution if it is not installed yet
2. Install crcmod and all other required packages if using system python compiler. If using the local venv as the compiler, these packages should be installed.
   Command:

pip install -r requirements.txt

Alternatively:

python<version> -m pip<version> install crcmod

or use IDE (interpreter settings -> pip in PyCharm)

3. Install python-tk on Linux.

sudo apt-get install python-tk

On Windows, the package should be included.

How To Use

The script can be used by specifying command line parameters. Please run this script with the -h flag or without any command line parameters to display options. The client can be used to send via Ethernet or serial port.

GUI is work-in-progress. It might be necessary to set board or PC IP address if using ethernet communication. Default values should work normally though.

Examples

Example command to test service 17, assuming no set client IP (set manually to PC IP Address if necessary) and default board IP 169.254.1.38:

obsw_tmtc_client.py -m 3 -s 17

Example to run Unit Test:

obsw_tmtc_client.py -m 5

Example to test service 3 with serial communication, printing all housekeeping packets, COM port needs to be typed in manually (or set with --COM <COM PORT>):

obsw_tmtc_client.py -m 3 -s 3 --hk -c 

Modes

There are different modes. Run the client with the -h flag to display the modes.

Ethernet Communication

Port needs to be specified manually for now, IP adresses can be set in command line.

Issues

If there are problems receiving packets, use the tool Wireshark to track ethernet communication for UDP echo packets (requests and response). If the packets appear, there might be a problematic firewall setting. Please ensure that python.exe UDP packets are not blocked in advanced firewall settings and create a rule to allow packets from port 2008.

Serial Communication

Serial communication was implemented and is tested for Windwos 10. It requires the PySerial package installed.

Module Test