Skip to content

RemehaHeating Binding ​

This binding integrates Remeha Home heating systems with openHAB. It connects to the Remeha cloud service using the same API as the official Remeha Home mobile app.

The binding supports monitoring and control of Remeha boilers that are connected to the Remeha Home cloud service. This includes most modern Remeha boilers with internet connectivity.

Key features include:

  • Real-time monitoring of room and outdoor temperatures
  • Target temperature control
  • Hot water (DHW) temperature monitoring and mode control
  • Water pressure monitoring and status
  • System error status monitoring

Supported Things ​

This binding supports Remeha boilers that are connected to the Remeha Home cloud service.

  • boiler: Represents a Remeha boiler with ThingTypeUID remehaheating:boiler

The binding has been tested with Remeha Calenta Ace boilers but should work with any Remeha boiler that supports the Remeha Home cloud service.

Discovery ​

This binding does not support automatic discovery. Boilers must be manually configured using your Remeha Home account credentials.

Each Remeha Home account typically manages one heating system, so you will need one Thing configuration per account.

Binding Configuration ​

This binding does not require any global configuration. All configuration is done at the Thing level using your Remeha Home account credentials.

Thing Configuration ​

To configure a Remeha boiler, you need your Remeha Home account credentials. These are the same credentials you use for the Remeha Home mobile app.

boiler Thing Configuration ​

NameTypeDescriptionDefaultRequiredAdvanced
emailtextRemeha Home account email addressN/Ayesno
passwordtextRemeha Home account passwordN/Ayesno
refreshIntervalintegerInterval the device is polled in seconds60noyes

The refresh interval should be set between 30 and 3600 seconds. A shorter interval provides more up-to-date data but may increase API usage.

Channels ​

The binding provides the following channels for monitoring and controlling your Remeha heating system:

ChannelTypeRead/WriteDescription
room-temperatureNumber:TemperatureReadCurrent room temperature
target-temperatureNumber:TemperatureRead/WriteTarget room temperature (5-30°C)
dhw-temperatureNumber:TemperatureReadCurrent hot water temperature
dhw-targetNumber:TemperatureReadTarget hot water temperature
dhw-modeStringRead/WriteDHW mode (anti-frost/schedule/continuous-comfort)
dhw-statusStringReadHot water status
water-pressureNumber:PressureReadSystem water pressure
water-pressure-okSwitchReadWater pressure status (ON=OK, OFF=Low)
outdoor-temperatureNumber:TemperatureReadOutdoor temperature
statusStringReadBoiler error status
thermal-modeStringReadActive thermal mode of the appliance (e.g. heating or hot water)
operating-modeStringReadOperating mode of the appliance
seasonal-modeStringReadSeasonal mode of the appliance (e.g. winter or summer)
holiday-activeSwitchReadHoliday schedule is active
zone-modeStringReadMode of the climate zone (e.g. scheduling or manual)
heating-demandStringReadComfort demand of the climate zone (e.g. producing heat)
next-setpointNumber:TemperatureReadTarget temperature of the next schedule switch point
next-switch-timeDateTimeReadTime of the next schedule switch point
fireplace-mode-activeSwitchReadFireplace mode of the climate zone is active
dhw-next-switch-timeDateTimeReadTime of the next hot water schedule switch point
dhw-anti-legionellaSwitchReadAnti-legionella function of the hot water zone is enabled
heating-curve-slopeNumberReadHeating curve slope (0-4)
heating-curve-base-setpointNumber:TemperatureReadHeating curve base setpoint (15-60°C)
heating-curve-max-flow-temperatureNumber:TemperatureReadMaximum flow temperature of the heating curve

The heating curve channels reflect the heating curve settings of the Remeha Home app. They stay NULL if the heating curve is not available for your installation, for example with an eTwist RF.

Full Example ​

Thing Configuration ​

dsl
Thing remehaheating:boiler:myboiler "Remeha Boiler" [
    email="<your-email@example.com>",
    password="<your-password>",
    refreshInterval=60
]

Item Configuration ​

dsl
// Temperature monitoring
Number:Temperature RoomTemp "Room Temperature [%.1f °C]" { channel="remehaheating:boiler:myboiler:room-temperature" }
Number:Temperature TargetTemp "Target Temperature [%.1f °C]" { channel="remehaheating:boiler:myboiler:target-temperature" }
Number:Temperature OutdoorTemp "Outdoor Temperature [%.1f °C]" { channel="remehaheating:boiler:myboiler:outdoor-temperature" }

// Hot water
Number:Temperature DHWTemp "Hot Water Temperature [%.1f °C]" { channel="remehaheating:boiler:myboiler:dhw-temperature" }
Number:Temperature DHWTarget "Hot Water Target [%.1f °C]" { channel="remehaheating:boiler:myboiler:dhw-target" }
String DHWMode "Hot Water Mode [%s]" { channel="remehaheating:boiler:myboiler:dhw-mode" }
String DHWStatus "Hot Water Status [%s]" { channel="remehaheating:boiler:myboiler:dhw-status" }

// System status
Number:Pressure WaterPressure "Water Pressure [%.1f bar]" { channel="remehaheating:boiler:myboiler:water-pressure" }
Switch WaterPressureOK "Water Pressure OK" { channel="remehaheating:boiler:myboiler:water-pressure-ok" }
String BoilerStatus "Boiler Status [%s]" { channel="remehaheating:boiler:myboiler:status" }

Sitemap Configuration ​

dsl
sitemap remeha label="Remeha Heating" {
    Frame label="Temperature Control" {
        Text item=RoomTemp
        Setpoint item=TargetTemp minValue=5 maxValue=30 step=0.5
        Text item=OutdoorTemp
    }
    Frame label="Hot Water" {
        Text item=DHWTemp
        Text item=DHWTarget
        Selection item=DHWMode mappings=["anti-frost"="Anti-frost", "schedule"="Schedule", "continuous-comfort"="Continuous Comfort"]
        Text item=DHWStatus
    }
    Frame label="System Status" {
        Text item=WaterPressure
        Text item=WaterPressureOK
        Text item=BoilerStatus
    }
}

Authentication ​

This binding uses the same OAuth2 PKCE authentication flow as the official Remeha Home mobile app. Your credentials are used only to obtain an access token and are not stored permanently.

The binding automatically handles token refresh and re-authentication as needed.

Limitations ​

  • Only the first appliance from your Remeha Home account is supported
  • Only the first climate zone and hot water zone are monitored
  • The binding requires an active internet connection to the Remeha cloud service
  • API rate limiting may apply - avoid setting very short refresh intervals

Troubleshooting ​

  • Ensure your Remeha Home account credentials are correct
  • Check that your boiler is online in the Remeha Home mobile app
  • Verify your openHAB system has internet connectivity
  • Check the openHAB logs for authentication or API errors
  • Try increasing the refresh interval if you experience connection issues