DIY: Einen Tracker erstellen

mit einem Raspberry Pi und einem NMEA-Gateway


Raspberry Pi Python Linux GPS WiFi TCP UDP

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


Überblick

Der Prozess ist einfach:

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

⚓ - Konfiguriere dein Boat auf Trakkit.org

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

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

  1. Erstelle einen user (in dieser Anleitung gehen wir vom Benutzernamen pi aus)
  2. 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.