Red#

La puesta en marcha de Wi-Fi (main/main.c) es una de las partes más instrumentadas del firmware, porque «cambié a modo Station y no pasó nada» es el tipo de fallo más difícil de diagnosticar en una estación sin cabeza. Cada ruta que lo atraviesa registra lo que hizo.

Modos Wi-Fi#

g_config.wifi_mode selecciona la configuración de interfaz, coincidiendo con la página Wireless. Los números almacenados son los selectores WIFI_MODE_CFG_* de main/include/app_config.h, que todos los consumidores usan por nombre:

  • 0 = WIFI_MODE_CFG_OFF

  • 1 = WIFI_MODE_CFG_STA (estación)

  • 2 = WIFI_MODE_CFG_AP (punto de acceso) — WIFI_MODE_CFG_DEFAULT, el valor de fábrica; el dispositivo siempre es accesible

  • 3 = WIFI_MODE_CFG_APSTA

wifi_init() levanta el SoftAP para WIFI_MODE_CFG_OFF y para cualquier valor por encima de WIFI_MODE_CFG_MAX, así que ningún valor almacenado puede dejar una estación sin cabeza sin una administración web desde la que corregirlo.

Se almacenan hasta cinco perfiles STA (WIFI_STA_NUM = 5), cada uno con su propia casilla Enable. La primera entrada habilitada con un SSID no vacío se empuja al controlador, y es la única que se usa en ese arranque: las ranuras son credenciales alternativas entre las que elegir, no una rotación por la que el firmware conmute.

Conexión de estación robusta#

Varias decisiones de diseño deliberadas hacen fiable la ruta de estación:

  • Conectar desde ``WIFI_EVENT_STA_START``, no de inmediato. esp_wifi_connect() solo es legal una vez que la interfaz de estación ha arrancado realmente, lo que el controlador señala con WIFI_EVENT_STA_START. Llamarlo justo tras esp_wifi_start() pierde esa carrera y devuelve ESP_ERR_WIFI_NOT_STARTED — sin asociación, sin evento de desconexión, sin reintento. La conexión se emite desde el manejador de STA_START y cada intento registra su resultado.

  • Intervalo de reconexión fijo, armado en un temporizador. Cada desconexión espera el mismo RECONNECT_INTERVAL_MS (5 s) antes del siguiente esp_wifi_connect(), armado en un esp_timer — no un vTaskDelay() dentro del manejador de eventos, que detendría el bucle de eventos compartido (incluido el propio STA_GOT_IP que espera) y, en un bucle de desconexión ajustado, mataría de hambre a la tarea idle hasta que saltara el watchdog de tareas.

  • Capacidad PMF anunciada. Un wifi_config_t a cero deja pmf_cfg.capable = false, y los AP WPA3 / WPA2-con-PMF-requerido simplemente rechazan tal estación. El firmware pone capable, no required, que funciona contra AP antiguos y nuevos.

  • Recurso a AP+STA. Solo-STA sin nada a lo que unirse dejaría el dispositivo inaccesible, así que recurre a AP+STA y lo dice — la administración web sigue arriba.

  • Volcados de diagnóstico. Si ninguna ranura STA está habilitada con un SSID, el firmware vuelca cada ranura y te dice cuál es el error («habilitada, pero el SSID está VACÍO» vs «tiene un SSID, pero “Enable” no está marcado»).

Los códigos de razón de desconexión se registran en lugar de descartarse:

Razón

Significado

15 (4WAY_HANDSHAKE_TIMEOUT), 204 (NOT_AUTHED)

contraseña equivocada

201 (NO_AP_FOUND)

SSID no visible: nombre equivocado, fuera de rango, o solo 5 GHz

2 / 8 / 200

roaming ordinario / caídas del lado del AP

La bandera de «¿tenemos internet?»#

net_state.c mantiene un único booleano que se vuelve verdadero solo con IP_EVENT_STA_GOT_IP y falso al desconectarse o en modo solo-AP. El IGate lo sondea y espera una IP real antes de intentar siquiera una conexión con APRS-IS — estar meramente asociado a un AP no basta.

Escaneo Wi-Fi#

El escaneo de la página Wireless conmuta temporalmente una radio solo-AP a AP+STA. Una bandera s_staEnabled condiciona cada esp_wifi_connect() automático para que el manejador de eventos no pelee con el escaneo.

Potencia TX#

La potencia TX (dBm) de la página Wireless se convierte ×4 a cuartos de dBm para esp_wifi_set_max_tx_power(). El driver rechaza todo lo que esté por debajo de 8 cuartos de dBm, así que el rango aceptado es WIFI_TX_POWER_DBM_MIN..``WIFI_TX_POWER_DBM_MAX`` (2-20 dBm, app_config.h) y no 0-20: un valor menor es rechazado y deja en vigencia la potencia anterior, lo que se lee como «potencia mínima» siendo en realidad «sin cambio». El valor se acota en el handler POST de Wireless y otra vez en config_from_json(), de modo que los límites del formulario son una comodidad y lo que realmente se aplica es el valor almacenado.

Sincronización horaria#

time_sync.c ejecuta SNTP contra tres hosts. Es una máquina de estados no bloqueante plegada en el tick de servicio de 1 Hz, y fija el reloj del sistema a UTC (TZ=UTC0) — las marcas de tiempo zulú de la especificación APRS lo requieren.

El mismo archivo lleva además una tabla incorporada de desfases UTC fijos (sin reglas de horario de verano), seleccionada por g_config.timezone_idx desde la sección Time de la página System. Es solo una comodidad de visualización: time_sync_format_local() suma el utc_offset_s de la entrada seleccionada al instante UTC y lee el resultado con gmtime_r(). La conversión es aritmética pura: no toma ningún cerrojo, no asigna memoria y nunca escribe la variable TZ del proceso, que se fija a UTC0 una sola vez durante la puesta en marcha de SNTP y no se vuelve a reescribir. Esto importa porque el panel consulta la fecha/hora representada una vez por segundo durante todo el tiempo que el equipo esté encendido. El reloj del sistema, todas las marcas de tiempo APRS y el resto de llamadas de formato horario del firmware (todas ellas con gmtime_r()) siguen en UTC con independencia de la selección.

Frecuencia de CPU#

cpu_freq.c aplica la selección de 80/160/240 MHz de la página System vía esp_pm_configure(), de modo que la selección cambia el reloj real y no solo se almacena y se muestra. Se aplica en el arranque y de nuevo en cada guardado, sin reiniciar.