Beschattungssteuerung für Raffstore

Funktionsbeschreibung

Die Beschattung wird aktiv, wenn alle der folgenden Bedingungen erfüllt sind:

Steuerung Ein ist TRUE
Lux hat SchwelleHell überschritten und seitdem SchwelleDunkel nicht mehr unterschritten (Hysterese)
HoeheBegin < SonnenHoehe < HoeheEnde
RichtungBegin < Sonnenrichtung < RichtungEnde

Ist die Beschattung NICHT aktiv, geschieht folgendes:

RaffPos wird auf den Wert vonRaffPosAus gesetzt
LamellePos wird auf den Wert von LamellePosOffen gesetzt

Ist die Beschattung aktiv, geschieht folgendes:

RaffPos wird auf den Wert von RaffPosEin gesetzt
LamellePos wird auf einen Wert gesetzt, der sich sich abhängig von der SonnenHoehe berechnet
1. LamellePos = LamellePosZu , wenn SonnenHoehe < HoeheZu
2. LamellePos = LamellePosOffen , wenn SonnenHoehe > HoeheOffen
3. LamellePos wird zwischen LamellePosZu und LamellePosOffen interpoliert ,
  wenn HoeheZu < SonnenHoehe < HoeheOffen
LamellePos wird nur gesendet, wenn die Änderung zur letzten Ausgabe größer ist als LamelleStep (damit nicht bei jeder kleinen Änderung die Lamellen verstellt werden, das nervt sonst)

Eingänge

Steuerung Ein (boolean): Beschattungssteuerung einschalten
Lux (float): Aussenhelligkeit
SchwelleDunkel (float): untere Schwelle für Aussenhelligkeit
SchwelleHell (float): obere Schwelle für Aussenhelligkeit
SonnenHoehe (float): Winkel des Sonnenstands über dem Horizont
HoeheBegin (float): Höhenuntergrenze für Beschattung
HoeheEnde (float): Höheobergrenze für Beschattung
Sonnenrichtung (float): Richtungswinkel des Sonnenstands
RichtungBegin (float): Richtungswinkel für Start der Beschattung
RichtungEnde (float): Richtungswinkel für Ende der Beschattung
RaffPosAus (float): Position für Raffstore bei inaktiver Beschattung, d.h. Wert für Raffstore in oberer Position (z.B. 0%)
RaffPosEin (float): Position für Raffstore bei aktiver Beschattung, Wert für Raffstore in Beschattungsposition (fast) unten (z.B. 90%)
LamellePosOffen (float): Position für Lamellen bei inaktiver Beschattung
LamellePosZu (float): Position für Lamellen bei aktiver Beschattung
HoeheZu (float): Sonenhöhe bei der die Lamellennachführung startet, Sonnenstandshöhe ab der die Lamellen nicht mehr komplett zu sein müssen, damit keine Sonnenstrahl durch die Spalten kommt (z.B. 5°)
HoeheOffen (float): Sonenhöhe bei der die Lamellennachführung endet, d.h. Sonnstandshöhe bei der auch bei offenen Lamellen kein Sonnenstrahl mehr durch die Spalten kommt (z.B. 45°)
LamelleStep (float): Schrittweite für Lamellennachführung
Inhibit (boolean): Sperreingänge

Ausgänge

Output (boolean): Ergebnis der Berechnung.
RaffPos (float): Aktuelle Position für Raffstore
LamellePos (float): Aktuelle Position für Lamellen

Hinweise

Diskussion im Rahmen der Entwicklung dieses Logik-Moduls: https://forum.timberwolf.io/viewtopic.php?f=31&t=1061&hilit=%24LamellePosSteigung

Praktische Anwendungsbeispiele

Code

EXPERTEN
Der Custom-Logik-Code dieses Logikmoduls lautet wie folgt:

{  
"Level": [
    [      "$BeschattungEin",      "bool",      false    ],
    [      "$LuxAussen",      "float",      50000    ],
    [      "$LuxSchwelleDunkel",      "float",      300    ],
    [      "$LuxSchwelleHell",      "float",      1000    ],
    [      "$AussenHell",      "bool",      false    ],
    [      "$SonnenHoehe",      "float",      0    ],
    [      "$HoeheStart",      "float",      0    ],
    [      "$HoeheEnde",      "float",      90    ],
    [      "$HoeheInnerhalb",      "bool",      false    ],
    [      "$SonnenAzimut",      "float",      0    ],
    [      "$AzimutStart",      "float",      90    ],
    [      "$AzimutEnde",      "float",      270    ],
    [      "$AzimutInnerhalb",      "bool",      false    ],
    [      "$BeschattungAktiv",      "bool",      false    ],
    [      "$RaffPosAus",      "float",      0    ],
    [      "$RaffPosEin",      "float",      100    ],
    [      "$RaffPosOut",      "float",      0    ],
    [      "$LamellePosZu",      "float",      100    ],
    [      "$LamellePosOffen",      "float",      0    ],
    [      "$LamellePosDiff",      "float",      0    ],
    [      "$LamellePosSteigung",      "float",      0    ],
    [      "$LamellePosOffset",      "float",      0    ],
    [      "$HoeheZu",      "float",      10    ],
    [      "$HoeheOffen",      "float",      50    ],
    [      "$HoeheDiff",      "float",      50    ],
    [      "$HoeheLimit",      "float",      0    ],
    [      "$LamellePosEin",      "float",      0    ],
    [      "$LamellePosOut",      "float",      0    ],
    [      "$LamellePosStep",      "float",      5    ],
    [      "$LamellePosStpOut",      "float",      0    ],
    [      "$EinsKonst",      "float",      1    ],
    [      "$VAR<Inhibit?>",      "bool",      false    ]  ],
"Module": [
    [      "Break",      [        "$VAR<Inhibit?>"      ]    ],
    [       "Comparator",      "$LuxAussen",      "$AussenHell",      [        "$LuxSchwelleDunkel",        "$LuxSchwelleHell"      ]    ],
    [       "Limiter",      "$SonnenHoehe",      0,      "$HoeheInnerhalb",      [        "$HoeheStart",        "$HoeheEnde"      ]    ],
    [       "Limiter",      "$SonnenAzimut",      0,      "$AzimutInnerhalb",      [        "$AzimutStart",        "$AzimutEnde"      ]    ],
    [       "And",      [        "$BeschattungEin",        "$AussenHell",        "$HoeheInnerhalb",        "$AzimutInnerhalb"      ],      "$BeschattungAktiv"    ],
    [      "Multiplexer",      [        "$RaffPosAus",        "$RaffPosEin"      ],      "$RaffPosOut",      "$BeschattungAktiv"    ],
    [      "Limiter",      "$SonnenHoehe",      "$HoeheLimit",      0,      [        "$HoeheZu",        "$HoeheOffen"      ]    ],
    [       "Polynomial",      "$LamellePosOffen",      "$LamellePosDiff",      [        "-$LamellePosZu",        "$EinsKonst"      ]    ],
    [       "Polynomial",      "$HoeheOffen",      "$HoeheDiff",      [        "-$HoeheZu",        "$EinsKonst"      ]    ],
    [       "Ratio",      "$LamellePosDiff",      "$LamellePosSteigung",      "$HoeheDiff"    ],
    [      "Polynomial",      "$HoeheZu",      "$LamellePosOffset",      [        "$LamellePosZu",        "-$LamellePosSteigung"      ]    ],
    [       "Polynomial",      "$HoeheLimit",      "$LamellePosEin",      [        "$LamellePosOffset",        "$LamellePosSteigung"      ]    ],
    [       "Multiplexer",      [        "$LamellePosOffen",        "$LamellePosEin"      ],      "$LamellePosOut",      "$BeschattungAktiv"    ],
    [      "Step",      "$LamellePosOut",      "$LamellePosStpOut",      0,      "$LamellePosStep",      0    ]  ],
"Input": [
    [      "Steuerung Ein",      "Beschattungssteuerung einschalten",      "$BeschattungEin",      "c"    ],
    [      "Lux",      "Aussenhelligkeit",      "$LuxAussen",      "c"    ],
    [      "SchwelleDunkel",      "untere Schwelle für Aussenhelligkeit",      "$LuxSchwelleDunkel",      "c"    ],
    [      "SchwelleHell",      "obere Schwelle für Aussenhelligkeit",      "$LuxSchwelleHell",      "c"    ],
    [      "SonnenHoehe",      "Winkel des Sonnenstands über dem Horizont",      "$SonnenHoehe",      "c"    ],
    [      "HoeheBegin",      "Höhenuntergrenze für Beschattung",      "$HoeheStart",      "c"    ],
    [      "HoeheEnde",      "Höheobergrenze für Beschattung",      "$HoeheEnde",      "c"    ],
    [      "Sonnenrichtung",      "Richtungswinkel des Sonnenstands",      "$SonnenAzimut",      "c"    ],
    [      "RichtungBegin",      "Richtungswinkel für Start der Beschattung",      "$AzimutStart",      "c"    ],
    [      "RichtungEnde",      "Richtungswinkel für Ende der Beschattung",      "$AzimutEnde",      "c"    ],
    [      "RaffPosAus",      "Position für Raffstore bei inaktiver Beschattung",      "$RaffPosAus",      "c"    ],
    [      "RaffPosEin",      "Position für Raffstore bei aktiver Beschattung",      "$RaffPosEin",      "c"    ],
    [      "LamellePosOffen",      "Position für Lamellen bei inaktiver Beschattung",      "$LamellePosOffen",      "c"    ],
    [      "LamellePosZu",      "Position für Lamellen bei aktiver Beschattung",      "$LamellePosZu",      "c"    ],
    [      "HoeheZu",      "Sonenhöhe bei der die Lamellennachführung startet",      "$HoeheZu",      "c"    ],
    [      "HoeheOffen",      "Sonenhöhe bei der die Lamellennachführung endet",      "$HoeheOffen",      "c"    ],
    [      "LamelleStep",      "Schrittweite für Lamellennachführung",      "$LamellePosStep",      "c"    ],
    [      "Inhibit",      "Inhibit",      "$VAR<Inhibit?>",      "u"    ]  ],
"Output": [
    [      "RaffPos",      "Aktuelle Position für Raffstore",      "$RaffPosOut",      "c"    ],
    [      "LamellePos",      "Aktuelle Position für Lamellen",      "$LamellePosStpOut",      "c"    ]  ]
}

Beschattung (Logik-Modul)