featurenab/air-sensor

This repository contains everything needed to build a desktop air quality monitor that displays real-time readings on a small e-ink screen. The device measures nine different air quality indicators: fine and coarse particles at several size ranges (PM1, PM2.5, PM4, and PM10), volatile organic compounds, nitrogen oxides, carbon dioxide, temperature, and humidity. All measurements come from the Sensirion SEN66, a single sensor that handles all nine metrics. The electronics are built around an ESP32, a small Wi-Fi-capable microcontroller. The firmware uses ESPHome, a system that lets you configure the device's behavior using a configuration file rather than writing code from scratch. If you use Home Assistant (a popular self-hosted smart home platform), the device connects to it automatically and exposes all its sensor readings as entities you can track, graph, and set alerts for. There are two ways to build this. The minimal version uses an off-the-shelf ESP32 board connected to the sensor with a short cable. No custom circuit board is needed. You can flash the firmware by visiting a website in Chrome, connecting the device via USB, and uploading the pre-built file with a few clicks. The full version adds a custom circuit board (PCB) designed for JLCPCB, a 2.13-inch e-ink display, and a 3D-printed enclosure. The repository includes the PCB design files for ordering, the 3D model files for printing, and the firmware configuration for the display. The README walks through both build paths step by step, including wiring, PCB ordering, 3D printing settings, and firmware installation. The 3D files are also available on Printables and Makerworld if you want to download them directly. A companion Home Assistant dashboard card from a third-party developer is mentioned for displaying the readings in a formatted UI. The project was created alongside a YouTube video tutorial linked in the README. The creator accepts support via Patreon.