Toolmatic Shutter Actuator (Rollladensteuerung)

Die Toolmatic Bibliothek ist eine kleine Tool-Sammlung im Zusammenhang mit HomeMatic/IP Geräten.
Hauptsächlich beinhaltet sie kleine Erweiterung zur Automatisierung von Aktoren oder erleichtert das Steuern von Geräten bzw. bietet mehr Komfort bei der Bedienung.

Die Rollladensteuerung dient zur Ansteuerung der korrekten Öffnungsposition in Abhängigkeit der Motor-Laufzeit.

1. Funktionsumfang

Übersetzung der Laufzeit des Rollladenmotors zur Position der Lamellen.

2. Voraussetzungen

IP-Symcon ab Version 5.2

3. Software-Installation

Über den Modul Store das Modul Toolmatic Shutter Actuator installieren.
Alternativ Über das Modul-Control folgende URL hinzufügen.
https://github.com/Wilkware/IPSymconShutterActuator oder git://github.com/Wilkware/IPSymconShutterActuator.git

4. Einrichten der Instanzen in IP-Symcon

Unter "Instanz hinzufügen" ist das ‚Rollladensteuerung‘-Modul (Alias: ‚Jalousiesteuerung‘) unter dem Hersteller ‚(Geräte)‘ aufgeführt.

Konfigurationsseite:

Einstellungsbereich:

Geräte …

Name	Beschreibung
Empfänger	Positions-Variable des Rollladen-Steuergerätes (Kanal 3:LEVEL)
Sender	Schalt-Variable des Rollladen-Steuergerätes (Kanal 4:LEVEL)

Ansteuerung …

Name	Beschreibung
Geöffnet/Oben (0%)	Levelwert bei geöffneten Rollläden
Viertel (25%)	Levelwert bei virtel geschlossenen Rollläden
Mitte (50%)	Levelwert bei halb geschlossenen Rollläden
Dreiviertel (75%)	Levelwert bei dreiviertel geschlossenen Rollläden
Blickdicht (99%)	Levelwert bei fast geschlossenen Rollläden
Geschlossen/Unten (100%)	Levelwert bei geschlossenen Rollläden

Die Laufzeit (Level) muss vorher manuell gestoppt und aus der ‚Level‘ Gerätevariable ausgelesen werden (siehe nachfolgenden Aktionsbereich)!

Aktionsbereich:

Aktion	Beschreibung
HOCH	Startet das Hochfahren des Rollladens
STOP	Stoppt den Rollladen an aktueller Position
RUNTER	Startet das Runterfahren des Rollladens
ANZEIGEN	Zeigt die interne Position (0.0 – 1.0%) des Geätes an

5. Statusvariablen und Profile

Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

Name	Typ	Beschreibung
Position	Integer	Öffnungsgrad des Rollladens

Folgende Profile werden angelegt:

Name	Typ	Beschreibung
HM.ShutterActuator	Integer	Öffnungsgrad in Prozent(-schritte) (0% = Auf, 25%, 50%, 75%, 99%, 100% = Zu)

6. WebFront

Die erzeugten Variable kann direkt ins Webfront verlinkt werden.

7. PHP-Befehlsreferenz

void TSA_Up(int $InstanzID);

Fährt den Rollladen ganz hoch.
Die Funktion liefert keinerlei Rückgabewert.

void TSA_Down(int $InstanzID);

Fährt den Rollladen ganz nach unten.
Die Funktion liefert keinerlei Rückgabewert.

void TSA_Stop(int $InstanzID);

Hält den Rollladen sofort an.
Die Funktion liefert keinerlei Rückgabewert.

float TSA_Level(int $InstanzID);

Liefert die aktuelle Position (Level) des Rollladens.
Die Funktion liefert die prozentualen Level (00 – 1.0) als Rückgabewert zurück. Im Fehlerfall wird -1 zurückgegeben.

void TSA_Position(int $InstanzID, int $Position);

Fährt den Rollladen an die übergebene Postion (0-100).
Die Funktion liefert keinerlei Rückgabewert.

8. Versionshistorie

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 IP-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 kommzerielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

Rollladensteuerung