abbrechen
Suchergebnisse werden angezeigt für 
Anzeigen  nur  | Stattdessen suchen nach 
Meintest du: 

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

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...

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.

5 ANTWORTEN 5

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.

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.

Reinhard4_0-1673728577108.png

-Reinhard

What the hell is really going on?

Was zum Teufel ist wirklich los?

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

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

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