MHC – Magic Home Controller
IP-Symcon Modul für die Ansteuerung von WiFi LED Controller der Firma Magic Home.
Inhaltverzeichnis
- Funktionsumfang
- Voraussetzungen
- Installation
- Einrichten der Instanzen in IP-Symcon
- Statusvariablen und Profile
- WebFront
- PHP-Befehlsreferenz
- 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
- IP-Symcon ab Version 5.2
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
odergit://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 ‚(Geräte)‘ 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).
Einstellungsbereich:
Einstellungen …
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
v2.0.20210701
- NEU: Konfigurationsformular vereinheitlicht
- FIX: Berechnung der Geschwindigkeit bei Programmen
- FIX: Code optimiert und Übersetzungen nachgezogen
- FIX: Interne Bibliotheken überarbeitet und vereinheitlicht
- FIX: Debug Meldungen überarbeitet
- FIX: Dokumentation überarbeitet
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
Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der IP-Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti 😉
Spenden
Die Software ist für die nicht kommzerielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.