Intégration externe - Magic Home

Développement
1

Bonjour à tous,

Comme annoncé dans le fil des intégrations à développer, voici une intégration externe pour les ampoules, rubans LED et prises Wi-Fi Magic Home, pilotés en local.

Ce qu’elle fait

Elle amène dans Gladys les appareils des applications Magic Home Pro, Zengge ou Surplife : ampoules, contrôleurs de rubans, rubans adressables, guirlandes, prises. Tout reste sur le réseau local (transport local) : pas de compte, pas de cloud. Gladys trouve les appareils seule (recherche UDP 48899 via sa découverte réseau), puis l’intégration leur parle en TCP.

Gladys n’a pas d’intégration Magic Home native : plus besoin du pont MQTT (fil) ni de Matterbridge (fil).

Fonctionnalités

  • Appareils : marche/arrêt, luminosité, couleur et température de couleur selon le modèle ; les prises comme interrupteurs. Les changements faits à la télécommande remontent seuls sur la plupart des modèles.
  • 2 déclencheurs de scène : un appareil ne répond plus (après 30 s), un appareil répond à nouveau.
  • 4 actions de scène : effet intégré (23 au choix), jusqu’à 16 couleurs en boucle, clignotement puis retour à l’état d’avant, arrêt de l’effet.
  • 2 widgets : « Lumières Magic Home » (avec « Tout éteindre ») et « Effets Magic Home » (trois boutons d’effet au choix).

Exemples de scènes :

  • quand on sonne à la porte → faire clignoter la lampe du salon en rouge 5 secondes ;
  • quand la lumière du jardin ne répond plus → m’envoyer un message (coupée à l’interrupteur) ;
  • au coucher du soleil → ruban de la cuisine à 40 %, puis un fondu orange-rose sur le ruban du salon.

Widgets Lumières Magic Home et Effets Magic Home (illustration générée, pas une capture d'écran)

[Capture à venir : l’onglet Découverte avec une ampoule, un ruban et une prise]

Installation

  • Depuis le store : chercher « Magic Home ». Disponible dans la journée, le temps de l’indexation.
  • Ou depuis l’URL du dépôt : https://github.com/William-De71/gladys-magic-home.

Version minimale de Gladys : 5.1.1.

  1. Installer l’intégration en acceptant la découverte réseau (UDP 48899).
  2. Configuration : « Rechercher et tester les appareils ».
  3. Onglet Découverte : ajouter les appareils, puis les widgets et les scènes.

Limites connues

  • Protocole non documenté par le fabricant : je l’ai écrit d’après flux_led, qu’utilise Home Assistant. Pas encore testé sur de vrais appareils, seulement contre des appareils simulés avec des trames capturées sur du vrai matériel : vos retours sont précieux (avec le paramètre MAGICHOME_MODEL).
  • Non gérés : animations des rubans adressables et guirlandes, mode musique, minuteries, réglages des rubans.
  • Les interrupteurs à 2 ou 4 sorties sont vus comme un seul interrupteur ; les appareils joignables seulement par le cloud ne sont pas pris en charge.
Détails techniques
  • Un appareil par module, identifié par son adresse MAC : il est retrouvé après un changement d’adresse IP (recherche automatique toutes les heures, et dès qu’un appareil ne répond plus). Une adresse IP fixe reste conseillée.
  • Le protocole est choisi d’après le numéro de modèle et la version du firmware : protocole d’origine sans somme de contrôle, protocoles 8 et 9 octets, firmware 25 octets en HSV des ampoules récentes, trames encapsulées des rubans adressables.
  • Une seule connexion TCP par appareil créé (ils en acceptent peu, l’application en garde une) ; les appareils découverts mais non ajoutés ne restent pas connectés.
  • La température de couleur est en mired, comme Hue et Tasmota dans Gladys.
  • Les actions de scène ne déclenchent jamais de déclencheur (pas de boucle) ; une coupure de moins de 30 s ne déclenche rien.

Faire un retour

Par une issue GitHub ou en réponse à ce fil, avec la version de Gladys, la version de l’intégration et les logs