Repository navigation
Releases
v0.1.1
Config bundle, no firmware binaries: build the firmware yourself with ESPHome, see Setup in the README. The zip holds the ESPHome config, the headers, secrets.example.yaml, docs and the addon board files (Gerber, pinout).
What's Changed
✨ New Features
- Complete release bundle, update minimum version, and enhance features by @Ajimaru in #2
- Add firmware version substitution and PMS sleep cycle by @Ajimaru in #3
New Contributors
Full Changelog: v0.1.0...v0.1.1
v0.1.0
Config bundle, no firmware binaries: build the firmware yourself with ESPHome, see Setup in the README. The zip holds the ESPHome config, the headers, secrets.example.yaml, docs and the addon board files (Gerber, pinout).
Highlights
Thresholds are no longer round numbers
Colour steps and alarm limits are anchored to published values instead of guesses: CO2 1000 / 1500 / 2000 /
3000 ppm (Umweltbundesamt, ASR A3.6), PM2.5 15 / 25 / 50 / 75 and PM10 45 / 50 / 75 / 100 µg/m³ (WHO 2021 and
the EU daily limit), formaldehyde 80 / 120 / 200 / 400 ppb (0.1 mg/m³, WHO indoor air guideline). TVOC keeps
trend bands because the sum parameter has no health-based limit. New colour steps for the dew point (10 / 12 /
16 °C) and the absolute humidity, the latter being a building-physics criterion for condensation on cold
surfaces rather than an exposure limit. Sources and reasoning: docs/thresholds.md.
The alarm only covers what has a limit
The buzzer sounds for CO2, PM2.5 and PM10, requires the condition to hold for five minutes and stays silent
unless "Buzzer Alarm" is switched on. CH2O and both eCO2 estimates never trigger it.
Pressure view: QNH and the 3-hour tendency
Enter your height above sea level once (web UI, "Height Above Sea Level") and the pressure view shows QNH — the
value weather reports quote — next to the three-hour pressure tendency in the WMO classes. The barometric
altitude estimate is gone: it needed a weather-dependent sea-level reference and drifted by up to 125 m.
Calibration and sensor work
- Formaldehyde: "CH2O Offset" plus a "Zero CH2O (fresh air)" button. The Winsen datasheet has neither an
accuracy figure nor a zero command, so the reading is relative by nature — the config and the docs say so. - LTR390: gain and resolution set to the datasheet operating points (X3 / 18-bit for ambient light, X18 /
20-bit for UV), plus a window correction factor for measurements behind glass. - SGP30: a baseline timer showing the time left in the 12-hour learning run.
- SCD40: forced recalibration button for fresh air, and pressure compensation taken from the BME680.
Display and filter
- The values page rotates its top row through five views; removing two redundant page clears cut the redraw
from 189-208 ms to 115-132 ms of blocked loop time. - Pages: values, info with alarm limits and controls, RAM/CPU, air and climate graphs for 1 h and 24 h, and a
QR code for the web UI. - Optional air filter control with per-step thresholds, hysteresis and a "Filter Thresholds Reset" button.
Fixes
- PMS5003: wake-up frames at boot plus a 5-minute watchdog, so a sensor that powers up asleep no longer leaves
the particulate block empty. - The top-row rotation pauses while another page is shown, so returning always starts with a full minute.
- Temperature value on the values page aligned to the column grid shared by the other views.
- Sensor names corrected, remaining German strings translated.
Docs
docs/thresholds.mdsplit out of the capability matrix: colour steps, alarm limits and filter control, each
with its source.- Sensor datasheets archived and the operating-range table completed.
Full Changelog: v0.0.1...v0.1.0
v0.0.1
Source release, no firmware binaries: build the firmware yourself with ESPHome, see
Setup in the README.
sensor-box-enhanced-*.zip: ESPHome config, headers,secrets.example.yaml, docs and hardware filesaddon-board-v0.2-gerber.zip: Gerber and drill files of the addon board v0.2 for orderingSHA256SUMS.txt: checksums of both zips
Full Changelog: https://github.com/Ajimaru/Sensor-Box-Enhanced/commits/v0.0.1