DIY: Maak een Tracker

met een Raspberry Pi, een USB GPS en/of een NMEA-gateway


Raspberry Pi Python Linux GPS USB TCP UDP

Deze gids legt uit hoe je je eigen Trakkit.org live tracker bouwt met een Raspberry Pi of eender welk Linux-systeem en Joli_Compagnon.

Compatibele systemen zijn onder andere:

  • Raspberry Pi OS
  • Ubuntu
  • Debian

Joli_Compagnon kan NMEA Data lezen van:

  • een USB GPS-ontvanger, zoals de BU-353N5
  • een NMEA-multiplexer of -gateway via TCP of UDP, zoals de ShipModul Miniplex
  • beide tegelijk, bijvoorbeeld de positie van de USB GPS en de wind van de multiplexer

Inhoudsopgave


Overzicht

Joli_Compagnon bestaat uit twee programma’s die naast elkaar draaien:

  • reader.py luistert naar je databronnen, decodeert de NMEA-zinnen en slaat ze lokaal op, met maximaal één positie elke 2 seconden.
  • sender.py comprimeert de opgeslagen Data en uploadt die via SFTP naar Trakkit.org, elke 5 minuten.

Als de internetverbinding wegvalt, blijven de Data op de Raspberry Pi staan en worden ze verzonden zodra de verbinding terug is.

Het proces is eenvoudig:

  1. Bereid je configuratie voor op Trakkit.org
  2. Installeer Raspberry Pi OS
  3. Installeer en configureer Joli_Compagnon
  4. Test de tracker
  5. Automatiseer het opstarten

⚓ - Configureer je Boat op Trakkit.org

Voordat je iets installeert op de Raspberry Pi, declareer je je tracker op Trakkit.org.

  1. Maak je Boat aan
  2. Maak een Tag aan
    (geef die een herkenbare naam)
  3. Maak een password voor deze Tag (Boat > Mails & Tags)
  4. Maak een Track met:
    • Startdatum: 01/01/2020
    • Einddatum: 01/01/2050
  5. Markeer deze track als LiveTrack (Boat > Edit > Active LiveTrack)

Je moet het volgende beschikbaar hebben:

TAG
TAG PASSWORD

Deze inloggegevens worden door de tracker gebruikt.


🍓 - Raspberry Pi OS installeren

Installeer Raspberry Pi OS op de gebruikelijke manier op je SD-kaart.

Volg de officiële instructies:

https://www.raspberrypi.com/software

Er is geen speciale configuratie nodig.

Je kunt de Desktop-versie kiezen, die eenvoudiger te configureren is, of de Lite-versie als je vertrouwd bent met Linux.


⚙️ — Basisconfiguratie van het systeem

Bij de eerste opstart:

  1. Maak een user aan (in deze gids gaan we ervan uit dat de gebruikersnaam pi is)
  2. Configureer zoals gebruikelijk:
    • taal
    • toetsenbord
    • netwerk (Wifi om toegang tot internet te krijgen)

Het wordt aanbevolen de tijdzone op UTC te zetten.


🛰️ — Je databron voorbereiden

Volg de sectie die overeenkomt met je apparatuur. Als je zowel een USB GPS als een NMEA-gateway gebruikt, volg dan beide.

Ongeacht de bron moet je GPS RMC-zinnen versturen: dat zijn de enige die de datum bevatten, en zonder die zinnen wordt er geen positie opgeslagen.

USB GPS

Sluit de GPS aan op de Raspberry Pi en controleer dat die gedetecteerd wordt:

dmesg | grep tty

Voorbeelduitvoer:

[  123.456789] usb 1-1.2: pl2303 converter now attached to ttyUSB0

De GPS is beschikbaar op:

/dev/ttyUSB0

De user die Joli_Compagnon uitvoert moet toegang hebben tot de seriële poort, wat betekent dat die lid moet zijn van de groep dialout:

sudo usermod -a -G dialout $USER

Log daarna uit en weer in.

Je hoeft de seriële snelheid niet zelf te vinden: als er geen NMEA Data ontvangen wordt met de geconfigureerde poort en snelheid, probeert reader.py de andere snelheden (4800 tot 115200 baud), daarna de andere seriële poorten, en vertelt je wat hij gevonden heeft.

NMEA-gateway via WiFi of LAN

Afhankelijk van het verbindingstype (WiFi of LAN) van je NMEA-gateway, vraag de volgende informatie op bij de fabrikant:

  • IP-adres
  • Poort
  • Protocol (UDP of TCP)

Doorgaans ziet de configuratie er zo uit:

IP: 10.0.0.1
Port: 10110
Protocol: TCP

Als je WiFi gebruikt en je NMEA-gateway niet bereikbaar is op hetzelfde netwerk als je hoofd-internetverbinding, moet je mogelijk een tweede WiFi-interface op je Raspberry Pi configureren met een extra USB WiFi-dongle.

Dit stelt je in staat om: - de NMEA-datastroom te ontvangen (inkomende route) - positiegegevens naar Trakkit.org te sturen (uitgaande route)


📦 — Joli_Compagnon installeren

Download de software van de Trakkit-website:

Trakkit.org → About → Download Tools

Download het bestand:

joli_compagnon.tgz

Pak het uit in je home directory:

tar -xzf joli_compagnon.tgz

Dit maakt de directory joli_compagnon_last aan, die onder andere het volgende bevat:

reader.py
sender.py
config.ini.EXAMPLE
requirements.txt
README.txt
data/

🐍 — De Python virtual environment aanmaken

Ga naar de directory:

cd joli_compagnon_last

Maak de Python virtual environment aan:

python3 -m venv venv

Activeer die:

source venv/bin/activate

Installeer de vereiste modules:

pip install -r requirements.txt

🔧 — Joli_Compagnon configureren

Maak het configuratiebestand aan op basis van het voorbeeld:

cp config.ini.EXAMPLE config.ini

Bewerk het:

nano config.ini

Trakkit-inloggegevens

###############################################
# 🔑 Your Trakkit.org login credentials
###############################################
[USER]
TAG = YOUR_TAG_HERE
PWD = YOUR_TAG_PASSWORD_HERE

Databron

Kies de bron in de sectie READER: usb, tcp of udp.

###############################################
# 🔀 Data source used by reader.py
###############################################
[READER]
SOURCE = usb

Meerdere bronnen kunnen gecombineerd worden, gescheiden door komma’s:

SOURCE = tcp, usb

De Data van alle bronnen wordt samengevoegd in één Track.

USB GPS (SOURCE = usb)

Stel het eerder gevonden device in en de snelheid:

###############################################
# 🛰️ Data source from USB GPS device
###############################################
[GPS]
GPS_PORT = /dev/ttyUSB0
GPS_BAUDS = 4800

Als de GPS op een andere poort of met een andere snelheid wordt gevonden, gebruikt reader.py die alsnog en toont hij de waarden die je hier moet invullen.

NMEA-gateway via TCP (SOURCE = tcp)

Stel het IP-adres en de poort van je gateway in:

###############################################
# 📡 Data source from NMEA multiplexer
###############################################
[NMEA]
NMEA_SRV = 10.0.0.1
NMEA_PORT = 10110

NMEA-gateway via UDP (SOURCE = udp)

Met UDP stuurt de gateway de Data naar de Raspberry Pi. NMEA_SRV is daarom het lokale adres om op te luisteren, niet het adres van de gateway:

  • 0.0.0.0 om te ontvangen van het netwerk
  • 127.0.0.1 als de Data van de Raspberry Pi zelf komt

NMEA_PORT is de poort waarnaar je gateway verstuurt.

[NMEA]
NMEA_SRV = 0.0.0.0
NMEA_PORT = 10110

TCP en UDP delen de NMEA-sectie, dus ze kunnen niet tegelijk gebruikt worden.

Overige instellingen

Dit zouden de enige parameters moeten zijn die je hoeft aan te passen.

Zet DELAY in de GENERAL-sectie niet lager dan 300 seconden, om te voorkomen dat je geblokkeerd wordt door de Trakkit SFTP-server wegens overmatig gebruik of als aanval gezien wordt.


🔁 — De tracker handmatig starten

Beide programma’s moeten gestart worden vanuit de directory joli_compagnon_last, omdat config.ini en de directory data relatief ten opzichte van de huidige directory worden opgezocht.

Activeer de Python virtual environment:

source venv/bin/activate

Start de reader:

./reader.py

Je zou de ontvangen NMEA-zinnen moeten zien:

📡 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)
  • ✅ markeert een zin die door Trakkit wordt gebruikt
  • ❌ markeert een zin die genegeerd wordt (onbekend type, proprietary zin of foutieve checksum)
  • 💾 toont de posities die lokaal opgeslagen worden, elke 10 seconden

Start de sender in een andere terminal (activeer daar ook de virtual environment):

./sender.py

Dit programma verstuurt de opgeslagen Data elke 5 minuten naar Trakkit.org.

Wacht een paar minuten.

De positie van je Boat zou nu moeten verschijnen op Trakkit.org.


🚀 - Opstarten automatiseren met systemd

Op dit punt heb je een volledig functionele tracker voor Trakkit.org. De laatste stap is om deze zo te configureren dat hij automatisch start bij het opstarten.

Voor de rest van deze gids gaan we uit van de gebruikersnaam pi en het volgende installatiepad:

/home/pi/joli_compagnon_last/

Scripts en virtual environment bevinden zich daar.


Service voor de reader

Maak aan:

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 geeft toegang tot de USB GPS. Het is onschadelijk als je alleen een NMEA-gateway gebruikt.


Service voor de sender

Maak aan:

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

De services inschakelen

sudo systemctl daemon-reload
sudo systemctl enable --now trakkit_reader
sudo systemctl enable --now trakkit_sender

Controleer dat ze draaien:

journalctl -u trakkit_reader -u trakkit_sender -f

Je Trakkit.org Companion start nu automatisch bij het opstarten en stuurt continu de positie van je Boat.


🔄 — Upgraden vanaf een vorige versie

Vorige versies van Joli_Compagnon hadden één reader per bron: reader_usb.py, reader_tcp.py en reader_udp.py. Die zijn vervangen door de enkele reader.py.

Stop de services:

sudo systemctl stop trakkit_reader trakkit_sender

Pak het nieuwe archief uit over de bestaande installatie, vanuit je home directory:

tar -xzf joli_compagnon.tgz

Je config.ini en je Data blijven behouden: het archief bevat ze niet.

Voeg de sectie READER toe aan je config.ini, met de bron die je gebruikte:

[READER]
SOURCE = usb

(usb als je reader_usb.py gebruikte, tcp voor reader_tcp.py, udp voor reader_udp.py).

Bewerk /etc/systemd/system/trakkit_reader.service zodat het reader.py start, zoals getoond in Service for the reader, en herstart dan:

sudo systemctl daemon-reload
sudo systemctl start trakkit_reader trakkit_sender

Data die door de vorige versie opgenomen zijn en nog niet verzonden waren, worden gewoon zoals ze zijn verstuurd: er gaat niets verloren.

Je kunt daarna de oude reader_usb.py, reader_tcp.py en reader_udp.py verwijderen.