MicroPython Library

The bme690 module drives the BME690 over I2C. Its BME690 class reads the compensated temperature (°C), pressure (Pa), humidity (% r.H.) and gas resistance (Ω), and runs the sensor in forced, sequential or parallel mode. It does no BSEC processing: the IAQ, bVOC and CO2 equivalents come from Bosch's BSEC software, which this module does not include.

The module uses the floating-point compensation of the Bosch API. MicroPython ports with single-precision floats, the ESP32 among them, are slightly less precise than the Arduino library, well below the accuracy of the sensor itself.

Not installed yet? Follow Quick Start before using the functionality pages.

Public sourceSoldered BME690 MicroPython libraryThe bme690.py module, its mip manifest and five examples.Pinned reference: commit 91a07b5

Functionality

Each page starts with one verified module example and explains every function the example uses to get that result.

MicroPython exampleRead in forced modeOne measurement at a time, the usual way to read the sensor.bme690-forcedMode.pyMicroPython exampleStep through a heater profile in sequential modeThe sensor steps through a ten-step heater profile on its own, sleeping in between.bme690-sequentialMode.pyMicroPython exampleSweep the heater in parallel modeThe gas sensor sweeps a heater profile while temperature, pressure and humidity are measured continuously.bme690-parallelMode.pyMicroPython exampleRun the self testRuns the sensor's built-in self test and prints its unique ID.bme690-selfTest.pyMicroPython exampleLog raw data for BME AI-StudioRecords a .bmerawdata file on an SD card for Bosch's BME AI-Studio. Needs an ESP32 with WiFi and an SD card module.bme690-aiStudioLogger.py