ryanaross / aqi-display

Combine a TTGO T-Display (esp32) and a Plantower PMS7003 Air Quality Sensor to make a low cost, indoor AQI Display.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

AQI Display

A small box which will display the Air Quality Index based on the US EPA formula, using a $15 sensor and $10 microcontroller and display. As the AQI climbs, the background color changes, matching the colors used on PurpleAir. The display is a 1.1" TFT, bright enough to be seen in daylight from across a large room.

t-display image

Features

  • 30 seconds of data gathering and averaging of particle count to calculate AQI
  • Color changing background based on AQI value
  • Displays latest calculated value every 1 minute for the first 30 minutes. Then goes into a Sleep Mode to preserve the sensors fan, calculating a new AQI value every 30 minutes.
  • Written in micropython, everything is easily configurable.
  • Front button to begin gathering on demand
  • Can be made portable with the use of a USB Power Bank

Assembly

Parts Required:

  1. LILYGO® TTGO T-Display ESP32 aliexpress

t-display image

  1. Plantower PMS7003 Air Quality Sensor + G7 Adapter aliexpress

t-display image

Software

Easiest way to setup the software is to hook up the T-Display to a computer running Thonny and follow these instructions to flash this custom firmware, which includes drivers for writing to the display included with the T-Display device.

Then you can copy to the device all the *.py files from this repository and customize them if required.

Hardware

Attach the G7 Adapter to the PMS7003 sensor, it will only fit one way. Connect the included cable to the adapter and cut off the other end to expose the wires. Strip, connect and solder the following connections:

PMS7003 T-Display
VCC 5V
GND G
RX 26
TX 25

The T-Display schematic can be found here.

Case

The two components can be taped together quite easily. But if you have access to a 3d printer you can use the included STL files (in the case/ directory) to print a case and fit the components inside. It uses a sliding dovetail top which can be printed separately.

case]

About

Combine a TTGO T-Display (esp32) and a Plantower PMS7003 Air Quality Sensor to make a low cost, indoor AQI Display.


Languages

Language:Python 100.0%