DIY : créer un Tracker
avec un Raspberry Pi et une passerelle NMEA
Ce guide explique comment construire votre propre live tracker Trakkit.org à l’aide d’un Raspberry Pi ou de tout système Linux.
Les systèmes compatibles incluent :
- Raspberry Pi OS
- Ubuntu
-
Debian
-
Pour ce guide, nous utilisons un multiplexeur NMEA tel que le ShipModul Miniplex ou une passerelle similaire.
Table des matières
- Overview
- Configure your boat on Trakkit.org
- Install Raspberry Pi OS
- Basic system configuration
- WiFi / LAN to NMEA Gateway
- Install Joli_Compagnon
- Create the Python virtual environment
- Manual launch of the tracker
- Automate startup with systemd
Vue d’ensemble
Le processus est simple :
- Préparez votre configuration sur Trakkit.org
- Installez Raspberry Pi OS
- Installez Joli_Compagnon
- Testez le tracker
- Automatisez 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
- Créez un Track avec :
- Date de début : 01/01/2020
- Date de fin : 01/01/2050
- Marquez ce Track comme LiveTrack
Vous devez maintenant avoir :
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
Aucune configuration particulière n’est 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 :
- la langue
- le clavier
- le réseau (Wifi pour accéder à Internet)
Il est recommandé de définir le fuseau horaire sur UTC.
🛰️ — Connexion WiFi ou LAN à la passerelle NMEA
Selon le type de connexion (WiFi ou LAN) de votre passerelle NMEA, obtenez auprès du fabricant les informations suivantes :
- Adresse IP
- Port
- Protocole (UDP ou 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 à l’aide d’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)
En général, la configuration ressemble à :
IP: 10.0.0.1
Port: 10110
Protocol: TCP
Ces valeurs doivent être configurées dans le fichier config.ini.
📦 — Installer Joli_Compagnon
Téléchargez le logiciel depuis le site Trakkit :
Trakkit.org → About → Download
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 tous les scripts.
🐍 — 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
🔁 — Lancement manuel du tracker
Activez l’environnement virtuel Python :
source venv/bin/activate
Renommez le fichier de configuration :
mv config.ini.EXAMPLE config.ini
Modifiez le fichier :
nano config.ini
Configurez vos identifiants Trakkit :
###############################################
# 🔑 Your Trakkit.org login credentials
###############################################
[USER]
TAG = YOUR_TAG_HERE
PWD = YOUR_TAG_PASSWORD_HERE
Puis configurez la section NMEA en utilisant les valeurs définies précédemment pour accéder à votre passerelle NMEA :
###############################################
# 📡 Data source from NMEA multiplexer
###############################################
[NMEA]
NMEA_SRV = 10.0.0.1
NMEA_PORT = 10110
Démarrez le lecteur NMEA selon le protocole utilisé
(un seul processus doit être en cours d’exécution) :
./reader_tcp.py
OU
./reader_udp.py
Vous devriez voir des trames NMEA s’afficher.
Démarrez l’émetteur dans un autre terminal :
./sender.py
Ce script envoie les positions GPS vers Trakkit.org.
Attendez quelques minutes.
La position de votre bateau devrait maintenant apparaître sur Trakkit.org.
🚀 - Automatiser le démarrage avec systemd
À ce stade, vous disposez maintenant d’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 l’utilisation du protocole TCP, 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 lecteur NMEA
Créez :
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 pour l’émetteur
Créez :
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
Activer les services
sudo systemctl daemon-reload
sudo systemctl enable trakkit_reader
sudo systemctl enable trakkit_sender
Démarrez-les :
sudo systemctl start trakkit_reader
sudo systemctl start trakkit_sender
Votre Trakkit.org Companion démarrera désormais automatiquement au boot, se connectera à votre passerelle NMEA et enverra en continu la position de votre bateau.