HMCCUDEV - Versionsgeschichte

Zap: /* Steuern von Homematic Geräten über Datenpunkte */

2023-12-10T12:02:03Z

Steuern von Homematic Geräten über Datenpunkte

← Nächstältere Version		Version vom 10. Dezember 2023, 14:02 Uhr
Zeile 115:		Zeile 115:

	===Steuern von Homematic Geräten über Datenpunkte===		===Steuern von Homematic Geräten über Datenpunkte===

			==== Befehlssyntax ====
	Mit dem Befehl '''set datapoint''' können Werte von Datenpunkten in der CCU2 geändert werden. Die Syntax des Befehls lautet:		Mit dem Befehl '''set datapoint''' können Werte von Datenpunkten in der CCU2 geändert werden. Die Syntax des Befehls lautet:
	<pre>set <device> datapoint <datapoint> <value></pre>		<pre>set <device> datapoint <datapointSpec> <value> [...]
	~~Als~~ Parameter ~~wird~~ bei ~~HMCCUDEV~~ Devices ~~eine Kombination aus Kanalnummer und~~ Datenpunkt ~~angegeben~~ (z.B. 1.~~STATE~~). ~~Bei HMCCUCHN Devices nur~~ der Datenpunkt. ~~Zu beachten ist~~, ~~dass~~ der ~~angegebene~~ Wert ~~dem Datentyp des Datenpunktes entspricht~~.		set <device> datapoint <datapointSpec>=<value> [...]</pre>
			Der Parameter ''datapointSpec'' beschreibt den zu setzenden Datenpunkt in folgendem Format:
			datapointSpec := [<seqNum>:][<channelNum>.]<datapointName>
			''seqNum'' - Wenn mehrere Datenpunkte mit einem set-Befehl geändert werden sollen und dabei die Reihenfolge wichtig ist, in der diese Datenpunkte gesetzt werden, kann am Anfang einer Datenpunktspezifikation eine laufende Nummer angegeben werden.

			''channelNum'' - Bei HMCCUDEV Devices muss die Nummer des Kanals angegeben werden, zu dem der Datenpunkt gehört. Diese Angabe ist bei HMCCUCHN Devices nicht erforderlich.

			''datapointName'' - Der Name des Datenpunktes.

			Bei Problemen mit dem Setzen von Datenpunkten ist es hilfreich, sich die Ausgabe des Befehls get deviceInfo anzuschauen. Dort werden die Datenpunkte inkl. Kanalzugehörigkeit aufgelistet. Außerdem kann man anhand der Flags ("RWE") erkennen, ob ein Datenpunkt überhaupt geändert werden kann ("W=Write").

			==== Datenpunktwerte ====
			Wenn als ''value'' ein "?" angegeben wird, zeigt HMCCU die möglichen Werte eines Datenpunktes an. Der Wert "oldVal" setzt den Datenpunkt auf den vorhergehenden Zustand. Dadurch wird eine Umschaltung zwischen 2 Werten ermöglicht (toggeln). Dies setzt allerdings voraus, dass der Datenpunkt seit dem letzten Starten von FHEM mindestens einmal geändert wurde. Andernfalls wird eine Fehlermeldung ausgegeben.

			Wenn ein Datenpunkt die Einheit Prozent verwendet (z.B. LEVEL bei Dimmern oder Rollläden), erfolgt die Angabe beim Setzen in Prozent, d.h. der Wert muss zwischen 0 und 100 liegen. HMCCU skaliert diese Werte automatisch in den Bereich 0 bis 1.

	~~Beispiel~~: ~~Eine Steckdose wird über den Datenpunkt 1.STATE (Kanal~~ = ~~1) und den Werten~~ "~~true~~" ~~und "false" ein-~~ oder ~~ausgeschaltet~~. ~~Der entsprechende Befehl zum einschalten lautet:~~		Werte von Text-Datenpunkte sollten in doppelten Hochkomma eingeschlossen sein:
	~~<pre>set mydev datapoint~~ 1.~~STATE true</pre>~~		set myDev datapoint COMBINED="Das ist ein Text"
	~~Das Setzen von Datenpunkten kann man mit Hilfe der Attribute ''statedatapoint'' und ''statevals'' vereinfachen~~. ~~Zunächst wird mit ''statedatapoint'' der Datenpunkt festgelegt~~, ~~der per Default geschaltet werden soll~~. ~~Im vorherigen Beispiel wäre das „1~~.~~STATE“. Dann~~ werden ~~mit ''statevals'' sprechende Werte sowie ihre Übersetzung für die CCU2 festgelegt:~~		Einige Homematic Geräte unterstützen spezielle Werte, um z.B. einen vorherigen Zustand einzustellen oder auch, um einen Befehl zu ignorieren. Diese Werte können z.B. bei Jalousien 1.01 oder 1.005 sein, manchmal auch -0.5 (siehe auch Homematic Datenpunkt Beschreibung). Wichtig: Diese Werte werden ohne Skalierung eingegeben, z.B.
	~~<pre>attr mydev statevals on:true~~,~~off:false</pre>~~		set myDev datapoint LEVEL 1.005
	~~Die im Attribut ''statevals'' festgelegten Stati stehen als zusätzliche Set-Befehle zur Verfügung~~. ~~Außerdem kann mit dem Befehl '''set toggle''' zwischen den einzelnen Stati umgeschaltet werden:~~
	~~<pre>~~
	set ~~mydev devstate on~~
	~~set mydev on~~
	~~set mydev off~~
	~~set mydev toggle~~
	~~</pre>~~
	Die Befehle '''set devstate''' und '''get devstate''' greifen immer auf den Datenpunkt zurück, der im Attribut ''statedatapoint'' angegeben ist. Beim Auslesen des State-Datenpunktes mit '''get devstate''' oder auch '''get datapoint~~''' wird das zugehörige Reading und zusätzlich das Reading state sowie das Internal STATE aktualisiert~~.

	===~~Automatisches Erkennen von Gerätefunktionen~~===		==== Beispiele ====
	~~Wenn ein Gerät~~ über den Datenpunkt ~~LEVEL oder ON_TIME verfügt, stellen HMCCUDEV~~ und ~~HMCCUCHN automatisch Befehle zum prozentualen~~ und ~~zeitgesteuerten Schalten zur Verfügung. Als Beispiel sei hier~~ ein ~~Dim~~-~~Aktor genannt, der im Kanal 1~~ den Datenpunkt ~~LEVEL für die prozentuale Helligkeit im Bereich 0 bis~~ 1 ~~sowie den Datenpunkt~~ ON_TIME ~~für~~ die ~~Festlegung der Einschaltzeit in~~ Sekunden ~~bereit stellt~~. In diesem ~~Fall stellen HMCCUDEV und HMCCUCHN automatisch~~ die ~~Set-Befehle set pct, set on-till und set on-for-timer bereit~~. ~~Damit der Befehl set pct korrekt arbeitet~~, ~~muss der Wert des Datenpunkts LEVEL mit dem Attribut ccuscaleval von 0 bis 1 auf 0 bis 100 skaliert werden~~.		Beispiel 1: Eine Steckdose ist als HMCCUDEV definiert. Sie wird über den Datenpunkt 1.STATE (Kanal = 1) und den Werten "1" und "0" ein- oder ausgeschaltet. Über den Datenpunkt 1.ON_TIME soll die Einschaltdauer auf 60 Sekunden gesetzt werden. Der entsprechende Befehl zum Einschalten lautet:
			<pre>set myDev datapoint 1:1.ON_TIME=60 2:1.STATE=1</pre>
			Bei diesem Beispiel wird durch Voranstellen von "1:" bzw. "2:" sichergestellt, dass zunächst die Einschaltdauer gesetzt wird. Dies ist in diesem Fall zwingend erforderlich, da die CCU sonst diesen Parameter ignoriert.

			Beispiel 2: Umschalten eines Gerätes auf den vorherigen Wert:
			set myDev datapoint 1.LEVEL oldVal
	==Darstellung in der FHEM Oberfläche==		==Darstellung in der FHEM Oberfläche==

Zap: Korrekturen

2017-01-27T18:00:24Z

Korrekturen

Zap: /* Automatisches Erkennen von Gerätefunktionen */

2016-12-21T11:13:26Z

Automatisches Erkennen von Gerätefunktionen

← Nächstältere Version		Version vom 21. Dezember 2016, 13:13 Uhr
Zeile 133:		Zeile 133:

	===Automatisches Erkennen von Gerätefunktionen===		===Automatisches Erkennen von Gerätefunktionen===
	Wenn ein Gerät über den Datenpunkt LEVEL oder ON_TIME verfügt, stellen HMCCUDEV und HMCCUCHN automatisch Befehle zum prozentualen und zeitgesteuerten Schalten zur Verfügung.		Wenn ein Gerät über den Datenpunkt LEVEL oder ON_TIME verfügt, stellen HMCCUDEV und HMCCUCHN automatisch Befehle zum prozentualen und zeitgesteuerten Schalten zur Verfügung. Als Beispiel sei hier ein Dim-Aktor genannt, der im Kanal 1 den Datenpunkt LEVEL für die prozentuale Helligkeit im Bereich 0 bis 1 sowie den Datenpunkt ON_TIME für die Festlegung der Einschaltzeit in Sekunden bereit stellt. In diesem Fall stellen HMCCUDEV und HMCCUCHN automatisch die Set-Befehle set pct, set on-till und set on-for-timer bereit. Damit der Befehl set pct korrekt arbeitet, muss der Wert des Datenpunkts LEVEL mit dem Attribut ccuscaleval von 0 bis 1 auf 0 bis 100 skaliert werden.

	Darstellung in der FHEM Oberfläche		==Darstellung in der FHEM Oberfläche==
	X



	[[Kategorie:HomeMatic Components]]		[[Kategorie:HomeMatic Components]]

Zap: Fehler korrigiert

2016-12-21T11:05:21Z

Fehler korrigiert

← Nächstältere Version		Version vom 21. Dezember 2016, 13:05 Uhr
Zeile 123:		Zeile 123:
	Das Setzen von Datenpunkten kann man mit Hilfe der Attribute ''statedatapoint'' und ''statevals'' vereinfachen. Zunächst wird mit ''statedatapoint'' der Datenpunkt festgelegt, der per Default geschaltet werden soll. Im vorherigen Beispiel wäre das „1.STATE“. Dann werden mit ''statevals'' sprechende Werte sowie ihre Übersetzung für die CCU2 festgelegt:		Das Setzen von Datenpunkten kann man mit Hilfe der Attribute ''statedatapoint'' und ''statevals'' vereinfachen. Zunächst wird mit ''statedatapoint'' der Datenpunkt festgelegt, der per Default geschaltet werden soll. Im vorherigen Beispiel wäre das „1.STATE“. Dann werden mit ''statevals'' sprechende Werte sowie ihre Übersetzung für die CCU2 festgelegt:
	<pre>attr mydev statevals on:true,off:false</pre>		<pre>attr mydev statevals on:true,off:false</pre>
	~~Nach diesen Festlegungen sind folgende~~ Befehle ~~möglich~~:		Die im Attribut ''statevals'' festgelegten Stati stehen als zusätzliche Set-Befehle zur Verfügung. Außerdem kann mit dem Befehl '''set toggle''' zwischen den einzelnen Stati umgeschaltet werden:
	<pre>		<pre>
	set mydev devstate on		set mydev devstate on
	set mydev on		set mydev on
			set mydev off
	set mydev toggle		set mydev toggle
	</pre>		</pre>
	Die Befehle '''set devstate''' und '''get devstate''' greifen immer auf den Datenpunkt zurück, der im Attribut ''statedatapoint'' angegeben ist. Der Befehl '''set toggle''' schaltet zwischen den Zuständen um, die im Attribut ''statevals'' angegeben sind. Letztere werden außerdem als direkte Set-Befehle (im Beispiel „on“ und „off“) bereitgestellt.		Die Befehle '''set devstate''' und '''get devstate''' greifen immer auf den Datenpunkt zurück, der im Attribut ''statedatapoint'' angegeben ist. Beim Auslesen des State-Datenpunktes mit '''get devstate''' oder auch '''get datapoint''' wird das zugehörige Reading und zusätzlich das Reading state sowie das Internal STATE aktualisiert.

	Beim Auslesen des State-Datenpunktes mit '''get devstate''' oder auch '''get datapoint''' wird das zugehörige Reading und zusätzlich das Reading state sowie das Internal STATE aktualisiert.

	===Automatisches Erkennen von Gerätefunktionen===		===Automatisches Erkennen von Gerätefunktionen===

Zap am 5. Dezember 2016 um 17:00 Uhr

2016-12-05T17:00:00Z

← Nächstältere Version		Version vom 5. Dezember 2016, 19:00 Uhr
Zeile 1:		Zeile 1:
			{{Baustelle}}
	<div style="float:right">		<div style="float:right">
	{{Infobox Modul		{{Infobox Modul

Zap: /* Darstellung von Datenpunkten in FHEM */

2016-12-05T15:54:08Z