homebridge-connex

Homebridge plugin for the Dimplex Connex WiFi thermostat.

Table of Contents

• homebridge-connex
• Table of Contents
• Roadmap
  • To do
  • Done
• Using the plugin
  • Temperature Control
  • Current Temperature
  • Mode Setting
• Settings
  • Required settings
  • Optional settings
• Known Issues

Roadmap

To do

1 - Add support for multiple controllers on a single account 2 - Local API ( Currently not supported by WiFi controller, needs further investigation )

Done

1 - Reverse engineer the interface 2 - Fix long running sessions 3 - Repair connections after failure, currently need to restart 4 - Have 'Auto' release hold on a zone, and resume schedule 5 - Have temperature setting changes trigger a Poll 6 - Queue requests to dimplex connex to prevent service API overload 7 - Handle website not available during startup 8 - Investigate options for thermostat not responding - Issue #1 9 - Does current temperature update ? 10 - Set not responding for web site not responding

Using the plugin

Thermostats are retrieved from the dimplex connex site, and are automatically created in the Home App.

Temperature Control

Setting a temperature in 'Heat' mode, set's the temperature with a permanent hold. Setting a temperature in 'Auto', set's the temperature as an override until the next scheduled temperature change.

Current Temperature

The current temperature you see in the Home App is what is reported from the WiFi Controller and not the Baseboard itself and will be the same for each Zone. ie the temperature of the WiFi controller

Mode Setting

Off - Turns the temperature setting of the zone to 0, and place on hold Heat - Changes the temperature setting of the zone to defaultTemp ( Default is 18 Celsius) and place on hold. See defaultTemp optional setting Auto - Remove hold for zone

Settings

"platforms": [{
  "platform": "connex",
  "username": "XXXXXXXXXXXX",
  "password": "XXXXXXXXXXXX"
}]

Required settings

• username - Your Connex Dimplex email address / login
• password - Your Connex Dimplex password

Optional settings

• defaultTemp - Default temperature in Celsius to set a zone to when turning on ( Defaults to 18 Celsius)
• refresh - Data polling interval in seconds, defaults to 60 seconds

Known Issues

1 - Does not support multiple dimplex connex wifi thermostats on a single account ( I don't have the ability to test ). If you have multiple dimplex connex wifi thermostats, and have the time to work with me to get it working, please let me know.