Skip to content

Conversation

@burmistrzak
Copy link
Contributor

This is a follow-up to a discussion started at #11204 (comment).

To avoid further confusion about capabilities, renaming co2 to eco2 seems to be an appropriate step. This should prevent ecosystems from misrepresenting sensor readings.

@Koenkk Koenkk merged commit bc6eb3e into Koenkk:master Jan 29, 2026
3 checks passed
@Koenkk
Copy link
Owner

Koenkk commented Jan 29, 2026

Thanks!

@mf19862
Copy link

mf19862 commented Feb 1, 2026

I'm totally confused now. Where is the Co² data now? It is just gone. And the VOC data is now "ppm" it should be "ug/m³". This change totally messed up my setup and data

@burmistrzak
Copy link
Contributor Author

@mf19862 Everything as intended. Let me explain really quick:

  1. Devices like the Twinguard are not CO2 sensors. The BME680 inside doesn't detect CO2. It measures TVOC and derives a CO2-equivalent (eCO2) value for presentation using a proprietary algorithm.
  2. According to Bosch Sensortec, the BME680 expresses relative change in TVOC in ppm. It therefore cannot measure the absolute concentration of TVOC in ug/m³.
  3. eCO2 is a TVOC value, thus the change in device_class

I know it takes some time to getting used to, but at least it's correct now. 😅

@mf19862
Copy link

mf19862 commented Feb 1, 2026

@burmistrzak Thank you for your detailed reply! This does clarify most of it. But there was an additional sensor "CO2" before, which is now removed. Where did this sensor come from?
The entity "CO2" did output a different value than "AQI" and "TVOC" but it was changing relatively.

@burmistrzak
Copy link
Contributor Author

@mf19862 Well... We made it up (kinda).

Long story short: Before, we used a non-linear formula to calculate a sensible CO2 value from raw IAQ, but switched back to the default formula (likely also used by the Bosch SHC) because the sensor's raw IAQ output was not behaving as described in the BME680 data sheet.

Bosch is probably doing some sort of pre-processing in firmware before sending out the IAQ value via Zigbee.

Hope that makes sense. 🤞

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants