From 61e46870f5cb8adc56776aa818509c3e8975ecba Mon Sep 17 00:00:00 2001
From: Jonni Liljamo <jonni@liljamo.com>
Date: Wed, 23 Apr 2025 22:23:35 +0300
Subject: [PATCH] docs: add Advanced examples section

---
 README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/README.md b/README.md
index 81d2e4b..3dbbded 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,26 @@ thinking.
     - [#kotiautomaatio:hacklab.fi](https://matrix.to/#/#kotiautomaatio:hacklab.fi) (Finnish)
 - Open an issue on GitHub.
 
+### Advanced examples
+#### Reading valve position as a number
+In Home Assistant, valve entities only record whether the valve is open or not,
+due to exact position reporting being optional and dependent on the integration
+implementation.
+
+This integration does implement exact position reporting, and as such the
+position can be read by templates.
+
+Example, this will make a helper that can be viewed like a graph in history:
+```yaml
+template:
+  - sensor:
+    - name: "Valve Position"
+      unit_of_measurement: "%"
+      state: >
+          {{ state_attr('valve.l1_valve_position', 'current_position') }}
+```
+
+
 ## GitHub mirror
 
 Mirrored to GitHub so HACS can import it and to have a more accessible issue
-- 
2.44.1