ph_insteonwithret1 PowerHome formula function
Description
Send a standard length Insteon command and waits for the return value. The value returned will be the CMD2 value followed by the extended return data if it exists.
Syntax
ph_insteonwithret1 ( id, cmd1, cmd2 )
Argument Description
id String. The ID of the Insteon device to send commands to.
cmd1 Integer. The command 1 value. Use standard 0 to 255 for Insteon Direct commands. Add 1000 to the cmd1 value to send Group Cleanup commands.
cmd2 Integer. The command 2 value.
Return value
String. Returns the CMD2 value and extended return data (if it exists).
Usage
This function is nearly identical to the ph_insteonwithret function except it is also capable of returning extended data. Some Insteon standard commands return an extended data message so this function will be able to return this data whereas the ph_insteonwithret command ONLY returns the CMD2 value.
Examples
The following examples demonstrate typical syntax/usage for this function.
ph_insteonwithret ("MID CHANDELIER",3,2)
The above example sends a standard Device Text String Request. This particular Insteon command will respond with an extended data message which will be returned along with CMD2 as a string.