ph_insteonrawext PowerHome formula function
Description
This function allows the sending of raw
Insteon extended
commands.
Syntax
ph_insteonrawext ( ctlr, address, flags,
cmd1, cmd2, data
)
| Argument |
Description |
| ctlr |
String. The controller ID for the
Insteon controller. |
| address |
String. The address of the device to
send commands to. |
| flags |
Integer. The Insteon flags to
send. |
| cmd1 |
Integer. The Insteon CMD1 value. |
| cmd2 |
Integer. The Insteon CMD2 value. |
|
data
|
String. The extended Insteon data to
send. This should be in hexadecimal format with a single space between
each byte (two hex characters). Insteon extended data is 14 bytes of
data. If you leave this field blank or have less than 14 bytes of
data then this function will pad the extended data with 00 byte
characters. If the 14th byte contains 00, then PowerHome will
automatically calculate the I2CS checksum and apply it to the
extended data.
|
Return value
Integer. A value indicating the success of
failure of
the operation.
Usage
Use this function to send extended commands
to an Insteon address (the device/address does not need to exist as an Insteon
device in the PowerHome database).
Examples
The following examples demonstrate typical syntax/usage for this function.
ph_insteonrawext("PLM","34.AB.7C",h2d("1F"),h2d("2E"),0,"03
00")
The above example sends an extended request to an Insteon keypadlic to
retrieve its extended
settings.