ph_insteonwithretext1 PowerHome formula function
Description
This function sends an extended Insteon
command to an Insteon device and waits for
a return. The returned CMD2 value as well as any returned extended data
will be returned from this function.
Syntax
ph_insteonwithretext1 ( 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
String. Waits for the Insteon command to
process/return and then returns the CMD2 value followed
by any extended data. The data is
returned as a string in hexadecimal format.
Usage
Use this function to send extended Insteon commands and retrieve
the result (CMD2 and extended data) of the command.
Examples
The following examples demonstrate typical
syntax/usage for this function.
ph_insteonwithretext1("KITCHENLIGHT",h2d("2E"),0,"03
00")