home-assistant.io/source/_integrations/airgradient.markdown

title, description, ha_category, ha_config_flow, ha_release, ha_iot_class, ha_codeowners, ha_domain, ha_platforms, ha_integration_type, ha_zeroconf

title	description	ha_category	ha_config_flow	ha_release	ha_iot_class	ha_codeowners	ha_domain	ha_platforms	ha_integration_type	ha_zeroconf
AirGradient	Instructions on how to setup AirGradient devices in Home Assistant.	Health Sensor Update	true	2024.6	Local Polling	@airgradienthq @joostlek	airgradient	button diagnostics number select sensor switch update	device	true

The AirGradient integration will fetch data from your AirGradient devices. AirGradient creates indoor and outdoor air quality monitors that enable you know if the air quality is healthy or not. They measure metrics such as PM2.5, CO2, TVOCs, and NOx. Both the software and hardware are open-source, allowing you to customize or extend the device functionality.

{% important %} In order for the device to be set up or discovered by Home Assistant, the firmware version should be at least 3.1.1. {% endimportant %}

{% include integrations/config_flow.md %}

{% configuration_basic %} Host: description: "The IP address or hostname for your AirGradient device." {% endconfiguration_basic %}

Available sensors

The integration will fetch data from each device. The following sensors are supported:

• Carbon dioxide
• Humidity
• Nitrogen index
• PM0.3 count
• PM1 density
• PM2.5 density
• PM10 density
• Raw nitrogen
• Raw total volatile organic compounds
• Raw PM2.5
• Signal strength
• Temperature
• Total volatile organic compounds index

A number of configuration entities are available as sensors to automate with if you control the device via the AirGradient dashboard instead of set it to control locally.

• CO2 automatic baseline calibration days
• NOx learning offset
• Total volatile organic compounds learning offset
• Data used for the LED bar
• LED bar brightness
• Display temperature unit
• Display brightness

Available configuration entities

The integration provides a few configuration entities to customize the device experience. The settings are only available when the configuration source is set to local. The following entities are supported:

• Display temperature unit
• Display brightness
• LED bar brightness
• Requesting CO2 calibration
• Requesting LED bar test
• Toggling sharing metrics with AirGradient
• Configuration source
• Data used for the LED bar
• Display PM standard
• CO2 automatic baseline calibration days
• NOx learning offset
• Total volatile organic compounds learning offset

Removing the integration

This integration follows standard integration removal, no extra steps are required.

{% include integrations/remove_device_service.md %}