Skip to content

NeoHub Binding

sprehn edited this page Jul 16, 2014 · 7 revisions

Documentation of the NeoHub binding Bundle

Introduction

The NeoHub binding allows you to connect openhab via TCP/IP to Heatmiser's NeoHub and integrate your NeoStat thermostats onto the bus.

For installation of the binding, please see Wiki page Bindings.

Binding Configuration

The binding polls each thermostat that is configured in your items, at the refresh rate (as set in the cfg file - see below).

Refer to the example below to see what you need to include in your openhab.cfg file:

################################ NeoHub Binding #####################################
#
# Refresh interval in milliseconds (optional, defaults to 60000ms)
#neohub:refresh=60000

# Set the NeoHub network address
#neohub:hostname=

# Set the port number for the NeoHub interface (optional, defaults to 4242)
#neohub:port=4242

Item Binding Configuration

Item strings simply consist of two components - the NeoStat device name (as set in the thermostat and in the mobile app, e.g. Office), and the NeoStat property (e.g. CurrentTemperature). Both parameters are only separated by a colon. Some examples are below.

Switch Heating_Office       "Heating Office"         {neohub="Office:Heating"}
Switch Away_Office          "Away Office"            {neohub="Office:Away"}
Switch Standby_Office       "Standby Office"         {neohub="Office:Standby"}
Number Temperature_Office   "Temperature [%.1f °C]"  {neohub="Office:CurrentTemperature"}

The following properties, and their associated item types are shown below. The R and RW in the description column indicate which properties are read only (RO) or read/write (RW).

Property Type Supported Description
CurrentTemperature Number RO Current room temperature
CurrentSetTemperature Number RO Current set temperature
CurrentFloorTemperature Number RO Current floor temperature
DeviceName String RO Returns the device name
Heating Switch, String RO Returns ON or OFF if heating is currently enabled or not
Away Switch, String RW Returns ON or OFF if thermostat is in away mode or not
Standby Switch, String RW Returns ON or OFF if thermostat is in standby mode or not

feature overview

Installation

Setup intro

Linux and OS X

Windows

FreeBSD


Configuration

Automation*

User Interfaces

Persistence


Community

(link to openHAB forum)

Development


Bindings


Application Integration

Misc


Samples

A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Binding configurations

Use case examples

Item definition examples

Sitemap definition examples

Collections of Rules on a single page

Single Rules

Scripts

Syntax highlighting for external editors


Release Notes

Clone this wiki locally
You can’t perform that action at this time.