SETZEWERT
Syntax :
SETZEWERT(Objektname,Wertecode,Wert)
Mit dieser Anweisung können verschiedene Einstellungen in den Hardwaremodulen des HomeMatic-Systems vorgenommen werden.
Bitte beachten Sie, dass die Benutzung dieser Anweisung für die Hardware anderer Systeme nicht möglich ist.
Diese Anweisung erzeugt immer einen Sendebefehl und sollte nur selten verwendet werden, Sie darf keinesfalls in Makros erwendet werden, die in kurzen Zeitintervallen ausgeführt werden, das könnte das ganze System blockieren.
Es muss auch unbedingt beachtet werden, dass bei Einstellungen über diese Anweisung nur ein Sendebefehl erzeugt wird. Die Werte und Zustände von Objekten und Variablen werden nicht direkt beeinflusst, sondern erst durch eventuelle Rückmeldungen von den Hardwaremodulen aktualisiert. Das kann zur Folge haben, dass Hardware und Visualisierung nicht oder nicht zeitgleich synchron sind und Zustandsabfragen in wenn-Bedingungen nicht aktuell sind. Daher sollte diese Möglichkeit den Zustand von Hardwaremodulen zu ändern nur in Ausnahmefällen benutzt werden.
Die Anweisung sollte nur von erfahrenen Benutzern verwendet werden, die unsachgemässe Verwendung dieser Anweisung kann zu schweren Fehlfunktionen führen.
Benutzen Sie diese Anweisung nur wenn Sie genau wissen was Sie tun !!
Die Wertecodes können Konstanten oder auch Variablen vom Typ Zeichen sein.
Die Wertecodes müssen in Grossbuchstaben geschrieben sein, es kann auch die englische Bezeichnung (in Klammern) verwendet werden.
Mit dieser Anweisung wird die Methode setValue aus dem XMLRPC-Protokoll des BidCoS-Services aufgerufen. Das funktioniert nicht nür für die im unteren Teil angegebenen Wertecodes, sondern auch für andere, es kann aber setValue-Kombinationwen geben, die nicht funktionieren z.B. weil ein anderer Kanal erfoderlich ist als der im Objekt hinterlegte.
Beispiel für die Sirene des HMIP-Rauchmelders mit edn ´im BidCoS-Protokoll angegebenen Parametern:
zum Einschalten:
SETZEWERT(MeinHMIPRauchmelder, "SMOKE_DETECTOR_COMMAND", "INTRUSION_ALARM")
zum Ausschalten:
SETZEWERT(MeinHMIPRauchmelder, "SMOKE_DETECTOR_COMMAND", "INTRUSION_ALARM_OFF")
Bitte unbedingt beachten:
Bis auf den ersten Parameter müssen alle in Hochkomma stehen und in Grossbuchstaben sein.
Diese Option funkltioniert nur mit dem HMIP-Rauchmelder, nicht mit dem normalen HomeMatic--Rauchmelder.
Für folgende Wertecodes können momentan deutsche Schlüsselwörter verwendet werden:
EINSCHALTZEIT (ON_TIME), Einheit ist Sekunden
Beispiel:
Setzewert(Stehlampe,"EINSCHALTZEIT",30)
Stehlampe einschalten
Mit diesem Schlüsselwert kann z.B. für Schaltaktoren und Dimmer die Einschaltzeit eingestellt werden werden. Es ist keine Dauer-Einstellung, sie ist nur gültig für den nächsten Einschaltbefehl an das Modul. Bei dieser Möglichkeit ein Gerät für eine bestimmte Zeit einzuschalten, wird der interne Timer des Moduls benutzt, d.h. das Gerät schaltet nach der angegebenen Anzahl von Sekunden aus, auch wenn die Zentrale nicht mehr aktiv ist. Die Verwendung dieser Methode kann bei sicherheitskritischen Funktionen vorteilhaft sein.
VERZÖGERUNG (RAMP_TIME), Einheit ist Sekunden
Beispiel:
Setzewert(Dimmer,"VERZÖGERUNG",8)
Dimmer:=70
Mit diesem Schlüsselwert kann z.B. die Dimmgeschwindigkeit von Dimmern gesteuert werden.
ALTE STUFE (OLD_LEVEL)
Beispiel:
Setzewert(Dimmer,"ALTE STUFE",1)
Mit diesem Schlüsselwert kann ein Dimmer auf seine letzte Dimmstufe vor dem Ausschalten gesetzt werden. Die 1 ist als fester Wert erforderlich.
STUFE (LEVEL)
Beispiel:
Setzewert(Dimmer,"STUFE","0.6")
Mit diesem Schlüsselwert kann die Helligkeit eines Dimmers eingestellt werden. Der Wert ist ein Dezimalwert zwischen 0 und 1, als Parameter in Form einer Konstante oder Variable vom Typ Zeichen.
Diese Möglichkeit der Dimmersteuerung sollte nur in Ausnahmefällen benutzt werden, besser ist es den Dimmer über eine Zuweisung in einem Makro (z.B. Dimmer:=60) einzustellen.
ZUSTAND (STATE)
Beispiel:
Setzewert(Stehlampe,"ZUSTAND",1)
Mit diesem Schlüsselwert kann ein Binäraktor geschaltet werden. Bei Wert 1 wird eingeschaltet, bei Wert 0 wird ausgeschaltet. Diese Steuerungsmöglichkeit sollte nur in Ausnahmefällen verwendet werden, besser ist es Binäraktoren über die Anweisungen "einschalten" und "ausschalten" zu steuern.
Für neuere Thermostate können über diese Anweisung mehrere Einstellungen vorgenommen werden (gilt nicht für ältere Baureihen).
Der BOOST-Modus wird eingeschaltet mit
SETZEWERT(ThermostatName,"BOOST_MODE",1)
Der AUTO-Modus wird eingeschaltet mit
SETZEWERT(ThermostatName,"AUTO_MODE",1)
Der MANU-Modus wird eingeschaltet mit
SETZEWERT(ThermostatName,"MANU_MODE",Temperatur)
wobei die Temperatur eine Konstante mit einer Kommastelle oder Variable vom Typ Zahl mit einer Kommastelle sein kann.
Die Angabe der Kommastelle ist zwingend erforderlich, also z.B.:
SETZEWERT(Wohnzimmer,"MANU_MODE",22.0)
Um die Absenk- bzw. Komforttemperatur einzustellen können folgende Anweisungen benutzt werden:
SETZEWERT(ThermostatName,"LOWERING_MODE",1)
bzw.
SETZEWERT(ThermostatName,"COMFORT_MODE",1)
Bitte beachten Sie unbedingt:
Diese Anweisung generiert bei jeder Ausführung eine Meldung an das Gerät.
Wenn es sich um ein Funkmodul handelt kann die hemmungslose und unsachgemässe Benutzung dieser Anweisung viele unnötige Funkmeldungen generieren, was dazu führen kann, dass das Duty-Cycle-Konto überlauft und alle Funkmeldungen an Aktoren zeitweise blockiert werden.