Manual — openRadar

1. Empezá acá (primera vez)

Objetivo: ver aviones reales alrededor de un lugar.

Encendé el radar (USB o fuente estable).
Si pide red → CONFIGURAR WIFI y conectate a tu casa. Si no hay red, podés usar MODO SIMULACION para probar la UI.
Cuando haya WiFi → espera Recuperando datos de vuelo.
Deslizá a Menú → Aeropuerto y elegí el centro (aeropuerto o MI LUGAR) + zoom en km.
Volvé al Radar (swipe). Deberías ver EN VIVO y aviones (si hay tráfico en el área).

2. Cómo se usa día a día

Hay cuatro pantallas principales. Cambiá entre ellas deslizando el dedo en horizontal:

Radar ⇄ Lista ⇄ Reloj ⇄ Menú ⇄ (vuelve al Radar)

El cambio se detecta mientras movés el dedo (no hace falta soltar).
En subpantallas del menú (Aeropuerto, Pantalla, etc.) el botón SALIR vuelve al Menú.
En la pantalla WiFi, SALIR también vuelve al Menú (firmware reciente).

Estados que vas a ver

En pantalla	Significado
EN VIVO	WiFi OK y la fuente ADS-B respondió.
SIN RED	No hay enlace WiFi al router.
SIN API / fuente	Hay WiFi, pero la API no respondió (probá otra fuente o ACTUALIZAR).
SIM	Modo demo local (sin internet).

3. Las pantallas (qué hace cada una)

Radar

Vista principal: círculo con aviones, anillos de distancia y rumbo.

Zona	Qué muestra
Arriba izq.	Hora local + estado (EN VIVO / SIN RED / SIM…)
Arriba der.	Nombre del lugar + alcance (km)
Abajo izq.	Marca, o acceso rápido a WiFi si hay problema
Abajo der.	Cuenta regresiva al próximo refresh

Tocá un avión (icono o etiqueta) → ficha de detalle.
Tocá afuera / cerrá para volver al radar.
El zoom (km) se cambia en Menú → Aeropuerto, no en el radar.

Lista

Solo vuelos en el aire, ordenados por distancia. Tocá una fila → mismo detalle que en el radar. Si no hay nadie: Sin trafico en rango.

Reloj

Hora grande, fecha (si NTP sincronizó), widget de clima (si está ON) y últimos movimientos (aterrizajes / despegues). No tiene botones propios: salís con swipe.

Menú

Cuatro casillas + pie con AYUDA y VOLVER (al radar):

Aeropuerto | WiFi Pantalla | Datos ADS-B

4. Opciones del menú (explicadas)

Aeropuerto

Para qué: definir el centro del mapa y el radio.

Lista de aeropuertos de fábrica + hasta 5 propios + MI LUGAR.
Columna de zoom: 5…40 km (radio visual; la API pide hasta 40 km).
Editar MI LUGAR o un slot propio (nombre/coords). Presets de fábrica no se editan.

SALIR → Menú.

Pantalla

Para qué: aspecto y reloj.

Opción	Qué hace
TEMA	Paleta de colores de la UI.
BRILLO	10 % … 100 %. Con modo noche el tope real es más bajo.
Modo noche	Atenúa la pantalla aunque el brillo diga 100 %.
SYNC HORA	Sincroniza reloj por internet (hace falta WiFi).
Clima ON/OFF	Muestra u oculta el clima en Reloj.

Datos ADS-B

Para qué: de dónde salen los aviones.

Fuente	Cuándo usarla
openRadar Cloud	Preferida: proxy + cache en tu servidor (`openradar.space` u otra URL).
adsb.lol	API pública directa.
adsb.fi	API pública alternativa.
Simulador	Demo local, sin internet.

EDITAR — Cloud URL (base, sin /api/...).
ACTUALIZAR — vuelve a probar las fuentes (✓ / X).
Intervalo — cada cuántos segundos consulta (mín. 15 s en builds actuales).
Si Cloud falla, el firmware puede respaldar a lol/fi automáticamente.

Ayuda (pie del menú)

QR al manual web (/manual).
ACTUALIZAR — consulta si hay firmware nuevo en Cloud y, si hay, descarga (no apagues).

5. WiFi en pantalla

Entrada: Menú → WiFi, o el acceso WiFi del pie del radar cuando hay problema de red.

Arriba: red actual OK: nombre + IP, o (no conectado).
★ = red ya guardada (conectás sin tipear clave).
SCAN — busca redes. Si ya estás conectado, el enlace se mantiene.
PORTAL — reinicia al AP Radar-Setup para configurar desde el celular (opcional).
Al tocar una red: Conectar / Olvidar / Cancelar.

Se guardan hasta 5 redes. Al reiniciar prueba primero la más reciente.

6. Portal y panel web

Primera configuración (portal)

En el radar: WiFi → PORTAL (o arranque sin redes).
En el celular: conectate al WiFi Radar-Setup (sin clave).
Abrí http://192.168.4.1/ (o el QR de la pantalla).
Elegí tu red de casa, guardá y esperá el reinicio.

Panel en casa (misma WiFi)

Preferí la IP que muestra el radar: http://192.168.x.x/
http://radar.local a veces no resuelve en todos los celulares/routers.
Ahí podés ver estado, cambiar fuentes / Cloud URL y abrir /update.

7. Actualizar el firmware

Método	Cómo
En el radar	Menú → Ayuda → ACTUALIZAR. Compara tu versión con Cloud. Si hay update, descarga sola. No apagues ni cortes WiFi (1–2 min).
Navegador	`http://<IP-del-radar>/update` · clave `openradar` · subí `openradar.bin` (el `.ino.bin` exportado, renombrado).
Automático	Con WiFi + Cloud URL consulta `/firmware/version.json` (~90 s al conectar, luego cada 6 h).
Arduino IDE	Puerto de red → host `openRadar` · pass `openradar`.

8. Si algo falla

Síntoma	Qué probar
No abre `radar.local`	Usá la IP que ves en WiFi / panel.
SIN RED	Menú → WiFi → SCAN / conectar. Revisá router y distancia.
WiFi OK pero sin aviones	Datos ADS-B → otra fuente o ACTUALIZAR. Probá zoom más grande.
Cloud con X	EDITAR URL (https, sin barra final). Misma red / DNS.
OTA web falla	Misma WiFi, IP + `/update`, archivo `openradar.bin`, clave `openradar`.
Pantalla se reinicia al entrar WiFi	Fuente USB más firme / cable corto. Firmware reciente baja la potencia del scan.

LED: verde = datos OK · azul titila = WiFi sin datos · rojo titila = sin WiFi · cian = SIM a propósito.