Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marcelo-schreiber/weather
A weather logging system using an ESP32 with a DHT22 sensor
https://github.com/marcelo-schreiber/weather
chart dht22 esp32 weather
Last synced: 12 days ago
JSON representation
A weather logging system using an ESP32 with a DHT22 sensor
- Host: GitHub
- URL: https://github.com/marcelo-schreiber/weather
- Owner: marcelo-schreiber
- License: mit
- Created: 2024-11-18T21:09:07.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2024-12-12T23:02:15.000Z (14 days ago)
- Last Synced: 2024-12-12T23:29:25.725Z (14 days ago)
- Topics: chart, dht22, esp32, weather
- Language: TypeScript
- Homepage: https://weather.marcelo-schreiber.com
- Size: 557 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Weather Logger System
[](https://github.com/marcelo-schreiber/weather/blob/master/LICENSE)
[README in portuguese](https://github.com/marcelo-schreiber/weather/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 --legacy-peer-deps
```
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
```
---
## 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 `[email protected]`.
---
## Todo list
- [x] Add other sensors
- [x] Auto reconnect when the ESP32 is disconnected
- [ ] Add testing to the web application
- [ ] Add a Curitiba weather forecast to the web application
- [ ] When air quality sensors are added, add a warning when the air quality is bad (e.g., when the CO2 level is high)
- [ ] Make the ESP32 a webserver with a configuration page and a page to see the real-time data.