HMCCU - Versionsgeschichte

DR: /* Inbetriebnahme */

2023-08-09T06:22:25Z

Inbetriebnahme

← Nächstältere Version		Version vom 9. August 2023, 08:22 Uhr
Zeile 98:		Zeile 98:

	Unter Windows (Strawberry Perl) kann man das Paket RPC::XML mit cpan installieren		Unter Windows (Strawberry Perl) kann man das Paket RPC::XML mit cpan installieren
	<~~syntaxhighlight lang="doscon"~~>		<pre>cpan install RPC::XML</pre>
	cpan install RPC::XML
	</~~syntaxhighlight~~>
	Bei der Installation gemäß [[FHEM Installation Windows]] befindet sich cpan man unter <code><FHEM-Hauptverzeichis>\perl\bin</code>		Bei der Installation gemäß [[FHEM Installation Windows]] befindet sich cpan man unter <code><FHEM-Hauptverzeichis>\perl\bin</code>

Zap: /* RPC Server konfigurieren und starten */

2021-12-29T14:12:35Z

RPC Server konfigurieren und starten

← Nächstältere Version		Version vom 29. Dezember 2021, 16:12 Uhr
Zeile 118:		Zeile 118:

	Alle RPC-Server werden über das I/O Device mit einem Befehl gestartet:		Alle RPC-Server werden über das I/O Device mit einem Befehl gestartet:
	<pre>set d_ccu ~~rpcserver~~ on</pre>		<pre>set d_ccu on</pre>
	Während des Starts der RPC-Server und der Registrierung bei der CCU kann das I/O Device nur eingeschränkt verwendet werden. Dies wird durch den Status „starting/busy“ angezeigt. Nachdem die RPC-Server gestartet wurden, wechselt der Status zu „running/OK“. Zusätzlich werden im Internal RPCPID die Prozess-IDs der RPC-Server Prozesse gespeichert.		Während des Starts der RPC-Server und der Registrierung bei der CCU kann das I/O Device nur eingeschränkt verwendet werden. Dies wird durch den Status „starting/busy“ angezeigt. Nachdem die RPC-Server gestartet wurden, wechselt der Status zu „running/OK“. Zusätzlich werden im Internal RPCPID die Prozess-IDs der RPC-Server Prozesse gespeichert.
	Anschließend sollte man noch das Attribut ''rpcserver'' auf „on“ setzen, damit die RPC-Server beim Start von FHEM automatisch gestartet werden:		Anschließend sollte man noch das Attribut ''rpcserver'' auf „on“ setzen, damit die RPC-Server beim Start von FHEM automatisch gestartet werden:

Ph1959de: Sichtung / Korrektur der letzten Änderung (Tippfehler, Syntaxhighlight)

2021-11-23T12:06:58Z

Sichtung / Korrektur der letzten Änderung (Tippfehler, Syntaxhighlight)

← Nächstältere Version		Version vom 23. November 2021, 14:06 Uhr
Zeile 1:		Zeile 1:
	Das Modul HMCCU ermöglicht zusammen mit weiteren Modulen eine Integration der [[HomeMatic]] CCU Zentrale sowie der dort angelernten Geräte in FHEM.		Das Modul HMCCU ermöglicht zusammen mit weiteren Modulen eine Integration der [[HomeMatic]] CCU Zentrale sowie der dort angelernten Geräte in FHEM.
			{{Hinweis\|Dieser Artikel bezieht sich auf die neue HMCCU Version 5.0}}
	{{Hinweis\|Dieser Artikel bezieht sich auf die neue HMCCU Version 5.0}}{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Anbindung HomeMatic CCU an FHEM		\|ModPurpose=Anbindung HomeMatic CCU an FHEM
	\|ModType=d		\|ModType=d
Zeile 35:		Zeile 35:
	Geräte in der HomeMatic CCU bestehen aus einem oder mehreren Kanälen. Ein Kanal wiederum hat einen oder mehrere Datenpunkte. Über diese Datenpunkte kann ein Gerät gesteuert oder Statusinformationen ausgelesen werden. Sofern ein Datenpunkt lesbar ist, kann er als Reading in einem HMCCUCHN oder HMCCUDEV Device dargestellt werden. Ausgehend von dieser Abbildung in der CCU kann man nun entscheiden, ob man ein CCU Gerät mit HMCCUCHN oder HMCCUDEV definiert.		Geräte in der HomeMatic CCU bestehen aus einem oder mehreren Kanälen. Ein Kanal wiederum hat einen oder mehrere Datenpunkte. Über diese Datenpunkte kann ein Gerät gesteuert oder Statusinformationen ausgelesen werden. Sofern ein Datenpunkt lesbar ist, kann er als Reading in einem HMCCUCHN oder HMCCUDEV Device dargestellt werden. Ausgehend von dieser Abbildung in der CCU kann man nun entscheiden, ob man ein CCU Gerät mit HMCCUCHN oder HMCCUDEV definiert.

	Der oben beschriebene Aufbau lässt sich am Beispiel einer Steckdose veranschaulichen:<syntaxhighlight>		Der oben beschriebene Aufbau lässt sich am Beispiel einer Steckdose veranschaulichen:<syntaxhighlight lang="Text">
	DEV ST-WR-Waschmaschine KEQ0965669 interface=BidCos-RF type=HM-ES-PMSw1-Pl		DEV ST-WR-Waschmaschine KEQ0965669 interface=BidCos-RF type=HM-ES-PMSw1-Pl
	CHN KEQ0965669:0 ST-WR-Waschmaschine:0		CHN KEQ0965669:0 ST-WR-Waschmaschine:0
Zeile 60:		Zeile 60:
	2.FREQUENCY = 49.990000 {f} [RE]		2.FREQUENCY = 49.990000 {f} [RE]
	2.BOOT = true {b} [RE]		2.BOOT = true {b} [RE]
	</syntaxhighlight>Das Gerät in diesem Beispiel hat 3 nutzbare Kanäle:		</syntaxhighlight>
			Das Gerät in diesem Beispiel hat 3 nutzbare Kanäle:
	* Kanal 0 ist der Maintenance Kanal. Diesen Kanal hat jedes Gerät. Er ist sowohl bei HMCCUCHN als auch bei HMCCUDEV immer vorhanden. Die Datenpunkte werden automatisch auf gebräuchliche Readings wie z.B. "battery" gemappt.		* Kanal 0 ist der Maintenance Kanal. Diesen Kanal hat jedes Gerät. Er ist sowohl bei HMCCUCHN als auch bei HMCCUDEV immer vorhanden. Die Datenpunkte werden automatisch auf gebräuchliche Readings wie z.B. "battery" gemappt.
	* Kanal 1 ist der Schaltkanal der Steckdose. Er besitzt einen Datenpunkt STATE, über den die Steckdose ein-/ausgeschaltet werden kann. Die Flags "RWE" stehen für '''R'''ead, '''W'''rite, '''E'''vent. Der Datenpunkt ist also beschreibbar, lesbar und wird von der CCU per Event automatisch aktualisiert		* Kanal 1 ist der Schaltkanal der Steckdose. Er besitzt einen Datenpunkt STATE, über den die Steckdose ein-/ausgeschaltet werden kann. Die Flags "RWE" stehen für '''R'''ead, '''W'''rite, '''E'''vent. Der Datenpunkt ist also beschreibbar, lesbar und wird von der CCU per Event automatisch aktualisiert
Zeile 158:		Zeile 159:
	erzeugt die HMCCUCHN Devices: FB-Rollladen-Wohnzimmer, FB-Rollladen-Kueche.		erzeugt die HMCCUCHN Devices: FB-Rollladen-Wohnzimmer, FB-Rollladen-Kueche.

	Die Attribute der automatisch angelegten Devices können über die I/O Device Attribute '''ccudef-attributes''' und '''createDeviceGroup''' beeinflusst werden. Um allen neu angelegten Devices das Attribut room=Homematic zuzuweisen, definiert ~~mal~~ folgendes Attribut im I/O Device:<syntaxhighlight>		Die Attribute der automatisch angelegten Devices können über die I/O Device Attribute '''ccudef-attributes''' und '''createDeviceGroup''' beeinflusst werden. Um allen neu angelegten Devices das Attribut room=Homematic zuzuweisen, definiert man folgendes Attribut im I/O Device:
			<syntaxhighlight lang="Text">
	attr d_ccu ccudef-attributes room=Homematic		attr d_ccu ccudef-attributes room=Homematic
	</syntaxhighlight>Mit dem Attribut '''createDeviceGroup''' können Einzel-Devices, die alle zu einem CCU-Gerät gehören, automatisch in einer FHEM-Gruppe zusammengefasst werden. Dieses Attribut kommt z.B. zur Anwendung, wenn man get createDev für eine Fernbedienung mit mehreren Kanälen ausführt. In diesem Fall legt HMCCU für jeden Kanal der Fernbedienung ein HMCCUCHN Device an. Mit dem folgenden Attribut im I/O Device werden diese HMCCUCHN Devices alle einer Gruppe zugeordnet, deren Name dem Gerätenamen in der CCU entspricht:<syntaxhighlight>		</syntaxhighlight>
			Mit dem Attribut '''createDeviceGroup''' können Einzel-Devices, die alle zu einem CCU-Gerät gehören, automatisch in einer FHEM-Gruppe zusammengefasst werden. Dieses Attribut kommt z.B. zur Anwendung, wenn man get createDev für eine Fernbedienung mit mehreren Kanälen ausführt. In diesem Fall legt HMCCU für jeden Kanal der Fernbedienung ein HMCCUCHN Device an. Mit dem folgenden Attribut im I/O Device werden diese HMCCUCHN Devices alle einer Gruppe zugeordnet, deren Name dem Gerätenamen in der CCU entspricht:
			<syntaxhighlight lang="Text">
	attr d_ccu createDeviceGroup %n		attr d_ccu createDeviceGroup %n
	</syntaxhighlight>Die möglichen Platzhalter (wie z.B. %n) können der Commandref entnommen werden.		</syntaxhighlight>
			Die möglichen Platzhalter (wie z.B. %n) können der Commandref entnommen werden.

	==Weitere Funktionen des Moduls HMCCU==		==Weitere Funktionen des Moduls HMCCU==

Zap: /* Autocreate von FHEM-Devices für CCU Geräte */

2021-11-23T10:08:17Z

Autocreate von FHEM-Devices für CCU Geräte

← Nächstältere Version		Version vom 23. November 2021, 12:08 Uhr
Zeile 158:		Zeile 158:
	erzeugt die HMCCUCHN Devices: FB-Rollladen-Wohnzimmer, FB-Rollladen-Kueche.		erzeugt die HMCCUCHN Devices: FB-Rollladen-Wohnzimmer, FB-Rollladen-Kueche.

	Mit dem Attribut "createDeviceGroup" können ~~solche~~ Einzel-Devices, die alle zu einem CCU-Gerät gehören, automatisch in einer FHEM-Gruppe zusammengefasst werden. ~~Das~~ Attribut legt ~~das Namensschema dieser~~ Gruppe ~~fest~~.		Die Attribute der automatisch angelegten Devices können über die I/O Device Attribute '''ccudef-attributes''' und '''createDeviceGroup''' beeinflusst werden. Um allen neu angelegten Devices das Attribut room=Homematic zuzuweisen, definiert mal folgendes Attribut im I/O Device:<syntaxhighlight>
			attr d_ccu ccudef-attributes room=Homematic
			</syntaxhighlight>Mit dem Attribut '''createDeviceGroup''' können Einzel-Devices, die alle zu einem CCU-Gerät gehören, automatisch in einer FHEM-Gruppe zusammengefasst werden. Dieses Attribut kommt z.B. zur Anwendung, wenn man get createDev für eine Fernbedienung mit mehreren Kanälen ausführt. In diesem Fall legt HMCCU für jeden Kanal der Fernbedienung ein HMCCUCHN Device an. Mit dem folgenden Attribut im I/O Device werden diese HMCCUCHN Devices alle einer Gruppe zugeordnet, deren Name dem Gerätenamen in der CCU entspricht:<syntaxhighlight>
			attr d_ccu createDeviceGroup %n
			</syntaxhighlight>Die möglichen Platzhalter (wie z.B. %n) können der Commandref entnommen werden.

	==Weitere Funktionen des Moduls HMCCU==		==Weitere Funktionen des Moduls HMCCU==

Zap: /* Geräte, Kanäle und Datenpunkte */

2021-11-23T09:48:39Z

Geräte, Kanäle und Datenpunkte

← Nächstältere Version		Version vom 23. November 2021, 11:48 Uhr
Zeile 36:		Zeile 36:

	Der oben beschriebene Aufbau lässt sich am Beispiel einer Steckdose veranschaulichen:<syntaxhighlight>		Der oben beschriebene Aufbau lässt sich am Beispiel einer Steckdose veranschaulichen:<syntaxhighlight>
			DEV ST-WR-Waschmaschine KEQ0965669 interface=BidCos-RF type=HM-ES-PMSw1-Pl
	CHN KEQ0965669:0 ST-WR-Waschmaschine:0		CHN KEQ0965669:0 ST-WR-Waschmaschine:0
	0.UNREACH = false {b} [RE]		0.UNREACH = false {b} [RE]
Zeile 63:		Zeile 64:
	* Kanal 1 ist der Schaltkanal der Steckdose. Er besitzt einen Datenpunkt STATE, über den die Steckdose ein-/ausgeschaltet werden kann. Die Flags "RWE" stehen für '''R'''ead, '''W'''rite, '''E'''vent. Der Datenpunkt ist also beschreibbar, lesbar und wird von der CCU per Event automatisch aktualisiert		* Kanal 1 ist der Schaltkanal der Steckdose. Er besitzt einen Datenpunkt STATE, über den die Steckdose ein-/ausgeschaltet werden kann. Die Flags "RWE" stehen für '''R'''ead, '''W'''rite, '''E'''vent. Der Datenpunkt ist also beschreibbar, lesbar und wird von der CCU per Event automatisch aktualisiert
	* Kanal 2 ist ein reiner Statuskanal. Er besitzt keine beschreibbaren Datenpunkte (nur '''R'''ead und '''E'''vent).		* Kanal 2 ist ein reiner Statuskanal. Er besitzt keine beschreibbaren Datenpunkte (nur '''R'''ead und '''E'''vent).
	Wenn man das Gerät lediglich schalten möchte und auf die Anzeige der Energiewerte aus Kanal 2 verzichten kann, sollte man ein HMCCUCHN Device für Kanal 1 definieren (enthält automatisch auch Kanal 0). Andernfalls definiert man ein HMCCUDEV Device für das Gerät, das dann alle Kanäle (0-2) enthält.		Wenn man das Gerät lediglich schalten möchte und auf die Anzeige der Energiewerte aus Kanal 2 verzichten kann, sollte man ein HMCCUCHN Device für Kanal 1 (KEQ0965669:1) definieren (enthält automatisch auch Kanal 0). Andernfalls definiert man ein HMCCUDEV Device für das Gerät KEQ0965669, das dann alle Kanäle (0-2) enthält.

	Es wird empfohlen, für die Definition von FHEM Devices die HMCCU-Befehle '''get createDev''' oder '''get create''' zu verwenden. Sofern ein Gerät von HMCCU unterstützt wird, wird automatisch das richtige Modul ausgewählt.		Es wird empfohlen, für die Definition von FHEM Devices die HMCCU-Befehle '''get createDev''' oder '''get create''' zu verwenden. Sofern ein Gerät von HMCCU unterstützt wird, wird automatisch das richtige Modul ausgewählt.

Zap: /* Geräte, Kanäle und Datenpunkte */

2021-11-23T09:46:23Z

Geräte, Kanäle und Datenpunkte

@@ Zeile 35: / Zeile 35: @@
 Geräte in der HomeMatic CCU bestehen aus einem oder mehreren Kanälen. Ein Kanal wiederum hat einen oder mehrere Datenpunkte. Über diese Datenpunkte kann ein Gerät gesteuert oder Statusinformationen ausgelesen werden. Sofern ein Datenpunkt lesbar ist, kann er als Reading in einem HMCCUCHN oder HMCCUDEV Device dargestellt werden. Ausgehend von dieser Abbildung in der CCU kann man nun entscheiden, ob man ein CCU Gerät mit HMCCUCHN oder HMCCUDEV definiert.
-Wenn alle benötigten Datenpunkte eines Gerätes über einen Kanal angesprochen werden können, sollte HMCCUCHN verwendet werden. Mit HMCCUDEV werden alle Kanäle eines Gerätes eingebunden. Außerdem unterstützt HMCCUDEV Rauchmeldergruppen sowie virtuelle Geräte wie z.B. Heizungsgruppen. Es wird empfohlen, für die Definition von FHEM Devices die HMCCU-Befehle '''get createDev''' oder '''get create''' zu verwenden. Sofern ein Gerät von HMCCU unterstützt wird, wird automatisch das richtige Modul ausgewählt.
+Der oben beschriebene Aufbau lässt sich am Beispiel einer Steckdose veranschaulichen:<syntaxhighlight>
-Der Statuskanal 0 ist inklusive seiner Datenpunkte sowohl in HMCCUCHN als auch in HMCCUDEV Devices verfügbar!
+Es wird empfohlen, für die Definition von FHEM Devices die HMCCU-Befehle '''get createDev''' oder '''get create''' zu verwenden. Sofern ein Gerät von HMCCU unterstützt wird, wird automatisch das richtige Modul ausgewählt.
 {{Hinweis|Im Artikel → [[HMCCU Best Practice]] gibt es einige Tipps für den Einstieg inklusive Schritt-für-Schritt Anleitungen (noch nicht an 5.0 angepasst).}}

Zap am 26. Oktober 2021 um 11:02 Uhr

2021-10-26T11:02:25Z

← Nächstältere Version		Version vom 26. Oktober 2021, 13:02 Uhr
Zeile 35:		Zeile 35:
	Geräte in der HomeMatic CCU bestehen aus einem oder mehreren Kanälen. Ein Kanal wiederum hat einen oder mehrere Datenpunkte. Über diese Datenpunkte kann ein Gerät gesteuert oder Statusinformationen ausgelesen werden. Sofern ein Datenpunkt lesbar ist, kann er als Reading in einem HMCCUCHN oder HMCCUDEV Device dargestellt werden. Ausgehend von dieser Abbildung in der CCU kann man nun entscheiden, ob man ein CCU Gerät mit HMCCUCHN oder HMCCUDEV definiert.		Geräte in der HomeMatic CCU bestehen aus einem oder mehreren Kanälen. Ein Kanal wiederum hat einen oder mehrere Datenpunkte. Über diese Datenpunkte kann ein Gerät gesteuert oder Statusinformationen ausgelesen werden. Sofern ein Datenpunkt lesbar ist, kann er als Reading in einem HMCCUCHN oder HMCCUDEV Device dargestellt werden. Ausgehend von dieser Abbildung in der CCU kann man nun entscheiden, ob man ein CCU Gerät mit HMCCUCHN oder HMCCUDEV definiert.

	Wenn alle benötigten Datenpunkte eines Gerätes über einen Kanal angesprochen werden können, sollte HMCCUCHN verwendet werden. Mit HMCCUDEV werden alle Kanäle eines Gerätes eingebunden. Außerdem unterstützt HMCCUDEV Rauchmeldergruppen sowie virtuelle Geräte wie z.B. Heizungsgruppen.		Wenn alle benötigten Datenpunkte eines Gerätes über einen Kanal angesprochen werden können, sollte HMCCUCHN verwendet werden. Mit HMCCUDEV werden alle Kanäle eines Gerätes eingebunden. Außerdem unterstützt HMCCUDEV Rauchmeldergruppen sowie virtuelle Geräte wie z.B. Heizungsgruppen. Es wird empfohlen, für die Definition von FHEM Devices die HMCCU-Befehle '''get createDev''' oder '''get create''' zu verwenden. Sofern ein Gerät von HMCCU unterstützt wird, wird automatisch das richtige Modul ausgewählt.

	~~Ein Sonderfall ist der~~ Statuskanal 0~~, der von allen HomeMatic Geräten bereitgestellt wird. Dieser Kanal~~ ist inklusive seiner Datenpunkte sowohl in HMCCUCHN als auch in HMCCUDEV Devices verfügbar.		Der Statuskanal 0 ist inklusive seiner Datenpunkte sowohl in HMCCUCHN als auch in HMCCUDEV Devices verfügbar!
	{{Hinweis\|Im Artikel → [[HMCCU Best Practice]] gibt es einige Tipps für den Einstieg inklusive Schritt-für-Schritt Anleitungen.}}
			{{Hinweis\|Im Artikel → [[HMCCU Best Practice]] gibt es einige Tipps für den Einstieg inklusive Schritt-für-Schritt Anleitungen (noch nicht an 5.0 angepasst).}}

	==Inbetriebnahme==		==Inbetriebnahme==
Zeile 46:		Zeile 47:
	* Namen in der CCU müssen über alle Objekttypen hinweg eindeutig sein. Beispiel: Ein Gerät und ein Raum dürfen nicht den gleichen Namen haben.		* Namen in der CCU müssen über alle Objekttypen hinweg eindeutig sein. Beispiel: Ein Gerät und ein Raum dürfen nicht den gleichen Namen haben.
	* Nach dem Neustart der CCU muss auch der RPC-Server neu gestartet werden, da die CCU2 bei einem Neustart die registrierten RPC-Server "vergisst".		* Nach dem Neustart der CCU muss auch der RPC-Server neu gestartet werden, da die CCU2 bei einem Neustart die registrierten RPC-Server "vergisst".
			* Nach Änderung von Attributen der RPC-Server Devices oder von RPC-Attributen im I/O Device müssen die RPC-Server neu gestartet werden, damit die Änderungen berücksichtigt werden.
	* Vor der Ausführung eines FHEM Updates oder vor der Installation eines CCU Firmware Updates muss der RPC-Server gestoppt werden.		* Vor der Ausführung eines FHEM Updates oder vor der Installation eines CCU Firmware Updates muss der RPC-Server gestoppt werden.
	* Seit der CCU Firmware 2.27.7 sind die Zugriffsmöglichkeiten auf die CCU durch eine Firewall abgesichert. Der Zugriff durch FHEM muss explizit freigeschaltet werden, da HMCCU sonst nicht korrekt funktioniert (s. nächster Abschnitt).		* Seit der CCU Firmware 2.27.7 sind die Zugriffsmöglichkeiten auf die CCU durch eine Firewall abgesichert. Der Zugriff durch FHEM muss explizit freigeschaltet werden, da HMCCU sonst nicht korrekt funktioniert (s. nächster Abschnitt).
Zeile 62:		Zeile 64:
	Alle HMCCU Module sind Teil von FHEM. HMCCU benötigt die Perl Module RPC::XML::Server und RPC::XML::Client.		Alle HMCCU Module sind Teil von FHEM. HMCCU benötigt die Perl Module RPC::XML::Server und RPC::XML::Client.

	Unter debian/raspbian kann das Paket librpc-xml-perl installiert werden		Unter debian/raspbian kann das Paket librpc-xml-perl installiert werden oder alternativ CPAN verwendet werden:
	<pre>sudo apt-get update && sudo apt-get install -y librpc-xml-perl</pre>		<pre>sudo apt-get update && sudo apt-get install -y librpc-xml-perl</pre>

Zeile 70:		Zeile 72:
	</syntaxhighlight>		</syntaxhighlight>
	Bei der Installation gemäß [[FHEM Installation Windows]] befindet sich cpan man unter <code><FHEM-Hauptverzeichis>\perl\bin</code>		Bei der Installation gemäß [[FHEM Installation Windows]] befindet sich cpan man unter <code><FHEM-Hauptverzeichis>\perl\bin</code>

	Der interne RPC-Server legt für den Datenaustausch zwischen CCU2 und FHEM Dateien im Verzeichnis /tmp an. Der fhem Prozess benötigt daher Schreibrechte für dieses Verzeichnis. Das Verzeichnis kann mit dem Attribut ''rpcqueue'' geändert werden. Der mit dem Modul HMCCURPCPROC bereitgestellte externe RPC-Server verwendet keine temporären Dateien. Der interne RPC-Server wird ab Version 4.4 nicht mehr unterstützt.

	===Definition I/O Device===		===Definition I/O Device===
	Im ersten Schritt wird ein I/O Device angelegt, das für die Kommunikation zwischen FHEM und der CCU verantwortlich ist. Im folgenden Beispiel wird davon ausgegangen, dass die CCU unter der IP-Adresse 192.168.1.10 erreichbar ist. Das FHEM Device bekommt den Namen „d_ccu“.		Im ersten Schritt wird ein I/O Device angelegt, das für die Kommunikation zwischen FHEM und der CCU verantwortlich ist. Im folgenden Beispiel wird davon ausgegangen, dass die CCU unter der IP-Adresse 192.168.1.10 erreichbar ist. Das FHEM Device bekommt den Namen „d_ccu“.
	<pre>define d_ccu HMCCU 192.168.1.10</pre>		<pre>define d_ccu HMCCU 192.168.1.10</pre>
	Falls die CCU als Software Service auf dem gleichen Rechner läuft wie FHEM, sollte bei der Definition der Parameter ''ccudelay'' angegeben werden. Die CCU Services brauchen beim Starten länger als FHEM. Durch ''ccudelay'' wird das neu angelegte I/O Device verzögert um die angegebene Anzahl Sekunden initialisiert. Die Vorgabe sind 180 Sekunden. Je nach Installation kann auch ein höherer Wert notwendig sein:		Falls die CCU als Software Service auf dem gleichen Rechner läuft wie FHEM, sollte bei der Definition der Parameter ''ccudelay'' angegeben werden. Die CCU Services brauchen beim Starten länger als FHEM (bis zu 2 Minuten). Durch ''ccudelay'' wird das neu angelegte I/O Device verzögert um die angegebene Anzahl Sekunden initialisiert. Die Vorgabe sind 180 Sekunden. Je nach Installation kann auch ein höherer Wert notwendig sein:
	<pre>define d_ccu HMCCU 192.168.1.10 ccudelay=180</pre>		<pre>define d_ccu HMCCU 192.168.1.10 ccudelay=180</pre>
	Der Start von FHEM wird dadurch nicht verzögert. Die verzögerte Initialisierung kann mit dem Parameter ''delayedinit'' erzwungen werden, greift dann also auch, wenn die CCU beim Start von FHEM erreichbar ist		Der Start von FHEM wird dadurch nicht verzögert. Lediglich HMCCU wird verzögert initialisiert. Die verzögerte Initialisierung kann mit dem Parameter ''delayedinit'' erzwungen werden, greift dann also auch, wenn die CCU beim Start von FHEM erreichbar ist

	===RPC Server konfigurieren===		===RPC Server konfigurieren und starten===
	Im nächsten Schritt wird der RPC-Server konfiguriert und gestartet. Zunächst werden mit dem Attribut ''rpcinterfaces'' die Schnittstellen bzw. Ports festgelegt, für die sich der RPC-Server bei der CCU registrieren soll. Das Attribut zeigt in einer Auswahlliste die möglichen Schnittstellen an. Nur für die hier ausgewählten Schnittstellen werden automatisch Readings aktualisiert.		Im nächsten Schritt wird der RPC-Server konfiguriert und gestartet. Zunächst werden mit dem Attribut ''rpcinterfaces'' die Schnittstellen bzw. Ports festgelegt, für die sich der RPC-Server bei der CCU registrieren soll. Das Attribut zeigt in einer Auswahlliste die möglichen Schnittstellen an. Nur für die hier ausgewählten Schnittstellen werden automatisch Readings aktualisiert.

	~~'''Externer RPC-Server (HMCCURPCPROC)'''~~		Beim ersten Start dieses RPC-Servers über das I/O Device wird automatisch je Schnittstelle ein Device vom Typ HMCCURPCPROC angelegt. Die Attribute "room" und "group" werden vom I/O Device übernommen.
	Beim ersten Start dieses RPC-Servers über das I/O Device wird automatisch je Schnittstelle ein Device vom Typ HMCCURPCPROC angelegt. Die Attribute room und group werden vom I/O Device übernommen.

	~~'''RPC-Server starten'''~~
	Nun kann der RPC-Server gestartet werden. Dabei wird je RPC-Schnittstelle ein separater fhem.pl Prozess mit eigenem Listening-Port gestartet. Beim ersten Start legt HMCCU für jede unter ''rpcinterfaces'' angegebene Schnittstelle ein Device vom Typ HMCCURPCPROC an. Sofern auf dem FHEM-Server eine Firewall aktiv ist, müssen die Ports (s. Attribut ''rpcserverport'') für den Zugriff der CCU freigegeben werden.		Nun kann der RPC-Server gestartet werden. Dabei wird je RPC-Schnittstelle ein separater fhem.pl Prozess mit eigenem Listening-Port gestartet. Beim ersten Start legt HMCCU für jede unter ''rpcinterfaces'' angegebene Schnittstelle ein Device vom Typ HMCCURPCPROC an. Sofern auf dem FHEM-Server eine Firewall aktiv ist, müssen die Ports (s. Attribut ''rpcserverport'') für den Zugriff der CCU freigegeben werden.

Zeile 96:		Zeile 94:

	== Migration von HMCCU 4.3 ==		== Migration von HMCCU 4.3 ==
	Nachdem FHEM auf HMCCU Version 5.0 aktualisiert und neu gestartet wurde, sollten die definierten Geräte (HMCCUCHN und HMCCUDEV Devices) wie unter Version 4.3 funktionieren. ~~Es wird~~ jedoch ~~dringend empfohlen~~, die Geräte jeweils mit dem Befehl '''set defaults reset''' zurückzusetzen. HMCCU 5.0 erkennt nun sehr viele Geräte und die notwendigen Attribute automatisch anhand der Kanalrollen. Dadurch sind nur noch sehr wenige Attribute erforderlich, was die Gerätedefinition deutlich vereinfacht. Beim Zurücksetzen der ~~Defaults~~ werden überflüssige Attribute gelöscht~~. Speziell das in 4.3 häufig verwendete Attribut "eventMap" kann bei der Version 5.0 zu Konflikten mit den eingebauten Befehlen führen~~.		Nachdem FHEM auf HMCCU Version 5.0 aktualisiert und neu gestartet wurde, sollten die definierten Geräte (HMCCUCHN und HMCCUDEV Devices) wie unter Version 4.3 funktionieren. Da die Devices in Version 5.0 jedoch mit deutlich weniger Attributen auskommen bzw. einige Attribute wie z.B. "eventMap" sogar zu doppelten '''set''' Befehlen führen können, sollten die Attribute der Geräte jeweils mit dem Befehl '''set defaults reset''' zurückgesetzt werden. Beim Zurücksetzen der Attribute werden überflüssige Attribute gelöscht.

	Wichtig: Nach dem Zurücksetzen der Attribute mit '''set defaults reset''' die Konfiguration speichern und FHEM neu starten.		Wichtig: Nach dem Zurücksetzen der Attribute mit '''set defaults reset''' die Konfiguration speichern und FHEM neu starten.

			Je nach Anzahl bereits definierter Devices kann es sinnvoll sein, alle Devices mit der Funktion '''get create''' oder '''get createDev''' neu anzulegen. Für die neu angelegten Geräte wird automatisch das passende Client-Modul (HMCCUDEV oder HMCCUCHN) verwendet.

	==Synchronisation mit der CCU==		==Synchronisation mit der CCU==
	Das Modul HMCCU bietet Befehle an, um Daten zwischen der CCU und FHEM zu synchronisieren. Der Befehl '''get ccuConfig''' liest alle Geräte aus der CCU. Er sollte immer ausgeführt werden, wenn sich an einer Gerätedefinition in der CCU etwas geändert hat, z.B. Gerät oder Kanal wurde umbenannt, neues Gerät wurde angelernt, Gerät wurde gelöscht. Bei der Definition des I/O Device (z.B. beim Start von FHEM) wird der Befehl automatisch ausgeführt.

	Der Befehl '''get ccuDevices''' zeigt eine Liste der in der CCU bekannten Geräte an inklusive einer Liste der Kanalrollen, die von HMCCU automatisch erkannt werden.		=== Geräte synchronisieren ===
			Das Modul HMCCU bietet Befehle an, um Daten zwischen der CCU und FHEM zu synchronisieren. Der Befehl '''get ccuConfig''' liest alle Geräte aus der CCU. Er sollte immer ausgeführt werden, wenn sich an einer Gerätedefinition in der CCU etwas geändert hat, z.B. ein Gerät oder Kanal wurde umbenannt, ein neues Gerät wurde angelernt, ein Gerät wurde gelöscht. Bei der Definition des I/O Device (z.B. beim Start von FHEM) wird der Befehl automatisch ausgeführt.

			Der Befehl '''get ccuDevices''' zeigt eine Liste der in der CCU bekannten Geräte an inklusive einer Liste der Kanalrollen, die von HMCCU automatisch erkannt werden. Daran kann man erkennen, welche CCU-Geräte von den Befehlen '''get create''' und '''get createDev''' unterstützt werden.

	Der Befehl '''get update''' liest die Datenpunkte aller in FHEM definierten HMCCUDEV und HMCCUCHN Devices aus der CCU und aktualisiert alle Readings aller Client Devices.		=== Datenpunkte (Readings) synchronisieren ===
			Eine manuelle Aktualisierung der Datenpunkte sollte nicht notwendig sein. Die Aktualisierung erfolgt automatisch durch die CCU per RPC-Server Verbindung. Der Befehl '''get update''' liest die Datenpunkte aller in FHEM definierten HMCCUDEV und HMCCUCHN Devices aus der CCU und aktualisiert alle Readings aller Client Devices.

	==Autocreate von FHEM-Devices für CCU Geräte==		==Autocreate von FHEM-Devices für CCU Geräte==
	HMCCU bietet eine Möglichkeit, um automatisch Client Devices in FHEM für Geräte oder Kanäle in der CCU anzulegen, sofern HMCCU eine oder mehrere Kanalrollen unterstützt. Dazu kann entweder der Befehl '''get createDev''' (für ein einzelnes CCU Gerät) oder der Befehl '''get create''' (für mehrere CCU Geräte) verwenden werden.		HMCCU bietet eine Möglichkeit, um automatisch Client Devices in FHEM für Geräte oder Kanäle in der CCU anzulegen, sofern HMCCU eine oder mehrere Kanalrollen des betreffenden Gerätetyps unterstützt. Dazu kann entweder der Befehl '''get createDev''' (für ein einzelnes CCU Gerät) oder der Befehl '''get create''' (für mehrere CCU Geräte) verwenden werden.

	{{Hinweis\|Es wird dringend empfohlen, FHEM Devices für CCU Geräte mit den Befehlen get createDev oder get create anzulegen. Nur wenn Geräte dabei nicht erkannt werden, sollte man auf das klassische define zurückgreifen}}		{{Hinweis\|Es wird dringend empfohlen, FHEM Devices für CCU Geräte mit den Befehlen get createDev oder get create anzulegen. Nur wenn Geräte dabei nicht erkannt werden, sollte man auf das klassische define zurückgreifen}}
Zeile 118:		Zeile 121:
	Beispiel: Für alle CCU-Geräte, deren Namen mit "Heizung" beginnt, sollen FHEM-Devices angelegt werden:		Beispiel: Für alle CCU-Geräte, deren Namen mit "Heizung" beginnt, sollen FHEM-Devices angelegt werden:
	get d_ccu create Heizung.* room=Homematic group=Heizung		get d_ccu create Heizung.* room=Homematic group=Heizung
	Beim vorherigen Beispiel wird als Gerätename ein regulärer Ausdruck ("Heizung.*) angegeben. Jedes angelegte Gerät bekommt die Attribute room und group zugewiesen.		Beim vorherigen Beispiel wird als Gerätename ein regulärer Ausdruck ("Heizung.*) angegeben. Jedes angelegte Gerät bekommt die Attribute "room" und "group" zugewiesen.

	Wenn ein CCU-Gerät mehrere identische Kanalrollen besitzt, erzeugt HMCCU für jeden Kanal ein HMCCUCHN-Device. Ein Beispiel für solche CCU-Geräte sind Fernbedienungen, die 2-16 Kanäle der Rolle "KEY" besitzen.		Wenn ein CCU-Gerät mehrere identische Kanalrollen besitzt, erzeugt HMCCU für jeden Kanal ein HMCCUCHN-Device. Ein Beispiel für solche CCU-Geräte sind Fernbedienungen, die 2-16 Kanäle der Rolle "KEY" besitzen.

Zap: Beschreibung HMCCU 5.0

2021-10-20T17:10:14Z

Beschreibung HMCCU 5.0

Änderungen zeigen

ChristophMorrison: Fehlender Doppelpunkt in der Beschreibung zu ccuGetVars ergänzt

2021-04-28T12:09:00Z

Fehlender Doppelpunkt in der Beschreibung zu ccuGetVars ergänzt

← Nächstältere Version		Version vom 28. April 2021, 14:09 Uhr
Zeile 66:		Zeile 66:
	<syntaxhighlight lang="doscon">		<syntaxhighlight lang="doscon">
	cpan install RPC::XML		cpan install RPC::XML
	</syntaxhighlight >		</syntaxhighlight>
	Bei der Installation gemäß [[FHEM Installation Windows]] befindet sich cpan man unter <code><FHEM-Hauptverzeichis>\perl\bin</code>		Bei der Installation gemäß [[FHEM Installation Windows]] befindet sich cpan man unter <code><FHEM-Hauptverzeichis>\perl\bin</code>

Zeile 177:		Zeile 177:
	Beispiel: Lesen aller Systemvariablen alle 60 Sekunden. Im zweiten Befehl werden nur Variablen gelesen, die mit "A" beginnen:		Beispiel: Lesen aller Systemvariablen alle 60 Sekunden. Im zweiten Befehl werden nur Variablen gelesen, die mit "A" beginnen:
	<pre>attr d_ccu ccuGetVars 60		<pre>attr d_ccu ccuGetVars 60
	attr d_ccu ccuGetVars 60 ^A</pre>		attr d_ccu ccuGetVars 60:^A</pre>

	Wenn eine Systemvariable bereits in der CCU existiert, kann ihr Wert mit dem Befehl '''set var''' geändert werden.		Wenn eine Systemvariable bereits in der CCU existiert, kann ihr Wert mit dem Befehl '''set var''' geändert werden.

DR: /* Installation */

2020-12-15T20:32:13Z

Installation

← Nächstältere Version		Version vom 15. Dezember 2020, 22:32 Uhr
Zeile 58:		Zeile 58:

	===Installation===		===Installation===
	Alle HMCCU Module sind Teil von FHEM. HMCCU benötigt die Perl Module RPC::XML::Server und RPC::XML::Client. Unter debian/raspbian kann das Paket librpc-xml-perl installiert werden		Alle HMCCU Module sind Teil von FHEM. HMCCU benötigt die Perl Module RPC::XML::Server und RPC::XML::Client.

			Unter debian/raspbian kann das Paket librpc-xml-perl installiert werden
	<pre>sudo apt-get update && sudo apt-get install -y librpc-xml-perl</pre>		<pre>sudo apt-get update && sudo apt-get install -y librpc-xml-perl</pre>

			Unter Windows (Strawberry Perl) kann man das Paket RPC::XML mit cpan installieren
			<syntaxhighlight lang="doscon">
			cpan install RPC::XML
			</syntaxhighlight >
			Bei der Installation gemäß [[FHEM Installation Windows]] befindet sich cpan man unter <code><FHEM-Hauptverzeichis>\perl\bin</code>

	Der interne RPC-Server legt für den Datenaustausch zwischen CCU2 und FHEM Dateien im Verzeichnis /tmp an. Der fhem Prozess benötigt daher Schreibrechte für dieses Verzeichnis. Das Verzeichnis kann mit dem Attribut ''rpcqueue'' geändert werden. Der mit dem Modul HMCCURPCPROC bereitgestellte externe RPC-Server verwendet keine temporären Dateien. Der interne RPC-Server wird ab Version 4.4 nicht mehr unterstützt.		Der interne RPC-Server legt für den Datenaustausch zwischen CCU2 und FHEM Dateien im Verzeichnis /tmp an. Der fhem Prozess benötigt daher Schreibrechte für dieses Verzeichnis. Das Verzeichnis kann mit dem Attribut ''rpcqueue'' geändert werden. Der mit dem Modul HMCCURPCPROC bereitgestellte externe RPC-Server verwendet keine temporären Dateien. Der interne RPC-Server wird ab Version 4.4 nicht mehr unterstützt.