Guía de instalación y configuración de acarsdec para SDR

acarsdec es un decodificador ACARS VHF multicanal. Esta guía cubre la instalación, configuración y envío de datos (feeding) a Airframes.

Instalación paso a paso en Debian/Ubuntu

Instalación de dependencias necesarias

sudo apt-get install build-essential cmake git libusb-1.0-0-dev librtlsdr-dev libxml2-dev zlib1g-dev pkg-config

Instalar libacars (requerido para decodificar mensajes)

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

Compilar acarsdec

git clone https://github.com/TLeconte/acarsdec.git
cd acarsdec
mkdir build && cd build
cmake .. -Drtl=ON
make
sudo make install

Opciones de compilación para otro hardware SDR:

• Airspy: cmake .. -Dairspy=ON
• SDRplay: cmake .. -Dsdrplay=ON
• SoapySDR: cmake .. -Dsoapy=ON

Pasos de Configuración

Guía de uso básico

acarsdec -o 4 -j feed.airframes.io:5550 -i MI-ESTACION-ACARS -r 0 130.025 130.450 131.125 131.550

Opciones principales de la línea de comandos

Opción	Descripción
-r <dispositivo> f1 f2 ...	Número del dispositivo RTL-SDR seguido de las frecuencias (en MHz)
-s <dispositivo> f1 f2 ...	Número del dispositivo Airspy seguido de las frecuencias
-o <nivel>	Formato de salida: 0 ninguno, 1 una-linea, 2 completo (por defecto), 3 monitor, 4 JSON, 5 ruta JSON
-j <host:puerto>	Envía mensajes JSON mediante UDP al destino especificado
-i <station_id>	Identificador de estación incluido en los mensajes de salida
-g <ganancia>	Ganancia del sintonizador en dB (usá -10 o valores sobre 52 para AGC)
-p <ppm>	Corrección de frecuencia en PPM
-A	Solo mostrar mensajes de aeronaves (enlace descendente/downlink), omitir enlace ascendente (uplink)
-e	Excluir mensajes vacíos
-l <archivo_log>	Guardar registro en un archivo en vez de mostrar en consola (stdout)
-H	Rotar el archivo de registro cada hora
-D	Rotar el archivo de registro cada día

Compartir datos con Airframes

Para enviar datos ACARS VHF a Airframes, usá la bandera -j combinada con la salida JSON (-o 4):

acarsdec -o 4 -j feed.airframes.io:5550 -i MI-ESTACION-ACARS -g 42 -r 0 130.025 130.450 131.125 131.550

Parámetros importantes para alimentar a la red:

• -o 4 habilita la salida JSON (requerida por Airframes).
• -j feed.airframes.io:5550 envía los datos a la ingesta ACARS de Airframes (puerto UDP 5550).
• -i MI-ESTACION-ACARS identifica a tu estación.

Formato de ID de la estación

La identificación de tu estación (Station ID) ayuda a identificar tu señal en Airframes. El formato recomendado es:

XX-YYYY-ACARS

Donde:

• XX — Tus iniciales o un identificador personal (ej. KE)
• YYYY — El código ICAO del aeropuerto más cercano (ej. KSEA o SABE)
• ACARS — El tipo de decodificador

Ejemplo: KE-KSEA-ACARS

Frecuencias ACARS Comunes

Todas las frecuencias deben estar dentro del mismo ancho de banda de 2 MHz. Se pueden decodificar hasta 8 canales a la vez.

Revisá la tabla original según la región en la que te encuentres, por ejemplo en América suele usarse 129.125, 130.025, 130.450, 131.125 y 131.550 MHz.

Ejecutando como un Servicio

Para ejecutar acarsdec automáticamente al arrancar, crea un servicio systemd:

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

[Service]
Type=simple
ExecStart=/usr/local/bin/acarsdec -o 4 -j feed.airframes.io:5550 -i MI-ESTACION-ACARS -g 42 -r 0 130.025 130.450 131.125 131.550
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable acarsdec
sudo systemctl start acarsdec

Solución a Problemas Frecuentes

No se reciben mensajes:

• Verificá que se detecta tu SDR: rtl_test.
• Revisá tu configuración de ganancia (intentá valores entre 20–48).
• Asegurate de estar utilizando frecuencias activas en tu región.
• Comprobá que otro software no esté usando el dispositivo.

Errores de permisos:

• Creá una regla udev para tu RTL-SDR.
• Bloqueá el módulo del kernel de DVB-T: echo "blacklist dvb_usb_rtl28xxu" > /etc/modprobe.d/blacklist-rtlsdr.conf y reiniciá.

Lecturas relacionadas

Intermedio Aviación y ACARS Cómo decodificar mensajes ACARS con RTL-SDR: Guía completa Recibí mensajes de texto, telemetría OOOI y reportes meteorológicos de aviones en tiempo real con tu RTL-SDR. Frecuencias, software acarsdec y decodificación VHF en Argentina (131.550 y 131.725 MHz). 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. 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).