Fai da te: Crea un Tracker

con un Raspberry Pi, un GPS USB e/o un gateway NMEA


Raspberry Pi Python Linux GPS USB TCP UDP

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


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:

  1. Prepara la tua configurazione su Trakkit.org
  2. Installa Raspberry Pi OS
  3. Installa e configura Joli_Compagnon
  4. Testa il tracker
  5. 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.

  1. Crea la tua Boat
  2. Crea un Tag
    (assegnagli un nome riconoscibile)
  3. Crea una password per questo Tag (Boat > Mails & Tags)
  4. Crea un Track con:
    • Data di inizio: 01/01/2020
    • Data di fine: 01/01/2050
  5. 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:

  1. Crea un utente (in questa guida assumiamo che lo username sia pi)
  2. 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.0 per ricevere dalla rete
  • 127.0.0.1 se 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.