Documentation du plugin SmartThings pour Jeedom

Le plugin permet de récupérer les emplacements, pièces et commandes de tous les appareils qui sont enregistrés et actifs sur son compte SmartThings.
Il récupère les informations des appareils depuis le cloud SmartThings, aucune communication directe vers l’appareil n’est réalisée.

Appareils compatibles

Tous les appareils affichés dans l’application SmartThings.
Les commandes générées et leurs traductions peuvent ne pas être complète pour l’instant. Pensez à fournir les infos brutes au développeur pour ajout de ces informations.
Actuellement voilà la liste des appareils testés et configurés ou en cours d’amélioration :

  • Lave-linge (Samsung OCF Washer)
  • Sèche-linge (Samsung OCF Dryer)
  • Réfrigérateur avec dongle (Samsung OCF Refrigerator)
  • TV (Samsung OCF TV)
  • Four (Samsung OCF Oven)
  • Climatiseur (Samsung Floor A/C et Samsung OCF Air Conditioner)
  • Lampe Bulb (c2c-rgbw-color-bulb)
  • Thermostat Netatmo (c2c-thermostat-bridge-1 et c2c-thermostat-heating-1)
  • SmartTag (SmartTag-Tag(BLE))
  • Harmony
  • eWeLink

Commandes générées

Commandes info

Les commandes info sont générées principalement en fonction des informations fournies par SmartThings sur cet appareil. Si la valeur est nulle, la commande n’est pas créée (la valeur ne remonte pas de l’appareil).
Le type et sous-type de la commande dépend, lui, de la documentation de SmartThings (capabilities) qui sont téléchargés en dur dans le plugin lors de la mise à jour du plugin. Cette documentation est disponible ici, elle est modifiée et corrigée par mes soins pour les besoins du plugin.

Une commande info Santé est créée lors de la synchronisation.
Elle remonte l’état de l’appareil (En ligne, Hors ligne).

Les autres commandes info dépendent de l’appareil.

Commandes action

Les commandes actions sont, elles, générées premièrement en fonction des commandes info précédemment créées, puis en fonction de la documentation de SmartThings (capabilities).
Il se peut qu’il y ait une dérive dans la documentation de SmartThings (par ex : numéro de chaîne qui apparaît en string au lieu de numeric). Pensez à me remonter ces dérives.

Une commande action Rafraîchir les infos est créée lors de la synchronisation.
Elle permet de lancer, en dehors du cron, manuellement une récupération des infos de l’appareil.

À ne pas confondre avec la commande Rafraîchir qui permet à SmartThings de forcer une demande d’informations directement à l’appareil. (certaines TV ne remontent les infos que lorsque SmartThings envoie cette commande)

En laissant la souris sur un équipement de la page générale du plugin, on peut rapidement voir les informations (nom, type, catégorie, santé…)

Configurer une commande

Depuis la page des commandes de l’équipement, on peut voir et modifier les informations servant à SmartThings en cliquant sur le bouton orange.

Cette page s’ouvre et indique des champs différents en fonction du type de commande.
En vert, tout bas de page, il y a les informations venant de SmartThings sur cette commande. (minimum, maximum, valeur possibles…)
En rouge, quand les capabilities ne sont pas sur votre Jeedom.

Page Configuration du plugin

La première configuration du plugin est documentée ici.

Les options avancées permettent de mettre à jour les capabilities en cas de modification, ajout, suppression.
Suite à la mise à jour, il faudra soit recharger la configuration ou synchroniser soit supprimer l’équipement puis synchroniser, pour que les changement soient pris en compte. Ce sera indiqué dans le changelog.

Générer l’ensemble des options permet d’avoir la liste complète des commandes de SmartThings (select).
La liste fournie par certains appareils ne coïncide pas avec la réalité de commande supportées.
Ça permet donc d’ajouter des commandes compatibles. Mais toutes ne sont pas forcément fonctionnelles du coup.
Exemple : une TV dit supporter uniquement HDMI1, alors que le port HDMI2 existe sur la TV.

Équipement

Chaque appareil peut fournir des informations sur chacun de ses modules s’il en a plusieurs.
Un four à deux cavités fournit les informations de chaque cavité et des informations globales.
Un réfrigérateur-congélateur peut fournir les informations de la partie réfrigérateur, de la partie congélateur et des informations globales.

Voici l’exemple d’un congélateur :

Il est possible de modifier le nom de l’appareil, sa pièce et son emplacement SmartThings ou de le supprimer de SmartThings directement sans passer par l’application. (si suppression de SmartThings OK, suppression de Jeedom également).

  • Le bouton Recréer les commandes permet de recréer les commandes infos/actions de l’appareil (en recréant toutes ses commandes ou en n’ajoutant que les manquantes). Cette option ne permet pas de créer les commandes action Rafraîchir les infos ou Santé (uniquement synchronisation).
  • Le bouton Infos brutes affiche l’arbre de l’appareil dans SmartThings. C’est à partir de ces informations que les commandes info/action sont créées et que les informations remontent dans Jeedom. En cas de problème avec une commande, ou pour l’ajout ou la modification d’une commande, pensez à copier cet arbre.
  • Le bouton Synchroniser les infos permet de récupérer les informations de base de l’appareil (type, catégorie) qui sont affichées dans le volet de droite.

Page Santé

La page santé remonte tous les équipements : leurs type, santé, statut, dernière communication, depuis… et date de création.

Dashboard

Depuis la page de l’équipement, on peut choisir le Widget équipement à afficher sur le dashboard.
Celui du core Jeedom ou celui de l’appareil, s’il existe.
Actuellement, il y en a pour le lave-linge, la télévision, le réfrigérateur, le sèche-linge, et les climatiseurs.

Sur ces widgets, l’image de l’appareil indique s’il est allumé (en couleur) ou éteint (noir et blanc).



Ici, le lave-linge est Hors ligne, il affiche donc l’image en noir et blanc.
Ici, le lave-linge est allumé.

Un widget de commande info binaire est disponible pour reprendre cette image.
Dans les paramètres optionnels, il faut indiquer :

  • la catégorie : #category# : Samsung OCF Oven. Il s’agit en fait du type de l’équipement.
  • la hauteur (peut être optionnel) : #height# : 90 par défaut.
  • la largeur (peut être optionnel) : #width# : 90 par défaut.

Une réflexion sur « Documentation du plugin SmartThings pour Jeedom »

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *