DIY: Einen Tracker erstellen
mit einem Raspberry Pi, einem USB GPS und/oder einem NMEA-Gateway
Diese Anleitung erklärt, wie du deinen eigenen Trakkit.org Live Tracker mit einem Raspberry Pi oder einem beliebigen Linux-System und Joli_Compagnon baust.
Kompatible Systeme sind u. a.:
- Raspberry Pi OS
- Ubuntu
- Debian
Joli_Compagnon kann NMEA-Daten lesen von:
- einem USB GPS-Empfänger, z. B. dem BU-353N5
- einem NMEA-Multiplexer oder Gateway über TCP oder UDP, z. B. dem ShipModul Miniplex
- beidem gleichzeitig, z. B. die Position vom USB GPS und den Wind vom Multiplexer
Inhaltsverzeichnis
- Overview
- Configure your boat on Trakkit.org
- Install Raspberry Pi OS
- Basic system configuration
- Prepare your data source
- Install Joli_Compagnon
- Create the Python virtual environment
- Configure Joli_Compagnon
- Manual launch of the tracker
- Automate startup with systemd
- Upgrade from a previous version
Übersicht
Joli_Compagnon besteht aus zwei Programmen, die parallel laufen:
- reader.py lauscht auf deine Datenquellen, dekodiert die NMEA-Sätze und speichert sie lokal, mit maximal einer Position alle 2 Sekunden.
- sender.py komprimiert die gespeicherten Daten und lädt sie alle 5 Minuten per SFTP zu Trakkit.org hoch.
Wenn die Internetverbindung ausfällt, bleiben die Daten auf dem Raspberry Pi und werden gesendet, sobald die Verbindung wieder verfügbar ist.
Der Ablauf ist einfach:
- Bereite deine Konfiguration auf Trakkit.org vor
- Installiere Raspberry Pi OS
- Installiere und konfiguriere Joli_Compagnon
- Teste den Tracker
- Automatisiere den Start
⚓ - Dein Boat auf Trakkit.org konfigurieren
Bevor du irgendetwas auf dem Raspberry Pi installierst, deklariere deinen Tracker auf Trakkit.org.
- Erstelle dein Boat
- Erstelle einen Tag
(gib ihm einen gut erkennbaren Namen) - Erstelle ein password für diesen Tag (Boat > Mails & Tags)
- Erstelle einen Track mit:
- Startdatum: 01/01/2020
- Enddatum: 01/01/2050
- Markiere diesen Track als LiveTrack (Boat > Edit > Active LiveTrack)
Du musst Folgendes verfügbar haben:
TAG
TAG PASSWORD
Diese Zugangsdaten werden vom Tracker verwendet.
🍓 - Raspberry Pi OS installieren
Installiere Raspberry Pi OS wie üblich 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 Benutzer (in dieser Anleitung gehen wir vom Benutzernamen pi aus)
- Konfiguriere normal:
- Sprache
- Tastatur
- Netzwerk (WLAN für den Internetzugang)
Es wird empfohlen, die Zeitzone auf UTC zu setzen.
🛰️ — Deine Datenquelle vorbereiten
Folge dem Abschnitt, der zu deiner Hardware passt. Wenn du sowohl ein USB GPS als auch ein NMEA-Gateway verwendest, befolge beide.
Unabhängig von der Quelle muss dein GPS RMC-Sätze senden: Das sind die einzigen, die das Datum enthalten, und ohne sie wird keine Position aufgezeichnet.
USB GPS
Schließe das GPS an den Raspberry Pi an und prüfe, ob es erkannt wird:
dmesg | grep tty
Beispielausgabe:
[ 123.456789] usb 1-1.2: pl2303 converter now attached to ttyUSB0
Das GPS ist verfügbar unter:
/dev/ttyUSB0
Der Benutzer, der Joli_Compagnon ausführt, muss Zugriff auf den seriellen Port haben, d. h. Mitglied der Gruppe dialout sein:
sudo usermod -a -G dialout $USER
Dann abmelden und wieder anmelden.
Du musst die serielle Geschwindigkeit nicht selbst herausfinden: Wenn mit dem konfigurierten Port und der Geschwindigkeit keine NMEA-Daten empfangen werden, versucht reader.py die anderen Geschwindigkeiten (4800 bis 115200 Baud), dann die anderen seriellen Ports, und teilt dir mit, was gefunden wurde.
NMEA-Gateway über WiFi oder LAN
Je nach Verbindungstyp (WiFi oder LAN) deines NMEA-Gateways, besorge dir vom Hersteller die folgenden Informationen:
- IP-Adresse
- Port
- Protokoll (UDP oder TCP)
Typischerweise sieht die Konfiguration so aus:
IP: 10.0.0.1
Port: 10110
Protocol: TCP
Wenn du WiFi verwendest und dein NMEA-Gateway nicht im selben Netzwerk wie deine Internet-Hauptverbindung erreichbar ist, musst du eventuell ein zweites WiFi-Interface auf deinem Raspberry Pi konfigurieren, indem du einen zusätzlichen USB-WiFi-Dongle verwendest.
Das ermöglicht dir: - den NMEA-Datenstrom zu empfangen (eingehende Route) - Positionsdaten an Trakkit.org zu senden (ausgehende Route)
📦 — Joli_Compagnon installieren
Lade die Software von der Trakkit-Website herunter:
Trakkit.org → About → Download Tools
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 insbesondere Folgendes enthält:
reader.py
sender.py
config.ini.EXAMPLE
requirements.txt
README.txt
data/
🐍 — 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
🔧 — Joli_Compagnon konfigurieren
Erstelle die Konfigurationsdatei aus dem Beispiel:
cp config.ini.EXAMPLE config.ini
Bearbeite sie:
nano config.ini
Trakkit-Zugangsdaten
###############################################
# 🔑 Your Trakkit.org login credentials
###############################################
[USER]
TAG = YOUR_TAG_HERE
PWD = YOUR_TAG_PASSWORD_HERE
Datenquelle
Wähle die Quelle im Abschnitt READER: usb, tcp oder udp.
###############################################
# 🔀 Data source used by reader.py
###############################################
[READER]
SOURCE = usb
Mehrere Quellen können kombiniert werden, durch Kommas getrennt:
SOURCE = tcp, usb
Die Daten aller Quellen werden in einem einzigen Track zusammengeführt.
USB GPS (SOURCE = usb)
Setze das zuvor gefundene Gerät und dessen Geschwindigkeit:
###############################################
# 🛰️ Data source from USB GPS device
###############################################
[GPS]
GPS_PORT = /dev/ttyUSB0
GPS_BAUDS = 4800
Wenn das GPS an einem anderen Port oder mit einer anderen Geschwindigkeit gefunden wird, verwendet reader.py es trotzdem und zeigt dir die Werte an, die du hier eintragen musst.
NMEA-Gateway über TCP (SOURCE = tcp)
Setze die IP-Adresse und den Port deines Gateways:
###############################################
# 📡 Data source from NMEA multiplexer
###############################################
[NMEA]
NMEA_SRV = 10.0.0.1
NMEA_PORT = 10110
NMEA-Gateway über UDP (SOURCE = udp)
Bei UDP sendet das Gateway die Daten an den Raspberry Pi. NMEA_SRV ist daher die lokale Adresse, auf der gelauscht werden soll, nicht die Adresse des Gateways:
0.0.0.0um aus dem Netzwerk zu empfangen127.0.0.1wenn die Daten vom Raspberry Pi selbst kommen
NMEA_PORT ist der Port, an den dein Gateway sendet.
[NMEA]
NMEA_SRV = 0.0.0.0
NMEA_PORT = 10110
TCP und UDP teilen sich den NMEA-Abschnitt, daher können sie nicht gleichzeitig verwendet werden.
Weitere Einstellungen
Das sollten die einzigen Parameter sein, die du ändern musst.
Setze DELAY im Abschnitt GENERAL nicht unter 300 Sekunden, um zu vermeiden, dass du wegen übermäßiger Nutzung vom Trakkit-SFTP-Server gesperrt wirst oder als Angriff eingestuft wirst.
🔁 — Manueller Start des Trackers
Beide Programme müssen aus dem Verzeichnis joli_compagnon_last gestartet werden, weil config.ini und das Verzeichnis data relativ zum aktuellen Verzeichnis gesucht werden.
Aktiviere die Python Virtual Environment:
source venv/bin/activate
Starte den Reader:
./reader.py
Du solltest die empfangenen NMEA-Sätze sehen:
📡 Listening to GPS on /dev/ttyUSB0 at 4800 baud
✅ Connected to GPS (/dev/ttyUSB0)
✅ $GPRMC,184551.00,A,4250.5589,N,07059.3421,W,0.13,309.62,210424,,,A*6C
✅ $GPGGA,184551.00,4250.5589,N,07059.3421,W,1,10,0.8,12.3,M,-33.9,M,,*5A
💾 written: 5 line(s)
- ✅ markiert einen von Trakkit verwendeten Satz
- ❌ markiert einen ignorierten Satz (unbekannter Typ, proprietärer Satz oder falsche Prüfsumme)
- 💾 zeigt die lokal gespeicherten Positionen, alle 10 Sekunden
Starte den Sender in einem anderen Terminal (dort ebenfalls die Virtual Environment aktivieren):
./sender.py
Dieses Programm sendet die gespeicherten Daten alle 5 Minuten an Trakkit.org.
Warte ein paar Minuten.
Die Position deines Boat sollte jetzt auf Trakkit.org erscheinen.
🚀 - Autostart mit systemd automatisieren
An diesem Punkt hast du nun einen vollständig funktionierenden 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 nehmen wir den Benutzernamen pi und den folgenden Installationspfad an:
/home/pi/joli_compagnon_last/
Dort befinden sich Skripte und Virtual Environment.
Service für den Reader
Erstellen:
sudo nano /etc/systemd/system/trakkit_reader.service
[Unit]
Description=Trakkit.org Companion Reader
After=network.target
[Service]
User=pi
SupplementaryGroups=dialout
WorkingDirectory=/home/pi/joli_compagnon_last
Environment=PYTHONUNBUFFERED=1
ExecStart=/home/pi/joli_compagnon_last/venv/bin/python reader.py
Restart=always
RestartSec=30
[Install]
WantedBy=multi-user.target
SupplementaryGroups=dialout ermöglicht den Zugriff auf das USB GPS. Es ist unbedenklich, wenn du nur ein NMEA-Gateway verwendest.
Service für den Sender
Erstellen:
sudo nano /etc/systemd/system/trakkit_sender.service
[Unit]
Description=Trakkit.org Companion Sender
After=network.target
[Service]
User=pi
WorkingDirectory=/home/pi/joli_compagnon_last
Environment=PYTHONUNBUFFERED=1
ExecStart=/home/pi/joli_compagnon_last/venv/bin/python sender.py
Restart=always
RestartSec=30
[Install]
WantedBy=multi-user.target
Services aktivieren
sudo systemctl daemon-reload
sudo systemctl enable --now trakkit_reader
sudo systemctl enable --now trakkit_sender
Prüfe, dass sie laufen:
journalctl -u trakkit_reader -u trakkit_sender -f
Dein Trakkit.org Companion startet nun beim Booten automatisch und sendet die Position deines Boat kontinuierlich.
🔄 — Upgrade von einer früheren Version
Frühere Versionen von Joli_Compagnon hatten einen Reader pro Quelle: reader_usb.py, reader_tcp.py und reader_udp.py. Sie werden durch den einzelnen reader.py ersetzt.
Stoppe die Services:
sudo systemctl stop trakkit_reader trakkit_sender
Entpacke das neue Archiv über die bestehende Installation, aus deinem Home-Verzeichnis:
tar -xzf joli_compagnon.tgz
Dein config.ini und deine Data bleiben erhalten: Das Archiv enthält sie nicht.
Füge den Abschnitt READER zu deiner config.ini hinzu, mit der Quelle, die du verwendet hast:
[READER]
SOURCE = usb
(usb wenn du reader_usb.py verwendet hast, tcp für reader_tcp.py, udp für reader_udp.py).
Bearbeite /etc/systemd/system/trakkit_reader.service so, dass es reader.py startet, wie in Service for the reader gezeigt, und starte dann neu:
sudo systemctl daemon-reload
sudo systemctl start trakkit_reader trakkit_sender
Von der vorherigen Version aufgezeichnete und noch nicht gesendete Data wird so gesendet, wie sie ist: nichts geht verloren.
Du kannst dann die alten reader_usb.py, reader_tcp.py und reader_udp.py löschen.