Guía de instalación y configuración de dumpvdl2

dumpvdl2 es un decodificador de mensajes VDL Mode 2 y analizador de protocolos. Es el decodificador recomendado para VDL2 y admite múltiples canales simultáneos con opciones de salida flexibles.

Instalación paso a paso en Debian/Ubuntu

Instalación de dependencias necesarias

sudo apt-get install build-essential cmake git pkg-config libglib2.0-dev librtlsdr-dev

Instalar libacars (requerido)

git clone https://github.com/szpajder/libacars.git
cd libacars
mkdir build && cd build
cmake ../
make
sudo make install
sudo ldconfig

Compilar dumpvdl2

git clone https://github.com/szpajder/dumpvdl2.git
cd dumpvdl2
mkdir build && cd build
cmake ../
make
sudo make install

Opciones opcionales de compilación (flags):

• -DRTLSDR=TRUE — Soporte RTL-SDR (habilitado por defecto si se encuentra librtlsdr)
• -DMIRISDR=TRUE — Soporte Mirics SDR
• -DSDRPLAY=TRUE — Soporte SDRplay
• -DSOAPYSDR=TRUE — Soporte SoapySDR
• -DSQLITE=TRUE — Enriquecimiento con base de datos de aeronaves
• -DZMQ=TRUE — Soporte para salida ZeroMQ (instalar libzmq3-dev antes)

Instalación rápida mediante script

Una alternativa a compilar desde el código fuente es el script de instalación de wiedehopf:

bash -c "$(wget -q -O - https://raw.githubusercontent.com/wiedehopf/adsb-wiki/main/dumpvdl2-install.sh)"

Pasos de Configuración

Guía de uso básico

dumpvdl2 --rtlsdr 0 --gain 40 --correction 0 \
  --output decoded:json:udp:address=feed.airframes.io,port=5552 \
  --station-id MI-ESTACION-VDL2 \
  136975000

Opciones principales de la línea de comandos

Opción	Descripción
--rtlsdr <dispositivo>	Usa el dispositivo RTL-SDR (por índice o número de serie)
--sdrplay <dispositivo>	Usa el dispositivo SDRplay
--soapysdr <dispositivo>	Usa el dispositivo SoapySDR
--gain <dB>	Ganancia del sintonizador en dB
--correction <ppm>	Corrección de frecuencia en PPM
--centerfreq <freq>	Establece la frecuencia central (útil para evitar el pico de DC)
--station-id <id>	Identificador de la estación para los mensajes de salida
--output <spec>	Configuración de la salida (ver más abajo)

Las frecuencias se especifican como últimos argumentos en Hz (ej., 136975000) o con sufijos (136.975M).

Configuración de la salida

dumpvdl2 usa un sistema de salida flexible con la siguiente sintaxis:

--output <qué>:<formato>:<transporte>:<parámetros>

Formatos:

• text — Texto legible por humanos
• json — Formato JSON (requerido para Airframes)

Transportes:

• file:path=/ruta/al/archivo — Escribe en un archivo
• udp:address=<host>,port=<puerto> — Envía vía UDP
• tcp:address=<host>,port=<puerto> — Envía vía TCP
• zmq:mode=<client|server>,endpoint=<endpoint> — ZeroMQ pub/sub

Podés usar múltiples banderas --output simultáneamente.

Compartir datos con Airframes

dumpvdl2 --rtlsdr 0 --gain 40 \
  --output decoded:json:udp:address=feed.airframes.io,port=5552 \
  --station-id MI-ESTACION-VDL2 \
  136650000 136700000 136800000 136975000

(El canal de señalización mundial CSC de VDL2 es 136975000 y siempre debería incluirse).

Ejecutando como un Servicio

sudo tee /etc/systemd/system/dumpvdl2.service << 'EOF'
[Unit]
Description=dumpvdl2 VDL2 decoder
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/dumpvdl2 --rtlsdr 0 --gain 40 --output decoded:json:udp:address=feed.airframes.io,port=5552 --station-id MI-ESTACION-VDL2 136650000 136700000 136800000 136975000
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable dumpvdl2
sudo systemctl start dumpvdl2

Lecturas relacionadas

Principiante Aviación y ACARS ¿Qué es VDL Mode 2? Evolución de las comunicaciones aeronáuticas VDL Mode 2 es el sucesor digital del ACARS original: 13 veces más rápido a 31.500 bps y decodificable con dumpvdl2. Frecuencias, diferencias con POA y cómo recibirlo con SDR. Avanzado Aviación y ACARS Guía de instalación y configuración de acarsdec para SDR Guía completa de instalación, compilación y configuración de acarsdec para decodificar ACARS VHF y compartir los datos. Principiante Aviación y ACARS Resumen de Tecnologías Aeronáuticas: ACARS, ADS-B, VDL2 y más Una visión general del panorama tecnológico de ACARS, los diferentes medios de transmisión y cómo Airframes los captura. Incluye guía de sistemas y equipos receptores de 1 a 4+ SDRs y ACARS sobre AERO (Inmarsat).