Vitoconnect - Versionsgeschichte

Stefanru: mehrere Devices klarer

2026-06-26T16:02:26Z

mehrere Devices klarer

← Nächstältere Version		Version vom 26. Juni 2026, 18:02 Uhr
Zeile 62:		Zeile 62:
	das Device auswählen, das FHEM abfragen soll.		das Device auswählen, das FHEM abfragen soll.

	Sollen mehrere Devices abgefragt werden, bitte mehrere FHEM vitoconnect Devices anlegen. ~~Hier bitte~~ das API Limit ~~von oben beachten~~.		Sollen mehrere Devices abgefragt werden, bitte mehrere FHEM vitoconnect Devices anlegen. Beachte dabei das API-Limit und die Intervall-Faustregel im Abschnitt [[#Betrieb\|Betrieb]].

	Zur nachträgliches Änderung des Intervalls kann das DEF aufgerufen und dort die Parameter korrigiert werden (z.B. von 60 Sek. auf 180 Sek.) - dies gilt natürlich ebenso für nachträgliches Ändern des Usernamens oder Passwortes.		Zur nachträgliches Änderung des Intervalls kann das DEF aufgerufen und dort die Parameter korrigiert werden (z.B. von 60 Sek. auf 180 Sek.) - dies gilt natürlich ebenso für nachträgliches Ändern des Usernamens oder Passwortes.

Stefanru: Smal fixes

2026-06-26T16:00:34Z

Smal fixes

← Nächstältere Version		Version vom 26. Juni 2026, 18:00 Uhr
Zeile 74:		Zeile 74:

	Der aktuelle Verbrauch ist über zwei Wege einsehbar:		Der aktuelle Verbrauch ist über zwei Wege einsehbar:
	* '''Im Viessmann Developer Portal''': https://app.developer.viessmann-climatesolutions.com/transactions (Login mit dem		* '''Im Viessmann Developer Portal''': https://app.developer.viessmann-climatesolutions.com/transactions (Login mit dem Developer-Account erforderlich)
	Developer-Account erforderlich)
	* '''Direkt im Modul''' (ab Version 1.1.6): Die Readings <code>apiCallsToday</code>, <code>apiCallsTodayAccount</code> und
	~~<code>apiQuotaUsedPercent</code> zeigen den Verbrauch live an. Siehe Abschnitt [[#Diagnose-Readings\|Diagnose-Readings]].~~

			* '''Direkt im Modul''' (ab Version 1.1.6): Die Readings <code>apiCallsToday</code>, <code>apiCallsTodayAccount</code> und <code>apiQuotaUsedPercent</code> zeigen den Verbrauch live an. Siehe Abschnitt [[#Diagnose-Readings\|Diagnose-Readings]].
	== Readings ==		== Readings ==
	=== Mapping ===		=== Mapping ===

Stefanru: api limit

2026-06-26T15:59:54Z

api limit

← Nächstältere Version		Version vom 26. Juni 2026, 17:59 Uhr
Zeile 67:		Zeile 67:

	=== Betrieb ===		=== Betrieb ===
	Der Zugriff auf die API von Viessmann ist aktuell auf 1450 pro Tag in der Gratisversion beschränkt, daraus ergibt sich ein Maximum von ca. einer Abfrage pro Minute. ~~Die Anzahl der Zugriffe~~ ist ~~im Entwicklerportal~~ einsehbar: https://developer.viessmann.com/de/~~clients~~/~~history (funktioniert Stand 02~~/~~2026 nicht mehr, eine "neue" Seite um die Anzahl der Zugriffe abzufragen ist (mir) nicht bekannt)~~.		Der Zugriff auf die API von Viessmann ist aktuell auf '''1450 Calls pro Tag pro Account''' (apiKey) in der Gratisversion
			beschränkt, daraus ergibt sich ein Maximum von ca. einer Abfrage pro Minute pro Device.

			'''Hinweis bei mehreren Devices''': Bei mehreren FHEM vitoconnect Devices am selben apiKey teilen sich diese das 1450/Tag-Limit.
			Faustregel: bei 2 Devices nicht unter 120s Intervall pro Device, bei 3 Devices nicht unter 180s.

			Der aktuelle Verbrauch ist über zwei Wege einsehbar:
			* '''Im Viessmann Developer Portal''': https://app.developer.viessmann-climatesolutions.com/transactions (Login mit dem
			Developer-Account erforderlich)
			* '''Direkt im Modul''' (ab Version 1.1.6): Die Readings <code>apiCallsToday</code>, <code>apiCallsTodayAccount</code> und
			<code>apiQuotaUsedPercent</code> zeigen den Verbrauch live an. Siehe Abschnitt [[#Diagnose-Readings\|Diagnose-Readings]].

	== Readings ==		== Readings ==

Stefanru: Smal fixes

2026-06-26T15:56:27Z

Smal fixes

← Nächstältere Version		Version vom 26. Juni 2026, 17:56 Uhr
Zeile 398:		Zeile 398:
	\|clearReadings\|\| \|\|clear all readings immeadiatlely		\|clearReadings\|\| \|\|clear all readings immeadiatlely
	\|-		\|-
	\|clearMappedErrors\|\| \|\|Löscht alle Readings die mit "device.messages.errors.mapped." beginnen. Nutzt man wenn die aufgelösten		\|clearMappedErrors\|\| \|\|Löscht alle Readings die mit "device.messages.errors.mapped." beginnen. Nutzt man wenn die aufgelösten Fehlertexte (Code → Klartext) im Cache mal neu aufgebaut werden sollen — z.B. nach einem Sprachwechsel.
	Fehlertexte (Code → Klartext) im Cache mal neu aufgebaut werden sollen — z.B. nach einem Sprachwechsel.
	\|-		\|-
	\|password <passwd>\|\|String\|\|store password in key store		\|password <passwd>\|\|String\|\|store password in key store

Stefanru: fix clear mapped errors

2026-06-26T15:55:40Z

fix clear mapped errors

← Nächstältere Version		Version vom 26. Juni 2026, 17:55 Uhr
Zeile 398:		Zeile 398:
	\|clearReadings\|\| \|\|clear all readings immeadiatlely		\|clearReadings\|\| \|\|clear all readings immeadiatlely
	\|-		\|-
	~~\|clearMappedErrors~~
	\|
	\|clearMappedErrors\|\| \|\|Löscht alle Readings die mit "device.messages.errors.mapped." beginnen. Nutzt man wenn die aufgelösten		\|clearMappedErrors\|\| \|\|Löscht alle Readings die mit "device.messages.errors.mapped." beginnen. Nutzt man wenn die aufgelösten
	Fehlertexte (Code → Klartext) im Cache mal neu aufgebaut werden sollen — z.B. nach einem Sprachwechsel.		Fehlertexte (Code → Klartext) im Cache mal neu aufgebaut werden sollen — z.B. nach einem Sprachwechsel.
Zeile 481:		Zeile 479:
	\| ftui \|\| Identisch zu <code>html</code>, aber speziell für die Einbindung in [https://wiki.fhem.de/wiki/FHEM_Tablet_UI TabletUI]		\| ftui \|\| Identisch zu <code>html</code>, aber speziell für die Einbindung in [https://wiki.fhem.de/wiki/FHEM_Tablet_UI TabletUI]
	gedacht. Die SVG-Größe wird auf 100% gesetzt für responsive Darstellung.		gedacht. Die SVG-Größe wird auf 100% gesetzt für responsive Darstellung.
	\|}

	~~{\| class="wikitable"~~
	\|-
	~~!Name!!Beschreibung~~
	\|-
	~~\| \|\|~~
	\|}		\|}

Zeile 554:		Zeile 545:
	\|Setzt ein Timeout für den API-Aufruf.		\|Setzt ein Timeout für den API-Aufruf.
	\|-		\|-
	\| vitoconnect_showKaeltekreislauf \|\| 0,1 \|\| 0 \|\| Zeigt in der Detail-Ansicht des Devices ein SVG des Kältekreislaufs (nur bei		\| vitoconnect_showKaeltekreislauf \|\| 0,1 \|\| 0 \|\| Zeigt in der Detail-Ansicht des Devices ein SVG des Kältekreislaufs (nur bei Wärmepumpen sinnvoll). Wird auch von <code>get html</code> / <code>get ftui</code> ausgeliefert wenn aktiviert.
	Wärmepumpen sinnvoll). Wird auch von <code>get html</code> / <code>get ftui</code> ausgeliefert wenn aktiviert.
	\|}		\|}

Stefanru: showKältekreislauf, ClearMappedErrors

2026-06-26T15:52:19Z

showKältekreislauf, ClearMappedErrors

← Nächstältere Version		Version vom 26. Juni 2026, 17:52 Uhr
Zeile 400:		Zeile 400:
	\|clearMappedErrors		\|clearMappedErrors
	\|		\|
	\|~~clear all~~ mapped ~~errors immediately~~		\|clearMappedErrors\|\| \|\|Löscht alle Readings die mit "device.messages.errors.mapped." beginnen. Nutzt man wenn die aufgelösten
			Fehlertexte (Code → Klartext) im Cache mal neu aufgebaut werden sollen — z.B. nach einem Sprachwechsel.
	\|-		\|-
	\|password <passwd>\|\|String\|\|store password in key store		\|password <passwd>\|\|String\|\|store password in key store
Zeile 470:		Zeile 471:

	==Get==		==Get==
	~~Derzeit gibt es keine~~ "~~get~~"-~~Kommandos~~.		{\| class="wikitable"
			\|-
			! Name !! Beschreibung
			\|-
			\| html \|\| Liefert das Modul-SVG (z.B. Kältekreislauf bei Wärmepumpen, falls über Attribut
			<code>vitoconnect_showKaeltekreislauf</code> aktiviert) als HTML-Fragment zurück. Geeignet zur Einbindung in andere
			FHEM-Web-Devices.
			\|-
			\| ftui \|\| Identisch zu <code>html</code>, aber speziell für die Einbindung in [https://wiki.fhem.de/wiki/FHEM_Tablet_UI TabletUI]
			gedacht. Die SVG-Größe wird auf 100% gesetzt für responsive Darstellung.
			\|}

	{\| class="wikitable"		{\| class="wikitable"
Zeile 542:		Zeile 553:
	\|		\|
	\|Setzt ein Timeout für den API-Aufruf.		\|Setzt ein Timeout für den API-Aufruf.
			\|-
			\| vitoconnect_showKaeltekreislauf \|\| 0,1 \|\| 0 \|\| Zeigt in der Detail-Ansicht des Devices ein SVG des Kältekreislaufs (nur bei
			Wärmepumpen sinnvoll). Wird auch von <code>get html</code> / <code>get ftui</code> ausgeliefert wenn aktiviert.
	\|}		\|}

Stefanru: set passwort korrigiert

2026-06-26T15:48:40Z

set passwort korrigiert

← Nächstältere Version		Version vom 26. Juni 2026, 17:48 Uhr
Zeile 47:		Zeile 47:
	Da die Parameter, die beim Definieren des Devices angelegt werden im Klartext in der Detailansicht lesbar sind, kann man beim Definieren einfach ein falsches Passwort eingeben und das richtige später mit einem "set"-Kommando setzen. Also zum Beispiel:		Da die Parameter, die beim Definieren des Devices angelegt werden im Klartext in der Detailansicht lesbar sind, kann man beim Definieren einfach ein falsches Passwort eingeben und das richtige später mit einem "set"-Kommando setzen. Also zum Beispiel:
	:<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br>		:<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br>
	:<code>set vitoconnect password correctPassword 60</code>		:<code>set vitoconnect password correctPassword</code>

	Zusätzlich muss der apiKey gesetzt werden.		Zusätzlich muss der apiKey gesetzt werden.

Stefanru: Tippfehler be set passwort und neue Diagnose Readings

2026-06-26T15:43:29Z

Tippfehler be set passwort und neue Diagnose Readings

← Nächstältere Version		Version vom 26. Juni 2026, 17:43 Uhr
Zeile 95:		Zeile 95:

	Raw Readings müssen nicht erklärt werden; die Beschreibung der Datenpunkte kann hier bei Viessmann gefunden werden: https://api.viessmann-climatesolutions.com/documentation/data-points		Raw Readings müssen nicht erklärt werden; die Beschreibung der Datenpunkte kann hier bei Viessmann gefunden werden: https://api.viessmann-climatesolutions.com/documentation/data-points

			=== Diagnose-Readings ===

			Unabhängig vom gewählten Mapping erzeugt das Modul folgende Readings für Diagnose und Monitoring:

			==== API-Verbrauchszähler (ab v1.1.6) ====

			{\| class="wikitable"
			\|-
			! Reading !! Inhalt
			\|-
			\| apiCallsToday \|\| Anzahl erfolgreicher API-Calls seit Mitternacht für dieses Device (zählt Resource-Reads UND Set-Aktionen)
			\|-
			\| apiCallsLastDay \|\| Anzahl der API-Calls vom Vortag, beim Tageswechsel automatisch befüllt
			\|-
			\| apiCallsLastDay_date \|\| Datum zu dem apiCallsLastDay gehört (relevant bei FHEM-Downtime > 24h)
			\|-
			\| apiCallsTodayAccount \|\| Summe der apiCallsToday über alle vitoconnect-Devices mit gleichem apiKey. Wird nur befüllt wenn
			mindestens 2 Devices den gleichen apiKey nutzen.
			\|-
			\| apiQuotaUsedPercent \|\| Aktueller Verbrauch in Prozent vom 1450/Tag-Limit. Bei Multi-Device-Setups bezieht sich auf
			apiCallsTodayAccount, sonst auf apiCallsToday. Ab 80% erscheint eine Warnung im FHEM-Log.
			\|}

			Der Tageswechsel wird über die System-Uhrzeit erkannt (Mitternacht-Sprung), nicht über das Viessmann-eigene Sliding-Window. Das ist eine ausreichend genaue Näherung — wenn der Counter bei 100% ist, hat man die Quote auch wirklich verbraucht.

			==== Aktive Fehler (ab v1.1.5) ====

			{\| class="wikitable"
			\|-
			! Reading !! Inhalt
			\|-
			\| currentError \|\| Kommagetrennte Liste aller aktuell aktiven F-Codes aus <code>device.messages.errors.raw.entries</code>. Leer
			wenn keine F-Codes aktiv. Beispiel: <code>F.11,F.770</code>. Triggert FHEM-Events nur bei Wertänderung — geeignet als Auslöser für
			notify-Regeln.
			\|}

			Die ausführliche Fehlerliste mit Klartext steht weiterhin in <code>device.messages.errors.list</code> (Format: <code>DD.MM.YYYY
			HH:MM:SS - F.xxx - Volltext</code>).

	<div class="mw-collapsible mw-collapsed">		<div class="mw-collapsible mw-collapsed">

Ph1959de: URL für API-Key etc. angepasst; Formatierung überarbeitet

2026-02-12T17:27:44Z

URL für API-Key etc. angepasst; Formatierung überarbeitet

Änderungen zeigen

Stefanru: clearMappedErrors

2025-02-17T14:45:07Z

clearMappedErrors

← Nächstältere Version		Version vom 17. Februar 2025, 16:45 Uhr
Zeile 365:		Zeile 365:
	\|-		\|-
	\|clearReadings\|\| \|\|clear all readings immeadiatlely		\|clearReadings\|\| \|\|clear all readings immeadiatlely
			\|-
			\|clearMappedErrors
			\|
			\|clear all mapped errors immediately
	\|-		\|-
	\|password <passwd>\|\|String\|\|store password in key store		\|password <passwd>\|\|String\|\|store password in key store