DIY : Créer un tracker

avec un Raspberry Pi, un GPS USB et/ou une passerelle NMEA


Raspberry Pi Python Linux GPS USB TCP UDP

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


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 :

  1. Préparer votre configuration sur Trakkit.org
  2. Installer Raspberry Pi OS
  3. Installer et configurer Joli_Compagnon
  4. Tester le tracker
  5. 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.

  1. Créez votre Boat
  2. Créez un Tag
    (donnez-lui un nom reconnaissable)
  3. Créez un password pour ce Tag (Boat > Mails & Tags)
  4. Créez un Track avec :
    • Date de début : 01/01/2020
    • Date de fin : 01/01/2050
  5. 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 :

  1. Créez un utilisateur (dans ce guide, nous supposons que le nom d’utilisateur est pi)
  2. 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.0 pour recevoir depuis le réseau
  • 127.0.0.1 si 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.