Renson Healthbox

Air flow, temperature, humidity, CO₂ and VOC per room of a Renson Healthbox 3.0 ventilation unit, from its local API, with a room’s boost.

In a dashboard file: a connection with "driver": "renson", 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 healthbox, 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": {
        "healthbox": { "driver": "renson", "config": { "host": "192.168.1.60" } }
    },
    "screens": [
        {
            "name": "Home",
            "tiles": [
                {
                    "type": "value",
                    "label": "Bedroom CO₂",
                    "layout": { "x": 1, "y": 1, "width": 2, "height": 2 },
                    "dataSource": {
                        "connection": "healthbox",
                        "params": { "tag": "device", "tagValue": "1", "attribute": "co2" }
                    },
                    "options": { "unit": "ppm" }
                }
            ]
        }
    ]
}

Settings (config)

Field	Type	Default	What
host	text	required	The Healthbox, for example 192.168.1.60.
port	whole number, 1 to 65535		80 when left out.
key	text		API key. The Healthbox’s API key, from Renson; left out, none is sent. A credential.
refreshInterval	number, above 0		Seconds between refreshes.

What a data source reads (params)

Field	Type	Default	What
tag	device	required	Tag. Readings are told apart by their device.
tagValue	text	required	Room. One of the Healthbox’s rooms.
attribute	text		Reading. The air flow, temperature, humidity, CO₂, VOC, or the boost; all of them, as a record, when left out.