DIY: Einen Tracker erstellen

mit einem Raspberry Pi, einem USB GPS und/oder einem NMEA-Gateway


Raspberry Pi Python Linux GPS USB TCP UDP

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


Ü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:

  1. Bereite deine Konfiguration auf Trakkit.org vor
  2. Installiere Raspberry Pi OS
  3. Installiere und konfiguriere Joli_Compagnon
  4. Teste den Tracker
  5. Automatisiere den Start

⚓ - Dein Boat auf Trakkit.org konfigurieren

Bevor du irgendetwas auf dem Raspberry Pi installierst, deklariere deinen Tracker auf Trakkit.org.

  1. Erstelle dein Boat
  2. Erstelle einen Tag
    (gib ihm einen gut erkennbaren Namen)
  3. Erstelle ein password für diesen Tag (Boat > Mails & Tags)
  4. Erstelle einen Track mit:
    • Startdatum: 01/01/2020
    • Enddatum: 01/01/2050
  5. 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:

  1. Erstelle einen Benutzer (in dieser Anleitung gehen wir vom Benutzernamen pi aus)
  2. 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.0 um aus dem Netzwerk zu empfangen
  • 127.0.0.1 wenn 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.