OSO Energy for Home Assistant (built-in integration)

About

OSO Energy is a built-in integration that connects OSO Energy water heaters to Home Assistant through the vendor's cloud. It adds a water heater entity along with sensors for water temperatures at different tank levels, heater mode, optimization mode, and the amount of mixed water available at 40°C. Binary sensors report whether the heater is heating, in power save, or using extra energy. Actions can read and set the heater temperature profile, set the minimum quantity of water at 40°C, and turn on away mode. Heating can also be turned on or off for one hour, or until the maximum or minimum temperature is reached. Setup happens in the UI and asks for an API key.

Automatic summary of Home Assistant's source code. Something wrong? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Updated with Home Assistant Ships and updates with every Home Assistant release.

Provides

Water heaters
Sensors

Setting it up

It is added under Settings, Devices and services, with Add integration.

OSO Energy auth

API key

Also asked when signing in again.

Texts from Home Assistant's source code, Apache License 2.0.

Entities

Binary sensorsExtra energy, Heating, Power save
SensorsCapacity mixed water 40°C, Heater mode, Optimization mode, Profile local, Tapping capacity, Temperature bottom, Temperature middle, Temperature one, Temperature top, Maximum level of mixed water at 40°C, Minimum level of mixed water at 40°C, Mixed water at 40°C

Actions

Get heater profileGets the temperature profile for water heater
Set heater profileSets the temperature profile for water heaterFields: 00:00, 01:00, 02:00, 03:00, 04:00, 05:00, 06:00, 07:00, 08:00, 09:00
Set v40 minSets the minimum quantity of water at 40°C for a heaterFields: V40 Min
Set away modeTurns on away mode for the water heaterFields: Duration in days
Turn off heatingTurns off heating for one hour or until min temperature is reachedFields: Until temperature limit
Turn on heatingTurns on heating for one hour or until max temperature is reachedFields: Until temperature limit