Note that this software is no longer supported.
Overview:
This Indigo Pro 4, 5, or 6 Attachment AppleScript helps track energy usage by various devices. By simply calling the trackEnergy() or trackHVACEnergy() functions from within a trigger action, energy usage can be tracked for any thermostat, relay device, dimming device, or low-voltage controller. Calling either of these two handlers will automatically create all the variables needed for a device, if they don't already exist in Indigo, but a wattage (or therms-per-hour value for furnaces) must be assigned to a device before tracking will begin.
Features:
- Track total energy usage and cost for each of the following device types…
- Dimmers (SwitchLinc, KeypadLinc, LampLinc, In-Line Linc, etc)
- Relays (SwitchLinc, KeypadLinc, ApplianceLinc, In-Line Linc, etc)
- Power Synchronizers (SynchroLinc)
- Energy Meters (iMeter Solo)
- Low-Voltage Controllers (I/O-Linc)
- HVAC Controllers (Venstar Thermostats and Thermostat Adapters)
- Track total energy usage and cost for all devices combined.
- Enable or disable energy tracking for a device (by setting it's wattage or therms-per-hour rating to zero).
- Enable or disable all energy tracking by changing the value of one Indigo variable between "true" and "false".
- Easily reset all energy and cost values for a new energy billing cycle using one Action Group.
- Easily reset all energy, cost, wattage and therms values using another Action Group.
Limitations:
- With the exception of energy meters like the iMeter Solo, energy usage is entirely based on mathematical calculations of energy consumption based on your input, not on actual measured usage, so the reported usage and cost may differ from what you actually use or pay.
- eTrack does not support tiered energy cost schemes (used by many utility companies). It also does not support time-of-day-based energy cost calculations. Thus, when entering a cost per kWh or cost per Therm during setup, use an average cost per kWh/Therm. However, you can manually create an Indigo Schedule (Date/Time Action) to change the eTrackCostPerKWH and eTrackCostPerTherm variables at specific times of the day if your energy company uses a time-of-day calculation method.
- eTrack can only track electrical energy usage and gas furnace energy usage, not other utility usages.
- eTrack can't accurately calculate energy usage and costs for heat pump-type heating and cooling systems.
- When tracking energy usage for an I/O-Linc Controller device, eTrack only creates triggers based on whether that device's output changes, not on whether it's input changes. The I/O-Linc also cannot be in "momentary mode," otherwise energy will not be calculated correctly. You can modify the triggers created by eTrack to track energy based on input changes if needed.
- eTrack only works on Indigo systems that run 24-hours a day. It will not work with standalone controllers like an ISY-99i or 2414U.
Details:
Though this attachment does not require it, using the included eTrack Setup applet to setup all the variables and triggers within Indigo is highly recommended. That setup program will walk you through defining wattage levels for every compatible device, creating the needed Indigo variables and triggers for you afterwards. It also creates an Action Group which will reset all cost, kWh, and Therms tracking variables, and another Action Group to reset all data, including wattages and therms (respectively).
Each tracked device has a number of Indigo variables associated with it which are used by the eTrack functions to keep track of energy usage and cost.
- eTrackKWH_<deviceName> (eTrackTherms_<deviceName>Furnace): Number of kilowatt-hours (or Therms for furnaces) used during the most recent "event". For example, the kitchen light was turned on at 6:00 PM then turned off at 8:00 PM (which we're calling an "event"). When it was turned off at 8:00 PM, eTrack calculated how many kilowatt-hours were used by the light for that 2-hour period and stored that amount in this variable (as well as added it to the total kWhs used for the device and for all devices).
- eTrackCost_<deviceName>: Cost of using the device (in dollars) from the last "event."
- eTrackTotalKWH_<deviceName> (eTrackTotalTherms_<deviceName>Furnace): Total kilowatt-hours (or Therms) used by the device including the most recent "event."
- eTrackTotalTime_<deviceName>: Total time the device has been turned on (since eTrack has been reset).
- eTrackTotalCycles_<deviceName>: Total number of times device has been turned on (since eTrack has been reset).
- eTrackTotalCost_<deviceName>: Total cost of using the device so far, including the most recent "event."
- eTrackWatts_<deviceName> (eTrackThermsPerHour_<deviceName>Furnace): Your estimate of how many watts of power (or Therms per hour) are required to power the device (at 100% power). These are not created for iMeter Solo devices.
- eTrackData_<deviceName>: Data used by eTrack functions to calculate the number of kilowatt-hours (or Therms) used from the last device state change to the next time the device changes states. The first value is the date and time the device last changed states. The second value is the current on-level (percent brightness) of the device. This is not created for iMeter Solo devices.
There are also some globally used variables created by eTrack functions (if they don't already exist).
- eTrackEnabled: This is set to "true" by default and allows eTrack functions to proceed. Set this to "false" to prevent eTrack from tracking energy costs for all devices.
- eTrackCostPerKWH: This is the cost per kilowatt-hour you've told eTrack to use when calculating energy costs. eTrack does not support tiered energy calculations (where costs go up after you use more than a "baseline" total amount) or time-of-day energy calculations. However, for time-of-day calculations, you could manually create an Indigo Schedule (Date/Time Action) to change the value of this variable at specific times of the day and eTrack will calculate all future energy use based on the new cost per kWh.
- eTrackCostPerTherm: This is the cost per Therm you've told eTrack to use when calculating gas energy costs. eTrack does not support tiered energy calculations (where costs go up after you use more than a "baseline" total amount) or time-of-day energy calculations. However, for time-of-day calculations, you could manually create an Indigo Schedule (Date/Time Action) to change the value of this variable at specific times of the day and eTrack will calculate all future energy use based on the new cost per Therm.
- eTrackGrandTotalKWH: The sum of all device total kilowatt-hours, including the most recent "events" from all tracked devices.
- eTrackGrandTotalTherms: The sum of all device total Therms, including the most recent "events" from all tracked furnace devices.
- eTrackGrandTotalCost: The sum of all device total costs, including the most recent "events" from all tracked devices.
The eTrack Setup applet also creates device state change triggers for each of the tracked devices. Each trigger created by the eTrack Setup applet is named "eTrack - <device name>". Event logging is suppressed for all eTrack triggers so their execution doesn't clog up your Indigo logs. Triggers for HVAC energy tracking are named "eTrack - <thermostat name> [AC|Heat|Fan|Furnace]" (i.e. ending in either "AC", "Heat", "Fan", or "Furnace"). These triggers track the on and off state of each of the HVAC's 3 equipment components as well as the gas energy usage for the heater's furnace.
Finally, the eTrack Setup applet creates two Action Groups. The first, "eTrack - Reset", when executed, resets all eTrack cost and kWh variables, but leaves the wattage and data variables as they are. This allows you to easily reset energy and cost values for a new energy billing cycle. The second Action Group, "eTrack - Reset All", resets all eTrack variables, including wattages/therms and data variables. This could be useful if you'd like to stop tracking all devices and make changes to individual device wattage/therm-per-hour settings, or to erase any system-wide miscalculations.
Installation:
Download the .zip file, uncompress it (if it isn't done automatically) then run the included eTrack Setup program to install eTrack into the Indigo attachment folder. You can also put it there manually, then manually reload attachments within the Indigo Client.
Uninstallation:
Use the included Uninstall eTrack program to permanently delete this attachment and all associated Indigo variables, triggers, and action groups.
Requirements:
Indigo Pro 4, 5, or 6 and at least 1 trackable device. iMeter Solo support requires Indigo 5 or later.
EDIT: Now at version 1.3.1. Fixed bug that caused the eTrack installer to return a "Maximum of 3 buttons" error if more than 2 supported versions of Indigo were installed. The installer now only gives the option of installing eTrack for the two most recent supported versions of Indigo if more than 2 are installed.