El WiFi es el cerebro de CO₂ Gadget. Sin él no hay página web, ni MQTT, ni Home Assistant, ni actualizaciones OTA. Por eso he querido dedicarle una guía completa, para que saques el máximo partido a la conexión de tu medidor.
Configurar el WiFi es sorprendentemente fácil: puedes hacerlo desde el móvil con la app MyAmbiance, desde el portal cautivo al encenderlo por primera vez, o desde el menú si tu medidor tiene pantalla. Y una vez conectado, se abre un mundo de posibilidades.
En esta guía te explico todo lo que necesitas saber para configurar y aprovechar al máximo el WiFi de tu CO₂ 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ámetro | Valor |
|---|---|
| WiFi | OFF |
| Hostname | CO2-Gadget |
| DHCP | Activado (IP automática) |
| mDNS | Activado |
| Portal Cautivo | Activado (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)
- Instala Sensirion MyAmbiance (iOS / Android) — es gratuita
- Abre la app y busca tu dispositivo (
CO2-Gadget) - Ve a Settings → WiFi Configuration
- Introduce tu SSID y contraseña
- 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://ip_del_medidor/preferences.html
Interfaz Web de tu medidor de CO₂
Una vez conectado, abre http://CO₂-Gadget.local en cualquier navegador. La interfaz web de CO₂ 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ágina | URL | Descripció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
CO₂ Gadget implementa mDNS: accede a tu medidor por su nombre de host, sin tener que averiguar su IP: http://CO₂-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ámetrosIP 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
| Problema | Solución |
|---|---|
| No conecta a la WiFi | Verifica SSID y contraseña (máx. 63 caracteres) |
| Se desconecta aleatoriamente | Señal débil, acerca el router o usa un repetidor |
| No funciona .local | mDNS bloqueado en tu red, usa la IP directamente |
| Portal cautivo no carga en iOS | Abre 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