Le périphérique SmartThings pour eedomus permet de lire l'état du téléviseur Samsung (Tizen modèles de 2016+ avec l'interface SmartThings) et de passer des commandes via son API.
Il faut intégrer au préalable son téléviseur Samsung dans l'application SmartThings de Samsung, et récupérer un token avec l'ensemble des droits: (r:locations:*, w:customcapability, x:rules:*, r:customcapability, w:rules:*, w:installedapps:*, r:installedapps:*, r:schedules, w:deviceprofiles, r:rules:*, x:devices:*, l:devices, w:locations:*, x:locations:*, r:channels:*, r:deviceprofiles, w:invitations, l:installedapps, r:scenes:*, w:schedules, x:notifications:*, x:scenes:*, w:channels:*, r:invitations, r:drivers:*, r:devices:*, w:devices:*, w:drivers:*, r:apps:*, w:apps:*)
Voici le lien pour récupérer le token: https://account.smartthings.com/tokens
Attention bien sauvegarder ce token car il ne sera pas affiché de nouveau dans le site et vous en aurez besoin lors de l'installation du Plugin, il sera stocké dans [VAR1].
Cette version du Plugin permet de piloter plusieurs télévisions, il faut autant de créations que de TV Samsung à piloter.
Il faut récupérer le deviceId du téléviseur à piloter.
le deviceID apparait dans le lien du device affiché dans la colonne "Display Name". Il faut faire un click droit puis copier l'adresse du lien, ensuite le coller dans un éditeur de texte pour récupérer la chaine de caractère qui représente le deviceId (exemple: a0b1e44c-8352-491a-947a-ae41f3eb825f)
Le Plugin Philips TV est constitué de plusieurs devices un nom (capteur HTTP), un Marche/Arrêt (actionneur HTTP), un volume (actionneur HTTP), une chaîne (actionneur HTTP), une source (actionneur HTTP).
Lors de la création vous devez saisir:
Nom personnalisé si vous souhaitez le modifier au lieu de "TV Samsung avec SmartThings", spécialement si vous disposez de plusieurs TV Samsung à piloter. puis sélectionnez une Pièce. Il est recommandé de l'affecter à une pièce, pour retrouver les devices plus facilement.
Eventuellement saisir des Notes utilisateur.
Le token de SmartThings,
Le deviceId si vous l'avez récupéré avec le site de SmartThings, sinon laisser vide.
Enfin cliquer sur "créer" pour créer les 5 devices.
Vous allez retrouver:
Un device TV Samsung avec SmartThings qui affiche le nom du téléviseur.
Un device TV Samsung avec SmartThings-M/A avec 3 commandes et 2 états:
cde On
cde Off
cde Refresh
Un device TV Samsung avec SmartThings-volume permet de piloter le téléviseur avec 2 modes différents: volume mini, maxi, volume absolu, volume relatif (incréments 1 ou 5). Il permet aussi de mettre en Mute ou UnMute. Liste des 10 commandes et 67 états (57 masqués) :
cde Volume Min
cde Mute
cde UnMute
cde Volume Down (-1)
cde Volume Up (+1)
cde Volume 10
cde Volume 25
cde Volume 30
cde Volume 40
cde Volume 60
cde Volume Max
Un device TV Philips-source permet de sélectionner la source d'entrée du téléviseur. Liste des 8 commandes et 8 états:
cde EXT 1
cde HDMI 1
cde HDMI 2
cde HDMI 3
cde HDMI Side
cde Watch TV
cde VGA
cde YPBPR
Un device TV Samsung avec SmartThings-chaîne permet de sélectionner la chaine du téléviseur. Liste des 20 commandes et 18 états:
cde TF1
cde France2
cde France3 .../...
cde Gulli
cde chaine -
cde chaine +
Plusieurs images pour les chaînes sont disponibles dans le répertoire img du Plugin, afin de personnaliser les chaînes.
Un device TV Samsung avec SmartThings-source permet de sélectionner les sources disponibles.
Avec les paramètres:
VAR1 (obligatoire) contient le token de l'application SmartThings.
VAR2 (obligatoire) contient de deviceId.
Le script est lancé à la fréquence rapide (polling à 1 minutes, il est tout à fait possible de changer cette valeur).
POLLING=1.
Le fonctionnement du PLUGIN est le suivant:
Pour récupérer la liste des équipements, on passe le device "TV Samsung avec SmartThings" en mode test et on saisit en fin d'url: * &action=list * puis cliquer sur "tester".
1. Cette opération est effectuée 1 seule fois après la création du Plugin.
Elle va permettre de lister les équipements disponibles dans SmartThings et récupérer le deviceId.
2. Lorsque tout s'est déroulé correctement, la liste des équipements avec le deviceId est affichée.
Copier/coller cette valeur dans [VAR2].
Le nom de la télé doit s'afficher dans le device TV Samsung avec SmartThings, et le volume actuel dans le device TV Samsung avec SmartThings-volume, et ainsi de suite...
Ceci peut prendre jusqu'à 2 minutes car le Polling a été fixé à 1 min.
3. Le passage des commandes s'effectue au travers des devices TV Samsung avec SmartThings-volume, TV Samsung avec SmartThings-chaîne et TV Samsung avec SmartThings-source.
4. Mode debug et passage de commandes
Un mode debug est disponible en ajoutant &debug=1, en mode test à la fin de la "Requête de mise à jour :" http://localhost/script/?exec=smartthings.php&token=[VAR1]&device=[VAR2]&module=MasterData&debug=1.
Il faut passer en mode test en appuyant sur "tester", et les messages s'affichent dans la fenêtre XML.
Il est possible de passer des commandes, par exemple:
Mettre le volume à 25: http://localhost/script/?exec=smartthings.php&token=[VAR1]&device=[VAR2]&action=SET_VOLUME¶metre=25
Mettre en Mute: http://localhost/script/?exec=smartthings.php&token=[VAR1]&device=[VAR2]&action=MUTE