Dokumentation

HM_WriteValueBoolean

boolean HM_WriteValueBoolean ( integer $InstanzID, string $Parameter, boolean $Wert )

Parameterliste

InstanzID

ID der Instanz des zu schaltenden Gerätes

Parameter

Parameter welcher gesetzt werden soll. Der Name des Parameters kann in der Datenpunktliste oder als "Ident" im Reiter "Statusvariablen" in IP-Symcon nachgesehen werden.

Wert

true oder false

Rückgabewerte

Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.

Beschreibung

Setzt den Parameter des Gerätes mit der ID InstanzID auf den Wert Wert.

Den einzutragenen $Parameter können Sie anhand des Idents der Statusvariablen der Instanz ableiten. In der Parameterliste werden einige Beispiele gegeben. Anhand des Typs der Variable können Sie auch die notwendige HM_WriteValue Funktion erkennen.

Weitere Datenpunkte können der HomeMatic Datenpunktliste entnommen werden.

Sollte die Fehlermeldung Failure auftreten, so ist dies im Normalfall auf eine mangelhafte Funkverbindung zurückzuführen.

Beispiel

//Gerät einschalten
HM_WriteValueBoolean(12345, "STATE", true);
 
//Gerät sperren
HM_WriteValueBoolean(12345, "INHIBIT", true); 
 
//Display Beleuchtung einschalten
HM_WriteValueBoolean(12345, "BACKLIGHT", true);