https://github.com/northernman54/homebridge-connex

Homebridge Plugin for Dimplex Connex Wifi Thermostats
https://github.com/northernman54/homebridge-connex

Last synced: 17 days ago
JSON representation

Homebridge Plugin for Dimplex Connex Wifi Thermostats

• Host: GitHub
• URL: https://github.com/northernman54/homebridge-connex
• Owner: NorthernMan54
• Created: 2019-11-06T02:04:53.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2020-02-12T00:00:46.000Z (over 4 years ago)
• Last Synced: 2024-10-10T12:02:13.585Z (29 days ago)
• Language: JavaScript
• Size: 85 KB
• Stars: 7
• Watchers: 5
• Forks: 2
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# homebridge-connex

Homebridge plugin for the [Dimplex Connex WiFi thermostat](https://www.dimplex.com/en/electric_heating/thermostats_controls/products/cxwifi/connex_sup_r_sup_wifi_multizone_programmable_controller).

# Table of Contents

   * [homebridge-connex](#homebridge-connex)

   * [Table of Contents](#table-of-contents)

   * [Roadmap](#roadmap)

      * [To do](#to-do)

      * [Done](#done)

   * [Using the plugin](#using-the-plugin)

      * [Temperature Control](#temperature-control)

      * [Current Temperature](#current-temperature)

      * [Mode Setting](#mode-setting)

   * [Settings](#settings)

      * [Required settings](#required-settings)

      * [Optional settings](#optional-settings)

   * [Known Issues](#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.