Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/infra-blue/esp32-weatherstationrtc
ESP32 based desk clock with DS3231, BME280 and BH1750
https://github.com/infra-blue/esp32-weatherstationrtc
arduino bh1750 bme280 clock cpp ds3231 electronics esp32 esp32-arduino max7219 platformio weather-station
Last synced: 2 months ago
JSON representation
ESP32 based desk clock with DS3231, BME280 and BH1750
- Host: GitHub
- URL: https://github.com/infra-blue/esp32-weatherstationrtc
- Owner: infra-blue
- License: gpl-3.0
- Created: 2024-06-17T14:12:14.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-10-30T12:35:33.000Z (2 months ago)
- Last Synced: 2024-11-07T10:03:44.056Z (2 months ago)
- Topics: arduino, bh1750, bme280, clock, cpp, ds3231, electronics, esp32, esp32-arduino, max7219, platformio, weather-station
- Language: C++
- Homepage:
- Size: 56 MB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ESP32-WeatherStationRTC
This project is an ESP32-based desk clock with functionality of monitoring the temperature, atmospheric pressure and humidity in the air. The display is auto dimmed. It is coded using the arduino framework.
## Features
- **Time and date:** Utilizes the DS3231 RTC module for accurate timekeeping and displays the current time and date.
- **Temperature, Humidity, and Pressure Measurement:** Uses the BME280 sensor to measure and display the current temperature, humidity, and pressure.
- **Beep Sound**: Every hour the buzzer beeps.
- **Automatic Brightness Adjustment:** Adjusts the LED matrix display brightness based on the ambient light level detected by the BH1750 sensor.
- **WiFi Time Sync:** In case the RTC loses power, the device attempts to sync the time via an NTP server over WiFi.
- **Button Control:** A button allows cycling through the display modes and turning the display on/off with a long press.
- **Web Server**: A web server for change the clock settings.
## Requirements
### Hardware Requirements
- **ESP32** (other arduino compatible boards are okay, just change the pins)
- **MAX7219** LED matrix module (8 devices needed)
- **DS3231** Real-Time Clock module
- **BME280** sensor module (temperature, humidity, pressure)
- **BH1750** light sensor module
- **Passive Buzzer**
- **(OPTIONAL) PushButton** (the default button is the BOOT button in the ESP32-DevKitC V4 devboard)
### Software Requirements
- **PlatformIO**
- **Python3**
## Setup
### **Software Setup:**
- Install the PlatformIO IDE or PlatformIO CLI (or the VSCode extension, make sure to add ".platformio\penv\Scripts" in your path).
- Connect the board to your computer.
- Change the configuration in ```data/config.json```.
- Build the filesystem and upload it with ```pio run --target uploadfs``` (make sure you have set the pins and addresses correctly in the configuration file, the other settings are changeable via web interface).
- Compile and upload the firmware to your ESP32 board ```pio run --target upload```.
### **Hardware Setup:**
- The reference board is an ESP32-DevKitC V4
| PushButton | ESP32-DevKitC V4 |
| ----------- | ----------- |
| + | 0 |
| - | GND |
**N.B.** The PIN 0 is the one used by the BOOT button on the ESP32-DevKitC V4 devboard so it's not necessary using an external push button.
| Buzzer | ESP32-DevKitC V4 |
| ----------- | ----------- |
| + | 25 |
| - | GND |
| I2C DEVICES| ESP32-DevKitC V4 |
| ----------- | ----------- |
| VCC | 3V3 |
| GND | GND |
| SCL | 22 |
| SDA | 21 |
| MAX7219 (SPI Interface) | ESP32-DevKitC V4 |
| ----------- | ----------- |
| VCC | 5V |
| GND | GND |
| CLK | 18 |
| DIN | 23 |
| CS | 5 |
**N.B.** The two 4 devices displays needs to be connected like this:
# 
## Settings
- **WiFi**: you can set your network ssid and password or leave it blank (the clock tries to connect to the first open AP it finds). You can only set the ssid for an open AP.
- **Supported languages**: english, italian, spanish, german, french.
- **Timezone**: Timezone.h TimeChangerule format.
## First boot
At the first boot the display shows "POWER LOST" and if you push the button it tries to connect to your wifi to sync the RTC with an NTP server.
**So:**
- Set up an AP (mobile hotspot is ok).
- Press the push button on the clock.
- Wait for it to connect to the server.
- Press the button again.
**IMPORTANT**: this procedure is necessary whenever the DS3231 loses power (i.e. when the battery runs out or one is not inserted and the ESP32 loses power).
## Usage
- The device will automatically display the time and temperature upon startup.
- Press the button to cycle through the different display modes:
- time & temperature (in Celsius)
- date (DDD DD MMM YYYY)
- humidity & pressure (in hPa)
- Hold the button for more than 500ms to turn off the display. Press again to turn it back on.
## WebServer
You can reach the web server connecting to
- SSID:```ESP32WeatherStation```
- PASSWORD: ```SuP3r_S3cr3t_P@ssw0rd!```
at the ```10.10.10.10``` IP address.
## Home page
## Settings page
## License
This project is licensed under the GNU GENERAL PUBLIC LICENSE - see the LICENSE file for details.
## Credits
[Leonardo Mirabella](https://github.com/infra-blue)