Thema "Betreff: Fehlende Datenpunkte" in The Viessmann API

Fehlende Datenpunkte

andreas13 — Wed, 23 Jun 2021 16:27:41 GMT

Hallo,

ich bin der Autor des FHEM Moduls für die Viessmann API. In der neuen API vermisse ich etliche Datenpunkte, die es in der alten API nocht gegeben hat. Z.B.

Abgas
Sensoren
Brenner (Starts, Modulation, ....)
Fehlereinträge
Gas- und Stromverbrauch
und Heizkurve

Ist es geplant die Datenpunkte auch in der neuen API zur Verfügung zu stellen und wenn ja, wann?

Und noch eine zweite Frage, wird an der Dokumentation der API noch gearbeitet? Gefühlt hat sich an der Dokumentation seit Wochen nichts mehr getan und die Dokumentation ist noch sehr rudimentär, was sehr ärgerlich ist zumal die alte API ja schon bald abgeschaltet werden soll.

Viele Grüße
Andreas

Betreff: Fehlende Datenpunkte

phildaub23 — Wed, 23 Jun 2021 16:59:35 GMT

Ich schließe mich an, die Datenpunkte für Brennermodulation und -starts sowie Verbrauch wären schon wichtig zu bekommen.

PS: vielleicht könnt ihr auch die Dokumentation der Features etwas prominenter verlinken, ich hab sie zu Anfang gar nicht gefunden. Wen es interessiert die ist hier zu finden:

https://developer.viessmann.com/en/doc/iot

Betreff: Fehlende Datenpunkte

JueBag — Tue, 06 Jul 2021 07:16:51 GMT

I'm going to second this request.
I'm missing the statistic datapoints (burner-houres and -starts).
I do not see any logical reasoning for that, those are only values, no commands. There can be no harm to the system.
IMHO the removal of such informations from the API, datapoints that are available using the ViCare App, could drive people to extract such data from the app. And this something Viessmann does not want to happen.

Betreff: Fehlende Datenpunkte

AndreasP — Tue, 06 Jul 2021 20:16:06 GMT

Hallo,

ich habe zu diesem Thema schon bei Viessmann via Mail nachgefragt und keine Antwort bekommen.

Ich nutze PyVicare mit einer eigenen Anpassung and die neue API.

Es fehlen die wirklich wichtigen, verbrauchsbezogenen Datenpunkte und auch solche für einen sicheren Betrieb wie z.B der Anlagendruck.

Es fehlen:

device.timeseries

device.timeseries.monitoringIonization

device.zigbee

heating.boiler.sensors.temperature

heating.burner.demand

heating.burner.demand.modulation

heating.burner.demand.temperature

heating.burner.modulation

heating.burner.statistics

heating.burners.0.modulation

heating.circuits.0.circulation.schedule

heating.circuits.0.geofencing

heating.circuits.0.heating.curve

heating.circuits.0.operating.programs.screedDrying

heating.circuits.1.geofencing

heating.circuits.1.heating.curve

heating.circuits.1.operating.programs.screedDrying

heating.circuits.2.geofencing

heating.circuits.2.heating.curve

heating.circuits.2.operating.programs.screedDrying

heating.circuits.3.geofencing

heating.circuits.3.heating.curve

heating.circuits.3.operating.programs.screedDrying

heating.configuration.bufferCylinderSize

heating.configuration.centralHeatingCylinderSize

heating.configuration.dhwCylinderSize

heating.configuration.houseHeatingLoad

heating.configuration.houseLocation

heating.configuration.houseOrientation

heating.configuration.regulation

heating.dhw.pumps

heating.dhw.sensors.temperature

heating.errors

heating.errors.active

heating.errors.history

heating.flue

heating.flue.sensors

heating.flue.sensors.temperature

heating.flue.sensors.temperature.main

heating.gas

heating.gas.consumption

heating.gas.consumption.dhw

heating.gas.consumption.heating

heating.gas.consumption.summary

heating.gas.consumption.summary.dhw

heating.gas.consumption.summary.heating

heating.gas.consumption.total

heating.heat

heating.heat.production

heating.heat.production.dhw

heating.heat.production.heating

heating.heat.production.summary

heating.heat.production.summary.dhw

heating.heat.production.summary.heating

heating.heat.production.total

heating.power

heating.power.consumption

heating.power.consumption.dhw

heating.power.consumption.heating

heating.power.consumption.summary

heating.power.consumption.summary.dhw

heating.power.consumption.summary.heating

heating.power.consumption.total

heating.sensors.pressure

heating.sensors.pressure.supply

heating.solar.power

heating.solar.power.production

heating.solar.statistics

heating.solar.summary

heating.solar.summary.power

heating.solar.summary.power.production

heating.valves

heating.valves.diverter

heating.valves.diverter.heatDhw

Re: Betreff: Fehlende Datenpunkte

MichaelHanna — Thu, 08 Jul 2021 11:23:00 GMT

Hello @andreas13, @JueBag , @AndreasP ,

with the availability of the Developer Portal, we simultaneously look at which features of the API we can make available and in what form. Our API offers various options for obtaining certain data points.

The Developer Portal is ongoing development, you can always state your concrete feedback in the respective section in the developer forum area 🙂

Also, keep in mind that there is a difference between the offering and use of ViCare and the API. We are not planning to 1:1 all functionalities of ViCare through our API.

@AndreasP , your list of features is quite exetensive. As they were only accessible through an unofficial / unauthorized way, we cannot offer the same functionality through the Developer Portal. What would be more interesting is a more concrete explanation of use cases that come with certain functionalities.

To sum it up, the Developer Portal and the offering is in an ongoing development. My recommendation is to first consider the currently available features, however we are happy to take the requests (based on use cases) with us for further investigation.

Best,

Michael

Re: Betreff: Fehlende Datenpunkte

JueBag — Thu, 08 Jul 2021 14:47:10 GMT

@MichealHanna
I am missing data points that would allow monitoring/logging how often and how long the burner is on.
With such a history I could see if my used settings for desired HotWaterSupply temperature and desired RoomTemperature are causing unwanted prolonged burnerhoures/ -starts.

Re: Betreff: Fehlende Datenpunkte

AndreasP — Thu, 08 Jul 2021 21:54:57 GMT

Thanks for the answer (and the parallel e-mails),

I understand that the developer portal is still under development and the change to new auth methods and registered clients is out of the discussion. I also respect the decision not to allow any local access to the API as other vendors allow. Even the rate limit is something that i can deal with.

What I don't understand is why should there a difference between data points the ViCare app can show to the system owner and the API which seems to be widely used in the "unofficial / unauthorized way".

Exactly the consumption parameters and burner stats are the most useful data points.

Since i have my new Vitodens300 installed back in May i was always impressed from the stability of your API and the value that it gives to me. Never used the "set" part, only reading data-points.

Please see the attached graphs build with weewx (yes the weather system) using PyVicare showing me the burner for heating and dhw plus the temperature values and consumption. BTW, I'm doing such graphs as well for my photovoltaic system based on a local api (Solarwatt Energy Manager)

Betreff: Fehlende Datenpunkte

Isi — Tue, 13 Jul 2021 13:24:12 GMT

Ich kann mich nur anschließen,

Abgastemperatur, Modulation, Brennerstarts und Brennerstunden sind für mich die wichtigsten Daten aus der alten API die jetzt leider fehlen.

Somit ist der Mehrwert einer Visualisierung durch eine Gebäudesteuerung zur Analyse des effektiven Betriebs dahin.

Schade dass die API inhaltlich so verschlechtert wurde dass sie jetzt für mich nutzlos wurde...

Betreff: Fehlende Datenpunkte

upset — Tue, 13 Jul 2021 17:09:36 GMT

Ich schließe mich an. Die Abgastemperatur, Brennerlaufzeit/ Modulation wurde von mir ebenfalls verwendet, um das System zu optimieren (Energieeffizienz, Taktung, Laufzeit,..) ..
Die Abgastemperatur ist nach wie vor in der App vorhanden.
Ich sag's ganz ehrlich.. die App ist schön und gut. Aber diese Volatilität und ständiges nachjustieren meiner Lösung an den Viessmann Server führt vermutlich dazu, dass ich nach Ablauf der Garantie auf eine Lokale Lösung umbaue... Eine eigene "Fernwartung" und Push Nachrichten zu programmieren ist ja das geringste Problem.

Betreff: Fehlende Datenpunkte

prior_philip — Tue, 13 Jul 2021 17:18:14 GMT

Yes well... Im owner of a Vitocal200S HeatPump and I could send out a list of missing features from V2 API. But I understand that this API is still WIP.

Nevertheless its hard to understand and accept why most important features like "heating.errors.active" or "setActiveMode" should not be part of public available information.

Betreff: Fehlende Datenpunkte

AndreasP — Thu, 15 Jul 2021 10:00:40 GMT

Hi,

just yesterday I changed from the old to the new API in "production".

I think Viessman was hearing our concerns and was putting back some important data points.

Compared to the first look at v2 API the following is back in the game:

heating.burners.0.modulation
heating.burners.0.statistics
heating.circuits.0.heating.curve
heating.circuits.1.heating.curve
heating.circuits.2.heating.curve
heating.circuits.3.heating.curve
heating.gas.consumption.dhw
heating.gas.consumption.heating
heating.power.consumption
heating.solar.power.production

(Under curve you can find slop and shift, under statistics teh hours and starts)

Still missing:

heating.valves

heating.valves.diverter

heating.valves.diverter.heatDhw

(to distinguish between burner is heating or dhw)

heating.sensors.pressure

heating.sensors.pressure.supply

I need to thank MichaelHanna with the hope getting the remaining things back over time.

Betreff: Fehlende Datenpunkte

nerixs — Thu, 15 Jul 2021 11:24:29 GMT

Hello @AndreasP,

"heating.power.consumption" is functional? There is no information in the documentation.

Hello @MichealHanna,

Could you have the maintenance information and error message display added?

cordially

Re: Betreff: Fehlende Datenpunkte

MichaelHanna — Thu, 15 Jul 2021 11:44:46 GMT

Hi @AndreasP @nerixs ,

we recently added some features that were missing to the basic version of the API. The information we just shared on the Change Log within the Documentation: https://developer.viessmann.com/de/doc/changelog

This is especially to provide you with a smooth transition switching from the old API client to the Developer Portal with your own personal API keys.

Re: Betreff: Fehlende Datenpunkte

Isi — Thu, 15 Jul 2021 14:49:51 GMT

Danke,

Das ist super wie ihr da reagiert habt!

Ich finde das einfach gut wenn man schon so ein Forum hat auch auf die Anforderungen der Mitglieder einzugehen. Da könnte sich manch andere Firma mal was abschauen.

Gruß Isi

Re: Betreff: Fehlende Datenpunkte

joeH68 — Sat, 17 Jul 2021 12:02:45 GMT

Hi @MichaelHanna , I'm new here and good impressed by your fast reaction. Thank you!

Only missing point for me now is heating.burner.statistics.
It seems replaced by heating.burners.N.statistics but that's also missing.

Am I missing something? thanks

Re: Betreff: Fehlende Datenpunkte

nerixs — Sat, 17 Jul 2021 13:31:59 GMT

Example for circuit 0:

- "heating.burners.0.statistics","hours","value"

- "heating.burners.0.statistics","starts","value"

Betreff: Fehlende Datenpunkte

prior_philip — Mon, 19 Jul 2021 09:41:10 GMT

Hi Team and @MichaelHanna,

Im requesting system "error messages" and "HeatingRod" status for Vitocal200S.

Thanks and best regards

Oliver

Re: Betreff: Fehlende Datenpunkte

joeH68 — Thu, 22 Jul 2021 09:03:55 GMT

hi @nerixs, those are exactly the same data points I'm trying (using PyViCare 1.0). This is what I get when using the browser:

https://api.viessmann-platform.io/iot/v1/equipment/installations/xxx/gateways/yyyyyyyyyyyyyy/devices/0/features/heating.burners.0.statistics

{"viErrorId":"req-575990325452489c915ec172c4ec64d9","statusCode":404,"errorType":"FEATURE_NOT_FOUND","message":"FEATURE_NOT_FOUND","extendedPayload":{}}

however the values I'm looking for (#starts, #hours) must be in the API according to the documentation and ViCare App (3.5.0 iOS) is showing them. The Vitodens 300-W was freshed booted for this test.

Additional investigation shows following heating features/components. "burners" is not one of them

https://api.viessmann-platform.io/iot/v1/equipment/installations/xxx/gateways/yyyyyy/devices/0/features/heating

{"data":{"apiVersion":1,"isEnabled":true,"isReady":true,"gatewayId":"yyyyyyyyyyy","feature":"heating","uri":https://api.viessmann-platform.io/iot/v1/equipment/installations/xxx/gateways/yyyyyyyyyyyyyy/devices/0/features/heating,"deviceId":"0","timestamp":"2021-07-22T08:50:50.253Z","properties":{},"commands":{},"components":["boiler","burner","circuits","device","dhw","sensors","solar"]}}

Re: Betreff: Fehlende Datenpunkte

nerixs — Thu, 22 Jul 2021 09:54:46 GMT

Hi @joeH68 ,
Your order is good, I get this:

{ "data": { "properties": {}, "commands": {}, "components": [ "boiler", "burner", "burners", "circuits", "configuration", "device", "dhw", "operating", "sensors", "solar" ], "apiVersion": 1, "uri": "https://api.viessmann-platform.io/iot/v1/equipment/installations/xxxxxx/gateways/xxxxxxxxxxxxxxx/devices/0/features/heating", "gatewayId": "xxxxxxxxxxxxxxx", "feature": "heating", "timestamp": "2021-07-10T17:30:45.346Z", "isEnabled": true, "isReady": true, "deviceId": "0" } }

I can’t tell you any more!

Betreff: Fehlende Datenpunkte

JueBag — Thu, 22 Jul 2021 12:43:09 GMT

Please check the used URL, yours starts with:
https://api.viessmann-platform.io
It should start with:
https://api.viessmann.com

I made the same mistake before. 😉