Files
cantabile-ha-addons/src/profiles/ha-immersion-heater.json
T

42 lines
3.9 KiB
JSON

{
"id": "ha-immersion-heater",
"version": "1.0.0",
"manufacturer": "Home Assistant",
"name": "Immersion heater on a relay, with tank sensors",
"models": ["*"],
"category": "hot-water",
"status": "documented",
"source": "A hot-water tank without a water_heater entity: an immersion heater (Heizstab) switched by a relay (any HA switch) and the tank's temperature sensors (top, optionally bottom), with the heater's power where a sensor measures it. Found by the entities' names, across Home Assistant (not offered by itself: add it under Add device, Home Assistant): the relay switch.<...>immersion / heizstab / heating_rod / tank_heater, the sensors <...>tank / speicher / boiler / warmwasser / hot_water / dhw with top / oben / upper (bottom / unten / lower), the power sensor like the relay. Rename the entities in Home Assistant to fit. Cantabile plans the tank as a store of heat (docs/design/storage-losses.md, control kind dhw_tank, heater element).",
"recognise": {},
"fields": [
{"name": "rated_tank_volume_l", "label": "Hot-water tank, litres (the type plate; needed: the tank is not planned without it)", "type": "number", "rating": "tank_volume_l", "optional": true, "min": 1, "max": 20000},
{"name": "rated_tank_heater_kw", "label": "Immersion heater, kW (its type plate; needed)", "type": "number", "rating": "tank_heater_kw", "optional": true, "min": 0.01, "max": 100},
{"name": "rated_tank_standby_w", "label": "Tank standing loss (ErP S), W (the label or datasheet; kWh per 24 h ÷ 0.024)", "type": "number", "rating": "tank_standby_w", "optional": true, "min": 0.1, "max": 2000},
{"name": "rated_tank_erp_class", "label": "Tank ErP class (1 A+, 2 A, 3 B, 4 C, 5 D, 6 E, 7 F; where the standing loss is not known)", "type": "int", "rating": "tank_erp_class", "optional": true, "min": 1, "max": 7},
{"name": "rated_tank_max_c", "label": "Tank maximum, °C (optional)", "type": "number", "rating": "tank_max_c", "optional": true, "min": 30, "max": 95},
{"name": "rated_tank_room_c", "label": "Room temperature at the tank, °C (optional)", "type": "number", "rating": "tank_room_c", "optional": true, "min": 1, "max": 40},
{"name": "rated_tank_grossanlage", "label": "Large system, DVGW W 551 (1: yes; optional, else from the volume)", "type": "int", "rating": "tank_grossanlage", "optional": true, "min": 1, "max": 1}
],
"setup": [
{"path": "existing", "note": "In Home Assistant already: the immersion heater's relay and the tank's sensors, found by their names (see the profile's source). Enter the tank's volume, the heater's power and the standing loss from its label under Ratings.",
"values": {
"dhw.temp_top": {"entity_id": "^sensor\\..*(tank|speicher|boiler|warmwasser|hot_?water|dhw).*(top|oben|upper)", "device_class": "temperature"},
"dhw.temp_bottom": {"entity_id": "^sensor\\..*(tank|speicher|boiler|warmwasser|hot_?water|dhw).*(bottom|unten|lower)", "device_class": "temperature"},
"dhw.heater_power": {"entity_id": "^sensor\\..*(immersion|heizstab|heating_rod|tank_heater)", "device_class": "power"}
},
"controls": [
{"kind": "dhw_tank",
"entities": {"switch": {"entity_id": "^switch\\..*(immersion|heizstab|heating_rod|tank_heater)"},
"temp_top": {"entity_id": "^sensor\\..*(tank|speicher|boiler|warmwasser|hot_?water|dhw).*(top|oben|upper)", "device_class": "temperature"},
"temp_bottom": {"entity_id": "^sensor\\..*(tank|speicher|boiler|warmwasser|hot_?water|dhw).*(bottom|unten|lower)", "device_class": "temperature", "optional": true},
"heater_power": {"entity_id": "^sensor\\..*(immersion|heizstab|heating_rod|tank_heater)", "device_class": "power", "optional": true}},
"params": {"heater": "element"},
"note": "The relay on and off by the plan (an element, COP 1), at least min_switch_s apart; the element's own thermostat stays the last limit."}
]}
],
"view": {
"card": "sensor",
"headline": ["dhw.temp_top", "dhw.temp_bottom", "dhw.heater_power"]
}
}