Skip to content

README.MD

Latest commit

 

History

History
161 lines (107 loc) · 2.82 KB

README.MD

File metadata and controls

161 lines (107 loc) · 2.82 KB

ESP32-C3 SuperMini BME280 HTTP Sensor Node

A lightweight IoT firmware for ESP32-C3 SuperMini that reads environmental data from a BME280 sensor and periodically sends measurements as JSON to a remote HTTP endpoint.

This project is designed for simple environmental monitoring scenarios such as balcony/weather nodes, indoor climate tracking, or distributed sensor systems.

Features

  • Temperature, humidity, and pressure measurement
  • I²C BME280 sensor integration
  • Wi-Fi auto connection with timeout protection
  • HTTP JSON telemetry upload
  • Retry logic for failed transmissions
  • Sensor error detection
  • Lightweight and stable runtime behavior
  • PlatformIO build system

Hardware Requirements

Components

  • ESP32-C3 SuperMini
  • BME280 environmental sensor (I²C module)

Wiring

BME280 ESP32-C3
VIN 5V
GND GND
SDA GPIO 8
SCL GPIO 9

Most BME280 modules support both 3.3V and 5V input, but 3.3V is safest for ESP32 logic.

Software Requirements

  • VS Code
  • PlatformIO extension
  • ESP32 USB drivers

⚙ Installation

1. Clone the repository

git clone https://github.com/pvdiulin/ESP32-C3_BME280_HTTP_Sensor_Node.git
cd thmetrix

2. Configure credentials

Edit or create the file:

src/config.h

Example configuration:

#pragma once

#define WIFI_SSID "your_wifi_name"
#define WIFI_PASSWORD "your_wifi_password"

#define API_ENDPOINT "http://your-server/api/sensor"

#define LOCATION "location"

#define SEND_INTERVAL 30000

3. Build firmware

pio run

4. Upload to device

pio run -t upload

5. Monitor serial output

pio device monitor

Example JSON Payload

{
  "location": "balcony",
  "temperature": 23.6,
  "humidity": 44.8,
  "pressure": 1012.9
}

Troubleshooting

Sensor not detected

  • Check wiring
  • Confirm I²C address (0x76 or 0x77)
  • Use 3.3V power
  • Verify SDA/SCL pins

Wi-Fi connection issues

  • Confirm credentials
  • Check signal strength
  • Watch serial logs

HTTP failures

  • Verify API endpoint
  • Ensure server is reachable
  • Check firewall/network rules

Possible Extensions

  • MQTT telemetry publishing
  • Deep sleep battery operation
  • OTA firmware updates
  • Web dashboard integration
  • Home Assistant support
  • Data buffering and batching

MIT License — free to use, modify, and distribute.

Acknowledgements

  • ESP32 Arduino framework
  • Adafruit BME280 library
  • ArduinoJson
  • PlatformIO ecosystem

ESP32-C3_SuperMini__BME280_Modules ESP32-C3_SuperMini__BME280_Modules_Reverse