Natural cooling

[jchapuis]

A proposal to surface the endpoint

https://api.viessmann.com/iot/v2/features/installations/{installation_id}/gateways/{gateway_id}/devices/0/features/heating.circuits.1.operating.modes.cooling

Afaik this returns a boolean flag that allows to determine whether natural cooling is currently running, which can be helpful to automate opening up valves

[CFenner]

There is already the getActiveProgram which you can already use to compare yourself.

https://github.com/somm15/PyViCare/blob/6c5b023ca6c8bb2d38141dd1746dc1705ec84ce8/PyViCare/PyViCareHeatingDevice.py#L591-L593

One could also add a generic function like this to handle it for all programs:

https://github.com/somm15/PyViCare/blob/6c5b023ca6c8bb2d38141dd1746dc1705ec84ce8/PyViCare/PyViCareHeatingDevice.py#L459-L464

[jchapuis]

thanks! actually, these endpoints do not seem to deliver enough details. What I'm looking for are not settings but whether the circulation pump is currently pumping heat down into the ground, so that I can open up all the floor heating valves.

"uri": "https://api.viessmann.com/iot/v2/features/installations/{}/gateways/{}/devices/0/features/heating.circuits.1.operating.programs.active",
        "properties": {
            "value": {
                "type": "string",
                "value": "reduced"
            }
        },

 "uri": "https://api.viessmann.com/iot/v2/features/installations/{}/gateways/{}/devices/0/features/heating.circuits.1.operating.modes.active",
        "properties": {
            "value": {
                "type": "string",
                "value": "dhwAndHeatingCooling"
            }
        },

[CFenner]

Sorry, I mixed up program and mode. But there is also a function getActiveMode.

Maybe your problem can be solved with comparing temperature.supply and temperature.return sensor values?

[jchapuis]

Sorry, I mixed up program and mode. But there is also a function getActiveMode.

Maybe your problem can be solved with comparing temperature.supply and temperature.return sensor values?

good hint! i could also compound this with the circulation pump running, as natural cooling only uses the pump. However, since the API seems to have this flag to indicate cooling operation currently running, would have been nice to surface this.
I have yet to observe API values during real operations as summer hasn't arrived yet, so I'll report back when this happens. I could also work on a PR to surface that flag, if that would be a welcome addition.

[bartcortooms]

I found that for our Vitocal 222-G, I can determine whether it's in natural cooling mode by looking at the value for heating.circuits.0.temperature as returned by the API. If the target temperature is 18, then it's doing natural cooling. When it's 40, it's heating. When it's 0, it's neither cooling nor heating.

It seems PyViCare doesn't currently support getting the target temperature of a heating circuit though?

    {
      "feature": "heating.circuits.0.temperature",
      "gatewayId": "xxx",
      "deviceId": "0",
      "timestamp": "2025-06-07T11:52:12.081Z",
      "isEnabled": true,
      "isReady": true,
      "apiVersion": 1,
      "uri": "https://api.viessmann.com/iot/v2/features/installations/xxx/gateways/xxx/devices/0/features/heating.circuits.0.temperature",
      "properties": {
        "value": {
          "type": "number",
          "value": 18,
          "unit": "celsius"
        }
      },
      "commands": {}
    },

[bartcortooms]

I added the target temperature for heating circuits here: #560. I've found this useful for determining whether natural cooling is active.

[lackas]

PR #689 adds several methods useful for detecting and monitoring natural cooling:

• getCircuitTemperature() - circuit target temperature (18°C = cooling, 40°C = heating per @bartcortooms observation)
• getCoefficientOfPerformanceCooling() - COP for cooling mode
• CoolingCircuit class with getType() and getReverseActive()

This covers the use case of detecting when natural cooling is active.