DIY: Einen Tracker erstellen
mit einem Raspberry Pi und einem NMEA-Gateway
Diese Anleitung erklärt, wie du deinen eigenen Trakkit.org Live-Tracker mit einem Raspberry Pi oder einem beliebigen Linux-System baust.
Kompatible Systeme sind unter anderem:
- Raspberry Pi OS
- Ubuntu
-
Debian
-
Für diese Anleitung verwenden wir einen NMEA-Multiplexer wie den ShipModul Miniplex oder ein ähnliches Gateway.
Inhaltsverzeichnis
- Overview
- Configure your boat on Trakkit.org
- Install Raspberry Pi OS
- Basic system configuration
- WiFi / LAN to NMEA Gateway
- Install Joli_Compagnon
- Create the Python virtual environment
- Manual launch of the tracker
- Automate startup with systemd
Überblick
Der Prozess ist einfach:
- Bereite deine Konfiguration auf Trakkit.org vor
- Installiere Raspberry Pi OS
- Installiere Joli_Compagnon
- Teste den Tracker
- Automatisiere den Start
⚓ - Konfiguriere dein Boat auf Trakkit.org
Bevor du irgendetwas auf dem Raspberry Pi installierst, lege deinen Tracker auf Trakkit.org an.
- Erstelle dein Boat
- Erstelle ein Tag
(gib ihm einen wiedererkennbaren Namen) - Erstelle ein password für dieses Tag
- Erstelle einen Track mit:
- Startdatum: 01/01/2020
- Enddatum: 01/01/2050
- Markiere diesen Track als LiveTrack
Du solltest jetzt Folgendes haben:
TAG
TAG PASSWORD
Diese Zugangsdaten werden vom Tracker verwendet.
🍓 - Raspberry Pi OS installieren
Installiere Raspberry Pi OS wie gewohnt auf deiner SD-Karte.
Folge den offiziellen Anweisungen:
https://www.raspberrypi.com/software
Es ist keine spezielle Konfiguration erforderlich.
Du kannst die Desktop-Version wählen (einfacher zu konfigurieren) oder die Lite-Version, wenn du dich mit Linux auskennst.
⚙️ — Grundlegende Systemkonfiguration
Beim ersten Start:
- Erstelle einen user (in dieser Anleitung gehen wir vom Benutzernamen pi aus)
- Konfiguriere wie üblich:
- Sprache
- Tastatur
- Netzwerk (Wifi für den Internetzugang)
Es wird empfohlen, die Zeitzone auf UTC zu setzen.
🛰️ — WiFi- oder LAN-Verbindung zum NMEA-Gateway
Abhängig vom Verbindungstyp (WiFi oder LAN) deines NMEA-Gateways besorge dir vom Hersteller die folgenden Informationen:
- IP-Adresse
- Port
- Protokoll (UDP oder TCP)
Wenn du WiFi verwendest und dein NMEA-Gateway nicht im selben Netzwerk wie deine Haupt-Internetverbindung erreichbar ist, musst du möglicherweise auf deinem Raspberry Pi eine zweite WiFi-Schnittstelle mit einem zusätzlichen USB-WiFi-Dongle konfigurieren.
Damit kannst du: - den NMEA-Datenstrom empfangen (eingehende Route) - Positionsdaten an Trakkit.org senden (ausgehende Route)
Typischerweise sieht die Konfiguration so aus:
IP: 10.0.0.1
Port: 10110
Protocol: TCP
Diese Werte müssen in der Datei config.ini konfiguriert werden.
📦 — Joli_Compagnon installieren
Lade die Software von der Trakkit-Website herunter:
Trakkit.org → About → Download
Lade die Datei herunter:
joli_compagnon.tgz
Entpacke sie in deinem Home-Verzeichnis:
tar -xzf joli_compagnon.tgz
Dadurch wird das Verzeichnis: joli_compagnon_last erstellt, das alle Skripte enthält.
🐍 — Die Python-Virtual-Environment erstellen
Wechsle in das Verzeichnis:
cd joli_compagnon_last
Erstelle die Python-Virtual-Environment:
python3 -m venv venv
Aktiviere sie:
source venv/bin/activate
Installiere die benötigten Module:
pip install -r requirements.txt
🔁 — Manueller Start des Trackers
Aktiviere die Python-Virtual-Environment:
source venv/bin/activate
Benenne die Konfigurationsdatei um:
mv config.ini.EXAMPLE config.ini
Bearbeite die Datei:
nano config.ini
Konfiguriere deine Trakkit-Zugangsdaten:
###############################################
# 🔑 Your Trakkit.org login credentials
###############################################
[USER]
TAG = YOUR_TAG_HERE
PWD = YOUR_TAG_PASSWORD_HERE
Konfiguriere dann den NMEA-Abschnitt mit den zuvor definierten Werten, um auf dein NMEA-Gateway zuzugreifen:
###############################################
# 📡 Data source from NMEA multiplexer
###############################################
[NMEA]
NMEA_SRV = 10.0.0.1
NMEA_PORT = 10110
Starte den NMEA-Reader entsprechend dem verwendeten Protokoll
(nur ein Prozess darf laufen):
./reader_tcp.py
ODER
./reader_udp.py
Du solltest NMEA-Frames angezeigt bekommen.
Starte den Sender in einem anderen Terminal:
./sender.py
Dieses Skript sendet die GPS-Positionen an Trakkit.org.
Warte ein paar Minuten.
Die Position deines Boat sollte nun auf Trakkit.org erscheinen.
🚀 - Automatisiere den Start mit systemd
An diesem Punkt hast du nun einen vollständig funktionsfähigen Tracker für Trakkit.org. Der letzte Schritt ist, ihn so zu konfigurieren, dass er beim Booten automatisch startet.
Für den Rest dieser Anleitung gehen wir von der Verwendung des TCP-Protokolls, dem Benutzernamen pi und dem folgenden Installationspfad aus:
/home/pi/joli_compagnon_last/
Skripte und Virtual-Environment befinden sich dort.
Service für den NMEA-Reader
Erstelle:
sudo nano /etc/systemd/system/trakkit_reader.service
[Unit]
Description=Trakkit.org Companion NMEA Reader
After=network.target
[Service]
User=pi
WorkingDirectory=/home/pi/joli_compagnon_last
ExecStart=/home/pi/joli_compagnon_last/venv/bin/python reader_tcp.py
Restart=always
[Install]
WantedBy=multi-user.target
Service für den Sender
Erstelle:
sudo nano /etc/systemd/system/trakkit_sender.service
[Unit]
Description=Trakkit.org Companion Sender
After=trakkit_reader.service
[Service]
User=pi
WorkingDirectory=/home/pi/joli_compagnon_last
ExecStart=/home/pi/joli_compagnon_last/venv/bin/python sender.py
Restart=always
[Install]
WantedBy=multi-user.target
Services aktivieren
sudo systemctl daemon-reload
sudo systemctl enable trakkit_reader
sudo systemctl enable trakkit_sender
Starte sie:
sudo systemctl start trakkit_reader
sudo systemctl start trakkit_sender
Dein Trakkit.org Companion startet nun automatisch beim Booten, verbindet sich mit deinem NMEA-Gataway und sendet die Position deines Boat fortlaufend.