RCS X10 Thermostat Plug-in for HomeSeer Beta Version 2.0.105
Contents
1. o Made changes to fully comply with Thermostat API See Notes above for more info o Added a Thermostat PollStat function o OperationalMode renamed to SettingsMode to avoid confusion with OperatingMode confused already o Fixed event action and trigger validation for temperature values o Fixed problem with Heat Cool setpoint confirmation when using CmdSetTemp Fixed bug with Hold mode setting at startup o Failure to set Ack Echo Safe AUTOSEND modes is now logged as a Warning rather than as an Error O o When in debug mode initialization succcess rate and initialization time for each thermostat is logged e Version 1 0 3 o Fixed bug with Heat Pump Recovery Mode being incorrectly enabled o Fixed bug with event condition check o Added hidden frame form processing which provides cleaner operation of web interface as it does not require entire page to be refreshed It can be enabled through the Plug In Options o Added ability to specify heat and cool setpoints and heat pump recovery mode within Thermostat Properties o Numerous improvements to web interface o Abandoned use of 1 degree setpoint change commands CmdSetTempAdjust CmdSetHeatAdjust CmdSetCoolAdjust Plug In will still resoond 1 degree changes using Unit Code commands or Preset Dims sent by Control Panel but will not send them to the thermostat These commands could not be reliably controlled in a manner that would prevent multiple instances e Version 1 0 6 o2. Unit Code 4 Send Command Preset Level is echoed back as the same Preset Level in Unit Code 10 xv Enable Disable SAFE COMMAND Mode From the RCS X10 Thermostat Bi directional Protocol Manual To insure that commands which may have become garbled in transmission do not cause erroneous actions a SAFE COMMAND Mode is available When activated no command will be acted on unless it is received twice within a 2 second period Use of this mode in conjunction with message acknowledgment can insure fail safe communications Note that this mode is no longer supported in later versions of the TXB 16 thermostat firmware Refer to your user manual to see if this mode is still supported 6 Work with thermostats a Control thermostats using Thermostat Control Interface Control thermostats via HomeSeer status page Create HomeSeer events that trigger based upon thermostat setting changes Create HomeSeer events that perform actions to control thermostats Create scripts using the plug in s scripting interface as documented in the API ooo of Using the Thermostat Control Interface to Control Your Thermostat The Thermostat Control Interface is designed to mimic the functionality of the RCS X10 thermostat s Wall Display Unit WDU Pressing up or down button once will display setpoint is shown Subsequent presses will either increment or decrement setpoint Holding the button down causes the setpoint to change more quickly The setpoint value i
3. Version 2 0 11 o Minor change to plug in device creation procedure Version 2 0 12 o API changes to support MCE plug in Version 2 0 13 o Initialization and polling sequence changed in an attempt to improve performance Version 2 0 14 o Attempted to prevent some UNKNOWN MESSAGE log entries Version 2 0 15 o Fixed File Not Found error that occurred with new installs Version 2 0 25 o Communication improvements to increase reliability Version 2 0 26 o More attempts to increase communication reliability Version 2 0 29 o Changes to prevent possible issues related to timer processing Version 2 0 35 o Added support for outside temperature for TXB16 stats For now user will need to create virtual device and a recurring event that updates the virtual device using amp hs GetPlugins RCS X10 Thermostat GetOutsideTemp hs GetPlugins RCS X10 Thermostat GetIndexByHouseCode J where J is the house code of the TXB16 thermostat Version 2 0 38 o Added a plug in device that lists status of all thermostats o Timing of commands was adjusted on repeat attempts in an attempt to increase reliability Version 2 0 40 o Minor code changes Version 2 0 41 o Fixed command confirmation error Version 2 0 42 o Yet another attempt to correctly handle a one type of temperature change report from the stat AUTOSEND enabled when the plug in is waiting for another temperature related change to be confirmed o Fixed initialization not recognizing Fan Mode
4. Improved communications between plug in and thermostat resulting in faster response times o Fixed problem with Options and Config These would open and quickly close on some systems o Safe mode is OFF for new installs and should only be enabled if user wishes it to be enabled e Version 1 0 8 o Fixed some error messages that kept some commands from being confirmed even though commands were being executed e Version 1 1 0 o Plug In is now an Active EXE rather than an ActiveX Control which means that it runs in its own thread which means that you can give it a three finger salute and not shutdown HomeSeer o Fixed a bug that resulted in Unable to add command to X10 event queue errors that were reported on some systems e Version 1 1 3 o Made some changes to the way thermostats are initialized Non X10 related settings for thermostats are completed immediately when HomeSeer starts up rather than being delayed e Version 1 1 10 o Fixed stalling issues with Thermostat s web interface o Fixed inability to move Thermostat s Windows interface o Fixed problem with Safe Mode being off but reported on e Version 1 1 11 o Fixed delays associated with execution of events and button presses o Plug in device control menus are now synched with current values o Added more error trapping o GetModeSet now correctly returns 0 for System Off 1 for Heat 2 for Cool and 3 for Auto o Thermostat temperatures are now used as plug in device values to facil
5. Still may be issues with some firmware versions of the RCS X10 stats e Version 1 2 35 o Fixed some web interface problems o Some changes to support HomeSeer 2 0 Version 2 0 1 o Changes to support HomeSeer 2 0 o Fixed formatting of event action descriptions Version 2 0 2 o Monitor Mode is no longer supported Version 2 0 3 o Some improvements for users running without any of the special modes ACK ECHO SAFE or AUTOSEND enabled However ECHO and AUTOSEND are recommended to always be enabled for best performance Version 2 0 4 o Fixed problem with web page refresh Version 2 0 5 o For event actions Hold Mode is processed first when it is being set OFF and it is processed last when being set ON This will ensure that remaining actions for a given events are performed o Fixed problem with Properties and Log Windows being stuck open Improved appearance of windows o Fixed Settings Mode showing 32768 instead of N A not available Version 2 0 6 o Added PluginActive property that will allow plug in to be enabled disabled o Fixed WebRefreshInterval problem Version 2 0 7 o PluginActive property setting is now retained between restarts o PluginActive property can now be accessed via plug in device Version 2 0 8 o Fixed inability to change polling interval Version 2 0 9 o Fixed incorrect Decode Table property Version 2 0 10 o Altered initialization process to improve initialization success for systems with multiple thermostats
6. Version 1 2 25 o Fixed filter reminder dates not updating o Polling sequence reordered to improve reliability of retrieving temperature settings o Thermostat temperature and setpoint changes reported by the thermostat via AUTOSEND are now better handled while other temperature related commands are waiting confirmation o Polling sequence reordered to improve reliability of retrieving temperature settings Version 1 2 26 o Reordered sequence of event action processing so that complicated events function properly Version 1 2 28 o Fixed problem with incorrect thermostat Location fields when configuring more than one thermostat Version 1 2 29 o Fixed bug with plug in ignoring the No Logging setting o A few tweaks to polling sequence for users that still poll their stat Version 1 2 30 o No Logging bug was not just a problem with the setting but with the omission of the log entries for thermostat setting changes The plug in now logs thermostat settings as it did in earlier 1 2 X builds and users can use the No Logging setting to suppress logging o Added Getting Started section to readme document o Fixed bug with inability to turn Echo Off when Ack is still enabled o Implemented new methodology for handling Setpoint when Setback Mode is changed e Version 1 2 33 o Fixed some interactions bugs with ACK MESSAGE Mode and ECHO COMMAND Mode Some users reported problems when one mode was enabled while the other was not enabled
7. case they were changed while HS was not running o Fixed error with recent Settings Mode change The new change required users to rename their events to contain the name of an existing thermostat or the words all thermostats If the changes were not made an error was being generated when CmdSetSettingsMode was being called o Fixed problem with new dual setpoint strategy for TXB16 stats being disabled on the web thermostat properties page o Fixed problem with polling timer o New thermostats will be give the location RCS X10 Thermostat and name Thermostat J where J is the thermostat s housecode if user does not specify location or name Version 2 0 64 o To avoid problems with HS2 event handling Settings Mode is no longer available The Settings Mode plug in device has been replaced with the Message Modes plug in device that shows current settings for ACK MESSAGE Mode ECHO COMMAND Mode SAFE COMMAND Mode and AUTOSEND Mode Version 2 0 65 o Fixed HS2 console menus when plug in is disabled and re enabled while HS2 remains running o When running with HS2 plug in web links now use HS2 link buttons Version 2 0 66 o Improvements to command processing to ensure good operation with HS 1 7 and HS 2 0 Version 2 0 67 o Fixed fan indicator on Web Thermostat Control Interface page o Fixed Options page showing two submit buttons thereby causing form to not submit Version 2 0 69 o Returned to command processing scheme used in 2 0
8. excluding Setback Mode Delta o Fixed problem with changing Heat Pump Recovery Mode setting via Web Thermostat Properties e Version 2 0 103 o Changes to facilitate process of adding a new thermostat to the plug in o Changes to tackle automation errors reported when accessing Thermostat Control Interface o Fixed problem with thermostat mode being changed when setpoint change while thermostat mode is OFF o Added GetPollingInterval to scripting interface e Version 2 0 104 o Fixed problem with adding removing thermostats that resulted from changes in 2 0 103 e Version 2 0 105 o Initialization and Polling will now stop after three failed attempts
9. rather than creating file dynamically This will allow updates to the processor page to be released without requiring a new build of the plug in rcsX10_processor asp page now handles form submission e Version 0 6 1 O O O Safe Ack and Echo are forced OFF in this build Found and fixed and X10 event queue bug When Debug Mode is enabled plug in uses hs ExecX10 to send commands but when disabled the plug in uses hs ExecX10NoLog no log entries will be written when X10 commands are sent by HS over powerline e Version 0 6 2 O O Reinitialization and stopping initialization can be done via right click context menu when Windows interface for thermostat is displayed Added support for Decode Table B O O Improved initialization to better handle conditions where Safe Ack and Echo are not enabled OperationalMode function improved Operational Modes are now associated with any event that has uses RCS X10 Thermostat actions So if one were to create and event named Summer Weekend that enabled Cool Mode and brought thermostat down Summer Weekend would be considered an Operational Mode e Version 0 6 3 O O O Found a bug with Preset Dim 0 commands Improved automatic polling function Ack Echo and Safe mode can now be enabled via right click context menu when Windows interface for thermostat is displayed They are still disabled by default unless user changes them e Version 0 6 6 O O O Mo
10. setback delta value 0 if Setback Mode is Off If the current mode is COOL then the cool setpoint value is prefaced with the current setpoint adjusted by the setback delta value 0 if Setback Mode is Off Fixed a CheckX10Command error Plug In now monitors HS log to further increase command confirmation reliability e Version 1 1 46 o Added 2 second gap between commands being sent from two different thermostats o Fixed Waiting message bug o Fixed device value bugs o SettingsMode plug in device value is now 0 if Settings Mode is still using same settings and the device value is 1 if at least one of the settings has changed device string will have an asterisk o Attempted to fix mode jumps Version 1 1 47 o Fixed Waiting message bug o Fixed double Becomes Initialized event triggering o Improved beta version installer to prevent HomeSeer hangs Version 1 1 48 o Command processing improvements to eliminate mode jumping Version 1 1 49 o Fixed double Becomes Initialized triggers o Initialization changes to facilitate uncooperative stats Version 1 1 51 o Becomes Initialized trigger was not waiting until all stat settings were updated Version 1 2 0 o Added Initialize extended API function call to allow user to invoke initialization via scripting o Plug in now properly recognizes temperature changes made via Device control from menu Send X10 from ext interface and Send command from control panel
11. 66 o Fixed Message Modes plug in device that was not updating to show current status of all message modes Version 2 0 70 o Fixed X10 events not being processed after initialization o Changes to prevent data loss when user system has corrupted Microsoft VBScript 5 6 install e Version 2 0 74 o Improved dual setpoint handling for both TXB16 and TX15 B stats running under HS 1 7 and HS 2 0 o Polling interval is now independently configurable for each thermostat and no longer a global setting o Message Modes ACK ECHO SAFE and AUTOSEND are no longer shown in right click context menu and have been moved to thermostat properties dialog page o X10 preset dim commands for Message Modes are now only sent when command setting has been changed or if plug in is making the third and final attempt to initialize a thermostat e Version 2 0 75 o Added event triggers for command confirmation failure initialization failure and poll failure Note that initialization and poll failures do not apply to when user aborts that operation o Added event conditions for Is Polling Is Not Polling Initialization Aborted and Polling Aborted o Added context menu option to immediately poll stat o Changes to allow partial operation with ACK MESSAGE Mode and ECHO COMMAND Mode disabled o Improved handling of non bidirectional X10 thermostats TX15 Fixed polling looping Fixed polling not starting after a failed initialization o Fixed problem with
12. RCS X10 Thermostat Plug in for HomeSeer Beta Version 2 0 105 Getting Started 1 2 Install plug in Access the plug in s configuration by using one of the following two methods a Clicking on Options menu item of the RCS X10 Thermostat menu within HomeSeer Windows Interface b Accessing HomeSeer web at http myhomeseerweb port resX10_config c Open the HomeSeer Options dialog from the View menu select the Interface tab and then select RCS X10 Thermostat from the Active Interfaces list and clicking on the Setup button Add Thermostats to plug in a Specify X10 house code used by thermostat Specify the model of RCS X10 thermostat Specify Location of thermostat to be used within HomeSeer Specify Name of thermostat to be used within HomeSeer Click the Add button when done f Repeat for other RCS X10 thermostats that you wish to add Specify plug in options by navigating your browser to http myhomeseerweb port rcsX10_options You could also select the RCS X10 Thermostat menu and then select Options menu a Specify whether user want to use Celsius or Fahrenheit b Specify whether user wants HomeSeer to use a Windows interface in addition to the web interface c Specify how often user wants the web interface to refresh to provide up to date settings from thermostat d Specify whether user wants logging of thermostat settings changes disabled e Specify whether user wants Debug Mode enabled Configure each thermos
13. S X10 thermostats do not support multiple interfaces so the Thermostat GetXXXX commands use a default interface parameter of 1 e AUTO Mode o AUTO Mode and use of dual setpoints involves an assumption regarding current mode o The plug in assumes that if the current temperature is more than two degrees above the COOL setpoint then the thermostat must be in COOL mode o If the current temperature is more than two degrees below the HEAT setpoint then the thermostat must be in HEAT mode o All other values result in the plug in storing HEAT and COOL setpoints and not acting on them This is necessary since the RCS X10 thermostats do not report an actual thermostat mode while in AUTO e Hold Mode o Implemented via software since RCS X10 thermostats do not support it as a hardware setting o If enabled Hold Mode will prevent all plug in changes to thermostat settings It will NOT prevent changes made at the Wall Display Unit o User can still change thermostat manually User could also change via direct ExecX10 commands e Heat Pump Recovery Mode o If enabled Heat Pump Recovery Mode limits physical setpoint changes to one degree two degrees if in AUTO mode at a time until desired setpoint is reached This helps to prevent use of auxiliary heating when desired heat setpoint is much higher than the current temperature o If disabled physical heat setpoint goes immediately to desired heat setpoint e Dual Setpoint Control o Unlike the T
14. XB16 which natively supports separate heating and cooling setpoints separate HEAT and COOL setpoints for the TX15 B are implemented via software o The separate setpoints can be directly changed via the CmdSetHeat and CmdSetCool commands o When working within the Windows or Web Interface the following strategy is used a Thermostat Mode Change If Model is not a TXB16 with hardware dual setpoint control enabled If change is to HEAT then set thermostat s current setpoint to the plug ins internal heat setpoint setting If change is to COOL then set thermostat s current setpoint to the plug in s internal cool setpoint setting Current Setpoint Change If thermostat s current mode is HEAT then set plug in s internal heat setpoint setting equal to the new setpoint If thermostat s current mode is COOL then set plug in s internal cool setpoint equal to the new setpoint a Heat Setpoint Change Set plug in s internal heat setpoint setting to new value If current mode is HEAT then set thermostat s current setpoint to new value Otherwise if Change Thermostat Mode for Dual Setpoints is enabled TXB16 only then temporarily change mode to HEAT then change thermostat s current setpoint to the new value then change mode back to original mode Cool Setpoint Change Set plug in s internal cool setpoint setting to new value If current mode is COOL then set thermostat s current setpoint to new value Otherwise if Change Thermo
15. an expired filter reminder not allowing Filter Reminder device to be updated o Fixed CheckTrigger error o Individual thermostat logging is no longer supported e Version 2 0 76 o Fixed polling looping e Version 2 0 77 o Except for a user request for immediate polling the plug in will now only allow one stat at a time to be polled Initialization will still be concurrent for multiple stats unless one stat has made two failed attempts After two failed attempts only one stat will be initialized at a time o Fixed inability to disable polling o Fixed inability to save Enable hardware dual setpoint control setting in Windows interface e Version 2 0 78 o Attempted to fix problem recognizing X10 received command when running plug in with HS 1 7 O O o Fixed problems associated with thermostat changes via HomeSeer Status page o Fixed incorrect reporting of ACK and ECHO being OFF Version 2 0 79 o Initialization and polling have been returned to consecutive operation as in earlier builds o Fixed some issues associated with the dual setpoint enhancements Version 2 0 80 o Fixed problem with disabling timed polling but yet still allowing user to force a poll o More fixes for hardware dual setpoint control Version 2 0 81 o Another tweak to improve temperature type recognition Version 2 0 82 o Plug In should now work with HS 1 7 again o Ability to manually poll when polling interval is 0 was fixed o Using the reset button to reset fi
16. bled Improved refreshing of web thermostat control interface e Version 1 1 28 O O O O O Improved command control processing to reduce scripting and web lockups The thermostat s name is shown as a tooltip text when mouse is hovered over the housecode displayed on the Thermostat Control Interface Fixed a heat cool setpoint bug Fixed a bug where failed polling would keep retrying Polling now stops after three failed attempts Fixed a bug where a forced pol via PollStat would not work e Version 1 1 29 O Fixed trigger for Cool Setpoint less than e Version 1 1 38 O O O O O O Improvements to web interface response time Fixed some web control bugs Another attempt to allow use of ACK MESSAGE Mode for command confirmation when thermostat does not support ECHO COMMAND Mode Fixed web fan mode control issue Fixed a Settings Mode bug Fixed a command confirmation error e Version 1 1 43 O O O Fixed Control device via menu and Control device via web problems with Setback Mode Fixed a Heat Pump Recovery Mode bug Added CmdSetFanDate Added All Thermostats and Becomes Initialized conditions Fixed Temperature Increases Temperature Decreases and Thermostat Mode Changed triggers The device strings of heat and cool setpoints are now shown within square brackets If the current mode is HEAT then the heat setpoint value is prefaced with the current setpoint adjusted by the
17. confirmation o Fixed problem with right click context menu on Thermostat Web Interface Version 2 0 43 o Fixed GetDevice warning in HomeSeer log o X10 command queue is no longer populated when plug in is deactivated o When plug in options are changed log entries are only written if the options has changed Version 2 0 44 o Changes to prevent possible problems related to HS2 s multithreaded capability Version 2 0 45 o Fixed object errors resulting from Version 2 0 44 changes o To account for later TXB16 thermostat firmware revisions that do not support SAFE COMMAND Mode SAFE COMMAND Mode is assumed Off on third attempt to set it e Version 2 0 47 o Temperature reporting changes e Version 2 0 48 o Fixed a potential bug for HS 1 7 users e Version 2 0 55 o Fixed some temperature type identification issues e Version 2 0 56 o Fixed problem with activating deactivating plug in e Version 2 0 58 o Brought back a feature in earlier versions where thermostat properties changes were written to the HomeSeer log This feature can be enabled disabled via the plug ins Options Also added a LoggingEnabled property to Extended API for scripting use e Version 2 0 59 o Fixed plug in device strings that were showing UNKNOWN o Added independent retrieval of heat and cool setpoints during initialization and polling for later firmware versions of TXB16 If you have a TXB16 that supports this you will need to enable this in the thermostat propertie
18. ctions Also created corresponding CmdSetHeatAdjust and CmdSetCoolAdjust functions e Version 0 9 3 o Improvements to polling routines A zero or empty field in GUI poll time disables polling o Removed thermostat script warning since Updater already displays that warning e Version 0 9 4 o Added support for non bi directional thermostats e Version 0 9 5 o Fixed ACK Echo Safe and AUTOSEND mode settings not being read from config file during startup o Decode table can now be selected via menu o Renaming a thermostat also fixes any associated events o Fixed setpoints not being correctly limited to user absolute values o Fixed some bugs with heat cool setpoints o Web interface no longer uses popup form processing and instead uses a hidden frame form processing This should provide a cleaner look and feel and not require popup blockers to be turned off e Version 0 9 8 o Improvements to logic for sending commands to thermostat o Fixed loss of thermostat name when editing thermostat properties via Windows interface o Added better error checking to web interface o Warning and error messages cause thermostat log window to automatically display o Improved thermostat windows interface right click contextmenu display o Added a message to both windows and web interfaces to indicate whether thermostat is initializing o Web interface will now properly indicate setback mode e Version 1 0 0 o Release version e Version 1 0 2
19. eded Not necessarily It depends upon whether you wish the hardware settings to be maintained in the event that HomeSeer and this plug in are not running Q What is the plug in strategy for handling Thermostat Modes A The plug in uses the following logic for Thermostat Mode e If in Auto Mode the plug in tries to does the following check o If Current Temperature is more than two degrees above Cool Setpoint then plug in assumes Cool Mode o Elself Current Temperature is more than two degrees below Heat Setpoint then plug in assumes Heat Mode o Else the plug in considers mode to be UNKNOWN e Ifin System Off Mode the plug in considers mode to be UNKNOWN Q What is the plug in strategy for handling Setback Mode A As of Version 1 2 2 the plug in uses the following logic for Setback Mode Setback Mode is Off e Adjusting Current Setpoint while mode is Cool Mode or mode is UNKNOWN causes Current Setpoint to change and stores the value as the new Cool Setpoint e Adjusting Current Setpoint while mode is Heat Mode or mode is UNKNOWN causes Current Setpoint to change and stores the value as the new Heat Setpoint e Adjusting Cool Setpoint while mode is Cool Mode or mode is UNKNOWN causes Current Setpoint to be changed to the Cool Setpoint e Adjusting Heat Setpoint while mode is Heat Mode or mode is UNKNOWN causes Current Setpoint to be changed to the Heat Setpoint Setback Mode is turned On e Plug in shows that Setback Mode
20. essage each time there is a change in temperature setpoint fan mode A report of temperature change is preceded by a Temp Change Unit 6 level 9 report status message and a report of change in setpoint is preceded by a Setpoint Change Unit 6 level 10 report status message The temperature or setpoint value is represented as a preset level in the Report Temperature group in Unit Codes 11 16 Enable Disable ACK MESSAGE Mode From the RCS X10 Thermostat Bi directional Protocol Manual When this message acknowledgment mode is activated an RCS product that receives a valid X 10 message will transmit an acknowledgment message in the form of the standard X 10 Status message The ACK responses are as follows Status ON message received and command completed Status OFF message received but command not completed successfully No ACK back message invalid or not received xiv Enable Disable ECHO COMMAND Mode From the RCS X10 Thermostat Bi directional Protocol Manual This message acknowledgment method echoes commands back It uses the Preset Dim format and only works with the Preset Dim Commands in Unit Codes 1 to 4 When a Preset Level Command is received it is acknowledged by being echoed back as the same preset level on a different unit code For instance a Setpoint temperature transmitted as a Unit Code 1 3 Preset Level is echoed back in the corresponding temperature Preset Level in the REPORT TEMPERATURE Unit Codes 11 16 A
21. et to Off or set to ON and confirmed as ON only on 3rd and final initialization attempt ECHO COMMAND Mode set to Off or set to ON and confirmed as ON only on 3rd and final initialization attempt 11 SAFE COMMAND Mode set to Off or set to ON and confirmed as ON only on 3rd and final initialization attempt 12 AUTOSEND Mode set to Off or set to ON and confirmed as ON only on 3rd and final initialization attempt SOOT Oy Oia eo m 2 Q What are the ACK MESSAGE Mode ECHO COMMAND Mode SAFE COMMAND Mode and AUTOSEND Mode A The RCS X10 Thermostat manual does a good job of explaining these modes but will briefly describe them and mention how they are used within the RCS X10 Thermostat Plug In The plug in uses all of these modes which in unison help to ensure failsafe operations of your X10 thermostat There is one caveat to this in that some systems seem to not be compatible with the use of some or all of these settings Obviously in those cases the modes become detrimental At this time a complete explanation of what systems may experience this is unavailable so the user must use trial and error at this time When SAFE COMMAND Mode is enabled not available with later firmware versions of the TXB16 thermostat commands must be sent twice within a 2 second timeframe before the thermostat processes the command ACk MESSAGE Mode confirms commands sent to the unit by sending back a J Status On command where J is the thermostat s
22. housecode The ECHO COMMAND mode causes commands to be echoed back as another method of confirming receipt of the command ACK and Echo are used together as some commands require ACK mode as they are not echoed back These commands can be enabled disabled by right clicking on the Thermostat s Control nterface Q What message and command modes must be enabled A None really which would make the plug in not much different than the original thermostat scripts To maintain the ability of the plug in to confirm commands sent ACK MESSAGE Mode or ECHO COMMAND Mode needs to be enabled To have the plug in automatically report changes occurring at the thermostat temperatur change or someone manually changes setpoint then AUTOSEND Mode needs to be enabled If AUTOSEND Mode is disabled then a faster polling time would effectively perform the same function albeit it would not be nearly as instantaneous SAFE COMMAND Mode should be enabled if your system tends to cause HomeSeer to receive spurious commands Note that some users have been unable to operate their stats with one or more of the message command modes in which case those modes should be turned OFF The SAFE COMMAND Mode is notoriously bad on some systems but have successfully used all four modes for many months with both RCS TX15 B and TXB16 X10 thermostats Q How does the plug in differ from the original thermostat scripts A The plug in takes full advantage of the use of HomeSeer eve
23. ing and logging that provides information for debugging Normal logging includes reports for changes to thermostat settings This can be disabled within the Thermostat Properties For debugging there are two debug modes simple and advanced The advanced debug mode includes event queue processing information Debug Mode is enabled via the Plug In Options Q Can manually send commands to the thermostat A Yes You can send commands using HomeSeer s Control Panel but realize that HomeSeer uses Preset Dims 0 31 while the RCS X10 thermostat manual refers to Preset Levels 1 32 This means that you need to subtract 1 from the value in the RCS Preset Level table Note that you can also send Unit ON OFF commands from a X10 mini controller or X10 remote The function that the unit code commands perform depends upon the selected Decode Table refer to RCS manual Q What are the the dual setpoint options for TXB16 thermostats A Enable hardware dual setpoints was added to ensure that the TXB16 stats had been set to use hardware dual setpoints When enabled the plug in should be able to better distinguish between setpoints by taking advantage of Cool Setpoint changes and Heat Setpoint changes reported by AUTOSEND mode Firmware supports is for TXB16 firmware that has commands to explicitly retrieve heat and cool setpoints Temporarily Change is for TXB16s to overcome the lack of a explicit commands to SET heat and cool setpoints Are these ne
24. is ON Heat Setpoint and Cool Setpoint are left unchanged e Current Setpoint i is decrease by Setback Delta when thermostat is in Heat Mode and is increasted by Setback Delta when thermostat is in Cool Mode e Setback Mode indicator blinks Setback Mode is On e Adjusting Current Setpoint while mode is Cool Mode or mode is UNKNOWN causes Current Setpoint to change and stores the value as the new Cool Setpoint and disables Setback Mode e Adjusting Current Setpoint while mode is Heat Mode or mode is UNKNOWN causes Current Setpoint to change and stores the value as the new Heat Setpoint and disables Setback Mode e Adjusting Cool Setpoint while mode is Cool Mode or mode is UNKNOWN only causes the new Cool Setpoint to be stored e Adjusting Heat Setpoint while mode is Heat Mode or mode is UNKNOWN only causes the new Heat Setpoint to be stored Setback Mode is turned Off e f mode is Cool Mode force stored Cool Setpoint as new Current Setpoint e f mode is Heat Mode force stored Heat Setpoint as new Current Setpoint e If mode is UNKNOWN do nothing Revision History e Version 0 4 0 o Fixed View Options Interfaces url bug o Fixed menu item unregistering bug o Fixed inability to remove Plug Ins menu if created by HS o Fixed setback mode X10 code error o Fixed Decode Table P log entries o Fixed Filter Reminder not changing o Fixed increasing decreasing temp setpoint o Popup window move cursor release o Fixed Web UI thermostat
25. itate creating of conditional triggers e Version 1 1 15 o There are now conditional triggers for filter reminder setpoints and temperatures that are more inituitive than directly using device values o Fixed display of Action Trigger and Condition strings o Buttons for Heat Up Down and Cool Up Down have been replaced with ability to directly set setpoint e Version 1 1 16 o Fixed ability to directly set setpoint values e Version 1 1 18 o Fixed DATA folder errors occurring with new installs o Fixed bug with adding a thermostat o Fixed some bugs with Conditions o Fixed a bug reported for some events not being able to be added to event queue e Version 1 1 19 o Improved Conditions support e Version 1 1 20 o Simplified scripting interfaces and improved its performance o Fixed a setback delta confirmation bug e Version 1 1 21 o Improved temperature unit change functionality o Fixed Settings Mode selection bug o Fixed web interface bug o Fixed some issues with thermostats not showing in Windows interface menu e Version 1 1 22 o Fixed bugs with direct device control of thermostat settings e Version 1 1 23 o Improved look of thermostat control interface buttons o Added ability to disable logging o Polling bug fixed o Config and Options dialogs within Window s interface now close when Add OK button or Cancel button is selected e Version 1 1 24 O O More polling improvements Note however that if AUTOSEND is enabled then polling can be disa
26. l temperatures values that prevent some command confirmations e Version 1 2 14 o Another attempt to fix fractional temperatures values that prevent some command confirmations e Version 1 2 16 o Event triggers modified to be more intuitive Should not affect existing triggers Multiple triggers are now shown as being OR d only one trigger is checked at any given time o Improved AUTO mode operational strategy with regards to dual setpoints Note that this and any strategy involving this mode is subject to possible problems given that the RCS X10 stats do not report actual mode so plug in must make assumptions about actual mode o Plug In now uses an XML configuration file rather than an INI o Plug In opens new default browser window rather than using a Windows Browser Control window e Version 1 2 18 o Fixed bug where duplicate set of plug in devices were being created o Improved temperature unit selection no longer need to restart o Add a few more item to Options page e Version 1 2 19 o Fixed bug where if initialization failed for one stat others would not operate properly Version 1 2 21 o Fixed bug where polling would not complete o Removed debugging code from 1 2 20 that would not init stats Version 1 2 23 o Added more error protection for API scripting commands o Added filter for received X10 commands to prevent repeated temperature related commands from being misinterpreted o Fixed web JavaScript bug related to debug value
27. lder builds o In an attempt to correct lingering command looping with HS 1 7 recent I O queue timing as adjusted and a value added to Settings xml RecentEventTimerInterval for manually tweaking of this parameter Version 2 0 94 o Fixed PluginActive status looping with HS 1 7 Version 2 0 95 o Fixed setting of dual setpoints while in AUTO mode Version 2 0 96 o Added Unknown Temperature Type received event trigger o More work on Change Thermostat Mode for Dual Setpoints option o Reduced total initialization time Version 2 0 97 o Fixed Recent Event queue not emptying o Fixed setpoint temperatures not adhering to user hardware limits Version 2 0 98 o Filter Reminder can now be disabled by setting Filter Days to 0 Note that device will still be displayed within HomeSeer o Fixed issues with setting dual setpoints via events Version 2 0 99 o Heat Pump Recovery Mode improved Now only works with heating mode as it should have been o Disabling the plug in now stops RCS X10 Thermostat even conditions triggers and actions from working o Fixed a problem where failed commands would not be removed from the event queue and would continue to repeat Version 2 0 100 o Fixed initialization problem related to Change Thermostat Mode for Dual Setpoints option Version 2 0 101 o Include Setback Mode Delta When Polling options is now an individual thermostat property instead of a global setting o Fixed initialization problem when
28. lter reminder within Thermostat Properties will now immediately reflect a change if any to the filter days field Version 2 0 83 o Fixed problems with setpoint events Version 2 0 85 o Fixed problems with using the feature that changes thermostat modes to set hardware dual setpoints TXB16 only o Fixed problems with Message Mode settings ACK ECHO SAFE and AUTOSEND not remaining persistent o Attempted to fix some Setback Mode related issues Version 2 0 86 o Fixed problem with polling interval setting not being retained Version 2 0 87 o Plug In now polls a setting that was not properly confirmed Version 2 0 89 o Fixed more problems with Setback Delta misinterpretations o Fixed most HS 1 7 looping issues o Added ability to exclude Setback Mode Delta from initialization and polling for users who do not use Setbacks Version 2 0 90 o Plug in now employs immediate temperature and setpoint polls when temperature type cannot be determine from a received temperature value o Fixed problems with repeated error messages for invalid settings Should only see message once o When operating with debug mode enabled references to Ignore I O queue are now termed Recent I O queue to better reflect what is happening with the event queues Version 2 0 91 o Fixed inability to recognize a returned Setpoint value as Heat Setpoint when thermostat is in HEAT mode and vice versa for COOL mode o Fixed TriggerUI format bug when upgrading from o
29. nts including triggers actions and conditions Plug In devices are created that allow a quick glance of the status of several important thermostat settings The plug in also provides a GUI for controlling your RCS X10 thermostats The interface is designed to have the same look and feel as the Wall Display Unit WDU for your thermostat Additionally the plug in has some behind the scenes differences when compare to the thermostat scripts Belov are some of those differences e Plug In uses AUTOSEND mode there was at least one thermostat script that used this this increases preset dim traffic and cannot control when stat is sending the info User can disable if necessary e Plug In uses ACK MESSAGE Mode ECHO COMMAND Mode and SAFE COMMAND Mode All can increase preset dim traffic but the plug in has some control over spreading the commands apart by putting a delay between commands being sent SAFE COMMAND Mode has the benefit of preventing spurious changes bu some users have reported problems with it and suppose it is not needed if you never had problems with spurious commands when running a thermostat script All of these modes can be disabled by user e Plug In performs an initialization which is where the most user reported problems have occurred Although plug in can use polling it is designed to rely on AUTOSEND Thermostat scripts used polling Q What type of information logging is performed by the plug in A There is normal logg
30. o Changed minor build for new release version Version 1 2 1 o Fixed GetHouseCode extended API script command o Fixed Fahrenheit Celsius change o Temperature Setpoint reports from thermostat are now handled better o Setback Delta value of 0 is no longer supported A zero Setback Delta is not supported by RCS but was used by plug in as a redundant method of turning Setback Mode off Version 1 2 2 o Changes to Current Setpoint e g at WDU cause Setback Mode to be disabled if Setback Mode had been enabled o There is now a simple and an advanced debugging mode The advance mode includes debug entries for message queuing Version 1 2 3 o Fixed isbusy javascript web bug Version 1 2 4 o Fixed FilterReminder device not updating o Added warning when user attempts to enable Safe Mode e Version 1 2 5 o Fixed bug with using Celsius with Decode Table commands o Added ability to use unit code commands as specified by current Decode Table instead of preset dims whenever possible e Version 1 2 7 o Fixed command confirmation for setpoints o Fixed inability to disable debug mode e Version 1 2 9 o Fixed some JavaScript web page bugs e Version 1 2 11 o Fixed ConditionUI validation error e Version 1 2 12 o Fixed inability to change Debug Mode Level o Fixed Setback Delta issues for Celsius Note that this bug cause UNKNOWN MESSAGE Statusltem 7 Status errors o Fixed some temperature unit change bugs e Version 1 2 13 o Fixed fractiona
31. poller e Version 0 4 1 o Fixed setting thermostat mode to OFF O Improved dual setpoint control for TX15 B e Version 0 5 0 O O O Fixed event trigger bugs Fixed a myriad of other minor bugs Implemented two strategies for polling thermostat via web page see Notes above e Version 0 5 8 O O O O O O Fixed bug that resulted in repeated plug in initialization notifications Added absolute minimum and maximum setpoint temperatures to Thermostat Properties Added housecode to upper left of Windows Interface in case user has multiple interfaces open at one time Added ability to disable various command modes via configuration file tweak Added small browser control for Web Interface when plug in accessed locally Added message when plug in installed to remind user to disable existing thermostat scripts heidner e Version 0 6 0 O O O O RCS X10 Thermostat Event actions are now working FailSAFE COMMAND modes SAFE ACK ECHO can be tweaked and thermostat reinitialized without restarting HomeSeer Default command confirmation timeout is 10 seconds and there are 2 retries before failure is declared Disabled ability to place menu items within Plug Ins menu as this did not seem to be fully support by current versions of HS Added Init_Attempts and Init_Successes entries to hspi_rcsX10therm ini so that user can determine initialization performance Plug in is now supplied with rcsX10_processor asp file
32. re improvements to thermostat X10 event handling Fixed a bug with the report of a dual setpoint value Added menu item for Windows Interace that will allow all thermostats to be shown Both Windows and Web Interfaces use a right click context menu to access more thermostat features Thermostat Properties and Thermostat Log are now accessed via this menu rather than via icons Fixed ability to move Thermostat Log and Thermostat Properties windows for Web Interface Windows interface now supports placement of thermostat interface on an extended desktop when using multiple monitors Web interface now supports placement of thermostat interface on Active Desktop In addition to specifying the house code you need to specify rawpage true as part of querystring e g http nomeseer rcsX10_control housecode J amp rawpage T rue e Version 0 7 44 O O O O Fixed bug with configuration file settings that was forcing fail safe modes to incorrect settings Config and Options menu items fixed Received X10 events are now handled immediately rather than queued Sent X10 events are now handled by a queue processed at the individual thermostat level rather than at the plug in level e Version 0 8 X O Fixes to initialization routines e Version 0 9 1 o Fixed bug with adjusting setpoint by one degree increase decrease via Cool Up Cool Down and Heat Up Heat Down commands Needed to create CmdSetTempAdjust command to handle these fun
33. s o Also added option for TXB16 stats to change thermostat mode to force appropriate heat cool setpoints which is necessary if stat is in AUTO mode Note that this will potentially cause HVAC unit to temporarily turn on using an undesired mode e Version 2 0 60 o Fixed Web Thermostat Control Interface o Setup button on Interfaces Tab of HS2 Options Page now brings up config page e Version 2 0 61 o Fixed plug in status and thermostat status device strings o Fixed problem with reactivating plug in once inactivated e Version 2 0 62 o Fixed web errors occurring when changing options o Removed web page processor functionality to ensure proper functioning of HS web links o HS2 broke Settings Mode functionality so a temporary fix requires that the event contain the name of the thermostat or contain the words all thermostats in order for it to be considered a settings mode Before the event could have any name but needed to have a least one thermostat action e Version 2 0 63 o Fixed problem with polling timer o Fixed updating of Windows interface menus when a stat is added removed Had to remove menu divider lines o Fixed problem with new dual setpoint strategy for TXB16 stats being disabled on the web thermostat properties page o For users who enable Change Thermostat Mode For Setpoints option for TXB16 thermostats the thermostat mode is temporarily changed during initialization to ensure retrieval of correct dual setpoints in
34. s limited based upon the thermostat model according to the RCS manual Three seconds after user has quit adjusting setpoint the new setpoint is will then be used Note that the system may or may not respond immediately unless the criteria specified by the RCS manual are met In the HEAT mode the heating system will be turned on at one degree below the setpoint and will turn off at the setpoint In the COOL mode the cooling system will be turned on at one degree above setpoint and will turn off at the setpoint In the AUTO mode the current heating or cooling operating mode will operate as usual with the one degree setpoint control In order for the system to change operating mode from heating to cooling the temperature must rise two degrees above setpoint Right click on the Thermostat Control Interface to configure the thermostat Additional Notes e General o References to Preset Level are equivalent to X10 preset dim 1 to be consistent with RCS documentation that refers to Preset Levels 1 to 32 o For the web interface polling is performed at a rate specified by WebPollingInterval default 30 sec either via configuration setting or querystring parameter o When the Thermostat API GetXXXX x y commands are used the value returned is the currently stored value o When the ThermostatGetXXXX commands for a given thermostat are called directly there is an optional parameter available to have the value polled o Note that RC
35. stat Mode for Dual Setpoints is enabled TXB16 only then temporarily change mode to COOL then change thermostat s current setpoint to the new value then change mode back to original mode Q What is involved in initialization and how does it differ from polling A will answer the second question first Initialization and polling both send commands requesting information from the thermostats This is done to ensure that the plug in has the most up to date information especially when HomeSeer and the plug in have not been running While running polling becomes less necessary if AUTOSEND Mode is enabled since this mode provides info on changes made For Setback Mode users polling may still be useful because AUTOSEND Mode does not provide information on Setback Mode changes Since initialization occurs at startup or by user request if deemed necessary more steps are involved as this ensures that no major changes to the thermostat settings were made while HomeSeer and the plug in were not running There are 12 initialization steps and 7 polling steps Both are show below with the polling steps shown in bold 1 Current temperature retrieved Current thermostat mode retrieved Current setback mode retrieved Current fan mode retrieved Current setback delta retrieved Heat setpoint retrieved see dual setpoint control Cool setpoint retrieved see dual setpoint control Hardware dual setpoint set TXB16 only ACK MESSAGE Mode s
36. tat by displaying the Thermostat Control Interface Navigate your browser to http myhomeseerweb port rcsX10_control housecode where is the house code of the thermostat to use the web interface or select the RCS X10 Thermostat menu to select the Windows interface Then select the menu item with the name of your thermostat Right click on the Thermostat Control Interface to a Cancel initialization of a thermostat or perform a manual initialization b Right click on the Thermostat Control Interface to access thermostat properties ooo fF Vil viii Xi Xil xiii Location Name Heat setpoint Cool setpoint Absolute minimum setpoint Absolute maximum setpoint Filter Reminder Heat Pump Recovery Mode For TXB16 thermostat specify whether to use hardware dual setpoints For TXB16 thermostat specify whether to use independent retrieval of heat and cool setpoints during initialization and polling Make sure that your firmware version supports this and that you have also enabled hardware dual setpoints For TXB16 thermostat specify whether stat should change thermostat mode to force appropriate heat cool setpoints necessary if stat is in AUTO mode Note that this will potentially cause HVAC unit to temporarily turn on using an undesired mode Enable Disable AUTOSEND Mode From the RCS X10 Thermostat Bi directional Protocol Manual The AUTOSEND mode enables the controller to automatically send a m
Download Pdf Manuals
Related Search