Reading Environmental Sensors

TIMEEstimated Time

LEVELDifficulty

PREPrerequisites

• I2C Communication You should understand SDA, SCL, device addresses, and how the ESP32 talks to I2C modules.

SKILLSkills You'll Learn

• Read environmental data from a BME280 sensor
• Explain temperature, humidity, and atmospheric pressure
• Display sensor values on an SSD1306 OLED and Serial Monitor
• Understand accuracy, precision, calibration, sampling, and refresh rate
• Recognize why real sensor readings constantly change

PARTSComponents Required

• ESP32ESP32 DevKit V1Reads the sensor and controls the display
• BMEBME280 environmental sensorMeasures temperature, humidity, and pressure
• OLEDSSD1306 OLED displayShows the live readings
• WIREBreadboard and jumper wiresConnect shared 3.3 V, GND, SDA, and SCL

ENGEngineering Explanation

REALReal-World Analogy

WIREWiring Diagram

Follow these steps in order. Unplug USB before you change any wires.

1. 1

   Unplug the ESP32 USB cable before wiring.

2. 2

   Connect BME280 VIN or VCC to ESP32 3.3 V.

3. 3

   Connect BME280 GND to ESP32 GND.

4. 4

   Connect BME280 SDA to ESP32 GPIO21.

5. 5

   Connect BME280 SCL to ESP32 GPIO22.

6. 6

   Connect OLED VCC to ESP32 3.3 V.

7. 7

   Connect OLED GND to ESP32 GND.

8. 8

   Connect OLED SDA to the same GPIO21 SDA row.

9. 9

   Connect OLED SCL to the same GPIO22 SCL row.

10. 10

    Install Adafruit BME280, Adafruit Unified Sensor, Adafruit SSD1306, and Adafruit GFX from Arduino Library Manager.

GPIOGPIO Table

⌨️Arduino Code

Copy this into Arduino IDE, then click Upload.

#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#include <Adafruit_BME280.h>

const int I2C_SDA = 21;
const int I2C_SCL = 22;

const int SCREEN_WIDTH = 128;
const int SCREEN_HEIGHT = 64;
const int OLED_RESET = -1;
const int OLED_ADDRESS = 0x3C;

const unsigned long SAMPLE_INTERVAL_MS = 2000;

Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);
Adafruit_BME280 bme;

unsigned long lastSampleTime = 0;

void setup() {
  Serial.begin(115200);
  delay(1000);

  Wire.begin(I2C_SDA, I2C_SCL);

  if (!display.begin(SSD1306_SWITCHCAPVCC, OLED_ADDRESS)) {
    Serial.println("OLED not found. Check address, SDA, and SCL.");
    while (true) {
      delay(1000);
    }
  }

  bool bmeReady = bme.begin(0x76);

  if (!bmeReady) {
    bmeReady = bme.begin(0x77);
  }

  if (!bmeReady) {
    Serial.println("BME280 not found at 0x76 or 0x77.");
    showMessage("BME280 not found", "Check wiring");
    while (true) {
      delay(1000);
    }
  }

  Serial.println("Mission 11: Environmental sensor ready");
  showMessage("ESP32 Engine", "BME280 ready");
  delay(1500);
}

void loop() {
  unsigned long now = millis();

  if (now - lastSampleTime >= SAMPLE_INTERVAL_MS) {
    lastSampleTime = now;

    float temperatureC = bme.readTemperature();
    float humidity = bme.readHumidity();
    float pressureHpa = bme.readPressure() / 100.0;

    printToSerial(temperatureC, humidity, pressureHpa);
    showOnDisplay(temperatureC, humidity, pressureHpa);
  }
}

void printToSerial(float temperatureC, float humidity, float pressureHpa) {
  Serial.print("Temperature: ");
  Serial.print(temperatureC, 1);
  Serial.print(" C | Humidity: ");
  Serial.print(humidity, 1);
  Serial.print(" % | Pressure: ");
  Serial.print(pressureHpa, 1);
  Serial.println(" hPa");
}

void showOnDisplay(float temperatureC, float humidity, float pressureHpa) {
  display.clearDisplay();
  display.setTextColor(SSD1306_WHITE);
  display.setTextSize(1);

  display.setCursor(0, 0);
  display.println("Environment");

  display.setCursor(0, 16);
  display.print("Temp: ");
  display.print(temperatureC, 1);
  display.println(" C");

  display.setCursor(0, 32);
  display.print("Hum:  ");
  display.print(humidity, 1);
  display.println(" %");

  display.setCursor(0, 48);
  display.print("Pres: ");
  display.print(pressureHpa, 1);
  display.println(" hPa");

  display.display();
}

void showMessage(const char* line1, const char* line2) {
  display.clearDisplay();
  display.setTextColor(SSD1306_WHITE);
  display.setTextSize(1);
  display.setCursor(0, 12);
  display.println(line1);
  display.setCursor(0, 32);
  display.println(line2);
  display.display();
}

CODELine-by-line Explanation

• Wire.h starts the I2C bus used by both the BME280 and OLED.
• Adafruit_GFX and Adafruit_SSD1306 control the OLED display.
• Adafruit_BME280 reads temperature, humidity, and pressure from the sensor.
• I2C_SDA and I2C_SCL keep the ESP32 on GPIO21 and GPIO22, matching Mission 10.
• SAMPLE_INTERVAL_MS sets how often the ESP32 reads the sensor. Two seconds is readable and calm.
• display.begin() checks that the OLED responds at address 0x3C.
• bme.begin(0x76) tries the common BME280 address first.
• If 0x76 fails, the sketch tries 0x77 because many BME280 modules use that address.
• millis() is used to sample every 2 seconds without needing a long blocking delay in the main loop.
• readTemperature() returns temperature in degrees Celsius.
• readHumidity() returns relative humidity as a percent.
• readPressure() returns pressure in pascals, so the code divides by 100 to display hPa.
• printToSerial() formats the values for debugging on your computer.
• showOnDisplay() formats the same values for the OLED so the project can stand alone.

WARNCommon Mistakes

• Misconception: a stable room should give identical readings

  Real measurements include air movement, sensor noise, and tiny electrical changes.

• Misconception: more decimals mean more truth

  Extra digits can suggest more certainty than the sensor really provides.

• Confusing accuracy with precision

  A stable reading can still be offset from the true value.

• Touching the sensor during testing

  Your finger warms the board and changes humidity around the sensor.

• Putting the sensor beside the ESP32 regulator

  Board heat can make temperature read too high.

• Using the wrong BME280 address

  Some modules use 0x76 and others use 0x77.

• Reading too fast

  Fast updates can make normal noise look like a problem.

• Comparing indoor values directly with weather apps

  Weather apps report outdoor station data, not the air next to your desk.

• Ignoring humidity temperature relationship

  Relative humidity can change when temperature changes.

• Expecting two sensors to match exactly

  Every sensor has tolerance, placement differences, and calibration differences.

!Troubleshooting

Most ESP32 problems are wiring, power, library, or timing issues. Check these first.

• OLED works but BME280 is not found

  Likely cause: The display is on the bus, but the sensor wiring or address is wrong.

  Fix: Check BME280 3.3 V, GND, SDA, SCL, then run the I2C scanner.

• BME280 works but OLED is blank

  Likely cause: The sensor is responding, but the OLED address or display wiring is wrong.

  Fix: Check OLED VCC, GND, GPIO21, GPIO22, and address 0x3C or 0x3D.

• Compilation fails for Adafruit_BME280.h

  Likely cause: The BME280 library is not installed.

  Fix: Install Adafruit BME280 and Adafruit Unified Sensor from Library Manager.

• Compilation fails for Adafruit_SSD1306.h

  Likely cause: The OLED display library is not installed.

  Fix: Install Adafruit SSD1306 and Adafruit GFX from Library Manager.

• Temperature seems too high

  Likely cause: The sensor may be warmed by the ESP32, USB power, your hand, or sunlight.

  Fix: Move the sensor away from heat and wait a few minutes.

• Pressure looks unfamiliar

  Likely cause: Pressure is shown in hPa, which is common for weather-style readings.

  Fix: Normal sea-level pressure is often near 1013 hPa, but your local value changes with weather and altitude.

TIPEngineer Tip

REMRemember This Forever

?FAQs

• What is an environmental sensor?

  An environmental sensor measures conditions around the device, such as temperature, humidity, air pressure, light, air quality, or moisture.

• Why use the BME280 in this mission?

  The BME280 is a compact I2C sensor that can measure temperature, humidity, and atmospheric pressure with one module.

• How is the BME280 different from the DHT22?

  The DHT22 measures temperature and humidity. The BME280 also measures pressure and uses I2C, which makes it fit naturally after the I2C mission.

• Why do sensor readings keep changing?

  Real air is always moving, electronics have small noise, and sensors have limited precision. Small changes are normal, not a sign that the sensor is broken.

• What is sensor accuracy?

  Accuracy describes how close a reading is to the true value. A sensor can be stable but still slightly wrong.

• What is sensor precision?

  Precision describes how repeatable the readings are. A sensor can show very consistent numbers even if they are offset from the true value.

• What is calibration?

  Calibration means comparing sensor readings with a trusted reference and adjusting your interpretation or code so the result is more useful.

• Why does pressure change during the day?

  Atmospheric pressure changes as weather systems move, air temperature changes, and air masses rise or sink. Indoor pressure usually follows outdoor pressure slowly.

• Why does my sensor not match a weather app?

  Weather apps usually use outdoor station data or forecasts. Your BME280 measures the air at your desk, inside your room, near your electronics.

• Are cheap sensors useful?

  Yes. Cheap sensors are excellent for trends, learning, automation triggers, and relative changes, even when they are not laboratory instruments.

• Why do engineers average sensor readings?

  Averaging reduces small random changes so decisions are based on the general trend instead of one noisy sample.

• How often should I read a BME280?

  For a beginner environment monitor, every 1 to 5 seconds is usually enough. Reading too quickly often creates noise without adding useful information.