Thema "Betreff: Important adjustment in IoT features: Split heating circuits and domestic hot water" in Announcements

Important adjustment in IoT features: Split heating circuits and domestic hot water

CustomerCareMichael — Thu, 24 Nov 2022 08:38:23 GMT

In our API we have coupled heating circuits (HC) and domestic hot water (DHW) support closely together to keep the backwards compatibility between Legacy devices and devices based on our Viessmann One Base control platform, also called E3. Viessmann One Base provides the HCs and DHW as independent systems with a chance to access HC- and DHW-features as independent features.

What is being adjusted?

The planned adjustments brings the following changes to our IoT features:

adjust heating.circuits.N.operating.modes.* by removing existent DHW dependencies
remove heating.circuits.N.operating.modes.dhw* operating modes
adjust heating.circuits.N.operating.modes.active to only show the following states for the “value” property: auto, heating, cooling, heatingCooling or testMode

The DHW operating can in future be requested through the following new features:

introduce heating.dhw.operating.modes.off >> Shows whether the DHW is off
adjust heating.dhw.operating.modes.active >> Shows the current DHW operating mode with the possible states for the “value” property: balanced, comfort, eco, off

This change only affects our Viessmann One Base (E3) control platform (wifi integrated devices). For legacy devices, i.e. using a Vitoconnect, there are no changes. However, this also means, depending on the device, requesting and changing the DHW operating mode differs.

How to find out which device (legacy / One Base) is used?

To find which device you have, you can use the following request to check the devices of your installation: curl -X GET https://api.viessmann.com/iot/v1/equipment/installations/{{installationID}}/gateways/{{gatewaySerial}}/devices/

In the response, you find the list of devices, containing information about the type of device:

{
    "data": [
        {
            "gatewaySerial": {{gatewaySerial}},
            "id": {{deviceId}},
            "boilerSerial": {{boilerSerial}},
            "boilerSerialEditor": "DeviceCommunication",
            "bmuSerial": null,
            "bmuSerialEditor": null,
            "createdAt": "2020-11-16T07:06:56.267Z",
            "editedAt": "2022-10-27T11:16:06.670Z",
            "modelId": "E3_Vitodens_300_0421",
            "status": "Online",
            "deviceType": "heating",
            "roles": [
                "capability:backup;0002_HMU_VD3",
                "type:E3",
                "type:boiler",
                "type:product;Vitodens_300"
            ]
        },
    ]
}

The “roles” parameter lists the different types the device is assigned to. Here, you will find either the type:E3 or type:legacy. This information then tells you how to check the DHW operating modes.

When will this change take effect?

The adjustments will go live January 2023 (exact date will be added as soon as possible). From this date, you can only request the DHW operating mode for E3 using the described new way.

Betreff: Important adjustment in IoT features: Split heating circuits and domestic hot water

BrechtM — Sat, 14 Jan 2023 16:00:15 GMT

Hi, is it possible this change has been implemented yesterday? It was not listed on the changelog but something seems to have changed.

I am having issues controlling my vitodens burner as I used to, as do other people controlling their boiler using home automation.

Betreff: Important adjustment in IoT features: Split heating circuits and domestic hot water

Reinhard4 — Sat, 14 Jan 2023 20:37:55 GMT

As of yesterday, or the day before, Home Assistant did no longer report the actual hot water temperatur.

The problem was in the are of "water_heater.vicare_water", showing the value Unknown.

I upgraded to HA 2023.1.4 today and the problem disappeared.

-Reinhard

Betreff: Important adjustment in IoT features: Split heating circuits and domestic hot water

Lala_OK — Sun, 15 Jan 2023 09:13:22 GMT

What the hell is really going on?

Was zum Teufel ist wirklich los?

Betreff: Important adjustment in IoT features: Split heating circuits and domestic hot water

ArrowX — Mon, 16 Jan 2023 16:51:47 GMT

My home automation is also not working after the rollout of this breaking change in the API.

@CustomerCareMichael : Can you give an example on how to set the operating modes "dhw" and "dhwAndHeating" with the new API?

Betreff: Important adjustment in IoT features: Split heating circuits and domestic hot water

CustomerCareMichael — Tue, 17 Jan 2023 14:06:07 GMT

Hi, thanks for reaching out. The change was announced in November here as well as in the Changelog and the emailing that was sent out in December as well, forwarding to the news article in the Developer Portal.

For the new type of heating systems (type = E3), the operating modes of the heating circuit and of the domestic hot water (DHW) were split. To see/change the operating mode of the DHW, you now need to use the features heating.dhw.operating.modes.*. For example to check the currently active operating mode of the DHW, you now use heating.dhw.operating.modes.active. The new features for the DHW operating modes are

heating.dhw.operating.modes.active
heating.dhw.operating.modes.balanced
heating.dhw.operating.modes.comfort
heating.dhw.operating.modes.eco
heating.dhw.operating.modes.off

For further communication and if anything is not working, please use the other areas of the Developer area of this forum. Thanks for your understanding!

Best regards,

Michael