Externe Integration - Magic Home

Entwicklung
1

Hallo zusammen,

Wie im Thread zu den zu entwickelnden Integrationen angekündigt, hier eine externe Integration für die Magic Home Wi-Fi-Lampen, LED-Streifen und Steckdosen, die lokal gesteuert werden.

Was sie kann

Sie bringt die Geräte der Magic Home Pro-, Zengge- oder Surplife-Apps in Gladys: Lampen, Streifencontroller, adressierbare Streifen, Lichterketten, Steckdosen. Alles bleibt im Lokalnetzwerk (Lokaler Transport): kein Konto, keine Cloud. Gladys findet die Geräte allein (UDP-Suche 48899 über seine Netzwerkentdeckung), dann spricht die Integration sie per TCP an.

Gladys hat keine native Magic Home Integration: Keine MQTT-Brücke (Thread) oder Matterbridge (Thread) mehr nötig.

Funktionen

  • Geräte: Ein-/Ausschalten, Helligkeit, Farbe und Farbtemperatur je nach Modell; Steckdosen als Schalter. Änderungen am Fernbedienung werden bei den meisten Modellen automatisch übertragen.
  • 2 Szenenauslöser: Ein Gerät antwortet nicht mehr (nach 30 s), ein Gerät antwortet wieder.
  • 4 Szenenaktionen: Integrierter Effekt (23 zur Auswahl), bis zu 16 Farben im Loop, Blinken und Rückkehr zum vorherigen Zustand, Effekt stoppen.
  • 2 Widgets: „Magic Home Lichter“ (mit „Alles ausschalten“) und „Magic Home Effekte“ (drei Effektknöpfe zur Auswahl).

Beispiele für Szenen:

  • Wenn es an der Tür klingelt → Wohnzimmerlampe 5 Sekunden rot blinken lassen;
  • Wenn das Gartenlicht nicht mehr antwortet → mir eine Nachricht schicken (ausgeschaltet am Schalter);
  • Bei Sonnenuntergang → Küchenstreifen auf 40 %, dann ein Orange-Rosa-Fade auf dem Wohnzimmerstreifen.

Widgets Magic Home Lichter und Magic Home Effekte (generierte Illustration, kein Screenshot)

[Screenshot folgt: Der Entdeckungstab mit einer Lampe, einem Streifen und einer Steckdose]

Installation

  • Über den Store: „Magic Home“ suchen. Sollte im Laufe des Tages verfügbar sein, sobald die Indizierung abgeschlossen ist.
  • Oder über die Repo-URL: https://github.com/William-De71/gladys-magic-home.

Mindestversion von Gladys: 5.1.1.

  1. Integration installieren und Netzwerkentdeckung (UDP 48899) akzeptieren.
  2. Konfiguration: „Geräte suchen und testen“.
  3. Entdeckungstab: Geräte hinzufügen, dann Widgets und Szenen.

Bekannte Einschränkungen

  • Nicht vom Hersteller dokumentiertes Protokoll: Ich habe es basierend auf flux_led geschrieben, das Home Assistant verwendet. Noch nicht an echten Geräten getestet, nur an simulierten Geräten mit erfassten Frames von echtem Gerät: Eure Rückmeldungen sind wertvoll (mit dem Parameter MAGICHOME_MODEL).
  • Nicht unterstützt: Animationen der adressierbaren Streifen und Lichterketten, Musikmodus, Timer, Streifeneinstellungen.
  • Schalter mit 2 oder 4 Ausgängen werden als ein einzelner Schalter erkannt; Geräte, die nur über die Cloud erreichbar sind, werden nicht unterstützt.
Technische Details
  • Ein Gerät pro Modul, identifiziert durch seine MAC-Adresse: Es wird nach einer IP-Adressänderung wiedergefunden (automatische Suche alle Stunden und sobald ein Gerät nicht mehr antwortet). Eine feste IP-Adresse wird empfohlen.
  • Das Protokoll wird basierend auf der Modellnummer und der Firmware-Version ausgewählt: Originalprotokoll ohne Prüfsumme, 8- und 9-Octet-Protokolle, 25-Octet-Firmware in HSV der neueren Lampen, verkapselte Frames der adressierbaren Streifen.
  • Eine einzige TCP-Verbindung pro erstelltem Gerät (sie akzeptieren nur wenige, die App behält eine); entdeckte, aber nicht hinzugefügte Geräte bleiben nicht verbunden.
  • Die Farbtemperatur wird in Mired angegeben, wie bei Hue und Tasmota in Gladys.
  • Szenenaktionen lösen niemals einen Auslöser aus (keine Schleife); eine Unterbrechung von weniger als 30 s löst nichts aus.

Feedback geben

Über ein GitHub-Issue oder als Antwort auf diesen Thread, mit der Gladys-Version, der Integrationsversion und den Logs