« Back to Product

Documentation

HM_WriteValueInteger

 boolean HM_WriteValueInteger (int $InstanceID, string $Parameter, int $Value) 

Parameters

InstanceID

ID of the device to be switched

Parameter

Parameter that should be set. The name of the parameter can be taken from the data point list or as "Ident" in the tab "Status Variables" in IP-Symcon.

Value

Whole number that should be set

Returns

If the command succeeds, it returns TRUE, otherwise FALSE.

Description

Sets the Parameter of the device with ID InstanceID to value Value.

Warning

The Parameter value you can derive based on the name of the state variable. In the parameter list some examples are given. Based on the type of variable you can also see the needed __HM_WriteValue__ function.

Warning

Additional datapoints can be taken from the HomeMatic data point list.

Warning

If the error message Failure occurs, this is usually due to a bad wireless connection.

Example

// Set the number of alarms to the value 25. Values allowed between 0 and 255.
HM_WriteValueInteger(12345, ALARM_COUNT, 25);
 
// Set the number of service to the value 78. Values allowed between 0 and 255.
HM_WriteValueInteger(12345, SERVICE_COUNT, 78);
Any questions?