Rollladensteuerung
Das Modul dient zur Ansteuerung der korrekten Öffnungsposition in Abhängigkeit der Motorlaufzeit. Dabei wird die nicht lineare Laufzeit des Motors in den tatsächlichen Öffnungsgrad des Rollladens übersetzt.
1. Funktionsumfang
- Übersetzung der Laufzeit (Level) des Rollladenmotors in den tatsächlichen Öffnungsgrad des Rollladens.
- Darstellung wahlweise in festen Stufen (Aufzählung) oder stufenlos als Rollladen-Schieberegler mit linearer Interpolation.
- Optionaler Blockier-Kontakt, z. B. gegen Aussperren bei geöffneter Tür.
- Herstellerunabhängiges Stoppen über eine optionale Stopp-Variable (HomeMatic auch ohne).
- Unterstützung invertierter Aktoren und anderer Skalen (z. B. 0-100) über die Kalibrierwerte.
2. Voraussetzungen
- Symcon ab Version 8.1
3. Installation
- Über den Modul Store das Modul Rollladenaktor installieren.
- Alternativ über das Modul Control folgende URL hinzufügen.
https://github.com/Wilkware/ShutterActuatorodergit://github.com/Wilkware/ShutterActuator.git
4. Einrichtung
- Unter ‘Instanz hinzufügen’ ist das Rollladenaktor-Modul unter dem Hersteller ‘(Geräte)’ aufgeführt.
Konfigurationsseite:
Einstellungsbereich:
ℹ️ Erläuterung …
Kurze Erläuterung der Funktionsweise der Ansteuerung.
🪟 Geräte …
| Name | Beschreibung |
|---|---|
| Empfänger | Positions-Variable (Level) des Rollladenaktors, z. B. bei HomeMatic IP Kanal 3:LEVEL |
| Sender | Schalt-Variable (Level, mit Aktion) des Rollladenaktors, z. B. bei HomeMatic IP Kanal 4:LEVEL |
| Stopp | Optionale Variable mit Aktion zum Anhalten des Rollladens (wird mit TRUE geschaltet). Ohne Auswahl werden HomeMatic-Geräte direkt über den STOP-Datenpunkt angehalten. |
🎚️ Ansteuerung …
| Name | Standard | Beschreibung |
|---|---|---|
| Darstellung | Stufen | Stufen (Aufzählung mit festen Positionen – der gemeldete Level wird der nächstgelegenen Stufe zugeordnet) oder Schieberegler (Rollladen-Darstellung, stufenlos – die Levelwerte werden zwischen den Stützpunkten linear interpoliert) |
| Geöffnet/Oben (0%) | 1.00 | Levelwert bei geöffneten Rollläden |
| Viertel (25%) | 0.85 | Levelwert bei viertel geschlossenen Rollläden |
| Mitte (50%) | 0.70 | Levelwert bei halb geschlossenen Rollläden |
| Dreiviertel (75%) | 0.50 | Levelwert bei dreiviertel geschlossenen Rollläden |
| Blickdicht (99%) | 0.25 | Levelwert bei fast geschlossenen Rollläden |
| Geschlossen/Unten (100%) | 0.00 | Levelwert bei geschlossenen Rollläden |
Bei HomeMatic passen die Standardwerte für 0 % und 100 % immer, die Zwischenwerte sind nur grobe Schätzwerte. Die Werte legen auch Richtung und Skala des Aktors fest: z. B. 1.00 (offen) bis 0.00 (geschlossen) bei HomeMatic oder 0 (offen) bis 100 (geschlossen) bei einem invertierten Aktor mit Skala 0-100. Eine eigene Option zum Invertieren ist daher nicht nötig. Die Laufzeit (Level) muss vorher manuell gestoppt und aus der ‘Level’ Gerätevariable ausgelesen werden (siehe nachfolgenden Aktionsbereich)!
⚙️ Erweiterte Einstellungen …
| Name | Beschreibung |
|---|---|
| Blockier-Kontakt | Variable, die beim Ein- bzw. Ausfahren vorher geprüft wird (Test auf TRUE). |
| Berücksichtigen beim Ausfahren | Prüfung bzw. Berücksichtigung des Variablenwertes beim Ausfahren (Schließen) |
| Berücksichtigen beim Einfahren | Prüfung bzw. Berücksichtigung des Variablenwertes beim Einfahren (Öffnen) |
Aktionsbereich:
🧪 Test …
| Aktion | Beschreibung |
|---|---|
| HOCH | Startet das Hochfahren des Rollladens (Blockier-Kontakt wird berücksichtigt) |
| STOP | Stoppt den Rollladen an aktueller Position |
| RUNTER | Startet das Runterfahren des Rollladens (Blockier-Kontakt wird berücksichtigt) |
| ANZEIGEN | Zeigt die interne Position (Level, z. B. 0.0 - 1.0 bei HomeMatic) des Gerätes an – dieser Wert wird bei der jeweiligen Position unter „🎚️ Ansteuerung …“ eingetragen |
Ist eine Aktion nicht möglich (z. B. aktiver Blockier-Kontakt oder fehlende Variable), wird im Konfigurationsformular ein entsprechender Hinweis angezeigt.
5. Statusvariablen
Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.
| Ident | Name | Typ | Beschreibung |
|---|---|---|---|
| Position | Position | Integer | Öffnungsgrad des Rollladens (0 = geöffnet, 100 = geschlossen) |
6. Darstellungen
Die Darstellungen werden direkt an den Statusvariablen hinterlegt, es werden keine Profile angelegt.
| Variable | Darstellung | Werte |
|---|---|---|
| Position | Aufzählung | Auf (0), 25 %, 50 %, 75 %, 99 %, Zu (100) – bei Darstellung „Stufen“ |
| Position | Rollladen | 0 (geöffnet) bis 100 (geschlossen), stufenlos – bei Darstellung „Schieberegler“ |
7. Visualisierung
Die Statusvariable Position kann direkt in die Visualisierung verlinkt werden.
In der Kachel-Visualisierung erscheint sie je nach gewählter Darstellung als Auswahl der festen Stufen oder als Rollladen-Kachel mit stufenlosem Schieberegler.
Das Modul selbst bringt keine eigene Kachel mit.
8. Befehlsreferenz
bool TSA_Up(int $InstanzID);
Fährt den Rollladen ganz hoch. Ein aktiver Blockier-Kontakt wird berücksichtigt.
Die Funktion liefert true, wenn der Befehl an den Aktor gesendet wurde, sonst false (z. B. bei aktivem Blockier-Kontakt oder fehlender Variable).
bool TSA_Down(int $InstanzID);
Fährt den Rollladen ganz nach unten. Ein aktiver Blockier-Kontakt wird berücksichtigt.
Die Funktion liefert true, wenn der Befehl an den Aktor gesendet wurde, sonst false (z. B. bei aktivem Blockier-Kontakt oder fehlender Variable).
bool TSA_Stop(int $InstanzID);
Hält den Rollladen sofort an (über die Stopp-Variable bzw. bei HomeMatic über den STOP-Datenpunkt).
Die Funktion liefert true, wenn der Stopp-Befehl gesendet wurde, sonst false.
float TSA_Level(int $InstanzID);
Liefert die aktuelle Position (Level) des Rollladens.
Die Funktion liefert den Level in der Skala des Aktors (z. B. 0.0 - 1.0 bei HomeMatic) als Rückgabewert zurück. Im Fehlerfall wird -1 zurückgegeben.
bool TSA_Position(int $InstanzID, int $Position);
Fährt den Rollladen an die übergebene Position (0-100). Ein aktiver Blockier-Kontakt wird berücksichtigt.
Die Funktion liefert true, wenn der Befehl an den Aktor gesendet wurde, sonst false (z. B. bei aktivem Blockier-Kontakt oder fehlender Variable).
9. Versionshistorie
v5.0.20261027
- NEU: Kompatibilität auf Symcon 8.1 hoch gesetzt
- NEU: Darstellung wahlweise als Stufen (Aufzählung) oder stufenloser Rollladen-Schieberegler mit linearer Interpolation
- NEU: Optionale Stopp-Variable für herstellerunabhängiges Stoppen (HomeMatic weiterhin auch ohne Auswahl)
- NEU: Blockier-Kontakt wird auch beim Hoch- und Runterfahren berücksichtigt
- NEU: Unterstützung invertierter Aktoren und anderer Skalen (z. B. 0-100) über die Kalibrierwerte, auch Integer-Variablen als Empfänger/Sender
- NEU: Hinweise im Konfigurationsformular, wenn eine Testfunktion nicht ausgeführt werden kann
- NEU: TSA_Up, TSA_Down, TSA_Stop und TSA_Position liefern jetzt true/false zurück (z. B. false bei aktivem Blockier-Kontakt)
- NEU: Position wird beim Start und nach Änderungen sofort mit dem Aktor abgeglichen
- NEU: Instanzstatus zeigt fehlende Konfiguration an
- FIX: Stufen werden dem nächstgelegenen Level zugeordnet, ein geschlossener Rollladen wird nicht mehr als offen angezeigt
- FIX: Anzeige des Levels auf Systemen mit Dezimalkomma korrigiert
- FIX: Fehlende oder ungültige Variablen bzw. Variablen ohne Aktion führen nicht mehr zu Fehlermeldungen
- FIX: Ungültige Positionswerte (außerhalb 0-100) schließen den Rollladen nicht mehr
- FIX: Positionswerte mit Nachkommastellen (z. B. aus der Sprachsteuerung) werden korrekt verarbeitet
- FIX: Konfigurationsformular auf Standard-Struktur umgestellt
- FIX: Interne Bibliotheken überarbeitet und vereinheitlicht
- FIX: Übersetzungen und Dokumentation überarbeitet und vereinheitlicht
v4.1.20250529
- NEU: Das Modul wurde in Rollladenaktor umbenannt. Die Steuerung gab es bereits von Symcon.
- NEU: Blockiermodus (Kontakt) eingebaut.
- FIX: Test auf Variablenauswahl vereinheitlicht (nicht mehr nur auf 0).
- FIX: Interne Bibliotheken überarbeitet und vereinheitlicht
- FIX: Dokumentation vereinheitlicht
v4.0.20240907
- NEU: Kompatibilität auf IPS 6.4 hoch gesetzt
- NEU: Referenzieren der Gerätevariablen hinzugefügt
- NEU: Farbedefinition aus Profil gelöscht wegen besserer Darstellung in der TileVisu
- FIX: Bibliotheks- bzw. Modulinfos vereinheitlicht
- FIX: Namensnennung und Repo vereinheitlicht
- FIX: Update Style-Checks
- FIX: Übersetzungen überarbeitet und verbessert
- FIX: Dokumentation vereinheitlicht
v3.0.20221117
- NEU: Konfigurationsformular überarbeitet und vereinheitlicht
- NEU: Kompatibilität auf 6.0 hoch gesetzt
- FIX: Interne Bibliotheken überarbeitet und vereinheitlicht
- FIX: Bibliotheksdefinition überarbeitet und vereinheitlicht
- FIX: Dokumentation überarbeitet
v2.0.20210712
- NEU: Konfigurationsformular überarbeitet und vereinheitlicht
- FIX: Übersetzungen nachgezogen
- FIX: Interne Bibliotheken überarbeitet und vereinheitlicht
- FIX: Debug Meldungen überarbeitet
- FIX: Dokumentation überarbeitet
v1.2.20200813
- NEU: Funktion zum Anfahren einer bestimmeten Position hinzugefügt
- FIX: Dokumentation überarbeitet
v1.1.20190818
- NEU: Umstellung für Module Store
- FIX: Dokumentation überarbeitet
v1.0.20190415
- NEU: Initialversion
Entwickler
Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)
Spenden
Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.
Lizenz
Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International