Integrate Xiaomi Air Quality Monitor into Home Assistant

S.C.O.R.E. → Safety → Security

Overview

The Xiaomi Air Quality Monitor provides real-time data on indoor air quality, including pollutants like PM2.5 and volatile organic compounds (VOCs). Integrating this device into Home Assistant allows homeowners to monitor air quality remotely, receive alerts on unhealthy levels, and automate responses for better living conditions.

Benefits

• Improved indoor air quality monitoring for a healthier home environment.
• Automated alerts notifying users of poor air quality levels.
• Integration with other smart home devices for automated responses, such as activating air purifiers.

Intent

This capability aims to enhance the home environment by providing continuous monitoring of air quality. By integrating the Xiaomi Air Quality Monitor, users can make informed decisions to improve their indoor air conditions.

Preconditions

• Xiaomi Air Quality Monitor (cgllc.airmonitor.b1) is installed and powered on.
• Home Assistant is set up and configured to support new integrations.
• Stable Wi-Fi connection for the monitor and Home Assistant.
• Home Assistant installed and configured.
• Integration available and authenticated: Zigbee2MQTT.
• Device installed and reachable: Smoke Detector and Alarm Trigger.

Actors

• Homeowner checking air quality levels
• Family members receiving alerts on air quality changes
• Guests experiencing a healthier indoor environment

Trigger

The capability is triggered when the air quality monitor detects a change in air quality levels that exceeds predefined thresholds.

Workflow Diagram

flowchart TD
    A[Air Quality Change Detected] -->|check| B{{Is Air Quality Poor?}}
    B -->|Yes| C[Send Alert to Homeowner]
    C --> D[Activate Air Purifier]
    B -->|No| E[Monitor Continues]

Workflow Description

1. Initialize Monitor

The Xiaomi Air Quality Monitor starts measuring air quality parameters upon power-on.

2. Detect Air Quality Change

The monitor continuously detects and analyzes air quality levels in real time.

3. Send Alert

If the air quality exceeds safe levels, an alert is sent to the homeowner’s device.

4. Automate Response

Home Assistant can trigger automated actions, such as turning on an air purifier or notifying other family members.

5. Log Data

Air quality data is logged for historical analysis, allowing users to track changes over time.

Postconditions

The air quality monitoring system remains active, continuously assessing air quality and responding to changes appropriately.

Optional Enhancements

• Integrate with smart thermostat for optimal HVAC adjustments based on air quality.
• Create a dashboard in Home Assistant to visualize air quality trends.
• Set up voice notifications through smart speakers when air quality changes.

Recommended Components

Source Examples

• 2026.1: Home is where the dashboard is ?? – Home Assistant (homeassistant)