Migration from CO2 Easy to CO2 Gadget

If you have a meter running the old firmware CO2 Easy, you’re in luck: migrate to CO2 Gadget It’s very simple. Your sensors and wiring remain the same. You just need to flash the new firmware.

Documentation is currently being updated. We are currently reviewing and improving all our pages. You may come across a broken link or some content that hasn’t been finalised yet. If you spot anything that isn’t quite right, please help us fix it at GitHub.

CO2 Gadget is the natural evolution of CO2 Easy. It retains everything you loved about the original, but adds features with notable practical improvements:

FunctionCO2 EasyCO2 Gadget
Web interfaceBasicApple design, dark mode, responsive
ScreensOLEDColour TFT, OLED and E-Ink
ProtocolsWi-Fi + BLEWi-Fi, BLE, MQTT, ESP-NOW
Home AssistantNoAutomatic discovery
CO₂ sensors2 families5+ families (SCD30/40/41, MH-Z19, CM1106, S8)
PM sensorsNoSPS30, SN-GCJA5, Plantower, IKEA
Low consumptionNoUp to 3 months’ battery life
UpdatesManualsOnline travel agency (OTA)
REST API3 endpoints40+ endpoints

Compatibility: you’ll need an ESP32

CO2 Gadget has been developed for ESP32, which is the microcontroller used by most of the supported boards (Wemos LOLIN D32, TTGO T-Display, TTGO T5, LilyGo T-Display S3, etc.).

If your CO2 Easy is installed on an ESP32, the upgrade is straightforward: you simply need to flash CO2 Gadget onto the same board, without changing any hardware. The sensors and wiring remain exactly as they were.

If your CO2 Easy was installed in a ESP8266 (NodeMCU, Wemos D1 mini, etc.), migration is not possible as it stands: CO2 Gadget requires an ESP32 due to memory, Bluetooth Low Energy and processing power requirements. The good news is that compatible ESP32 boards are very affordable (from around €5) and the sensors you already have (MH-Z19, Senseair S8, SCD30, etc.) are fully compatible: you simply need to move them over to the new board. You get to keep your investment in sensors and cabling, which is the most important part of the project.

How to migrate from CO2 Easy to CO2 Gadget

The following steps apply to ESP32 boards. If you are coming from an ESP8266, first replace the board with an ESP32 whilst keeping the sensors and wiring in place, and then follow these steps.

  1. Download CO2 Gadget — Go to the CO2 Gadget homepage and click INSTALL on your motherboard.
  2. Connect your circuit board — Use a USB data cable (a charging-only cable won’t work).
  3. Select «Erase device» — Before flashing, tick this box to delete the previous CO2 Easy settings.
  4. Flashea — Tap INSTALL and select the USB port.
  5. Configure — After the first start-up, configure the Wi-Fi and sensors via the menu or the WiFi Guide.

What tinned food do you have?

  • Your CO₂ sensors (MH-Z19, Senseair S8, SCD30, etc.)
  • Your wiring and connections
  • Your ESP32 board
  • Your 3D-printed box

I can't wait

  • Web interface with Apple-style design, dark mode and responsive layout
  • MQTT with Home Assistant automatic discovery
  • MyAmbiance app for iOS and Android
  • Low power consumption: up to 3 months on a single charge
  • Web-based OTA updates
  • Comprehensive REST API (40+ endpoints)
  • Support for particulate matter (PM) sensors
  • Open source (GPLv3)

Any questions? Join the Telegram group or open a issue on GitHub.

Leave a comment