Community

Hallo Jürgen,   Zunächst, um Missverständnisse zu vermeiden, ein Access Token hat eine Gültigkeit von 1 Stunde. Wovon du wahrscheinlich sprichst, ist ein Refresh Token, welcher eine Gültigkeit von 180 Tagen besitzt und mit Hilfe welchen man Access Token generieren kann.   Hier nun ein paar Dinge, die du ausprobieren könntest, welche helfen könnten: Schaue einmal in die Postman Beispiel Collection für die Viessmann API rein. Versuche bitte darüber, einen neuen Refresh Token zu erstellen. Überprüfe bitte deine Redirect URI. Ist sie identisch (inklusive dem "/" am Ende) zu dem, was beim Erstellen des Clients im API Dashboard eingestellt wurde? Nutze zum Erstellen des Code Verifiers / Code Challenge dieses Tool. Zusätzlich füge beim ersten Authentifizierungsschritt den Query Parameter "&code_challenge_method=S256" hinzu. Beim ersten Authentifizierungsschritt steht fälschlicherweise "code_verifier" in den Query Parametern. Im ersten Schritt muss stattdessen "code_challenge" als Parameter angegeben werden. Schaue dazu auch nochmal in unsere API Dokumentation. Bitte probiere diese Punkte einmal aus und gib mir eine Rückmeldung, ob es damit klappt. Du kannst in der Zwischenzeit auch im API Dashboard einen Access Token erstellen, um mit der API arbeiten zu können.   P.S. Ich habe gesehen, dass du weitere Beiträge zum gleichen Thema erstellt hast. Sind diese Themen doppelt? Dann könntest du sie für die Übersicht bitte entfernen.   Gruß,   Michael ... Mehr anzeigen

Hi @JörgWende , Thanks for the feedback! Could you please provide more details to what you are describing? Regards, Michael ... Mehr anzeigen

@FrankyM is your issue still valid? Then please send me your account name via PN so we can have a closer look. @abo the IT-Support is checking the issue. I will inform you updates. Regards, Michael ... Mehr anzeigen

@abo did you register the installation in the ViCare app with your account? Also, please provide me your username (via PN) so we can have a closer look. Regards, Michael ... Mehr anzeigen

@CaCicala deine Beschreibung des API Endpunkts List Errors From Database ist korrekt. Allerdings gibt es mit dem Events Endpunkt auch eine Möglichkeiten, die Historie der Events für das eigene Gerät auszulesen. Dazu gehören auch Fehlermeldungen des Geräts. Wenn man die beiden Endpunkte kombiniert, kann man sowohl den Fehlercode auslesen als auch die Beschreibung des Fehlers. Schaut euch den Endpunkt gerne einmal an! Gruß, Michael ... Mehr anzeigen

Hi @keremerkan, you are correct here and thanks for your question! There are no plans for the Vitoconnect to support local connections. The API that is provided is solely cloud-based. However I understand the request of having a local connection as well. There is a gateway module "Vitogate" that provides local connection through different possible protocols. Have a look at http://www.vitogate.info/ I hope this helps. Regards, Michael ... Mehr anzeigen

Hallo @oleonline, für Warmwasserspeicher gibt es über  API das Feature heating.dhw.oneTimeCharge. Zu dem Feature heißt es: Activate one time charge. The exact target temperature, on which the hot water will be heated up, depends on a controller type, see manuals from controllers. Ich hoffe, das hilft weiter. Gruß, Michael ... Mehr anzeigen

Hallo @Nunu62, danke für deine Frage! Für die Property aggregatedStatus gibt es die Wesentlichen Zustände: Error >> Wenn es einen Fehler auf der Installation gibt Offline >> Wenn das Gerät offline ist WorksProperly >> Wenn keine Fehler o.ä. vorhanden sind Ich hoffe, das hilft dir weiter. Gruß, Michael ... Mehr anzeigen

@r2h2 Thanks a lot for your remarks on the authentication process! There are at least some points I can share concerning your remarks.   For 1.: As is you knew what were up to, we now included exactly this functionality in the API Dashboard. You can now generate an access token via the dashboard to be able to quickly test the API even before implementing the authentication process. Feel free to check it out and let me know what you think! For 2.: Thank you for the info. In the Authentication page of the API Documentation, we do not refer to the code challenge method plain. As you described, this method is more insecure. We will adjust the getting started page accordingly so there is no confusion. For 3. and 4.: For the error codes of in the authentication, we use the standard RFC specification. You can find the error codes with description https://www.rfc-editor.org/rfc/rfc6749#section-5.2 (Section 5.2).   @AndreaC könntest du deine Authorisierungsbefehle zeigen? Und nutzt du für die Befehle schon die v3, oder sind deine Befehle noch auf der v2?   ... Mehr anzeigen

Hi @ArrowX, since you seem to be effected by the change I assume you are having a device based on the "ONE BASE" platform (also known as E3). Setting the operating mode of the heating circuit (hc) and the operating mode for the domestic hot water (dhw) are now split to different features. This means you will not find the previously known modes that were available in the hc like dhwAndHeating or dhw. For the hc, still use the known heating.circuits.n.operating.modes.* features. For the dhw, you now need to use the features heating.dhw.operating.modes.*. Here, you will find the following features: heating.dhw.operating.modes.active heating.dhw.operating.modes.balanced heating.dhw.operating.modes.off Depending on your device, there might be two more operating modes (comfort and eco) for dhw. I hope this helps! Regards, Michael ... Mehr anzeigen

@geowiwi mit "ONE BASE" sind die E3 Geräte gemeint. Das heißt, für deine Anlage mussst du auf das Feature heating.dhw.operating.modes.active zurück greifen. Bitte prüfe noch einmal, ob du dieses Feature abrufen kannst. heating.dhw.charging steht auf E3-Geräten nicht zur Verfügung. Versuche stattdessen einmal heating.dhw oder wie gesagt die Betriebsmodi. ... Mehr anzeigen

Hallo @BernhardW1, Da es sich bei dir um ein "Legacy" Gerät handelt (Konnektivierung via Vitoconnect), kannst du in diesem Fall den Betriebsmodus betrachten. Nutze dazu folgendes Feature heating.circuits.N.operating.modes.active Sollte der Modus hier auf dhw, dhwAndHeatingCooling oder dhwAndHeating stehen, ist die Warmwasserbereitung aktiv. Wichtig: Dieser Weg gilt nur für Legacy Geräte. Für die neueren "ONE BASE" Geräte (Konnektivität im Gerät integriert) muss das Feature heating.dhw.operating.modes.active genutzt werden. Gruß, Michael ... Mehr anzeigen

Hi @AnHardt, Thanks for the question. In the heating domain, generally the unit "per hour" is used for these values. As this is mostly clear for installers and partner, the time is often left out. So, the correct unit in this case is "liter/hour". Regards, Michael ... Mehr anzeigen

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

Hi @impiantispeciali, is it possible to use the ViCare app for the device and do you see any data there? What is the gateway serial number (send via DM). Regards, Michael ... Mehr anzeigen

Hi @bvm, could you provide me your gateway serial number (via PN)? This way, it is possible to have a closer look. Just to be sure: Is the desired data visible in your ViCare app or is it also not available in the application? Regards, Michael ... Mehr anzeigen

Hallo @Figo81, leider kann ich dir zum Home Assistant Plugin keine direkte Unterstützung anbieten. Aber kannst du gar keine Daten abrufen, oder nur bestimmte Daten nicht, wie z.B. der PV-Anlage? Gruß, Michael ... Mehr anzeigen

Hallo @CHZ, vielen Dank für das Feedback! Ärgerlich finde ich, dass die API Dokumentation bezüglich Datenpunkte unzureichend ist. Den Punkt mit der fehlenden Dokumentation zu bestimmten Features nehme ich gerne auf. Das sollten wir relativ schnell ändern können 🙂 Die anderen Informationen sehe ich zwar in der VicareApp, siehe werden aber beim allgemeinen Abruf aller features nicht ausgelesen. Kannst du kurz beschreiben, um welche Informationen in ViCare es sich handelt? Gerne kannst du ein Screenshot der ViCare App hinzufügen. Ich prüfe gerne, ob diese Features auch via public API verfügbar sind.   Gruß, Michael ... Mehr anzeigen

Hallo @alex_2112, In der Regel tritt der Fehler UNSUPPORTED_GATEWAY_TYPE auf, wenn die angegebene Gateway Seriennummer im Befehl nicht der Konvention entspricht. Überprüfe daher beim Auftreten dieses Fehlers bitte, ob die Gateway Seriennummer korrekt ist. Für den Fehler DEVICE_OFFLINE könntest du mir bitte die Gateway Seriennummern nennen, bei denen dies Auftritt (gerne per PN). Dann kann ich einen Blick darauf werfen. Jedoch deutet dieser Fehler eigentlich ausschließlich darauf hin, dass das Gerät online nicht zur Verfügung steht. Vielleicht hat sich das Gerät mit einem Repeater verbunden, welcher allerdings nicht mit dem Internet verbunden ist? Gruß, Michael ... Mehr anzeigen

Unsere Entwicklungsteam waren sich dem Problem bereits bewusst und es haben es geschafft, das Problem vor kurzem zu lösen. Die Information im Feature heating.circuits.N.circulation.pump sollten also wieder wie gewohnt zur Verfügung stehen. Für die entstandenen Umstände möchte ich mich entschuldigen und danke euch für die schnellen Rückmeldungen zum Problem! Gruß, Michael ... Mehr anzeigen

Hi @nerixs, you can try and use the service documents endpoints in addition to the events endpoint:  https://documentation.viessmann.com/service-documents/v3#service-documents_List_Errors_From_Database Here, you have the following input: materialNumber = the first 7 digits of your device's serial number errorCode = the error code you want to read – in your described case, it would be "0f" countryCode = 2-letter country code – e.g. fr languageCode = 2-letter language code – e.g. fr This will output a description (and measure) for the provided error in the chosen language.   Best,   Michael ... Mehr anzeigen

Hallo @Chovy, Danke für deine Geduld und dein Feedback! Deinen Vorschlag zur besseren Dokumentation der Body Attribute nehme ich gerne auf! Was ich mir vorstellen kann, ist ein Glossar für die wichtigsten Begrifflichkeiten im Bereich IoT Features und in diesem Zugang eine Beschreibung der Attribute in einem typischen Body. Würde dir in diesem Zusammenhang auch helfen, wenn es zu jedem IoT Feature ein Beispiel Output gäbe, oder geht es dir in erster Linie wirklich nur um das Verständnis der grundlegenden Attribute? Gruß, Michael ... Mehr anzeigen

Hallo @alex_2112, es scheinen zwei verschiedene Fehler aufzutreten. Einmal ist deine Installation nicht aus dem Internet verfügbar (Error 404 "DEVICE_OFFLINE"). Bei dem anderen Fehler müsstest du mir nochmal genau sagen, welcher Befehl aufgerufen wurde? Grundsätzlich kann ich dir hier keinen Support zum ioBroker Adapter geben, da wir diesen nicht offiziell unterstützen.  Gruß, Michael ... Mehr anzeigen

Hallo @stegner, du kannst unter folgendem Link versuchen, dein Password für deinen Viessmann (ViCare) Account zu ändern. Gruß, Michael ... Mehr anzeigen

@Reinhard4 was zeigt das Gerät an? Wird dort die Aktivität der Pumpe richtig wiedergegeben? Mir sind keine Änderungen in diesem Feature bekannt. Ich habe aber trotzdem einmal bei den Teams nachgefragt. Sobald ich Neuigkeiten hierzu habe, melde ich mich. Gruß, Michael ... Mehr anzeigen

Hallo an alle hier im Thread, Zunächst einmal danke, dass ihr hier eure Erfahrungen mit uns und mit anderen teilt! Das hilft uns, mit dem entsprechenden Feedback unser Angebot weiter zu verbessern. Wie von @Galbatorix bereits aus dem ChangeLog verlinkt, gab es im Mai diesen Jahres eine Änderung in den Update Modes einiger IoT Features. Die Änderung der Granularität der Features ist also kein temporäres Phänomen. Dass für einige die Änderung erst jetzt aktiv geworden ist, kann ich aktuell nicht genau erklären. Allerdings betrifft diese Änderung jede Anlage. @mibr85 gerne nehme ich sämtliche Punkte auf, die sich aus deiner Sicht bei der API verschlechtert haben. Die API nichts statisches und ändert sich mit neuen Anforderungen ebenfalls mit. Was aber stets gegeben ist, ist dass die API eine zukunftsfähige und zuverlässige Schnittstelle für enorm viele Anwendungsfälle. Gruß, Michael ... Mehr anzeigen