Eedomus et Hue

Documentation eedomus

Les ampoules Hue de Philips (http://www.meethue.com) sont constituées d'un bridge IP et d'ampoules LED RGB de couleurs (plusieurs formats de douilles existent).

Cette solution a l'avantage de disposer d'une API ouverte, facilitant l'interopérabilité avec d'autres solutions.

De ce fait, la Hue est naturellement pilotable par la box eedomus.

Sommaire

Paramétrage

Cliquez sur Configuration / Ajouter ou supprimer un périphérique / Ajouter un autre type de périphérique / Philips Hue / Créer

Vous devez ensuite renseigner l'adresse MAC de votre bridge Hue et cliquez sur le lien afin de récupérer votre jeton qui sera utilisée pour la communication entre la lampe et le bridge.

Nota: depuis janvier 2022, l'adresse MAC doit être utilisée à la place de l'adresse IP (pour les nouveaux modules ajoutés, sinon, il faut utiliser l'adresse IP).

Comment trouver l'adresse MAC ? Vous pouvez utiliser le scan intégré à eedomus : scan

Pour procéder, cliquez sur la "loupe" à côté des mots "Adresse MAC Bridge Philips Hue". Dans la fenêtre qui s'ouvre, cherchez la ligne avec Philips, l'adresse IP est à gauche, séparée par des ".", l'adresse MAC est au milieu avec des ":".

Un double clic sur la ligne va copier l'adressee MAC.

Cliquez ensuite sur le lien "Cliquez ici pour obtenir votre compte utilisateur Hue et vos identifiants lampes".

Une page s'ouvre, qui ressemble à la suivante.

Appuyez alors sur le bouton de votre bridge puis cliquez sur Confirm

Vous devez récupérer le jeton sur la page suivante, et le copier sur eedomus (comme ci-dessus).

Une fois cliquez sur validé, la box eedomus pourra communiquer vers le bridge.

Nota: l'utilisateur initial pouvait être choisi. A partir de 2016, c'est un jeton de type : 'XWKy6x2yLHA4RVNPKC0YcwXWKy6x2yLHA' qu'il faut recopier intégralement, suite à une mise à jour de sécurité réalisée par Philips Hue.

Les identifiants de vos lampes sont listés, utilisez celui que vous souhaitez piloter avec votre box eedomus.

Retournez sur le portail eedomus et cliquez sur Créer, votre lampe Philips Hue, peut maintenant être pilotée.

Personnalisation des couleurs

Des couleurs par défaut sont automatiquement créés pour le pilotage de votre lampe.

Si vous souhaitez les personnaliser, vous pouvez le faire de 2 manières:

  • en utilisant le sélecteur de couleur (bouton Couleur disponible dans l'onglet "Valeurs" de votre périphérique), mais la gestion des couleurs par la lampe nécessite des ajustements, la couleur obtenue ne ressemblera pas toujours à la couleur théorique.
  • en réglant la couleur de votre choix avec l'app Philips Hue, puis en attendant le polling suivant (par défaut 5min) pour voir la couleur au format RGB, vous pourrez alors ressaisir cette valeur dans la ligne de votre choix de l'onglet "Valeurs" puis cliquer sur le bouton Couleur ce qui aura pour effet de convertir la couleur au format "Hue / Sat" attendu par la Hue.

Info techniques

Le périphérique s'appuie sur 2 actionneurs HTTP pour piloter séparément la couleur et la luminosité de la lampe.

2 scripts eedomus sont automatiquement déployés sur la box, le 1er permet la création/vérification du compte utilisateur Hue, le 2nd permet le polling de la lampe (afin d'en détecter les changements d'états)

Par défaut, le "polling" se fait toutes les 5 minutes, en conséquence un changement d'état sur la lampe qui ne passerait pas par la box eedomus (ex. action directe depuis l'app Hue) mettra jusqu'à 5 minutes pour être vu par la box eedomus.

Ce délai peut être réduit, mais attention cela prendra plus de ressources à votre box eedomus.


Remarque : Lorsque vous éteignez une ampoule au niveau d'un interrupteur (donc que vous coupez le courant de l'ampoule), cette dernière va se rallumer au rétablissement du courant - en blanc !-, même si elle n'était pas allumée avant.

Droits de propriété intellectuelle

Les noms Philips, Hue, l'image en haut de page, le site meethue et la documentation de l'API Hue sont la propriété de Koninklijke Philips Electronics N.V. .

Les descriptifs, applications et méthodes d'interopérabilité proposés n'ont pas de lien avec la société Philips NV.

Pour aller plus loin

Découvrez les différentes manières d'avoir un Eclairage en couleur

Script

Cet objet connecté utilise un script déployé automatiquement sur votre box eedomus.

Méthode manuelle

Il existe une méthode manuelle décrite sur 

https://developers.meethue.com/develop/get-started-2/

pour récupérer le username à partir de la page : 

http://ADRESSE_IP_DE_VOTRE_BRIDGE_HUE/debug/clip.html (vous pouvez utiliser le scanner réseau de la box eedomus pour identifier l'IP)