Installation:

Before starting installation you should know the IP address of the Neo-hub. If you don’t know the IP address, use one of the approaches suggested below to find your neo-hubs IP address.

It is suggested that you should allocate a static IP to the Heatmiser Neo-hub or use a DNS entry that’s resolvable by Home-Assistant (see notes below).

The preferred method of installation is using HACS although the legacy, cut-and-paste method of installation can still be used and is described under Options below. Installing via HACS is a two-stage process. Firstly, add the Heatmiser repository to HACS, then secondly adding the Heatmiser Integration to Home Assistant.

HACS is available from https://github.com/hacs and there are copious resources available (e.g. http://hacs.xyz) about its installation. This will involve lots of Home Assistant restarts! Once you have HACS running…

Stage 1: Add to HACS

Open HACS and go to the Settings tab

Add “https://github.com/MindrustUK/Heatmiser-for-home-assistant” as a repository as an “Integration” type, note you need to include the quote marks around the repository name. Go to the Integrations tab Search for “Heatmiser Neo Integration”, (it will probably be at the bottom!) select and install

When this message appears follow it by going to Configuration -> Server Tools and then “Restart”

Stage 2: Configure the integration in HA:

Go to Configuration -> Integrations and click on the orange icon in the bottom right corner produces a drop down list and scroll down to “Heatmiser Neo Climate”.

When the integration starts you may need to enter the Neo-hub IP address. The port is always 4242.

If you are successful, after restarting HA you will see the results under Configuration -> Entities

(Optional) Pre-relase Installation:

You can use the Redownload functionality in HACS to chose a prerelease version if you want to try the latest development features.

(Optional) Legacy Installation:

For Hass.io:

Install and configure SSH server from the “Add-on store”. Once you have shell run the following:

mkdir -p /config/custom_components
cd /tmp/
git clone https://github.com/MindrustUK/Heatmiser-for-home-assistant /tmp/heatmiserneo
mv /tmp/heatmiserneo/custom_components/heatmiserneo /config/custom_components/
rm -rf /tmp/heatmiserneo/

Restart Home Assistant and setup the integration.

For Windows 10 Manual installation:

Install and configure Samba Share from the “Add-on store”. Change directory to config location then run the following:

Create a network drive pointing at your Home Assistant config directory.
If there is not a sub-directory in this drive called custom_components create it.
Now create a subdirectory under custom_components called heatmiserneo.
Download all the files from the Heatmiser-for-home-assistant Github repository.
Copy and paste all those files into the new Home Assistant heatmiserneo sub-directory.