WSAL24244 – BME680 Environmental Sensor/en

Documentation notice: This technical documentation was independently rewritten from an archived supplier source. Check technical details and commands against the product version and manufacturer documentation before use.

Summary

The BME68X environmental sensor measures temperature, humidity, barometric pressure and gas resistance via I2C or SPI. It is supported on Raspberry Pi, Arduino, ESP32 and Pico; IAQ calculation requires the non-open-source Bosch BSEC software library.

Related products at JW Tech

• WSAL24244 – BME68X Environmental Sensor, Supports Temperature / Humidity / Barometric Pressure / Gas Detection, optional AI function
• WSAL24245 – BME68X Environmental Sensor, Supports Temperature / Humidity / Barometric Pressure / Gas Detection, optional AI function

Technical overview

• Four-in-one sensing: temperature, relative humidity, barometric pressure and VOC gas resistance in one module.
• Communication via I2C (default) or SPI; I2C address configurable via ADDR pad (0x77 default, 0x76 when grounded).
• Onboard voltage translator supports 3.3 V and 5 V supply.
• BME680 and BME688 include a mini MOX sensor whose resistance changes with VOC concentration.
• An IAQ value (0–500) is only produced through the official, non-open-source BSEC library; use is subject to Bosch licensing restrictions.
• Module dimensions: 27 mm × 20 mm.
• Platforms covered in the wiki: Raspberry Pi (C/Python), Raspberry Pi Pico, Arduino, ESP32.
• Stated measurement ranges: temperature −40 to 85 °C, humidity 0–100 % r.H., pressure 300–1100 hPa.

Commands and examples – verify before use: 

sudo raspi-config
sudo reboot
lsmod
sudo apt-get install i2c-tools
i2cdetect -y 1
wget https://files.waveshare.com/upload/4/49/BME68X_Environmental_Sensor_code.zip
unzip BME68X_Environmental_Sensor_code.zip
sudo chmod -R 777 BME68X_Environmental_Sensor_code
sudo make clean
sudo make
sudo ./bme68x
sudo pip3 install bme680
sudo python3 read-all.py

Notes and version constraints

• The BSEC library is proprietary and license-restricted; review licensing terms before integration.
• I2C address depends on the ADDR pad state; if malfunction occurs, check connection, communication mode and address.
• Demo files must be downloaded and extracted; paths may vary by version.
• Arduino SPI demo uses D10/D11/D12/D13; other boards require adjusted pin assignments.
• No warranty or certification information present in the source; no safety notes available.

Source and revision record

• BME68X Environmental Sensor - Waveshare Wiki
• Source revision: 110850
• Captured: 2026-09-04T04:01:57+00:00
• SHA-256: f1cd20b2e61e531630c44c0d04cce05a02bd616ed092d7bf15a716752e519b5e