DIY: Crear un Tracker
con una Raspberry Pi, un GPS USB y/o una pasarela NMEA
Esta guía explica cómo construir tu propio Trakkit.org live tracker usando una Raspberry Pi o cualquier sistema Linux y Joli_Compagnon.
Los sistemas compatibles incluyen:
- Raspberry Pi OS
- Ubuntu
- Debian
Joli_Compagnon puede leer datos NMEA desde:
- un receptor GPS USB, como el BU-353N5
- un multiplexor o pasarela NMEA por TCP o UDP, como el ShipModul Miniplex
- ambos al mismo tiempo, por ejemplo la posición desde el GPS USB y el viento desde el multiplexor
Tabla de contenidos
- 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
Visión general
Joli_Compagnon consta de dos programas que se ejecutan en paralelo:
- reader.py escucha tus fuentes de datos, decodifica las frases NMEA y las almacena localmente, con un máximo de una posición cada 2 segundos.
- sender.py comprime los datos almacenados y los sube a Trakkit.org por SFTP, cada 5 minutos.
Si se pierde la conexión a Internet, los datos permanecen en la Raspberry Pi y se envían en cuanto la conexión vuelve.
El proceso es sencillo:
- Preparar tu configuración en Trakkit.org
- Instalar Raspberry Pi OS
- Instalar y configurar Joli_Compagnon
- Probar el tracker
- Automatizar el arranque
⚓ - Configura tu Boat en Trakkit.org
Antes de instalar nada en la Raspberry Pi, declara tu tracker en Trakkit.org.
- Crea tu Boat
- Crea un Tag
(ponle un nombre reconocible) - Crea una password para este Tag (Boat > Mails & Tags)
- Crea un Track con:
- Fecha de inicio: 01/01/2020
- Fecha de fin: 01/01/2050
- Marca este track como LiveTrack (Boat > Edit > Active LiveTrack)
Debes tener disponibles:
TAG
TAG PASSWORD
Estas credenciales serán utilizadas por el tracker.
🍓 - Instalar Raspberry Pi OS
Instala Raspberry Pi OS de forma normal en tu tarjeta SD.
Sigue las instrucciones oficiales:
https://www.raspberrypi.com/software
No se requiere ninguna configuración especial.
Puedes elegir la versión Desktop, más fácil de configurar, o la versión Lite si te sientes cómodo con Linux.
⚙️ — Configuración básica del sistema
En el primer arranque:
- Crea un usuario (en esta guía asumimos el nombre de usuario pi)
- Configura de forma normal:
- idioma
- teclado
- red (Wifi para acceder a Internet)
Se recomienda configurar la zona horaria en UTC.
🛰️ — Preparar tu fuente de datos
Sigue la sección que corresponda a tu equipo. Si usas tanto un GPS USB como una pasarela NMEA, sigue ambas.
Sea cual sea la fuente, tu GPS debe enviar frases RMC: son las únicas que contienen la fecha, y no se registra ninguna posición sin ellas.
GPS USB
Conecta el GPS a la Raspberry Pi y comprueba que se detecta:
dmesg | grep tty
Salida de ejemplo:
[ 123.456789] usb 1-1.2: pl2303 converter now attached to ttyUSB0
El GPS está disponible en:
/dev/ttyUSB0
El usuario que ejecute Joli_Compagnon debe tener acceso al puerto serie, lo que implica ser miembro del grupo dialout:
sudo usermod -a -G dialout $USER
Luego cierra sesión e inicia sesión de nuevo.
No necesitas encontrar tú mismo la velocidad del puerto serie: si no se reciben datos NMEA con el puerto y la velocidad configurados, reader.py prueba las otras velocidades (4800 a 115200 baudios), luego los otros puertos serie, y te dice qué ha encontrado.
Pasarela NMEA por WiFi o LAN
Dependiendo del tipo de conexión (WiFi o LAN) de tu pasarela NMEA, obtén del fabricante la siguiente información:
- Dirección IP
- Puerto
- Protocolo (UDP o TCP)
Normalmente, la configuración tiene este aspecto:
IP: 10.0.0.1
Port: 10110
Protocol: TCP
Si utilizas WiFi y tu pasarela NMEA no es accesible en la misma red que tu conexión principal a Internet, puede que necesites configurar una segunda interfaz WiFi en tu Raspberry Pi usando un adaptador WiFi USB adicional.
Esto te permite: - recibir el flujo de datos NMEA (ruta entrante) - enviar los datos de posición a Trakkit.org (ruta saliente)
📦 — Instalar Joli_Compagnon
Descarga el software desde el sitio web de Trakkit:
Trakkit.org → About → Download Tools
Descarga el archivo:
joli_compagnon.tgz
Extráelo en tu directorio personal:
tar -xzf joli_compagnon.tgz
Esto crea el directorio joli_compagnon_last, que contiene en particular:
reader.py
sender.py
config.ini.EXAMPLE
requirements.txt
README.txt
data/
🐍 — Crear el entorno virtual de Python
Entra en el directorio:
cd joli_compagnon_last
Crea el entorno virtual de Python:
python3 -m venv venv
Actívalo:
source venv/bin/activate
Instala los módulos requeridos:
pip install -r requirements.txt
🔧 — Configurar Joli_Compagnon
Crea el archivo de configuración a partir del ejemplo:
cp config.ini.EXAMPLE config.ini
Edítalo:
nano config.ini
Credenciales de Trakkit
###############################################
# 🔑 Your Trakkit.org login credentials
###############################################
[USER]
TAG = YOUR_TAG_HERE
PWD = YOUR_TAG_PASSWORD_HERE
Fuente de datos
Elige la fuente en la sección READER: usb, tcp o udp.
###############################################
# 🔀 Data source used by reader.py
###############################################
[READER]
SOURCE = usb
Se pueden combinar varias fuentes, separadas por comas:
SOURCE = tcp, usb
Los datos de todas las fuentes se fusionan en un único track.
GPS USB (SOURCE = usb)
Configura el dispositivo encontrado anteriormente y su velocidad:
###############################################
# 🛰️ Data source from USB GPS device
###############################################
[GPS]
GPS_PORT = /dev/ttyUSB0
GPS_BAUDS = 4800
Si el GPS se encuentra en otro puerto o a otra velocidad, reader.py igualmente lo utiliza y muestra los valores que debes poner aquí.
Pasarela NMEA por TCP (SOURCE = tcp)
Configura la dirección IP y el puerto de tu pasarela:
###############################################
# 📡 Data source from NMEA multiplexer
###############################################
[NMEA]
NMEA_SRV = 10.0.0.1
NMEA_PORT = 10110
Pasarela NMEA por UDP (SOURCE = udp)
Con UDP, la pasarela envía los datos a la Raspberry Pi. Por lo tanto, NMEA_SRV es la dirección local en la que se debe escuchar, no la dirección de la pasarela:
0.0.0.0para recibir desde la red127.0.0.1si los datos provienen de la propia Raspberry Pi
NMEA_PORT es el puerto al que envía tu pasarela.
[NMEA]
NMEA_SRV = 0.0.0.0
NMEA_PORT = 10110
TCP y UDP comparten la sección NMEA, por lo que no se pueden usar al mismo tiempo.
Otros ajustes
Estos deberían ser los únicos parámetros que necesitas modificar.
No configures DELAY en la sección GENERAL a menos de 300 segundos, para evitar que el servidor SFTP de Trakkit te bloquee por uso excesivo o que se considere como un ataque.
🔁 — Lanzamiento manual del tracker
Ambos programas deben iniciarse desde el directorio joli_compagnon_last, porque config.ini y el directorio data se buscan de forma relativa al directorio actual.
Activa el entorno virtual de Python:
source venv/bin/activate
Inicia el reader:
./reader.py
Deberías ver las frases NMEA recibidas:
📡 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)
- ✅ marca una frase utilizada por Trakkit
- ❌ marca una frase ignorada (tipo desconocido, frase propietaria o checksum incorrecto)
- 💾 muestra las posiciones guardadas localmente, cada 10 segundos
Inicia el sender en otra terminal (activa allí también el entorno virtual):
./sender.py
Este programa envía los datos almacenados a Trakkit.org cada 5 minutos.
Espera unos minutos.
La posición de tu Boat debería aparecer ahora en Trakkit.org.
🚀 - Automatizar el arranque con systemd
En este punto, ya tienes un tracker completamente funcional para Trakkit.org. El paso final es configurarlo para que se inicie automáticamente al arrancar.
Para el resto de esta guía, asumimos el nombre de usuario pi y la siguiente ruta de instalación:
/home/pi/joli_compagnon_last/
Los scripts y el entorno virtual están ubicados allí.
Servicio para el 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 da acceso al GPS USB. Es inofensivo si solo usas una pasarela NMEA.
Servicio para el 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
Habilitar los servicios
sudo systemctl daemon-reload
sudo systemctl enable --now trakkit_reader
sudo systemctl enable --now trakkit_sender
Comprueba que se están ejecutando:
journalctl -u trakkit_reader -u trakkit_sender -f
Tu Trakkit.org Companion ahora se iniciará automáticamente al arrancar y enviará la posición de tu Boat de forma continua.
🔄 — Actualizar desde una versión anterior
Las versiones anteriores de Joli_Compagnon tenían un reader por fuente: reader_usb.py, reader_tcp.py y reader_udp.py. Han sido sustituidos por el único reader.py.
Detén los servicios:
sudo systemctl stop trakkit_reader trakkit_sender
Extrae el nuevo archivo sobre la instalación existente, desde tu directorio personal:
tar -xzf joli_compagnon.tgz
Tu config.ini y tus datos se conservan: el archivo no los contiene.
Añade la sección READER a tu config.ini, con la fuente que estabas usando:
[READER]
SOURCE = usb
(usb si usabas reader_usb.py, tcp para reader_tcp.py, udp para reader_udp.py).
Edita /etc/systemd/system/trakkit_reader.service para que inicie reader.py, como se muestra en Service for the reader, y luego reinicia:
sudo systemctl daemon-reload
sudo systemctl start trakkit_reader trakkit_sender
Los datos registrados por la versión anterior y todavía no enviados se envían tal cual: no se pierde nada.
Luego puedes eliminar los antiguos reader_usb.py, reader_tcp.py y reader_udp.py.