README.md

iaq-node

Indoor air quality (IAQ) data acquisition (DAQ) node running ESPHome.

This is the software for an always-on measurement node that publishes data over a home network to a Home Assistant server.

Hardware

• TTGO T-Display ESP32 (Wi-Fi/BLE) dev board
• Plantower PMS3003 laser airborne particle counter
• SVM30-J sensor module (SGP30 VOC gas sensor with SHTC1 temperature/humidity sensor)
• SCD30 NDIR CO₂ gas sensor

Software

1. Copy and edit secrets.yaml from secrets.yaml.example template

• api_encryption_key is a random 32-byte pre-shared key in base64

2. Edit site.yaml if necessary to configure node names and IDs
3. pipenv install
4. pipenv run esphome run iaq-node.yaml