Tutoriel UPnP. La liste des messages échangés entre le point de contrôle et les appareils présents est affichée au bas de la fenêtre.

Transcription

1 Ecole des Mines d Alès Christelle Urtado & Sylvain Vauttier Avril 2012 Tutoriel UPnP 1. Installation des binaires - Récupérer l archive binaries.zip sur le site (http://www.lgi2p.ema.fr/~vauttier/isn/). Les éléments proposés sont librement empruntés et adaptés depuis le projet cyberlink (http://www.cybergarage.org) - Décompresser l archive dans un répertoire de travail (Note : Eviter les noms de répertoires comportant des espaces. Ils peuvent générer des problèmes dans la gestion des chemins). - Chaque sous-répertoire propose un fichier run.bat permettant de lancer : o une horloge, o une machine à laver, o une lampe, o une télévision, o une climatisation, o une télécommande, o un point de contrôle générique. La télécommande permet de piloter les autres appareils (après détection de la présence des autres appareils, ce qui peut nécessiter un temps d attente). La télévision se comporte partiellement comme un point de contrôle. Elle est capable d afficher des informations sur les autres appareils (par exemple, la température de la climatisation). En cas de problème, tester la présence de Java sur la machine. Ouvrir un shell (cmd) et lancer la commande «java -version». En absence de réponse, Java n est pas installé. L installation d un JDK (requis pour le développement) résout le problème. 2. Utilisation du point de contrôle La liste des appareils détectés est affichée dans la colonne de gauche. La liste des messages échangés entre le point de contrôle et les appareils présents est affichée au bas de la fenêtre. La sélection d un appareil dans la liste permet d afficher ses caractéristiques (URL, type, fournisseur, ).

2 La liste des appareils est rafraîchie en permanence. Le bouton «Freeze» suspend le rafraichissement pour permettre une utilisation pratique des appareils. En développant le nœud correspondant à un appareil, il est possible d accéder à la liste des services et des variables d états contrôlables à distance. En développant le nœud correspondant à un service, on accède à la liste des opérations et des variables associées au service. Le développement d un nœud correspondant à une opération fait apparaître la liste de ses paramètres. La sélection d une variable permet de requérir sa valeur (bouton «Query»)

3 La sélection d une opération permet son invocation.

4 3. Téléchargement et installation d un environnement de développement Java (JDK) Sur le site d Oracle (http://www.oracle.com/technetwork/java/javase/downloads/index.html), télécharger un JDK ou le combiné JDK+Netbeans : - JDK version 7 - JDK version 6 - combinés en version 7 ou 6 A priori, les versions 6 et 7 sont équivalentes pour nos besoins. Seul le JDK est nécessaire à l exécution des programmes Java. NetBeans, l outil de développement, peut être installé séparément. Si un JDK est déjà présent sur la machine, télécharger uniquement NetBeans Java SE (http://netbeans.org/downloads/index.html)

5 A la fin du téléchargement, exécuter le programme d installation et suivre les étapes proposées (choix des emplacements, acceptation des licenses, ). 4. Utilisation de NetBeans Récupérer l archive contenant les codes sources (fichier sources.zip sur le site Décompresser l archive dans un répertoire de travail. Lancer NetBeans (à partir du bureau ou du menu «Démarrer»). Fermer la page de démarrage. Dans le menu Fichier, choisir «Nouveau projet».

6 Choisir la catégorie «Java», puis la création d un projet à partir de codes source existants («Java Project with Existing Sources»). Cliquer sur («Suivant»). Donner un nom au projet et cliquer sur («Suivant»). Définir la localisation du répertoire contenant les codes sources à réutiliser en cliquant sur «Ajouter un dossier» puis en sélectionnant un répertoire dans le navigateur : Le répertoire choisit doit correspondre à l un des répertoires de l archive des codes sources (ci-dessous, le répertoire contenant les codes source de la lampe) :

7 Cliquer sur «Terminer» pour obtenir la création du projet : Le projet apparaît dans le navigateur de l outil de développement. Il est possible de développer et d explorer son contenu :

8 La compilation/exécution du projet requiert l utilisation de bibliothèques externes (implantation d UPnP, parser XML, ). Sélectionner le nœud «Bibliothèques» et ouvrir le menu contextuel (clic-droit). Choisir l item «Ajouter un fichier JAR ou un dossier».

9 Choisir dans le répertoire de travail contenant les sources le répertoire «libs», contenant les librairies à utiliser : Exécuter le projet à l aide de la flèche verte située dans la barre d outils : A la première exécution, la classe principale, contenant la méthode principale («main») doit être définie. L outil suggère les classes principales possibles :

10 Créer des projets pour les différents appareils ou points de contrôle, pour pouvoir inspecter leur code. Lorsque plusieurs projets ont été créés, il faut sélectionner un projet principal pour définir celui qui est exécuté. Sélectionner un projet dans le navigateur. Ouvrir le menu contextuel et choisir l item («Définir comme projet principal»).