Heatmiser Binding

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.

PropertyDefaultRequiredDescription
refresh2000Nofrequency 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.
addressYesIP address for the Heatmiser interface
portYesport 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).

ParameterType SupportedDescription
SETTEMPNumber, StringRW Temperature control setting
RUNMODENumber, StringRW -
FROSTTEMPNumber, StringRW Frost temperature
ROOMTEMPNumber, StringRO Current room temperature
FLOORTEMPNumber, StringRO Floor temperature
HOLDTIMESwitch, DateTimeRO Current hold time (in minutes)
HOLIDAYTIMESwitch, DateTimeRO Holiday time remaining (in days)
HOLIDAYSETNumber, SwitchRW Sets the holiday time (in days)
HOLDMODESwitchRO Returns ON or OFF if the thermostat is in hold mode
HOLIDAYMODESwitchRO Returns ON or OFF if the thermostat is currently in holiday mode
WATERSTATESwitch, StringRW Returns ON or OFF if the hot water is currently heating
HEATSTATESwitch, StringRO Returns ON or OFF if the thermostat is currently heating
STATESwitch, StringRO This is a consolidated thermostat state and maybe one of the following - OFF, ON, HOLD, HOLIDAY
ONOFFSwitch, StringRW 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
}