ph_devicebtn PowerHome formula function
Description
Controls a device that appears on the Device Status Screen (X10, Digital Out, Analog Out, Insteon). Expanded version of ph_x10btn formula.
Syntax
ph_devicebtn ( type, id, cmd, level )
Argument Description
type Integer. The type of device to control. Use 0 for X10 devices, 1 for Digital Outputs, 2 for Analog Outputs, 3 for Insteon Devices, 4 for Insteon Groups, 5 for UPB Devices, and 6 for UPB Links. You may also use the enumerated values: X10, DO, AO, INSTEON, INSTEONGROUP, UPB, and UPBLINK
id String. The ID of the device to control. Use the respective ID defined in the X10 Devices, Insteon Devices, Insteon Groups, UPB Devices, UPB Links, Digital Outputs, and Analog Outputs screens.
cmd Integer. The control command to send. See ph_x10btn for valid values for X10 Devices. For Digital Outputs, use 1 to set the device and 0 to clear the device. Use 0 for Analog Outputs. For X10 devices you may use the enumerated values: xon, xoff, xdim, xbright, adim. For Insteon Devices and Groups, you may use these enumerated values: ion, ioff, ifaston, ifastoff, idim, ibright, adim (Insteon Devices only).  For UPB Devices and UPB Links you may use the enumerated values: ugoto, ufadestart, ufadestop, ublink, uindicate, adim.  For UPB Links you may also use the enumerated values: uactlink and udeactlink.
level String. Use a value from 0 to 100 when using ADIM with X10 and Insteon Devices (Enclose value in single or double quotes). Use "0" for Digital Outputs. Use a CALCULATED value string for Analog Outputs.

For UPB Devices and UPB Links, use a value of 0 to 100 with the UGOTO and UFADESTART commands.  Use a value of of 0 to 101 with the ADIM command.  101 will make the UPB devices blink.  You may also include a UPB rate value (from 0 to 255) by following the level with a comma (Example: 75,3)

Return value
Integer. Returns - 200 if an invalid type is specified. For Digital Outputs, see the return values for ph_setdigitalout. For Analog Outputs, see the return values for ph_setanalogout. For X10 devices, see the return values for ph_x10btn. For Insteon, see the return values for ph_insteon. For Insteon Groups, see the return values for ph_insteongroup.  For UPB Devices, see the return values for ph_upb.  For UPB Links, see the return values for ph_upblink.
Usage
See ph_x10btn for details concerning absolute dimming and X10 device control.