HomeConnect - Versionsgeschichte

Adimarantis am 9. Februar 2025 um 14:46 Uhr

2025-02-09T14:46:42Z

← Nächstältere Version		Version vom 9. Februar 2025, 16:46 Uhr
Zeile 20:		Zeile 20:

	== Update von der ursprünglichen Version von Stefan/swhome ==		== Update von der ursprünglichen Version von Stefan/swhome ==
	Wer die ursprüngliche Version von Stefan/swhome nutzt editiert die Datei FHEM/~~controls_fhem~~.txt und ersetzt "sw-home" mit "bublath" und führt dann entsprechend in FHEM ein "update all" aus.		Wer die ursprüngliche Version von Stefan/swhome nutzt editiert die Datei FHEM/controls.txt und ersetzt "sw-home" mit "bublath" und führt dann entsprechend in FHEM ein "update all" aus.

	=== Unterschiede zur Urversion ===		=== Unterschiede zur Urversion ===

Adimarantis am 6. Februar 2025 um 16:43 Uhr

2025-02-06T16:43:33Z

← Nächstältere Version		Version vom 6. Februar 2025, 18:43 Uhr
Zeile 40:		Zeile 40:
	===Basisdefinition===		===Basisdefinition===
	Für das Weitere braucht man, egal ob für echte Hausgeräte oder eine Simulation, einen (kostenlosen) [https://developer.home-connect.com/ Entwickleraccount bei HomeConnect]. Dazu muss man sich zunächst registrieren und eine Verifikation der Mailadresse durchführen, ähnlich wie schon bei der primären Registrierung auf der HomeConnect-Plattform. Wählt hier den Type "(Open Source) Community".		Für das Weitere braucht man, egal ob für echte Hausgeräte oder eine Simulation, einen (kostenlosen) [https://developer.home-connect.com/ Entwickleraccount bei HomeConnect]. Dazu muss man sich zunächst registrieren und eine Verifikation der Mailadresse durchführen, ähnlich wie schon bei der primären Registrierung auf der HomeConnect-Plattform. Wählt hier den Type "(Open Source) Community".

			Das "Default Home Connect Account for Testing" muss das Account sein, welches ihr verwendet habt um euch bei Home Connect mit der App anzumelden um letztendlich eure Geräte zu sehen.

	Der ursprüngliche Modulentwickler bittet darum, als ''Company Nam'' im Home Connect Developer Portal den Wert “FHEM Betatester“ anzugeben. Dabei ist es nach derzeitigem Kenntnisstand egal, was man als ''Additional Information'' über sich selbst einträgt.		Der ursprüngliche Modulentwickler bittet darum, als ''Company Nam'' im Home Connect Developer Portal den Wert “FHEM Betatester“ anzugeben. Dabei ist es nach derzeitigem Kenntnisstand egal, was man als ''Additional Information'' über sich selbst einträgt.

Adimarantis am 6. Februar 2025 um 16:40 Uhr

2025-02-06T16:40:29Z

← Nächstältere Version		Version vom 6. Februar 2025, 18:40 Uhr
Zeile 39:		Zeile 39:

	===Basisdefinition===		===Basisdefinition===
	Für das Weitere braucht man, egal ob für echte Hausgeräte oder eine Simulation, einen (kostenlosen) [https://developer.home-connect.com/ Entwickleraccount bei HomeConnect]. Dazu muss man sich zunächst registrieren und eine Verifikation der Mailadresse durchführen, ähnlich wie schon bei der primären Registrierung auf der HomeConnect-Plattform.		Für das Weitere braucht man, egal ob für echte Hausgeräte oder eine Simulation, einen (kostenlosen) [https://developer.home-connect.com/ Entwickleraccount bei HomeConnect]. Dazu muss man sich zunächst registrieren und eine Verifikation der Mailadresse durchführen, ähnlich wie schon bei der primären Registrierung auf der HomeConnect-Plattform. Wählt hier den Type "(Open Source) Community".

	Der ursprüngliche Modulentwickler bittet darum, als ''Company Nam'' im Home Connect Developer Portal den Wert “FHEM Betatester“ anzugeben. Dabei ist es nach derzeitigem Kenntnisstand egal, was man als ''Additional Information'' über sich selbst einträgt.		Der ursprüngliche Modulentwickler bittet darum, als ''Company Nam'' im Home Connect Developer Portal den Wert “FHEM Betatester“ anzugeben. Dabei ist es nach derzeitigem Kenntnisstand egal, was man als ''Additional Information'' über sich selbst einträgt.

	Nach diesem Vorgang sieht man auf der Seite https://developer.home-connect.com/applications zwei Reiter, ''Your Applications'' und ''Register Application''. Unter ''Your Applications'' sieht man zunächst nur den Schlüssel für den API Web Client~~, bis man selbst unter ''Register Application''~~ eine neue ~~Anwendung erzeugt hat~~. Die wichtigste Einstellung der Anwendung ist die ''Redirect URL''. Diese URL muss den Host enthalten, den man selbst im Browser für den Zugriff auf FHEM verwendet, also in der Regel die IP-Adresse des FHEM-Servers. Damit soll über das REST-API von FHEM ein Kommando in dem definierten HomeConnectConnection Device aufgerufen werden,		Nach diesem Vorgang sieht man auf der Seite https://developer.home-connect.com/applications zwei Reiter, ''Your Applications'' und ''Register Application''. Unter ''Your Applications'' sieht man zunächst nur den Schlüssel für den API Web Client.
	:<code>~~http~~://<Kurzname FHEM-Servers>.local:8083/fhem?cmd.Test=set%20hcconn%20auth%20 </code>
			Hier eine neue Applikation (z.B. FHEM) registrieren. Als OAuth Flow "Authorization Code Grant Flow" verwenden. Die wichtigste Einstellung der Anwendung ist die ''Redirect URL''. Diese URL muss den Host enthalten, den man selbst im Browser für den Zugriff auf FHEM verwendet, also in der Regel die IP-Adresse des FHEM-Servers. Damit soll über das REST-API von FHEM ein Kommando in dem definierten HomeConnectConnection Device aufgerufen werden,
			:<code>https://<Kurzname FHEM-Servers>.local:8083/fhem?cmd.Test=set%20hcconn%20auth%20 </code>
			Es macht durchaus Sinn hier gleich mehrere Varianten (http, https, unterschiedliche Adressen) einzutragen, da es mit manchen Varianten immer wieder Probleme gibt.

	Dieser String muss '''identisch''' sowohl auf der Home Connect Seite in der zu erzeugenden Anwendung angegeben werden, als auch bei der Gerätedefinition in FHEM.		Dieser String muss '''identisch''' sowohl auf der Home Connect Seite in der zu erzeugenden Anwendung angegeben werden, als auch bei der Gerätedefinition in FHEM.
	Das Erzeugen der Anwendung im Home Connect Developer Portal liefert dann zwei längliche Strings, die ''Client ID'' und das ''Client Secret''. Diese müssen ebenfalls in die Gerätedefinition in FHEM aufgenommen werden, sie lautet also		Das Erzeugen der Anwendung im Home Connect Developer Portal liefert dann zwei längliche Strings, die ''Client ID'' und das ''Client Secret''. Diese müssen ebenfalls in die Gerätedefinition in FHEM aufgenommen werden, sie lautet also

Adimarantis: Umstieg auf die Version 2

2025-02-06T16:26:30Z

Umstieg auf die Version 2

Änderungen zeigen

Pahenning: /* Modul-Installation */

2024-01-24T03:49:57Z

Modul-Installation

← Nächstältere Version		Version vom 24. Januar 2024, 05:49 Uhr
Zeile 31:		Zeile 31:
	2021.11.03 20:29:15 1 : aborting.		2021.11.03 20:29:15 1 : aborting.
	</syntaxhighlight>		</syntaxhighlight>
	In diesem Fall bitte die beiden Module 48_HomeConnect.pm und 48_HomeConnectConnection.pm manuell von https://github.com/sw-home/FHEM-HomeConnect/FHEM herunterladen, danach FHEM neu starten.		In diesem Fall bitte die beiden Module 48_HomeConnect.pm und 48_HomeConnectConnection.pm manuell von https://github.com/sw-home/FHEM-HomeConnect/tree/master/FHEM herunterladen, danach FHEM neu starten.

	Damit die Module auch bei einem normalen "update check" mit geprüft werden, muss ferner in die FHEM-Kommandozeile eingetragen werden:		Damit die Module auch bei einem normalen "update check" mit geprüft werden, muss ferner in die FHEM-Kommandozeile eingetragen werden:

HugoMcKinley: /* Problembehandlung */

2023-05-13T15:50:33Z

Problembehandlung

← Nächstältere Version		Version vom 13. Mai 2023, 17:50 Uhr
Zeile 98:		Zeile 98:
	'''''Antwort''''': Du musst das Attribut csrfToken deines FHEMWEB auf none setzen (oder wie oben beschrieben ein statisches Token installieren)		'''''Antwort''''': Du musst das Attribut csrfToken deines FHEMWEB auf none setzen (oder wie oben beschrieben ein statisches Token installieren)
	:<code>attr WEB csrfToken none</code>		:<code>attr WEB csrfToken none</code>
			'''''Frage''''': Wenn ich auf den '''Home Connect Login''' Button klicke bekomme ich den Fehler, dass es sich um ein nicht autorisiertes Gerät handelt.

			'''''Antwort''''': Man darf nicht im HomeConnect Portal angemeldet sein. Logout auf der Webseite und nochmal versuchen.
	==Unterstützte Geräte==		==Unterstützte Geräte==
	Grundsätzlich funktionieren alle Home Connect Geräte, d.h. sie werden zumindest in FHEM angelegt und ihr Status wird sichtbar. Steuern kann man sie aktuell jedoch noch nicht alle.		Grundsätzlich funktionieren alle Home Connect Geräte, d.h. sie werden zumindest in FHEM angelegt und ihr Status wird sichtbar. Steuern kann man sie aktuell jedoch noch nicht alle.

Ph1959de: Sichtung der letzten Änderungen; Modultyp korrigiert, diverse Infos nachgetragen

2021-11-04T09:51:44Z

Sichtung der letzten Änderungen; Modultyp korrigiert, diverse Infos nachgetragen

Änderungen zeigen

Pahenning: /* Basisdefinition */

2021-11-04T08:07:32Z

Basisdefinition

← Nächstältere Version		Version vom 4. November 2021, 10:07 Uhr
Zeile 42:		Zeile 42:

	===Basisdefinition===		===Basisdefinition===
	~~Um mit dem Simulator zu testen~~, ~~braucht Ihr~~ einen [https://developer.home-connect.com/ Entwickleraccount bei HomeConnect]		Für das Weitere braucht man, egal ob für echte Hausgeräte oder eine Simulation, einen (kostenlosen) [https://developer.home-connect.com/ Entwickleraccount bei HomeConnect]. Dazu muss man sich zunächst registrieren und eine Verifikation der Mailadresse durchführen, ähnlich wie schon bei der primären Registrierung auf der HomeConnect-Plattform.

	~~Man braucht zwingend einen Advanced Account um Geräte fernstarten zu dürfen~~. ~~Das kostet nichts~~, ~~es wird jedoch eine Namensverifikation durchgeführt~~.		Der ursprüngliche Modulentwickler bittet darum, als ''Company Nam'' im Home Connect Developer Portal den Wert “FHEM Betatester“ anzugeben. Dabei ist es nach derzeitigem Kenntnisstand egal, was man als ''Additional Information'' über sich selbst einträgt.

	~~Im Entwickleraccount muss~~ eine ~~Applikation generiert werden, als „Company Name“ im Home Connect Developer Portal bitte “FHEM Betatester“ angeben~~. Die wichtigste Einstellung der ~~Applikation~~ ist die Redirect URL. Diese URL muss den Host enthalten, den ~~Ihr in Eurer Umgebung~~ für den Zugriff auf FHEM verwendet, also ~~localhost oder 192~~.~~168.x.y, und sie muss~~ ein Kommando in dem definierten HomeConnectConnection ~~Modul aufrufen. Die URL sieht dann z.B. so aus:~~		Nach Diesem Vorgang sieht man auf der Seite https://developer.home-connect.com/applications zwei Reiter, ''Your Applications'' und ''Register Application''. Unter ''Your Applications'' sieht man zunächst nur den Schlüssel für den API Web Client, bis man selbst unter ''Register Application'' eine neue Anwendung erzeugt hat. Die wichtigste Einstellung der Anwendung ist die ''Redirect URL''. Diese URL muss den Host enthalten, den man selbst im Browser für den Zugriff auf FHEM verwendet, also in der Regel die IP-Adresse des FHEM-Servers. Damit soll über das REST-API von FHEM ein Kommando in dem definierten HomeConnectConnection Device aufgerufen werden,

	<pre>		<pre>
	http://~~localhost~~:8083/fhem?cmd.Test=set%20hcconn%20auth%20		http://<IP-Adresse des FHEM-Servers>:8083/fhem?cmd.Test=set%20hcconn%20auth%20
	</pre>		</pre>

	~~Die identische URL~~ muss sowohl auf der Home Connect Seite in der ~~Applikation~~ angegeben werden, als auch bei der ~~Definition~~ in FHEM. ~~Dazu kommen noch~~ der ~~generierte API Key~~ und das Client Secret:		Dieser String muss '''identisch''' sowohl auf der Home Connect Seite in der zu erzeugenden Anwendung angegeben werden, als auch bei der Gerätedefinition in FHEM.
			Das Erzeugen der Anwendung im Home Connect Developer Portal liefert dann zwei längliche Strings, die ''Client ID'' und das ''Client Secret''. Diese müssen ebenfalls in die Gerätedefinition in FHEM aufgenommen werden, sie lautet also

	<pre>		<pre>
	define hcconn HomeConnectConnection ~~API-KEY REDIRECT-~~URL ~~simulator CLIENT-SECRET~~		define hcconn HomeConnectConnection <Client ID> <Redirect URL> <Client Secret>
	</pre>		</pre>

	~~Also zum Beispiel~~		also beispielsweise

	<pre>		<pre>
	define hcconn HomeConnectConnection D239EBCABC99994D239EBCABC999B3D2393204		define hcconn HomeConnectConnection D239EBCABC99994D239EBCABC999B3D2393204
	http://~~localhost~~:8083/fhem?cmd.Test=set%20hcconn%20auth%20 ~~simulator~~ 994D239EBCABCBCABC999B3D		http://192.168.0.94:8083/fhem?cmd.Test=set%20hcconn%20auth%20 994D239EBCABCBCABC999B3D
	</pre>		</pre>

	~~Danach findet Ihr~~ in dem neuen Device hcconn einen Link namens Home Connect Login. Diesen klicken und die Anmeldung wird durchgeführt. Danach im hcconn-Device noch scanDevices ausführen und Ihr solltet eine stattliche Anzahl Hausgeräte finden.		Der Name '''hcconn'' kann auch anders gewählt werden, er muss dann aber konsequenterweise auch in der ''Redirect URL'' anders lauten.

	~~Um mit echten Geräten zu arbeiten~~, muss das ~~Wort simulator in der Definition entfernt werden~~.		Danach findet man auf der Detailseite des neuen FHEM-Device hcconn über dem ''set''-Button einen Link '''Home Connect Login'''. Wenn man diesen anklickt, wird ein Browserfenster zur einmaligen Anmeldung von FHEM beim Home Connect Portal geöffnet, in welches man seine Home Connect Credentials eintragen und die Steuerung zulassen muss. Bei erfolgter Anmeldung wechselt der STATE des FHEM-Devices hcconn auf 'Connected'. Anschließend sollte man (per ''set''-Button) den Befehl ''scanDevices'' ausführen, das FHEM-Device hcconn (das ja nur das Interface zu Home Connect liefert) legt damit für jedes gefundene Hausgerät ein eigenes Geräte-Device vom Typ HomeConnect an.

	~~====Fehler während~~ der ~~Installation====~~		Wenn man mit simulierten statt mit echten Geräten arbeiten will (z.B. für Testzwecke), muss vor das ''Client Secret'' bei der Definition des hcconn-Devices das Schlüsselwort 'simulator' eingetragen werden.

	~~Kam es beim vorangegangenen define zu folgender Fehlermeldung:~~

	~~<pre>~~
	~~Cannot load module HomeConnectConnection~~
	~~</pre>~~

	~~dann ist die Perl~~-~~Bibliothek "libswitch-perl" zu installieren:~~

	~~<pre>~~
	~~apt-get install libswitch-perl~~
	~~</pre>~~

	==Sicherheitsfunktion csrfToken in FHEM==		==Sicherheitsfunktion csrfToken in FHEM==

Pahenning: /* Modul-Installation */

2021-11-04T07:37:39Z

Modul-Installation

← Nächstältere Version		Version vom 4. November 2021, 09:37 Uhr
Zeile 18:		Zeile 18:
	==Definition von FHEM Devices==		==Definition von FHEM Devices==
	===Modul-Installation===		===Modul-Installation===
	Zur Installation (oder zum Update) ~~einfach diesen Befehl~~ in der FHEM Kommandozeile eingeben:		Ggf. ist das Perlmodul Switch nachzuinstallieren, durch Eingabe des Befehls

			sudo apt-get install libswitch-perl

			in die Linux-Kommandozeile. Zur Installation (oder zum Update) der FHEM-spezifischen Software in der FHEM Kommandozeile eingeben:

	<pre>		<pre>
Zeile 24:		Zeile 28:
	</pre>		</pre>

	~~Ggf. ist das Perlmodul~~ ''~~Switch~~'' ~~erforderlich~~. ~~Dieses~~ mit		'''Achtung, temporärer Workaround''': Auf Grund eines Fehlers in der Datei controls_homeconnect.txt kann es sein, dass dieser Befehl mit einer Fehlermeldung abbricht:
	~~<pre>~~		2021.11.03 20:29:15 1 : Downloading https://raw.githubusercontent.com/sw-home/FHEM-HomeConnect/master/controls_homeconnect.txt
	~~sudo apt~~-~~get install libswitch~~-~~perl~~		2021.11.03 20:29:15 1 : UPD FHEM/48_HomeConnect.pm
	</~~pre>~~		2021.11.03 20:29:15 1 : Got 31752 bytes for FHEM/48_HomeConnect.pm, expected 30881
	~~installieren~~.		2021.11.03 20:29:15 1 : aborting.

	~~Danach~~ FHEM ~~neu starten~~.		In diesem Fall bitte die beiden Module 48_HomeConnect.pm und 48_HomeConnectConnection.pm manuell von https://github.com/sw-home/FHEM-HomeConnect/FHEM herunterladen.

	Damit ~~das Modul~~ auch bei einem normale "update check" mit geprüft wird, muss ~~folgendes ergänzt~~ werden		Danach FHEM neu starten. Damit die Module auch bei einem normale "update check" mit geprüft wird, muss ferner in die FHEM-Kommandozeile eingetrage werden
	<pre>		<pre>
	update add https://raw.githubusercontent.com/sw-home/FHEM-HomeConnect/master/controls_homeconnect.txt		update add https://raw.githubusercontent.com/sw-home/FHEM-HomeConnect/master/controls_homeconnect.txt

Maddinthebrain: /* Modul-Installation */Nötiges Perlmodul Switch ergänzt.

2020-07-16T19:25:05Z

Modul-Installation: Nötiges Perlmodul Switch ergänzt.

← Nächstältere Version		Version vom 16. Juli 2020, 21:25 Uhr
Zeile 23:		Zeile 23:
	update all https://raw.githubusercontent.com/sw-home/FHEM-HomeConnect/master/controls_homeconnect.txt		update all https://raw.githubusercontent.com/sw-home/FHEM-HomeConnect/master/controls_homeconnect.txt
	</pre>		</pre>

			Ggf. ist das Perlmodul ''Switch'' erforderlich. Dieses mit
			<pre>
			sudo apt-get install libswitch-perl
			</pre>
			installieren.

	Danach FHEM neu starten.		Danach FHEM neu starten.