Instalar readsb y tar1090: tu propio mapa local en directo para el receptor ADS-B

Flightradar24, FlightAware y compañía te enseñan el cielo tal como lo ven miles de receptores a la vez. A veces lo más interesante es otra pregunta: qué está oyendo tu propia antena ahora mismo, sin filtrar, sin retraso, directamente desde tu red doméstica. Para eso existe la combinación de readsb y tar1090: un decodificador potente y una interfaz de mapa que muchos spotters consideran el mejor mapa local en directo. Esta guía te muestra cómo instalar ambos en la Raspberry Pi, configurarlos con sentido y usarlos en el día a día del spotter.

readsb y tar1090: la respuesta corta

Ejecutas en tu Pi el script de instalación del proyecto adsb-scripts. Instala el decodificador readsb y la interfaz web tar1090 de una sola vez. Después fijas con readsb-set-location la ubicación de tu antena, dejas que la ganancia se regule sola y abres en el navegador la dirección de tu Pi con el añadido /tar1090. Si usas PiAware y no quieres tocarlo, instala solo tar1090: también funciona sobre dump1090-fa.

Qué hardware necesitas lo explica Montar tu propio receptor ADS-B. Cómo funciona el ADS-B en general lo lees en Seguimiento de vuelos con ADS-B para spotters. Aquí nos ocupamos del software.

Qué son realmente readsb y tar1090

readsb es un decodificador ADS-B que su propio desarrollador describe como una «navaja suiza». La versión que hoy usan casi todos los spotters la mantiene el desarrollador wiedehopf. Es un fork con desarrollo propio del readsb de Mictronics, que a su vez surgió de dump1090-fa; al comienzo de esta línea genealógica está el dump1090 original. readsb controla el SDR, descifra mensajes Mode S, ADS-B y TIS-B y entrega los datos en muchos formatos: como flujo Beast y de datos en bruto, en formato SBS para programas antiguos y como JSON para interfaces web. Qué contienen esos mensajes lo explica Transpondedor modo A, C y S.

tar1090 es la interfaz para ello. No sustituye a ningún decodificador: lee sus datos y construye con ellos un mapa con símbolos de aviones, tabla, columna de detalles y trazas. tar1090 funciona con readsb y dump1090-fa; con dump1090-mutability muestra menos detalles. Que la interfaz vale la pena se ve en sus usuarios más destacados: los trackers comunitarios adsb.lol, adsb.fi, airplanes.live y también el globo de ADS-B Exchange se basan en tar1090. Quien conoce esas webs se orienta enseguida en su propio mapa; más información en Comparativa de trackers comunitarios sin filtrar y ADS-B Exchange explicado.

Pieza	Función	Configuración
readsb	controlar el SDR, decodificar señales, proporcionar datos	/etc/default/readsb
tar1090	mapa en directo, tabla, trazas y filtros en el navegador	/etc/default/tar1090 y config.js
lighttpd	servidor web que sirve tar1090	lo configura el instalador

Antes de empezar: ¿qué camino te conviene?

Un SDR solo puede usarlo un decodificador a la vez. Por eso el instalador de readsb elimina otros decodificadores como dump1090-fa y dump1090-mutability. Es la decisión más importante antes de empezar.

Para el tercer caso te ayudan Alimentar varias redes a la vez con Ultrafeeder (allí tar1090 ya viene incluido en el contenedor), Recepción ADS-B sin Raspberry Pi y Seguimiento de vuelos en el PC.

Paso a paso: instalar readsb y tar1090

El requisito es un sistema basado en Debian, como Raspberry Pi OS, con acceso a internet y a la línea de comandos, directamente en la Pi o por SSH. El SDR y la antena ya están conectados a la Pi.

La guía menciona expresamente algunas particularidades: para el RTL-SDR Blog V4 no bastan los paquetes de controladores de Debian y Raspberry Pi OS; necesita una instalación adicional de controladores. Quien use un Airspy ejecuta tras la instalación el script airspy-conf; entonces airspy_adsb entrega los datos a readsb. Más información en Airspy para la máxima recepción ADS-B. Qué SDR compensa en general lo compara Comparativa de SDR para ADS-B.

Las actualizaciones son sencillas: basta con volver a ejecutar el mismo script de instalación. Tus ajustes se conservan.

Solo tar1090 en un sistema existente

Si usas PiAware, instalas únicamente tar1090 con su propio script del proyecto de GitHub wiedehopf/tar1090. El mapa también aparece aquí en /tar1090. El instalador de readsb se interrumpe por sí solo en una imagen SD de PiAware. Cómo configurar el propio PiAware se explica en Instalar y configurar PiAware.

Ajustar bien la ganancia y la ubicación

La ganancia decide si llegan las señales débiles de aviones lejanos o si los aviones cercanos saturan el SDR. readsb incluye para los SDR RTL-SDR una regulación automática propia, afinada para ADS-B. Según el desarrollador, normalmente no hace falta modificar sus valores básicos.

• Automática: readsb-gain auto activa la regulación.
• Valor fijo: sudo readsb-gain 43.9 establece una ganancia fija. Compensa si quieres comparar de forma deliberada durante varios días.
• Ajuste fino: todas las opciones están en /etc/default/readsb. Tras los cambios reinicias el servicio con sudo systemctl restart readsb; readsb --help lista todos los parámetros.

Si un cambio aporta de verdad más alcance no lo ves en los primeros cinco minutos, sino en las estadísticas de varios días. Para eso existe Medir el rendimiento de recepción con graphs1090, del mismo entorno de desarrollo. Las palancas de hardware, como preamplificadores y filtros, las describe Aumentar el alcance ADS-B, y la antena en sí sigue siendo el factor más importante: consulta Encontrar la mejor ubicación para la antena.

La ubicación es más que un detalle estético: sin ella, tar1090 no puede mostrar distancias ni centrar el mapa en tu estación. Introduce las coordenadas de tu antena con la mayor precisión posible. Si compartes datos con redes que usan MLAT, la posición exacta es obligatoria de todos modos; por qué, lo explica MLAT y multilateración explicados.

tar1090 en el día a día: las funciones más importantes

A primera vista, tar1090 parece un mapa de radar de vuelos como cualquier otro. Sus puntos fuertes se ven en los detalles, sobre todo para spotters que buscan tipos o matrículas concretos.

Filtros por tipo, altura e indicativo

En la barra lateral filtras por código de tipo OACI, descripción del tipo, indicativo, altura y fuente de datos. Los filtros entienden expresiones regulares: B73. abarca, por ejemplo, toda la familia 737, y la descripción L2J todos los birreactores terrestres. Cómo se construyen los códigos de tipo lo explica Códigos IATA y OACI explicados. La información adicional, como matrícula y tipo, procede de una base de datos incluida que tar1090 asigna mediante la dirección hexadecimal; el trasfondo está en Dirección OACI de 24 bits (código hex).

Atajos de teclado

Tecla	Función
Q / E	alejar y acercar el zoom
W / A / S / D	desplazar el mapa hacia el norte, oeste, sur y este
T	seleccionar todos los aviones con trazas
M	activar y desactivar la selección múltiple
C o Esc	anular la selección
B	cambiar el brillo del mapa

Trazas con pTracks: ¿hasta dónde oye tu antena?

Si añades ?pTracks a la dirección, tar1090 muestra todas las trazas registradas en las últimas ocho horas. El resultado es la imagen más sincera del alcance de tu estación: ves de inmediato en qué dirección los edificios o las colinas cortan la recepción. Con ?pTracks=2 limitas la vista a dos horas. Además, con el script getupintheair.sh y un conjunto de datos panorámicos de heywhatsthat.com puedes superponer anillos de alcance teóricos para determinadas alturas de vuelo. Eso sí, estos anillos no tienen en cuenta los árboles ni los obstáculos situados justo al lado de la antena.

Parámetros de URL prácticos

tar1090 se controla con añadidos en la dirección que puedes guardar como marcadores:

• ?icao= más la dirección hexadecimal selecciona un avión concreto; ?reg= funciona con la matrícula, pero carga más despacio, así que el proyecto recomienda ?icao=.
• ?filterType=A388 muestra solo un tipo determinado, y ?filterAltMax= limita la altura, útil para ver únicamente aproximaciones.
• ?mil resalta los aviones militares y otros aviones interesantes.
• ?kiosk cambia a un modo de visualización sin elementos de control, por ejemplo para una pantalla en la pared.
• ?filterSources=mlat muestra solo los aviones cuya posición se ha calculado mediante multilateración.

Varios parámetros se unen con &. Si buscas aviones concretos, encontrarás más estrategias en Seguir un avión por matrícula o código hex y Seguir aviones militares online.

Mapa de calor e historial

Algunas funciones requieren la versión de readsb de wiedehopf: el mapa de calor, que muestra dónde hubo más tráfico a lo largo del tiempo, y una repetición que reproduce de nuevo el historial de todos los aviones. Para ello activas en readsb opciones adicionales como --heatmap, con un directorio para los datos del historial. Aquí está la verdadera ventaja frente a la combinación de PiAware y tar1090.

Configuración: dónde está cada cosa

• /etc/default/readsb: opciones del decodificador como la ganancia, los puertos de red y las funciones adicionales.
• /etc/default/tar1090: intervalo y número de instantáneas del historial; tras los cambios, reinicia el servicio.
• /usr/local/share/tar1090/html/config.js: ajustes de la interfaz web. Activas una línea quitando las dos barras del principio y después recargas el navegador. Si borras el archivo y vuelves a ejecutar el instalador, se aplican de nuevo los valores por defecto.

A través de los puertos de red, readsb pone sus datos a disposición de otros programas, por ejemplo como flujo Beast en el puerto 30005, al que el instalador también conecta fr24feed y rbfeeder, y, si quieres, en formato SBS para programas antiguos. Por ahí acceden feeders adicionales o programas de tu PC. Cómo conectar desde aquí más redes lo muestran Configurar fr24feed, Alimentar ADS-B Exchange y redes comunitarias y Comparativa de programas feeder ADS-B.

Problemas típicos y sus soluciones

• «Conexión rechazada» en el navegador: normalmente falta el servidor web. Instala lighttpd con sudo apt install -y lighttpd y vuelve a ejecutar el instalador.
• No hay aviones en el mapa: mira el registro con sudo journalctl --no-pager -u readsb. Si el SDR se queda bloqueado, ¿está bien enroscado el cable de la antena?
• «Kernel driver is active» o «device is claimed»: un controlador del sistema retiene el SDR. La guía recomienda bloquear los controladores DVB afectados y reiniciar. Si no ayuda, otro programa está accediendo al SDR.
• Un feeder ya no envía nada: el instalador adapta fr24feed y rbfeeder; otros programas tienes que reconfigurarlos tú para que usen readsb como fuente de datos.
• Apenas hay alcance: casi siempre es cuestión de antena y ubicación, rara vez del software. Instrucciones de montaje en Construir una antena de 1090 MHz.
• Volver a PiAware: desactiva readsb con sudo systemctl disable --now readsb, elimina tar1090 con su script de desinstalación y reinstala dump1090-fa.

Qué ganas tú como spotter

Tu propio mapa es la herramienta más rápida antes de salir a hacer spotting. Una mirada a tar1090 por la mañana y ves de qué dirección llegan las primeras aproximaciones. En el aeropuerto de Múnich eso decide, por ejemplo, si vas a la colina de observación (Besucherhügel) o al otro extremo; en Hamburgo, si hoy conviene el Affenfelsen. La lógica detrás de esto la explica Entender la configuración de pistas de un aeropuerto.

A eso se suma el trabajo posterior: con la repetición y pTracks asignas a posteriori matrículas y vuelos a tus fotos. Cómo hacerlo de forma sistemática lo muestra Cotejar avistamientos con registros ADS-B. Y antes de pasar datos a terceros o compartir capturas de pantalla, conviene echar un vistazo a Recibir datos ADS-B: la situación legal.

Conclusión

readsb y tar1090 convierten tu receptor ADS-B en una auténtica estación local de radar de vuelos. El instalador hace el trabajo principal y después quedan tres gestos: fijar la ubicación, revisar la ganancia y comprobar que todos los feeders siguen funcionando. Quien no quiera tocar PiAware ya obtiene un mejor mapa solo con tar1090; quien quiera mapa de calor e historial, pasa por completo a readsb.