HS4 Beta Release 4.2.19.17

Manual Install

Existing HS4 systems or HomeTroller Hubs

1. Navigate to Setup > General and click the CHECK UPDATE button.
2. Click the INSTALL BETA button.
3. An Install Beta pop up appears. Click INSTALL to begin the installation. This may take several minutes to complete. Your controller or computer will restart after the installation completes.

Changes

This release includes some core changes that support our new Z-Wave Plus Z-Wave plugin. It also includes a security update to Newtonsoft.

For Developers

The Newtonsoft update created some dependency issues and required the following changes.

• HS4 references an updated pluginsdk dll in bin/pluginsdk_1_5_0. If you update your plugin and wish to reference a newer version of the DLL, reference the one in the folder for the version you need. This reference is in your plugin EXE config file.
• We are leaving the pluginsdk dll version 1.4.4 in bin/homeseer so existing plugins continue to function properly.
• HS4 now references the  Newtonsoft dll in bin/homeseer/newtonsoft_13_0_3_27908. Note that developers should NEVER reference this DLL. Continue to reference your own Newtonsoft DLL in your private folder in bin/PLUGIN_NAME.
• The previous Newtonsoft dll version 12.0.03 is remaining in bin/homeseer as some plugins are referencing this DLL due to a configuration error with the probing privatePath in their config file. Your config file should always look in your private bin folder first for dependent dlls. A proper probing privatePath in your config file looks like this: <probing privatePath="bin/PLUGIN_NAME;bin/homeseer"/>
• These change ensure that current HS4 installations work normally but allows the HS4 application to reference updated DLL's.
• We are aware of issues with dependency management and will be reviewing a more robust solution going forward.

HS4 Changes from 4.2.19.16

PluginSDK Release Notes for version 1.5

Reverting to a Previous Version

If you wish to revert to a previous version, you'll need to follow the steps below. Starting with beta 4.2.17.2, a new backup feature was added to back up your configuration whenever you update your HS4 version. The backup may be retrieved from Setup.

When running Beta versions of HS4 it is advised that you always perform a backup from the Tools menu. This is an alternate way to go back to a previous config.

Windows

1. Uninstall the beta. Do not remove HS4 settings and temporary files.
   

   

2. Install the previous version.
3. Launch HS4 and navigate to Setup > General and click Edit Config
4. Select the config file that was created when the beta was installed. The name will contain _before_4.2.x.x.json
5. Check your events to confirm they're all there and the actions are correct

Linux

1. Navigate to Setup > General and click REINSTALL UPDATE
   

   

2. Once installation is complete, navigate to Setup > General and click Edit Config
3. Select the config file that was created when the beta was installed. The name will contain _before_4.2.x.x.json
4. Check your events to confirm they're all there and the actions are correct