Welcome to CO2nsole, open-source project aimed at providing an workstation climate device that measures CO2 levels and all the other microclimate information in a private, open and efficient way. This repository contains all the resources necessary to build the CO2nsole device, as well as a CLI library for a Text-based User Interface (TUI) library, making it highly embeddable into other projects or targets.

Device	Software

• DIY Build Guide: Step-by-step instructions to build your own CO2nsole device.
• CLI for TUI: Intuitive command-line interface to interact with the device via a text-based user interface.
• Embeddable Solutions: Flexible design for integrating CO2nsole functionality into different target environments.
• Real-Time Monitoring: Monitor CO2 levels in real-time with accurate and responsive readings.
• Open-Source: Freedom to modify, enhance, and distribute the application as you need.

You can have 2 versions of the CO2nsole device: with or without a battery. The required minimum components for the basic no-battery versions are:

Sensor	Description
	The ESP32 is a versatile microcontroller featuring dual-core CPUs and built-in Wi-Fi and Bluetooth capabilities, having enough power to maintain all the sensors work and the BLE and Network based syncing.
	The MH-Z19 is a carbon dioxide sensor that measures CO2 levels in the air using non-dispersive infrared (NDIR) technology, ideal for indoor air quality monitoring.
	The CCS811 is a combination of temperature, humudity, and an air quality sensor capable of detecting volatile organic compounds (VOCs) and CO2.
	The BH1750 is a digital light intensity sensor that provides measurements in lux.

Checkout the following sketch and connect everything as shown in this sketch:

For the initial build (no battery) you can connect the 5v directly the the esp32 5v pin.

Make sure that css811 and bh1750 share the same I2C bus (GPIO21/22). While the MH-Z19 is connected to the 1 hardware UART port of the ESP32 (GPIO 16/17).

Make sure that it is required to install PlatformIO on your computer. You can follow the instructions in the official documentation to install it.

Flashing the firmware is as simple as

cd core
pio run -t upload
pio device monitor

If everything works correctly your device will start printing out the measurements in the serial monitor.

You can build and run the CLI using rust toolchain by running the following commands:

cd cli
cargo run --release

Build and link the binary to your path using

cd cli
sh link.sh
# this binary will be located in /usr/local/bin and will be available globally
co2

This may be needed to implement custom trend reactions for the APP. Checkout the ./cli/src/reactions.rs file for an example and documentation on custom reactions.

Or it is also possible to install the CLI using cargo:

cargo install --locked co2nsole

You can calibrate both CO2 and temperature level.

• To perform CO2 calibration (you should do it on the very start): get the sensor out to the fresh air for 20 minutes and send the calibration command
• Temperature calibration is used using software by entering the current temperature (can be checked on other termostat)

It is required to run Bluetooth for your terminal emulator. You can do this by going to System Preferences -> Security & Privacy -> Privacy -> Bluetooth and checking your terminal emulator.

For better stability, it is recommended to install the battery as the CO2 sensor is designed to be always on for better calibration and more stable results. Any 18650 batter will work fine, I used a very old one from Olympus camera.

Here is a a schema of the battery connection:

Note On the AILAVI 0503V3 you can change the controlling register for higher charging current. I recommend to change it to the 135KOhm for the charging current of 1A.