https://github.com/marcelo-schreiber/indoor-weather-logger
A weather logging system using an ESP32 with a DHT22, BMP280 and MQ135 sensors
https://github.com/marcelo-schreiber/indoor-weather-logger
bmp280 chart dht22 esp32 mq135 weather
Last synced: 7 months ago
JSON representation
A weather logging system using an ESP32 with a DHT22, BMP280 and MQ135 sensors
- Host: GitHub
- URL: https://github.com/marcelo-schreiber/indoor-weather-logger
- Owner: marcelo-schreiber
- License: mit
- Created: 2024-11-18T21:09:07.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-03-22T22:12:20.000Z (7 months ago)
- Last Synced: 2025-03-22T23:20:02.391Z (7 months ago)
- Topics: bmp280, chart, dht22, esp32, mq135, weather
- Language: TypeScript
- Homepage: https://weather.marcelo-schreiber.com
- Size: 902 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Indoor Weather Logger
[](https://github.com/marcelo-schreiber/indoor-weather-logger/blob/master/LICENSE)
[README in portuguese](https://github.com/marcelo-schreiber/indoor-weather-logger/blob/master/README.pt.md)
This project logs weather data (temperature, humidity, pressure, and air quality) using an **ESP32 Wemos Lolin32** with **DHT22**, **BMP280**, and **MQ135** sensors. Data is sent to a **Next.js web application** hosted on **Vercel** for storage and visualization. The backend uses **Supabase** as its database, and a cron job is set up to manage daily data resets.
---
## Table of Contents
- [General Architecture](#general-architecture)
- [Getting Started](#getting-started)
- [Folder Structure](#folder-structure)
- [ESP32 Setup](#esp32-setup)
- [Web Application Setup](#web-application-setup)
- [How It Works](#how-it-works)
- [ESP32 Data Logging](#esp32-data-logging)
- [Daily Reset with Cron Job](#daily-reset-with-cron-job)
- [Technologies](#technologies)
- [Feedback](#feedback)
---
## General Architecture
The system architecture is illustrated below:
.png)
---
## Getting Started
### Folder Structure
- **`esp32/`**: Contains the `.ino` file for the ESP32 setup.
- **`webapp/`**: Contains the Next.js application.
---
### ESP32 Setup
0. **Hardware Setup**:
- Connect the DHT22 sensor to the ESP32 board as follows:
- VCC -> 3.3V
- GND -> GND
- DATA -> 13
- Connect the BMP280 sensor to the ESP32 board as follows:
- VCC -> 3.3V
- GND -> GND
- SCL -> 25 (I2C SCL)
- SDA -> 26 (I2C SDA)
- Connect the MQ135 sensor to the ESP32 board as follows:
- VCC -> SVN
- GND -> GND
- AOUT -> 39
Refer to [this guide](https://randomnerdtutorials.com/esp32-built-in-oled-ssd1306/) for additional ESP32 setup tips.
1. Install the required libraries in the Arduino IDE:
- [DHT Sensor Library](https://github.com/adafruit/DHT-sensor-library)
- [BMP280 Library](https://github.com/adafruit/Adafruit_BMP280_Library)
- [WiFi](https://www.arduino.cc/en/Reference/WiFi)
2. Open the `esp32.ino` file in the Arduino IDE and update the placeholders with your credentials:
```cpp
const char* ssid = ""; // Your WiFi SSID
const char* password = ""; // Your WiFi password
const char* api_key = ""; // API key set in the Next.js app
String serverName = ""; // The deployed Vercel API URL
```
3. Connect the ESP32 to your computer, upload the code, and monitor the serial output for connection status.
### Web Application Setup
1. Clone the repository and navigate to the `webapp/` directory:
```bash
git clone https://github.com/marcelo-schreiber/weather.git
cd weather/webapp
```
2. Go to the `webapp/` directory and create a `.env` file based on `.env.example`:
```bash
cp .env.example .env
```
3. Update the `.env` file with your credentials.
4. Inside the `webapp/` folder, install the dependencies:
```bash
npm install --force # because of storybook and react 19
```
5. To run the application locally, use the following command:
```bash
npm run dev
```
6. To deploy the application to Vercel, use the following command:
```bash
vercel
```
7. Configure a cron job using [cron-job.org](https://cron-job.org/en/) to send a GET request to `/api/cron` daily at 00:01. Make sure to add a header with the CRON_SECRET:
```bash
Authorization: Bearer
```
---
## Testing the Front-end
Using Storybook, you can test the components in isolation, this was used because it is a simple way to test the components without having to run the entire application.
The components are all the cards and charts that are displayed on the main page.
1. To run Storybook, use the following command:
```bash
npm run storybook
```
The Storybook will be available at `http://localhost:6006/`.
## How It Works
### ESP32 Data Logging
- The ESP32 collects data every minute from the DHT22, BMP280, and MQ135 sensors.
- DHT22: Temperature and humidity.
- BMP280: Atmospheric pressure.
- MQ135: Air quality in ppm.
- The collected data is sent as a `POST` request to the `/api` endpoint of the deployed Next.js application. The JSON payload structure:
```json
{
"apiKey": "",
"temperature": 25.5,
"humidity": 60.2,
"pressure": 1013.25,
"airQuality": 120
}
```
- The Next.js app validates the request using the API key and stores the data in a Supabase database.
### Daily Reset with Cron Job
- A cron job sends a GET request to the `/api/cron` endpoint daily at 00:01.
- The `/api/cron` handler:
- Calculates the mean and median for the data collected in the last 24 hours.
- Resets the daily data into a single summary record.
---
## Technologies
- **ESP32 Wemos Lolin32**: Microcontroller board with built-in Wi-Fi and Bluetooth.
- **DHT22 Sensor**: Digital temperature and humidity sensor.
- **BMP280 Sensor**: Atmospheric pressure sensor.
- **MQ135 Sensor**: Air quality sensor.
- **Next.js**: React framework for building web applications.
- **Vercel**: Cloud platform for static sites and serverless functions.
- **Supabase**: Open-source Firebase alternative for databases and authentication.
- **Cron-job.org**: Free online cron job service.
---
## Feedback
If you have feedback or suggestions, feel free to reach out at `marcelorissette15@gmail.com`.
---