Open Hardware

Airnode

Airnode is designed like a commercial IoT product. It fuses 9+ sensor modalities into a real-time environmental intelligence platform that computes, calibrates, and visualizes everything on-device.

MCUESP32-S2
DisplayIPS 2.8 240*320
FirmwareESPHome with custom C++ lambda
ModeOffline-first
Airnode enclosure with front display and side ventilation.
Airnode enclosure Fan-assisted chamber
Overview

What Makes It Special

A practical environmental node for local readings, diagnostics, and calibration state.

01

Measures multiple domains

Particulates, CO2, HCHO, VOCs, reducing gases, solvents, temperature, humidity, pressure. A fan and air flow chamber ensure accurate readings of the environment

02

Interprets readings locally

Computes AQI-style scores and worst-case status without needing a cloud service.

03

Tracks calibration state

Uses clean-air gates, stability checks, and bounded baseline updates for MOS gas sensors.

04

Shows status on-device

Five screens cover live readings, gas detail, calibration, a quick guide, and system status.

05

Active-flow sensor chamber

A fan-assisted flow-through sensor chamber that gently draws air across the sensing elements for more consistent exposure and faster response.

06

Monitors its own health

A watchdog checks invalid sensor channels and airflow health so failures are visible.

Supported sensors

Measurement channels

The payload combines reference sensors, gas sensors, and system telemetry.

Parameter / use Sensor Human health relevance
PM1 / PM2.5 / PM4 / PM10Particulate counts plus VOC and NOx indices.Sensirion SEN55Fine particles can reach deep into the lungs and are linked with asthma, cardiovascular stress, and long-term respiratory risk.
CO2Clean-air validation and occupancy signal.Sensirion SCD40High CO2 usually indicates poor ventilation and can correlate with drowsiness, headaches, and reduced cognitive performance.
FormaldehydeHCHO monitoring in ppb.Sensirion SFA30Formaldehyde is an irritant and known carcinogen; exposure can affect eyes, throat, and breathing comfort.
VOC / odorOrganic vapor, odor, toluene, H2S, and ammonia sensitivity.Figaro TGS2602VOCs can trigger irritation, headaches, nausea, and sensitivity reactions, especially in enclosed rooms.
Solvents / ethanolAlcohol and solvent vapor detection.Figaro TGS2620Solvent vapors can irritate airways and may affect the nervous system at higher concentrations.
Reducing gasesCO, H2, NH3, CH4, and related gases.MiCS-5524Acts as an early warning channel for combustion and chemical events; CO and ammonia can become acutely hazardous.
Temperature / humidityReference channel for compensation.Sensirion SHT3X/SHT4XComfort range affects sleep, respiratory comfort, mold risk, and how airborne pollutants behave indoors.
PressureBarometric pressure.Bosch BMP280Not a direct pollutant, but useful context for environmental interpretation and weather-related comfort tracking.
Fan healthRPM monitoring for the sensor chamber.Sunon Fan tachometerConfirms sampled air is moving through the chamber so pollutant readings remain trustworthy.
Calibration

Guarded baseline updates

The ESPHome script runs every minute, waits for warmup, checks clean-air references, accumulates stable Rs samples, then updates Ro baselines.

Clean-air thresholds450 ppm / 120 VOC / 5 PM2.5 / 30 ppb
Stability window5 min, CV <= 5%
Ro update70% candidate / 30% stored
Display

Local screens

The device remains usable without opening an app or dashboard.

Airnode TFT overview screen showing live air quality readings.
Screen 0 / Overview
Controls

Hardware interface

Two buttons handle display brightness and page navigation.

BTN 1 / SHORT

Brightness cycle

Cycles six PWM backlight levels from full brightness to low-light mode.

BTN 1 / LONG

Backlight toggle

Turns the TFT backlight on or off.

BTN 2

Next screen

Cycles through the five dashboard pages.

Files

Project resources

Make one yourself, everything is available on printables.