DIY: Creare un Tracker
con un Raspberry Pi e un gateway NMEA
Questa guida spiega come costruire il tuo Trakkit.org live tracker utilizzando un Raspberry Pi o qualsiasi sistema Linux.
I sistemi compatibili includono:
- Raspberry Pi OS
- Ubuntu
-
Debian
-
Per questa guida, utilizziamo un multiplexer NMEA come ShipModul Miniplex o un gateway simile.
Indice
- 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
Panoramica
Il processo è semplice:
- Prepara la configurazione su Trakkit.org
- Installa Raspberry Pi OS
- Installa 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
- Crea un Track con:
- Data di inizio: 01/01/2020
- Data di fine: 01/01/2050
- Contrassegna questo track come LiveTrack
Ora dovresti avere:
TAG
TAG PASSWORD
Queste credenziali verranno utilizzate dal tracker.
🍓 - Installare 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 come nome utente pi)
- Configura normalmente:
- lingua
- tastiera
- rete (Wifi per accedere a Internet)
Si consiglia di impostare il fuso orario su UTC.
🛰️ — Connessione WiFi o LAN al gateway NMEA
A seconda del tipo di connessione (WiFi o LAN) del tuo gateway NMEA, ottieni dal produttore le seguenti informazioni:
- Indirizzo IP
- Porta
- Protocollo (UDP o 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 utilizzando un dongle WiFi USB aggiuntivo.
Questo ti consente di: - ricevere lo stream Data NMEA (rotta in ingresso) - inviare i Data di posizione a Trakkit.org (rotta in uscita)
Tipicamente, la configurazione appare così:
IP: 10.0.0.1
Port: 10110
Protocol: TCP
Questi valori devono essere configurati nel file config.ini.
📦 — Installare Joli_Compagnon
Scarica il software dal sito Trakkit:
Trakkit.org → About → Download
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 tutti gli script.
🐍 — Creare 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
🔁 — Avvio manuale del tracker
Attiva l’ambiente virtuale Python:
source venv/bin/activate
Rinomina il file di configurazione:
mv config.ini.EXAMPLE config.ini
Modifica il file:
nano config.ini
Configura le tue credenziali Trakkit:
###############################################
# 🔑 Your Trakkit.org login credentials
###############################################
[USER]
TAG = YOUR_TAG_HERE
PWD = YOUR_TAG_PASSWORD_HERE
Quindi configura la sezione NMEA utilizzando i valori definiti in precedenza per accedere al tuo gateway NMEA:
###############################################
# 📡 Data source from NMEA multiplexer
###############################################
[NMEA]
NMEA_SRV = 10.0.0.1
NMEA_PORT = 10110
Avvia il lettore NMEA in base al protocollo utilizzato
(deve essere in esecuzione un solo processo):
./reader_tcp.py
OPPURE
./reader_udp.py
Dovresti vedere le frasi NMEA visualizzate.
Avvia il sender in un altro terminale:
./sender.py
Questo script invia le posizioni GPS a Trakkit.org.
Attendi qualche minuto.
Ora la posizione della tua Boat dovrebbe apparire su Trakkit.org.
🚀 - Automatizzare l’avvio con systemd
A questo punto, hai un tracker pienamente funzionante per Trakkit.org. L’ultimo passaggio è configurarlo per l’avvio automatico al boot.
Per il resto di questa guida, assumiamo l’uso del protocollo TCP, il nome utente pi e il seguente percorso di installazione:
/home/pi/joli_compagnon_last/
Gli script e l’ambiente virtuale si trovano lì.
Servizio per il lettore NMEA
Crea:
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
Servizio per il sender
Crea:
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
Abilitare i servizi
sudo systemctl daemon-reload
sudo systemctl enable trakkit_reader
sudo systemctl enable trakkit_sender
Avviali:
sudo systemctl start trakkit_reader
sudo systemctl start trakkit_sender
Il tuo Trakkit.org Companion ora si avvierà automaticamente al boot, si connetterà al tuo gateway NMEA e invierà continuamente la posizione della tua Boat.