← All guides

BOILER-FLEX-001 · TRAINING GUIDE

How to connect an ordinary electric water heater to Wesfin Flex

We upgrade the control, not the protection system. An ordinary storage water heater can shift electricity use in time if safety, hot water for the user and independent local control are kept.

Safety first. This material is not an electrical installation diagram. Work on 230/400 V circuits is done by a qualified electrician according to the equipment datasheet. Do not bypass the thermostat, the emergency thermal cut-out, the safety valve or the electrical protection. The pilot stays in the LAB scope only.

1. The water heater as a thermal battery

A water heater does not return electricity to the grid: it can defer heating when the price is high or use an allowed heating window when the price is low. Real load reduction capacity exists only when the heating element is actually drawing energy and there is enough thermal reserve.

Example heating element power2 kW
Tank for the calculation200 L
Physical resourceHeat, not electricity

2. Communication and control layout

Wesfin CloudPortfolio, forecasting, optimisation
↓ secure connection
Wesfin Edge / Home AssistantLocal limits, TTL, command log
↓ heating permission
Relay + power contactor Or the water heater's built-in control input
↓
Factory thermostat → heating elementThe factory thermal cut-out is not bypassed
Technical meter + temperature sensorIndependent confirmation of the actual state

Cloud does not switch the power relay directly. One local actuator is responsible for the command, and the manual LOCAL mode must be available independently of the cloud. If the Internet goes down, expired commands are not replayed.

3. Minimum equipment set

Control relay

Shelly Pro 1 or an equivalent with a dry contact, Ethernet and a local API/MQTT. It drives the contactor and does not bypass the thermostat.

Power contactor

For example, the ABB ESB series. The electrician selects the coil type, rating, load category and isolation.

Power meter

Shelly Pro EM-50 or another technical kW and kWh meter. Technical data must not be presented as official billing metering.

Temperature and LOCAL

A sensor in a location the manufacturer allows and a manual LOCAL/AUTO switch; an external sensor on the casing can be inaccurate.

4. Seven retrofit steps

  1. Check compatibility

    Record the model, power, voltage, datasheet, wiring diagram and thermostat type. Find out whether the manufacturer allows external disconnection or provides a separate control input. Without confirmation – observation mode only.

  2. Start with measurements

    Install power, energy and temperature measurement without touching the protection. Collect 24–72 hours of profile. Mark unknown values as UNKNOWN, not zero.

  3. Build the control unit

    The electrician installs an approved actuator and checks LOCAL/AUTO, the factory thermostat, controller power loss and recovery without fault states.

  4. Connect Home Assistant

    Set up the power, energy, temperature, heating_demand, relay_state and fault entities where they are available. The local connector sends normalised telemetry out over a secure MQTT connection – no open Home Assistant ports.

  5. Create the asset in Lab

    Choose the ELECTRIC_WATER_HEATER type and OBSERVE_ONLY mode. Fill in rated power, tank volume, measurement quality, temperature limits and owner permission. This is a proposed profile for implementation; whether a specific form is available depends on the Lab release.

  6. Test one bounded command

    After a physical check and explicit permission, defer heating for a short set time. Compare the command, the actuator receipt and the actual power drop. Restore LOCAL. A Wesfin command allows heating but does not force the heating element to run against the thermostat.

  7. Test failures

    Check Internet loss, stale telemetry, duplicates, expired TTL, manual LOCAL and the safe state after a restart. Keep an evidence log.

5. What data Wesfin sees

The cloud should see a normalised object, not the addresses of local relays or Home Assistant entities. For example:

{
  "asset_id": "WF-LAB-BOILER-001",
  "type": "ELECTRIC_WATER_HEATER",
  "rated_power_kw": 2.0,
  "actual_power_kw": 1.95,
  "tank_volume_l": 200,
  "water_temperature_c": 63,
  "heating_demand": true,
  "control_mode": "OBSERVE_ONLY",
  "available_up_kw": 0,
  "available_down_kw": 0,
  "telemetry_quality": "MEASURED"
}

Zero availability in the example is a deliberate safeguard until the checks are complete. After the thermal reserve is confirmed, you can calculate available power and the allowed shift time. Proposed commands: DEFER_HEATING, ALLOW_HEATING, RESTORE_LOCAL, SET_HEATING_WINDOW. This is a target contract, not a promise of the current production API.

6. How much heat can be shifted?

Eheat ≈ 0.001163 × VL × ΔT°C

For 200 L and an assumed temperature change of 5 °C, we get 1.16 kWh of thermal energy – about 35 min of a 2 kW heating element running. This is only an idealised example without losses or water draw, not a recommended operating temperature range.

Hot water and Legionella. Water storage mode, thermal disinfection and scald protection are set according to the system's purpose and current requirements. For potable water systems, the CDC recommends storing hot water above 60 °C with suitable mixing at the points of use. The optimiser cannot override sanitary limits.

A nominal 1000 water heaters of 2 kW each is 2 MW of installed capacity, not a guaranteed 2 MW of flexibility. If 35% are available at the same time, the preliminary estimate is 0.7 MW, before any reserve margin.

7. Economics and real monetisation

If 2 kWh per day can be shifted with a full price difference of 1.5 UAH/kWh, gross savings are about 3 UAH per day – 90 UAH per 30 days. Subtract losses, integration costs, connectivity, maintenance, fees, taxes and usage limits. Calculate pessimistic, base and optimistic scenarios.

Commercial boiler rooms can be a higher priority because of larger loads, peak reduction and use of surplus solar plant output. LAB does not perform market settlement and does not grant MARKET_READY status automatically.

8. Checklist before testing

  • □ The datasheet and the manufacturer's permission for the chosen external control method are checked
  • □ The protection design and installation are done by a qualified electrician
  • □ The factory thermostat, thermal cut-out and LOCAL mode keep priority
  • □ Power, energy, temperature and telemetry quality are checked
  • □ Observation without control is done and a baseline profile is defined
  • □ The local controller rejects expired and unsafe commands
  • □ The physical response is measured separately from the command execution acknowledgement
  • □ Loss of connection, return to LOCAL and replay blocking are tested

Completing all items allows a lab report to be issued; production operation requires a separate qualification step.

9. Sources and next steps

Home Assistant: Water heater · Home Assistant: MQTT · CDC: Potable water systems

Next: integration with the existing Wesfin Lab profile catalogue, lab tests with a real water heater and a separate guide for commercial multi-stage electric heaters.

Go to Wesfin Lab →