Sommaire
Le package Jeedom vous permet de contrôler vos équipements et vos scénarios Jeedom.
Cette documentation a été réalisé avec la version 1.0 du package Jeedom ainsi que la version 1.0 du plugin Constellation pour Jeedom.
Le code source est disponible sur https://github.com/myconstellation/constellation-packages/tree/master/Jeedom
Installation du package Jeedom
Depuis le “Online Package Repository” de votre Console Constellation, déployez le package Jeedom :
![clip_image002[4]](http://i.imgur.com/dftrTld.png "clip_image002[4]")
Une fois le package télécharger votre repository local, sélectionnez la sentinelle sur laquelle déployer le package.
Pour finir, sur la page de Settings vous devez obligatoirement spécifier l’adresse URL ainsi que la clé API de votre installation Jeedom sans le « http:// » :
![clip_image004[4]](http://i.imgur.com/D5VLHMX.png "clip_image004[4]")
Vous pouvez également déployer ce package manuellement dans la configuration de votre Constellation :
|
1 2 3 4 5 6 |
<package name="Jeedom"> <settings> <setting key="ServerUrl" value="192.168.1.20" /> <setting key="ApiKey" value="123456abcdef" /> </settings> </package> |
Détails du package
Les Settings
| Nom | Type | Détail | Description |
| ServerUrl | String | Obligatoire | Adresse IP de Jeedom |
| ApiKey | String | Obligatoire | Clé API de Jeedom |
Les StateObjects
Ce package ne comporte aucuns StateObjects.
Les MessageCallbacks
Le package expose 2 types de MessageCallbacks :
- SceneControl :
Ces Message Callbacks ne produisent aucunes réponses (saga).
| Nom | Champ scene_id | Description |
| Start | Id du scénario | Démarre le scénario |
| Stop | Id du scénario | Arrête le scénario |
| Activer | Id du scénario | Active le scénario |
| Desactiver | Id du scénario | Désactive le scénario |
- SendCommand :
Ces Message Callbacks ne produisent aucunes réponses (saga).
| Nom | Champ id | Champ value | Champ value2 | Description |
| Switch | Id de l’équipement | Aucun | Aucun | Pour un équipement de type switch |
| Slider | Id de l’équipement | Valeur souhaitée | Aucun | Pour un équipement de type slider |
| Message | Id de l’équipement | Titre du message | Corps du message | Pour un équipement de type message |
| Color | Id de l’équipement | Couleur souhaitée | Aucun | Pour un équipement de type color |
Le plugin pour Jeedom (version 1.0)
Installation
Afin d’éviter de questionner Jeedom toutes les x secondes et pour obtenir les informations le plus rapidement possible, un plugin pour Jeedom a été développé.
Celui-ci vous permet d’envoyer toutes les informations d’un équipement quand une ou plusieurs informations de cet équipement se mettent à jour.
Le plugin peut être téléchargé à cette adresse : http://erwann.laville.free.fr/Jeedom/constellation.zip
Il vous suffit alors de l’extraire dans le dossier plugin de Jeedom. Une fois installé, vous pourrez l’activer dans la liste des plugins sur Jeedom :
Une fois activé, vous aurez accès à la configuration générale du plugin. Il vous faudra indiquer l’url de Constellation (sans le http), le nom de la sentinelle et la clé créditential associée au plugin.
Par la suite vous pouvez ajouter autant d’équipement que souhaités. Chaque équipement créé correspondra à un package différent sur Constellation. Le nom de cet équipement correspondra au nom du package.
Les StateObjects
Le plugin Constellation pour Jeedom envoi un SO par équipement ajouté dans le « package ».
Si vous ajoutez plusieurs commandes d’un même équipement dans le package, les informations de l’équipement seront envoyés au même package dans Constellation à chaque mise à jour de chaque commandes indiquées.
Par exemple dans mon équipement Zwave, je rajoute #[Salle de Bains][Wall Plug][Etat]# et #[Salle de Bains][Wall Plug][Puissance]#. Les informations de mon Wall Plug seront envoyés à Constellation si l’état ou si la puissance changent.
Pour le moment, les SO ont comme nom le chemin de l’équipement dans Jeedom, par exemple : [Salle de Bains][Wall Plug]
N’oubliez pas de rajouter dans Constellation la sentinel et le package, par exemple ici :
|
1 2 3 4 5 |
<sentinel name="Squeezebox" credential="Standard"> <packages> <package name="Zwave" /> </packages> </sentinel> |
Les Plugins compatiblent
Du fait du système utilisé (fonction listener) tous les plugins de Jeedom ne sont pas compatibles. Voici une liste non exhaustive des plugins Jeedom essayés :
| Nom du plugin | Compatible | Non compatible |
| BLEA | X | |
| Espeasy | X | |
| Agenda | X | |
| Monitoring | X | |
| RFXCom | X | |
| Zwave | X |
Bonjour et merci pour tout ce travail.
Je ne comprends pas bien ce qu’il faut mettre comme « clé créditential associée au plugin » du côté du plugin Constellation sur Jeedom ?
Merci pour ton aide.
Ok je me réponds à moi-même, j’ai pas mal avancé depuis hier.
Dans le pluging Constellation du côté Jeedom, il faut mettre la clé crédential associée à la sentinelle à qui on envoie les données.