APNT-68 - Utilisation d'iTach avec VERA

Les adaptateurs IR iTach sont parfaits pour contrôler des appareils tels que les équipements audiovisuels (téléviseurs, lecteurs Blu-Ray, Home Cinéma) ainsi que tout appareil pouvant être commandé par signaux infrarouges (IR). Y compris les climatiseurs.

Ce guide explique comment utiliser les adaptateurs iTach avec les contrôleurs Z-Wave VERA Lite et VERA3 fonctionnant sous UI5.

Utilisation d'iTach avec VERA

Pour permettre à VERA d'utiliser les périphériques iTach, il est nécessaire de télécharger un plugin VERA, puis de créer des fichiers de périphérique pour chaque appareil IR que l'iTach devra contrôler.

Ce guide vous indique comment :

• Télécharger et configurer correctement le plugin VERA iTach (GC100)
• Créer les fichiers de périphérique pour chaque appareil à contrôler
• Ajouter les chaînes de commande IR iTach aux fichiers de périphérique
• Créer un périphérique VERA pour l'appareil
• Contrôler les fonctions de l'appareil à partir des scènes VERA

Étape 1 - Téléchargement des fichiers

Pour installer avec succès le plugin VERA iTach (GC100) et utiliser les périphériques iTach, plusieurs fichiers sont nécessaires. Afin de faciliter la démarche, nous les avons regroupés dans un fichier ZIP unique à télécharger.

Avant de poursuivre, téléchargez le fichier ZIP Vesternet iTach :

Vesternet iTach Files v2.0 (ZIP)

Le fichier ZIP comprend quatre fichiers que vous utiliserez tout au long de ce guide :

• I_GC100.xml - Fichier de mise à jour du plugin GC100
• D_Bose_Sounddock.xml - Fichier de description du périphérique (« Description », basé sur le Bose Sounddock 2)
• I_Bose_Sounddock.xml - Fichier d'implémentation du périphérique (« Implementation »)
• S_Bose_Sounddock.xml - Fichier de service du périphérique (« Service »)

Étape 2 - Installer et configurer correctement le plugin iTach/GC100

Le plugin iTach/GC100 permet d'utiliser et de configurer l'adaptateur IR iTach.

Installer le plugin GC100

• Dans l'interface utilisateur de VERA, accédez à l'onglet 'APPS', puis 'Install Apps'
• Recherchez 'GC100'
• Installez l'application ; elle apparaîtra ensuite dans l'onglet My Apps
• Dans l'onglet DEVICES, un nouveau périphérique GC100 apparaît
• Cliquez sur l'icône 'Clé à molette' du périphérique et accédez à l'onglet 'Advanced'
• Saisissez l'adresse IP de l'iTach (voir APNT-65 - Configuration de base et apprentissage iTach)
• Fermez la fenêtre du périphérique et cliquez sur le bouton rouge 'SAVE'
• Le périphérique GC100 doit désormais être visible dans l'onglet DEVICES de VERA

Figure 1 : Ajout de l'adresse IP de l'iTach au périphérique du plugin GC100

Plugin GC100 - Problème connu

Un problème connu a été identifié avec le plugin GC100 : les commandes IR sont envoyées deux fois.

La résolution s'effectue simplement en téléversant un fichier d'implémentation corrigé.

• Accédez à 'APPS' > 'Develop Apps'
• Dans la barre latérale gauche, cliquez sur 'LUUP Files'
• Cliquez sur le bouton 'Choose File' et sélectionnez le fichier I_GC100.xml (inclus dans le fichier ZIP Vesternet iTach)
• Cliquez sur 'Go'
• Une fois le téléversement terminé, redémarrez Luup
• Accédez à SETUP > Net & Wi-fi et cliquez sur 'Reboot'
• Laissez VERA redémarrer
• Le plugin GC100 est désormais correctement configuré et opérationnel

Figure 2 : Plugin GC100 configuré

Étape 3 - Créer et charger les fichiers du dispositif

Pour créer un appareil contrôlable par IR dans VERA, nous devons d'abord créer et modifier les fichiers de configuration de l'appareil.

Cet exemple repose sur un ensemble de fichiers créés pour une Bose Sounddock ; ce guide présente les sections des fichiers XML à modifier pour votre équipement.

• Extrayez les fichiers .xml du fichier ZIP Vesternet iTach
• Renommez-les afin d'identifier l'appareil auquel ils se rapportent - par exemple « XYZ », « Yamaha RX675 », etc.
• Vous pouvez utiliser le nom de votre choix - pour la suite de ce guide, les fichiers seront désignés sous le nom Bose_SoundDock.

Modifier le fichier Service (fichier S_)

Le fichier S_Bose_SoundDock.xml constitue le fichier « Service » de l'appareil IR ; il régit les actions de l'équipement. Dans le cas présent, nous définirons les actions IR pouvant être déclenchées par les commandes IR de l'iTach.

• Ouvrez le fichier S_Bose_SoundDock.xml dans un éditeur de texte ou HTML
• Vous trouverez une balise < actionList > à la ligne 7, suivie de plusieurs balises < action >
• Celles-ci renvoient à des balises < action > similaires dans le fichier I_Bose_SoundDock.xml qui contiennent les codes IR effectifs pour piloter l'équipement
• Dans le fichier S_Bose_SoundDock.xml, modifiez ces noms, supprimez ceux qui sont inutiles ou ajoutez-en de nouveaux
• Pour cet exemple, deux commandes seulement étaient requises pour la SoundDock - Bose Play et Bose Off
• Pensez à enregistrer les modifications une fois terminé
• Le fichier S_Bose_SoundDock.xml final est présenté sur la Figure 3

Figure 3 : Fichier de dispositif S_Bose_SoundDock.xml

Modifier le fichier Implementation (fichier I_)

Le fichier I_Bose_SoundDock.xml constitue le fichier « Implementation » de l'appareil IR ; il contient les actions et les codes IR qui commanderont l'équipement.

• Ouvrez le fichier I_Bose_SoundDock.xml dans un éditeur de texte ou HTML
• Vous trouverez une balise < actionList > à la ligne 3, suivie de plusieurs balises < action >
• Elles contiennent les codes IR qui seront transmis lors du déclenchement de chaque action
• Renommez le < serviceId > avec un identifiant lié à l'équipement - < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
• Remarque : le même < serviceId > est utilisé pour toutes les actions du fichier I_Bose_SoundDock.xml
• Modifiez la balise < name > pour qu'elle corresponde à la description de l'action - < name >Bose Play < /name >

Il est recommandé d'ajouter une première action ainsi que son code IR, puis de la tester dans VERA avant de finaliser l'ensemble du fichier I_SoundDock.xml.

Figure 4 : Fichier de périphérique I_Bose_SoundDock.xml avec le code IR mis en évidence

Modifier la description (fichier D_)

Le fichier D_Bose_SoundDock.xml est le fichier de « Description » du périphérique IR ; il contient toutes les informations relatives au périphérique IR. Vous devez ajouter les descriptions principales du périphérique ainsi que les liens vers les fichiers Implementation et Service.

Étape 4 - Créer le périphérique IR

Vous pouvez maintenant créer un équipement VERA qui utilisera les fichiers que vous venez de générer. Cet équipement constituera un « équipement virtuel » de l'appareil réel, vous permettant de contrôler ses fonctions à partir des scènes VERA.

• Accédez à « APPS » > « Develop Apps »
• Dans la barre latérale gauche, cliquez sur « Create Device »
• Saisissez le nom de fichier « D_Bose_SoundDock.xml » dans le champ Upnp Device Filename
• Cliquez sur « Create Device »

Figure 6 : Créer l'équipement IR dans VERA

• Le nouvel équipement apparaîtra dans l'onglet DEVICES, mais sa configuration ne sera pas finalisée
• Cliquez sur le bouton bleu « RELOAD » de VERA (en haut de la page) et attendez le rechargement du système
• L'équipement doit désormais afficher le « friendlyName » défini dans le fichier « Device Description »
• Dans l'onglet Advanced de l'équipement, vérifiez la présence du fichier Description adéquat (D_Bose_SoundDock.xml) et du type d'équipement (urn:schemas-micasaverde-com:device:IrDevice:1)
• Si ces champs ne sont pas renseignés, cliquez à nouveau sur le bouton « RELOAD » et attendez le rechargement de VERA
• La dernière étape consiste à configurer l'équipement avec le port IR iTach approprié – iTach dispose de trois ports IR ; pour cet exemple, nous utilisons l'IR Blaster (port 3) – voir APNT-65 - Configuration de base et apprentissage iTach
• Accédez à l'onglet « Settings » de l'équipement et sélectionnez le port adéquat dans le menu déroulant
• Fermez l'équipement et cliquez sur le bouton rouge « SAVE » (en haut de la page)
• Une fois le rechargement de VERA terminé, l'équipement est prêt pour les tests

Figure 6 : Sélectionner le port IR approprié pour l'équipement

Étape 5 - Tester l'équipement IR

Il convient à présent de tester le nouvel équipement et de valider son bon fonctionnement.

• Dans votre navigateur, saisissez http://VERAs_IP_address:3480/data_request?id=lu_invoke – remplacez « VERAs_IP_address » par l'adresse IP de votre unité VERA
• Cliquez sur l'équipement dans la liste – par exemple #200 Bose SoundDock
• La liste des commandes disponibles s'affiche
• Assurez-vous que l'émetteur/blaster IR de l'iTach est correctement positionné devant l'appareil
• Cliquez sur l'une des actions dans le navigateur – l'appareil doit alors exécuter l'action demandée
• En cas de dysfonctionnement, vérifiez les fichiers de l'équipement, corrigez-les et téléversez-les de nouveau

Figure 7 : Navigateur affichant la liste des actions disponibles pour l'équipement IR

Étape 6 - Intégrer l'équipement IR dans des scènes

Les actions de l'équipement étant désormais opérationnelles via iTach, vous pouvez utiliser les scènes VERA pour piloter les fonctions de l'appareil.

Pour ce faire, utilisez l'onglet Advanced Scene de VERA

• Créer une nouvelle scène - voir APNT-34 : Création de scènes dans VERA
• Accédez à l'onglet « Advanced » de la scène
• Sélectionnez le dispositif IR Appliance dans le menu déroulant « Pick a device »
• Cliquez sur « Add »
• Le dispositif est désormais ajouté à la scène
• Sélectionnez l'action dans le menu déroulant « Please select » à côté du dispositif
• Cliquez sur le bouton vert « Confirm changes » (en haut de la page)
• Cliquez sur le bouton rouge « SAVE » (en haut de la page)
• Vous disposez désormais d'une scène qui peut être déclenchée, programmée ou exécutée manuellement pour commander une ou plusieurs actions de l'appareil

Figure 8 : Utilisation du dispositif IR dans une scène

Ce guide est un peu long. Toutefois, après l'avoir réalisé une première fois, vous constaterez que la procédure est logique et vous pourrez configurer le prochain appareil commandé par iTach beaucoup plus rapidement.

Référence

Cette note d'application s'appuie sur des tests réalisés par Vesternet ainsi que sur de nombreuses contributions utiles des utilisateurs du VERA Forum, avec des remerciements particuliers aux membres du forum « a-lurker » et « konradwalsh ».

Informations connexes

• APNT-65 : Configuration de base et apprentissage de l'iTach
• APNT-66 : Utilisation de l'iTach avec le Fibaro Home Center
• APNT-34 : Création de scènes VERA
• APNT-35 : Contrôle des scènes VERA à l'aide d'un déclencheur
• APNT-36 : Programmation horaire des scènes VERA
• KB-35 : Différence entre les câbles émetteurs et blasters iTach
• KB-36 : Informations sur l'API iTach
• Téléchargements et documents Global Cache

Les adaptateurs IR iTach sont idéaux pour piloter des appareils audiovisuels (téléviseur, lecteur Blu-Ray, home cinéma) et tout équipement pouvant être commandé par signaux infrarouges (IR), y compris les systèmes de climatisation.

Ce guide explique comment utiliser les adaptateurs iTach avec les contrôleurs Z-Wave VERA Lite et VERA3 fonctionnant sous UI5.

Utilisation de l'iTach avec VERA

Pour permettre à VERA de piloter les dispositifs iTach, il convient de télécharger un plugin VERA, puis de générer des fichiers de dispositif pour chaque appareil IR à commander.

Ce guide détaille les étapes suivantes :

• Télécharger et configurer correctement le plugin VERA iTach (GC100)
• Créer les fichiers de dispositif pour chaque équipement à commander
• Ajouter les chaînes de commande IR iTach aux fichiers de dispositif
• Créer un dispositif VERA pour l'appareil
• Piloter les fonctions de l'appareil à partir des scènes VERA

Étape 1 - Télécharger les fichiers

Pour installer avec succès le plugin VERA iTach (GC100) et utiliser les appareils iTach, vous aurez besoin de plusieurs fichiers. Pour vous simplifier la tâche, nous les avons regroupés dans un seul fichier ZIP téléchargeable.

Avant toute chose, téléchargez le fichier ZIP Vesternet iTach :

Fichiers Vesternet iTach v2.0 (ZIP)

Le fichier ZIP contient quatre fichiers que vous utiliserez tout au long de ce guide :

• I_GC100.xml - Fichier de mise à jour du plugin GC100
• D_Bose_Sounddock.xml - Fichier de « Description » du périphérique (basé sur le Bose Sounddock 2)
• I_Bose_Sounddock.xml - Fichier d'« Implémentation » du périphérique
• S_Bose_Sounddock.xml - Fichier de « Service » du périphérique

Étape 2 - Installer et configurer correctement le plugin iTach/GC100

Le plugin iTach/GC100 vous permet d'utiliser et de configurer l'adaptateur IR iTach.

Installer le plugin GC100

• Dans l'interface utilisateur de VERA, accédez à l'onglet « APPS », puis à « Install Apps »
• Recherchez « GC100 »
• Installez l'application ; elle apparaîtra ensuite dans l'onglet My Apps
• Dans l'onglet DEVICES, un nouveau périphérique GC100 s'affiche
• Cliquez sur l'icône de clé à molette (« Wrench ») du périphérique et accédez à l'onglet « Advanced »
• Saisissez l'adresse IP de l'iTach (voir APNT-65 - iTach Basic Configuration and Learning)
• Fermez la fenêtre du périphérique et cliquez sur le bouton rouge « SAVE »
• Le périphérique GC100 doit maintenant apparaître dans l'onglet DEVICES de VERA

Figure 1 : Ajout de l'adresse IP de l'iTach au périphérique du plugin GC100

Plugin GC100 - Problème connu

Il existe un problème connu avec le plugin GC100 : il envoie les commandes IR deux fois.

Ce problème se résout facilement en téléversant un fichier d'« implémentation » corrigé.

• Accédez à « APPS » > « Develop Apps »
• Dans la barre latérale de gauche, cliquez sur « LUUP Files »
• Cliquez sur le bouton « Choose File » et sélectionnez le fichier I_GC100.xml (inclus dans le fichier ZIP Vesternet iTach)
• Cliquez sur « Go »
• Une fois le téléversement terminé, redémarrez Luup
• Accédez à SETUP > Net & Wi-fi et cliquez sur « Reboot »
• Laissez VERA redémarrer
• Vous disposez désormais d'un plugin GC100 correctement configuré et fonctionnel

Figure 2 : Plugin GC100 configuré

Étape 3 - Créer et téléverser les fichiers du périphérique

Pour créer un périphérique contrôlable par IR dans VERA, nous devons d'abord créer et modifier les fichiers de contrôle du périphérique.

Cet exemple s'appuie sur un ensemble de fichiers créés pour un Bose Sounddock ; ce guide met en évidence les sections des fichiers XML que vous devrez modifier pour votre équipement.

• Extrayez les fichiers .xml du fichier ZIP Vesternet iTach
• Renommez-les afin d'identifier facilement l'appareil auquel ils se rapportent — par exemple « XYZ », « Yamaha RX675 », etc.
• Vous pouvez utiliser le nom de votre choix — pour la suite de ce guide, je ferai référence aux fichiers sous le nom Bose_SoundDock.

Modifier le fichier de service (fichier S_)

Le fichier S_Bose_SoundDock.xml est le fichier de « Service » du dispositif IR ; il contrôle les actions de l'appareil. Dans ce cas, nous définirons les actions IR pouvant être déclenchées par les commandes IR iTach.

• Ouvrez le fichier S_Bose_SoundDock.xml dans un éditeur de texte ou HTML
• Vous trouverez une balise < actionList > à la ligne 7, et en dessous un ensemble de balises < action >
• Celles-ci font référence à des balises < action > similaires dans le fichier I_Bose_SoundDock.xml qui contiennent les codes IR réels permettant de contrôler l'appareil
• Dans le fichier S_Bose_SoundDock.xml, modifiez ces noms, supprimez ceux dont vous n'avez pas besoin ou ajoutez-en de nouveaux
• Pour cet exemple, seules deux commandes étaient nécessaires pour le SoundDock – Bose Play et Bose Off
• Pensez à enregistrer les modifications une fois terminé
• Le fichier S_Bose_SoundDock.xml final est présenté à la Figure 3

Figure 3 : Fichier de dispositif S_Bose_SoundDock.xml

Modifier l'implémentation (fichier I_)

Le fichier I_Bose_SoundDock.xml est le fichier d'« Implémentation » du dispositif IR ; il contient les actions et les codes IR qui contrôleront l'appareil.

• Ouvrez le fichier I_Bose_SoundDock.xml dans un éditeur de texte ou HTML
• Vous trouverez une balise < actionList > à la ligne 3, et en dessous un ensemble de balises < action >
• Celles-ci contiennent les codes IR qui seront transmis lorsque vous activerez chaque action
• Renommez le < serviceId > par un nom associé à l'appareil – < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
• Remarque : le même < serviceId > est utilisé pour toutes les actions dans le fichier I_Bose_SoundDock.xml
• Modifiez la balise < name > pour qu'elle corresponde à la description de son action – < name >Bose Play < /name >

Il est recommandé d'ajouter une action et son code IR, puis de les tester dans VERA avant de finaliser l'ensemble du fichier I_SoundDock.xml.

Figure 4 : Fichier de dispositif I_Bose_SoundDock.xml avec le code IR mis en évidence

Modifier la description (fichier D_)

Le fichier D_Bose_SoundDock.xml est le fichier de « Description » du dispositif IR ; il contient l'ensemble des informations relatives au dispositif IR. Vous devez y ajouter les descriptions principales du dispositif ainsi que les liens vers les fichiers d'implémentation et de service.

Étape 4 - Créer le dispositif d'appareil IR

Vous pouvez désormais créer un dispositif VERA qui utilisera les fichiers que vous venez de générer. Ce dispositif constituera un « dispositif virtuel » de l'appareil réel, vous permettant de contrôler ses fonctionnalités à partir des scénarios VERA.

• Allez dans 'APPS' > 'Develop Apps'
• Dans la barre latérale gauche, cliquez sur 'Create Device'
• Saisissez le nom de fichier 'D_Bose_SoundDock.xml' dans le champ Upnp Device Filename
• Cliquez sur 'Create Device'

Figure 6 : Créer le périphérique IR dans VERA

• Le nouveau périphérique apparaîtra dans l'onglet DEVICES, mais il ne sera pas encore entièrement configuré
• Cliquez sur le bouton bleu « RELOAD » de VERA (en haut de la page) et attendez le rechargement de VERA
• Le périphérique doit désormais afficher le « friendlyName » choisi dans le fichier « Device Description »
• Dans l'onglet Advanced du périphérique, le fichier de description approprié (D_Bose_SoundDock.xml) et le type de périphérique (urn:schemas-micasaverde-com:device:IrDevice:1) doivent être présents
• Si ces champs ne sont pas renseignés, cliquez à nouveau sur le bouton « RELOAD » et attendez le rechargement de VERA
• La dernière étape consiste à configurer le périphérique avec le port IR iTach approprié – iTach dispose de trois ports IR ; pour cet exemple, l'IR Blaster (port 3) est utilisé – voir APNT-65 - Configuration de base et apprentissage iTach
• Accédez à l'onglet « Settings » du périphérique et sélectionnez le port correspondant dans le menu déroulant
• Fermez la fenêtre du périphérique et cliquez sur le bouton rouge « SAVE » (en haut de la page)
• Une fois le rechargement de VERA terminé, le périphérique est prêt à être testé

Figure 6 : Sélectionner le port IR approprié pour l'appareil

Étape 5 - Tester l'appareil IR

Il convient maintenant de tester le nouveau périphérique et de vérifier son bon fonctionnement.

• Dans votre navigateur, saisissez http://VERAs_IP_address:3480/data_request?id=lu_invoke – remplacez « VERAs_IP_address » par l'adresse IP de votre VERA
• Cliquez sur l'appareil dans la liste – par exemple #200 Bose SoundDock
• La liste des commandes disponibles s'affiche
• Assurez-vous que le blaster/émetteur IR de l'iTach est positionné face à l'appareil
• Cliquez sur l'une des actions dans le navigateur – l'appareil doit exécuter l'action correspondante
• En cas de dysfonctionnement, vérifiez les fichiers du périphérique, corrigez-les et téléversez-les de nouveau

Figure 7 : Navigateur affichant la liste des actions disponibles pour le périphérique IR

Étape 6 - Utiliser l'appareil IR dans des scènes

Les actions du périphérique étant désormais opérationnelles via iTach, il est possible d'utiliser les scènes VERA pour commander les fonctions de l'appareil.

Pour ce faire, utilisez l'onglet Advanced Scene de VERA

• Créez une nouvelle scène – voir APNT-34 : Création de scènes dans VERA
• Accédez à l'onglet « Advanced » de la scène
• Sélectionnez l'appareil IR dans le menu déroulant « Pick a device »
• Cliquez sur « Add »
• Le périphérique est désormais ajouté à la scène
• Sélectionnez l'action dans le menu déroulant « Please select » à côté du périphérique
• Cliquez sur le bouton vert « Confirm changes » (en haut de la page)
• Cliquez sur le bouton rouge « SAVE » (en haut de la page)
• La scène peut désormais être déclenchée, planifiée ou exécutée manuellement pour commander une ou plusieurs actions de l'appareil

Figure 8 : Utilisation du périphérique IR dans une scène

Ce guide est un peu détaillé. Toutefois, après l'avoir réalisé une première fois, vous constaterez que la procédure est parfaitement logique et vous pourrez configurer le prochain appareil contrôlé par iTach bien plus rapidement.

Références

Cette note d'application s'appuie sur les tests menés par Vesternet ainsi que sur de nombreuses publications utiles rédigées par les utilisateurs du forum VERA Forum, avec des remerciements particuliers adressés aux membres « a-lurker » et « konradwalsh ».

Informations associées

• APNT-65 : Configuration de base et apprentissage iTach
• APNT-66 : Utilisation d'iTach avec Fibaro Home Center
• APNT-34 : Création de scènes VERA
• APNT-35 : Contrôle des scènes VERA par déclencheur
• APNT-36 : Programmation horaire des scènes VERA
• KB-35 : Différence entre les câbles émetteurs et blasters iTach
• KB-36 : Informations sur l'API iTach
• Téléchargements et documentation Global Cache

Activer la prise en charge du lecteur d'écran Pour activer la prise en charge du lecteur d'écran, appuyez sur Ctrl+Alt+Z. Pour en savoir plus sur les raccourcis clavier, appuyez sur Ctrl+barre oblique