Implement improved AQ calculation

Implements an AQ calculation from [1], which should hopefully provide a
more stable, sensible value for the air quality.

This also adds a configurable gas ceiling level, needed for full
calibration and explained in the README.

[1] https://github.com/thstielow/raspi-bme680-iaq

The human text ratings are still a work-in-progress.
This commit is contained in:
Joshua Boniface
2024-06-11 01:12:29 -04:00
parent c324689b19
commit 3088a6393b
2 changed files with 58 additions and 19 deletions

View File

@ -29,7 +29,7 @@ Note: Once programmed, the output LED will flash continuously until connected
to HomeAssistant, and a bit longer to establish if the wake word
functionality is enabled. This is by design, so you know if your sensors
are connected or not. If you do not want this, comment out the
`light.turn_on` block starting on line 54 of the ESPHome configuration
`light.turn_on` block starting on line 38 of the ESPHome configuration
to disable this functionality.
For more details, please [see my blog post on the SuperSensor project](https://www.boniface.me/the-supersensor/).
@ -59,6 +59,21 @@ The SuperSensor's voice functionality can be completely disabled if voice
support is not desired. This defeats most of the point of the SuperSensor,
but can be done if desired.
### Gas Ceiling
The AQ (air quality) calculation from the BME680 requires a "maximum"/ceiling
threshold for the gas resistance value in clean air after some operation
time. The value defaults to 200,000 to provide an initial baseline, but
should be calibrated manually by:
1. Turning on the Supersensor in a known-clean environment (e.g. a sealed
container in fresh air).
2. Leave the sensor on for 4-6 hours to burn in the sensor.
3. Setting this to the maximum value of the Gas Resistance sensor.
This value will then define what "100% air quality" represents, and the
Supersensor can then be moved to its normal operating location.
### Light Threshold Control
The SuperSensor features a "light presence" binary sensor based on the light