DIY : Créer un tracker
avec un Raspberry Pi, un GPS USB et/ou une passerelle NMEA
Ce guide explique comment construire votre propre tracker live Trakkit.org avec un Raspberry Pi ou tout système Linux et Joli_Compagnon.
Les systèmes compatibles incluent :
- Raspberry Pi OS
- Ubuntu
- Debian
Joli_Compagnon peut lire des données NMEA depuis :
- un récepteur GPS USB, tel que le BU-353N5
- un multiplexeur ou une passerelle NMEA via TCP ou UDP, tel que le ShipModul Miniplex
- les deux en même temps, par exemple la position depuis le GPS USB et le vent depuis le multiplexeur
Table des matières
- 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
Vue d’ensemble
Joli_Compagnon se compose de deux programmes qui s’exécutent côte à côte :
- reader.py écoute vos sources de données, décode les phrases NMEA et les stocke localement, avec au maximum une position toutes les 2 secondes.
- sender.py compresse les données stockées et les téléverse sur Trakkit.org via SFTP, toutes les 5 minutes.
Si la connexion Internet est perdue, les données restent sur le Raspberry Pi et sont envoyées dès que la connexion revient.
Le processus est simple :
- Préparer votre configuration sur Trakkit.org
- Installer Raspberry Pi OS
- Installer et configurer Joli_Compagnon
- Tester le tracker
- Automatiser le démarrage
⚓ - Configurer votre Boat sur Trakkit.org
Avant d’installer quoi que ce soit sur le Raspberry Pi, déclarez votre tracker sur Trakkit.org.
- Créez votre Boat
- Créez un Tag
(donnez-lui un nom reconnaissable) - Créez un password pour ce Tag (Boat > Mails & Tags)
- Créez un Track avec :
- Date de début : 01/01/2020
- Date de fin : 01/01/2050
- Marquez ce track comme LiveTrack (Boat > Edit > Active LiveTrack)
Vous devez disposer de :
TAG
TAG PASSWORD
Ces identifiants seront utilisés par le tracker.
🍓 - Installer Raspberry Pi OS
Installez Raspberry Pi OS normalement sur votre carte SD.
Suivez les instructions officielles :
https://www.raspberrypi.com/software
Il n’y a aucune configuration particulière requise.
Vous pouvez choisir la version Desktop, plus facile à configurer, ou la version Lite si vous êtes à l’aise avec Linux.
⚙️ — Configuration système de base
Au premier démarrage :
- Créez un utilisateur (dans ce guide, nous supposons que le nom d’utilisateur est pi)
- Configurez normalement :
- langue
- clavier
- réseau (Wifi pour accéder à Internet)
Il est recommandé de régler le fuseau horaire sur UTC.
🛰️ — Préparer votre source de données
Suivez la section correspondant à votre équipement. Si vous utilisez à la fois un GPS USB et une passerelle NMEA, suivez les deux.
Quelle que soit la source, votre GPS doit envoyer des phrases RMC : ce sont les seules qui contiennent la date, et aucune position n’est enregistrée sans elles.
GPS USB
Connectez le GPS au Raspberry Pi et vérifiez qu’il est détecté :
dmesg | grep tty
Exemple de sortie :
[ 123.456789] usb 1-1.2: pl2303 converter now attached to ttyUSB0
Le GPS est disponible sur :
/dev/ttyUSB0
L’utilisateur qui exécute Joli_Compagnon doit avoir accès au port série, ce qui signifie être membre du groupe dialout :
sudo usermod -a -G dialout $USER
Puis déconnectez-vous et reconnectez-vous.
Vous n’avez pas besoin de trouver vous-même la vitesse série : si aucune donnée NMEA n’est reçue avec le port et la vitesse configurés, reader.py essaie les autres vitesses (4800 à 115200 bauds), puis les autres ports série, et vous indique ce qu’il a trouvé.
Passerelle NMEA via WiFi ou LAN
Selon le type de connexion (WiFi ou LAN) de votre passerelle NMEA, obtenez les informations suivantes auprès du fabricant :
- Adresse IP
- Port
- Protocole (UDP ou TCP)
En général, la configuration ressemble à :
IP: 10.0.0.1
Port: 10110
Protocol: TCP
Si vous utilisez le WiFi et que votre passerelle NMEA n’est pas accessible sur le même réseau que votre connexion Internet principale, vous devrez peut-être configurer une seconde interface WiFi sur votre Raspberry Pi en utilisant une clé WiFi USB supplémentaire.
Cela vous permet de : - recevoir le flux de données NMEA (route entrante) - envoyer les données de position vers Trakkit.org (route sortante)
📦 — Installer Joli_Compagnon
Téléchargez le logiciel depuis le site Trakkit :
Trakkit.org → About → Download Tools
Téléchargez le fichier :
joli_compagnon.tgz
Extrayez-le dans votre répertoire personnel :
tar -xzf joli_compagnon.tgz
Cela crée le répertoire joli_compagnon_last, qui contient notamment :
reader.py
sender.py
config.ini.EXAMPLE
requirements.txt
README.txt
data/
🐍 — Créer l’environnement virtuel Python
Placez-vous dans le répertoire :
cd joli_compagnon_last
Créez l’environnement virtuel Python :
python3 -m venv venv
Activez-le :
source venv/bin/activate
Installez les modules requis :
pip install -r requirements.txt
🔧 — Configurer Joli_Compagnon
Créez le fichier de configuration à partir de l’exemple :
cp config.ini.EXAMPLE config.ini
Éditez-le :
nano config.ini
Identifiants Trakkit
###############################################
# 🔑 Your Trakkit.org login credentials
###############################################
[USER]
TAG = YOUR_TAG_HERE
PWD = YOUR_TAG_PASSWORD_HERE
Source de données
Choisissez la source dans la section READER : usb, tcp ou udp.
###############################################
# 🔀 Data source used by reader.py
###############################################
[READER]
SOURCE = usb
Plusieurs sources peuvent être combinées, séparées par des virgules :
SOURCE = tcp, usb
Les données de toutes les sources sont fusionnées dans un seul track.
GPS USB (SOURCE = usb)
Renseignez le périphérique trouvé précédemment et sa vitesse :
###############################################
# 🛰️ Data source from USB GPS device
###############################################
[GPS]
GPS_PORT = /dev/ttyUSB0
GPS_BAUDS = 4800
Si le GPS est trouvé sur un autre port ou à une autre vitesse, reader.py l’utilise quand même et affiche les valeurs à mettre ici.
Passerelle NMEA via TCP (SOURCE = tcp)
Renseignez l’adresse IP et le port de votre passerelle :
###############################################
# 📡 Data source from NMEA multiplexer
###############################################
[NMEA]
NMEA_SRV = 10.0.0.1
NMEA_PORT = 10110
Passerelle NMEA via UDP (SOURCE = udp)
Avec UDP, la passerelle envoie les données vers le Raspberry Pi. NMEA_SRV est donc l’adresse locale sur laquelle écouter, et non l’adresse de la passerelle :
0.0.0.0pour recevoir depuis le réseau127.0.0.1si les données proviennent du Raspberry Pi lui-même
NMEA_PORT est le port vers lequel votre passerelle envoie.
[NMEA]
NMEA_SRV = 0.0.0.0
NMEA_PORT = 10110
TCP et UDP partagent la section NMEA ; ils ne peuvent donc pas être utilisés en même temps.
Autres réglages
Ce devraient être les seuls paramètres que vous ayez à modifier.
Ne réglez pas DELAY dans la section GENERAL en dessous de 300 secondes, afin d’éviter d’être banni par le serveur SFTP de Trakkit pour usage excessif ou d’être considéré comme une attaque.
🔁 — Lancement manuel du tracker
Les deux programmes doivent être démarrés depuis le répertoire joli_compagnon_last, car config.ini et le répertoire data sont recherchés relativement au répertoire courant.
Activez l’environnement virtuel Python :
source venv/bin/activate
Démarrez le reader :
./reader.py
Vous devriez voir les phrases NMEA reçues :
📡 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)
- ✅ indique une phrase utilisée par Trakkit
- ❌ indique une phrase ignorée (type inconnu, phrase propriétaire ou somme de contrôle incorrecte)
- 💾 indique les positions sauvegardées localement, toutes les 10 secondes
Démarrez le sender dans un autre terminal (activez aussi l’environnement virtuel dans celui-ci) :
./sender.py
Ce programme envoie les données stockées vers Trakkit.org toutes les 5 minutes.
Attendez quelques minutes.
La position de votre Boat devrait maintenant apparaître sur Trakkit.org.
🚀 - Automatiser le démarrage avec systemd
À ce stade, vous avez désormais un tracker pleinement fonctionnel pour Trakkit.org. La dernière étape consiste à le configurer pour qu’il démarre automatiquement au boot.
Pour la suite de ce guide, nous supposons le nom d’utilisateur pi et le chemin d’installation suivant :
/home/pi/joli_compagnon_last/
Les scripts et l’environnement virtuel s’y trouvent.
Service pour le reader
Créez :
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 donne accès au GPS USB. C’est sans conséquence si vous n’utilisez qu’une passerelle NMEA.
Service pour le sender
Créez :
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
Activer les services
sudo systemctl daemon-reload
sudo systemctl enable --now trakkit_reader
sudo systemctl enable --now trakkit_sender
Vérifiez qu’ils fonctionnent :
journalctl -u trakkit_reader -u trakkit_sender -f
Votre Trakkit.org Companion démarrera désormais automatiquement au boot et enverra en continu la position de votre Boat.
🔄 — Mise à niveau depuis une version précédente
Les versions précédentes de Joli_Compagnon avaient un reader par source : reader_usb.py, reader_tcp.py et reader_udp.py. Ils sont remplacés par le reader.py unique.
Arrêtez les services :
sudo systemctl stop trakkit_reader trakkit_sender
Extrayez la nouvelle archive par-dessus l’installation existante, depuis votre répertoire personnel :
tar -xzf joli_compagnon.tgz
Votre config.ini et vos données sont conservés : l’archive ne les contient pas.
Ajoutez la section READER à votre config.ini, avec la source que vous utilisiez :
[READER]
SOURCE = usb
(usb si vous utilisiez reader_usb.py, tcp pour reader_tcp.py, udp pour reader_udp.py).
Éditez /etc/systemd/system/trakkit_reader.service afin qu’il démarre reader.py, comme montré dans Service for the reader, puis redémarrez :
sudo systemctl daemon-reload
sudo systemctl start trakkit_reader trakkit_sender
Les données enregistrées par la version précédente et pas encore envoyées sont envoyées telles quelles : rien n’est perdu.
Vous pouvez ensuite supprimer les anciens reader_usb.py, reader_tcp.py et reader_udp.py.