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)) => d’après le support SmartThings, ce n’est pas complètement opérationnel, 1 seule commande info peut remonter et aucune commande action ne fonctionne. Ajout de l’intégration de plusieurs commande. Sujet de discussion : https://community.jeedom.com/t/discussions-smarttag-et-smarttag/63972
  • Arlo Vidéo Doorbell (AVD1001A)
  • Caméra et sonnette vidéo (à tester et me remonter svp)
  • 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.

Page Historique

Cette page est accessible depuis la page des équipements et depuis chaque équipement (filtré à l’équipement en question).
Elle remonte les 50 dernières notifications de SmartThings avec la commande associée, la valeur et la date de l’évènement.
Les traductions en français peuvent être folkloriques, elles proviennent de SmartThings.

Page Notifications

Cette page est accessible depuis la page des équipements et depuis chaque équipement (filtré à l’équipement en question).
Elle remonte toutes les notifications envoyées à l’App SmartThings.
Celles générées depuis la commande action de l’équipement Location seront elles aussi listées ici.

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, le sèche-linge, la télévision, le réfrigérateur, le four et les climatiseurs.

Ces widgets sont séparés en 2 pages permettant d’afficher de manière ordonnées les informations et actions.
Si les informations sont disponibles, le widget les affichera.
Il est possible, depuis la page des commandes de décocher Afficher sur la commande qu’on ne souhaite pas afficher.

Le couleurs s’adaptent en fonction du thême Jeedom (dark, legacy).

Les widgets sont redimensionnables (3 tailles possibles) :

Lave-linge

  • La santé (info),
  • le bouton rafraichissement des infos via le cron (action),
  • le bouton d’envoi de commande rafraichissement forcé (action),
  • le logo coloré si actif, en noir et blanc si inactif (info),
  • si un lavage est en cours (programme en cours, temps restante, et date de fin) (info),
  • l’état de la machine (info+action),
  • le cycle actuel (info+action),
  • la température de lavage (info+action),
  • le nombre de cycles de rinçage (info+action),
  • la vitesse d’essorage (info+action),
  • l’état du lavage à bulles (info+action),
  • le controle à distance (info),
  • les informations générales de l’appareil (nom, type, catégorie, fabricant) (info),
  • les dates relevées par SmartThings (info),
  • les statistiques d’utilisation : nombre de lancement depuis 1 semaine, 1 mois, 1 an et la durée des lancements (info),
  • la consommation totale et le graphique sur 1 mois, affichant par jour la consommation en Wh.

Séche-linge

A l’instar du lave-linge, le sèche-linge fournit les mêmes informations et donc affichera les mêmes types d’informations. Je vous mets les informations qui divergent :

  • cycle de séchage (info+action),
  • vitesse de séchage (info+action),
  • cycle auto de séchage (info+action),
  • prévention des faux-plis (info+action),

Réfrigérateur

  • La santé (info),
  • le bouton rafraichissement des infos via le cron (action),
  • le bouton d’envoi de commande rafraichissement forcé (action),
  • le logo coloré si actif, en noir et blanc si inactif (info),
  • un bloc par commande Température de refroidissement (température actuelle, consigne et bouton +/-) (info+action),
  • un bloc commande Contact (état de la porte) avec date de valeur (:hover) (info),
  • un bloc par commande action on/off (dégivrage, surgélation, refroidissement rapide, machine à glaçon…) (info+action),
  • les informations générales de l’appareil (nom, type, catégorie, fabricant) (info),
  • les dates relevées par SmartThings (info).

Télévision

  • La santé (info),
  • le bouton rafraichissement des infos via le cron (action),
  • le bouton d’envoi de commande rafraichissement forcé (action),
  • le logo coloré si actif, en noir et blanc si inactif (info),
  • le bouton on/off (info+action),
  • source d’entrée (info+action),
  • mute/unmute (info+action),
  • sélecteur de volume et programme (info+action)

Four

Pour chacune des cavités, ici 3, le widget permet de sélectionner la cavité et de visualiser ses informations et actions.

  • La santé (info),
  • le bouton rafraichissement des infos via le cron (action),
  • le bouton d’envoi de commande rafraichissement forcé (action),
  • le logo coloré si actif, en noir et blanc si inactif (info),
  • un bouton par cavité disponible,
  • le bouton on/off (info+action),
  • une fenêtre modale mode (info+action),
  • sélecteur de température de cuisson (avec pas de 5) (info+action),
  • durée de cuisson (info),
  • un bouton stop (action),
  • le mode de four (info+action),
  • l’état de la machine (info),
  • l’état de la cavité (info),
  • la température actuelle (info),
  • l’état de la porte (info),
  • 2 bouton ouvrir et fermer la porte (action),
  • le controle à distance (info),
  • la page d’informations est identiques aux autres widgets.
  • la fenêtre modale qui permet de choisir mode + température et durée de cuisson. (à tester svp)

Climatiseur

Le logo dépend du type de climatiseur.

  • La santé (info),
  • le bouton rafraichissement des infos via le cron (action),
  • le bouton d’envoi de commande rafraichissement forcé (action),
  • le logo coloré si actif, en noir et blanc si inactif (info),
  • le bouton on/off (info+action),
  • sélecteur de consigne de température (info+action),
  • le mode de climatisation (info+action),
  • le mode d’oscillations (info+action),
  • la vitesse du ventilateur (info+action),
  • la page d’informations est identiques aux autres widgets.

Caméra (sonnette vidéo)

  • La santé (info),
  • le bouton rafraichissement des infos via le cron (action),
  • le bouton d’envoi de commande rafraichissement forcé (action),
  • la batterie (info),
  • la détection de mouvement (info),
  • la détection de son (info),
  • le widget envoie la commande action ‘Démarrer le flux’ pour récupérer le lien du flux vidéo et démarrer la lecture dans les 30 secondes,
  • la page d’informations est identiques aux autres widgets.

Info binaire

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.

12 réflexions sur « Documentation du plugin SmartThings pour Jeedom »

  1. Bonsoir,

    Je constate que malheureusement le plugin n’est plus disponible sur le market jeedom…

    Message sur le store: Ce plugin est pour le moment privé ou exclusivement en beta. Vous devez attendre qu’il devienne public pour y accèder.

    pouvez-vous me faire un retour concernant cette situation par email merci

    1. Bonjour.

      Le plugin est en beta depuis le début.
      Rien n’a changé sur le market.

      Il faut autoriser les plugins beta depuis le compte market pour y avoir accès.

      Cdt.

      1. Bonjour,

        Erreur de ma part en effet. Merci 🙂

        J’ai une autre question, j’ai bien installer et récupérer mes équipements. J’ai constater que même mon samsung smart tag est bien pris en charge. Cependant les commande semble “limité” est-il possible d’intégrer la commande permettant de faire sonner le TAG depuis jeedom ? Sauf erreur de ma part la documentation n’en parle pas.

        Merci à toi

    1. Bonjour.

      Les commandes info et action de chaque appareil sont créées en fonction de la valeur de l’information (info brute).
      Si l’information est null, la commande info n’est pas créée et donc sa commande action non plus.

      Dans la dernière mise à jour du plugin, j’ai ajouté une option dans la page de l’appareil pour créer l’ensemble des commandes de cet appareil (énormément de commandes peuvent être générées qui ne fonctionnent pas).

      Dans la page équipement il y a maintenant une case à cocher « Créer toutes les commandes » pour créer absolument toutes les commandes liée à l’appareil.
      Une fois la case cochée, sauvegarder.
      Puis soit lancer une synchronisation, soit « Recréer les commandes » puis « Sans recréer les commandes mais en créant les manquantes ».
      Pour le SmartTag, il devrait y avoir 45 commandes au total (info et action)
      Il faut donc tester une à une les commandes, et supprimer manuellement celles inutiles pour ne garder que les principales qui fonctionnent.

      La commande pour faire sonner le Tag devrait être Alarme.

      1. Merci pour la réponse.
        J’ai bien réussi à créer toutes les commandes en suivant la procédure, mais aucune ne parvient à faire sonner le SmartTag.
        À noter, que je n’ai pas de concentrateur SmartThings, J’utilise mon téléphone (donc le Bluetooth) pour localiser et faire sonner le SmartTag.

          1. En effet, “My Devices” vide .
            J’ai juste “mon domicile ” dans My Locations

Laisser un commentaire

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