Guía de Instalación de CO2 Gadget: Web Installer, Binarios y Compilación

Instalar CO2 Gadget en tu placa ESP32 es un proceso de un solo clic gracias al instalador web basado en ESP Web Tools: compatible con Chrome, Edge y navegadores Chromium, sin instalar nada en tu ordenador. Aquí encontrarás los 13 modelos de placa soportados, los pasos de flasheado, la tabla de binarios y la guía para compilar desde código fuente.

Que version instalar

Hay dos versiones disponibles. Elige la que mejor se adapte a tus necesidades:

• Beta (recomendada): incluye las ultimas funcionalidades — BTHome v2, modo binario de bajo consumo, MQTT Discovery mejorado, graficos con exportacion CSV/JSON, calibracion web, screenshots via HTTP, y mas de 40 endpoints REST. La rama development se compila y publica en cada cambio. Si encuentras cualquier problema, reportalo en GitHub o en el grupo de Telegram.
• Release estable: version probada de hace aproximadamente dos anos (v0.14.006). Tiene sentido solo si necesitas maxima estabilidad para un despliegue critico y las funcionalidades nuevas no te aportan valor. Si tu uso es personal, domestico o educativo, la Beta es mejor opcion.

Instalacion version Beta (recomendada)

Pulsa INSTALAR en la fila correspondiente a tu placa. Conecta tu ESP32 por USB y selecciona el puerto cuando se abra el dialogo del navegador. En pocos segundos el firmware Beta estara grabado en tu dispositivo.

Primera vez? Marca “Erase device” en el instalador para borrar la configuracion previa (recomendado si vienes de otro firmware).

Instalacion version Release estable

Si prefieres la version estable, tambien puedes instalarla directamente desde el navegador. Mismo procedimiento: busca tu placa en la tabla, pulsa INSTALAR, conecta por USB y espera.

Sabor	Versión	Fecha	Instalar
TTGO_TDISPLAY_SANDWICH	v0.014.006	09-06-2024	INSTALAR
TTGO_TDISPLAY	v0.014.006	09-06-2024	INSTALAR
TDISPLAY_S3	v0.014.006	09-06-2024	INSTALAR
esp32dev_OLED	v0.014.006	09-06-2024	INSTALAR
esp32dev	v0.014.006	09-06-2024	INSTALAR
esp32dev_ST7789_240x320	v0.014.006	09-06-2024	INSTALAR
ttgo-t5-EINKBOARDGDEM0213B74	v0.014.006	09-06-2024	INSTALAR
ttgo-t5-EINKBOARDDEPG0213BN	v0.014.006	09-06-2024	INSTALAR
ttgo-t5-EINKBOARDGDEW0213M21	v0.014.006	09-06-2024	INSTALAR
ttgo-t7-EINKBOARDGDEM029T94	v0.014.006	09-06-2024	INSTALAR
ttgo-t7-WEACT_GDEH0154D67	v0.014.006	09-06-2024	INSTALAR
ttgo-t7-WEACT_DEPG0213BN	v0.014.006	09-06-2024	INSTALAR
ttgo-t7-WEACT_GxEPD2_290_BS	v0.014.006	09-06-2024	INSTALAR

Elije el sabor que quieres instalar y sigue las instrucciones.

• TTGO_TDISPLAY_SANDWICH: Placa TTGO T-Display con sensor I2C en pines alternativos (SDA en 21 y SCD en 22)
• TTGO_TDISPLAY: Placa TTGO T-Display con sensor I2C en pines normales (SDA en 21 y SCD en 22)
• TDISPLAY_S3: Placa T-Display S3 con sensor I2C en pines normales (SDA en 42 y SCD en 43). Pronto disponible.
• esp32dev_OLED: Placa ESP32 genérica con display OLED (SH1106 de 128X64)
• esp32dev: Placa ESP32 genérica sin display
• esp32dev_ST7789_240x320: Placa genérica con display TFT de 240×320 y controlador ST7789
• ttgo-t5-EINKBOARDGDEM0213B74: Lilygo TTGO T5 con display e-Ink con panel GDEM0213B74
• ttgo-t5-EINKBOARDDEPG0213BN: Lilygo TTGO T5 con display e-Ink con panel DEPG0213BN
• ttgo-t5-EINKBOARDGDEW0213M21: Lilygo TTGO T5 con display e-Ink con panel GDEW0213M21
• ttgo-t7-EINKBOARDGDEM029T94: Placa ESP32 genérica con display e-Ink GDEM029T94
• ttgo-t7-WEACT_GDEH0154D67: Placa ESP32 genérica con display e-Ink WeAct Studio GDEH0154D67
• ttgo-t7-WEACT_DEPG0213BN: Placa ESP32 genérica con display e-Ink WeAct Studio DEPG0213BN
• ttgo-t7-WEACT_GxEPD2_290_BS: Placa ESP32 genérica con display e-Ink WeAct Studio GDEM029T94 BS

Opcional, borrar la memoria:

Al grabar tienes la opción de seleccionar “Erase device”, lo que borrará primero la memoria del ESP32 y restablecerá todas las configuraciones. Recomendado al grabar CO2-Gadget por primera vez.

Esta version no incluye BTHome, modo binario de bajo consumo, ni las ultimas mejoras de MQTT.

Descarga de binarios

Todos los binarios estan disponibles en GitHub Releases. Descarga el archivo correspondiente a tu placa y grabarlo con cualquier herramienta compatible con ESP32.

Compilacion desde codigo

Para desarrolladores: clona el repositorio, instala PlatformIO y compila para tu placa:

git clone https://github.com/melkati/CO2-Gadget.git
cd CO2-Gadget
pio run -e TTGO_TDISPLAY --target upload

Modelos de placa

CO2 Gadget soporta 13 placas diferentes. Las mas populares son:

• TTGO_TDISPLAY — TFT 240×135, la mas usada
• TDISPLAY_S3 — ESP32-S3 con TFT 320×170
• esp32dev_OLED — Placa generica con OLED
• esp32dev — Sin pantalla, headless
• ttgo-t5-* — E-Ink 2.13
• ttgo-t7-* — E-Ink 2.9 y 1.54

Primer arranque

Al encender por primera vez, BLE esta activo y WiFi apagado. Usa la app MyAmbiance para configurar el WiFi o conectate al portal cautivo. Todos los ajustes por defecto estan optimizados para que el medidor funcione nada mas encenderlo.

Notas

• Usa un buen cable USB: los cables de carga no siempre transmiten datos
• Si tienes problemas de conexion, prueba con Erase device antes de flashear
• Arduino IDE no esta soportado oficialmente: usa PlatformIO
• Tras flashear, espera 30 segundos antes de desconectar el USB

Te ha sido util? Comparte este articulo. Tambien consulta la Guía del Menú. Tienes dudas? Pregunta en el grupo de Telegram.