From 76787bc4207feddd4ad9695cec3e4f6f58ce7a88 Mon Sep 17 00:00:00 2001
From: osohotwateriot <102795312+osohotwateriot@users.noreply.github.com>
Date: Tue, 29 Jul 2025 14:56:17 +0300
Subject: [PATCH] Add OSO Energy Custom Away Mode Service Documentation
 (#40186)

---
 source/_integrations/osoenergy.markdown | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/source/_integrations/osoenergy.markdown b/source/_integrations/osoenergy.markdown
index ba4e044df92..bb0132d9473 100644
--- a/source/_integrations/osoenergy.markdown
+++ b/source/_integrations/osoenergy.markdown
@@ -168,6 +168,29 @@ script:
           v40_min: 240
 ```
 
+### Service `osoenergy.turn_away_mode_on`
+
+You can use the service `osoenergy.turn_away_mode_on` to enable Away Mode for a water heater for a period of time in the range from 1 to 365 days.
+
+| Service data attribute | Optional | Description                                        |
+| ---------------------- | -------- | -------------------------------------------------- |
+| `entity_id`            | no       | String, name of entity. For example: `water_heater.heater` |
+| `duration_days`        | no       | Number of days to keep Away Mode active (1-365).   |
+
+Example:
+
+```yaml
+# Example script to enable Away Mode for a water heater.
+script:
+  turn_away_mode_on:
+    sequence:
+      - service: osoenergy.turn_away_mode_on
+        target:
+          entity_id: water_heater.heater
+        data:
+          duration_days: 7
+```
+
 ### Service `osoenergy.turn_off`
 
 You can use the service `osoenergy.turn_off` to turn off the heating on your device for one hour or until the minimum temperature is reached.