Fai da te: Crea un Tracker
con un Raspberry Pi, un GPS USB e/o un gateway NMEA
Questa guida spiega come costruire il tuo live tracker Trakkit.org usando un Raspberry Pi o qualsiasi sistema Linux e Joli_Compagnon.
I sistemi compatibili includono:
- Raspberry Pi OS
- Ubuntu
- Debian
Joli_Compagnon può leggere i dati NMEA da:
- un ricevitore GPS USB, come il BU-353N5
- un multiplexer o gateway NMEA via TCP o UDP, come lo ShipModul Miniplex
- entrambi contemporaneamente, ad esempio la posizione dal GPS USB e il vento dal multiplexer
Indice
- 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
Panoramica
Joli_Compagnon è composto da due programmi che funzionano affiancati:
- reader.py resta in ascolto delle tue sorgenti dati, decodifica le frasi NMEA e le memorizza localmente, con al massimo una posizione ogni 2 secondi.
- sender.py comprime i dati memorizzati e li carica su Trakkit.org tramite SFTP, ogni 5 minuti.
Se la connessione Internet si interrompe, i dati rimangono sul Raspberry Pi e vengono inviati non appena la connessione ritorna.
Il processo è semplice:
- Prepara la tua configurazione su Trakkit.org
- Installa Raspberry Pi OS
- Installa e configura Joli_Compagnon
- Testa il tracker
- Automatizza l’avvio
⚓ - Configura la tua Boat su Trakkit.org
Prima di installare qualsiasi cosa sul Raspberry Pi, dichiara il tuo tracker su Trakkit.org.
- Crea la tua Boat
- Crea un Tag
(assegnagli un nome riconoscibile) - Crea una password per questo Tag (Boat > Mails & Tags)
- Crea un Track con:
- Data di inizio: 01/01/2020
- Data di fine: 01/01/2050
- Contrassegna questo track come LiveTrack (Boat > Edit > Active LiveTrack)
Devi avere a disposizione:
TAG
TAG PASSWORD
Queste credenziali verranno utilizzate dal tracker.
🍓 - Installa Raspberry Pi OS
Installa Raspberry Pi OS normalmente sulla tua scheda SD.
Segui le istruzioni ufficiali:
https://www.raspberrypi.com/software
Non è richiesta alcuna configurazione speciale.
Puoi scegliere la versione Desktop, più facile da configurare, oppure la versione Lite se hai dimestichezza con Linux.
⚙️ — Configurazione di base del sistema
Al primo avvio:
- Crea un utente (in questa guida assumiamo che lo username sia pi)
- Configura normalmente:
- lingua
- tastiera
- rete (Wifi per accedere a Internet)
Si consiglia di impostare il fuso orario su UTC.
🛰️ — Prepara la tua sorgente dati
Segui la sezione corrispondente alla tua attrezzatura. Se usi sia un GPS USB sia un gateway NMEA, segui entrambe.
Qualunque sia la sorgente, il tuo GPS deve inviare frasi RMC: sono le uniche che contengono la data e nessuna posizione viene registrata senza di esse.
GPS USB
Collega il GPS al Raspberry Pi e verifica che venga rilevato:
dmesg | grep tty
Esempio di output:
[ 123.456789] usb 1-1.2: pl2303 converter now attached to ttyUSB0
Il GPS è disponibile su:
/dev/ttyUSB0
L’utente che esegue Joli_Compagnon deve avere accesso alla porta seriale, cioè deve essere membro del gruppo dialout:
sudo usermod -a -G dialout $USER
Poi esci e accedi di nuovo.
Non è necessario trovare da solo la velocità della seriale: se non vengono ricevuti dati NMEA con la porta e la velocità configurate, reader.py prova le altre velocità (da 4800 a 115200 baud), poi le altre porte seriali, e ti dice cosa ha trovato.
Gateway NMEA via WiFi o LAN
A seconda del tipo di connessione (WiFi o LAN) del tuo gateway NMEA, ottieni le seguenti informazioni dal produttore:
- Indirizzo IP
- Porta
- Protocollo (UDP o TCP)
In genere, la configurazione appare così:
IP: 10.0.0.1
Port: 10110
Protocol: TCP
Se stai usando il WiFi e il tuo gateway NMEA non è accessibile sulla stessa rete della tua connessione Internet principale, potrebbe essere necessario configurare una seconda interfaccia WiFi sul Raspberry Pi usando un dongle WiFi USB aggiuntivo.
Questo ti consente di: - ricevere lo stream di dati NMEA (rotta in ingresso) - inviare i dati di posizione a Trakkit.org (rotta in uscita)
📦 — Installa Joli_Compagnon
Scarica il software dal sito Trakkit:
Trakkit.org → About → Download Tools
Scarica il file:
joli_compagnon.tgz
Estrarlo nella tua home directory:
tar -xzf joli_compagnon.tgz
Questo crea la directory joli_compagnon_last, che contiene in particolare:
reader.py
sender.py
config.ini.EXAMPLE
requirements.txt
README.txt
data/
🐍 — Crea l’ambiente virtuale Python
Spostati nella directory:
cd joli_compagnon_last
Crea l’ambiente virtuale Python:
python3 -m venv venv
Attivalo:
source venv/bin/activate
Installa i moduli richiesti:
pip install -r requirements.txt
🔧 — Configura Joli_Compagnon
Crea il file di configurazione a partire dall’esempio:
cp config.ini.EXAMPLE config.ini
Modificalo:
nano config.ini
Credenziali Trakkit
###############################################
# 🔑 Your Trakkit.org login credentials
###############################################
[USER]
TAG = YOUR_TAG_HERE
PWD = YOUR_TAG_PASSWORD_HERE
Sorgente dati
Scegli la sorgente nella sezione READER: usb, tcp o udp.
###############################################
# 🔀 Data source used by reader.py
###############################################
[READER]
SOURCE = usb
È possibile combinare più sorgenti, separate da virgole:
SOURCE = tcp, usb
I dati di tutte le sorgenti vengono uniti in un unico track.
GPS USB (SOURCE = usb)
Imposta il dispositivo trovato in precedenza e la sua velocità:
###############################################
# 🛰️ Data source from USB GPS device
###############################################
[GPS]
GPS_PORT = /dev/ttyUSB0
GPS_BAUDS = 4800
Se il GPS viene trovato su un’altra porta o a un’altra velocità, reader.py lo usa comunque e mostra i valori da inserire qui.
Gateway NMEA via TCP (SOURCE = tcp)
Imposta l’indirizzo IP e la porta del tuo gateway:
###############################################
# 📡 Data source from NMEA multiplexer
###############################################
[NMEA]
NMEA_SRV = 10.0.0.1
NMEA_PORT = 10110
Gateway NMEA via UDP (SOURCE = udp)
Con UDP, il gateway invia i dati al Raspberry Pi. NMEA_SRV è quindi l’indirizzo locale su cui mettersi in ascolto, non l’indirizzo del gateway:
0.0.0.0per ricevere dalla rete127.0.0.1se i dati provengono dal Raspberry Pi stesso
NMEA_PORT è la porta verso cui il tuo gateway invia.
[NMEA]
NMEA_SRV = 0.0.0.0
NMEA_PORT = 10110
TCP e UDP condividono la sezione NMEA, quindi non possono essere usati contemporaneamente.
Altre impostazioni
Questi dovrebbero essere gli unici parametri che devi modificare.
Non impostare DELAY nella sezione GENERAL a meno di 300 secondi, per evitare di essere bannato dal server SFTP di Trakkit per uso eccessivo o di essere considerato un attacco.
🔁 — Avvio manuale del tracker
Entrambi i programmi devono essere avviati dalla directory joli_compagnon_last, perché config.ini e la directory data vengono cercati in relazione alla directory corrente.
Attiva l’ambiente virtuale Python:
source venv/bin/activate
Avvia il reader:
./reader.py
Dovresti vedere le frasi NMEA ricevute:
📡 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)
- ✅ indica una frase usata da Trakkit
- ❌ indica una frase ignorata (tipo sconosciuto, frase proprietaria o checksum errato)
- 💾 mostra le posizioni salvate localmente, ogni 10 secondi
Avvia il sender in un altro terminale (attiva anche lì l’ambiente virtuale):
./sender.py
Questo programma invia i dati memorizzati a Trakkit.org ogni 5 minuti.
Attendi qualche minuto.
La posizione della tua Boat dovrebbe ora apparire su Trakkit.org.
🚀 - Automatizza l’avvio con systemd
A questo punto hai un tracker completamente funzionante per Trakkit.org. Il passo finale è configurarlo per avviarsi automaticamente al boot.
Per il resto di questa guida, assumiamo lo username pi e il seguente percorso di installazione:
/home/pi/joli_compagnon_last/
Script e ambiente virtuale si trovano lì.
Service per il reader
Crea:
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 consente l’accesso al GPS USB. È innocuo se usi solo un gateway NMEA.
Service per il sender
Crea:
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
Abilita i service
sudo systemctl daemon-reload
sudo systemctl enable --now trakkit_reader
sudo systemctl enable --now trakkit_sender
Verifica che siano in esecuzione:
journalctl -u trakkit_reader -u trakkit_sender -f
Il tuo Trakkit.org Companion ora si avvierà automaticamente al boot e invierà continuamente la posizione della tua Boat.
🔄 — Aggiornamento da una versione precedente
Le versioni precedenti di Joli_Compagnon avevano un reader per sorgente: reader_usb.py, reader_tcp.py e reader_udp.py. Sono stati sostituiti dall’unico reader.py.
Ferma i service:
sudo systemctl stop trakkit_reader trakkit_sender
Estrai il nuovo archivio sopra l’installazione esistente, dalla tua home directory:
tar -xzf joli_compagnon.tgz
Il tuo config.ini e i tuoi dati vengono mantenuti: l’archivio non li contiene.
Aggiungi la sezione READER al tuo config.ini, con la sorgente che stavi usando:
[READER]
SOURCE = usb
(usb se usavi reader_usb.py, tcp per reader_tcp.py, udp per reader_udp.py).
Modifica /etc/systemd/system/trakkit_reader.service in modo che avvii reader.py, come mostrato in Service for the reader, poi riavvia:
sudo systemctl daemon-reload
sudo systemctl start trakkit_reader trakkit_sender
I dati registrati dalla versione precedente e non ancora inviati vengono inviati così come sono: non si perde nulla.
Puoi quindi eliminare i vecchi reader_usb.py, reader_tcp.py e reader_udp.py.