Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wuespace/telestion-project-daedalus2
Telestion Project for the Daedalus 2
https://github.com/wuespace/telestion-project-daedalus2
daedalus2 telestion telestion-project
Last synced: about 2 months ago
JSON representation
Telestion Project for the Daedalus 2
- Host: GitHub
- URL: https://github.com/wuespace/telestion-project-daedalus2
- Owner: wuespace
- License: mit
- Created: 2021-04-19T20:27:18.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-03-25T13:58:29.000Z (almost 2 years ago)
- Last Synced: 2024-05-19T00:18:11.252Z (8 months ago)
- Topics: daedalus2, telestion, telestion-project
- Language: TypeScript
- Homepage: https://telestion.wuespace.de
- Size: 10.2 MB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# ⚠️ Dependency lock in place!
**Due to the current situation, dependency updates are restricted!**
**An update is only possible after prior consultation with the maintainers!**
# Telestion Project Daedalus2
This repository holds project-specific resources for [Daedalus2](https://www.wuespace.de/daedalus/daedalus2/ "Project page").
It contains the Telestion Application which connects to the Daedalus2 Interface,
handles incoming data, stores them in a MongoDB database
and prepares them for the connected clients.
The graphical Telestion Client connects to the Telestion Application
and visualizes incoming data in a clear way.
## Installation
### The Application
To set up the Telestion Application, please go to the latest release of the project
and download the `telestion-project-daedalus2-vX.X.X.zip`:
https://github.com/wuespace/telestion-project-daedalus2/releases/latest
Extract it with your favorite archiver.
Start the application with `docker-compose`.
Type in your terminal:
```shell
docker-compose up -d
```
and `docker-compose` does the rest for you. :wink:
### Connecting the Serial Device
Now you need to send and receive messages from and to the serial device.
Please install [python](https://www.python.org/) and the [pySerial](https://pyserial.readthedocs.io/en/latest/pyserial.html) package.
Then download this script:
https://github.com/pyserial/pyserial/blob/master/examples/tcp_serial_redirect.py
Please open a shell or command line and call the script with the required arguments:
```shell
python ./tcp_serial_redirect.py -c localhost:9871 /dev/pts/6 38400
# or
python ./tcp_serial_redirect.py -c localhost:9871 /dev/ttyUSB1 57600
# or
python ./tcp_serial_redirect.py -c localhost:9871 COM6 57600
```
And thats it! The serial-to-tcp adapter transmits the information between the serial device and the Telestion Application.
When you want to stop the Application, call:
```
docker-compose down
```
And terminate the serial-to-tcp adapter.
### The Client
For the Client setup, you simply need to go to the latest release in GitHub and download the suitable installer for your operating system:
https://github.com/wuespace/telestion-project-daedalus2/releases/latest
Then install the Client and start it.
A window should show up displaying a login page.
Please first check the backend server URL and enter the URL given from the Application management script.
It should look something like `http://192.168.0.10:9870/bridge`.
If you running the Telestion Application on the same system, you can _leave_ the URL like it is.
Then enter your given credentials from the Telestion team and press "Login".
The first dashboard should show up and the connection indicator in the navigation bar should switch to "Connected".
If this is not the case, please log out again via the avatar menu in the upper right corner and re-check if the entered backend server URL is correct.
When the Client still doesn't connect, please inform the Telestion team so we can debug this issue.
## Building
To build the projects from source,
please take a look into the part specific descriptions:
- [Application](./application/README.md)
- [Client](./client/README.md)
## This repository
The overall file structure of this monorepo looks like this:
```
.
├── .github
│ ├── workflows (CI configuration)
│ └── dependabot.yml (Dependabot config)
├── application
| ├── conf (the verticle configuration for the Application)
| ├── src (the source files of the Telestion Application)
| ├── Dockerfile (the definition to successfully build a Docker image from the compiled Application sources)
| ├── build.gradle (manages dependencies and the build process via Gradle)
| ├── gradle.properties (contains the required tokens to access required dependencies)
| ├── gradlew (the current gradle executable for UNIX-based systems)
| └── gradlew.bat (the current gradle executable for Windows systems)
├── client
| ├── public (template webpage folder where React will engage)
| ├── src (the source files of the Telestion Client)
| └── package.json (manages dependencies and the build process via npm)
├── CHANGELOG.md (DON'T TOUCH! Automatically generated Changelog)
├── README.md (you're here :P)
├── project.json (contains the current project information like the current version etc.)
└── telestion-application (DON'T TOUCH! Used as an indicator for our automation tools)
```
**The [Application](./application/README.md) and the [Client](./client/README.md) folders contain their own `README.md` that describe the different parts more specific.**
### Contributing
For the documentation on contributing to this repository, please take a look at the [Contributing Guidelines](./CONTRIBUTING.md).
## Contributors
Thank you to all contributors of this repository:
[](https://github.com/wuespace/telestion-project-daedalus2/graphs/contributors)
Made with [contributors-img](https://contrib.rocks).
## About
This is part of [Telestion](https://telestion.wuespace.de/), a project by [WüSpace e.V.](https://www.wuespace.de/).