A comprehensive indoor air quality monitor, capturing Temperature, Relative Humidity, CO2 (ppm), VOC (Index), and PM 1.0, 2.5, 4.0, 10 (ug/m3)
Schematic and PCB designed using KiCad. Schematic, PCB design, and manufacturing files can be found under Aeroq Hardware/
Two 3D printed components are required for the assembly. Model files can be found under Aeroq Enclosure/
Source code for ESP32 firmware, developed with PlatformIO. Can be found under Aeroq Firmware/
| Item | Link |
|---|---|
| Custom PCB Order | PCBWay |
| SEN54 (VOC/PM) Sensor | Sensirion |
| Enclosure 3D Print Files | Printables |
| 3.7" 240x416 E-Paper Display | GoodDisplay |
| JST GH 6 Pin Connector | Adafruit |
This project uses PlatformIO, a plugin for VSCode that streamlines ESP32 development. The firmware is written in C++ and targets the ESP32-C3 microcontroller.
-
Install VSCode
Download and install Visual Studio Code. -
Install PlatformIO
In VSCode, open the Extensions tab (Ctrl+Shift+X), search for PlatformIO IDE, and install it. -
Clone this Repository
git clone https://github.com/EnriqueNeyra/Aeroq.git cd "Aeroq/Aeroq Firmware"
-
Open Project in PlatformIO
- In VSCode, go to File > Open Folder
- Select the
Aeroq Firmware/directory.
-
Connect the ESP32-S3
- Use a USB-C cable to connect the board to your computer.
- Ensure the correct COM port/device is available
- The monitor_port configuration value may need to be changed in the platformio.ini file
-
Build and Upload
In PlatformIO, use the toolbar at the bottom:- Build: Compile the firmware
- Upload: Flash firmware to the ESP32-C3
-
Monitor Serial Output (Optional)
- Use the PlatformIO Serial Monitor to view sensor readings
- Default baud rate:
115200
4. Orient the PCB so that it sits against the back of the display. This CAD assembly image illustrates the correct component orientation
5. Press the enclosure shut. The USB-C port should be visible and accessible through the slot at the rear
Simply plug the device in using any USB-C cable/power supply (minimum 5V 1A), and wait for the initialization to complete.
For optimal measurement accuracy, keep it away from heat sources (electronics, lights, etc) and in an area with minimal clutter.
This project (hardware, design files, and firmware) is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.