Same-day dispatch before 2 PM · Free delivery over ₹999 · GST invoices Get the appPrices incl. GST
Geekobot
Snap & SendNEWGeeko AIWhere's myOrder
Log in
Products
  • Projects
    • Component guidesHow parts work, with code you can run
    • Learning pathsFrom your first LED to your first robot
    • Workshops & eventsOnline sessions for makers and classes
    • ElectrolarkFree guided builds, simulator and certificates
    • Students & teachersStudent discount and classroom help
    • CommunityShare builds and ask other makers
    • CalculatorsOhm's law, LED resistor, 555 and 100+ more
    • Circuit builderWire parts and run the circuit, powered by Electrolark
    • Geeko AIAsk what to buy or how to wire it
    • Snap & SendPhotograph a part or list, we find it
    • Part finderAnswer a few questions, get the right part
    • Compatibility checkWill these two parts work together?
    • Compare partsSpecs side by side
    • Business & bulk ordersGST invoices, credit and volume prices
    • Request a quotationSend your list, get a quote
    • Classroom kitsPer-student kits and lab bundles
    • Gift cardsFor students, teams and events
  • Atal Tinkering Lab
BOM to cart
Geekobot

Components, kits and know-how for makers, students, engineers, labs and businesses across India.

Ask Geeko AIOrders, parts and projects, any timeEmail supportReply within 1 working dayGet the Geekobot appAdd it to your home screen, free

Follow us

Shop

  • Boards & SBCs
  • Sensors & Modules
  • IoT & Wireless
  • Drone & FPV
  • 3D Printing
  • Filaments & Resins
  • Motors & Drivers
  • Power & Batteries
  • Semiconductors
  • Passive
  • Displays & LEDs
  • Switches & Relays
  • Wires & Cables
  • Prototyping
  • Tools & Test
  • Robotics
  • STEM Kits
  • Atal Tinkering Lab
  • Mechanical Parts
  • Audio

Orders

  • Track your order
  • Help & support
  • Shipping and delivery
  • Refunds and cancellation
  • Contact us

Learn

  • Projects
  • Geeko AI project assistant
  • Learning paths
  • Guides
  • Calculators
  • Electrolark: free guided builds

Part tools

  • Part finder
  • Compare parts
  • Will it work with my board?

Institutions

  • Classroom kits
  • Atal Tinkering Lab
  • Students & teachers
  • Workshops & Events

Business

  • Business & education
  • Request a quotation
  • BOM bulk upload
  • Quick order by SKU

Company

  • About Geekobot
  • Community
  • Gift cards
  • Terms & conditions
  • Privacy policy
  • Product directory
  • Sitemap

© 2026 Geekobot, a trade name of OLatus Systems Private Limited. All rights reserved.

20, 1st Floor, Neeladri Complex, 10th Cross, Sampige Rd, 2nd Main, Malleshwaram, Bengaluru, Karnataka 560003 · GSTIN 29AACCO0462F1ZM

+91 91810 15607 · connect@geekobot.in · Monday to Saturday, 10 AM to 2 PM IST

UPI · CARDS · NETBANKING · GST INVOICES

ShopProjectsGeeko AIGuides
Compare 0 parts →
Log in

Shop by category

Shop all components
  • Boards & SBCs1,910 products
    • Alternative Single Board Computers
    • Arduino Ecosystem
    • FPGA & Logic Boards
    • Microcontroller & Wireless Boards
    View all
  • Sensors & Modules4,701 products
    • Biomedical & Heart Rate
    • Current, Voltage & Power
    • Force, Weight & Pressure
    • Gas, Weather & Environmental
    View all
  • IoT & Wireless2,314 products
    • RF Modules
    • RFID & NFC
    • Antennas & RF Accessories
    • Cameras & Smart Vision
    View all
  • Drone & FPV3,558 products
    • Flight Control & Navigation
    • FPV Video & Optics
    • Frames & Structural Parts
    • Motors & Propulsion
    View all
  • 3D Printing2,204 products
    • 3D Printers
    • 3D Scanners & Digitizers
    • Laser Engravers & Cutters
    • Material Management & Upgrades
    View all
  • Filaments & Resins1,472 products
    • Filaments
    • Photopolymer Resins
    View all
  • Motors & Drivers463 products
    • BLDC Motor Drivers
    • DC & Geared Motors
    • DC Motor Drivers
    • Linear Actuators & Solenoids
    View all
  • Power & Batteries557 products
    • Battery Holders & Connectors
    • Breadboard Power
    • Chargers & BMS
    • DC-DC Converters
    View all
  • Semiconductors295 products
    • Diodes & Rectifiers
    • Interface & RF Encoder ICs
    • Logic ICs (74xx)
    • Logic ICs (CD4000)
    View all
  • Passive67 products
    • Capacitors
    • Circuit Protection
    • Crystals & Oscillators
    • Inductors
    View all
  • Displays & LEDs572 products
    • 7-Segment & Dot Matrix
    • Addressable LEDs
    • Character LCDs
    • Graphic LCDs
    View all
  • Switches & Relays184 products
    • Keypads & Touch
    • Push Buttons & Tactile
    • Relay Modules
    • Relays
    View all
  • Wires & Cables233 products
    • Board-to-Wire Connectors
    • Crimp & Splice
    • Headers & Dupont
    • Heat Shrink & Sleeving
    View all
  • Prototyping101 products
    • Breadboards
    • Interface Modules
    • PCBs & Perfboards
    View all
  • Tools & Test717 products
    • Bench Power Supplies
    • Hand Tools
    • Measuring Tools
    • Meters & Testers
    View all
  • Robotics180 products
    • Humanoid & Legged Robots
    • Robot Chassis & Platforms
    • Robotic Arms & Grippers
    • Wheels & Casters
    View all
  • STEM Kits268 products
    • Arduino Learning Kits
    • Coding & IoT Kits
    • Early Coding (Ages 3-8)
    • Invention Kits
    View all
  • Atal Tinkering Lab196 products
    • Package 1: Electronics, Robotics, IoT and Sensors
    • Package 2: Rapid Prototyping Tools
    • Package 3: Mechanical, Electrical and Measurement Tools
    • Package 4: Power Supply, Accessories and Safety Equipment
    View all
  • Mechanical Parts212 products
    • Bearings
    • Brackets & Mounts
    • Couplers
    • Fasteners & Standoffs
    View all
  • Audio109 products
    • Amplifier Modules
    • Buzzers & Sirens
    • Speakers
    View all
  1. Home
  2. ›Guides
  3. ›Sensors
  4. ›BME688 AI Gas Sensor

Component guide · Intermediate · 4 min read

BME688 AI Gas Sensor

Pinout, Wiring and Code

By Geekobot Learning Team · Updated 29 Oct 2026

I'm using
Wiring, code and the Run it panels follow your board.
On this page
Short answerWhat the BME688 isBME688 pinoutWiring the BME688Example codeSetup and tuningWhat you needAlternatives and when to choose themTry itCommon mistakesFAQsParts and next steps
Short answer

The BME688 from Bosch measures temperature, humidity, pressure and VOC gas like the BME680, and adds gas scanning: it cycles its heater through up to ten temperatures so a trained model can tell gases apart. Wire it over I2C at 0x76 or 0x77 and read it with the same code as the BME680, then use Bosch BME AI-Studio to train smell detection.

Key specs at a glance

Measures
Temperature, humidity, pressure, VOC gas resistance
Gas scanning
Heater profile of up to 10 steps for AI gas classification
Temperature / humidity
±0.5 °C typical, ±3 % RH
Pressure
300 to 1100 hPa, ±0.6 hPa
Interface
I2C (0x76 or 0x77) or SPI
Supply
Chip 1.71 to 3.6 V; modules usually 3.3 to 5 V

Models in this guide

These are alternatives. Pick the one that fits your project; you only need one.

  • Option 1Bosch BME688 4-in-1 Environmental Sensor – Temperature, Humidity, Pressure & AI Gas Detection, I2C/SPI₹1,119
  • Option 2Adafruit BME688 Temperature, Humidity, Pressure & Gas Sensor – I2C/SPI with Stemma QT₹3,029
  • Option 3Bosch BME688 4-in-1 Environmental Sensor Module with Cotton Core & Holder – I2C/SPI₹1,359
  • Option 4Bosch BME688 Environment Sensor Module – Temperature Humidity Pressure VOC I2C₹2,699
  • Option 5DFRobot BME688 AI Environmental Sensor VOC Temp Humidity Pressure – I2C/SPI₹2,339
  • Option 6DFRobot Fermion BME688 AI Environmental Sensor (VOC, Temperature, Humidity, Pressure) – I2C/SPI₹1,779
01

What the BME688 is

The BME688 is pin-compatible with the BME680. Normal readings work the same way. What is new is the heater profile: by heating the sensing layer to several temperatures in turn, the sensor produces a pattern of resistances that depends on which gases are present.

Bosch's BME AI-Studio software trains a small model on those patterns (for example coffee versus normal air, or spoiled food), and the BSEC2 library runs it on an ESP32 or similar board.

02

BME688 pinout

The pins on the BME688 and what each one does.

PinFunction
VCC / VINSupply, 3.3 to 5 V on modules with a regulator
GNDGround
SCL / SCKI2C clock, or SPI clock
SDA / SDII2C data, or SPI data in
SDOI2C address select (GND 0x76, VCC 0x77), or SPI data out
CSSPI chip select; high (or open) for I2C
PinFunction
VCC / VIN
Supply, 3.3 to 5 V on modules with a regulator
GND
Ground
SCL / SCK
I2C clock, or SPI clock
SDA / SDI
I2C data, or SPI data in
SDO
I2C address select (GND 0x76, VCC 0x77), or SPI data out
CS
SPI chip select; high (or open) for I2C
03

Wiring the BME688

Adafruit, SparkFun and Pimoroni boards default to 0x77; many generic modules use 0x76. Qwiic and STEMMA QT boards plug straight into a matching connector.

BME688 pinArduino UnoESP32
VCC5V (or 3.3V)3V3
GNDGNDGND
SDAA4GPIO 21
SCLA5GPIO 22
SDOGND (0x76) or VCC (0x77)GND (0x76) or VCC (0x77)
VCC
Arduino Uno:
5V (or 3.3V)
ESP32:
3V3
GND
Arduino Uno:
GND
ESP32:
GND
SDA
Arduino Uno:
A4
ESP32:
GPIO 21
SCL
Arduino Uno:
A5
ESP32:
GPIO 22
SDO
Arduino Uno:
GND (0x76) or VCC (0x77)
ESP32:
GND (0x76) or VCC (0x77)
04

Example code

This reads the BME688 in BME680-compatible mode. For gas scanning and trained models, use the Bosch BME68x and BSEC2 libraries.

Read the sensor (Adafruit BME680 library, works with BME688) · Arduino C++Verify & upload in Electrolark
#include <Wire.h>
#include <Adafruit_Sensor.h>
#include "Adafruit_BME680.h"

Adafruit_BME680 bme;   // also works with the BME688

void setup() {
  Serial.begin(115200);
  if (!bme.begin(0x76) && !bme.begin(0x77)) { Serial.println("No sensor at 0x76 or 0x77"); while (1); }
  bme.setTemperatureOversampling(BME680_OS_8X);
  bme.setHumidityOversampling(BME680_OS_2X);
  bme.setPressureOversampling(BME680_OS_4X);
  bme.setGasHeater(320, 150);   // 320 °C for 150 ms
}

void loop() {
  if (!bme.performReading()) return;
  Serial.print(bme.temperature); Serial.print(" C  ");
  Serial.print(bme.humidity); Serial.print(" %  ");
  Serial.print(bme.pressure / 100.0); Serial.print(" hPa  gas ");
  Serial.print(bme.gas_resistance / 1000.0); Serial.println(" kOhm");
  delay(3000);
}
05

Setup and tuning

Settle time

run it for at least 30 minutes, and for days for BSEC to learn a baseline.

Training data

record each smell many times with the BME688 Development Kit or a logging sketch, then train in BME AI-Studio.

Board choice

BSEC2 needs a 32-bit board such as an ESP32.

Placement

keep it away from heat sources and direct breath.

06

What you need

Shop this list16 of 16 found in our store · ₹30,775

  • Bosch BME688 4-in-1 environmental sensor: the sensor this guide coversBosch BME688 4-in-1 Environmental Sensor Module with Cotton Core & Holder – I2C/SPI₹1,359Closest match, check the specs
  • Adafruit BME688 Temperature, Humidity, Pressure & Gas Sensor – I2C/SPI with Stemma QT: another version this guide coversAdafruit BME688 Temperature, Humidity, Pressure & Gas Sensor – I2C/SPI with Stemma QT₹3,029
  • Bosch BME688 4-in-1 Environmental Sensor Module with Cotton Core & Holder – I2C/SPI: another version this guide coversBosch BME688 4-in-1 Environmental Sensor Module with Cotton Core & Holder – I2C/SPI₹1,359
  • Bosch BME688 Environment Sensor Module – Temperature Humidity Pressure VOC I2C: another version this guide coversBosch BME688 Environment Sensor Module – Temperature Humidity Pressure VOC I2C₹2,699
  • DFRobot BME688 AI Environmental Sensor VOC Temp Humidity Pressure – I2C/SPI: another version this guide coversDFRobot BME688 AI Environmental Sensor VOC Temp Humidity Pressure – I2C/SPI₹2,339
  • DFRobot Fermion BME688 AI Environmental Sensor (VOC, Temperature, Humidity, Pressure) – I2C/SPI: another version this guide coversDFRobot Fermion BME688 AI Environmental Sensor (VOC, Temperature, Humidity, Pressure) – I2C/SPI₹1,779
  • Pimoroni BME688 4-in-1 Air Quality Breakout (Gas, Temperature, Pressure, Humidity) – I2C/SPI: another version this guide coversPimoroni BME688 4-in-1 Air Quality Breakout (Gas, Temperature, Pressure, Humidity) – I2C/SPI₹2,216
  • Seeed Studio Studio Grove BME688 Air Quality Sensor AI 4-in-1 Module: another version this guide coversSeeed Studio Grove BME688 Air Quality Sensor AI 4-in-1 Module₹3,639Closest match, check the specs
  • SparkFun BME688 Environmental Sensor Breakout – Gas/Temp/Humidity/Pressure (Qwiic): another version this guide coversSparkFun BME688 Environmental Sensor Breakout – Gas/Temp/Humidity/Pressure (Qwiic)₹4,854
  • Waveshare BME688 Environmental Sensor Module – Temperature / Humidity / Pressure / Gas Detection with AI, I2C/SPI, 3.3V/5V Compatible: another version this guide coversWaveshare BME688 Environmental Sensor Module – Temperature / Humidity / Pressure / Gas Detection with AI, I2C/SPI, 3.3V/5V Compatible₹2,729
  • BME688 Blackboard Environmental Sensor Module – AI-Powered Gas, Temperature, Humidity & Pressure Sensor: another version this guide coversBME688 Blackboard Environmental Sensor Module – AI-Powered Gas, Temperature, Humidity & Pressure Sensor₹1,699
  • BME688 Stainless Steel Probe Wire 1 Meter – I2C Interface: another version this guide coversBME688 Stainless Steel Probe Wire 1 Meter – I2C Interface₹2,429
  • ESP32-WROOM-32 38-pin development board: for Wi-Fi logging and dashboardsESP32-WROOM-32 38-Pin Development Board₹389
  • 0.96 inch OLED display 128x64: to show readings without a computer0.96" OLED Display 128x64₹139Closest match, check the specs
  • Dupont jumper wires: for the connectionsDupont Jumper Wires (40 pcs)₹49Closest match, check the specs
  • Solderless breadboard: to build without solderingSolderless Breadboard₹68
07

Alternatives and when to choose them

  • ✓BME680: the earlier version without gas scanning.
  • ✓ENS160: gives eCO2 and TVOC directly without a library model.
  • ✓VOC and indoor air quality sensors: which VOC sensor to choose.
08

Try it: I2c pullup calculator

Change the values and the diagram and results update as you type.

09

Common mistakes to avoid

  • !Expecting it to name a gas without training a model first.
  • !Running BSEC2 on an Arduino Uno.
  • !Reading values in the first minutes after power-up.
  • !Mounting it inside a closed box with no airflow.
10

Frequently asked questions

Can the BME688 detect a specific gas?

Only after you train a model with BME AI-Studio; out of the box it gives VOC resistance and IAQ.

Is the BME688 compatible with BME680 code?

Yes, the Adafruit BME680 library reads it.

What is its I2C address?

0x76 or 0x77, set by the SDO pin.

Does it measure CO2?

It estimates a CO2 equivalent from VOCs; it is not an NDIR CO2 sensor.

Which board should I use?

An ESP32 or other 32-bit board for BSEC2; any board for basic readings.

Parts for this guide

  • Bosch BME688 4-in-1 Environmental Sensor – Temperature, Humidity, Pressure & AI Gas Detection, I2C/SPI
    ₹1,119View
  • Adafruit BME688 Temperature, Humidity, Pressure & Gas Sensor – I2C/SPI with Stemma QT
    ₹3,029View
  • Bosch BME688 4-in-1 Environmental Sensor Module with Cotton Core & Holder – I2C/SPI
    ₹1,359View
  • Bosch BME688 Environment Sensor Module – Temperature Humidity Pressure VOC I2C
    ₹2,699View
  • DFRobot BME688 AI Environmental Sensor VOC Temp Humidity Pressure – I2C/SPI
    ₹2,339View
  • DFRobot Fermion BME688 AI Environmental Sensor (VOC, Temperature, Humidity, Pressure) – I2C/SPI
    ₹1,779View
  • Pimoroni BME688 4-in-1 Air Quality Breakout (Gas, Temperature, Pressure, Humidity) – I2C/SPI
    ₹2,216View
  • Seeed Studio Grove BME688 Air Quality Sensor AI 4-in-1 Module
    ₹3,639View
  • SparkFun BME688 Environmental Sensor Breakout – Gas/Temp/Humidity/Pressure (Qwiic)
    ₹4,854View
  • Waveshare BME688 Environmental Sensor Module – Temperature / Humidity / Pressure / Gas Detection with AI, I2C/SPI, 3.3V/5V Compatible
    ₹2,729View
  • BME688 Blackboard Environmental Sensor Module – AI-Powered Gas, Temperature, Humidity & Pressure Sensor
    ₹1,699View
  • BME688 Stainless Steel Probe Wire 1 Meter – I2C Interface
    ₹2,429View
  • ESP32-WROOM-32 38-Pin Development Board
    ₹389View
  • 0.96" OLED Display 128x64
    ₹139View
  • Dupont Jumper Wires (40 pcs)
    ₹49View
  • Solderless Breadboard
    ₹68View
Shop Gas, Air Quality & CO2 SensorsShop Temperature & Thermal Sensors

Calculators

I2c pullup calculator

Terms in this guide

I2CInter-Integrated Circuit: a two-wire bus (SDA and SCL) that connects many devices by address.

Keep learning

ComparisonIntermediateVOC and Indoor Air Quality SensorsVOC sensors detect a mix of organic gases from cleaners, paints and cooking and report a relative index rather than a precise gas amount.3 min read · SensorsComponent guideIntermediateBME680 Environmental SensorThe BME680 from Bosch measures temperature, humidity, air pressure and volatile organic compounds (VOC) in one small chip.4 min read · SensorsBuying guideIntermediateAir Quality SensorsCompare particle, CO2 and VOC sensors for an air monitor: PMS5003 and SDS011, NDIR CO2 vs eCO2, wiring, warm-up, power and placement for honest readings.3 min read · SensorsConcept explainerIntermediateI2C ExplainedI2C is a two-wire bus that lets one microcontroller talk to many sensors and displays using a data line (SDA) and a clock line (SCL).4 min read · Electronics Fundamentals

Sources

  • BME688 datasheet (Bosch Sensortec)
  • BME AI-Studio documentation (Bosch Sensortec)

Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.

On this page
Short answerWhat the BME688 isBME688 pinoutWiring the BME688Example codeSetup and tuningWhat you needAlternatives and when to choose themTry itCommon mistakesFAQsParts and next steps
Need a hand?Ask Geeko AI which part fits your project, or talk to the Geekobot team.Ask Geeko AIHelp & support

Parts for this guide (Arduino Uno)3 items · ₹1,391

Bosch BME688 4-in-1 Environmental Sensor – Temperature, Humidity, Pressure & AI Gas Detection, I2C/SPI · Solderless Breadboard · Uno R3 CH340G ATmega328p Compatible Development Board

Run itChange the inputs and watch the output

Gas resistance falls when VOCs (alcohol, solvents, breath) reach the heated plate.

Serial monitor115200 baud
25.80 C  55.00 %  1008.20 hPa  gas 53.10 kOhm

A simulation of the sketch above, so you know what to expect. Real readings vary with your parts and wiring.

Ask the Community

Ask a question