From 44c373f8477192067e84bcf0f8fedd4ef5bb45eb Mon Sep 17 00:00:00 2001 From: Christoph Morrison Date: Fri, 24 May 2019 18:50:51 +0200 Subject: [PATCH 1/3] Fixed broken table tags, added tr for the table heading --- 73_AutoShuttersControl.pm | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/73_AutoShuttersControl.pm b/73_AutoShuttersControl.pm index c676273..9038460 100644 --- a/73_AutoShuttersControl.pm +++ b/73_AutoShuttersControl.pm @@ -5311,7 +5311,7 @@ sub getblockAscDrivesAfterManual { { ascAPIget('Getter','ROLLODEVICENAME') }
- + @@ -5333,21 +5333,21 @@ sub getblockAscDrivesAfterManual { -
GetterErläuterung
GetterErläuterung
FreezeStatus1=soft, 2=Daytime, 3=hard
NoOffsetWurde die Behandlung von Offset deaktiviert (Beispiel bei Fahrten über Fensterevents)
LastDriveGrund des letzten Fahrens
DelayCmdletzter Fahrbefehl welcher in die Warteschlange kam. Grund z.B. Partymodus.
StatusPosition des Rolllos
ASCenableAbfrage ob für das Rolllo die ASC Steuerung aktiv ist.
+

Übersicht für das ASC Device - + -
GetterErläuterung
GetterErläuterung
outTemp aktuelle Außentemperatur sofern Sensor definiert
ResidentsStatusaktueller Status des Residents Devices
ResidentsLastStatusletzter Status des Residents Devices
AzimuthAzimut Wert
ElevationElevation Wert
ASCenableist die ASC Steuerung global aktiv?
+
=end html_DE From 8b980438fbe86180def0ff8783b043438670cc77 Mon Sep 17 00:00:00 2001 From: Christoph Morrison Date: Fri, 24 May 2019 18:54:30 +0200 Subject: [PATCH 2/3] Self defense - congruent AE style --- 73_AutoShuttersControl.pm | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/73_AutoShuttersControl.pm b/73_AutoShuttersControl.pm index 9038460..8f4a0c9 100644 --- a/73_AutoShuttersControl.pm +++ b/73_AutoShuttersControl.pm @@ -5287,7 +5287,7 @@ sub getblockAscDrivesAfterManual {
  • ASC_Shading_StateChange_Sunny - Brightness Wert ab welchen Beschattung statt finden soll, immer in Abhängikkeit der anderen einbezogenden Sensorwerte (default: 35000)
  • ASC_Shading_WaitingPeriod - wie viele Sekunden soll gewartet werden bevor eine weitere Auswertung der Sensordaten für die Beschattung statt finden soll (default: 1200)

    • -
  • ASC_ShuttersPlace - window/terrace - Wenn dieses Attribut auf terrace gesetzt ist, das Residence Device in den Status "gone" geht und SelfDefence aktiv ist (ohne das das Reading selfDefense gesetzt sein muss), wird das Rollo geschlossen (default: window)
    • +
  • ASC_ShuttersPlace - window/terrace - Wenn dieses Attribut auf terrace gesetzt ist, das Residence Device in den Status "gone" geht und SelfDefense aktiv ist (ohne das das Reading selfDefense gesetzt sein muss), wird das Rollo geschlossen (default: window)
  • ASC_Time_Down_Early - Sunset frühste Zeit zum Runterfahren (default: 16:00)
  • ASC_Time_Down_Late - Sunset späteste Zeit zum Runterfahren (default: 22:00)
  • ASC_Time_Up_Early - Sunrise frühste Zeit zum Hochfahren (default: 05:00)
    • From 121226f6d25a4bafa63beb5b732b0ef88bfabd95 Mon Sep 17 00:00:00 2001 From: Christoph Morrison Date: Fri, 24 May 2019 19:56:38 +0200 Subject: [PATCH 3/3] fixed several typos, congruent usage of Rollladen instead of Roll(l)o --- 73_AutoShuttersControl.pm | 717 ++++++++++++++++++++++++++------------ 1 file changed, 488 insertions(+), 229 deletions(-) diff --git a/73_AutoShuttersControl.pm b/73_AutoShuttersControl.pm index 8f4a0c9..305f29c 100644 --- a/73_AutoShuttersControl.pm +++ b/73_AutoShuttersControl.pm @@ -5100,254 +5100,513 @@ sub getblockAscDrivesAfterManual {

    AutoShuttersControl

      -

      AutoShuttersControl (ASC) ermöglicht eine vollständige Automatisierung der vorhandenen Rollläden. Das Modul bietet umfangreiche Konfigurationsmöglichkeiten, um Rollläden bspw. nach Sonnenauf- und untergangszeiten, nach Helligkeitswerten oder rein zeitgesteuert zu steuern.

      -

      - Man kann festlegen, welche Rollläden von ASC in die Automatisierung mit aufgenommen werden sollen. Daraufhin stehen diverse Attribute zur Feinkonfiguration zur Verfügung. So sind unter anderem komplexe Lösungen wie Fahrten in Abhängigkeit des Bewohnerstatus einfach umsetzbar. Beispiel: Hochfahren von Rollläden, wenn der Bewohner erwacht ist und draußen bereits die Sonne aufgegangen ist. Weiterhin ist es möglich, dass der geschlossene Rollladen z.B. nach dem Ankippen eines Fensters in eine Lüftungsposition fährt. Und vieles mehr. -

      - - Define -
        - define <name> AutoShuttersControl +

        AutoShuttersControl (ASC) ermöglicht eine vollständige Automatisierung der vorhandenen Rollläden. Das Modul bietet umfangreiche Konfigurationsmöglichkeiten, um Rollläden bspw. nach Sonnenauf- und untergangszeiten, nach Helligkeitswerten oder rein zeitgesteuert zu steuern.

        +

        + Man kann festlegen, welche Rollläden von ASC in die Automatisierung mit aufgenommen werden sollen. Daraufhin stehen diverse Attribute zur Feinkonfiguration zur Verfügung. So sind unter anderem komplexe Lösungen wie Fahrten in Abhängigkeit des Bewohnerstatus einfach umsetzbar. Beispiel: Hochfahren von Rollläden, wenn der Bewohner erwacht ist und draußen bereits die Sonne aufgegangen ist. Weiterhin ist es möglich, dass der geschlossene Rollladen z.B. nach dem Ankippen eines Fensters in eine Lüftungsposition fährt. Und vieles mehr. +

        + + Define +
          + define <name> AutoShuttersControl +

          + Beispiel: +
            +
            + define myASControl AutoShuttersControl
            +
          +
          + Der Befehl erstellt ein AutoShuttersControl Device mit Namen myASControl.
          + Nachdem das Device angelegt wurde, muss in allen Rollläden Devices, welche gesteuert werden sollen, das Attribut ASC mit Wert 1 oder 2 gesetzt werden. + Dabei bedeutet 1 = "Prozent geschlossen" (z.B. ROLLO oder Siro Modul) - Rollo Oben 0, Rollo Unten 100, 2 = "Prozent geöffnet" (z.B. Homematic) - Rollo Oben 100, Rollo Unten 0. + Die Voreinstellung für den Befehl zum prozentualen Fahren ist in beiden Fällen unterschiedlich. 1="position" und 2="pct". Dies kann, soweit erforderlich, zu späterer Zeit noch angepasst werden. + Habt Ihr das Attribut gesetzt, könnt Ihr den automatischen Scan nach den Devices anstoßen. +
        +
        + + Readings +
          + Im ASC-Device +
            +
          • ..._nextAstroTimeEvent - Uhrzeit des nächsten Astro-Events: Sonnenauf- oder Sonnenuntergang oder feste Zeit
            • +
          • ..._PosValue - aktuelle Position des Rollladens
            • +
          • ..._lastPosValue - letzte Position des Rollladens
            • +
          • ..._lastDelayPosValue - letzter abgesetzter Fahrbefehl, welcher beim nächsten zulässigen Event ausgeführt wird.
            • +
          • partyMode - on/off - Partymodus-Status
            • +
          • ascEnable - on/off - globale ASC Steuerung bei den Rollläden aktiv oder inaktiv
            • +
          • controlShading - on/off - globale Beschattungsfunktion aktiv oder inaktiv
            • +
          • hardLockOut - on/off - Aussperrschutz-Status
            • +
          • room_... - Auflistung aller Rollläden, die in den jeweiligen Rämen gefunden wurde. Beispiel: room_Schlafzimmer: Terrasse
            • +
          • selfDefense - Selbstschutz-Status
            • +
          • state - Status des ASC-Devices: active, enabled, disabled oder weitere Statusinformationen
            • +
          • sunriseTimeWeHoliday - on/off - Status der Wochenendunterstützung
            • +
          • userAttrList - Das ASC-Modul verteilt an die gesteuerten Rollladen-Geräte diverse Benutzerattribute (userattr). In diesem Reading kann der Status dieser Verteilung geprüft werden.
            • +

          + In den Rollläden-Geräten +
            +
          • ASC_Enable - on/off - wird der Rollladen über ASC gesteuert oder nicht
            • +
          • ASC_Time_DriveUp - Im Astro-Modus ist hier die Sonnenaufgangszeit für das Rollo gespeichert. Im Brightness- und Zeit-Modus ist hier der Zeitpunkt aus dem Attribut ASC_Time_Up_Late gespeichert.
            • +
          • ASC_Time_DriveDown - Im Astro-Modus ist hier die Sonnenuntergangszeit für das Rollo gespeichert. Im Brightness- und Zeit-Modus ist hier der Zeitpunkt aus dem Attribut ASC_Time_Down_Late gespeichert.
            • +
          • ASC_ShuttersLastDrive - Grund der letzten Fahrt vom Rollladen
            • +
          +


        - Beispiel: + + Set
          -
          - define myASControl AutoShuttersControl
          +
        • ascEnable - on/off - Aktivieren oder deaktivieren der globalen ASC Steuerung
          • +
        • controlShading - on/off - Aktiviert oder deaktiviert die globale Beschattungssteuerung
          • +
        • createNewNotifyDev - Legt die interne Struktur für NOTIFYDEV neu an. Diese Funktion steht nur zur Verfügung, wenn Attribut ASC_expert auf 1 gesetzt ist.
          • +
        • hardLockOut - on/off - Aktiviert den globalen Aussperrschutz für die Rollläden, bei denen das Attributs ASC_LockOut entsprechend gesetzt ist. Mehr Informationen in der Beschreibung bei den Attributen für die Rollladengeräten.
          • +
        • partyMode - on/off - Aktiviert den globalen Partymodus. Alle Rollladen-Geräten, in welchen das Attribut ASC_Partymode auf on gesetzt ist, werden durch ASC nicht mehr gesteuert. Der letzte Schaltbefehl, der bspw. durch ein Fensterevent oder Wechsel des Bewohnerstatus an die Rollläden gesendet wurde, wird beim Deaktivieren des Partymodus ausgeführt
          • +
        • renewSetSunriseSunsetTimer - erneuert bei allen Rollläden die Zeiten für Sonnenauf- und -untergang und setzt die internen Timer neu.
          • +
        • scanForShutters - Durchsucht das System nach GerätenRo mit dem Attribut ASC = 1 oder ASC = 2
          • +
        • selfDefense - on/off - Aktiviert bzw. deaktiviert die Selbstschutzfunktion. Beispiel: Wenn das Residents-Gerät absent meldet, die Selbstschutzfunktion aktiviert wurde und ein Fenster im Haus noch geöffnet ist, so wird an diesem Fenster der Rollladen deaktivieren dann heruntergefahren.
          • +
        • shutterASCenableToggle - on/off - Aktivieren oder deaktivieren der ASC Kontrolle beim einzelnen Rollladens
          • +
        • sunriseTimeWeHoliday - on/off - Aktiviert die Wochenendunterstützung und somit, ob im Rollladengerät das Attribut ASC_Time_Up_WE_Holiday beachtet werden soll oder nicht.
          • +
        • wiggle - bewegt einen oder mehrere Rollläden um einen definierten Wert (Default: 5%) und nach einer Minute wieder zurück in die Ursprungsposition. Diese Funktion könnte bspw. zur Abschreckung in einem Alarmsystem eingesetzt werden.
        -
        - Der Befehl erstellt ein AutoShuttersControl Device mit Namen myASControl.
        - Nachdem das Device angelegt wurde, muss in allen Rollläden Devices, welche gesteuert werden sollen, das Attribut ASC mit Wert 1 oder 2 gesetzt werden. - Dabei bedeutet 1 = "Prozent geschlossen" (z.B. ROLLO oder Siro Modul) - Rollo Oben 0, Rollo Unten 100, 2 = "Prozent geöffnet" (z.B. Homematic) - Rollo Oben 100, Rollo Unten 0. - Die Voreinstellung für den Befehl zum prozentualen Fahren ist in beiden Fällen unterschiedlich. 1="position" und 2="pct". Dies kann, soweit erforderlich, zu späterer Zeit noch angepaßt werden. - Habt Ihr das Attribut gesetzt, könnt Ihr den automatischen Scan nach den Devices anstossen. -
      -
      - Readings -
        - Im ASC-Device +

        + + Get
          -
        • ..._nextAstroTimeEvent - Uhrzeit des nächsten Astro-Events: Sonnenauf- oder Sonnenuntergang oder feste Zeit
          • -
        • ..._PosValue - aktuelle Position des Rollladen
          • -
        • ..._lastPosValue - letzte Position des Rollladen
          • -
        • ..._lastDelayPosValue - letzter abgesetzter Fahrbefehl, welcher beim nächsten zulässigen Event ausgeführt wird.
          • -
        • partyMode - on/off - Partymodus-Status
          • -
        • ascEnable - on/off - globale ASC Steuerung bei den Rolllos aktiv oder inaktiv
          • -
        • controlShading - on/off - globale Beschattungsfunktion aktiv oder inaktiv
          • -
        • hardLockOut - on/off - Aussperrschutz-Status
          • -
        • room_... - Auflistung aller Rollläden, die in den jeweiligen Rämen gefunden wurde. Beispiel: room_Schlafzimmer: Terrasse
          • -
        • selfDefense - Selbstschutz-Status
          • -
        • state - Status des ASC-Devices: active, enabled, disabled oder weitere Statusinformationen
          • -
        • sunriseTimeWeHoliday - on/off - Status der Wochenendunterstützung
          • -
        • userAttrList - Das ASC-Modul verteilt diverse Benutzerattribute (userattr) Rollläden-Geräten. In diesem Reading kann der Status dieser Verteilung geprüft werden.
          • -

        - In den Rollläden-Geräten -
          -
        • ASC_Enable - on/off - wird das Rolllo über ASC gesteuert oder nicht
          • -
        • ASC_Time_DriveUp - Im Astro-Modus ist hier die Sonnenaufgangszeit für das Rollo gespeichert. Im Brightness- und Zeit-Modus ist hier der Zeitpunkt aus dem Attribut ASC_Time_Up_Late gespeichert.
          • -
        • ASC_Time_DriveDown - Im Astro-Modus ist hier die Sonnenuntergangszeit für das Rollo gespeichert. Im Brightness- und Zeit-Modus ist hier der Zeitpunkt aus dem Attribut ASC_Time_Down_Late gespeichert.
          • -
        • ASC_ShuttersLastDrive - Grund der letzten Fahrt vom Rollladen
          • +
        • showShuttersInformations - zeigt eine Übersicht aller Rollläden mit den Fahrzeiten, Modus und diverse weitere Statusanzeigen.
          • +
        • showNotifyDevsInformations - zeigt eine Übersicht der abgelegten NOTIFYDEV Struktur. Diese Funktion wird primär fürs Debugging genutzt. Hierzu ist das Attribut ASC_expert = 1 zu setzen.
        -
      -

      - - Set -
        -
      • ascEnable - on/off - aktivieren oder deaktiveren der globalen ASC Steuerung
        • -
      • controlShading - on/off - aktiviert oder deaktiviert die globale Beschattungssteuerung
        • -
      • createNewNotifyDev - Legt die interne Struktur für NOTIFYDEV neu an. Diese Funktion steht nur zur Verfügung, wenn Attribut ASC_expert auf 1 gesetzt ist.
        • -
      • hardLockOut - on/off - aktiviert den globalen Aussperrschutz für die Rollläden, bei denen das Attributs ASC_LockOut entsprechend gesetzt ist. Mehr Informationen in der Beschreibung bei den Attributen für die Rollladengeräten.
        • -
      • partyMode - on/off - aktiviert den globalen Partymodus. Alle Rollladen-Geräten, in welchen das Attribut ASC_Partymode auf on gesetzt ist, werden durch ASC nicht mehr gesteuert. Der letzte Schaltbefehl, der bspw. durch ein Fensterevent oder Wechsel des Bewohnerstatus an die Rollläden gesendet wurde, wird beim Deaktivieren des Partmodus ausgeführt
        • -
      • renewSetSunriseSunsetTimer - erneuert bei allen Rollläden die Zeiten für Sunset und Sunrise und setzt die internen Timer neu.
        • -
      • scanForShutters - Durchsucht das System nach Geräten mit dem Attribut ASC = 1 oder ASC = 2
        • -
      • selfDefense - on/off - aktiviert bzw. deaktiviert die Selbstschutzfunktion. Beispiel: Wenn das Residents-Gerät absent meldet, die Selbstschutzfunktion aktiviert wurde und ein Fenster im Haus noch geöffnet ist, so wird an diesem Fenster das Rollo dann heruntergefahren.
        • -
      • shutterASCenableToggle - on/off - aktivieren oder deaktiveren der ASC Kontrolle beim einzelnen Rolllo
        • -
      • sunriseTimeWeHoliday - on/off - aktiviert die Wochenendunterstützung und somit, ob im Rollladengerät das Attribut ASC_Time_Up_WE_Holiday beachtet werden soll oder nicht.
        • -
      • wiggle - bewegt einen oder mehrere Rollläden um einen definierten Wert (Default: 5%) und nach einer Minute wieder zurück in die Ursprungsposition. Diese Funktion könnte bpsw. zur Abschreckung in einem Alarmsystem eingesetzt werden.
        • -
      -

      - - Get -
        -
      • showShuttersInformations - zeigt eine Übersicht aller Rollläden mit den Fahrzeiten, Modus und diverse weitere Statusanzeigen.
        • -
      • showNotifyDevsInformations - zeigt eine Übersicht der abgelegten NOTIFYDEV Struktur. Diese Funktion wird primär fürs Debugging genutzt. Hierzu ist das Attribut ASC_expert = 1 zu setzen.
        • -
      -

      - - Attributes -
        - Im ASC-Device +

        + + Attributes
          - -
        • ASC_autoAstroModeEvening - REAL, CIVIL, NAUTIC, ASTRONOMIC oder HORIZON
          • - -
        • ASC_autoAstroModeEveningHorizon - Höhe über dem Horizont. Wird nur berücksichtigt, wenn im Attribut ASC_autoAstroModeEvening der Wert HORIZON ausgewählt wurde. (default: 0)
          • - -
        • ASC_autoAstroModeMorning - REAL, CIVIL, NAUTIC, ASTRONOMIC oder HORIZON
          • - -
        • ASC_autoAstroModeMorningHorizon - Höhe über dem Horizont. Wird nur berücksichtigt, wenn im Attribut ASC_autoAstroModeEvening der Wert HORIZON ausgewählt wurde. (default: 0)
          • - -
        • ASC_autoShuttersControlComfort - on/off - schaltet die Komfortfunktion an. Bedeutet, dass ein Rollladen mit einem threestate-Sensor am Fenster beim öffnen in eine Offenposition fährt. Hierzu muss beim Rollladen das Attribut ASC_ComfortOpen_Pos entsprechend konfiguriert sein. (default: off)
          • - -
        • ASC_autoShuttersControlEvening - on/off - aktiviert die automatische Steuerung durch das ASC-Modul am Abend.
          • - -
        • ASC_autoShuttersControlMorning - on/off - aktiviert die automatische Steuerung durch das ASC-Modul am Morgen.
          • - -
        • ASC_blockAscDrivesAfterManual - 0,1 - wenn dieser Wert auf 1 gesetzt ist, dann werden Rollläden vom ASC-Modul nicht mehr gesteuert, wenn zuvor manuell eingegriffen wurde. Voraussetzung hierfür ist jedoch, dass im Reading ASC_ShuttersLastDrive der Status manual enthalten ist und sich der Rollladen auf eine unbekannte (nicht in den Attributen anderweitig konfigurierte) Position befindet.
          • - -
        • ASC_brightnessDriveUpDown - WERT-MORGENS:WERT-ABENDS - Werte bei dem Schaltbedingungen für Sunrise und Sunset geprüft werden sollen. Diese globale Einstellung kann durch die WERT-MORGENS:WERT-ABENDS Einstellung von ASC_BrightnessSensor im Rollladen selbst überschrieben werden.
          • - -
        • ASC_debug - aktiviert die erweiterte Logausgabe für Debugausgaben
          • - -
        • ASC_expert - ist der Wert 1, so werden erweiterte Informationen bezüglich des NotifyDevs unter set und get angezeigt
          • - -
        • ASC_freezeTemp - Temperatur, ab welcher der Frostschutz greifen soll und der Rolladen nicht mehr fährt. Der letzte Fahrbefehl wird gespeichert.
          • - -
        • ASC_rainSensor - DEVICENAME[:READINGNAME] MAXTRIGGER[:HYSTERESE] [CLOSEDPOS] - der Inhalt ist eine Kombination aus Devicename, Readingname, Wert ab dem getriggert werden soll, Hysterese Wert ab dem der Status Regenschutz aufgehoben weden soll und der "wegen Regen geschlossen Position".
          • - -
        • ASC_residentsDev - DEVICENAME[:READINGNAME] - der Inhalt ist eine Kombination aus Devicenamen und Readingnamen des Residents-Device der obersten Ebene (z.B. rgr_Residents:presence)
          • - -
        • ASC_shuttersDriveOffset - maximale Zufallsverzögerung in Sekunden bei der Berechnung der Fahrzeiten. 0 bedeutet keine Verzögerung
          • - -
        • ASC_tempSensor - DEVICENAME[:READINGNAME] - der Inhalt ist eine Kombination aus Device und Reading für die Aussentemperatur
          • - -
        • ASC_twilightDevice - das Device, welches die Informationen zum Sonnenstand liefert. Wird unter anderem für die Beschattung verwendet.
          • - -
        • ASC_windSensor - DEVICE[:READING] - Sensor für die Windgeschwindigkeit. Kombination aus Device und Reading.
          • + Im ASC-Device +
            + +
          • ASC_autoAstroModeEvening - REAL, CIVIL, NAUTIC, ASTRONOMIC oder HORIZON
            • + +
          • ASC_autoAstroModeEveningHorizon - Höhe über dem Horizont. Wird nur berücksichtigt, wenn im Attribut ASC_autoAstroModeEvening der Wert HORIZON ausgewählt wurde. (default: 0)
            • + +
          • ASC_autoAstroModeMorning - REAL, CIVIL, NAUTIC, ASTRONOMIC oder HORIZON
            • + +
          • ASC_autoAstroModeMorningHorizon - Höhe über dem Horizont. Wird nur berücksichtigt, wenn im Attribut ASC_autoAstroModeEvening der Wert HORIZON ausgewählt wurde. (default: 0)
            • + +
          • ASC_autoShuttersControlComfort - on/off - schaltet die Komfortfunktion an. Bedeutet, dass ein Rollladen mit einem threestate-Sensor am Fenster beim Öffnen in eine Offenposition fährt. Hierzu muss beim Rollladen das Attribut ASC_ComfortOpen_Pos entsprechend konfiguriert sein. (default: off)
            • + +
          • ASC_autoShuttersControlEvening - on/off - Aktiviert die automatische Steuerung durch das ASC-Modul am Abend.
            • + +
          • ASC_autoShuttersControlMorning - on/off - Aktiviert die automatische Steuerung durch das ASC-Modul am Morgen.
            • + +
          • ASC_blockAscDrivesAfterManual - 0,1 - wenn dieser Wert auf 1 gesetzt ist, dann werden Rollläden vom ASC-Modul nicht mehr gesteuert, wenn zuvor manuell eingegriffen wurde. Voraussetzung hierfür ist jedoch, dass im Reading ASC_ShuttersLastDrive der Status manual enthalten ist und sich der Rollladen auf eine unbekannte (nicht in den Attributen anderweitig konfigurierte) Position befindet.
            • + +
          • ASC_brightnessDriveUpDown - WERT-MORGENS:WERT-ABENDS - Werte bei dem Schaltbedingungen für Sonnenauf- und -untergang geprüft werden sollen. Diese globale Einstellung kann durch die WERT-MORGENS:WERT-ABENDS Einstellung von ASC_BrightnessSensor im Rollladen selbst überschrieben werden.
            • + +
          • ASC_debug - Aktiviert die erweiterte Logausgabe für Debugausgaben
            • + +
          • ASC_expert - ist der Wert 1, so werden erweiterte Informationen bezüglich des NotifyDevs unter set und get angezeigt
            • + +
          • ASC_freezeTemp - Temperatur, ab welcher der Frostschutz greifen soll und der Rollladen nicht mehr fährt. Der letzte Fahrbefehl wird gespeichert.
            • + +
          • ASC_rainSensor - DEVICENAME[:READINGNAME] MAXTRIGGER[:HYSTERESE] [CLOSEDPOS] - der Inhalt ist eine Kombination aus Devicename, Readingname, Wert ab dem getriggert werden soll, Hysterese Wert ab dem der Status Regenschutz aufgehoben werden soll und der "wegen Regen geschlossen Position".
            • + +
          • ASC_residentsDev - DEVICENAME[:READINGNAME] - der Inhalt ist eine Kombination aus Devicenamen und Readingnamen des Residents-Device der obersten Ebene (z.B. rgr_Residents:presence)
            • + +
          • ASC_shuttersDriveOffset - maximale Zufallsverzögerung in Sekunden bei der Berechnung der Fahrzeiten. 0 bedeutet keine Verzögerung
            • + +
          • ASC_tempSensor - DEVICENAME[:READINGNAME] - der Inhalt ist eine Kombination aus Device und Reading für die Außentemperatur
            • + +
          • ASC_twilightDevice - das Device, welches die Informationen zum Sonnenstand liefert. Wird unter anderem für die Beschattung verwendet.
            • + +
          • ASC_windSensor - DEVICE[:READING] - Sensor für die Windgeschwindigkeit. Kombination aus Device und Reading.
            • +
          +
          +
            + Folgende Attribute sind obsolet und sollten nicht mehr verwendet werden. + +
          • ASC_temperatureSensor - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
            • + +
          • ASC_temperatureReading - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
            • + +
          • ASC_residentsDevice - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
            • + +
          • ASC_residentsDeviceReading - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
            • + +
          • ASC_rainSensorDevice - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
            • + +
          • ASC_rainSensorReading - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
            • + +
          • ASC_rainSensorShuttersClosedPos - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
            • + +
          • ASC_brightnessMinVal - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
            • + +
          • ASC_brightnessMaxVal - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
            • +
          +
          + In den Rollläden-Geräten +
            +
          • ASC - 0/1/2 0 = "kein Anlegen der Attribute beim ersten Scan bzw. keine Beachtung eines Fahrbefehles",1 = "Inverse oder Rollo - Bsp.: Rollo oben 0, Rollo unten 100 und der Befehl zum prozentualen Fahren ist position",2 = "Homematic Style - Bsp.: Rollo oben 100, Rollo unten 0 und der Befehl zum prozentualen Fahren ist pct
            • +
          • ASC_Antifreeze - soft/am/pm/hard/off - Frostschutz, wenn soft fährt der Rollladen in die ASC_Antifreeze_Pos und wenn hard/am/pm wird gar nicht oder innerhalb der entsprechenden Tageszeit nicht gefahren (default: off)
            • +
          • ASC_Antifreeze_Pos - Position die angefahren werden soll, wenn der Fahrbefehl komplett schließen lautet, aber der Frostschutz aktiv ist (default: 50)
            • +
          • ASC_AutoAstroModeEvening - aktuell REAL,CIVIL,NAUTIC,ASTRONOMIC (default: none)
            • +
          • ASC_AutoAstroModeEveningHorizon - Höhe über Horizont, wenn beim Attribut ASC_autoAstroModeEvening HORIZON ausgewählt (default: none)
            • +
          • ASC_AutoAstroModeMorning - aktuell REAL,CIVIL,NAUTIC,ASTRONOMIC (default: none)
            • +
          • ASC_AutoAstroModeMorningHorizon - Höhe über Horizont,a wenn beim Attribut ASC_autoAstroModeMorning HORIZON ausgewählt (default: none)
            • +
          • ASC_BlockingTime_afterManual - wie viel Sekunden soll die Automatik nach einer manuellen Fahrt aussetzen. (default: 1200)
            • +
          • ASC_BlockingTime_beforDayOpen - wie viel Sekunden vor dem morgendlichen öffnen soll keine schließen Fahrt mehr stattfinden. (default: 3600)
            • +
          • ASC_BlockingTime_beforNightClose - wie viel Sekunden vor dem nächtlichen schließen soll keine öffnen Fahrt mehr stattfinden. (default: 3600)
            • +
          • ASC_BrightnessSensor - DEVICE[:READING] WERT-MORGENS:WERT-ABENDS / 'Sensorname[:brightness [400:800]]' Angaben zum Helligkeitssensor mit (Readingname, optional) für die Beschattung und dem Fahren der Rollladen nach brightness und den optionalen Brightnesswerten für Sonnenauf- und Sonnenuntergang. (default: none)
            • +
          • ASC_Closed_Pos - in 10 Schritten von 0 bis 100 (Default: ist abhängig vom Attribut ASC)
            • +
          • ASC_ComfortOpen_Pos - in 10 Schritten von 0 bis 100 (Default: ist abhängig vom Attribut ASC)
            • +
          • ASC_Down - astro/time/brightness - bei astro wird Sonnenuntergang berechnet, bei time wird der Wert aus ASC_Time_Down_Early als Fahrzeit verwendet und bei brightness muss ASC_Time_Down_Early und ASC_Time_Down_Late korrekt gesetzt werden. Der Timer läuft dann nach ASC_Time_Down_Late Zeit, es wird aber in der Zeit zwischen ASC_Time_Down_Early und ASC_Time_Down_Late geschaut, ob die als Attribut im Moduldevice hinterlegte ASC_brightnessMinVal erreicht wurde. Wenn ja, wird der Rollladen runter gefahren (default: astro)
            • +
          • ASC_DriveUpMaxDuration - die Dauer des Hochfahrens des Rollladens plus 5 Sekunden (default: 60)
            • +
          • ASC_Drive_Offset - maximaler Wert für einen zufällig ermittelte Verzögerungswert in Sekunden bei der Berechnung der Fahrzeiten, 0 bedeutet keine Verzögerung, -1 bedeutet, dass das gleichwertige Attribut aus dem ASC Device ausgewertet werden soll. (default: -1)
            • +
          • ASC_Drive_OffsetStart - in Sekunden verzögerter Wert ab welchen dann erst das Offset startet und dazu addiert wird. Funktioniert nur wenn gleichzeitig ASC_Drive_Offset gesetzt wird. (default: -1)
            • +
          • ASC_LockOut - soft/hard/off - stellt entsprechend den Aussperrschutz ein. Bei global aktivem Aussperrschutz (set ASC-Device lockOut soft) und einem Fensterkontakt open bleibt dann der Rollladen oben. Dies gilt nur bei Steuerbefehlen über das ASC Modul. Stellt man global auf hard, wird bei entsprechender Möglichkeit versucht den Rollladen hardwareseitig zu blockieren. Dann ist auch ein Fahren über die Taster nicht mehr möglich. (default: off)
            • +
          • ASC_LockOut_Cmd - inhibit/blocked/protection - set Befehl für das Rollladen-Device zum Hardware sperren. Dieser Befehl wird gesetzt werden, wenn man "ASC_LockOut" auf hard setzt (default: none)
            • +
          • ASC_Mode_Down - always/home/absent/off - Wann darf die Automatik steuern. immer, niemals, bei Abwesenheit des Roommate (ist kein Roommate und absent eingestellt, wird gar nicht gesteuert) (default: always)
            • +
          • ASC_Mode_Up - always/home/absent/off - Wann darf die Automatik steuern. immer, niemals, bei Abwesenheit des Roommate (ist kein Roommate und absent eingestellt, wird gar nicht gesteuert) (default: always)
            • +
          • ASC_Open_Pos - in 10 Schritten von 0 bis 100 (default: ist abhängig vom Attribut ASC)
            • +
          • ASC_Partymode - on/off - schaltet den Partymodus an oder aus. Wird am ASC Device set ASC-DEVICE partyMode on geschalten, werden alle Fahrbefehle an den Rollläden, welche das Attribut auf on haben, zwischengespeichert und später erst ausgeführt (default: off)
            • +
          • ASC_Pos_Reading - Name des Readings, welches die Position des Rollladen in Prozent an gibt; wird bei unbekannten Device Typen auch als set Befehl zum fahren verwendet
            • +
          • ASC_PrivacyDownTime_beforNightClose - wie viele Sekunden vor dem abendlichen schließen soll der Rollladen in die Sichtschutzposition fahren, -1 bedeutet das diese Funktion unbeachtet bleiben soll (default: -1)
            • +
          • ASC_PrivacyDown_Pos - Position den Rollladens für den Sichtschutz (default: 50)
            • +
          • ASC_WindProtection - on/off - soll der Rollladen beim Regenschutz beachtet werden. On=JA, off=NEIN.
            • +
          • ASC_Roommate_Device - mit Komma getrennte Namen des/der Roommate Device/s, welche den/die Bewohner des Raumes vom Rollladen wiedergibt. Es macht nur Sinn in Schlaf- oder Kinderzimmern (default: none)
            • +
          • ASC_Roommate_Reading - das Reading zum Roommate Device, welches den Status wieder gibt (default: state)
            • +
          • SC_Self_Defense_Exclude - on/off - bei on Wert wird dieser Rollladen bei aktiven Self Defense und offenen Fenster nicht runter gefahren, wenn Residents absent ist. (default: off)

            • +
              + Beschreibung der Beschattungsfunktion +
              Damit die Beschattung Funktion hat, müssen folgende Anforderungen erfüllt sein. +
              Im ASC Device das Attribut "ASC_autoShuttersControlShading" mit dem Wert on, sowie ein Astro/Twilight Device im Attribut "ASC_twilightDevice" und das Attribut "ASC_tempSensor". +
              In den Rollladendevices benötigt ihr ein Helligkeitssensor als Attribut "ASC_BrightnessSensor", sofern noch nicht vorhanden. Findet der Sensor nur für die Beschattung Verwendung ist der Wert DEVICENAME[:READING] ausreichend. +
              Alle weiteren Attribute sind optional und wenn nicht gesetzt mit Default-Werten belegt. Ihr solltet sie dennoch einmal anschauen und entsprechend Euren Gegebenheiten setzen. Die Werte für; die Fensterposition und den Vor- Nachlaufwinkel sowie die Grenzwerte für die StateChange_Cloudy und StateChange_Sunny solltet ihr besondere Beachtung dabei schenken. +
            • ASC_Shading_Angle_Left - Vorlaufwinkel im Bezug zum Fenster, ab wann abgeschattet wird. Beispiel: Fenster 180° - 85° ==> ab Sonnenpos. 95° wird abgeschattet (default: 75)
              • +
            • ASC_Shading_Angle_Right - Nachlaufwinkel im Bezug zum Fenster, bis wann abgeschattet wird. Beispiel: Fenster 180° + 85° ==> bis Sonnenpos. 265° wird abgeschattet (default: 75)
              • +
            • ASC_Shading_Direction - Position in Grad, auf der das Fenster liegt - genau Osten wäre 90, Süden 180 und Westen 270 (default: 180)
              • +
            • ASC_Shading_Min_Elevation - ab welcher Höhe des Sonnenstandes soll beschattet werden, immer in Abhängigkeit der anderen einbezogenen Sensorwerte (default: 25.0)
              • +
            • ASC_Shading_Min_OutsideTemperature - ab welcher Temperatur soll Beschattet werden, immer in Abhängigkeit der anderen einbezogenen Sensorwerte (default: 18)
              • +
            • ASC_Shading_Mode - absent,always,off,home / wann soll die Beschattung nur stattfinden. (default: off)
              • +
            • ASC_Shading_Pos - Position des Rollladens für die Beschattung
              • +
            • ASC_Shading_StateChange_Cloudy - Brightness Wert ab welchen die Beschattung aufgehoben werden soll, immer in Abhängigkeit der anderen einbezogenen Sensorwerte (default: 20000)
              • +
            • ASC_Shading_StateChange_Sunny - Brightness Wert ab welchen Beschattung stattfinden soll, immer in Abhängigkeit der anderen einbezogenen Sensorwerte (default: 35000)
              • +
            • ASC_Shading_WaitingPeriod - wie viele Sekunden soll gewartet werden bevor eine weitere Auswertung der Sensordaten für die Beschattung stattfinden soll (default: 1200)
              • +
            +
          • ASC_ShuttersPlace - window/terrace - Wenn dieses Attribut auf terrace gesetzt ist, das Residence Device in den Status "gone" geht und SelfDefense aktiv ist (ohne das das Reading selfDefense gesetzt sein muss), wird das Rollo geschlossen (default: window)
            • +
          • ASC_Time_Down_Early - Sonnenuntergang frühste Zeit zum Runterfahren (default: 16:00)
            • +
          • ASC_Time_Down_Late - Sonnenuntergang späteste Zeit zum Runterfahren (default: 22:00)
            • +
          • ASC_Time_Up_Early - Sonnenaufgang frühste Zeit zum Hochfahren (default: 05:00)
            • +
          • ASC_Time_Up_Late - Sonnenaufgang späteste Zeit zum Hochfahren (default: 08:30)
            • +
          • ASC_Time_Up_WE_Holiday - Sonnenaufgang frühste Zeit zum Hochfahren am Wochenende und/oder Urlaub (holiday2we wird beachtet). (default: 08:00) ACHTUNG!!! in Verbindung mit Brightness für ASC_Up muss die Uhrzeit kleiner sein wie die Uhrzeit aus ASC_Time_Up_Late
            • +
          • ASC_Up - astro/time/brightness - bei astro wird Sonnenaufgang berechnet, bei time wird der Wert aus ASC_Time_Up_Early als Fahrzeit verwendet und bei brightness muss ASC_Time_Up_Early und ASC_Time_Up_Late korrekt gesetzt werden. Der Timer läuft dann nach ASC_Time_Up_Late Zeit, es wird aber in der Zeit zwischen ASC_Time_Up_Early und ASC_Time_Up_Late geschaut, ob die als Attribut im Moduldevice hinterlegte ASC_brightnessMinVal erreicht wurde. Wenn ja, wird der Rollladen hoch gefahren (default: astro)
            • +
          • ASC_Ventilate_Pos - in 10 Schritten von 0 bis 100 (default: ist abhängig vom Attribut ASC)
            • +
          • ASC_Ventilate_Window_Open - auf lüften, wenn das Fenster gekippt/geöffnet wird und aktuelle Position unterhalb der Lüften-Position ist (default: on)
            • +
          • ASC_WiggleValue - Wert um welchen sich die Position des Rollladens ändern soll (default: 5)
            • +
          • ASC_WindParameters - TRIGGERMAX[:HYSTERESE] [DRIVEPOSITION] / Angabe von Max Wert ab dem für Wind getriggert werden soll, Hytsrese Wert ab dem der Windschutz aufgehoben werden soll TRIGGERMAX - HYSTERESE / Ist es bei einigen Rollläden nicht gewünscht das gefahren werden soll, so ist der TRIGGERMAX Wert mit -1 an zu geben. (default: '50:20 ClosedPosition')
            • +
          • ASC_WindowRec - Name des Fensterkontaktes, an dessen Fenster der Rollladen angebracht ist (default: none)
            • +
          • ASC_WindowRec_subType - Typ des verwendeten Fensterkontaktes: twostate (optisch oder magnetisch) oder threestate (Drehgriffkontakt) (default: twostate)
            • +
        -
        -
          - Folgende Attribute sind obsolet und sollten nicht mehr verwendet werden. - -
        • ASC_temperatureSensor - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • - -
        • ASC_temperatureReading - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • - -
        • ASC_residentsDevice - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • - -
        • ASC_residentsDeviceReading - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • - -
        • ASC_rainSensorDevice - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • - -
        • ASC_rainSensorReading - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • - -
        • ASC_rainSensorShuttersClosedPos - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • - -
        • ASC_brightnessMinVal - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • - -
        • ASC_brightnessMaxVal - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • -
        -
        - In den Rollläden-Geräten -
          -
        • ASC - 0/1/2 0 = "kein Anlegen der Attribute beim ersten Scan bzw. keine Beachtung eines Fahrbefehles",1 = "Inverse oder Rollo - Bsp.: Rollo oben 0, Rollo unten 100 und der Befehl zum prozentualen Fahren ist position",2 = "Homematic Style - Bsp.: Rollo oben 100, Rollo unten 0 und der Befehl zum prozentualen Fahren ist pct
          • -
        • ASC_Antifreeze - soft/am/pm/hard/off - Frostschutz, wenn soft fährt der Rollladen in die ASC_Antifreeze_Pos und wenn hard/am/pm wird gar nicht oder innerhalb der entsprechenden Tageszeit nicht gefahren (default: off)
          • -
        • ASC_Antifreeze_Pos - Position die angefahren werden soll wenn der Fahrbefehl komplett schließen lautet, aber der Frostschutz aktiv ist (default: 50)
          • -
        • ASC_AutoAstroModeEvening - aktuell REAL,CIVIL,NAUTIC,ASTRONOMIC (default: none)
          • -
        • ASC_AutoAstroModeEveningHorizon - Höhe über Horizont wenn beim Attribut ASC_autoAstroModeEvening HORIZON ausgewählt (default: none)
          • -
        • ASC_AutoAstroModeMorning - aktuell REAL,CIVIL,NAUTIC,ASTRONOMIC (default: none)
          • -
        • ASC_AutoAstroModeMorningHorizon - Höhe über Horizont wenn beim Attribut ASC_autoAstroModeMorning HORIZON ausgewählt (default: none)
          • -
        • ASC_BlockingTime_afterManual - wie viel Sekunden soll die Automatik nach einer manuellen Fahrt aus setzen. (default: 1200)
          • -
        • ASC_BlockingTime_beforDayOpen - wie viel Sekunden vor dem morgendlichen öffnen soll keine schließen Fahrt mehr statt finden. (default: 3600)
          • -
        • ASC_BlockingTime_beforNightClose - wie viel Sekunden vor dem nächtlichen schlie&zlig;en soll keine öffnen Fahrt mehr statt finden. (default: 3600)
          • -
        • ASC_BrightnessSensor - DEVICE[:READING] WERT-MORGENS:WERT-ABENDS / 'Sensorname[:brightness [400:800]]' Angaben zum Helligkeitssensor mit (Readingname, optional) für die Beschattung und dem Fahren der Rollladen nach brightness und den optionalen Brightnesswerten für Sonnenauf- und Sonnenuntergang. (default: none)
          • -
        • ASC_Closed_Pos - in 10 Schritten von 0 bis 100 (Default: ist abhängig vom Attribut ASC)
          • -
        • ASC_ComfortOpen_Pos - in 10 Schritten von 0 bis 100 (Default: ist abhängig vom Attribut ASC)
          • -
        • ASC_Down - astro/time/brightness - bei astro wird Sonnenuntergang berechnet, bei time wird der Wert aus ASC_Time_Down_Early als Fahrzeit verwendet und bei brightness muss ASC_Time_Down_Early und ASC_Time_Down_Late korrekt gesetzt werden. Der Timer läuft dann nach ASC_Time_Down_Late Zeit, es wird aber in der Zeit zwischen ASC_Time_Down_Early und ASC_Time_Down_Late geschaut, ob die als Attribut im Moduldevice hinterlegte ASC_brightnessMinVal erreicht wurde. Wenn ja, wird der Rollladen runter gefahren (default: astro)
          • -
        • ASC_DriveUpMaxDuration - die Dauer des hochfahrens vom Rollladen plus 5 Sekunden (default: 60)
          • -
        • ASC_Drive_Offset - maximaler Wert für einen zufällig ermittelte Verzögerungswert in Sekunden bei der Berechnung der Fahrzeiten, 0 bedeutet keine Verzögerung, -1 bedeutet, dass das gleichwertige Attribut aus dem ASC Device ausgewertet werden soll. (default: -1)
          • -
        • ASC_Drive_OffsetStart - in Sekunden verzögerter Wert ab welchen dann erst das Offset startet und dazu addiert wird. Funktioniert nur wenn gleichzeitig ein Drive_Offset gesetzt wird. (default: -1)
          • -
        • ASC_LockOut - soft/hard/off - stellt entsprechend den Aussperrschutz ein. Bei global aktivem Aussperrschutz (set ASC-Device lockOut soft) und einem Fensterkontakt open bleibt dann der Rollladen oben. Dies gilt nur bei Steuerbefehle über das ASC Modul. Stellt man global auf hard, wird bei entsprechender Möglichkeit versucht den Rollladen hardwareseitig zu blockieren. Dann ist auch ein Fahren über die Taster nicht mehr möglich. (default: off)
          • -
        • ASC_LockOut_Cmd - inhibit/blocked/protection - set Befehl für das Rollladen-Device zum Hardware sperren. Dieser Befehl wird gesetzt werden, wenn man "ASC_LockOut" auf hard setzt (default: none)
          • -
        • ASC_Mode_Down - always/home/absent/off - Wann darf die Automatik steuern. immer, niemals, bei Abwesenheit des Roommate (ist kein Roommate und absent eingestellt, wird gar nicht gesteuert) (default: always)
          • -
        • ASC_Mode_Up - always/home/absent/off - Wann darf die Automatik steuern. immer, niemals, bei Abwesenheit des Roommate (ist kein Roommate und absent eingestellt, wird gar nicht gesteuert) (default: always)
          • -
        • ASC_Open_Pos - in 10 Schritten von 0 bis 100 (default: ist abhängig vom Attribut ASC)
          • -
        • ASC_Partymode - on/off - schaltet den Partymodus an oder aus. Wird am ASC Device set ASC-DEVICE partyMode on geschalten, werden alle Fahrbefehle an den Rollläden, welche das Attribut auf on haben, zwischengespeichert und später erst ausgeführt (default: off)
          • -
        • ASC_Pos_Reading - Name des Readings, welches die Position des Rollladen in Prozent an gibt; wird bei unbekannten Device Typen auch als set Befehl zum fahren verwendet
          • -
        • ASC_PrivacyDownTime_beforNightClose - wie viele Sekunden vor dem abendlichen schlie&zlig;en soll der Rollladen in die Sichtschutzposition fahren, -1 bedeutet das diese Funktion unbeachtet bleiben soll (default: -1)
          • -
        • ASC_PrivacyDown_Pos - Position den Rollladens für den Sichtschutz (default: 50)
          • -
        • ASC_WindProtection - on/off - soll das Rolllo beim Regenschutz beachtet werden. On=JA, off=NEIN.
          • -
        • ASC_Roommate_Device - mit Komma getrennte Namen des/der Roommate Device/s, welche den/die Bewohner des Raumes vom Rollladen wiedergibt. Es macht nur Sinn in Schlaf- oder Kinderzimmern (default: none)
          • -
        • ASC_Roommate_Reading - das Reading zum Roommate Device, welches den Status wieder gibt (default: state)
          • -
        • SC_Self_Defense_Exclude - on/off - bei on Wert wird dieser Rollladen bei aktiven Self Defense und offenen Fenster nicht runter gefahren, wenn Residents absent ist. (default: off)

          • -
            - Beschreibung der Beschattungsfunktion -
            Damit die Beschattung Funktion hat, müßen folgende Anforderungen erfüllt sein. -
            Im ASC Device das Attribut "ASC_autoShuttersControlShading" mit dem Wert on, sowie ein Astro/Twilight Device im Attribut "ASC_twilightDevice" und das Attribut "ASC_tempSensor". -
            In den Rollladendevices benötigt ihr ein Helligkeitssensor als Attribut "ASC_BrightnessSensor", sofern noch nicht vorhanden. Findet der Sensor nur für die Beschattung Verwendung ist der Wert DEVICENAME[:READING] ausreichend. -
            Alle weiteren Attribute sind optional und wenn nicht gestezt mit default Werten belegt. Ihr solltet sie dennoch einmal anschauen und entsprechend Euren Gegebenheiten setzen. Die Werte für; die Fensterposition und den Vor- Nachlaufwinkel sowie die Granzwerte für die StateChange_Cloudy und StateChange_Sunny solltet ihr besondere Beachtung dabei schenken. -
          • ASC_Shading_Angle_Left - Vorlaufwinkel im Bezug zum Fenster, ab wann abgeschattet wird. Beispiel: Fenster 180° - 85° ==> ab Sonnenpos. 95° wird abgeschattet (default: 75)
            • -
          • ASC_Shading_Angle_Right - Nachlaufwinkel im Bezug zum Fenster, bis wann abgeschattet wird. Beispiel: Fenster 180° + 85° ==> bis Sonnenpos. 265° wird abgeschattet (default: 75)
            • -
          • ASC_Shading_Direction - Position in Grad, auf der das Fenster liegt - genau Osten wäre 90, Süden 180 und Westen 270 (default: 180)
            • -
          • ASC_Shading_Min_Elevation - ab welcher Höhe des Sonnenstandes soll beschattet werden, immer in Abhängikkeit der anderen einbezogenden Sensorwerte (default: 25.0)
            • -
          • ASC_Shading_Min_OutsideTemperature - ab welcher Temperatur soll Beschattet werden, immer in Abhängikkeit der anderen einbezogenden Sensorwerte (default: 18)
            • -
          • ASC_Shading_Mode - absent,always,off,home / wann soll die Beschattung nur statt finden. (default: off)
            • -
          • ASC_Shading_Pos - Position des Rollladens für die Beschattung
            • -
          • ASC_Shading_StateChange_Cloudy - Brightness Wert ab welchen die Beschattung aufgehoben werden soll, immer in Abhängikkeit der anderen einbezogenden Sensorwerte (default: 20000)
            • -
          • ASC_Shading_StateChange_Sunny - Brightness Wert ab welchen Beschattung statt finden soll, immer in Abhängikkeit der anderen einbezogenden Sensorwerte (default: 35000)
            • -
          • ASC_Shading_WaitingPeriod - wie viele Sekunden soll gewartet werden bevor eine weitere Auswertung der Sensordaten für die Beschattung statt finden soll (default: 1200)
            • -

          -
        • ASC_ShuttersPlace - window/terrace - Wenn dieses Attribut auf terrace gesetzt ist, das Residence Device in den Status "gone" geht und SelfDefense aktiv ist (ohne das das Reading selfDefense gesetzt sein muss), wird das Rollo geschlossen (default: window)
          • -
        • ASC_Time_Down_Early - Sunset frühste Zeit zum Runterfahren (default: 16:00)
          • -
        • ASC_Time_Down_Late - Sunset späteste Zeit zum Runterfahren (default: 22:00)
          • -
        • ASC_Time_Up_Early - Sunrise frühste Zeit zum Hochfahren (default: 05:00)
          • -
        • ASC_Time_Up_Late - Sunrise späteste Zeit zum Hochfahren (default: 08:30)
          • -
        • ASC_Time_Up_WE_Holiday - Sunrise frühste Zeit zum Hochfahren am Wochenende und/oder Urlaub (holiday2we wird beachtet). (default: 08:00) ACHTUNG!!! in Verbindung mit Brightness für ASC_Up muss die Uhrzeit kleiner sein wie die Uhrzeit aus ASC_Time_Up_Late
          • -
        • ASC_Up - astro/time/brightness - bei astro wird Sonnenaufgang berechnet, bei time wird der Wert aus ASC_Time_Up_Early als Fahrzeit verwendet und bei brightness muss ASC_Time_Up_Early und ASC_Time_Up_Late korrekt gesetzt werden. Der Timer läuft dann nach ASC_Time_Up_Late Zeit, es wird aber in der Zeit zwischen ASC_Time_Up_Early und ASC_Time_Up_Late geschaut, ob die als Attribut im Moduldevice hinterlegte ASC_brightnessMinVal erreicht wurde. Wenn ja, wird der Rollladen hoch gefahren (default: astro)
          • -
        • ASC_Ventilate_Pos - in 10 Schritten von 0 bis 100 (default: ist abhängig vom Attribut ASC)
          • -
        • ASC_Ventilate_Window_Open - auf lüften, wenn das Fenster gekippt/geöffnet wird und aktuelle Position unterhalb der Lüften-Position ist (default: on)
          • -
        • ASC_WiggleValue - Wert um welchen sich die Position des Rollladens ändern soll (default: 5)
          • -
        • ASC_WindParameters - TRIGGERMAX[:HYSTERESE] [DRIVEPOSITION] / Angabe von Max Wert ab dem für Wind getriggert werden soll, Hytsrese Wert ab dem der Windschutz aufgehoben werden soll TRIGGERMAX - HYSTERESE / Ist es bei einigen Rollläden nicht gewünscht das gefahren werden soll, so ist der TRIGGERMAX Wert mit -1 an zu geben. (default: '50:20 ClosedPosition')
          • -
        • ASC_WindowRec - Name des Fensterkontaktes, an dessen Fenster der Rollladen angebracht ist (default: none)
          • -
        • ASC_WindowRec_subType - Typ des verwendeten Fensterkontaktes: twostate (optisch oder magnetisch) oder threestate (Drehgriffkontakt) (default: twostate)
          • -
        -
      -

      +

      Beschreibung der AutoShuttersControl API
      Mit dem Aufruf der API Funktion und Übergabe der entsprechenden Parameter ist es möglich auf interne Daten zu zu greifen.

      - Übersicht für das Rolllo Device + Übersicht für das Rollladen-Device
        - { ascAPIget('Getter','ROLLODEVICENAME') }
        + { ascAPIget('Getter','ROLLODEVICENAME') }
      - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + +
      GetterErläuterung
      FreezeStatus1=soft, 2=Daytime, 3=hard
      NoOffsetWurde die Behandlung von Offset deaktiviert (Beispiel bei Fahrten über Fensterevents)
      LastDriveGrund des letzten Fahrens
      LastPosdie letzte Position des Rolllos
      LastPosTimestampTimestamp der letzten festgestellten Position
      LastManPosPosition der letzten manuellen Fahrt
      LastManPosTimestampTimestamp der letzten manuellen Position
      SunsetUnixTimeberechnete Unixzeit für Abends (Sonnenuntergang)
      Sunset1=Abendfahrt wurde durchgeführt, 0=noch keine Abendfahrt durchgeführt
      SunriseUnixTimeberechnete Unixzeit für Morgens (Sonnenaufgang)
      Sunrise1=Morgenfahrt wurde durchgeführt, 0=noch keine Morgenfahrt durchgeführt
      RoommatesStatusaktueller Status der/des Roommate/s für das Rolllo
      RoommatesLastStatusletzter Status der/des Roommate/s für das Rolllo
      ShadingStatusAusgabe des aktuellen Shading Status, „in“, „out“, „in reserved“, „out reserved“
      ShadingStatusTimestampTimestamp des letzten Beschattungsstatus
      IfInShadingBefindet sich das Rolllo, in Abhängigkeit des Shading Mode, in der Beschattung
      WindProtectionStatusaktueller Status der Wind Protection „protection“ oder „unprotection“
      RainProtectionStatusaktueller Status der Regen Protection „protection“ oder „unprotection“
      DelayCmdletzter Fahrbefehl welcher in die Warteschlange kam. Grund z.B. Partymodus.
      StatusPosition des Rolllos
      ASCenableAbfrage ob für das Rolllo die ASC Steuerung aktiv ist.
      GetterErläuterung
      FreezeStatus1=soft, 2=Daytime, 3=hard
      NoOffsetWurde die Behandlung von Offset deaktiviert (Beispiel bei Fahrten über Fensterevents)
      LastDriveGrund des letzten Fahrens
      LastPosdie letzte Position des Rollladens
      LastPosTimestampTimestamp der letzten festgestellten Position
      LastManPosPosition der letzten manuellen Fahrt
      LastManPosTimestampTimestamp der letzten manuellen Position
      SunsetUnixTimeberechnete Unixzeit für Abends (Sonnenuntergang)
      Sunset1=Abendfahrt wurde durchgeführt, 0=noch keine Abendfahrt durchgeführt
      SunriseUnixTimeberechnete Unixzeit für Morgens (Sonnenaufgang)
      Sunrise1=Morgenfahrt wurde durchgeführt, 0=noch keine Morgenfahrt durchgeführt
      RoommatesStatusaktueller Status der/des Roommate/s für den Rollladen
      RoommatesLastStatusletzter Status der/des Roommate/s für den Rollladen
      ShadingStatusAusgabe des aktuellen Shading Status, „in“, „out“, „in reserved“, „out reserved“
      ShadingStatusTimestampTimestamp des letzten Beschattungsstatus
      IfInShadingBefindet sich der Rollladen, in Abhängigkeit des Shading Mode, in der Beschattung
      WindProtectionStatusaktueller Status der Wind Protection „protection“ oder „unprotection“
      RainProtectionStatusaktueller Status der Regen Protection „protection“ oder „unprotection“
      DelayCmdletzter Fahrbefehl welcher in die Warteschlange kam. Grund z.B. Partymodus.
      StatusPosition des Rollladens
      ASCenableAbfrage ob für den Rollladen die ASC Steuerung aktiv ist.
      +

      + Übersicht für das ASC Device +
        + { ascAPIget('Getter') }
        +
      + + + + + + + + +
      GetterErläuterung
      outTemp aktuelle Außentemperatur sofern Sensor definiert
      ResidentsStatusaktueller Status des Residents Devices
      ResidentsLastStatusletzter Status des Residents Devices
      AzimuthAzimut Wert
      ElevationElevation Wert
      ASCenableist die ASC Steuerung global aktiv?
      +
    !DOCTYPE html> + + + + Title + + + + +

    AutoShuttersControl

    +
      +

      AutoShuttersControl (ASC) ermöglicht eine vollständige Automatisierung der vorhandenen Rollläden. Das Modul bietet umfangreiche Konfigurationsmöglichkeiten, um Rollläden bspw. nach Sonnenauf- und untergangszeiten, nach Helligkeitswerten oder rein zeitgesteuert zu steuern.

      +

      + Man kann festlegen, welche Rollläden von ASC in die Automatisierung mit aufgenommen werden sollen. Daraufhin stehen diverse Attribute zur Feinkonfiguration zur Verfügung. So sind unter anderem komplexe Lösungen wie Fahrten in Abhängigkeit des Bewohnerstatus einfach umsetzbar. Beispiel: Hochfahren von Rollläden, wenn der Bewohner erwacht ist und draußen bereits die Sonne aufgegangen ist. Weiterhin ist es möglich, dass der geschlossene Rollladen z.B. nach dem Ankippen eines Fensters in eine Lüftungsposition fährt. Und vieles mehr.

      - Übersicht für das ASC Device + + Define
        - { ascAPIget('Getter') }
        + define <name> AutoShuttersControl +

        + Beispiel: +
          +
          + define myASControl AutoShuttersControl
          +
        +
        + Der Befehl erstellt ein AutoShuttersControl Device mit Namen myASControl.
        + Nachdem das Device angelegt wurde, muss in allen Rollläden Devices, welche gesteuert werden sollen, das Attribut ASC mit Wert 1 oder 2 gesetzt werden. + Dabei bedeutet 1 = "Prozent geschlossen" (z.B. ROLLO oder Siro Modul) - Rollo Oben 0, Rollo Unten 100, 2 = "Prozent geöffnet" (z.B. Homematic) - Rollo Oben 100, Rollo Unten 0. + Die Voreinstellung für den Befehl zum prozentualen Fahren ist in beiden Fällen unterschiedlich. 1="position" und 2="pct". Dies kann, soweit erforderlich, zu späterer Zeit noch angepasst werden. + Habt Ihr das Attribut gesetzt, könnt Ihr den automatischen Scan nach den Devices anstoßen. +
      +
      + + Readings +
        + Im ASC-Device +
          +
        • ..._nextAstroTimeEvent - Uhrzeit des nächsten Astro-Events: Sonnenauf- oder Sonnenuntergang oder feste Zeit
          • +
        • ..._PosValue - aktuelle Position des Rollladens
          • +
        • ..._lastPosValue - letzte Position des Rollladens
          • +
        • ..._lastDelayPosValue - letzter abgesetzter Fahrbefehl, welcher beim nächsten zulässigen Event ausgeführt wird.
          • +
        • partyMode - on/off - Partymodus-Status
          • +
        • ascEnable - on/off - globale ASC Steuerung bei den Rollläden aktiv oder inaktiv
          • +
        • controlShading - on/off - globale Beschattungsfunktion aktiv oder inaktiv
          • +
        • hardLockOut - on/off - Aussperrschutz-Status
          • +
        • room_... - Auflistung aller Rollläden, die in den jeweiligen Rämen gefunden wurde. Beispiel: room_Schlafzimmer: Terrasse
          • +
        • selfDefense - Selbstschutz-Status
          • +
        • state - Status des ASC-Devices: active, enabled, disabled oder weitere Statusinformationen
          • +
        • sunriseTimeWeHoliday - on/off - Status der Wochenendunterstützung
          • +
        • userAttrList - Das ASC-Modul verteilt an die gesteuerten Rollladen-Geräte diverse Benutzerattribute (userattr). In diesem Reading kann der Status dieser Verteilung geprüft werden.
          • +

        + In den Rollläden-Geräten +
          +
        • ASC_Enable - on/off - wird der Rollladen über ASC gesteuert oder nicht
          • +
        • ASC_Time_DriveUp - Im Astro-Modus ist hier die Sonnenaufgangszeit für das Rollo gespeichert. Im Brightness- und Zeit-Modus ist hier der Zeitpunkt aus dem Attribut ASC_Time_Up_Late gespeichert.
          • +
        • ASC_Time_DriveDown - Im Astro-Modus ist hier die Sonnenuntergangszeit für das Rollo gespeichert. Im Brightness- und Zeit-Modus ist hier der Zeitpunkt aus dem Attribut ASC_Time_Down_Late gespeichert.
          • +
        • ASC_ShuttersLastDrive - Grund der letzten Fahrt vom Rollladen
          • +
        +
      +

      + + Set +
        +
      • ascEnable - on/off - Aktivieren oder deaktivieren der globalen ASC Steuerung
        • +
      • controlShading - on/off - Aktiviert oder deaktiviert die globale Beschattungssteuerung
        • +
      • createNewNotifyDev - Legt die interne Struktur für NOTIFYDEV neu an. Diese Funktion steht nur zur Verfügung, wenn Attribut ASC_expert auf 1 gesetzt ist.
        • +
      • hardLockOut - on/off - Aktiviert den globalen Aussperrschutz für die Rollläden, bei denen das Attributs ASC_LockOut entsprechend gesetzt ist. Mehr Informationen in der Beschreibung bei den Attributen für die Rollladengeräten.
        • +
      • partyMode - on/off - Aktiviert den globalen Partymodus. Alle Rollladen-Geräten, in welchen das Attribut ASC_Partymode auf on gesetzt ist, werden durch ASC nicht mehr gesteuert. Der letzte Schaltbefehl, der bspw. durch ein Fensterevent oder Wechsel des Bewohnerstatus an die Rollläden gesendet wurde, wird beim Deaktivieren des Partymodus ausgeführt
        • +
      • renewSetSunriseSunsetTimer - erneuert bei allen Rollläden die Zeiten für Sonnenauf- und -untergang und setzt die internen Timer neu.
        • +
      • scanForShutters - Durchsucht das System nach GerätenRo mit dem Attribut ASC = 1 oder ASC = 2
        • +
      • selfDefense - on/off - Aktiviert bzw. deaktiviert die Selbstschutzfunktion. Beispiel: Wenn das Residents-Gerät absent meldet, die Selbstschutzfunktion aktiviert wurde und ein Fenster im Haus noch geöffnet ist, so wird an diesem Fenster der Rollladen deaktivieren dann heruntergefahren.
        • +
      • shutterASCenableToggle - on/off - Aktivieren oder deaktivieren der ASC Kontrolle beim einzelnen Rollladens
        • +
      • sunriseTimeWeHoliday - on/off - Aktiviert die Wochenendunterstützung und somit, ob im Rollladengerät das Attribut ASC_Time_Up_WE_Holiday beachtet werden soll oder nicht.
        • +
      • wiggle - bewegt einen oder mehrere Rollläden um einen definierten Wert (Default: 5%) und nach einer Minute wieder zurück in die Ursprungsposition. Diese Funktion könnte bspw. zur Abschreckung in einem Alarmsystem eingesetzt werden.
        • +
      +

      + + Get +
        +
      • showShuttersInformations - zeigt eine Übersicht aller Rollläden mit den Fahrzeiten, Modus und diverse weitere Statusanzeigen.
        • +
      • showNotifyDevsInformations - zeigt eine Übersicht der abgelegten NOTIFYDEV Struktur. Diese Funktion wird primär fürs Debugging genutzt. Hierzu ist das Attribut ASC_expert = 1 zu setzen.
        • +
      +

      + + Attributes +
        + Im ASC-Device +
          + +
        • ASC_autoAstroModeEvening - REAL, CIVIL, NAUTIC, ASTRONOMIC oder HORIZON
          • + +
        • ASC_autoAstroModeEveningHorizon - Höhe über dem Horizont. Wird nur berücksichtigt, wenn im Attribut ASC_autoAstroModeEvening der Wert HORIZON ausgewählt wurde. (default: 0)
          • + +
        • ASC_autoAstroModeMorning - REAL, CIVIL, NAUTIC, ASTRONOMIC oder HORIZON
          • + +
        • ASC_autoAstroModeMorningHorizon - Höhe über dem Horizont. Wird nur berücksichtigt, wenn im Attribut ASC_autoAstroModeEvening der Wert HORIZON ausgewählt wurde. (default: 0)
          • + +
        • ASC_autoShuttersControlComfort - on/off - schaltet die Komfortfunktion an. Bedeutet, dass ein Rollladen mit einem threestate-Sensor am Fenster beim Öffnen in eine Offenposition fährt. Hierzu muss beim Rollladen das Attribut ASC_ComfortOpen_Pos entsprechend konfiguriert sein. (default: off)
          • + +
        • ASC_autoShuttersControlEvening - on/off - Aktiviert die automatische Steuerung durch das ASC-Modul am Abend.
          • + +
        • ASC_autoShuttersControlMorning - on/off - Aktiviert die automatische Steuerung durch das ASC-Modul am Morgen.
          • + +
        • ASC_blockAscDrivesAfterManual - 0,1 - wenn dieser Wert auf 1 gesetzt ist, dann werden Rollläden vom ASC-Modul nicht mehr gesteuert, wenn zuvor manuell eingegriffen wurde. Voraussetzung hierfür ist jedoch, dass im Reading ASC_ShuttersLastDrive der Status manual enthalten ist und sich der Rollladen auf eine unbekannte (nicht in den Attributen anderweitig konfigurierte) Position befindet.
          • + +
        • ASC_brightnessDriveUpDown - WERT-MORGENS:WERT-ABENDS - Werte bei dem Schaltbedingungen für Sonnenauf- und -untergang geprüft werden sollen. Diese globale Einstellung kann durch die WERT-MORGENS:WERT-ABENDS Einstellung von ASC_BrightnessSensor im Rollladen selbst überschrieben werden.
          • + +
        • ASC_debug - Aktiviert die erweiterte Logausgabe für Debugausgaben
          • + +
        • ASC_expert - ist der Wert 1, so werden erweiterte Informationen bezüglich des NotifyDevs unter set und get angezeigt
          • + +
        • ASC_freezeTemp - Temperatur, ab welcher der Frostschutz greifen soll und der Rollladen nicht mehr fährt. Der letzte Fahrbefehl wird gespeichert.
          • + +
        • ASC_rainSensor - DEVICENAME[:READINGNAME] MAXTRIGGER[:HYSTERESE] [CLOSEDPOS] - der Inhalt ist eine Kombination aus Devicename, Readingname, Wert ab dem getriggert werden soll, Hysterese Wert ab dem der Status Regenschutz aufgehoben werden soll und der "wegen Regen geschlossen Position".
          • + +
        • ASC_residentsDev - DEVICENAME[:READINGNAME] - der Inhalt ist eine Kombination aus Devicenamen und Readingnamen des Residents-Device der obersten Ebene (z.B. rgr_Residents:presence)
          • + +
        • ASC_shuttersDriveOffset - maximale Zufallsverzögerung in Sekunden bei der Berechnung der Fahrzeiten. 0 bedeutet keine Verzögerung
          • + +
        • ASC_tempSensor - DEVICENAME[:READINGNAME] - der Inhalt ist eine Kombination aus Device und Reading für die Außentemperatur
          • + +
        • ASC_twilightDevice - das Device, welches die Informationen zum Sonnenstand liefert. Wird unter anderem für die Beschattung verwendet.
          • + +
        • ASC_windSensor - DEVICE[:READING] - Sensor für die Windgeschwindigkeit. Kombination aus Device und Reading.
          • +
        +
        +
          + Folgende Attribute sind obsolet und sollten nicht mehr verwendet werden. + +
        • ASC_temperatureSensor - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • + +
        • ASC_temperatureReading - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • + +
        • ASC_residentsDevice - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • + +
        • ASC_residentsDeviceReading - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • + +
        • ASC_rainSensorDevice - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • + +
        • ASC_rainSensorReading - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • + +
        • ASC_rainSensorShuttersClosedPos - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • + +
        • ASC_brightnessMinVal - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • + +
        • ASC_brightnessMaxVal - WARNUNG!!! OBSOLET !!! NICHT VERWENDEN!!!
          • +
        +
        + In den Rollläden-Geräten +
          +
        • ASC - 0/1/2 0 = "kein Anlegen der Attribute beim ersten Scan bzw. keine Beachtung eines Fahrbefehles",1 = "Inverse oder Rollo - Bsp.: Rollo oben 0, Rollo unten 100 und der Befehl zum prozentualen Fahren ist position",2 = "Homematic Style - Bsp.: Rollo oben 100, Rollo unten 0 und der Befehl zum prozentualen Fahren ist pct
          • +
        • ASC_Antifreeze - soft/am/pm/hard/off - Frostschutz, wenn soft fährt der Rollladen in die ASC_Antifreeze_Pos und wenn hard/am/pm wird gar nicht oder innerhalb der entsprechenden Tageszeit nicht gefahren (default: off)
          • +
        • ASC_Antifreeze_Pos - Position die angefahren werden soll, wenn der Fahrbefehl komplett schließen lautet, aber der Frostschutz aktiv ist (default: 50)
          • +
        • ASC_AutoAstroModeEvening - aktuell REAL,CIVIL,NAUTIC,ASTRONOMIC (default: none)
          • +
        • ASC_AutoAstroModeEveningHorizon - Höhe über Horizont, wenn beim Attribut ASC_autoAstroModeEvening HORIZON ausgewählt (default: none)
          • +
        • ASC_AutoAstroModeMorning - aktuell REAL,CIVIL,NAUTIC,ASTRONOMIC (default: none)
          • +
        • ASC_AutoAstroModeMorningHorizon - Höhe über Horizont,a wenn beim Attribut ASC_autoAstroModeMorning HORIZON ausgewählt (default: none)
          • +
        • ASC_BlockingTime_afterManual - wie viel Sekunden soll die Automatik nach einer manuellen Fahrt aussetzen. (default: 1200)
          • +
        • ASC_BlockingTime_beforDayOpen - wie viel Sekunden vor dem morgendlichen öffnen soll keine schließen Fahrt mehr stattfinden. (default: 3600)
          • +
        • ASC_BlockingTime_beforNightClose - wie viel Sekunden vor dem nächtlichen schließen soll keine öffnen Fahrt mehr stattfinden. (default: 3600)
          • +
        • ASC_BrightnessSensor - DEVICE[:READING] WERT-MORGENS:WERT-ABENDS / 'Sensorname[:brightness [400:800]]' Angaben zum Helligkeitssensor mit (Readingname, optional) für die Beschattung und dem Fahren der Rollladen nach brightness und den optionalen Brightnesswerten für Sonnenauf- und Sonnenuntergang. (default: none)
          • +
        • ASC_Closed_Pos - in 10 Schritten von 0 bis 100 (Default: ist abhängig vom Attribut ASC)
          • +
        • ASC_ComfortOpen_Pos - in 10 Schritten von 0 bis 100 (Default: ist abhängig vom Attribut ASC)
          • +
        • ASC_Down - astro/time/brightness - bei astro wird Sonnenuntergang berechnet, bei time wird der Wert aus ASC_Time_Down_Early als Fahrzeit verwendet und bei brightness muss ASC_Time_Down_Early und ASC_Time_Down_Late korrekt gesetzt werden. Der Timer läuft dann nach ASC_Time_Down_Late Zeit, es wird aber in der Zeit zwischen ASC_Time_Down_Early und ASC_Time_Down_Late geschaut, ob die als Attribut im Moduldevice hinterlegte ASC_brightnessMinVal erreicht wurde. Wenn ja, wird der Rollladen runter gefahren (default: astro)
          • +
        • ASC_DriveUpMaxDuration - die Dauer des Hochfahrens des Rollladens plus 5 Sekunden (default: 60)
          • +
        • ASC_Drive_Offset - maximaler Wert für einen zufällig ermittelte Verzögerungswert in Sekunden bei der Berechnung der Fahrzeiten, 0 bedeutet keine Verzögerung, -1 bedeutet, dass das gleichwertige Attribut aus dem ASC Device ausgewertet werden soll. (default: -1)
          • +
        • ASC_Drive_OffsetStart - in Sekunden verzögerter Wert ab welchen dann erst das Offset startet und dazu addiert wird. Funktioniert nur wenn gleichzeitig ASC_Drive_Offset gesetzt wird. (default: -1)
          • +
        • ASC_LockOut - soft/hard/off - stellt entsprechend den Aussperrschutz ein. Bei global aktivem Aussperrschutz (set ASC-Device lockOut soft) und einem Fensterkontakt open bleibt dann der Rollladen oben. Dies gilt nur bei Steuerbefehlen über das ASC Modul. Stellt man global auf hard, wird bei entsprechender Möglichkeit versucht den Rollladen hardwareseitig zu blockieren. Dann ist auch ein Fahren über die Taster nicht mehr möglich. (default: off)
          • +
        • ASC_LockOut_Cmd - inhibit/blocked/protection - set Befehl für das Rollladen-Device zum Hardware sperren. Dieser Befehl wird gesetzt werden, wenn man "ASC_LockOut" auf hard setzt (default: none)
          • +
        • ASC_Mode_Down - always/home/absent/off - Wann darf die Automatik steuern. immer, niemals, bei Abwesenheit des Roommate (ist kein Roommate und absent eingestellt, wird gar nicht gesteuert) (default: always)
          • +
        • ASC_Mode_Up - always/home/absent/off - Wann darf die Automatik steuern. immer, niemals, bei Abwesenheit des Roommate (ist kein Roommate und absent eingestellt, wird gar nicht gesteuert) (default: always)
          • +
        • ASC_Open_Pos - in 10 Schritten von 0 bis 100 (default: ist abhängig vom Attribut ASC)
          • +
        • ASC_Partymode - on/off - schaltet den Partymodus an oder aus. Wird am ASC Device set ASC-DEVICE partyMode on geschalten, werden alle Fahrbefehle an den Rollläden, welche das Attribut auf on haben, zwischengespeichert und später erst ausgeführt (default: off)
          • +
        • ASC_Pos_Reading - Name des Readings, welches die Position des Rollladen in Prozent an gibt; wird bei unbekannten Device Typen auch als set Befehl zum fahren verwendet
          • +
        • ASC_PrivacyDownTime_beforNightClose - wie viele Sekunden vor dem abendlichen schließen soll der Rollladen in die Sichtschutzposition fahren, -1 bedeutet das diese Funktion unbeachtet bleiben soll (default: -1)
          • +
        • ASC_PrivacyDown_Pos - Position den Rollladens für den Sichtschutz (default: 50)
          • +
        • ASC_WindProtection - on/off - soll der Rollladen beim Regenschutz beachtet werden. On=JA, off=NEIN.
          • +
        • ASC_Roommate_Device - mit Komma getrennte Namen des/der Roommate Device/s, welche den/die Bewohner des Raumes vom Rollladen wiedergibt. Es macht nur Sinn in Schlaf- oder Kinderzimmern (default: none)
          • +
        • ASC_Roommate_Reading - das Reading zum Roommate Device, welches den Status wieder gibt (default: state)
          • +
        • SC_Self_Defense_Exclude - on/off - bei on Wert wird dieser Rollladen bei aktiven Self Defense und offenen Fenster nicht runter gefahren, wenn Residents absent ist. (default: off)

          • +
            + Beschreibung der Beschattungsfunktion +
            Damit die Beschattung Funktion hat, müssen folgende Anforderungen erfüllt sein. +
            Im ASC Device das Attribut "ASC_autoShuttersControlShading" mit dem Wert on, sowie ein Astro/Twilight Device im Attribut "ASC_twilightDevice" und das Attribut "ASC_tempSensor". +
            In den Rollladendevices benötigt ihr ein Helligkeitssensor als Attribut "ASC_BrightnessSensor", sofern noch nicht vorhanden. Findet der Sensor nur für die Beschattung Verwendung ist der Wert DEVICENAME[:READING] ausreichend. +
            Alle weiteren Attribute sind optional und wenn nicht gesetzt mit Default-Werten belegt. Ihr solltet sie dennoch einmal anschauen und entsprechend Euren Gegebenheiten setzen. Die Werte für; die Fensterposition und den Vor- Nachlaufwinkel sowie die Grenzwerte für die StateChange_Cloudy und StateChange_Sunny solltet ihr besondere Beachtung dabei schenken. +
          • ASC_Shading_Angle_Left - Vorlaufwinkel im Bezug zum Fenster, ab wann abgeschattet wird. Beispiel: Fenster 180° - 85° ==> ab Sonnenpos. 95° wird abgeschattet (default: 75)
            • +
          • ASC_Shading_Angle_Right - Nachlaufwinkel im Bezug zum Fenster, bis wann abgeschattet wird. Beispiel: Fenster 180° + 85° ==> bis Sonnenpos. 265° wird abgeschattet (default: 75)
            • +
          • ASC_Shading_Direction - Position in Grad, auf der das Fenster liegt - genau Osten wäre 90, Süden 180 und Westen 270 (default: 180)
            • +
          • ASC_Shading_Min_Elevation - ab welcher Höhe des Sonnenstandes soll beschattet werden, immer in Abhängigkeit der anderen einbezogenen Sensorwerte (default: 25.0)
            • +
          • ASC_Shading_Min_OutsideTemperature - ab welcher Temperatur soll Beschattet werden, immer in Abhängigkeit der anderen einbezogenen Sensorwerte (default: 18)
            • +
          • ASC_Shading_Mode - absent,always,off,home / wann soll die Beschattung nur stattfinden. (default: off)
            • +
          • ASC_Shading_Pos - Position des Rollladens für die Beschattung
            • +
          • ASC_Shading_StateChange_Cloudy - Brightness Wert ab welchen die Beschattung aufgehoben werden soll, immer in Abhängigkeit der anderen einbezogenen Sensorwerte (default: 20000)
            • +
          • ASC_Shading_StateChange_Sunny - Brightness Wert ab welchen Beschattung stattfinden soll, immer in Abhängigkeit der anderen einbezogenen Sensorwerte (default: 35000)
            • +
          • ASC_Shading_WaitingPeriod - wie viele Sekunden soll gewartet werden bevor eine weitere Auswertung der Sensordaten für die Beschattung stattfinden soll (default: 1200)
            • +
          +
        • ASC_ShuttersPlace - window/terrace - Wenn dieses Attribut auf terrace gesetzt ist, das Residence Device in den Status "gone" geht und SelfDefense aktiv ist (ohne das das Reading selfDefense gesetzt sein muss), wird das Rollo geschlossen (default: window)
          • +
        • ASC_Time_Down_Early - Sonnenuntergang frühste Zeit zum Runterfahren (default: 16:00)
          • +
        • ASC_Time_Down_Late - Sonnenuntergang späteste Zeit zum Runterfahren (default: 22:00)
          • +
        • ASC_Time_Up_Early - Sonnenaufgang frühste Zeit zum Hochfahren (default: 05:00)
          • +
        • ASC_Time_Up_Late - Sonnenaufgang späteste Zeit zum Hochfahren (default: 08:30)
          • +
        • ASC_Time_Up_WE_Holiday - Sonnenaufgang frühste Zeit zum Hochfahren am Wochenende und/oder Urlaub (holiday2we wird beachtet). (default: 08:00) ACHTUNG!!! in Verbindung mit Brightness für ASC_Up muss die Uhrzeit kleiner sein wie die Uhrzeit aus ASC_Time_Up_Late
          • +
        • ASC_Up - astro/time/brightness - bei astro wird Sonnenaufgang berechnet, bei time wird der Wert aus ASC_Time_Up_Early als Fahrzeit verwendet und bei brightness muss ASC_Time_Up_Early und ASC_Time_Up_Late korrekt gesetzt werden. Der Timer läuft dann nach ASC_Time_Up_Late Zeit, es wird aber in der Zeit zwischen ASC_Time_Up_Early und ASC_Time_Up_Late geschaut, ob die als Attribut im Moduldevice hinterlegte ASC_brightnessMinVal erreicht wurde. Wenn ja, wird der Rollladen hoch gefahren (default: astro)
          • +
        • ASC_Ventilate_Pos - in 10 Schritten von 0 bis 100 (default: ist abhängig vom Attribut ASC)
          • +
        • ASC_Ventilate_Window_Open - auf lüften, wenn das Fenster gekippt/geöffnet wird und aktuelle Position unterhalb der Lüften-Position ist (default: on)
          • +
        • ASC_WiggleValue - Wert um welchen sich die Position des Rollladens ändern soll (default: 5)
          • +
        • ASC_WindParameters - TRIGGERMAX[:HYSTERESE] [DRIVEPOSITION] / Angabe von Max Wert ab dem für Wind getriggert werden soll, Hytsrese Wert ab dem der Windschutz aufgehoben werden soll TRIGGERMAX - HYSTERESE / Ist es bei einigen Rollläden nicht gewünscht das gefahren werden soll, so ist der TRIGGERMAX Wert mit -1 an zu geben. (default: '50:20 ClosedPosition')
          • +
        • ASC_WindowRec - Name des Fensterkontaktes, an dessen Fenster der Rollladen angebracht ist (default: none)
          • +
        • ASC_WindowRec_subType - Typ des verwendeten Fensterkontaktes: twostate (optisch oder magnetisch) oder threestate (Drehgriffkontakt) (default: twostate)
          • +
        +
      +

      + Beschreibung der AutoShuttersControl API +
      Mit dem Aufruf der API Funktion und Übergabe der entsprechenden Parameter ist es möglich auf interne Daten zu zu greifen. +

      + Übersicht für das Rollladen-Device +
        + { ascAPIget('Getter','ROLLODEVICENAME') }
      - - - - - - - + + + + + + + + + + + + + + + + + + + + + +
      GetterErläuterung
      outTemp aktuelle Außentemperatur sofern Sensor definiert
      ResidentsStatusaktueller Status des Residents Devices
      ResidentsLastStatusletzter Status des Residents Devices
      AzimuthAzimut Wert
      ElevationElevation Wert
      ASCenableist die ASC Steuerung global aktiv?
      GetterErläuterung
      FreezeStatus1=soft, 2=Daytime, 3=hard
      NoOffsetWurde die Behandlung von Offset deaktiviert (Beispiel bei Fahrten über Fensterevents)
      LastDriveGrund des letzten Fahrens
      LastPosdie letzte Position des Rollladens
      LastPosTimestampTimestamp der letzten festgestellten Position
      LastManPosPosition der letzten manuellen Fahrt
      LastManPosTimestampTimestamp der letzten manuellen Position
      SunsetUnixTimeberechnete Unixzeit für Abends (Sonnenuntergang)
      Sunset1=Abendfahrt wurde durchgeführt, 0=noch keine Abendfahrt durchgeführt
      SunriseUnixTimeberechnete Unixzeit für Morgens (Sonnenaufgang)
      Sunrise1=Morgenfahrt wurde durchgeführt, 0=noch keine Morgenfahrt durchgeführt
      RoommatesStatusaktueller Status der/des Roommate/s für den Rollladen
      RoommatesLastStatusletzter Status der/des Roommate/s für den Rollladen
      ShadingStatusAusgabe des aktuellen Shading Status, „in“, „out“, „in reserved“, „out reserved“
      ShadingStatusTimestampTimestamp des letzten Beschattungsstatus
      IfInShadingBefindet sich der Rollladen, in Abhängigkeit des Shading Mode, in der Beschattung
      WindProtectionStatusaktueller Status der Wind Protection „protection“ oder „unprotection“
      RainProtectionStatusaktueller Status der Regen Protection „protection“ oder „unprotection“
      DelayCmdletzter Fahrbefehl welcher in die Warteschlange kam. Grund z.B. Partymodus.
      StatusPosition des Rollladens
      ASCenableAbfrage ob für den Rollladen die ASC Steuerung aktiv ist.
      +

      + Übersicht für das ASC Device +
        + { ascAPIget('Getter') }
        +
      + + + + + + + + +
      GetterErläuterung
      outTemp aktuelle Außentemperatur sofern Sensor definiert
      ResidentsStatusaktueller Status des Residents Devices
      ResidentsLastStatusletzter Status des Residents Devices
      AzimuthAzimut Wert
      ElevationElevation Wert
      ASCenableist die ASC Steuerung global aktiv?
    =end html_DE