ph_insteonwithretext PowerHome formula function
Description
This function sends an extended Insteon
command to an Insteon device and waits for a return. The returned CMD2
value is returned from this
function.
Syntax
ph_insteonwithretext ( id, cmd1, cmd2,
extdata
)
| Argument |
Description |
| id |
String. The ID of the Insteon device to send extended
commands to. |
| cmd1 |
Integer. The Insteon CMD1 value to send. |
| cmd2 |
Integer. The Insteon CMD2 value to send. |
|
extdata
|
String. The extended data to send. This
data must be in hexadecimal format (up to 14 bytes) with a single space
between each byte (2 hex digits). If less than 14 bytes are
included, PowerHome will pad the remaining bytes with 00 characters. If
the 14th byte is 00, then PowerHome will automatically calculate and
include the
I2CS checksum.
|
Return value
Integer. Waits for the Insteon command to
return and then returns the
CMD2 value.
Usage
Use this function to send extended Insteon
commands and retrieve the result (CMD2) of
the command.
Examples
The following examples demonstrate typical syntax/usage for this function.
ph_insteonwithretext("KITCHENLIGHT",h2d("2E"),0,"03
00")