Bosch BME280 temperature, humidity & pressure I2C to the cloud with an ESP32

Bosch Sensortec·Environment sensors·I²CDatasheet-derived

The standard three-in-one environmental sensor, read by the gateway's built-in BME280 driver — no register map to enter. Temperature in °C, relative humidity in %, and barometric pressure in hPa.

The Synacl ESP32 gateway reads the Bosch BME280 temperature, humidity & pressure over I²C. This catalog entry carries the register map, scaling and connection defaults below, so adding it in the app is a pick from a list rather than a form filled in from the datasheet — and it is the same data an AI agent gets from the list_catalog MCP tool.

Registers · 3 tags

TagUnitI²C addressScale
Temperature
temperature_ambient
°C0x76× 1
Relative humidity
humidity_relative
%0x76× 1
Barometric pressure
pressure_atmospheric
hPa0x76× 1

Engineering value = raw × scale + offset; the gateway sends the raw reading and Synacl scales it.

Connection defaults

I²C address0x76
Sensor driverBME280
Bus pins (gateway default)SDA GPIO 21 · SCL GPIO 22 (3.3 V)
Bus clock100 kHz

Wiring

I²C: SDA to GPIO 21, SCL to GPIO 22 (the gateway defaults), VCC to 3.3 V, GND to GND. Most breakouts carry pull-ups and a 3.3 V regulator; check the board before feeding it 5 V.

Notes

Set it up in three steps

  1. Flash the gateway from the browser
    Plug an ESP32 dev board into USB, open the free web flasher in Chrome or Edge and write the Synacl gateway firmware. It asks for Wi-Fi and pairs the gateway with your account — nothing to install, about two minutes.
  2. Add the Bosch BME280 temperature, humidity & pressure from the catalog
    In the app open Devices → Add device and choose “Start from a catalog device”, then pick Bosch BME280 temperature, humidity & pressure. The I²C settings and every tag in the table above are filled in; choose the gateway it is wired to, change the I²C address if yours differs, and save. How the catalog picker works →
  3. Watch the live data arrive
    The gateway receives the new configuration over MQTT within seconds and starts polling. Readings show on the device page and in any dashboard widget you bind to them; add a rule for alerts, keep history for reports, or let an AI agent read it over MCP.

How this entry was verified

Datasheet-derived — derived from the vendor datasheet and not yet confirmed on hardware — please report a mismatch.

Bench-verified means Synacl ran this entry on real hardware. Datasheet-derived means the map was transcribed from the vendor's documentation, so a register may be off by one or in the other word order on your unit — a two-line email fixes it for everyone.

Report a register mismatch · Vendor datasheet ↗ · All catalog devices

Try it on your own hardware

Synacl is free for five devices — no card, no sales call. Flash a gateway from the browser, add the Bosch BME280 temperature, humidity & pressure from the catalog, and see live data in a few minutes.