User guide

ISY Insteon API
The ISY Insteon Plug-in API provides a means for HomeSeer scripts to interact with the ISY
Insteon Plug-in and the devices it controls. The API provides access to capabilities not
exposed through the standard HomeSeer interfaces.
string ActivateResource(string id)
Takes a network resource ID as the only parameter and sends the command to
the ISY to activate (run) that network resource.
The string returned is the HTTP response from the ISY.
string ControlDevice(string address, string cmd, int level)
Sends a command to a device. The parameters are:
• The device address. For Insteon devices, this will be the Insteon address.
For scenes, this will be the ISY scene ID.
• The command. This is the ISY command. For example: DON, DOF.
• The level. For dimmer devices, this is between 0 and 255. For relay
devices, this is 0 or 255.
string RunProgram(string address, string cmd)
Sends a command to the ISY to execute a program. The address is the ISY
program ID. The command is an ISY program command. For example:
“RunElse”, “RunIf”
string QueryDevice(string address)
Query the ISY for the status of a device. The only parameter is the device
address.
string RequestStatus()
Requests the status of all devices controlled by the ISY. The status is returned
in an XML formatted string.
string RequestConfig()
Requests the ISY configuration information. This returns an XML formatted
string containing the ISY's configuration information.
string RequestTime()
Request the current time and date from the ISY.
string RequestLastSetTime()
Request the last time the ISY received via NTP.
int EnergyMonitorNumChannels()
Request the number of data channels currently collecting energy data.
double EnergyMonitorUtilization(int channel)
Get the energy utilization value for a channel.