Skip to content

Commit dc9b9b6

Browse files
committed
docs: update README to include Water Heater entity and correct entity platform count
1 parent 7e17f25 commit dc9b9b6

1 file changed

Lines changed: 12 additions & 2 deletions

File tree

README.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ECHONET Lite protocol integration for Home Assistant, powered by [pyhems](https:
1414
- **Event-driven updates** — entity state changes are pushed immediately upon frame receipt
1515
- **Property polling** every 60 seconds for devices that do not send notifications
1616
- **Runtime health monitoring** — creates repair issues when no frames are received for 5 minutes
17-
- **8 entity platforms**: Climate, Fan, Binary Sensor, Button, Number, Select, Sensor, Switch
17+
- **9 entity platforms**: Climate, Fan, Water Heater, Binary Sensor, Button, Number, Select, Sensor, Switch
1818
- **Experimental mode** to enable unverified device classes
1919

2020
## Supported Devices
@@ -44,6 +44,16 @@ These device classes are enabled by default:
4444
- **Speed**: 8 levels mapped to percentage
4545
- **Preset modes**: Auto, Manual
4646

47+
### Water Heater (0x026B) Features
48+
49+
The electric heat-pump water heater class is exposed as a high-level `WaterHeaterEntity` that aggregates operation status (EPC 0x80), operation mode (EPC 0xB0) and target temperature (EPC 0xB3) into a single entity.
50+
51+
- **Operations**: `auto` (automatic water heating), `manual` (manual water heating), `manual_off` (manual heating stopped / away), `off`
52+
- **Target temperature**: setpoint via EPC 0xB3 (range derived from the device's MRA definition, 1 °C step)
53+
- **Current temperature**: measured water temperature (EPC 0xC1) — also exposed as a standalone sensor, mirroring the climate platform's room-temperature convention
54+
55+
> **Note**: 0x026B is currently part of the **experimental** device class set (see below) and must be enabled via the integration options. The dedicated water heater entity is created only after the device is discovered with experimental mode on.
56+
4757
### Generic Entity Platforms
4858

4959
Properties are automatically mapped to entity platforms based on the ECHONET Lite property definition:
@@ -59,7 +69,7 @@ Properties are automatically mapped to entity platforms based on the ECHONET Lit
5969

6070
Enable **"Enable experimental device classes"** in the integration options to access 50+ additional device classes, including:
6171

62-
Water heaters, electric locks, lighting, refrigerators, washing machines, smart meters, EV chargers, bathroom dryers, and more.
72+
Electric water heaters (0x026B, with the dedicated Water Heater entity described above), electric locks, lighting, refrigerators, washing machines, smart meters, EV chargers, bathroom dryers, and more.
6373

6474
> **Note**: Experimental device classes have not been verified with real hardware. Some entities may behave unexpectedly.
6575

0 commit comments

Comments
 (0)