Configurar PiAware: el feeder de FlightAware en una Raspberry Pi

El hardware está sobre la mesa: Raspberry Pi, receptor SDR, antena y una tarjeta de memoria vacía. Solo falta el software que convierte estas piezas en una estación que escucha los aviones en el cielo y pasa sus datos a FlightAware. Eso es justo lo que hace PiAware. Esta guía te muestra paso a paso cómo instalar y configurar PiAware, ya sea con la imagen SD lista para usar o como paquete en una Raspberry Pi OS existente. A ello se suman reclamar la estación, la ubicación para MLAT, el mapa local SkyAware y los comandos que te ayudan cuando hay problemas.

Configurar PiAware: la respuesta corta

Grabas la imagen de PiAware en una tarjeta microSD con Raspberry Pi Imager, introduces si hace falta tu wifi en el archivo piaware-config.txt, conectas la tarjeta, el receptor SDR y la antena a la Pi y la enciendes. Pasados cuatro o cinco minutos, reclamas la estación con tu cuenta de FlightAware, fijas en la página de estadísticas la ubicación y la altura de la antena y listo. Si en tu Pi ya funciona Raspberry Pi OS, instalas PiAware en su lugar mediante el repositorio de paquetes de FlightAware.

Qué componentes necesitas y dónde conviene colocar la antena lo explica la guía Montar tu propio receptor ADS-B. Cómo funciona el propio ADS-B está en Seguimiento de vuelos con ADS-B para spotters. Aquí tratamos solo el software.

Qué hace realmente PiAware

PiAware no es un único programa, sino un pequeño conjunto que trabaja unido en la Pi. La recepción propiamente dicha la hace dump1090-fa: este decodificador controla el receptor SDR, demodula las señales en 1090 MHz y las convierte en mensajes ADS-B y Modo S legibles. Los fundamentos de estos mensajes los explica Transpondedor Modo A, C y S.

El programa piaware se encarga luego de la conexión con el exterior. Lee el flujo de datos del decodificador, lo procesa con la utilidad faup1090 y lo envía cifrado y comprimido a FlightAware. De paso informa con regularidad de datos del sistema como la temperatura de la CPU, la carga y el espacio libre. Si FlightAware solicita multilateración, piaware inicia además el fa-mlat-client, que transmite determinados mensajes en bruto para la localización. Cómo localiza MLAT aviones sin informe de posición propio lo describe MLAT y multilateración explicados.

Cada estación recibe un ID de feeder único. Con él vinculas la Pi a tu cuenta de FlightAware y hace que tus estadísticas se conserven incluso tras cambiar la tarjeta, si lo introduces de nuevo en la configuración.

Imagen SD o paquete: el camino adecuado para ti

FlightAware ofrece dos vías de instalación. Cuál te conviene depende de si tu Pi funciona exclusivamente como feeder.

Criterio	Imagen SD de PiAware	Instalación del paquete
Punto de partida	tarjeta microSD vacía	Pi con Raspberry Pi OS Trixie, Bookworm o Bullseye
Esfuerzo	grabar, introducir el wifi, arrancar	añadir el repositorio, instalar los paquetes con apt
Manejo	posible sin línea de comandos	hace falta acceso por terminal o SSH
Actualizaciones	actualizaciones automáticas y manuales permitidas por defecto	actualizaciones desactivadas por defecto
Usar la Pi para otras tareas	más bien no previsto	sin problema
Configuración	/boot/piaware-config.txt o piaware-config	piaware-config o /etc/piaware.conf

Para el tercer caso merecen la pena Alimentar varias redes a la vez con Ultrafeeder y Recepción ADS-B sin Raspberry Pi.

Camino 1: la imagen SD de PiAware

La imagen es un sistema operativo completo con decodificador, feeder y mapa local preinstalados. FlightAware la ofrece como archivo comprimido de unos 700 MB, además de una variante compatible con una pequeña pantalla Waveshare.

Configurar el wifi: archivo o Bluetooth

Al editar piaware-config.txt ten en cuenta: usa un editor de texto plano y desactiva las comillas tipográficas, o PiAware no leerá los valores. Según FlightAware, se admiten WPA/WPA2 y redes abiertas, pero no WEP. Por defecto la Pi obtiene su dirección por DHCP; quien quiera una IP fija pone wireless-type en static e introduce, entre otros datos, la dirección, la máscara de red, la puerta de enlace y el servidor de nombres.

A partir de PiAware 7.0 también se puede sin editar archivos: los datos del wifi se pueden transmitir por Bluetooth, bien con la app de FlightAware para iOS, bien mediante una página de configuración en el navegador. FlightAware menciona para ello Chrome, Edge, Opera y Chrome en Android.

Camino 2: instalar PiAware en Raspberry Pi OS

Si tu Pi ya funciona con Raspberry Pi OS, instalas PiAware como paquete encima. Requisito según FlightAware: Raspberry Pi OS Trixie, Bookworm o Bullseye, una conexión a internet y acceso a la línea de comandos, directamente en la Pi o por SSH. El proceso, en resumen:

1. Actualizar el sistema: sudo apt update, luego sudo apt full-upgrade y un reinicio con sudo reboot.
2. Añadir el repositorio: descarga el paquete flightaware-apt-repository de la página de instalación de FlightAware e instálalo con sudo dpkg -i. Registra la fuente de paquetes de FlightAware en tu sistema.
3. Instalar PiAware: sudo apt update y a continuación sudo apt install piaware.
4. Instalar el decodificador: si todavía no tienes decodificador, sigue sudo apt install dump1090-fa.
5. Reiniciar: sudo reboot.

Una diferencia con la imagen SD: en la instalación del paquete las actualizaciones automáticas y manuales están desactivadas. Si quieres que FlightAware pueda actualizar el software o poder lanzar actualizaciones desde la página de estadísticas, activas ambas con sudo piaware-config allow-auto-updates yes y sudo piaware-config allow-manual-updates yes.

El paquete dump978-fa, para la segunda banda de frecuencia de 978 MHz, no lo necesitas en Europa: UAT es un sistema estadounidense, como muestra UAT en 978 MHz explicado.

Reclamar la estación

Da igual el camino que hayas seguido: solo reclamar vincula la estación a tu cuenta de FlightAware. Espera de cuatro a cinco minutos tras el arranque y después tienes tres posibilidades:

• Por Bluetooth mediante la app de FlightAware para iOS o la página de configuración en línea. Según FlightAware, este camino solo funciona con la imagen SD, no con la instalación del paquete.
• En el navegador: abre desde tu red doméstica la dirección IP local de la Pi. Una estación aún no reclamada muestra allí un enlace de reclamación.
• Con el ID del feeder: con cat /var/cache/piaware/feeder_id lees el ID y lo añades a la dirección de reclamación del sitio web de FlightAware.

Si pasados cinco minutos la estación no aparece como reclamada, reinicia la Pi y revisa los ajustes del wifi. Si eso no ayuda, FlightAware ofrece soporte ADS-B por correo electrónico.

Después, tu estación aparece en la página de estadísticas ADS-B de FlightAware. Según FlightAware, tardan hasta 30 minutos en aparecer las primeras cifras; después encuentras la página, con la sesión iniciada, también en el elemento de menú «My ADS-B». Lo que obtienes como feeder, sobre todo la cuenta Enterprise gratuita, lo resume la guía de FlightAware; la comparación con otras redes la ofrece Qué reciben los feeders a cambio.

Ubicación y altura de la antena para MLAT

El paso más importante tras reclamar suele olvidarse: en la página de estadísticas haces clic en la rueda dentada junto al nombre de la estación e introduces la posición exacta y la altura de tu antena. Sin estos datos, tu estación no puede participar en la multilateración, porque el cálculo se basa en las posiciones exactas de todos los receptores que oyen la misma señal.

En la configuración, allow-mlat y mlat-results están activados por defecto. Las posiciones calculadas por MLAT también se devuelven a tu estación y aparecen en tu mapa local. Sobre todo los aviones más antiguos, muchos helicópteros y algunos aviones militares sin posición ADS-B pueden así llegar a verse.

SkyAware: tu propio mapa de radar de vuelos

Con PiAware obtienes una interfaz web local llamada SkyAware. Muestra en un mapa todos los aviones que tu estación oye en ese momento, con datos como el código hexadecimal, el indicativo y la altitud. El enlace directo y la dirección IP local de tu Pi los encuentras en tu página de estadísticas de FlightAware. El mapa solo es accesible desde tu propia red.

Para los spotters, SkyAware es una herramienta honesta: ves solo lo que tu antena recibe de verdad, sin filtros y sin lagunas de datos por listas de bloqueo. Qué significan los campos lo explican Dirección OACI de 24 bits (código hexadecimal) e Indicativo y número de vuelo. Quien quiera una interfaz más completa encontrará las alternativas habituales en Instalar readsb y tar1090 y Seguimiento de vuelos en el ordenador con tar1090.

Los comandos y ajustes más importantes

Para el día a día bastan pocos comandos. En la imagen SD, según la guía de FlightAware, inicias sesión con el usuario pi y la contraseña flightaware: cambia la contraseña enseguida con passwd. SSH está desactivado en las instalaciones SD nuevas a partir de la versión 3.3; lo activas colocando un archivo vacío llamado ssh, sin extensión, en la partición de arranque de la tarjeta.

Comando	Para qué sirve
sudo piaware-status	comprueba si funcionan el decodificador, faup1090 y piaware, y si hay conexión con FlightAware
piaware-config	muestra la configuración actual
sudo piaware-config <ajuste> <valor>	cambia un ajuste, por ejemplo allow-mlat yes
sudo systemctl restart piaware	reinicia el feeder
cat /var/cache/piaware/feeder_id	muestra el ID del feeder
/var/log/piaware.log	archivo de registro con mensajes de conexión y de error

Tras cambiar la configuración, reinicias la Pi o al menos el servicio. Algunos ajustes son especialmente interesantes para los spotters:

• Ganancia (gain): las instalaciones SD nuevas usan una ganancia adaptativa en modo de rango dinámico, que mantiene el ruido de fondo automáticamente en un valor objetivo o por debajo; el modo ráfaga está desactivado por defecto. Con adaptive-min-gain y adaptive-max-gain limitas el rango; con la opción rtlsdr-gain fijas en la imagen SD un valor fijo para el receptor.
• Modo ráfaga: adaptive-burst yes reduce la ganancia cuando aviones cercanos saturan el receptor. Esto ayuda directamente en la trayectoria de aproximación, pero cuesta alcance y, según la documentación, se considera experimental.
• Varios receptores: con rtlsdr-device-index eliges en la imagen SD el receptor correcto cuando hay varios conectados.
• Reutilizar el ID del feeder: con feeder-id introduces el ID antiguo tras cambiar la tarjeta o el hardware, para que se conserven las estadísticas y el historial.

Si un ajuste cambiado aporta de verdad más, solo lo ves en las cifras. Cómo comparar el alcance y la tasa de mensajes a lo largo de días lo muestra Medir el rendimiento de recepción con graphs1090. Las palancas de hardware, como preamplificadores y filtros, las describe Aumentar el alcance ADS-B.

Problemas típicos y su solución

• La estación no se puede reclamar: normalmente la Pi ni siquiera está en línea. Revisa si hay erratas en el nombre y la contraseña del wifi en piaware-config.txt, así como comillas tipográficas, o prueba con cable de red.
• No hay aviones en el mapa: sudo piaware-status muestra si funciona dump1090-fa. ¿El receptor está bien conectado y el cable de la antena enroscado? Un vistazo al registro revela si el decodificador encuentra siquiera el receptor.
• Apenas alcance: casi siempre es por la antena, no por el software. Más en Encontrar la mejor ubicación para la antena y Construir tu propia antena de 1090 MHz.
• Sin MLAT: ¿has fijado la ubicación y la altura de la antena en la página de estadísticas? Sin ellas, MLAT sigue inactivo.
• La estación se cuelga o se reinicia: una posible causa es una fuente de alimentación demasiado débil. FlightAware recomienda 5,1 voltios a 2,5 amperios.
• Receptor saturado: si vives justo al lado del aeropuerto, prueba el modo ráfaga o una ganancia máxima más baja. Qué receptores sirven para qué lo compara Receptores SDR para ADS-B comparados.

Más allá de FlightAware: conectar otras redes

PiAware no excluye otros servicios. El decodificador pone sus datos a disposición en la red local y programas de feeder adicionales pueden acceder a ellos en paralelo. Muchos spotters añaden el feeder de Flightradar24, explicado paso a paso en Configurar fr24feed, o envían datos a redes comunitarias como en Alimentar ADS-B Exchange y redes comunitarias. Qué red ofrece qué lo ordena Programas de feeder ADS-B comparados.

Qué obtienes tú como spotter

Tener tu propia estación es más que una contribución a la gran red. Si vives cerca de tu aeropuerto habitual, por la mañana ves en SkyAware desde qué dirección llegan las primeras aproximaciones y sabes al instante qué spot funciona hoy. En el aeropuerto de Múnich eso decide, por ejemplo, si vas a la colina de observación (Besucherhügel) o prefieres el otro extremo de la pista; en Hamburgo, si merece la pena la Affenfelsen. La lógica que hay detrás la explica Entender la configuración de pistas de un aeropuerto.

A ello se suma el cuaderno de registro: con los datos de tu estación y la cuenta Enterprise asignas después a las fotos matrículas y vuelos. Cómo hacerlo de forma sistemática lo muestra Contrastar avistamientos con registros ADS-B.

Conclusión

PiAware es una de las formas más sencillas de tener tu propia estación ADS-B. Con la imagen SD, un feeder puro funciona con unos pocos pasos; con la instalación del paquete integras PiAware en una Raspberry Pi OS existente. Después son decisivas tres cosas: reclamar la estación, introducir la ubicación y la altura de la antena para MLAT y cambiar la contraseña predeterminada. El resto lo hacen piaware-status, el registro y un mástil de antena bien colocado.