This page is part of archived documentation for openHAB 2.5. Go to the current stable version

# Heatmiser Binding v1

The Heatmiser binding allows you to control Heatmiser RS-422 network thermostats (also sold under other names). The binding communicates via TCP/IP to an RS-422 adaptor that links to the thermostats.

# Binding Configuration

This binding can be configured in the file services/heatmiser.cfg.

Property Default Required Description
refresh 2000 No frequency in milliseconds to poll each thermostat that is configured in your items. It automatically detects the type of thermostats; this is not set in the items.
address Yes IP address for the Heatmiser interface
port Yes port number for the Heatmiser interface

# Item Configuration

Item strings simply consist of two components: the thermostat address (as set in the thermostat), and the parameter within the thermostat. Some examples are below.

Switch	HallThermostat_Enable	"Hall Heating Enable  [%s]"	{ heatmiser="1:ONOFF" }
Number	HallThermostat_RoomTemp	"Hall Heating Temperature [%.1f °C]"	{ heatmiser="1:ROOMTEMP" }
Number	HallThermostat_SetTemp	"Hall Heating Setpoint    [%.1f °C]"	{ heatmiser="1:SETTEMP" }
String	HallThermostat_HeatState	"Hall Heating State [%s]"	{ heatmiser="1:HEATSTATE" }
Switch	HallThermostat_HWEnable	"Hot Water Heating Enable  [%s]"	{ heatmiser="1:WATERSTATE" }

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

Parameter Type Supported Description
SETTEMP Number, String RW Temperature control setting
RUNMODE Number, String RW -
FROSTTEMP Number, String RW Frost temperature
ROOMTEMP Number, String RO Current room temperature
FLOORTEMP Number, String RO Floor temperature
HOLDTIME Switch, DateTime RO Current hold time (in minutes)
HOLIDAYTIME Switch, DateTime RO Holiday time remaining (in days)
HOLIDAYSET Number, Switch RW Sets the holiday time (in days)
HOLDMODE Switch RO Returns ON or OFF if the thermostat is in hold mode
HOLIDAYMODE Switch RO Returns ON or OFF if the thermostat is currently in holiday mode
WATERSTATE Switch, String RW Returns ON or OFF if the hot water is currently heating
HEATSTATE Switch, String RO Returns ON or OFF if the thermostat is currently heating
STATE Switch, String RO This is a consolidated thermostat state and maybe one of the following - OFF, ON, HOLD, HOLIDAY
ONOFF Switch, String RW Returns ON or OFF if the thermostat is enabled or not

# Example Sitemap

Below is an example sitemap for a Heatmiser thermostat. This includes conditional visibility of items dependant on the thermostat state.

Frame label="Lounge Thermostat" {
    Switch item=LoungeThermostat_Enable label="Lounge Thermostat Enable" 			
    Text item=LoungeThermostat_HeatState visibility=[LoungeThermostat_State==ON,LoungeThermostat_State==HOLD]
    Text item=LoungeThermostat_HolidayTime visibility=[LoungeThermostat_State==HOLIDAY]
    Setpoint item=LoungeThermostat_FrostTemp label="Lounge Frost Temperature [%d °C]" minValue=10 maxValue=18 step=1 visibility=[LoungeThermostat_State==HOLIDAY]
    Setpoint item=LoungeThermostat_SetTemp label="Lounge Setpoint [%d °C]" minValue=14 maxValue=25 step=1 visibility=[LoungeThermostat_State==ON,LoungeThermostat_State==HOLD]
    Text item=LoungeThermostat_FloorTemp valuecolor=[>28="red",>26.5="orange",>18="green", >16="orange", <=16="red"] 
    Text item=LoungeThermostat_RoomTemp  valuecolor=[>28="red",>26.5="orange",>18="green", >16="orange", <=16="red"]
    Setpoint item=LoungeThermostat_HolidaySet label="Lounge heating holiday days [%d]" minValue=0 maxValue=30 step=1