🏠 IoT Home Monitoring System

Real-time home monitoring with ESP32-S3, Firebase, and Next.js 14.

Architecture

ESP32-S3 (FreeRTOS) ──► Firebase Realtime DB ──► Next.js Dashboard (Vercel)
     │                          │
     │                   Cloud Functions
     │                          │
  BME688 (IAQ)           Telegram Alerts
  WiFi CSI (Motion)
  SSD1306 OLED

Hardware

Component	Details
MCU	ESP32-S3-DevKitC-1
Air Quality	BME688 (I2C 0x76, BSEC2)
Display	SSD1306 128×64 OLED (I2C 0x3C)
Motion	WiFi CSI (no extra hardware!)
I2C Pins	SDA=GPIO8, SCL=GPIO9

Quick Start

1. Firmware

cd firmware
# Edit include/config.h with your WiFi + Firebase credentials
pio run --target upload

2. Next.js Dashboard

cd nextjs-dashboard
cp .env.local.example .env.local
# Fill in your Firebase config
npm install
npm run dev

3. Cloud Functions (Telegram Alerts)

cd firebase-functions
firebase functions:config:set telegram.bot_token="YOUR_TOKEN" telegram.chat_id="YOUR_CHAT_ID"
cd functions && npm install && npm run build
cd .. && firebase deploy --only functions

FreeRTOS Task Map

Task	Core	Priority	Description
Sensor	1	3	BME688 BSEC2 readings
Motion	1	3	WiFi CSI motion detection
Display	0	2	SSD1306 OLED auto-cycling
Upload	0	1	Firebase realtime DB upload

IAQ Index Guide

Range	Rating
0–50	Excellent
51–100	Good
101–150	Moderate
151–200	Poor
201+	Very Poor