An OpenHAB binding for BWT Perla and Rondomat Duo water softeners. Communicates entirely over the device’s local REST API — no cloud
dependency. Provides 122 channels covering real-time status, water hardness, salt level monitoring, and daily/monthly/yearly water
consumption statistics.
Supported Devices
- BWT Perla (all variants including Perla Hybrid)
- BWT Rondomat Duo
Firmware version 2.02xx or higher required with local API enabled.
Prerequisites
- OpenHAB 5.1.0 or later
- The BWT device must be on the same local network as OpenHAB
- The local API must be enabled on the device:
Einstellungen > Allgemeines > Verbindung - You need the Login Code (sent via email upon product registration with BWT)
Configuration
| Parameter | Required | Default | Description |
|---|---|---|---|
hostname |
Yes | — | IP address or hostname of the BWT device |
port |
No | 8080 | HTTP port of the device API |
password |
Yes | — | Login Code for API authentication |
currentDataPollingInterval |
No | 60 | Polling interval for current data (seconds) |
consumptionDataPollingInterval |
No | 3600 | Polling interval for consumption data (seconds) |
Channels
The binding provides 122 channels organized in 4 groups:
- Current Data (31 channels) — live device status: flow rate, water hardness (in/out in °dH, °fH, mmol/l, ppm CaCO3), salt level & remaining
days, regeneration counts, error codes, holiday mode - Daily Consumption (48 channels) — water consumption per 30-minute slot for the current day
- Monthly Consumption (31 channels) — water consumption per day for the current month
- Yearly Consumption (12 channels) — water consumption per month for the current year
All channels are read-only. The REFRESH command is supported to trigger an immediate poll.
Example Thing
Thing bwtperla:device:mysoftener "Water Softener" [ hostname="192.168.1.100", password="your-login-code" ]
Changelog
Version 1.0.1
- added missing bwt_error.map
Version 1.0.0
- initial release
Resources
- https://github.com/ericbodden/openhab-addon-bwt-perla/releases/download/v1.0.1/org.openhab.binding.bwtperla-1.0.1.jar
- GitHub - ericbodden/openhab-addon-bwt-perla: OpenHAB addon for BWT Perla Water Softener · GitHub
Credits
- The code was entirely generated by Claude code with Opus 4.6, based on this API specification.