From d172282263ce8e93c9e361638e9b1d13d2d8d334 Mon Sep 17 00:00:00 2001
From: xengineering <me@xengineering.eu>
Date: Mon, 23 Mar 2026 20:10:04 +0100
Subject: Document /cover/<id>/movement MQTT topic

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

(limited to 'README.md')

diff --git a/README.md b/README.md
index d4a73b8..2b40691 100644
--- a/README.md
+++ b/README.md
@@ -112,6 +112,20 @@ For all terms not explained here see the [MQTT version 3.1.1 documentation][9].
     - `open`: contact is open
     - `closed`: contact is closed
 
+### `/cover/<id>/movement`
+
+- description: Allows control of Shelly 2PM Gen3 covers
+- direction: client to Sia server
+- Quality of Service: QoS 2 (exactly once)
+- retained: no
+- receives will message: no
+- topic parameters:
+    - `id`: ID of the Shelly 2PM Gen3 cover
+- payloads:
+    - `extend`: cover increases the covering surface
+    - `retract`: cover decreases the covering surface
+    - `stop`: cover stops current motion if given
+
 [1]: https://homematic-ip.com/
 [2]: https://openccu.de/
 [3]: https://homematic-ip.com/en/product/window-and-door-contact-optical
-- 
cgit v1.3