Module – IPSLight

Allgemein

IPSLight ist ein Modul zur Steuerung des Lichtes.

Folgende Funktionalitäten stellt das Modul zur Verfügung.

  • Schalten von normalen Beleuchtungen
  • Ansteuerung von dimmbaren Beleuchtungen
  • Ansteuerung von RGB Beleuchtungen
  • Definition von Beleuchtungsgruppen
  • Definition von Beleuchtungsprogrammen
  • API zur Ansteuerung der Beleuchtung (Schalten/Dimmen von Lampen, Schalten von Programmen und Gruppen)

Download und Installation

Die Installation gliedert sich wie für alle IPSLibrary Module in 3 Teile:

  • Download
  • Konfiguration
  • Installation

Download und Installation können entweder manuell mit dem IPSModuleManager gemacht werden oder man verwendet das IPSModuleManagerGUI Modul.

Konfiguration

Konfiguration:
Im File IPSLight_Configuration.inc.php werden die Beleuchtungselemente, die Gruppen und die Programme definiert.

Detaillierte Beschreibung der Konfiguration befindet sich oben genannten Include File.

RGB

Mit IPSLight lassen sich auch verschiedene RGB Module ansteuern. Unterstützt werden unter anderem:

Hinweis:

Mit folgenden Aufrufen kann eine RGB-Komponente per Skript angesprochen werden:

   IPSUtils_Include ('IPSLight.inc.php', 'IPSLibrary::app::modules::IPSLight');

   $level = ...
   $color = ...

   $lightManager = new IPSLight_Manager();
   // Helligkeit setzen
   $lightManager->SetRGB(46722 /*[Program\IPSLibrary\data\modules\IPSLight\Switches\Schlafzimmer_RGB_HUE#Level]*/, $level);
   // Farbe per RGB(Hex)-Wert setzen 
   $lightManager->SetRGB(35365 /*[Program\IPSLibrary\data\modules\IPSLight\Switches\Schlafzimmer_RGB_HUE#Color]*/, $color);

Synchronisierung der Aktoren

Todo…

Weiterführende Links

Diskussions Thread zum Modul

IPSLibrary Main Thread

IPSLibrary Diskussions Thread

GUI

IPSLight bietet auch die Möglichkeit zur Generierung des WebFront’s und der MobileGUI, allerdings ist dieser Teil nicht dokumentiert. Der erfahrene User kann sich die Konfiguration in einem der Beispiel Files im Example Ordner ansehen (ist analog zu den API Funktionen von IP-Symcon aufgebaut).

Wer damit Probleme hat, kann sich das WebFront auch mit dem normalen WebFront Konfigurator aufbauen. Die zugehörigen Variablen findet man unter „Program.IPSLibrary.data.modules.IPSLight“ in den Kategorien „Switches“, „Groups“ und „Programs“.

Übersicht

Zum Beispiel kann man sich eine Übersichtsseite aufbauen, die den Zustand aller Beleuchtungsmittel anzeigt.

IPSLight_Overview
Detailansicht Stockwerk

Für einzelne Stockwerke kann man sich auch noch Detailseiten aufbauen (manuell oder auch mit IPSLight).

IPSLight_Detail

API Funktionen

Durch das Inkludieren des IPSLight API Scripts stehen alle Funktionen von IPSLight zur Verfügung:

   IPSUtils_Include ('IPSLight.inc.php', 'IPSLibrary::app::modules::IPSLight');

API Funktionen

  • function IPSLight_SetValue($variableId, $value)
  • function IPSLight_SetSwitch($switchId, $value)
  • function IPSLight_ToggleSwitch($switchId)
  • function IPSLight_SetDimmerAbs($levelId, $value)
  • function IPSLight_SetDimmerRel($levelId, $value)
  • function IPSLight_SetGroup($groupId, $value)
  • function IPSLight_ToggleGroup($groupId)
  • function IPSLight_SetProgram($programId, $value)
  • function IPSLight_SetProgramNext($programId)
  • function IPSLight_SetSwitchByName($lightName, $value)
  • function IPSLight_ToggleSwitchByName($lightName)
  • function IPSLight_DimAbsoluteByName($lightName, $value)
  • function IPSLight_DimRelativByName($lightName, $value)
  • function IPSLight_SetGroupByName($groupName, $value)
  • function IPSLight_ToggleGroupByName($groupName)
  • function IPSLight_SetProgramName($programName, $value)
  • function IPSLight_SetProgramNextByName($programName)

Genauere Beschreibung der einzelnen Funktionen findet sich im Include File von IPSLight (zu finden unter „…/IP-Symcon/scripts/IPSLibrary/app/modules/IPSLight/IPSLight.inc.php“)

Callback Funktionen

Zur Zeit stehen 4 Callback Funktionen zur Verfügung:

  • function IPSLight_BeforeSwitch($control, $value)
  • function IPSLight_AfterSwitch($control, $value)
  • function IPSLight_BeforeSynchronizeSwitch ($SwitchId, $DeviceState)
  • function IPSLight_AfterSynchronizeSwitch ($SwitchId, $DeviceState)

IPSLight_BeforeSwitch und IPSLight_AfterSwitch wird vor bzw. nach dem Schalten einer Beleuchtung über IPSLight aufgerufen.

IPSLight_BeforeSynchronizeSwitch und IPSLight_AfterSynchronizeSwitch wird vor bzw. nach dem Synchronisieren eines Statuswechsel eines Beleuchtungs Elementes aufgerufen (zB manuelle Bedienung über einen Schalter).