AirGradient

Air quality from the sensor’s local API.

In a dashboard file: a connection with "driver": "airgradient", its settings in config, and what a data source of it reads in that data source’s params (Connections and data sources).

Example

A dashboard with a connection of this driver, named air, and a tile that reads it. Any number of tiles can read the same connection. In the editor, the values of params are picked from what the connection lists; ids in the example are made up.

{
    "schemaVersion": 4,
    "connections": { "air": { "driver": "airgradient", "config": { "host": "192.168.1.90" } } },
    "screens": [
        {
            "name": "Home",
            "tiles": [
                {
                    "type": "value",
                    "label": "CO₂",
                    "layout": { "x": 1, "y": 1, "width": 2, "height": 2 },
                    "dataSource": { "connection": "air", "params": { "attribute": "co2" } },
                    "options": { "unit": "ppm" }
                }
            ]
        }
    ]
}

Settings (config)

Field	Type	Default	What
host	text	required	The sensor, for example 192.168.1.90.
altitude	number		Metres, for the CO2 correction.
refreshInterval	number, above 0		Seconds between refreshes.

What a data source reads (params)

Field	Type	Default	What
attribute	text	required	Reading. Which measurement, as a running average, or its trend.