Guía WiFi de CO2 Gadget: Conexión, Página Web y API

Modificado por última vez hace 5 días

Configurar el WiFi de tu medidor CO2 Gadget es el primer paso para acceder a la interfaz web, la API REST y las actualizaciones OTA desde el navegador. En esta guía aprenderás las 4 formas disponibles: app Sensirion MyAmbiance, portal cautivo, menú serie y página de preferencias.

Documentacion en actualizacion. Estamos revisando y mejorando todas las paginas. Es posible que encuentres algun enlace roto o contenido pendiente. Si ves algo que falla, ayudanos a arreglarlo en GitHub.

El WiFi es el centro de comunicaciones de CO2 Gadget. A través de él puedes acceder a la interfaz web desde cualquier navegador, utilizar MQTT para enviar datos a Home Assistant, recibir comandos remotos, hacer actualizaciones OTA y consumir la API REST para integrar tu medidor de CO₂ con otros sistemas domóticos. Todo ello sin depender de servicios cloud de terceros, algo que muy pocos medidores comerciales ofrecen.

Aquí tienes todo lo necesario para configurar el WiFi de tu CO2 Gadget.

Configuración WiFi por defecto

Nada más flashear CO2 Gadget por primera vez, el WiFi viene desactivado. El BLE (Bluetooth Low Energy) sí está activo, lo que te permite configurar el WiFi desde la App Sensirion MyAmbiance sin necesidad de botones ni pantalla. Así de sencillo es tener un medidor de CO₂ de alta calidad funcionando en minutos.

ParámetroValor
WiFiOFF
Hostname`CO2-Gadget`
DHCPActivado (IP automática)
mDNSActivado
Portal CautivoActivado (si no hay WiFi configurado)

Cómo conectar tu medidor de CO₂ a la WiFi

Tienes 4 formas de conectar tu medidor de CO₂ con CO2 Gadget a la red WiFi, elige la que más te convenga:

1. Desde la App MyAmbiance (recomendada)

  1. Instala Sensirion MyAmbiance (iOS / Android) — es gratuita
  2. Abre la app y busca tu dispositivo (`CO2-Gadget`)
  3. Ve a Settings → WiFi Configuration
  4. Introduce tu SSID y contraseña
  5. El medidor se conecta automáticamente

2. Portal Cautivo (sin App, sin botones)

Si tu medidor no tiene WiFi configurado, al encenderlo por primera vez emite su propia red. Conéctate a ella, se abrirá automáticamente el portal cautivo y podrás introducir los datos de tu red. En iOS, si el portal no carga, abre Safari y ve a http://192.168.4.1.

3. Menú en pantalla o por puerto serie

Desde el menú: Configuración → WIFI Config → WiFi Enable [ON]. Introduce SSID, contraseña y hostname. Guarda con Save Preferences.

4. Página web de preferencias

Si ya está conectado, puedes cambiar de red desde http://ipdelmedidor/preferences.html

Interfaz Web de tu medidor de CO₂

Una vez conectado, abre http://CO2-Gadget.local en cualquier navegador. La interfaz web de CO2 Gadget tiene un diseño Apple con modo oscuro/claro automático, algo que no verás en ningún medidor comercial de precio similar.

PáginaURLDescripción
Inicio`/`Dashboard CO₂, temperatura y humedad
Gráficas`/charts.html`Históricos con Chart.js, exportación CSV/JSON
Calibración`/calibration.html`Calibración forzada FRC en vivo
Low Power`/low_power.html`Configuración de umbrales de bajo consumo
Preferencias`/preferences.html`Todos los ajustes del dispositivo
Estado`/status.html`Versión, RSSI, uptime y estado
OTA`/update`Actualización de firmware por web

mDNS: acceso por nombre

CO2 Gadget implementa mDNS: accede a tu medidor por su nombre de host, sin tener que averiguar su IP: http://CO2-Gadget.local. Configurable en Configuración → WIFI Config → Host.

API REST para integración profesional

CO2 Gadget expone una API REST completa para integrar tu medidor de CO₂ de alta calidad con Home Assistant, Node-RED, Grafana y cualquier otro sistema. Los medidores comerciales raramente ofrecen una API tan completa y documentada.

GET /readCO2           → 892 (ppm)
GET /readTemperature    → 24.5 (°C)
GET /readHumidity       → 45.2 (%)
GET /status             → JSON completo del sistema
GET /settings?Param=Val → Cambiar cualquier ajuste
POST /savePreferences   → Guardar múltiples parámetros

IP Fija para tu medidor

Configura una IP estática desde /preferences.html → activa Use Static IP e introduce IP, máscara, puerta de enlace y DNS. Ideal para integraciones con Home Assistant.

Seguridad

Los campos de contraseña están deshabilitados por defecto porque viajan en texto plano. Añade ?relaxedSecurity=true a la URL para habilitarlos. En compilación, activa WIFI_PRIVACY para ocultar contraseñas por el puerto serie.

Solución de problemas WiFi

ProblemaSolución
No conecta a la WiFiVerifica SSID y contraseña (máx. 63 caracteres)
Se desconecta aleatoriamenteSeñal débil, acerca el router o usa un repetidor
No funciona .localmDNS bloqueado en tu red, usa la IP directamente
Portal cautivo no carga en iOSAbre Safari y teclea http://192.168.4.1

Notas importantes

  • El WiFi se activa/desactiva sin reiniciar el medidor
  • En modo LOW_POWER el WiFi se conecta solo cada N ciclos para ahorrar batería
  • CO2 Gadget solo soporta redes de 2.4 GHz (el ESP32 no soporta 5 GHz)
  • Para usar MQTT o Home Assistant necesitas WiFi activado
  • Un medidor con CO2 Gadget ofrece más funcionalidades que la mayoría de medidores comerciales multiplicando por varios su precio

| No veo cambios tras configurar | No has guardado | Ve a Save Preferences en el menú o espera al siguiente ciclo | | La web se ve extraña | Caché del navegador | Borra caché o usa una ventana de incógnito |

Notas importantes

  • El WiFi se puede activar/desactivar sin reiniciar el medidor desde el menú o la web
  • En modo LOW_POWER, el WiFi se conecta solo cada N ciclos de wake (configurable) para ahorrar batería
  • Si usas MQTT, necesitas WiFi activado
  • CO2 Gadget soporta redes de 2.4 GHz (el ESP32 no soporta 5 GHz)

¿Tambien consulta la Guía del Menú. Tienes dudas? Pregunta en el grupo de Telegram o abre un issue en GitHub.

Deja un comentario