1. Description

Le plugin Imperihome permet:
  • la mise à disposition d’une API "ISS" pour Imperihome (récupération des données de JeeDom et demandes d’actions)

  • l’utilisation de l’API Control d’Imperihome pour intéragir avec le logiciel Imperihome installé sur un périphérique (non intégré à l’heure actuelle)

Les informations sur ce logiciel ainsi que les API sont disponibles sur le site de l’éditeur:

2. Configuration

2.1. Plugin

L’activation du plugin nécessite un pré-requis: avoir renseigné la configuration réseau dans le menu Général → Administration → Configuration.

Celle-ci permet en effet au plugin de déterminer le chemin d’accès de l’API ISS qu’il faudra renseigner dans Imperihome.

Une fois le plugin activé (menu Général → Plugins → Imperihome), une section "Configuration" apparait.

A ce moment là, le plugin détermine automatiquement l’adresse à renseigner dans Imperihome:

Configuration du plugin

2.2. Configuration d’Imperihome

Sous imperihome, aller dans Paramètres → Mes Systèmes, puis Ajouter un système. Sélectionner "Imperihome Standard System", puis rentrer l’URL donnée par le plugin dans "URL de Base API Locale".

Si vous souhaitez accéder depuis l’exterieur, configurer également l’URL Externe en l’adaptant à votre installation.

Cliquer sur suivant et terminer. Si aucun équipement ne s’affiche, c’est normal pour le moment, il faut aller sélectionner quels équipements vous souhaitez remonter vers Imperihome.

2.3. Sélection des équipements à transmettre

Rendez-vous dans la page Plugins → Imperihome, puis dans l’onglet "Configuration ISS".

Configuration du plugin

Vous pouvez ici sélectionner les équipements à transmettre, et visualiser le type d’équipement automatiquement détecté.

Une fois les équipements sélectionnés, cliquer sur "Sauvegarder". Sous Imperihome, il se peut que l’équipement ne remonte pas immédiatement. Pour forcer la mise à jour, cliquer sur la double fléche rotative en haut à droite de l’écran sous Imperihome.

2.4. Détermination automatique du type d’équipement

Dans le mesure du possible, le plugin essaie de reconnaitre les équipements et de leur donner un type "Imperihome" adapté. En automatique, le plugin transforme les commandes de type "info" en un équipement.

Si on prend en exemple une prise de courant télécommandée et qui remonte les informations de consommation, celle-ci aura deux commandes de type "info": Etat et Conso.

Le plugin va alors créer 2 équipements: un de type "devSwitch" (pour Etat) et l’autre de type "devElectricity" pour Conso.

2.5. Détermination manuel du type d’équipement

!! Attention: modifier le type d’un équipement alors que celui-ci est configuré dans Imperihome peut faire planter l’application.

!! Je vous recommande de supprimer l’équipement dans Imperihome avant de modifier son type dans Jeedom.

Pour accéder au mode avancé, il faut activer le Mode Expert de Jeedom. Un onglet "Mode avancé" est alors disponible.

Configuration du plugin

Vous retrouvez ici les équipements configurés manuellement.

Vous pouvez les modifier ou supprimer, ou en créer un nouveau.

Lorsque vous cliquer sur "Ajouter un équipement" ou Modifier, la fenêtre qui s’ouvre permet de configurer l’équipement.

Configuration du plugin

Il faut alors configurer la commande support: celle-ci correspond au nom de l’équipement qui s’affichera sur Imperihome.

Ensuite, il faut sélectionner le type d’équipement (se reporter à la doc Imperihome).

Ensuite, vous pouvez configurer chaque paramétre et action.

Configuration du plugin

Pour les paramètres, il faut soit rentrer manuellement une valeur, soit sélectionner une commande de type Info.

Pour les actions, il faut nécessairement sélectionner une commande de type Action.

Prenons l’exemple d’une prise télécommandée. Disons que sous Jeedom, elle possède deux commandes Info (Etat et Consommation) et deux commandes Action (Allumer et Eteindre).

Il faudra alors selectionner le type "Standard On/Off switch".

Puis:
  • paramètre Status: selectionner la commande Etat

  • paramètre Energy: selectionner la commande Consommation

  • action setStatus:

    • pour le 0: selectionner la commande Eteindre

    • pour le 1: selectionner la commande Allumer

Sauvegarder la configuration, puis réactualiser la liste des équipements sous Imperihome.

Il y a une subtilité pour le type MultiSwitch et son action SetChoice. Si une commande est renseignée, alors elle sera appelée en lui passant comme paramètre la valeur sélectionnée dans Imperihome. Si aucune commande n’est renseignée, alors le plugin recherchera une commange ayant comme nom la valeur sélectrionnée dans Imperihome au sein du même équipement que la commande support.


3. Détection automatique

3.1. Explication

Le système de détection automatique se base sur un certains nombre de critère afin de déterminer le type le plus adapté à Imperihome.

Ci-dessous, vous trouverez les différents critères pour pouvoir avoir une détection optimale.

3.2. Définition des critères

3.2.1. Actionneurs

Interrupteur [DevSwitch]
Conditions:
  • La commande est de type Binaire et il y a des commandes de type Action dans l’équipement

ou
  • Il s’agit d’une commande de type Action

Variateur de lumière [DevDimmer]
Conditions:
  • Le widget de la commande est "Light"

ou
  • La commande est de type Numeric et a comme unité "%" ainsi que des commandes de type Action dans l’équipement

Serrure [DevLock]

Pas de détection automatique sur ce type. Utiliser le mode avancé.

Lampe RGB [DevRGBLight]
Conditions:
  • Il existe au moins une commande de type Couleur dans l’équipement

Volet [DevShutter]
Conditions:
  • La commande est liée au plugin Store

  • Le widget de la commande est "Store"

3.2.2. Détecteurs et Capteurs

Capteur de CO2 [DevCO2]
Conditions:
  • Le type de la commande est "Binaire" et le nom de la commande contient "Fumée" ou "Smoke"

ou
  • La commande est de type Numeric et a comme unité "ppm"

Détecteur de CO2 [DevCO2Alert]
Conditions:
  • Le type de la commande est "Binaire"

et
  • Le nom de la commande est "Co"

Détecteur d’ouverture [DevDoor]
Conditions:
  • Le widget de la commande est "Door", "Baie", "Window" ou "Porte_garage"

ou
  • Le nom de la commande contient "Etat" et le nom de l’équipement est "Fenetre" ou "Porte"

Compteur d’énergie [DevElectricity]
Conditions:
  • La commande est de type Numeric et a comme unité "w" ou "kwh"

Compteur d’eau [DevFlood]
Conditions:
  • La commande est de type Numeric et a comme unité "m3"

Capteur d’humidité [DevHygrometry]
Conditions:
  • Le nom de la commande contient "Humidité"

Capteur de luminosité [DevLuminosity]
Conditions:
  • La commande est de type Numeric et a comme unité "lux"

Détecteur de mouvement [DevMotion]
Conditions:
  • Le widget de la commande est "Presence"

ou
  • La commande est liée au plugin Alarme

Capteur de bruit [DevNoise]
Conditions:
  • La commande est de type Numeric et a comme unité "dB"

Capteur de pression [DevPressure]
Conditions:
  • La commande est de type Numeric et a comme unité ""

Capteur de pluie [DevRain]
Conditions:
  • La commande est de type Numeric et a comme unité "mm/h" ou "mm"

Détecteur de fumée [DevSmoke]
Conditions:
  • Le widget de la commande est "Fire"

Capteur de température [DevTemperature]
Conditions:
  • La commande est de type Numeric et a comme unité "°C"

Capteur de température et humidité [DevTempHygro]
Conditions:
  • Le nom de la commande contient "Humidité"

et
  • Une commande du même équipement a comme unité "°C", et est indiquée comme "A Transmettre"

OU
  • La commande a comme unité "°C"

et
  • Une commande du même équipement a comme nom "Humidité", et est indiquée comme "A Transmettre"

Capteur d’UV [DevUV]
Conditions:
  • Le nom de la commande contient "UV"

Capteur de vent [DevWind]
Conditions:
  • La commande est de type Numeric et a comme unité "km/h"

3.2.3. Scénarios

Scénario [DevScene]
Conditions:
  • Il s’agit d’un scénario

3.2.4. Autres

Equipement générique [DevGenericSensor]
Conditions:
  • La commande est de type Numeric, a comme unité "%" et il n’y a pas de commandes de type Action dans l’équipement

ou
  • La commande est de type Binaire et il n’y a pas de commandes de type Action dans l’équipement

ou
  • Il n’a pas été possible de déterminer un autre type: type retourné par défaut

Caméra [DevCamera]
Conditions:
  • La commande est liée au plugin Caméra

Selecteur de choix [DevMultiSwitch]
Conditions:
  • La commande est liée au plugin Présence

ou
  • La commande est liée au plugin Alarme (sélection du mode)

Thermostat [DevThermostat]
  • La commande est liée au plugin Thermostat


4. Controle Imperihome

4.1. Controler un Imperihome via API

Il est possible de créer des équipements qui représentent des clients Imperihome, cela permet de les controler par api

Il est nécessaire de saisir l’adresse IP (avec le port) en configuration

Ensuite les commandes suivantes seront disponibles :

  • Lancer une page : ouvre une page sur l’imperihome, il faut saisir l’ID de la page dans le message

  • Lancer une camera : ouvre une caméra en plein écran, il faut saisir l’ID de la caméra dans le message

  • Lancer la reconnaissance vocale : fait passer Imperihome en reconnaissance Vocale

  • Lire un message TTS : lit le message envoyé, si un titre est saisi il doit être numérique de 0 à 100 et sera le volume en %

  • Réveiller : permet de réveiller la tablette/téléphone d’imperihome


5. FAQ

Ou trouver le lien à renseigner dans ImperiHome ?

Le lien de l’API a configurer dans Imperihome est donné dans la page de configuration.

L’équipement disponible dans Imperihome n’est pas du bon type

La configuration automatique utilise les types génériques qui sont paramétrables sur les commandes. La configuration automatique n’a pas fonctionné, il faut passer par le mode manuel: cf doc.