Suche

    Rollladensteuerung

    Dokumentation direkt aus GitHub Wilkware/ShutterActuator ↗

    Version Product Version License Actions

    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/ShutterActuator oder git://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 …

    NameBeschreibung
    EmpfängerPositions-Variable (Level) des Rollladenaktors, z. B. bei HomeMatic IP Kanal 3:LEVEL
    SenderSchalt-Variable (Level, mit Aktion) des Rollladenaktors, z. B. bei HomeMatic IP Kanal 4:LEVEL
    StoppOptionale Variable mit Aktion zum Anhalten des Rollladens (wird mit TRUE geschaltet). Ohne Auswahl werden HomeMatic-Geräte direkt über den STOP-Datenpunkt angehalten.

    🎚️ Ansteuerung …

    NameStandardBeschreibung
    DarstellungStufenStufen (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.00Levelwert bei geöffneten Rollläden
    Viertel (25%)0.85Levelwert bei viertel geschlossenen Rollläden
    Mitte (50%)0.70Levelwert bei halb geschlossenen Rollläden
    Dreiviertel (75%)0.50Levelwert bei dreiviertel geschlossenen Rollläden
    Blickdicht (99%)0.25Levelwert bei fast geschlossenen Rollläden
    Geschlossen/Unten (100%)0.00Levelwert 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 …

    NameBeschreibung
    Blockier-KontaktVariable, die beim Ein- bzw. Ausfahren vorher geprüft wird (Test auf TRUE).
    Berücksichtigen beim AusfahrenPrüfung bzw. Berücksichtigung des Variablenwertes beim Ausfahren (Schließen)
    Berücksichtigen beim EinfahrenPrüfung bzw. Berücksichtigung des Variablenwertes beim Einfahren (Öffnen)

    Aktionsbereich:

    🧪 Test …

    AktionBeschreibung
    HOCHStartet das Hochfahren des Rollladens (Blockier-Kontakt wird berücksichtigt)
    STOPStoppt den Rollladen an aktueller Position
    RUNTERStartet das Runterfahren des Rollladens (Blockier-Kontakt wird berücksichtigt)
    ANZEIGENZeigt 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.

    IdentNameTypBeschreibung
    PositionPositionIntegerÖffnungsgrad des Rollladens (0 = geöffnet, 100 = geschlossen)

    6. Darstellungen

    Die Darstellungen werden direkt an den Statusvariablen hinterlegt, es werden keine Profile angelegt.

    VariableDarstellungWerte
    PositionAufzählungAuf (0), 25 %, 50 %, 75 %, 99 %, Zu (100) – bei Darstellung „Stufen“
    PositionRollladen0 (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 ;-)

    GitHub

    Spenden

    Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

    PayPal

    Lizenz

    Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

    Licence