https://github.com/sibyx/vogon-air-sensor
Air pollution sensor using ESP32, DHT22 and SDS011 writen in ESP-IDF
https://github.com/sibyx/vogon-air-sensor
air-pollution esp-idf esp32
Last synced: 5 days ago
JSON representation
Air pollution sensor using ESP32, DHT22 and SDS011 writen in ESP-IDF
- Host: GitHub
- URL: https://github.com/sibyx/vogon-air-sensor
- Owner: Sibyx
- License: gpl-3.0
- Created: 2024-06-22T20:30:18.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-06-23T16:11:25.000Z (over 1 year ago)
- Last Synced: 2025-04-01T19:44:09.252Z (7 months ago)
- Topics: air-pollution, esp-idf, esp32
- Language: C
- Homepage:
- Size: 25.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# VogonAirFirmware
VogonAirFirmware is a simple air pollution sensor firmware for ESP32, developed using ESP-IDF. It reads data from
DHT22 (temperature and humidity sensor) and SDS011 (particulate matter sensor), and sends the measurements to a
server using MQTT and WiFi for further processing.
**Work in progress**
## Features
- Reads temperature and humidity data from DHT22 sensor
- Reads particulate matter (PM2.5 and PM10) data from SDS011 sensor
- Sends sensor data to a server via MQTT
- Connects to WiFi for internet connectivity
- Easy configuration and setup
## Hardware Requirements
- ESP32 development board
- DHT22 temperature and humidity sensor
- SDS011 particulate matter sensor
- Breadboard and jumper wires for connections
- Power supply (5V USB or battery)
## Software Requirements
- [ESP-IDF](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html) (Espressif IoT Development Framework)
- MQTT broker (e.g., Mosquitto)
- MQTT client for testing (e.g., MQTT.fx, MQTT Explorer)
## Installation
Follow the [official ESP-IDF setup guide](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
to install ESP-IDF and set up your development environment.
**Clone the Repository**
```sh
git clone https://github.com/Sibyx/vogon-air-sensor
cd vogon-air-sensor
```
**Configure the Project**
Use `idf.py menuconfig` to configure your project settings, such as WiFi credentials and MQTT server details.
**Build and Flash the Firmware**
```shell
idf.py build
idf.py flash
```
## Configuration
Configuration is done via the `menuconfig` tool. Key configuration options include:
## MQTT Topics and messages
By default, the firmware publishes sensor data to the following MQTT topic: `vogonair/:mac_address/raw`.
The compatible server configuration is in repository
[vogon-veggie-collector](https://github.com/Sibyx/vogon-veggie-collector).
---
Feel free to contribute to this project by creating issues, submitting pull requests, or suggesting improvements.
Happy hacking!