Skip to content

Latest commit

 

History

History
191 lines (128 loc) · 7.13 KB

README.md

File metadata and controls

191 lines (128 loc) · 7.13 KB
Raw

Rollladensteuerung (Shutter Actuator)

Version Product Version License Actions

Das Modul dient zur Ansteuerung der korrekten Öffnungsposition in Abhängigkeit der Motor-laufzeit. Dabei wird die nicht lineare Laufzeit des Motors zur Position der Lamellen übersetzt.

Inhaltverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Installation
  4. Einrichten der Instanzen in IP-Symcon
  5. Statusvariablen und Profile
  6. WebFront
  7. PHP-Befehlsreferenz
  8. Versionshistorie

1. Funktionsumfang

  • Übersetzung der Laufzeit des Rollladenmotors zur Position der Lamellen.

2. Voraussetzungen

  • IP-Symcon ab Version 6.4

3. Software-Installation

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

4. Einrichten der Instanzen in IP-Symcon

  • Unter "Instanz hinzufügen" ist das 'Rollladensteuerung'-Modul unter dem Hersteller '(Geräte)' aufgeführt.

Konfigurationsseite:

Einstellungsbereich:

Erläuterng ...

Kurze Erläterung der Funktionsweise der Ansteuerung.

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

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 IP-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