eive-tmtc/README.md

117 lines
2.2 KiB
Markdown
Raw Normal View History

2021-06-12 13:54:08 +02:00
# TMTC Commander EIVE
2020-12-17 17:50:00 +01:00
2022-05-17 14:46:23 +02:00
This application can be used to test the EIVE On-Board Software. Furthermore, it can
also be used to retrieve all sorts of telemetry data like housekeeping data.
It is recommended to use this application with a virtual environment.
2022-05-17 14:57:54 +02:00
The [virtual environemnt](#venv) chapter describes how to set one up. The [requirements](#reqs)
describes how to install all required packages.
2022-05-17 14:46:23 +02:00
The configuration file can currently be found at `tmtc_conf.json`. It caches settings
like the default communication interface or parameters like the TCP port when using the TCP
communication interface.
2022-05-17 14:57:54 +02:00
# Examples
Assuming you are running in a [virtual environment](#venv) and all [package requirements](#reqs)
were installed properly.
Run CLI mode
```sh
./tmtccli.py
```
Run GUI mode
```sh
./tmtcgui.py
```
# <a id="venv"></a> Set up virtual environment
2022-05-17 14:46:23 +02:00
## Linux
2022-05-17 14:46:23 +02:00
1. Create virtual environment
2022-05-17 14:46:23 +02:00
```sh
python3 -m venv venv
```
2022-05-17 14:46:23 +02:00
2. Activate virtual environment
2022-05-17 14:46:23 +02:00
```sh
. venv/bin/activate
```
2022-05-17 14:46:23 +02:00
## Windows
2021-08-09 11:45:01 +02:00
1. Create virtual environment
2021-08-09 11:45:01 +02:00
```sh
2022-05-18 18:32:20 +02:00
py -m venv venv
```
2021-08-09 11:45:01 +02:00
2. Activate virtual environment
2021-08-09 11:45:01 +02:00
```sh
venv\Scripts\activate.bat
```
2021-08-09 11:45:01 +02:00
2022-05-17 14:57:54 +02:00
# <a id="reqs"></a> Install requirements
2021-08-09 11:45:01 +02:00
There are two ways to install the requirements. One is to install the primary dependency
`tmtccmd` interactively. This is the recommended way
2021-08-09 11:45:01 +02:00
Assuming you are running in a virtual environment:
2021-06-12 13:54:08 +02:00
1. Install `tmtccmd` for virtual environment. `-e` for interactive installation.
2021-06-12 13:54:08 +02:00
```sh
cd tmtccmd
pip install -e .[gui]
```
2. You can also install the `spacepackets` package locally/interactively
Normally, it will be installed as a `tmtccmd` dependency.
```sh
cd spacepackets
pip install -e .
```
Alternatively you can also install the packages from PyPI completely, but the risk of
incompatibilities will be high there
2021-06-12 13:54:08 +02:00
```sh
pip install -r requirements.txt
2021-06-12 13:54:08 +02:00
```
# Run Linter
2021-06-12 13:54:08 +02:00
Can be used to quickly check validity of script. Install `flake8` first
2021-06-12 13:54:08 +02:00
```sh
python3 -m pip install flake8
2021-06-12 13:54:08 +02:00
```
or on Windows
2021-06-12 13:54:08 +02:00
```sh
py -m pip install flake8
2021-06-12 13:54:08 +02:00
```
and then run the `lint.py` script
2021-06-12 13:54:08 +02:00
```sh
./lint.py
2021-06-12 13:54:08 +02:00
```
2022-05-17 14:57:54 +02:00
# Run Auto-Formatter
This repo is auto-formatted using `black`. Assuming `black` is installed, you can simply run
```sh
black .
```