BWT Perla integration repository for HACS.
- Firmware with at least version 2.02xx (more info)
- Local API enabled in Settings > General > Connection
- "Login-Code" sent to you by mail during registration (more info)
- local network connection (you need the ip address during setup)
- Add this repository as user-defined repository in HACS
- Setup integration and enter host / ip address and the "Login-Code"
- Optional: set entity bwt total output as water source in the energy dashboard
| Entity Id(s) | Information |
|---|---|
| total_output | Increasing value of the blended water = the total water consumed. Use this as water source on the energy dashboard. |
| errors, warnings | The fatal errors and non-fatal warnings. Comma separated list or empty if no value present. List of values. |
| state | State of the device. Can be OK, WARNING, ERROR |
| holiday_mode | If the holiday mode is active (true) or not (false) |
| holiday_mode_start | Undefined or a timestamp if the holiday mode is set to start in the future |
| hardness_in, hardness_out | dH value of the incoming and outgoing water. Note that this value is not measured, but configured on the device during setup |
| customer_service, technician_service | Timestamp of the last service performed by the customer or technician. The timezone of BWT device and HA server must be the same for this to be correct |
| regenerativ_level | Percentage of salt left |
| regenerativ_days | Estimated days of salt left |
| regenerativ_mass | Total grams of salt used since initial device setup |
| last_regeneration_1, last_regeneration_2 | Last regeneration of column 1 or 2. The timezone of BWT device and HA server must be the same for this to be correct |
| counter_regeneration_1, counter_regeneration_2 | Total count of regenerations since initial device setup |
| capacity_1, capacity_2 | Capacity the columns have left of water with hardness_out |
| day_output, month_output, year_output | The output of the current day, month and year. These values are sometimes too low, probably when a lot of water is used in a short time. The total_output is more reliable to measure the water consumption. #14 |
| current_flow | The current flow rate. Please note that this value is not too reliable. Especially short flows might be completely missing, because this value is only queried every 30 seconds in the beginning. Only once a water flow is detected, it is queried more often. Once the flow is zero, the refresh rate cools down to 30 seconds. |
The firmware 2.02xx is currently rolling out to all devices. If your device does not have it yet, it can be requested through the customer service by mail and will be remotely installed on your device.
It looks like the customer service does not do the update on devices in the UK - it is still unclear why and what other countries are affected.
For more details and recent news, check out the discussion in the HomeAssistant forum.
The Login-Code is sent to you by mail when registering the device for the first time. It is not related to the login credentials for the BWT app.
The integration calculates the blended water volume for all entities. More info on blended water. It does so to make the values comparable - if there is a remaining capacity of 200l, you can use 200l in your house before the BWT needs to start regeneration.
Also the salt level on the device is only showing 10% steps, while this integration has exact percentages.
There are three different volume values, related to how the BWT operates internally. The BWT device sometimes shows either of them, which can lead to confusion.
- incoming water: flowing into the device at e.g. 20dH.
- fully desalinated water: the BWT produces water with a hardness of 0dH
- blended water: By mixing incoming water and fully desalinated water at a given ratio, the requested hardness is produced.
A small example: Target of blended water is 4dH, incoming 20dH. The BWT mixes now 20% of incoming water with 80% fully desalinated water: 0.2 * 20dH + 0.8 * 0dH = 4dH.