openHAB

# 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

Name Type Description Default Required Advanced
email text Remeha Home account email address N/A yes no
password text Remeha Home account password N/A yes no
refreshInterval integer Interval the device is polled in seconds 60 no yes

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:

Channel Type Read/Write Description
room-temperature Number:Temperature Read Current room temperature
target-temperature Number:Temperature Read/Write Target room temperature (5-30°C)
dhw-temperature Number:Temperature Read Current hot water temperature
dhw-target Number:Temperature Read Target hot water temperature
dhw-mode String Read/Write DHW mode (anti-frost/schedule/continuous-comfort)
dhw-status String Read Hot water status
water-pressure Number:Pressure Read System water pressure
water-pressure-ok Switch Read Water pressure status (ON=OK, OFF=Low)
outdoor-temperature Number:Temperature Read Outdoor temperature
status String Read Boiler error status
thermal-mode String Read Active thermal mode of the appliance (e.g. heating or hot water)
operating-mode String Read Operating mode of the appliance
seasonal-mode String Read Seasonal mode of the appliance (e.g. winter or summer)
holiday-active Switch Read Holiday schedule is active
zone-mode String Read Mode of the climate zone (e.g. scheduling or manual)
heating-demand String Read Comfort demand of the climate zone (e.g. producing heat)
next-setpoint Number:Temperature Read Target temperature of the next schedule switch point
next-switch-time DateTime Read Time of the next schedule switch point
fireplace-mode-active Switch Read Fireplace mode of the climate zone is active
dhw-next-switch-time DateTime Read Time of the next hot water schedule switch point
dhw-anti-legionella Switch Read Anti-legionella function of the hot water zone is enabled
heating-curve-slope Number Read Heating curve slope (0-4)
heating-curve-base-setpoint Number:Temperature Read Heating curve base setpoint (15-60°C)
heating-curve-max-flow-temperature Number:Temperature Read Maximum 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

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

# Item Configuration

// 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

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
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)

← Remote openHAB →