OpenKNX · estebanri87 · Feb 10, 2026 · Feb 12, 2026
diff --git a/ReleaseNotes.md b/ReleaseNotes.md
@@ -1,3 +1,10 @@
+v 0.5.0
+- Feature: Neues KO "Status Beschattung Bereit" je Kanal
+- Feature: Dachflaeche bevorzugt unzugeordnete Helligkeitssensoren (z.B. Dachsensor)
+- Feature: Wiederherstellung der vorherigen Position nach Fenster offen/gekippt
+- Fix: Azimut-/Helligkeit-UI klarer (Helligkeit Sensor 1..5, "Keine Himmelsrichtung (Azimut-Auswertung aus)")
+- Fix: Schreibfehler und Himmelsrichtungsbezeichnungen korrigiert
+- Doc: Help-Context und Applikationsbeschreibung aktualisiert
 v 0.4.0
 - Feature: Invertieren der Fensterkontakt KO
 - Feature: Auswahl verhalten der Fensterkontakte

diff --git a/ToDos.md b/ToDos.md
@@ -1,14 +1,7 @@
 To Do's
+- Lamellenstellung Beschattung Grundposition wählbar mit maximaler Abweichung von der Grundeinstellung um nicht den Raum komplett zu verdunkeln. 
+- Optionale Status KO´s & Sperren ausblendbar um die Anzahl der sichtbaren KO´s zu reduzieren (falls sie nicht benötigt werden).
 
-- Gekippt heißt nur, das Offen als gekippt interpertiert werden soll:
-
-Offen = 1 bedeutet nicht zu, ist also bei Gekippt = 1 auch 1
-Offen = 0 bedeutet zu, ganz egal was Gekippt anzeigt (Gekippt ist hier immer 1, technisch bedingt)
-Das Fenster ist gekippt, wenn Offen = 1 und Gekippt = 1
-Das Fenster ist offen, wenn Offen = 1 und Gekkippt = 0.
-Verbinde ich das direkt mit Deinen Eingängen, hab ich quasi bei geschlossenem Fenster immer Gekippt und bei gekipptem oder offenen Fenster immer Offen.
-
-- Getrennte Einstellungen für Fenster offen bei Tag und Nach
 
 Long Term To Do'S
 - Szenen 

diff --git a/createDoc.ps1 b/createDoc.ps1
@@ -1 +1,2 @@
-OpenKNXproducer baggages -d doc/Applikationsbeschreibung-ShutterController.md -b src/Baggages/Help_de -p SHC
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+OpenKNXproducer baggages -d "$scriptDir/doc/Applikationsbeschreibung-ShutterController.md" -b "$scriptDir/src/Baggages/Help_de" -p SHC
diff --git a/doc/Applikationsbeschreibung-ShutterController.md b/doc/Applikationsbeschreibung-ShutterController.md
@@ -196,6 +196,67 @@ DOCCONTENT -->
 
 Vorgesehen für den Helligkeitswert einer KNX-Wetterstation.
 
+<!-- DOC -->
+##### Weitere Helligkeitssensoren
+
+Legt fest, wie viele zusaetzliche Helligkeitssensoren (2 bis 5) verwendet werden.
+Die Anzahl bestimmt, welche weiteren Kommunikationsobjekte sichtbar und zu verknuepfen sind.
+
+<!-- DOC -->
+##### Helligkeit Aggregation
+
+Bestimmt, wie mehrere gueltige Helligkeitssensoren zusammengefasst werden, wenn keine Azimut-Auswertung verwendet wird.
+"Mittelwert" mittelt alle gueltigen Sensoren, "Maximum" nimmt den hoechsten Wert.
+
+<!-- DOC -->
+##### Fenster-/Behangausrichtung und Azimut-Auswertung
+
+Die Fenster-/Behangausrichtung im Kanal steuert, wie die Helligkeitssensoren ausgewertet werden:
+
+- **Ost/Suedost/Sued/Suedwest/West**: Azimut-Auswertung ist aktiv. Es werden nur Sensoren mit Azimut-Zuordnung verwendet.
+- **Dachflaeche**: Bevorzugt Sensoren ohne Azimut-Zuordnung (z.B. Dachsensor). Falls keine vorhanden sind, wird der Maximalwert aller Sensoren verwendet.
+- **Keine Himmelsrichtung (Azimut-Auswertung aus)**: Es wird die eingestellte Aggregation (Mittelwert/Maximum) ueber alle gueltigen Sensoren verwendet.
+
+Beispiele (vereinfachte Sicht):
+
+| Sensor-Setup | Fenster-/Behangausrichtung | Ergebnis fuer Helligkeit |
+| --- | --- | --- |
+| 3x Sensor mit Azimut (O/S/W) | Dachflaeche | Max(alle 3 Sensoren) |
+| 4x Sensor mit Azimut + 1x Sensor ohne Azimut | Dachflaeche | Max(alle Sensoren ohne Azimut) |
+| 4x Sensor mit Azimut + 1x Sensor ohne Azimut | Sued | Azimut-Interpolation nur mit den 4 Azimut-Sensoren |
+| 2x Sensor ohne Azimut | Keine Himmelsrichtung (Auswertung aus) | Aggregation ueber alle Sensoren ohne Azimut |
+| 1x Sensor mit Azimut | Keine Himmelsrichtung (Azimut-Auswertung aus) | Aggregation ueber alle gueltigen Sensoren |
+
+<!-- DOC -->
+##### Helligkeit Sensor 1
+
+Azimut-Zuordnung fuer Sensor 1 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
+<!-- DOC -->
+##### Helligkeit Sensor 2
+
+Azimut-Zuordnung fuer Sensor 2 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
+<!-- DOC -->
+##### Helligkeit Sensor 3
+
+Azimut-Zuordnung fuer Sensor 3 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
+<!-- DOC -->
+##### Helligkeit Sensor 4
+
+Azimut-Zuordnung fuer Sensor 4 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
+<!-- DOC -->
+##### Helligkeit Sensor 5
+
+Azimut-Zuordnung fuer Sensor 5 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
 <!-- DOC -->
 #### UV-Index
 
@@ -745,6 +806,23 @@ DOCCONTENT -->
 <!-- DOC -->
 ### Beschattungssteuerung
 
+<!-- DOC -->
+#### Azimut auswerten
+
+Wenn aktiviert, wird die aktuelle Sonnenrichtung fuer die Helligkeit verwendet.
+Bei deaktivierter Azimut-Auswertung wird der Helligkeitswert aus der Aggregation der Sensoren gebildet.
+Dies entspricht der Fenster-/Behangausrichtung "Keine Himmelsrichtung (Auswertung aus)".
+
+<!-- DOC HelpContext="Fenster-Behangausrichtung" -->
+#### Fenster-/Behangausrichtung
+
+Legt die Ausrichtung des Fensters bzw. Behangs fuer diesen Kanal fest.
+Diese Angabe wird verwendet, um den passenden Helligkeitssensor fuer die Beschattungsauswertung auszuwählen.
+
+- **Ost/Suedost/Sued/Suedwest/West**: Azimut-Auswertung ist aktiv. Es werden nur Sensoren mit Azimut-Zuordnung verwendet.
+- **Dachflaeche**: Bevorzugt Sensoren ohne Azimut-Zuordnung (z.B. Dachsensor). Falls keine vorhanden sind, wird der Maximalwert aller Sensoren verwendet.
+- **Keine Himmelsrichtung (Azimut-Auswertung aus)**: Es wird die eingestellte Aggregation (Mittelwert/Maximum) ueber alle gueltigen Sensoren verwendet.
+
 <!-- DOC -->
 #### Nur starten wenn aktuelle Position kleiner gleich
 

diff --git a/src/Baggages/Help_de/SHC-Azimut-Sensor-1.md b/src/Baggages/Help_de/SHC-Azimut-Sensor-1.md
@@ -0,0 +1,5 @@
+### Azimut Sensor 1
+
+Azimut-Zuordnung fuer Sensor 1 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
diff --git a/src/Baggages/Help_de/SHC-Azimut-Sensor-2.md b/src/Baggages/Help_de/SHC-Azimut-Sensor-2.md
@@ -0,0 +1,5 @@
+### Azimut Sensor 2
+
+Azimut-Zuordnung fuer Sensor 2 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
diff --git a/src/Baggages/Help_de/SHC-Azimut-Sensor-3.md b/src/Baggages/Help_de/SHC-Azimut-Sensor-3.md
@@ -0,0 +1,5 @@
+### Azimut Sensor 3
+
+Azimut-Zuordnung fuer Sensor 3 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
diff --git a/src/Baggages/Help_de/SHC-Azimut-Sensor-4.md b/src/Baggages/Help_de/SHC-Azimut-Sensor-4.md
@@ -0,0 +1,5 @@
+### Azimut Sensor 4
+
+Azimut-Zuordnung fuer Sensor 4 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
diff --git a/src/Baggages/Help_de/SHC-Azimut-Sensor-5.md b/src/Baggages/Help_de/SHC-Azimut-Sensor-5.md
@@ -0,0 +1,5 @@
+### Azimut Sensor 5
+
+Azimut-Zuordnung fuer Sensor 5 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
diff --git a/src/Baggages/Help_de/SHC-Azimut-auswerten.md b/src/Baggages/Help_de/SHC-Azimut-auswerten.md
@@ -0,0 +1,6 @@
+### Azimut auswerten
+
+Wenn aktiviert, wird die aktuelle Sonnenrichtung fuer die Helligkeit verwendet.
+Bei deaktivierter Azimut-Auswertung wird der Helligkeitswert aus der Aggregation der Sensoren gebildet.
+Dies entspricht der Fenster-/Behangausrichtung "Keine Himmelsrichtung (Auswertung aus)".
+
diff --git a/src/Baggages/Help_de/SHC-Fenster-Behangausrichtung-und-Azimut-Auswertung.md b/src/Baggages/Help_de/SHC-Fenster-Behangausrichtung-und-Azimut-Auswertung.md
@@ -0,0 +1,18 @@
+### Fenster-/Behangausrichtung und Azimut-Auswertung
+
+Die Fenster-/Behangausrichtung im Kanal steuert, wie die Helligkeitssensoren ausgewertet werden:
+
+- **Ost/Suedost/Sued/Suedwest/West**: Azimut-Auswertung ist aktiv. Es werden nur Sensoren mit Azimut-Zuordnung verwendet.
+- **Dachflaeche**: Bevorzugt Sensoren ohne Azimut-Zuordnung (z.B. Dachsensor). Falls keine vorhanden sind, wird der Maximalwert aller Sensoren verwendet.
+- **Keine Himmelsrichtung (Azimut-Auswertung aus)**: Es wird die eingestellte Aggregation (Mittelwert/Maximum) ueber alle gueltigen Sensoren verwendet.
+
+Beispiele (vereinfachte Sicht):
+
+| Sensor-Setup | Fenster-/Behangausrichtung | Ergebnis fuer Helligkeit |
+| --- | --- | --- |
+| 3x Sensor mit Azimut (O/S/W) | Dachflaeche | Max(alle 3 Sensoren) |
+| 4x Sensor mit Azimut + 1x Sensor ohne Azimut | Dachflaeche | Max(alle Sensoren ohne Azimut) |
+| 4x Sensor mit Azimut + 1x Sensor ohne Azimut | Sued | Azimut-Interpolation nur mit den 4 Azimut-Sensoren |
+| 2x Sensor ohne Azimut | Keine Himmelsrichtung (Auswertung aus) | Aggregation ueber alle Sensoren ohne Azimut |
+| 1x Sensor mit Azimut | Keine Himmelsrichtung (Azimut-Auswertung aus) | Aggregation ueber alle gueltigen Sensoren |
+
diff --git a/src/Baggages/Help_de/SHC-Fenster-Behangausrichtung.md b/src/Baggages/Help_de/SHC-Fenster-Behangausrichtung.md
@@ -0,0 +1,9 @@
+### Fenster-/Behangausrichtung
+
+Legt die Ausrichtung des Fensters bzw. Behangs fuer diesen Kanal fest.
+Diese Angabe wird verwendet, um den passenden Helligkeitssensor fuer die Beschattungsauswertung auszuwählen.
+
+- **Ost/Suedost/Sued/Suedwest/West**: Azimut-Auswertung ist aktiv. Es werden nur Sensoren mit Azimut-Zuordnung verwendet.
+- **Dachflaeche**: Bevorzugt Sensoren ohne Azimut-Zuordnung (z.B. Dachsensor). Falls keine vorhanden sind, wird der Maximalwert aller Sensoren verwendet.
+- **Keine Himmelsrichtung (Azimut-Auswertung aus)**: Es wird die eingestellte Aggregation (Mittelwert/Maximum) ueber alle gueltigen Sensoren verwendet.
+
diff --git a/src/Baggages/Help_de/SHC-FensterOffen-Aussperrverhinderung.md b/src/Baggages/Help_de/SHC-FensterOffen-Aussperrverhinderung.md
@@ -6,3 +6,4 @@ Beispielanwendung:
 Dieser Wert wird verwendet um ein Aussperren auf einer Terrasse durch beginnende Beschattung zu verhindern. 
 Werden hier Beispielsweise 20% eingestellt und die Terrassentüre ist vor dem Beginn der automatischen Beschattung geöffnet, wird die Jalousie zu maximal 20% geschlossen um ein Durchgehen noch zu ermöglichen.
 Erst nach dem Schließen der Terrassentüre wird die normale Beschattungsposition angefahren.
+
diff --git a/src/Baggages/Help_de/SHC-Helligkeit-Aggregation.md b/src/Baggages/Help_de/SHC-Helligkeit-Aggregation.md
@@ -0,0 +1,5 @@
+### Helligkeit Aggregation
+
+Bestimmt, wie mehrere gueltige Helligkeitssensoren zusammengefasst werden, wenn keine Azimut-Auswertung verwendet wird.
+"Mittelwert" mittelt alle gueltigen Sensoren, "Maximum" nimmt den hoechsten Wert.
+
diff --git a/src/Baggages/Help_de/SHC-Helligkeit-Sensor-1.md b/src/Baggages/Help_de/SHC-Helligkeit-Sensor-1.md
@@ -0,0 +1,5 @@
+### Helligkeit Sensor 1
+
+Azimut-Zuordnung fuer Sensor 1 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
diff --git a/src/Baggages/Help_de/SHC-Helligkeit-Sensor-2.md b/src/Baggages/Help_de/SHC-Helligkeit-Sensor-2.md
@@ -0,0 +1,5 @@
+### Helligkeit Sensor 2
+
+Azimut-Zuordnung fuer Sensor 2 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
diff --git a/src/Baggages/Help_de/SHC-Helligkeit-Sensor-3.md b/src/Baggages/Help_de/SHC-Helligkeit-Sensor-3.md
@@ -0,0 +1,5 @@
+### Helligkeit Sensor 3
+
+Azimut-Zuordnung fuer Sensor 3 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
diff --git a/src/Baggages/Help_de/SHC-Helligkeit-Sensor-4.md b/src/Baggages/Help_de/SHC-Helligkeit-Sensor-4.md
@@ -0,0 +1,5 @@
+### Helligkeit Sensor 4
+
+Azimut-Zuordnung fuer Sensor 4 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
diff --git a/src/Baggages/Help_de/SHC-Helligkeit-Sensor-5.md b/src/Baggages/Help_de/SHC-Helligkeit-Sensor-5.md
@@ -0,0 +1,5 @@
+### Helligkeit Sensor 5
+
+Azimut-Zuordnung fuer Sensor 5 in 5-Grad-Schritten.
+"Keine Zuordnung" deaktiviert die Azimut-Auswertung fuer diesen Sensor.
+
diff --git a/src/Baggages/Help_de/SHC-Weitere-Helligkeitssensoren.md b/src/Baggages/Help_de/SHC-Weitere-Helligkeitssensoren.md
@@ -0,0 +1,5 @@
+### Weitere Helligkeitssensoren
+
+Legt fest, wie viele zusaetzliche Helligkeitssensoren (2 bis 5) verwendet werden.
+Die Anzahl bestimmt, welche weiteren Kommunikationsobjekte sichtbar und zu verknuepfen sind.
+
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6,3 +6,4 @@ Beispielanwendung:
		Dieser Wert wird verwendet um ein Aussperren auf einer Terrasse durch beginnende Beschattung zu verhindern.
		Werden hier Beispielsweise 20% eingestellt und die Terrassentüre ist vor dem Beginn der automatischen Beschattung geöffnet, wird die Jalousie zu maximal 20% geschlossen um ein Durchgehen noch zu ermöglichen.
		Erst nach dem Schließen der Terrassentüre wird die normale Beschattungsposition angefahren.