HectorziN - Domótica y Home Assistant
Blog de HectorziN

Complete Guide: AirGradient O-1PST Outdoor Air Quality Sensor and Home Assistant

Ever wondered if the air you let into your home when you ventilate is actually healthy? In home automation we often focus on the indoors, but the AirGradient Open Air O-1PST changes the game. This professional-grade open-source sensor integrates seamlessly with Home Assistant, letting you make smart decisions based on real environmental data.

On YouTube I share more tutorials, hands-on tests and real smart home setups. Subscribe on YouTube

AirGradient O-1PST outdoor air quality sensor and Home Assistant

Related video on YouTube

Video

1. What makes the AirGradient O-1PST special?

Unlike other sensors, the O-1PST is a 9-in-1 monitor capable of accurately measuring:

  • Particulate matter: PM0.3, PM1, PM2.5 and PM10.
  • Gases and pollutants: CO2 (carbon dioxide), TVOC (total volatile organic compounds) and NOx (nitrogen oxides).
  • Environmental variables: Temperature and humidity, essential to contextualize air quality.

2. Step-by-step assembly (DIY kit version)

If you're a DIY enthusiast, the kit not only saves money but lets you get to know the heart of your device. For a flawless build, follow AirGradient's official documentation, which details strategic placement of the SGP41 and S8 sensors to avoid interference.

Assembly essentials:

  • Ensure the UV-resistant enclosure is properly sealed.
  • Correct orientation of the particle sensors to allow proper airflow.
  • Quick Wi-Fi setup (note the access point times out after 3 minutes).

Visit the assembly tutorial page for step-by-step guidance.

3. Integration with Home Assistant: Local power

The magic happens when you connect the AirGradient to Home Assistant. Thanks to its native integration, the device is discovered automatically.

Professional dashboard and code

Don't settle for the default cards. To visually get the most from your data, we recommend using Mushroom Cards and Button Card (available via HACS).

  • Panel code: You can replicate the exact dashboard from my videos using this GitHub Gist.
  • Reference dashboard: If you want to see how the data appears on the official platform, check out the AirGradient Demo Dashboard.

4. Smart automations

Why stop at charts? With the O-1PST in your system, you can create automations that improve your daily life:

  1. Health protection: If PM2.5 levels exceed 15 µg/m³, Home Assistant can send a critical mobile notification or announce by voice: "Outdoor air quality is poor, keep windows closed".
  2. Efficient ventilation: Only allow the mechanical ventilation system (VMC) to bring in outside air if NOx and TVOC levels are low.
  3. Safe exercise: An entryway light that turns red if it's not recommended to go running due to pollution.

Where to buy

If you are interested in any of the options mentioned, here are the available links:

5. Conclusion: DIY kit or factory-assembled version?

The choice depends on your needs. The assembled version offers official certifications (CE, FCC) and factory calibration, ideal for professional environments or if you want a hassle-free option. The DIY kit is the perfect choice for the home automator looking for the best value and the satisfaction of building a precision weather station.

Related video