AirGradient ONE is an open-source air quality monitor with local control. This guide covers setup and accuracy issues.
WiFi Setup Issues
- Device creates "AirGradient-xxx" hotspot initially
- Connect phone to device hotspot
- Configure WiFi via captive portal
- Requires 2.4GHz network
- Factory reset: Hold button 10+ seconds
Not Sending Data
- Check WiFi connection on display
- Verify AirGradient dashboard shows device
- Local API accessible at device IP
- Check firewall isn't blocking port 80
- Restart device if stuck
Home Assistant Integration
- Use RESTful sensor or AirGradient integration
- Local API endpoint: http://[IP]/measures/current
- JSON response with all sensor values
- Set scan interval to 30-60 seconds
- Alternatively use ESPHome firmware
ESPHome Firmware
- AirGradient supports custom ESPHome firmware
- Enables full local control without cloud
- Flash via USB-C connection
- Community configs available on GitHub
- Preserves all sensor functionality
PM2.5 Readings Seem High
- PMS5003 sensor needs 30 second warmup
- Place away from direct airflow
- Clean inlet with compressed air monthly
- Compare with outdoor AQI for reference
- Cooking and candles spike PM readings
CO2 Calibration
- Senseair S8 auto-calibrates weekly
- Needs exposure to fresh air occasionally
- Manual calibration available in firmware
- Baseline should be ~415 ppm outdoors
- Avoid breathing near sensor during calibration