Ce plugin a pour objectif d'améliorer le support des produits Philips Hue pour la box eedomus.
Le plugin officiel permet de piloter les lumières en intensité et couleur.
Ce plugin rajoute le support des prises, boutons, détecteurs de présence, les groupes avec les scènes.
Il permet aussi de piloter les lumières avec un seul et unique capteur avec plus de possibilités.
Les produits listés ci-dessous ou ayant les même capacités sont supportées.
De manière générique, tous produits fonctionnant sur pile/batterie ont le niveau de la batterie qui est affiché dans eedomus.
Lors de l'installation du plugin, vous avez l'affichage de configuration des produits.
Les étapes à suivre sont (Attention, les étapes en italique ne sont qu'à faire à la première installation):
NB : Il est possible d'installer le mode debug ultérieurement. Se reporter à la rubrique 'Mode Debug'
Selon les produits, vous avez les capacités pour connaitres les états des produits et de les piloter.
Les comportements supportés sont présentes ci-dessus dans la rubrique "Produits et fonctionnalités".
Par défaut, vous avez un ensemble de valeurs (comportements) pour pilotes les lumières et les groupes.
Il est possible de rajouter des comportmements ou des couleurs selon vos envies (cf rubrique "Configuration avancée").
Les états des lumières sont:
Les états des groupes sont:
Remarques :
Lorsque les lumières sont en état streaming alors le groupe est vu comme Etient.
Si une lumière du groupe est allumée alors le groupe est vu comme Allumé.
Afin d'éviter de trop nombreux appels à l'API et de simplifier le code, je ne modifie pas ces comportements de l'API Philips Hue.
Un ensemble d'icone est disponible avec le plugin.
Il est possible de rajouter une icone pour une lumière de couleur spécifique en éditant l'image png et remplacer la couleur bleue par une autre couleur.
A vous de configuer les images selon vos besoins.
Si vous désirez les rajouter dans le plugin et les partager, merci de respecter le nommage actuel <type_lumière>_action.
Par exemple, hue_color_blue.png
Pour informations, les couleurs utilisés pour les icones:
Ce plugin fonctionne avec les API Philips Hue V1 et V2 selon les capacités et commandes executées.
Les comportements de type scene et effects ne supportent que le paramètre "bri" (ie brightness/intensité lumineuse) en complément.
La configuration des scènes se fait naturellement au travers de l'application mobile Philips Hue.
Pour les lampes colorées, il est donc possible de rajouter des valeurs de couleurs, saturation, intensité.
Pour les groupes de lumières, il est possible de rajouter des scènes.
Pour chaque type supportés, vous avez des valeurs par défaut qui présentent toutes les possibilités.
Les paramètres supportés pour l'url sont:
Exemples:
&on=true&hue=43690&sat=255&bri=255
: allume (on=true) la lumière en bleue (hue=43690) avec la saturation et intensité au maximum. &effects=candle&bri=10
: allume la lumière avec l'effet "candle" àvec l'intensité 10Attention, si vous utilisez la fonctionnalité de sélection des couleurs, celui-ci modifie la syntaxe des paramètres de l'url.
Vous pouvez l'utiliser afin de connaitre la valeur de la couleur "hue=XXX" mais vous devez ensuite mettre à jour les paramètres d l'url.
Par exemple, pour mettre la lumière en bleue, la section 'paramètres' est :
En plus des paramètres précedents, vous avez en plus le paramètre "scene=identifiant".
Ce paramètre active la scène avec la possibilité de définir l'intensité ("bri").
Afin de connaitre l'identifiant de la scène, il suffit de se reporter à l'affichage des produits connectés (étape 3 lors de l'installation de plugin).
Par exemple, &scene=ab1eef67-ac22-4f44-aa62-00000000&bri=2
.
Celui-ci n'est pas nécessaire et il sera utile en cas d'évolutions ou corrections pour des produits non testés. Le mode debug installe 2 capteurs:
L'adresse MAC du pont et la clé de connexion à l'API Philips Hue ne sont pas affichées afin de préserver les données sensibles.
Elles sont remplacées par ***.
https://github.com/yannc74/eedomusPhilipsHue_Plugin.