Vaillant, Bulex, … heating (myVAILLANT cloud)

Zones as thermostats, hot water and the system of a Vaillant group heating controller (Bulex MiPro Sense, Vaillant sensoCOMFORT, …) through its internet gateway and the brand’s cloud.

In a dashboard file: a connection with "driver": "myvaillant", 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 heating, 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": {
        "heating": {
            "driver": "myvaillant",
            "config": {
                "brand": "bulex",
                "email": "you@example.com",
                "password": "your password"
            }
        }
    },
    "screens": [
        {
            "name": "Home",
            "tiles": [
                {
                    "type": "thermostat",
                    "label": "Living room",
                    "layout": { "x": 1, "y": 1, "width": 2, "height": 2 },
                    "dataSource": {
                        "connection": "heating",
                        "params": {
                            "device": "b1c2d3e4-0000-4000-8000-000000000001/zone/0"
                        }
                    }
                }
            ]
        }
    ]
}

Settings (config)

Field	Type	Default	What
brand	one of bulex, vaillant, sdbg (Saunier Duval), glow-worm, demirdokum (DemirDöküm)		Brand. Whose app the account logs in to; Bulex when left out.
country	one of albania, austria, belgium, bosnia (Bosnia and Herzegovina), bulgaria, croatia, cyprus, czechrepublic (Czechia), denmark, estonia, finland, france, georgia, germany, greece, hungary, ireland, italy, kosovo, latvia, lithuania, luxembourg, moldavia (Moldova), netherlands, new-zealand, north-macedonia, norway, poland, portugal, romania, serbia, slovakia, slovenia, spain, sweden, switzerland, turkiye (Türkiye), ukraine, unitedkingdom, uzbekistan		Country. Where the account is registered; Vaillant and Saunier Duval only.
email	text	required	Email. The login of the brand’s app (MiGo Link, myVAILLANT, …).
password	text	required	Password. Of that login. A credential.
quickVetoHours	number, 0.5 to 24		Temporary set point for. Hours, when a zone’s temperature is set on its schedule; 3 when left out.
refreshInterval	number, above 0		Refresh every. Seconds; 120 when left out (the cloud limits requests).

What a data source reads (params)

Field	Type	Default	What
device	text	required	Device. A zone, the hot water or the system of one of the account’s homes.
value	text		Value. One of its values; all of them, and a zone as a thermostat, when left out.
refreshInterval	number, above 0		Refresh every. Seconds; the connection’s setting when left out.