Si tienes Home Assistant, esta guía te va a encantar. CO₂ Gadget se integra con MQTT de una forma que no he visto en ningún otro firmware para ESP32: no solo publica datos, sino que se autoconfigura en Home Assistant gracias al Discovery, y puedes enviarle comandos para calibrar o ajustar la configuración.
Lo mejor es que no necesitas servicios cloud ni nada externo: todo funciona en tu red local, con la privacidad y el control que eso supone.
Configuración básica de MQTT
Para usar MQTT necesitas tener el WiFi activado. Puedes configurar MQTT desde el menú del medidor, desde la página web o desde la App MyAmbiance.
| Parámetro | Descripción |
|---|---|
| MQTT Enable | Activa o desactiva MQTT (ON / OFF) |
| Topic | Raíz de los topics donde se publicarán los datos |
| Client ID | Identificador único del dispositivo en el broker |
| Broker IP | Dirección IP de tu broker MQTT (Mosquitto, etc.) |
| User / Pass | Autenticación con el broker (opcional) |
Puedes acceder a la configuración desde la página web: http://ip_del_medidor/preferences.html, o desde el menú en pantalla: Configuración → MQTT Config.
Topics que publica tu medidor de CO₂
Una vez conectado al broker, CO₂ Gadget publica las mediciones en los siguientes topics (usando el topic raíz que hayas configurado):
| Topic | Valor | Descripción |
|---|---|---|
topic/co2 | 892 | CO₂ en ppm |
topic/temp | 24.50 | Temperatura en °C |
topic/humi | 45.20 | Humedad relativa en % |
topic/battery | 4100 | Voltaje de batería en mV |
topic/pm1 | 5 | PM1.0 (µg/m³) si hay sensor |
topic/pm25 | 12 | PM2.5 (µg/m³) si hay sensor |
topic/pm4 | 8 | PM4.0 (µg/m³) si hay sensor |
topic/pm10 | 15 | PM10 (µg/m³) si hay sensor |
Topics de alarmas
CO₂ Gadget también publica mensajes cuando se alcanzan los niveles de concentración configurados. Los mensajes tienen histéresis de 100 ppm para evitar oscilaciones:
| Topic | Payload ON | Payload OFF |
|---|---|---|
topic/green | Nivel normal | Se supera el nivel naranja |
topic/orange | Alarma naranja | Baja con histéresis |
topic/red | Alarma roja | Baja con histéresis |
Home Assistant Discovery automático
Si activas MQTT Discovery, CO2 Gadget se autoconfigura en Home Assistant sin que tengas que tocar nada. Home Assistant descubrirá automáticamente tu medidor y creará todas las entidades necesarias: sensores de CO₂, temperatura, humedad, batería, partículas PM y alarmas. Compatible también con OpenHAB y HomeSeer.
Comandos remotos por MQTT
Además de publicar datos, puedes controlar tu medidor de forma remota:
| Topic | Payload | Función |
|---|---|---|
topic/calibration | 400 | Calibración forzada (400-2000 ppm) |
topic/ambientpressure | 1013 | Compensación por presión (mbar) |
ThresholdManager: publicaciones inteligentes
El sistema de umbrales inteligentes evita publicar datos innecesarios cuando las lecturas no cambian significativamente. Configurable desde la página /low_power.html. Ideal para ahorrar batería y reducir el ancho de banda en el broker.
Solución de problemas
| Problema | Solución |
|---|---|
| No conecta al broker | Verifica IP del broker y WiFi activado |
| No hay datos en HA | Revisa que el topic raíz coincida |
| Discovery no funciona | Activa MQTT Discovery en configuración |
| No se actualizan valores | Revisa los umbrales del ThresholdManager |
Notas importantes
- MQTT necesita WiFi activado
- En LOW_POWER la frecuencia depende de los ciclos de wake
- Sin servicios cloud — todo en tu red local
- CO2 Gadget ofrece integración MQTT más completa que la mayoría de medidores comerciales