Skip to content

Latest commit

 

History

History
318 lines (218 loc) · 13.5 KB

lightcontrol.md

File metadata and controls

318 lines (218 loc) · 13.5 KB

Logo

LightControl

Steuerung von Lampen unterschiedlicher Hersteller


Inhaltsverzeichnis


1. Features

  • Gruppierung beliebig vieler Lampen/Leuchtmittel
  • Verwendung gemischter Lampen/Farbsystemen und Umrechnung der Farbsysteme (Hex,Rgb,Xy)
  • Möglichkeit der Zuweisung von defaultwerten zu jedem Leuchtmittel (gleiche Helligkeit trotz unterschiedlich leistungsstarker Leuchtmittel)
  • Verwendung beliebig vieler Bewegungsmelder pro Gruppe
  • Ramping (langsame Änderung der Helligkeit bis Zielwert) für on und off
  • Hoch- und Runterdimmen
  • AutoOff nach Zeit / Kein Off bei Bewegung;
  • AutoOff nach Helligkeit
  • AutoOn bei Bewegung ab bestimmter Helligkeit
  • AutoOn bei Dunkelheit
  • AutoOn bei Anwesenheitszählererhöhung ab bestimmter Helligkeit (Begrüßungslicht bei heimkommen)
  • Override on (Putzlicht)
  • Masterswitch um alle Gruppen gemeinsam ein- und auszuschalten (Gleichzeitig Indikator, wenn alle Gruppen an sind)
  • Info Datenpunkt für "beliebige Gruppe ist ein"
  • Blinken (Alarm, Türklingel, etc.)
  • Adaptive Helligkeit (Bei Aussenhelligkeit über 1000 Lux volle Helligkeit (100%), darunter linear dunkler bis 0 Lux (2%))
  • Adaptive Farbtemperatur (4 dynamische Modi: Linear (linear ansteigend von Sonnenaufgang bis Sonnenmittag, dann linear abfallend bis Sonnenuntergang), Solar (entsprechend der Sonnenhöhe errechneter Sinus, maxCt ist Jahreszeitenabhängig), SolarInterpoliert (wie Solar, jedoch ohne Jahreszeitenabhängigkeit), StartYourDay (linear Absteigend von Start-Uhrzeit - Sonnenuntergang) adaptive_Ct.png


2. Installation

Der Adapter befindet sich in der Beta-Repository des ioBrokers. Nach dem Download kann man durch anklicken des (+) eine Instanz angelgen.



3. Konfiguration

Sollte in dem Installationsfenster die Checkbox "schließen, wenn fertig" nicht angehakt sein muss man dieses natürlich noch schließen.

Das Konfigurationsfenster besteht aus den Reitern:



4. Gruppeneinstellungen

Das Konfigurationsfenster öffnet sich automatisch mit den Gruppeneinstellungen. Hier werden die einzelnen Lichtgruppen erstellt.

4.1 Lichtgruppen

Instance Settings - LightGroups

Mit Klick auf das + wird eine neue Zeile erstellt.

  • Bezeichnung: Hier benennt man die Gruppe. Achtung: Keine doppelten Namen anlegen!!
  • Individueller Lux Sensor: Hier definiert man einen individuellen Lux-Sensor. Über die 3 Punkte an der rechten Seite lässt sich eine Objekt-ID einfügen. Wenn das Feld leer gelassen wir, so wird für die Lichtgruppe der globale Lux-Sensor verwendet, sofern einer definiert ist.

4.2 Allgemeine Einstellungen

Instance Settings - General

  • Einstellungen für globalen Lux-Sensor
    • Dieser Sensor wird global verwendet, sofern nicht innerhalb einer Gruppe ein individueller Sensor gewählt wurde
    • Es muss ein numerischer Datenpunkt gewählt werden!
  • Einstellungen für die Farbtemperatur
    • Minimalwert für die Farbtemperatur in Kelvin => Standard: 2700
    • Maximalwert für die Farbtemperatur in Kelvin => Standard: 6500
  • Einstellungen zum Dimmen
    • Rampenschritte zum Dimmen => Standard: 10
    • Mindeshelligkeit beim Dimmen über den Datenpunkt DimmDown => Standard: 10
  • Einstellungen für Anwesenheit
    • Objekt-ID der Anwesenheit => Muss true oder false sein
    • Objekt-ID des Anwesenheitszählers => Muss eine Nummer sein.
  • Logging
    • Erweitertes User-Logging


5 Lichter und Sensoren

Alle Lichter und Sensoren werden über die jeweiligen Datenpunkte den Lichtgruppen hinzugefügt:

Custom Configuration

Nach Öffnen der Einstellungen muss die Konfiguration aktiviert werden:

Activate Custom Config

5.1 Lichter

Light Settings

  • Typ des Objekt In vielen Fällen erkennt LightControl, ob es sich um ein Licht oder Sensor handelt. Wenn dies nicht der Fall sein sollte, ist Licht voreingestellt.

  • Licht Gruppe Hier wählt man die zuvor in den Instanzeinstellungen definierten Lichtgruppen aus (Mehrfachauswahl möglich -> Bug)

  • Lichtname Hier einen Namen für das Licht definieren. Schon zuvor definierte Namen werden zur Auswahl vorgeschlagen

  • Funktion des Objekts In vielen Fällen erkennt LightControl, um welche Funktion es sich handeln könnte. Wenn die automatische Erkennung nicht dem entspricht, was gewünscht ist, dann über das DropDown Menü die jeweilige Funktion auswählen

    • Switch

      • Power On Value - Wert für Ein. z.B. true
      • Power Off Value - Wert für Aus. z.B. false
    • Brightness

      • Value for minimum Brightness - Wert die geringste Helligkeit. z.B. 0
      • Value for maximum Brightnes - Wert für die maximalste Helligkeit. z.B. 100
      • Value/Offset for Brightness - Korrekturwert/Max-Wert für die Anpassung der Helligkeit gegenüber den anderen Lampen innerhalb der Gruppe.
      • Use Brightness for Switching - Verwendet den Helligkeits Datenpunkt der Lampe, um diese zu schalten, anstatt den Power Datenpunkt
    • Color-Temperature

      • Wert für minimum Farbemperatur - Min-Wert des Datenpunkts. z.B. 0
      • Wert für maximum Farbemperatur - Max-Wert des Datenpunkts. z.B. 100
      • Verhalten der Farbtemperatur - Festlegen des Verlaufs der Farbtemperatur (Warm- zu Kaltweiß, Kalt- zu Warmweiß oder Mired)
      • Wert für minimum Kelvin - _Entspricht dem Kelvin des Min-Werts vom Datenpunkt. z.B. 2700
      • Wert für maximum Kelvin - _Entspicht dem Kelvin des Max-Werts vom Datenpunkt. z.B. 6500
      • Send Color-Temperatur - Sende die Farbtemperatur an die Lampe, auch wenn diese ausgeschaltet ist
    • Saturation

      • Value for minimum Saturation - Wert für die geringste Sättigung. z.B. 0
      • Value for maximum Saturation - Wert für die maximale Sättigung. z.B. 100
      • Send Saturation - Sende die Sättigung an die Lampe, auch wenn diese ausgeschaltet ist
    • ModeSwitch

      • Value for White Mode - Wert für den Weiß-Modus. z.B. false
      • Value for Color Mode - Wert für den Farbmodus. z.B. true
      • Send ModeSwitch - Ändere den Modus der Lampe, auch wenn diese ausgeschaltet ist
    • Color

      • Color Type - Typ der Farbvorgabe (HEX => #FFFFFF // RGB => 255,255,255 // XY => [0.4992,0.418])
      • Default Value for Color- Standardwert. z.B. #FFFFFF
      • Send Color - Sende die Farbe an die Lampe, auch wenn diese ausgeschaltet ist
  • zurück zum Inhaltsverzeichnis


5.2 Sensoren

4.2.1 Allgemeines

  • Wenn ein Sensor auslöst, wird das Licht geschalten (sofern in den Datenpunkten aktiviert).
  • Erst wenn ALLE Sensoren nichts mehr registrieren, wird der Ausschaltprozess gestartet (sofern in den Datenpunkten aktiviert).

Hinweis: Theoretisch können hier auch Schalter angegeben werden. Hauptsache es gibt für Ein/Aus unterschiedliche Werte. Jedoch verhält sich der Auschaltprozess je nach Einstellung. z.B. Licht geht aus nach 60 Sekunden

Custom Config Sensor

  • Value for Motion - Wert für Bewegung erkannt. z.B. true
  • Value for noMotion - Wert für keine Bewegung. z.B. false

6 Datenpunkte

6.1 Datenpunkte für alle Gruppen

  • All
    • power: Alle Gruppen ein-/ausschalten / Indikator, wenn alle Gruppen an sind
    • anyOn: true wenn mindestens eine Gruppe an ist

6.2 Datenpunkte der einzelnen Gruppe

  • Gruppe

    • autoOffLux: AutoOff des Lichts bei erreichen einer Helligkeitsschwelle

      • enabled: AutoOff bei Helligkeit aktivieren/deaktivieren
      • minLux: minimaler Lichtwert
      • dailyLock: Bei false wird AutoOffTimed nicht ausgeführt
      • operator: Vergleich ob Licht über oder unter minLux ausgehen soll (z.B. > / < / >= / <=)
    • autoOffTimed: AutoOff nach fest eingestellter Zeit (Nur in Verbindung mit den Sensoren)

      • enabled: AutoOff aktivieren/deaktivieren
      • autoOffTime: Zeit bis AutoOff in Sekunden
      • noAutoOffWhenMotion: AutoOff resetten bei erneuter Bewegung
      • noticeEnabled: Hinweis für AutoOff aktivieren/deaktivieren (Aktuell noch ohne Funktion)
      • noticeBri: Helligkeit in Prozent bevor AutoOff
      • noticeTime: Zeit in Sekunden wann der Hinweis aktiviert wird bevor AutoOff
    • autoOnLux: Automatisch Licht ein bei Lux

      • enabled: Aktivieren/Deaktivieren
      • minLux: Lux-Schwellwert für das Schalten
      • bri: Helligkeit, mit der das Licht an geht
      • color: Farbe, mit das Licht an geht
      • switchOnlyWhenPresence: Nur Schalten, wenn jemand zuhause ist
      • switchOnlyWhenNoPresence: Nur schalten, wenn niemand zu hause ist
      • dailyLock: Bei false wird AutoOnLux nicht ausgeführt
      • operator: Vergleich ob Licht über oder unter minLux angehen soll (z.B. > / < / >= / <=)
    • autoOnMotion: Automatisch Licht ein bei Bewegung

      • enabled: Aktivieren/Deaktivieren
      • minLux: Lux-Schwellwert für das Schalten
      • bri: Helligkeit, mit der das Licht an geht
      • color: Farbe, mit das Licht an geht
    • autoOnPresenceIncrease: Automatisch Licht ein, wenn sich der Wert des Anwesenheitszähler größe als der letztere war

      • enabled: Aktivieren/Deaktivieren
      • minLux: Lux-Schwellwert für das Schalten
      • bri: Helligkeit, mit der das Licht an geht
      • color: Farbe, mit das Licht an geht
    • blink: Blinken

      • enabled: Startet Blinken in Endlosschleife, => false beendet Blinken
      • start: Startet Blinken bis Anzahl erreicht.
      • frequency: Blinkfrequenz in Sekunden
      • blinks: Anzahl der Blinker
      • bri: Helligkeit der Lampen beim Blinken
      • color: Farbe der Lampen beim Blinken
    • rampOff: Runterdimmen beim Ausschalten

      • enabled: Aktivieren/Deaktivieren
      • time: Zeit für das Runterdimmen (sollte nicht kleiner als 10 Sekunden sein)
      • switchOutletsLast: Lampen welche nur ein-/ausgeschaltet werden zuletzt aktivieren?
    • rampOn: Hochdimmen beim Einschalten

      • enabled: Aktivieren/Deaktivieren
      • time: Zeit für das Hochdimmen (sollte nicht kleiner als 10 Sekunden sein)
      • switchOutletsLast: Lampen welche nur ein-/ausgeschaltet werden zuletzt aktivieren?
    • adaptiveBri: Adaptive Helligkeit ein-/ausschalten

    • adaptiveCt: Adaptive Farbtemperatur ein-/ausschalten

    • adaptiveCtMode: Modus der adaptiven Farbtemperatur

      • Linear (Sonnenaufgang --> Mittag --> Sonnenuntergang)
      • Solar (entsprechend der Sonnenhöhe errechneter Sinus, maxCt ist Jahreszeitenabhängig)
      • SolarInterpoliert (wie Solar, jedoch ohne Jahreszeitenabhängigkeit)
      • StartYourDay (linear Absteigend von Start-Uhrzeit - Sonnenuntergang)
    • adaptiveCtTime: Startzeit Adaptive Farbtemperature bei Modus: StartYourDay

    • bri: Helligkeit setzen (0-100%)

    • color: Farbe setzen als Hex-Wert (#FFFFFF)

    • ct: Farbtemeratur setzen in Kelvin

    • dimmAmount: Schritte zum Dimmen in %

    • dimmDown: Button Runterdimmen

    • dimmUp: Button Hochdimmen

    • isMotion: Aktivieren/Deaktivieren der Sensoren

    • power: Ein-/Ausschalten

    • powerCleaningLight: Putzlicht (setzt Helligkeit auf 100% und Farbtemperatur auf Kaltweiß)



7 Was ist für die Zukunft geplant

  • CodeCleaning.... ;-)
  • Hinweisfunktion bei AutoOff mit reduzierter Helligkeit
  • Intergration von einfachen Button-Events (Ein/Aus/Dimmen) für jede Gruppe


8 Was ist nicht geplant

  • Zeitpläne für das Aktivieren oder Deaktivieren von Funktionen oder zum setzten von verschiedenen Helligkeiten, etc.