DIY: Maak een Tracker
met een Raspberry Pi, een USB GPS en/of een NMEA-gateway
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
- 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
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:
- Bereid je configuratie voor op Trakkit.org
- Installeer Raspberry Pi OS
- Installeer en configureer Joli_Compagnon
- Test de tracker
- Automatiseer het opstarten
⚓ - Configureer je Boat op Trakkit.org
Voordat je iets installeert op de Raspberry Pi, declareer je je tracker op Trakkit.org.
- Maak je Boat aan
- Maak een Tag aan
(geef die een herkenbare naam) - Maak een password voor deze Tag (Boat > Mails & Tags)
- Maak een Track met:
- Startdatum: 01/01/2020
- Einddatum: 01/01/2050
- 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:
- Maak een user aan (in deze gids gaan we ervan uit dat de gebruikersnaam pi is)
- 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.0om te ontvangen van het netwerk127.0.0.1als 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.