Imported from GitHub: EnriqueNeyra/Aeroq · commit ae79cdc

Description

An Indoor Air Quality Monitor Powered by ESP32, SCD40, and SEN54

README

Aeroq

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)

Contents

• Project Overview
• Required Hardware
• Firmware Setup
• Assembly
• Using Aeroq

---

Project Overview

Hardware

Schematic and PCB designed using KiCad. Schematic, PCB design, and manufacturing files can be found under Aeroq Hardware/

Enclosure

Two 3D printed components are required for the assembly. Model files can be found under Aeroq Enclosure/

Firmware

Source code for ESP32 firmware, developed with PlatformIO. Can be found under Aeroq Firmware/

---

Required Hardware

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

---

Firmware Setup

This project uses PlatformIO, a plugin for VSCode that streamlines ESP32 development. The firmware is written in C++ and targets the ESP32-C3 microcontroller.

Steps

1. Install VSCode
   Download and install Visual Studio Code.

2. Install PlatformIO
   In VSCode, open the Extensions tab (Ctrl+Shift+X), search for PlatformIO IDE, and install it.

3. Clone this Repository

   git clone https://github.com/EnriqueNeyra/Aeroq.git
   cd "Aeroq/Aeroq Firmware"
   
   

4. Open Project in PlatformIO

   • In VSCode, go to File > Open Folder
   • Select the Aeroq Firmware/ directory.

5. 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

6. Build and Upload
   In PlatformIO, use the toolbar at the bottom:

   • Build: Compile the firmware
   • Upload: Flash firmware to the ESP32-C3

7. Monitor Serial Output (Optional)

   • Use the PlatformIO Serial Monitor to view sensor readings
   • Default baud rate: 115200

---

Assembly

1. Components should connect as pictured below

2. Insert the SEN54 into the slot in the enclosure, ensuring it is pressed in all the way

3. Place display into frame

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

---

Using Aeroq

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.

License

This project (hardware, design files, and firmware) is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.