Environment Sensors

ESPGeiger can read temperature, humidity, and atmospheric pressure from a cheap I2C sensor on the same bus as the OLED. Detection is automatic at boot. Add a sensor and the values appear on /status and relevant outputs.

For wiring, pins, and per-output details see the Environment sensor configuration page.

Which one to buy

Module What you get Notes
AHT20 + BMP280 combo T + H + P Two chips on one board (AHT20 at 0x38, BMP280 at 0x76). The cheapest way to get all three readings. Often sold as a “BME280 replacement”.
BME280 T + H + P Single-chip Bosch part, ±0.3 °C and ±3 % RH. Buy from a seller you trust — BMP280s (no humidity) are routinely re-labelled as BME280 because the chip packages look almost identical.

Either is fine for ESPGeiger’s purposes — the combo board is usually cheaper and ships in a day.

The BMP280-pretending-to-be-BME280 trap

If you bought a “BME280” and the humidity row is missing on /status, you almost certainly got a BMP280. Check the actual chip name in /info; the firmware reports what it found. There’s no firmware workaround — the chip physically doesn’t have a humidity sensor. Either return it or accept temperature + pressure only.

AHT-only modules

Bare AHT10/15/20/21/25/30 modules (no BMP280) work too — you get temperature and humidity but no pressure. Worth it only if you already have one in a drawer.

Connection

Four pins: VCC (3.3 V), GND, SDA, SCL. Shares the I2C bus with the OLED if one is fitted. Default pins per platform are listed on the configuration page.


This site uses Just the Docs, a documentation theme for Jekyll.