MHC – Magic Home Controller

IP-Symcon Modul für die Ansteuerung von WiFi LED Controller der Firma Magic Home.

Inhaltverzeichnis

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

1. Funktionsumfang

Das Modul dient zur Ansteuerung von LED Stripes mittels eines WiFi LED Controllers des Herstellers Magic Home. Das sind Controller vom Typ LD382 bzw. LD382A.

Wenn jemand noch weitere kennt, bitte einfach bei mir melden!

2. Voraussetzungen

• ab IP-Symcon Version 5.0

3. Installation

• Über den Modul Store das Modul ‚Magic Home Controller‘ installieren.
• Alternativ Über das Modul-Control folgende URL hinzufügen.
  https://github.com/Wilkware/IPSymconMHC oder git://github.com/Wilkware/IPSymconMHC.git

4. Einrichten der Instanzen in IP-Symcon

• Unter "Instanz hinzufügen" ist das ‚Magic Home Controller‘-Modul (Alias: LED Controller) unter dem Hersteller ‚(Sonstige)‘ aufgeführt.

Konfigurationsseite:

Die Konfiguration beinhaltet die Zuweisung der IP-Adresse und der Auswahl der Farbkanal-Reihenfolge (RGB-Pins).
Derzeit werden Stripes mit der Reihenfolge GRB (Gelb, Rot, Blau) und BRG (Blau, Rot, Gelb) unterstützt.
Die Reihenfolge der Pins beginnt immer ausgehend vom GND-Pin (12V Pin).

Darüber hinaus kann noch ausgewählt werden, ob die Debug-Meldungen auch im Status Logging (Log Meldungen) ausgegeben werden sollen.

Name	Beschreibung
WiFi Controller IP	IP-Adresse des Controlers im lokalen WLAN (zb. 192.168.0.10)
RGB Pin Belegung	Reihenfolge der Farb-Pins (GRB oder BRG), Standard ist GRB

5. Statusvariablen und Profile

Ident	Name	Typ	Profil	Beschreibung
Brightness	Helligkeit	Integer	~Intensity.100	Helligkeitswert von 0 bis 100%
Color	Farbe	Integer	~HexColor	Farbwert
Mode	Modus	Integer	MHC.ModeGRB oder MHC.ModeBRG	Manueller Farbmodus oder vordefinierter Funktionsmodus
Power	Aktiv	Boolean	~Switch	An/Aus Schalter
Speed	Geschwindigkeit	Integer	~Intensity.100	Geschwindigkeitswert von 0 bis 100%

6. WebFront

Man kann die Statusvariaben direkt im WebFront verlinken.

7. PHP-Befehlsreferenz

void MHC_SetBrightness(int $InstanzID, int $Brightness);
Setzt die Helligkeit auf $Brightness. Die Funktion liefert keinerlei Rückgabewert.

void MHC_SetColor(int $InstanzID, int $Color);
Setzt den Farbwert auf $Color. Die Funktion liefert keinerlei Rückgabewert.

void MHC_SetMode(int $InstanzID, int $Mode);
Setzt den Anzeigemodus auf auf $Mode. Die Funktion liefert keinerlei Rückgabewert.

void MHC_Power(int $InstanzID, bool $Power);
Schaltet den Controler Ein(true) bzw Aus(false). Die Funktion liefert keinerlei Rückgabewert.

8. Versionshistorie

v1.2.20190812

• NEU: Anpassungen für Module Store
• NEU: Vereinheitlichungen, Umstellung auf Libs
• FIX: Fehler in Profilen korrigiert

v1.1.20190225

• NEU: Umbenennungen, Vereinheitlichungen, StyleCI uvm.

v1.0.20180415

• NEU: Initialversion

Danksagung

Dieses Modul basiert auf dem Modul von …

• Spoosie : Modul KH_LEDWiFiController https://github.com/Spoosie/KH_LEDWiFiController

Vielen Dank für die hervorragende und tolle Arbeit!

Entwickler

• Heiko Wilknitz (@wilkware)

Spenden

Die Software ist für die nicht kommzerielle Nutzung kostenlos, Schenkungen als Unterstützung für den Entwickler bitte hier:

Lizenz