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.
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.
2. Communication and control layout
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
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.
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.
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.
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.
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.
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.
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?
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.
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 →