From fd6029e791f5a904f0e38b952765c092f54214d9 Mon Sep 17 00:00:00 2001
From: osohotwateriot <102795312+osohotwateriot@users.noreply.github.com>
Date: Wed, 24 Apr 2024 17:09:30 +0300
Subject: [PATCH] Add OSO Energy sensor documentation (#30889)

* Add OSO Energy sensor documentation

* Fix marker style

* Remove provile sensor

* Remove description of profile sensor

* Add descriptions to the sensors.

* Tiny tweaks

* Removing term 'platform'

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/osoenergy.markdown | 29 +++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/source/_integrations/osoenergy.markdown b/source/_integrations/osoenergy.markdown
index 896a08baf7c..eed00259e7b 100644
--- a/source/_integrations/osoenergy.markdown
+++ b/source/_integrations/osoenergy.markdown
@@ -21,12 +21,33 @@ This OSO Energy integration uses a subscription key, which a user can create for
 
 {% include integrations/config_flow.md %}
 
-## Platforms
 
-### Water Heater
+## Sensors
 
-The OSO Energy water heater platform integrates your OSO Energy devices into Home Assistant.
+The **OSO Energy** integration exposes OSO Energy data as a sensor. It provides the following sensors:
 
-The platform supports the following OSO Energy devices:
+- Heater Mode for water heaters.
+  - Indication of the current heater mode on the device.
+- Optimization Mode for water heaters.
+  - Indication of the way heating is managed by the device according to external factors. For example, electricity prices.
+- Power load (kW) for water heaters.
+  - Indication of the current power load of the water heater - how much energy is currently drawn out of the electricity grid.
+- Tapping capacity (kWh) for water heaters.
+  - Indication for quantity of energy that is stored and available for use at the moment - the current kWh equivalent capacity of the water heater.
+- Capacity mixed water at 40°C (L) for water heaters.
+  - Indication of the current quantity of water that can be drained out after mixing the water in the heater with the inlet tap water to produce water at 40°C.
+- V40 Min (L) for water heaters.
+  - The current minimum allowed quantity of mixed water at 40°C. When the current capacity drops below this threshold, the heater will turn on as a feature to guard against cold water.
+- Minimum Level of V40 Min (L) for water heaters.
+  - The lower boundary of the V40 Min sensor that can be achieved during normal operation of the water heater. Can vary depending on the type of the heater.
+- Maximum Level of V40 Min (L) for water heaters.
+  - The upper boundary of the V40 Min sensor that can be achieved during normal operation of the water heater. Can vary depending on the type of the heater.
+
+## Water heater
+
+The OSO Energy water heater integration integrates your OSO Energy devices into Home Assistant.
+
+It supports the following OSO Energy devices:
 
 - Water Heaters
+- Sensors