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 versión 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, gráficos con exportación CSV/JSON, calibración web, screenshots vía HTTP, y más de 40 endpoints REST. La rama
developmentse compila y publica en cada cambio. Si encuentras cualquier problema, reportalo en GitHub o en el grupo de Telegram. - Release estable: versión probada de hace aproximadamente dos anos (
v0.14.006). Tiene sentido solo si necesitas máxima estabilidad para un despliegue crítico y las funcionalidades nuevas no te aportan valor. Si tu uso es personal, doméstico o educativo, la Beta es mejor opción.
Instalación versión Beta (recomendada)
Pulsa INSTALAR en la fila correspondiente a tu placa. Conecta tu ESP32 por USB y selecciona el puerto cuando se abra el diálogo del navegador. En pocos segundos el firmware Beta estará grabado en tu dispositivo.
| Sabor | Versión | Fecha | Instalar |
|---|---|---|---|
| TTGO_TDISPLAY_SANDWICH | 0.16.031-beta | 26-10-2026 | |
| TTGO_TDISPLAY | 0.16.031-beta | 26-10-2026 | |
| TDISPLAY_S3 | 0.16.031-beta | 26-10-2026 | |
| esp32dev_OLED | 0.16.031-beta | 26-10-2026 | |
| esp32dev | 0.16.031-beta | 26-10-2026 | |
| esp32dev_ST7789_240x320 | 0.16.031-beta | 26-10-2026 | |
| ttgo-t5-EINKBOARDGDEM0213B74 | 0.16.031-beta | 26-10-2026 | |
| ttgo-t5-EINKBOARDDEPG0213BN | 0.16.031-beta | 26-10-2026 | |
| ttgo-t5-EINKBOARDGDEW0213M21 | 0.16.031-beta | 26-10-2026 | |
| ttgo-t7-EINKBOARDGDEM029T94 | 0.16.031-beta | 26-10-2026 | |
| ttgo-t7-WEACT_GDEH0154D67 | 0.16.031-beta | 26-10-2026 | |
| ttgo-t7-WEACT_DEPG0213BN | 0.16.031-beta | 26-10-2026 | |
| ttgo-t7-WEACT_GxEPD2_290_BS | 0.16.031-beta | 26-10-2026 |
Primera vez? Marca “Erase device” en el instalador para borrar la configuración previa (recomendado si vienes de otro firmware).
Instalación versión Release estable
Si prefieres la versión estable, también 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 | |
| TTGO_TDISPLAY | v0.014.006 | 09-06-2024 | |
| TDISPLAY_S3 | v0.014.006 | 09-06-2024 | |
| esp32dev_OLED | v0.014.006 | 09-06-2024 | |
| esp32dev | v0.014.006 | 09-06-2024 | |
| esp32dev_ST7789_240x320 | v0.014.006 | 09-06-2024 | |
| ttgo-t5-EINKBOARDGDEM0213B74 | v0.014.006 | 09-06-2024 | |
| ttgo-t5-EINKBOARDDEPG0213BN | v0.014.006 | 09-06-2024 | |
| ttgo-t5-EINKBOARDGDEW0213M21 | v0.014.006 | 09-06-2024 | |
| ttgo-t7-EINKBOARDGDEM029T94 | v0.014.006 | 09-06-2024 | |
| ttgo-t7-WEACT_GDEH0154D67 | v0.014.006 | 09-06-2024 | |
| ttgo-t7-WEACT_DEPG0213BN | v0.014.006 | 09-06-2024 | |
| ttgo-t7-WEACT_GxEPD2_290_BS | v0.014.006 | 09-06-2024 |
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 versión no incluye BTHome, modo binario de bajo consumo, ni las ultimas mejoras de MQTT.
Descarga de binarios
Todos los binarios están disponibles en GitHub Releases. Descarga el archivo correspondiente a tu placa y grabarlo con cualquier herramienta compatible con ESP32.
Compilación desde código
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 uploadModelos de placa
CO2 Gadget soporta 13 placas diferentes. Las más populares son:
- TTGO_TDISPLAY — TFT 240×135, la más usada
- TDISPLAY_S3 — ESP32-S3 con TFT 320×170
- esp32dev_OLED — Placa genérica 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 está activo y WiFi apagado. Usa la app MyAmbiance para configurar el WiFi o conéctate al portal cautivo. Todos los ajustes por defecto están optimizados para que el medidor funcione nada más encenderlo.
Notas
- Usa un buen cable USB: los cables de carga no siempre transmiten datos
- Si tienes problemas de conexión, prueba con Erase device antes de flashear
- Arduino IDE no está soportado oficialmente: usa PlatformIO
- Tras flashear, espera 30 segundos antes de desconectar el USB
Te ha sido útil? Comparte este artículo. También consulta la Guía del Menú. Tienes dudas? Pregunta en el grupo de Telegram.
Hey,
first of all thanks for your update and the effort during the last years!!
Just wanted to inform you, that following package ist broken withe the error:
“Downloading firmware https://emariete.com/wp-content/uploads/firmware/CO2-Gadget/beta/CO2-Gadget-ttgo-t5-EINKBOARDDEPG0213BN-0.16.014-bootloader.bin failed: 404″
Would be great if can be fixed.
Thanks in advance and best regards
Michael
Hi.
I’m sorry for the inconvenience.
Please, can you try again?
Hi Michael, thanks for the report and sorry for the long wait.
The 404 was not on your side: the beta binaries were being served from a location that had started returning “not found”, so the installer could not download them. We’ve moved all firmware binaries to a new, reliable host and published a fresh beta, v0.16.031-beta.
Please open the installation guide again, do a hard refresh (Ctrl+F5 / Cmd+Shift+R) so the page loads the updated version table, and press INSTALL on the ttgo-t5-EINKBOARDDEPG0213BN row. It should now download the four files and flash normally. Coming from an older firmware, ticking “Erase device” first is recommended.
If anything still fails, tell me and I’ll look into it. Thanks for your patience!
Hi, Thanks for your continuing efforts to update the CO2 gadget!
I tried to instal the latest beta firmware however i get a 404 error. The stable firmware is no problem but i can not download CO2-Gadget-esp32dev-0.16.014-bootloader.bin, could you please fix this? Thanks!
Hi.
I’m sorry for the inconvenience.
Please, can you try again?
Hi Cadster, thanks for reporting and sorry it took so long.
You were right: the beta binaries’ download URLs were returning 404, while the stable ones worked. We’ve moved the beta firmware to a new host and published v0.16.031-beta, so the beta table now points to files that actually exist.
Please reload the installation guide with a hard refresh (Ctrl+F5 / Cmd+Shift+R) and press INSTALL on the esp32dev row. The installer should fetch all four parts and flash without errors. If you’re upgrading, “Erase device” is recommended.
Let me know if it works for you now. Thanks!
Hello! Thank you for all your efforts with the CO₂ gadget! , I am sorry to bother you, but I am getting the same error as described in previous comments – I tried to install the latest beta firmware, but I’m getting a 404 error. The stable firmware works fine, but I can’t download CO2-Gadget-esp32dev-0.16.014-bootloader.bin. Is it possible to sort it out? Thank you!
Hi!
Thank you for reporting this, and for your kind words about the CO₂ Gadget.
I’m sorry for the inconvenience. It looks like there is indeed an issue with the download of the latest beta firmware. I’ll investigate it and try to fix it over the weekend.
In the meantime, if the stable firmware is working correctly for you, I recommend continuing to use that version until the beta download issue is resolved.
Thanks again for letting me know, and for your patience and support! 😊
Best regards,
Mariete
Hi Snekounec, thanks for flagging this again and sorry for the wait — you caught it right before the fix landed.
The cause was the same 404 on the beta binary URLs that other users reported. The beta firmware is now hosted in a new, stable location and we’ve published v0.16.031-beta, so the download links are valid again.
Please do a hard refresh of the installation guide (Ctrl+F5 / Cmd+Shift+R) and press INSTALL on the esp32dev row. It should download and flash normally now. Using “Erase device” is recommended when flashing from a different version.
If you still hit any error, let me know. Thanks for your patience and for the kind words!