Skip to content

Python library to talk the direct-lan-api to control a Heatmiser Neohub / Neostats - and home-assistant component

Notifications You must be signed in to change notification settings

RJ/heatmiser-neohub.py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Heatmiser NeoHub, NeoStat, NeoPlug Library

This library controls the wireless mesh NeoStat thermostats, via the NeoHub.

It talks the JSON-over-TCP protocol, on the LAN, to the Neo Hub - so no internet access is required.

I do not have any wifi neostats, just the "mesh networked" (aka zigbee) ones.

This library uses asyncio, and strives to be a well-behaved async home-assistant component.

Python 3.5 required!

Although as of Nov 2017, home-assistant only requires python 3.4 or newer, this component needs python 3.5+ (async/await).

Home-assistant is planning to require python 3.5 sometime early 2018 anyway, and many distributions are already using it anyway.

Example CLI Usage

$ export NEOHUB_IP="192.168.0.123"
$ ./neocli.py list

<NeoStat id=1  temp=20.8 name='Bedroom'>
<NeoStat id=2 temp=21.7 name='Office'>
<NeoStat id=3  temp=23.4 name='Kitchen'>

<NeoPlug id=4  status=OFF name='Desktop fan plug'>


$ ./neocli.py rename_zone "Bedroom" "Master Bedroom"
$ ./neocli.py frost_on "Master Bedroom"
$ ./neocli.py switch_on "Desktop fan plug"

Bit of a half-assed CLI, because I mainly built this libary for the...

Home Assistant Integration

Although functional, this is not production ready. For now, installation via custom_components dir in your ~/.homeassistant config dir:

custom_components/
  climate/
    neohub --> link to this repo neohub dir
    heatmiser_neohub.py --> link to this repo heatmiser_neohub.py

and in configuration.yaml:

climate:
  platform: heatmiser_neohub
  host: 10.0.0.197
  port: 4242
  debug: True

Troubleshooting

Connection Refused

This API uses the Legacy API over port 4242.

To use this functionality, you will need to enable Legacy API access for your NeoHub. To do this, log into the app > Settings > API Access > Legacy API Enable. Your NeoHub will now listen to port 4242.

About

Python library to talk the direct-lan-api to control a Heatmiser Neohub / Neostats - and home-assistant component

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages