air - User contributions [en]

Extensions XBMC/Fiche Suivi

2014-03-27T00:03:34Z

Rebecca.Poustis: /* Dépôts Git */

= Suivi de l'avancement du projet =
[[Image:Gant_xbmc_previsionnel.png| Planning Prévisionnel |thumb|left|510px]]
[[Image:Gant_xbmc_final.png| Planning Effectif |thumb|right|550px]] 

==Sprint 1 (semaine 5) : 27 janvier au 2 février==

Lundi : 
*MPI et Séminaire 
Mardi :
*Choix du projet 
Mercredi : 
*Recherche documentaire sur les différentes technologies envisagées pour le projet 
Jeudi : 
*Définition des différentes tâches réalisables suite à nos recherches. 

==Sprint 2 (semaine 6) : 3 au 9 février==
'''Objectifs :''' 
*Ecrire le cahier des charges du projet afin de chiffrer la durée de chaque tâche et leur priorité 
*Etudier la réalisation de plugins sur XBMC et réaliser un ''HelloWord'' 
*Commencer les premières tâches décidées dans le cahier des charges 
Lundi : 
* MPI et Séminaire 
Mardi: 
*Finalisation du cahier des charges 
Mercredi : 
*Hue : Communication avec le système et découverte plugin XBMC 
*OpenHab : Création du plugin, étude approfondie d'OpenHab 
Jeudi : 
*MPI 
Vendredi : 
*Hue : Intégration à XBMC du code python, et configuration de l'interface de paramétrage 
*OpenHab : Récupération des Etages de la maison, et affichage dans XBMC 

==Sprint 3 (semaine 7) : 10 au 16 février==

'''Objectifs :''' 
*Extension OpenHab : Listes dynamiques des pièces de la maison avec sous menus dynamiques 
*Utilisation de l’algo de détermination de k couleurs dominantes (méthode basée sur k-means) 
*Extension Philips Hue : intégration de la synchronisation des lampes avec l’image à l’écran. Prise en compte de la vidéo 

Lundi : 
* MPI et Séminaire 
Mardi : 
*OpenHab : Recherche sur la navigation dans les menus et traitement des exceptions pouvant être générée. 
Mercredi : 
*OpenHab : Mise en place de la navigation dans les différentes pièces de la maison, et affichage dans le menu de l'ensemble des capteurs. Etude sur l'utilisation de label générique pour l'affichage des informations et des messages d'erreur. 
Vendredi : 
*OpenHab : Etude sur les techniques pour réaliser l'interface XBMC d'une pièce. Prototypage à l'aide d'une librairie python de l'affichage des capteurs. 

==Sprint 4 (semaine 8) : 17 au 23 février==

'''Objectifs :''' 
*Extension OpenHab : Récupération et modification des informations des différentes pièces de la maison
*Extension reflexive remote : Etude de l'existant et compréhension du code
*Extension caméra de surveillance : Intégration dans XBMC (interaction de l'utilisateur avec la caméra depuis l'interface)

Lundi : 
* Openhab : recherche affichage des labels à partir de fichier XML 
Mardi : 
* Openhab : gérer l'affichage des labels et de leurs valeurs, à partir du framework PyXBMCt (http://romanvm.github.io/PyXBMCt/) 
Mercredi : 
* Openhab : gérer l'affichage des labels et de leurs valeurs, mise en œuvre du framework dans l'interface 
Jeudi : 
* Openhab : finalisation de l'affichage des labels et de leurs valeurs, gestion des exceptions et tests du plugin 
Vendredi : 
* Reflexive remote : étude de l'existant
 

==Sprint 5 (semaine 9) : 24 au 28 février==
'''Objectifs :''' 
*Finalisation des plugins : nettoyage et restructuration du code
*Extension reflexive remote
*Intégration de NFC
*Re-priorisation des objectifs

Lundi : 
* Openhab : écriture de la doc
* Caméra : auto-configuration

Mardi : 
* OpenHab : Validation du plugin
* NFC : Compréhension de NFC et Android
* Caméra : Finalisation du plugin
* Re-priorisation des objectifs : rendez-vous avec N. Palix

Mercredi : 
* NFC : Intégration dans la remote
* Reflexive remote : Ecriture du cahier des charges
* Reflexive remote : Récupération du menu principal

Jeudi : 
* NFC : Ecriture d'un tag particulier pour lancer un menu de xbmc
* Reflexive remote : Intégration de OpenHab

Vendredi : 
* NFC : finalisation de l'application
* Reflexive remote : Finalisation, récupération de la liste des addons

==Sprint 6 (semaine 11) : 10 au 14 mars==
'''Objectifs :''' 
* Terminer la reflexive remote
** Récupérer le menu principal de XBMC sous forme de liste
** Ajouter Open Hab dans le menu principal
** Modifier la remote avec les nouveaux menus et les rendre dynamiques
** Déterminer le protocole de communication entre la télécommande et le serveur XBMC
** Gérer la navigation (afficher les listes ou exécuter les plugins)
** Rafraîchir automatiquement la télécommande lors de la sortie de veille, ou en appuyant sur un bouton

Lundi : 
* Ajout d'OpenHab dans le menu principal
* Début de l'étape 3: modifier l'interface de l'application selon l'entrée (si c'est une liste l'afficher, sinon lancer la télécommande)

Mardi : 
* Etape 3: suite

Mercredi : 
* Etape 3: suite

Jeudi : 
* Etape 3: fin

Vendredi : 
* Documentation de l'étape 3
* Documentation des dépôts BitBuckets pour les différents plugins
* Rédaction du dossier pour le Management de Projet Innovant

==Sprint 7 (semaine 12) : 17 au 21 mars==
'''Objectifs :''' 
* Terminer la reflexive remote
* Intégrer le plugin de reconnaissance vocale SARAH

Lundi :
* Documentation
* Suite Reflexive remote (Android + noyau)
Mardi :
* Suite Reflexive remote (Android + noyau)
* Etude du plugin SARAH
Mercredi :
* Suite Reflexive remote (Android + noyau)
* Début d'intégration du plugin SARAH
Jeudi :
* Fin de l'intégration de SARAH
* Suite Reflexive remote (Android + noyau)
Vendredi :
* Documentation et slides de la présentation
* Suite Reflexive remote (Android + noyau)

==Sprint 8 (semaine 13) : 24 au 27 mars==
'''Objectifs :''' 
* Terminer et tester la reflexive remote
* Finaliser toutes les extensions
* Terminer la documentation (poster, flyers, video, screencast, wiki, code)

Lundi :
* Ajout de fonctionnalités au plugin Philips Hue
* Création du poster et du flyer
* Fin du plugin Reflexive Remote

=Dépôts Git=

[https://bitbucket.org/xbmcproject Dépôt Bitbucket] 

[https://github.com/NicolasAfonso/xbmc/tree/jsonrpcextension XBMC modifié] 
[https://bitbucket.org/xbmcproject/xbmc-openhab-plugin Openhab Plugin] 
[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk Reflexive Remote] 
[https://github.com/NicolasAfonso/script.xbmc.hue.ambilight Ambilight Plugin] 
[https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon Dlink Addon] 

[http://1drv.ms/OVMkoB Lien] vers l'Installateur de notre version d'XBMC modifiée, avec l'ensemble des plugins développés, utilisés (SARAH) et ceux nécessaires à la bonne exécution du tout (plugins dépendants).

= Documents et liens annexes =

[[Media:CahierDesCharges.pdf | Cahier des charges]] 
[[Media:Rapport MPI - AFONSO BIANCO LARTIGUE MARTINEZ POUSTIS.pdf | Rapport Gestion et Management du Projet]]
Supports soutenance

Extensions XBMC

2014-03-27T00:03:26Z

Rebecca.Poustis: /* Ajouter de commandes vocales dans SARAH */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]]
 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]]
 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===
[[Image:XBMC_phillipsHue_demo.JPG|Visualisation d'ambilight|thumb|left|500px]]
[[Image:XBMC_SettingsPhilipsHueExtension.png|Configuration des settings|thumb|right|500px]]
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
[https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon/downloads/script.DLinkCameraXBMCAddon.zip script.DLinkCameraXBMCAddon.zip]

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

Bien que nous ayons essayé de rendre le plus générique possible notre plugin, nous avons été confronté au problème de non-standardisation des camera D-Link et de l'inexistence de documentation. Nous avons néanmoins essayé de rendre le plus aisé possible l'ajout de nouvelles caméras. Pour ce faire, il faudra isoler deux informations essentielles, qui sont spécifiques à un modèle de caméra :
* le nom du fichier xml de description : type [path sur serveur][nomfichier].xml
* l'url d'accès au flux vidéo sur la caméra

Ensuite les ajustements dans le code sont les suivantes :
- ajouter le choix de cette camera dans les settings du plugin. On ajoute une valeur dans la liste enum d'id "camera_id" dans le fichier settings.xml.

=== Aperçu ===

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]]
 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
* une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).
* une méthode GetCurrentListDisplayed qui permet d'obtenir la liste de menu actuellement affichée dans XBMC. Seuls les labels des items sont retournés. Si aucune liste n'est affichée (exécution d'un script, lecture de média, settings...), la méthode revoie une liste vide.
* une méthode NavigateInListItem qui génére un clic sur un item de la liste actuellement affichée à partir de son label placé en paramétre. Cette méthode vérifie si une liste est affichée et, si le paramétre apparait bel et bien dans cette liste. Dans les cas contraires, la méthode renvoie l'erreur InvalidParameter au client.

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]]
 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]]
 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://1drv.ms/OVMkoB lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

=Dépôts Git=

[https://bitbucket.org/xbmcproject Dépôt Bitbucket] 

[https://github.com/NicolasAfonso/xbmc/tree/jsonrpcextension XBMC modifié] 
[https://bitbucket.org/xbmcproject/xbmc-openhab-plugin Openhab Plugin] 
[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk Reflexive Remote] 
[https://github.com/NicolasAfonso/script.xbmc.hue.ambilight Ambilight Plugin] 
[https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon Dlink Addon] 

[http://1drv.ms/OVMkoB Lien] vers l'Installateur de notre version d'XBMC modifiée, avec l'ensemble des plugins développés, utilisés (SARAH) et ceux nécessaires à la bonne exécution du tout (plugins dépendants).

Extensions XBMC

2014-03-26T23:54:00Z

Rebecca.Poustis: /* Installation */

Extensions XBMC

2014-03-26T23:52:37Z

Rebecca.Poustis: /* Installation */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]]
 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]]
 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===
[[Image:XBMC_phillipsHue_demo.JPG|Visualisation d'ambilight|thumb|left|500px]]
[[Image:XBMC_SettingsPhilipsHueExtension.png|Configuration des settings|thumb|right|500px]]
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
[[https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon/downloads/script.DLinkCameraXBMCAddon.zip]]

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

Bien que nous ayons essayé de rendre le plus générique possible notre plugin, nous avons été confronté au problème de non-standardisation des camera D-Link et de l'inexistence de documentation. Nous avons néanmoins essayé de rendre le plus aisé possible l'ajout de nouvelles caméras. Pour ce faire, il faudra isoler deux informations essentielles :
* le nom du fichier xml de description : type [path][]

=== Aperçu ===

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]]
 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
* une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).
* une méthode GetCurrentListDisplayed qui permet d'obtenir la liste de menu actuellement affichée dans XBMC. Seuls les labels des items sont retournés. Si aucune liste n'est affichée (exécution d'un script, lecture de média, settings...), la méthode revoie une liste vide.
* une méthode NavigateInListItem qui génére un clic sur un item de la liste actuellement affichée à partir de son label placé en paramétre. Cette méthode vérifie si une liste est affichée et, si le paramétre apparait bel et bien dans cette liste. Dans les cas contraires, la méthode renvoie l'erreur InvalidParameter au client.

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]]
 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]]
 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://1drv.ms/OVMkoB lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T23:23:47Z

Rebecca.Poustis: /* Installation */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]]
 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]]
 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===
[[Image:XBMC_phillipsHue_demo.JPG|Visualisation d'ambilight|thumb|left|500px]]
[[Image:XBMC_SettingsPhilipsHueExtension.png|Configuration des settings|thumb|right|500px]]
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

Bien que nous ayons essayé de rendre le plus générique possible notre plugin, nous avons été confronté au problème de non-standardisation des camera D-Link et de l'inexistence de documentation. Nous avons néanmoins essayé de rendre le plus aisé possible l'ajout de nouvelles caméras. Pour ce faire, il faudra isoler deux informations essentielles :
* le nom du fichier xml de description : type [path][]

=== Aperçu ===

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]]
 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
*une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).
*une méthode GetCurrentListDisplayed qui permet d'obtenir la liste de menu actuellement affichée dans XBMC. Seuls les labels des items sont retournés. Si aucune liste n'est affichée (exécution d'un script, lecture de média, settings...), la méthode revoie une liste vide.
*une méthode NavigateInListItem qui génére un clique sur un item de la liste actuellement affichée à partir de son label placé en paramétre. Cette méthode vérifie si une liste est affichée et, si le paramétre apparait bel et bien dans cette liste. Dans les cas contraires, la méthode renvoie l'erreur InvalidParameter au client.

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]]
 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]]
 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://1drv.ms/OVMkoB lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T23:04:19Z

Rebecca.Poustis: /* Reconnaissance vocale */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]]
 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]]
 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===
[[Image:XBMC_phillipsHue_demo.JPG|Visualisation d'ambilight|thumb|left|500px]]
[[Image:XBMC_SettingsPhilipsHueExtension.png|Configuration des settings|thumb|right|500px]]
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

Bien que nous ayons essayé de rendre le plus générique possible notre plugin, nous avons été confronté au problème de non-standardisation des camera D-Link et de l'inexistence de documentation. Nous avons néanmoins essayé de rendre le plus aisé possible l'ajout de nouvelles caméras. Pour ce faire, il faudra isoler deux informations essentielles :
* le nom du fichier xml de description : type [path][]

=== Aperçu ===

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]]
 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]]
 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]]
 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon/downloads/script.DLinkCameraXBMCAddon.zip lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T23:03:41Z

Rebecca.Poustis: /* Télécommande */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]]
 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]]
 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===
[[Image:XBMC_phillipsHue_demo.JPG|Visualisation d'ambilight|thumb|left|500px]]
[[Image:XBMC_SettingsPhilipsHueExtension.png|Configuration des settings|thumb|right|500px]]
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]]
 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]]
 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]]
 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon/downloads/script.DLinkCameraXBMCAddon.zip lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T23:01:50Z

Rebecca.Poustis: /* Aperçu */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]]
 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]]
 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===
[[Image:XBMC_phillipsHue_demo.JPG|Visualisation d'ambilight|thumb|left|500px]]
[[Image:XBMC_SettingsPhilipsHueExtension.png|Configuration des settings|thumb|right|500px]]
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon/downloads/script.DLinkCameraXBMCAddon.zip lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T23:01:36Z

Rebecca.Poustis: /* Aperçu */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]]
 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]]
 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon/downloads/script.DLinkCameraXBMCAddon.zip lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T23:01:01Z

Rebecca.Poustis: /* Plugin Philips Hue */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]]
 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]]
 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]]
 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===
[[Image:XBMC_phillipsHue_demo.JPG|Visualisation d'ambilight|thumb|left|500px]]
[[Image:XBMC_SettingsPhilipsHueExtension.png|Configuration des settings|thumb|right|500px]]
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon/downloads/script.DLinkCameraXBMCAddon.zip lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:59:40Z

Rebecca.Poustis: /* Plugin OpenHab */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]]
 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]]
 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===
[[Image:XBMC_phillipsHue_demo.JPG|Visualisation d'ambilight|thumb|left|500px]]
[[Image:XBMC_SettingsPhilipsHueExtension.png|Configuration des settings|thumb|right|500px]]
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon/downloads/script.DLinkCameraXBMCAddon.zip lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:57:30Z

Rebecca.Poustis: /* Aperçu */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===
[[Image:XBMC_phillipsHue_demo.JPG|Visualisation d'ambilight|thumb|left|500px]]
[[Image:XBMC_SettingsPhilipsHueExtension.png|Configuration des settings|thumb|right|500px]]
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon/downloads/script.DLinkCameraXBMCAddon.zip lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:55:13Z

Rebecca.Poustis: /* Aperçu */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===
[[Image:XBMC_philipsHue_demo.jpg|Visualisation d'ambilight|thumb|left|500px]]
[[Image:XBMC_SettingsPhilipsHueExtension.png|Configuration des settings|thumb|right|500px]]

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[http://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon/downloads/script.DLinkCameraXBMCAddon.zip lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[https://bitbucket.org/xbmcproject/xbmc-remote-fork/downloads/RemoteReflexive.apk lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:46:42Z

Rebecca.Poustis: /* Plugin Philips Hue */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

===Aperçu===

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:40:37Z

Rebecca.Poustis: /* Principe de fonctionnement */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]]
 

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:38:49Z

Rebecca.Poustis: /* Aperçu */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera (auto configuration, récupération du flux video), la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon

2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====

Nous avons étendu l'API JSON-RPC du noyau XBMC :
- une méthode GetCurrentMainMenu qui permet de retourner l'état actuel de la barre de menu principal. Cet état est loin d'être statique, des nouvelles entrées peuvent apparaître (insertion d'un disque dans la machine où est installée le media center, activation d'une carte tuner TV) ou disparaître (demande explicite de l'utilisateur dans les paramètres d'un skin de ne pas afficher tel ou tel menu). De plus, il est inutile de renvoyer des menus ne contenant aucun média (on ne renvoie pas le menu vidéo si aucune n'est présente dans notre médiathèque).

====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:28:32Z

Rebecca.Poustis: /* Aperçu */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera, la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

L'installation du plugin :

1) Récupérer l'archive zip du plugin :
https://bitbucket.org/xbmcproject/script.dlinkcameraxbmcaddon
2) System -> Addons -> Install from ZIP file -> choose
script.dlinkcameraxbmcaddon.zip -> Validate

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[lien]]
 

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:27:40Z

Rebecca.Poustis: /* Installation */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera, la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
 
1) la version modifiée de XBMC téléchargeable sur ce [[lien]]
 
2) l'apk de la télécommande modifiée disponible sur ce [[lien]]
 

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:27:14Z

Rebecca.Poustis: /* Installation */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

L'idée de cet addon était de pouvoir utiliser XBMC pour lire le flux
video d'une caméra de surveillance. Notre plugin, donne à
l'utilisateur de choisir entre deux modèles cités. Au lancement du script,
si l'adresse IP de la caméra n'a pas été saisie par l'utilisateur, une
recherche du modèle selectionné s'exécute. Une fois le périphérique
repéré sur le réseau, le flux video est lu par le lecteur de XBMC via
l'adresse HTTP de celui-ci. Le recherche se base sur la recherche d'un
périphérique [http://en.wikipedia.org/wiki/Universal_Plug_and_Play UPnP]. Pendant la lecture, un overlay a été créé pour pouvoir contrôlé
via XBMC l'un des deux modèles de camera ([http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L]). Cela est rendu
possible car celles-ci disposent d'un serveur web interne accessible
directement sur le port 80, avec l'adresse attribuée dans le réseau
local. Les mouvements de la caméras lui sont donc adressés par des
requêtes HTTP.

=== Architecture logicielle ===

Le plugin dispose de 3 fichiers sources python:
* addon.py regroupe la classe Camera, la definition de l'overlay et le
script de lancement.
* resources/lib/camDriver.py regroupe les methodes pour interagir avec la camera.
* resources/lib/settings.py qui a pour but de récupérer les settings saisis par
l'utilisateur.

=== Installation ===

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :

1) la version modifiée de XBMC téléchargeable sur ce [[lien]]

2) l'apk de la télécommande modifiée disponible sur ce [[lien]]


==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:26:25Z

Rebecca.Poustis: /* Installation */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]). Celles-ci disposent d'un serveur web interne accessible directement sur le port 80, avec l'adresse attribuée dans le réseau local. On peut alors directement, par des requêtes

=== Architecture logicielle ===

=== Installation ===

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
1) la version modifiée de XBMC téléchargeable sur ce [[lien]]
2) l'apk de la télécommande modifiée disponible sur ce [[lien]]

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:25:48Z

Rebecca.Poustis: /* Installation */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]). Celles-ci disposent d'un serveur web interne accessible directement sur le port 80, avec l'adresse attribuée dans le réseau local. On peut alors directement, par des requêtes

=== Architecture logicielle ===

=== Installation ===

==== Ajout d'une nouvelle caméra ====

=== Aperçu ===
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====
Pour installer l'application Remote XBMC avec nos modifications, il suffit d'installer :
* la version modifiée de XBMC téléchargeable sur ce [[lien]]
* l'apk de la télécommande modifiée disponible sur ce [[lien]]

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:16:27Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]). Celles-ci disposent d'un serveur web interne accessible directement sur le port 80, avec l'adresse attribuée dans le réseau local. On peut alors directement, par des requêtes

=== Architecture logicielle ===

=== Installation ===

=== Aperçu ===
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:16:14Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]). Celles-ci disposent d'un serveur web interne accessible directement sur le port 80, avec l'adresse attribuée dans le réseau local. On peut alors directement, par des requêtes

=== Architecture logicielle ===

=== Installation ===

=== Aperçu ===
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

'''Interaction avec le noyau de XBMC :'''
 
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:15:50Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]). Celles-ci disposent d'un serveur web interne accessible directement sur le port 80, avec l'adresse attribuée dans le réseau local. On peut alors directement, par des requêtes

=== Architecture logicielle ===

=== Installation ===

=== Aperçu ===
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique
Image:xbmc_List_addons.png|Etape 2 : Liste des addons
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote
</gallery>

 
'''Interaction avec le noyau de XBMC :'''
[[Image:XBMC_remote_example.png|Diagramme de séquence]]

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:12:21Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==

=== Principe de fonctionnement ===

Nous avons été amenés à travailler sur des caméras de la marque D-Link (les modèles [http://www.dlink.com/fr/fr/support/product/dcs-5222l-pan-tilt-zoom-cloud-camera DCS-5222L] et [http://www.dlink.com/fr/fr/home-solutions/view/network-cameras/dcs-932l-day-night-cloud-camera DCS-932L]).

=== Architecture logicielle ===

=== Installation ===

=== Aperçu ===
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|200px
Image:xbmc_List_addons.png|Etape 2 : Liste des addons|200px
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages|200px
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces|200px
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote|200px
</gallery>

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:06:43Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

<gallery>
Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|200px
Image:xbmc_List_addons.png|Etape 2 : Liste des addons|thumb|200px
Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages|thumb|200px
Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces|thumb|200px
Image:xbmc_Remote.png|Etape 5 : Affichage de la remote|thumb|200px
</gallery>

 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T22:03:45Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'un plugin d'interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

Enfin, si le temps le permet, d'inclure, de tester voire d'implémenter d'autres extensions telles que :
* commande vocale d'XBMC
* commande gestuelle
* implémentation du profil UPnP Low Power
* suivi d'utilisateurs d'XBMC entre plusieurs instances du logiciel, et ce de manière automatique

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''

[[Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|200px]]
[[Image:xbmc_List_addons.png|Etape 2 : Liste des addons|thumb|200px]]
[[Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages|thumb|200px]]
[[Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces|thumb|200px]]
[[Image:xbmc_Remote.png|Etape 5 : Affichage de la remote|thumb|200px]]
 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T21:57:07Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'une interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''
 
[[Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|left|200px]]
[[Image:xbmc_List_addons.png|Etape 2 : Liste des addons|thumb|center|200px]]
[[Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages|thumb|right|200px]]
[[Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces|thumb|left|200px]]
[[Image:xbmc_Remote.png|Etape 5 : Affichage de la remote|thumb|right|200px]]
 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T21:54:05Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'une interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''
 
[[File:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|left|200px]]
[[File:xbmc_List_addons.png|Etape 2 : Liste des addons|thumb|left|200px]]
[[File:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages|thumb|left|200px]]
[[Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces|thumb|left|200px]]
[[Image:xbmc_Remote.png|Etape 5 : Affichage de la remote|thumb|left|200px]]
 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T21:53:05Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'une interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''
 
[[Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|left|200px]]
[[Image:xbmc_List_addons.png|Etape 2 : Liste des addons|thumb|left|200px]]
[[Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages|thumb|left|200px]]
[[Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces|thumb|left|200px]]
[[Image:xbmc_Remote.png|Etape 5 : Affichage de la remote|thumb|left|200px]]
 

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T21:51:31Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'une interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''
[[Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|right|800px]]
[[Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|left|200px]]
[[Image:xbmc_List_addons.png|Etape 2 : Liste des addons|thumb|left|200px]]
[[Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages|thumb|left|200px]]
[[Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces|thumb|left|200px]]
[[Image:xbmc_Remote.png|Etape 5 : Affichage de la remote|thumb|left|200px]]

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T21:51:07Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'une interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''
[[Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|left|800px]]
[[Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|left|200px]]
[[Image:xbmc_List_addons.png|Etape 2 : Liste des addons|thumb|left|200px]]
[[Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages|thumb|left|200px]]
[[Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces|thumb|left|200px]]
[[Image:xbmc_Remote.png|Etape 5 : Affichage de la remote|thumb|left|200px]]

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T21:48:33Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'une interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''
[[Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|left|200px]]
[[Image:xbmc_List_addons.png|Etape 2 : Liste des addons|thumb|right|200px]]
[[Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages|thumb|left|200px]]
[[Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces|thumb|right|200px]]
[[Image:xbmc_Remote.png|Etape 5 : Affichage de la remote|thumb|left|200px]]

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Extensions XBMC

2014-03-26T21:47:17Z

Rebecca.Poustis: /* Télécommande Android */

Cette page wiki se veut être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins, qui seront développés, vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'une interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de contrôler des caméras de surveillance D-Link
* Amélioration de la télécommande Android développée par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grâce à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveurs openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC, directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécessaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : http://bitbucket.org/xbmcproject/xbmc-openhab-plugin

===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/downloads/script.module.openhab_v1.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponibles sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==

===Présentation===

Nous sommes partis d'un plugin XBMC existant.

Code original :
https://github.com/cees-elzinga/script.xbmc.hue.ambilight

Ce plugin implémente le système [http://en.wikipedia.org/wiki/Ambilight Ambilight] pour les Philips Hue. Ce système capture les couleurs
dominantes de l'image du média en cours de lecture et les transmet aux
ampoules Hue. Ce qui améliore grandement l'immersion de l'utilisateur.

====Amélioration====

Nous avons voulu ajouter des effets d'ambiance lorsqu'il n'y a pas de
média en cours de lecture. Nous avons donc ajouté un mode
d'utilisation des lampes de Philips à savoir le changement de couleur
automatique de chaque lampe. Les couleurs sont aléatoires et
indépendantes pour chaque ampoule. L'utilisateur peut configurer ce
mode selon 3 paramètres : la luminosité, la saturation et
la fréquence de changement de couleur des ampoules.

===Principe de fonctionnement===
[[Image:XBMC_Hue_fonctionnement.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
L'utilisateur interagit avec les différentes options du plugin grâce aux
settings de celui-ci et sélectionne l'addon pour lancer le script.
La communication entre le plugin et le pont Hue est réalisée grâce à
l'[http://developers.meethue.com/ API Philips].

===Architecture logicielle===
[[Image:XBMC_Hue_archi.png|Fonctionnement plugin Phillips Hue|thumb|left|600px]] 
Le plugin dispose de 3 fichiers sources python: 
* default.py qui regroupe les fonctions de calcul de couleurs
dominantes d'ambilight, la classe Hue qui représente le pont Hue et
la boucle principale du script.
* resources/lib/tools.py définit les fonctionnalités de
communication avec les lampes. Dans ce fichier, sont implémentées
des fonctions telles que l'auto-recherche du pont sur le réseau,
les méthodes d'envoi des requêtes JSON.
* resources/lib/settingsAmbilight.py qui a pour but de récupérer
les settings saisis par l'utilisateur. 

===L'installation du plugin===
 
1) Récupérer l'archive zip du plugin : [https://github.com/NicolasAfonso/script.xbmc.hue.ambilight extension Philips Hue pour XBMC]

2) System -> Addons -> Install from ZIP file -> choose
script.xbmc.hue.ambilight.zip -> Validate

3) Configurer les plugins à souhait. Ne pas oublier de faire la
recherche automatique du pont Hue sur le réseau si vous ne connaissez
pas son adresse IP
 

== Plugin Caméra de surveillance ==
[[Image:OpenHab_video_Fonctionnement.png|Fonctionnement Plugin Video|thumb|left|600px]] 
 

== Télécommande ==
[[Image:XBMC_Telecommande_global.png| Fonctionnement Télécommande|thumb|left|600px]] 

=== Réflexivité ===
====Noyau====
====Télécommande Android ====
Modifications apportées à la [https://github.com/freezy/android-xbmcremote télécommande officielle] :

* Récupération dynamique du menu principal

* Récupération de la liste des addons

* Navigation dans les listes à l'intérieur des addons

'''Exemple d'application :'''
[[Image:xbmc_Menu_modifie.png|Etape 1 : Menu principal dynamique|thumb|200px]]
[[Image:xbmc_List_addons.png|Etape 2 : Liste des addons|thumb|200px]]
[[Image:xbmc_Openhab_floors.png|Etape 3 : Navigation dans les étages|thumb|200px]]
[[Image:xbmc_Openhab_rooms.png|Etape 4 : Navigation dans les pièces|thumb|200px]]
[[Image:xbmc_Remote.png|Etape 5 : Affichage de la remote|thumb|200px]]

=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui possède un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture. L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

[[Image:sarah-logo.png|Sarah|thumb|left|250px]]
 

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécessaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espace
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** Remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

File:Xbmc Remote.png

2014-03-26T21:45:30Z

Rebecca.Poustis:

File:Xbmc Openhab rooms.png

2014-03-26T21:43:48Z

Rebecca.Poustis:

File:Xbmc Openhab floors.png

2014-03-26T21:43:03Z

Rebecca.Poustis:

File:Xbmc List addons.png

2014-03-26T21:41:33Z

Rebecca.Poustis:

File:Xbmc Menu modifie.png

2014-03-26T21:34:06Z

Rebecca.Poustis:

File:Xbmc Menu origine.png

2014-03-26T21:28:24Z

Rebecca.Poustis:

Extensions XBMC

2014-03-26T21:27:08Z

Rebecca.Poustis: /* Télécommande Android */

Extensions XBMC

2014-03-26T10:35:52Z

Rebecca.Poustis:

Extensions XBMC

2014-03-26T09:27:57Z

Rebecca.Poustis: /* Présentation du sujet */

Cette page wiki se veux être une fiche de suivi interactive du '''projet "extensions XBMC"''' d'un groupe d'étudiants de la promotion RICM5 2014. Interactive, car nous suivons pour ce projet une méthodologie de type Agile. Revenez donc régulièrement consulter cette page pour suivre ses dernières évolutions, mises à jour et modifications ! Si le sujet de notre projet vous plaît, que vous avez des questions ou remarques, n'hésitez surtout pas à nous [mailto:xbmc_ricm5@googlegroups.com contacter] :)

=Présentation du sujet=

L'objectif de ce projet de 8 semaines est de créer de nouveaux plugins pour le [http://xbmc.org/ media center XBMC]. 
Les plugins qui seront développés vont permettre d'ajouter les fonctions suivantes :
* Réalisation d'un plugin de domotique basé sur [http://www.openhab.org/ OpenHab]
* Réalisation d'une interaction avec les lampes [http://meethue.com/ Philips Hue]
* Réalisation d'un plugin permettant de controler des caméras de surveillance D-Link
* Amélioration de la télécommande Android developpé par la "Team-XBMC" :
**Ajout d'un système permettant de rendre la télécommande réflexive
**Ajout d'une fonction NFC permettant de lancer de la musique (par genre ou album)

=L'équipe projet=

'''Team:'''
* Nicolas Afonso (Chef de projet)
* Jean-François Bianco
* Pierre Lartigue
* Elisa Martinez
* Rebecca Poustis

= Spécifications =
== Plugin OpenHab ==
Le but de ce plugin est de permettre aux utilisateurs de contrôler leur maison depuis une instance XBMC.
===Principe de fonctionnement===
[[Image:Openhab_plugin_principe.png|Fig 1 : Fonctionnement|thumb|left|800px]] 
L'utilisateur accède aux informations concernant son logement grâce à un plugin développé spécialement pour XBMC. Grace à celui-ci, l'utilisateur est en mesure de consulter et d'agir sur les l'états des objets connectés gérés par son serveur openHAB 
La communication entre le plugin et le serveur openHab est réalisée à l'aide de [http://github.com/openhab/openhab/wiki/REST-API l'API REST] disponible sur les serveur openHAB (la connexion utilisée est du type JSON-RPC). 

===Architecture logicielle ===
[[Image:Plugin_Openhab_archi.png|Fig 2 : Architecture Logicielle|thumb|left|600px]] 
Le plugin a été développé en Python. Son architecture est décomposée en 3 composants :
* Le premier est l'OpenHab API qui permet de communiquer simplement avec le serveur, et met à disposition les différents types d'objets disponibles dans un serveur openHab.
* Le second est le Framework [http://github.com/romanvm/PyXBMCt PyXBMCt] développé par Roman Miroshnychenko. Celui-ci permet de réaliser des interfaces graphiques pour XBMC directement en python.
* Le troisième est le composant principal. Il gère l'affichage et l'envoi des requêtes nécéssaires pour modéliser l'habitation dans XBMC.
 
Les sources sont disponibles sur le dépôt de sources suivant : https://bitbucket.org/xbmcproject/xbmc/src
===Installation===

====Plugin====
L'installation du plugin : 
1) Récupérer l'archive zip du plugin : [http://bitbucket.org/xbmcproject/xbmc-openhab-plugin/get/e94f369ef62d.zip openHab XBMC plugin] 
2) System -> Addons -> Install from ZIP file -> choose openHab_XBMC_plugin.zip -> Validate 

Configuration : 
Par défaut, le plugin utilise les valeurs suivantes :
* Adresse serveur : 127.0.0.1
* Port du serveur : 8080
* Nom du serveur : demo
* Id du serveur : demo
Ces valeurs sont modifiables dans les paramètres du plugin. 

====OpenHab====
Les détails concernant l'installation d'OpenHab sont disponible sur [http://github.com/openhab/openhab/wiki/Quick-Setup-an-openHAB-Server le wiki du projet openHab]. 

===Aperçu===
[[Image:Screenshot_xbmcOpenhab_1.png|Fig 3 : Accueil Add-on|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_2.png|Fig 4 : Vue Etages|thumb|center|600px]] 
[[Image:Screenshot_xbmcOpenhab_3.png|Fig 5 : Vue pièces|thumb|left|600px]][[Image:Screenshot_xbmcOpenhab_4.png|Fig 6 : Détails pièces|thumb|center|600px]] 

== Plugin Philips Hue ==
== Plugin Caméra de surveillance ==
== Télécommande ==
=== Réflexivité ===
=== NFC ===
Le module NFC ajouté dans la télécommande Android d'XBMC permet de lancer un artiste ou un type de musique. 

==== Principe de fonctionnement ====
[[Image:NFC_fonctionnement.png| Fonctionnement NFC |thumb|left|600px]] 

L'utilisateur à la possibilité de lire et d'écrire un TAG NFC depuis la télécommande d'XBMC. 

Les TAGs utilisés peuvent être configurés directement depuis la télécommande, qui posséde un lecteur NFC. La communication est réalisée avec [http://wiki.xbmc.org/index.php?title=JSON-RPC_API/v6 l'API JSON-RPC] disponible sur les instances XBMC. 

==== Architecture logicielle ====
[[Image:NFC_XBMC_archi.png| Fonctionnement NFC |thumb|left|600px]] 
L'activité NFCWriterActivity permet de lire et d'écrire les TAGs NFC. 
La classe NFCWriterController permet d'envoyer les requêtes de lecture au serveur XBMC. 
L'activité est lancée par la classe HomeController, lorsque l'utilisateur exécute l'activité NFC depuis le menu principal. Le mode lancé dans ce cas est le mode lecture.L'utilisateur doit approcher un TAG pour que celui-ci soit lu, et la lecture lancée. 
Le mode écriture peut être activé par l'utilisateur dans les menus musique et genre. 

Les TAG utilisent la technologie NDEF, et sont configurés de la façon suivante : 
'''Lecture album :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name
*Record 3 : Artist
*Record 4 : Year
 
'''Lecture genre de musique :''' 
*Record 0 : Type
*Record 1 : Id
*Record 2 : Name

==== Installation ====

==== Aperçu ====

== Reconnaissance vocale ==
S.A.R.A.H (Self Actuated Residential Automated Habitat) est un système de maison intelligente connectée à l'internet des objets.

Il permet notamment :
* reconnaissance vocale et gestuelle via fichiers XML
* reconnaissance faciale avec une Kinect
* reconnaissance des QRCodes

Les requêtes HTTP générées exécutent des scripts NodeJS pour l'interaction domotique ou la recherche d'information.

=== Fonctionnement ===

Lien vers la description complète : http://encausse.wordpress.com/s-a-r-a-h/s-a-r-a-h-architecture/

L'architecture de SARAH repose principalement sur un programme C# et un programme NodeJS :

Le programme C# :
* Ecoute et identifie des phrases, gestes ou qrcode via un fichier XML et génère une requête HTTP
* Répond à la requête et produit un retour vocal
Le programme NodeJS :
* Exécute un script en fonction de la requête HTTP reçue pour exécuter un programme ou chercher de l'information

=== Installation ===

==== Prérequis ====
Lien : http://domotique-info.fr/2014/02/sarah-installation-premiers-pas/
* Microsoft .NET 4.5
* Microsoft Speech Platform
* Speech Platform Runtime
* SDK Kinect (non nécéssaire pour la reconnaissance vocale)

==== Tutoriel ====
Lien du tutoriel : http://encausse.wordpress.com/2013/02/16/s-a-r-a-h-tutorial-plugin-xbmc/

* Télécharger l'archive (version actuelle: 3.1.4) http://encausse.wordpress.com/s-a-r-a-h/
* Extraire dans un dossier dont le chemin ne comporte pas d'espaces
* Dans le répertoire "plugins", créer un dossier "xbmc"
* Télécharger l'archive https://github.com/PasDeBol/Sarah-Plugin-Xbmc
* Copier le contenu du répertoire "plugins" de la nouvelle archive (excepté addonSarahAndXbmc.V1.0.zip) dans le dossier "/plugins/xbmc" précédemment créé
* Modifier le fichier xbmc.prop :
** remplacer "[FIXME]:[FIXME]" par "127.0.0.1:8077"
* Décompresser l'archive addonSarahAndXbmc.V1.0.zip présente dans "Sarah-Plugin-Xbmc-master/Sarah-Plugin-Xbmc-master/plugins"
* Copier le répertoire "sarah.addon" dans le dossier "addons" de XBMC

=== Configuration de XBMC ===
* System/Services/Webserver
** Autoriser le contrôle d'XBMC via HTTP
** Port : 8077
** Supprimer le nom d'utilisateur
** Supprimer le mot de passe
* System/Services/Remote control
** Tout autoriser
* System/System/Video output
** Mode fenêtré
* System/System/Audio output
** Play GUI Sounds : Never

* Vérification de la configuration
** "localhost:8077" doit vous rediriger vers l'interface d'XBMC
** "localhost:8080" doit afficher l'interface web de SARAH
*** Sur l'interface web cliquer sur l'icône "actualiser" du plugin XBMC -> icône "planète" (documentation) -> "Test de la configuration" et vérifier que tous les contrôles soient OK

=== Exécution ===
* Dans l'archive "WSRRelease314", lancer "Server_NodeJS.cmd"
* Lancer "Client_Microphone.cmd"
* Pour tester, dire "Sarah, il est quelle heure ?"
* Si Sarah répond, lancer XBMC
* Dire "Sarah, active le mode XBMC"
* À partir d'ici, toutes les commandes de Sarah sont utilisables (récapitulatif ici : https://github.com/PasDeBol/Sarah-Plugin-Xbmc/blob/master/info/liste%20compl%C3%A8te%20des%20commandes.txt)

=== Ajouter de commandes vocales dans SARAH ===
* Ouvrir le fichier "WSRRelease314/plugins/xbmc/xbmc.xml"
* Ajouter une ligne : <item>(1)<tag>out.action.action="(2)"</tag><tag>out.action.xbmc="(3)" </tag></item>
** (1) : la commande vocale que vous souhaitez utiliser (exemple: ferme l'application XBMC)
** (2) : l'action SARAH correspondant à votre commande

Projet biometrie-2013-2014

2014-03-17T13:52:22Z

Rebecca.Poustis: /* Serrure faciale */

Projet biométrie 2013-2014
= Présentation=
==Sujet==
Application android de serrure vocale et faciale.

Dépot git [https://github.com/thomasNDS/biometry-lock-facial-and-vocal]

==Technologies ==
* Android
* OpenCV
* Lium
* Eclipse
* git
=Sous projets =
== IHM ==
===Equipe===
* Walid
* Elisa
===Sujet ===
* Acquisition et comparaison de visages et voix avec la base de données
=== Technologies ===
* Utilisation de [http://developer.android.com/tools/sdk/eclipse-adt.html ADT]
=== Etapes ===
==== Interface générale ====
* Création d'une interface d'accueil (choix enregistrement ou identification)
==== Acquisition des données ====
* Interface globale pour l'acquisition de visage et de voix
** Ovale fixe sur l'écran pour centrer la tête de l'utilisateur
** Texte prédéfini à lire pendant l'acquisition faciale
** Prise de photos en rafale pendant la lecture
* Enregistrement dans la base de données de l'image et du fichier son
==== Identification ====
* Interface de sélection de profil
** Nom et Prénom
* Bouton de déconnexion

== Serrure vocale ==
===Equipe===
* Nicolas
* Morgan
* Lotfi
===Sujet ===
Serrure vocale :
* Enrôlement du locuteur
* Identification du locuteur
=== Technologies ===
* Utilisation de [http://www-lium.univ-lemans.fr/diarization/doku.php/welcome LIUM speaker]
=== Etapes ===
==== Enrôlement du locuteur ====
* Enregistrement de la parole du locuteur (création d'un fichier wav contenant la parole du locuteur)
* Transcription du fichier wav en mfcc [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
* Puis [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
==== Identification du locuteur ====
* Enregistrement de la parole du locuteur (récupération d'un fichier wav)
* Transcription du fichier wav en seg [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
* Identification du locuteur [http://www-lium.univ-lemans.fr/diarization/doku.php/speaker_identification lienLyum]

== Reconnaissance de visages ==
===Equipe===
* Rebecca
* Thomas
===Sujet ===
Serrure faciale :
* Ajout d'un individu dans la base de donnée
* Authentification d'un individus

=== Technologies ===
* Reconnaissance de visage avec OpenCV

=== Tâches ===
*Identification de la personne (authentification, identif sans connaissance, classe de rejet)
*BD : avec tous les visages (plusieurs photos par personne (10 avec la même position))
*Authentification
*Présentation de la personne, choix entre plusieurs profils, ok ou rejet
*2 phases : apprentissage et évaluation
*Algo : entrainement des modèles et évaluation
*Capture du visage + extraction des points d’intérêt (openCV)
*Tester rejet avec utilisateur sans profil
*Verifier centrage du visage
===Etapes===
*Regarder projet de l’an passé
*Tuto de openCV/Android
*Commencer application :
*Saisie d’image (prise photo + BD)
*Points d’intérêt (openCV ?)
*Authentification (entrainement et évaluation)
*Intégration avec IHM
*Multi-image (si simple)
*Identification avec rejet
*Identification sans rejet

===Tutoriel: installation du NDK et configuration avec Eclipse ===
* Téléchargement du NDK [http://developer.android.com/tools/sdk/ndk/index.html#Installing]
* Extraire le dossier
* Dans Eclipse : Window > Preferences > Android > NDK coller le path du lien vers le dossier d'installation
* Dans le projet : clic droit sur le projet > project properties > C/C++ Build > Tool Chain Editor et selectionné Android Builder en tant que builder.
* Tuto pour installer OpenCV [http://www.seneschal.fr/index.php/recherches/84-installation-android-et-opencv-pour-android]

=Projets des années passées =
* Reconnaissance faciale [http://air.imag.fr/index.php/PAGE_WIKI_ETUDIANTS_2012-13_RECONNAISSANCE_FACIALE]
* Reconnaissance de signatures [http://air.imag.fr/index.php/PAGE_WIKI_ETUDIANTS_2012-13_SIGNATURES]

=Avancement=
==Semaine 1==
* Constitution des groupes
* Prise en main du SDK android

==Semaine 2==
===Serrure faciale===
* Définitions des tâches
* Installation et configuration du SDK et connexion nos téléphones
* Installation et configuration du NDK android
* Installation de la librairie OpenCV pour android
* Etude des projets des années passées

===Serrure vocale===
* Définitions des tâches
* Installation et configuration du SDK
* Installation de [http://developer.android.com/tools/help/adb.html adb]
* Connexion des téléphones via adb

===IHM===

==Semaine 3==
===Serrure faciale===
* Configuration du système de gestion de version
* Premiers tests avec openCV
* Enregistrement d'images dans l'application en utilisant l'appareil photo

===Serrure vocale===

===IHM===

==Semaine 4==
===Serrure faciale===
* Recherche de projets similaires
* Etude de l'existant
* Test de l'application utilisant la comparaison de scènes

===Serrure vocale===

===IHM===

==Semaine 5==

===Interruption pédagogique===

==Semaine 6==
===Serrure faciale===
* Premier test de l'application utilisant HAAR
* Correction des bugs
* Configuration des environnements de développement

===Serrure vocale===

===IHM===

==Semaine 7==
===Serrure faciale===
* Finalisation de l'application
* Documentation sur les algorithmes
* Intégration avec les autres parties
* Préparation de la soutenance

===Serrure vocale===

===IHM===

Projet biometrie-2013-2014

2014-03-17T13:51:22Z

Rebecca.Poustis: /* Serrure faciale */

Projet biometrie-2013-2014

2014-03-17T13:50:47Z

Rebecca.Poustis: /* Serrure faciale */

Projet biométrie 2013-2014
= Présentation=
==Sujet==
Application android de serrure vocale et faciale.

Dépot git [https://github.com/thomasNDS/biometry-lock-facial-and-vocal]

==Technologies ==
* Android
* OpenCV
* Lium
* Eclipse
* git
=Sous projets =
== IHM ==
===Equipe===
* Walid
* Elisa
===Sujet ===
* Acquisition et comparaison de visages et voix avec la base de données
=== Technologies ===
* Utilisation de [http://developer.android.com/tools/sdk/eclipse-adt.html ADT]
=== Etapes ===
==== Interface générale ====
* Création d'une interface d'accueil (choix enregistrement ou identification)
==== Acquisition des données ====
* Interface globale pour l'acquisition de visage et de voix
** Ovale fixe sur l'écran pour centrer la tête de l'utilisateur
** Texte prédéfini à lire pendant l'acquisition faciale
** Prise de photos en rafale pendant la lecture
* Enregistrement dans la base de données de l'image et du fichier son
==== Identification ====
* Interface de sélection de profil
** Nom et Prénom
* Bouton de déconnexion

== Serrure vocale ==
===Equipe===
* Nicolas
* Morgan
* Lotfi
===Sujet ===
Serrure vocale :
* Enrôlement du locuteur
* Identification du locuteur
=== Technologies ===
* Utilisation de [http://www-lium.univ-lemans.fr/diarization/doku.php/welcome LIUM speaker]
=== Etapes ===
==== Enrôlement du locuteur ====
* Enregistrement de la parole du locuteur (création d'un fichier wav contenant la parole du locuteur)
* Transcription du fichier wav en mfcc [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
* Puis [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
==== Identification du locuteur ====
* Enregistrement de la parole du locuteur (récupération d'un fichier wav)
* Transcription du fichier wav en seg [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
* Identification du locuteur [http://www-lium.univ-lemans.fr/diarization/doku.php/speaker_identification lienLyum]

== Reconnaissance de visages ==
===Equipe===
* Rebecca
* Thomas
===Sujet ===
Serrure faciale :
* Ajout d'un individu dans la base de donnée
* Authentification d'un individus

=== Technologies ===
* Reconnaissance de visage avec OpenCV

=== Tâches ===
*Identification de la personne (authentification, identif sans connaissance, classe de rejet)
*BD : avec tous les visages (plusieurs photos par personne (10 avec la même position))
*Authentification
*Présentation de la personne, choix entre plusieurs profils, ok ou rejet
*2 phases : apprentissage et évaluation
*Algo : entrainement des modèles et évaluation
*Capture du visage + extraction des points d’intérêt (openCV)
*Tester rejet avec utilisateur sans profil
*Verifier centrage du visage
===Etapes===
*Regarder projet de l’an passé
*Tuto de openCV/Android
*Commencer application :
*Saisie d’image (prise photo + BD)
*Points d’intérêt (openCV ?)
*Authentification (entrainement et évaluation)
*Intégration avec IHM
*Multi-image (si simple)
*Identification avec rejet
*Identification sans rejet

===Tutoriel: installation du NDK et configuration avec Eclipse ===
* Téléchargement du NDK [http://developer.android.com/tools/sdk/ndk/index.html#Installing]
* Extraire le dossier
* Dans Eclipse : Window > Preferences > Android > NDK coller le path du lien vers le dossier d'installation
* Dans le projet : clic droit sur le projet > project properties > C/C++ Build > Tool Chain Editor et selectionné Android Builder en tant que builder.
* Tuto pour installer OpenCV [http://www.seneschal.fr/index.php/recherches/84-installation-android-et-opencv-pour-android]

=Projets des années passées =
* Reconnaissance faciale [http://air.imag.fr/index.php/PAGE_WIKI_ETUDIANTS_2012-13_RECONNAISSANCE_FACIALE]
* Reconnaissance de signatures [http://air.imag.fr/index.php/PAGE_WIKI_ETUDIANTS_2012-13_SIGNATURES]

=Avancement=
==Semaine 1==
* Constitution des groupes
* Prise en main du SDK android

==Semaine 2==
===Serrure faciale===
* Définitions des tâches
* Installation et configuration du SDK et connexion nos téléphones
* Installation et configuration du NDK android
* Installation de la librairie OpenCV pour android
* Etude des projets des années passées

===Serrure vocale===
* Définitions des tâches
* Installation et configuration du SDK
* Installation de [http://developer.android.com/tools/help/adb.html adb]
* Connexion des téléphones via adb

===IHM===

==Semaine 3==
===Serrure faciale===
* Configuration du système de gestion de version
* Premiers tests avec openCV
* Enregistrement d'images dans l'application en utilisant l'appareil photo

===Serrure vocale===

===IHM===

==Semaine 4==
===Serrure faciale===
* Recherche de projets similaires
* Etude de l'existant

===Serrure vocale===

===IHM===

==Semaine 5==

===Interruption pédagogique===

==Semaine 6==
===Serrure faciale===
* Premier test de l'application utilisant HAAR
* Correction des bugs
* Configuration des environnements de développement

===Serrure vocale===

===IHM===

==Semaine 7==
===Serrure faciale===

===Serrure vocale===

===IHM===

Projet biometrie-2013-2014

2014-03-17T13:49:26Z

Rebecca.Poustis: /* Semaine 4 */

Projet biométrie 2013-2014
= Présentation=
==Sujet==
Application android de serrure vocale et faciale.

Dépot git [https://github.com/thomasNDS/biometry-lock-facial-and-vocal]

==Technologies ==
* Android
* OpenCV
* Lium
* Eclipse
* git
=Sous projets =
== IHM ==
===Equipe===
* Walid
* Elisa
===Sujet ===
* Acquisition et comparaison de visages et voix avec la base de données
=== Technologies ===
* Utilisation de [http://developer.android.com/tools/sdk/eclipse-adt.html ADT]
=== Etapes ===
==== Interface générale ====
* Création d'une interface d'accueil (choix enregistrement ou identification)
==== Acquisition des données ====
* Interface globale pour l'acquisition de visage et de voix
** Ovale fixe sur l'écran pour centrer la tête de l'utilisateur
** Texte prédéfini à lire pendant l'acquisition faciale
** Prise de photos en rafale pendant la lecture
* Enregistrement dans la base de données de l'image et du fichier son
==== Identification ====
* Interface de sélection de profil
** Nom et Prénom
* Bouton de déconnexion

== Serrure vocale ==
===Equipe===
* Nicolas
* Morgan
* Lotfi
===Sujet ===
Serrure vocale :
* Enrôlement du locuteur
* Identification du locuteur
=== Technologies ===
* Utilisation de [http://www-lium.univ-lemans.fr/diarization/doku.php/welcome LIUM speaker]
=== Etapes ===
==== Enrôlement du locuteur ====
* Enregistrement de la parole du locuteur (création d'un fichier wav contenant la parole du locuteur)
* Transcription du fichier wav en mfcc [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
* Puis [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
==== Identification du locuteur ====
* Enregistrement de la parole du locuteur (récupération d'un fichier wav)
* Transcription du fichier wav en seg [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
* Identification du locuteur [http://www-lium.univ-lemans.fr/diarization/doku.php/speaker_identification lienLyum]

== Reconnaissance de visages ==
===Equipe===
* Rebecca
* Thomas
===Sujet ===
Serrure faciale :
* Ajout d'un individu dans la base de donnée
* Authentification d'un individus

=== Technologies ===
* Reconnaissance de visage avec OpenCV

=== Tâches ===
*Identification de la personne (authentification, identif sans connaissance, classe de rejet)
*BD : avec tous les visages (plusieurs photos par personne (10 avec la même position))
*Authentification
*Présentation de la personne, choix entre plusieurs profils, ok ou rejet
*2 phases : apprentissage et évaluation
*Algo : entrainement des modèles et évaluation
*Capture du visage + extraction des points d’intérêt (openCV)
*Tester rejet avec utilisateur sans profil
*Verifier centrage du visage
===Etapes===
*Regarder projet de l’an passé
*Tuto de openCV/Android
*Commencer application :
*Saisie d’image (prise photo + BD)
*Points d’intérêt (openCV ?)
*Authentification (entrainement et évaluation)
*Intégration avec IHM
*Multi-image (si simple)
*Identification avec rejet
*Identification sans rejet

===Tutoriel: installation du NDK et configuration avec Eclipse ===
* Téléchargement du NDK [http://developer.android.com/tools/sdk/ndk/index.html#Installing]
* Extraire le dossier
* Dans Eclipse : Window > Preferences > Android > NDK coller le path du lien vers le dossier d'installation
* Dans le projet : clic droit sur le projet > project properties > C/C++ Build > Tool Chain Editor et selectionné Android Builder en tant que builder.
* Tuto pour installer OpenCV [http://www.seneschal.fr/index.php/recherches/84-installation-android-et-opencv-pour-android]

=Projets des années passées =
* Reconnaissance faciale [http://air.imag.fr/index.php/PAGE_WIKI_ETUDIANTS_2012-13_RECONNAISSANCE_FACIALE]
* Reconnaissance de signatures [http://air.imag.fr/index.php/PAGE_WIKI_ETUDIANTS_2012-13_SIGNATURES]

=Avancement=
==Semaine 1==
* Constitution des groupes
* Prise en main du SDK android

==Semaine 2==
===Serrure faciale===
* Définitions des tâches
* Installation et configuration du SDK et connexion nos téléphones
* Installation et configuration du NDK android
* Installation de la librairie OpenCV pour android
* Etude des projets des années passées

===Serrure vocale===
* Définitions des tâches
* Installation et configuration du SDK
* Installation de [http://developer.android.com/tools/help/adb.html adb]
* Connexion des téléphones via adb

===IHM===

==Semaine 3==
===Serrure faciale===
* Configuration du système de gestion de version
* Premiers tests avec openCV
* Enregistrement d'images dans l'application en utilisant l'appareil photo

===Serrure vocale===

===IHM===

==Semaine 4==
===Serrure faciale===
* Recherche de projets similaires
* Etude de l'existant

===Serrure vocale===

===IHM===

==Semaine 5==

===Interruption pédagogique===

==Semaine 6==
===Serrure faciale===

===Serrure vocale===

===IHM===

==Semaine 7==
===Serrure faciale===

===Serrure vocale===

===IHM===

Projet biometrie-2013-2014

2014-03-17T13:48:35Z

Rebecca.Poustis: /* Semaine 5 */

Projet biométrie 2013-2014
= Présentation=
==Sujet==
Application android de serrure vocale et faciale.

Dépot git [https://github.com/thomasNDS/biometry-lock-facial-and-vocal]

==Technologies ==
* Android
* OpenCV
* Lium
* Eclipse
* git
=Sous projets =
== IHM ==
===Equipe===
* Walid
* Elisa
===Sujet ===
* Acquisition et comparaison de visages et voix avec la base de données
=== Technologies ===
* Utilisation de [http://developer.android.com/tools/sdk/eclipse-adt.html ADT]
=== Etapes ===
==== Interface générale ====
* Création d'une interface d'accueil (choix enregistrement ou identification)
==== Acquisition des données ====
* Interface globale pour l'acquisition de visage et de voix
** Ovale fixe sur l'écran pour centrer la tête de l'utilisateur
** Texte prédéfini à lire pendant l'acquisition faciale
** Prise de photos en rafale pendant la lecture
* Enregistrement dans la base de données de l'image et du fichier son
==== Identification ====
* Interface de sélection de profil
** Nom et Prénom
* Bouton de déconnexion

== Serrure vocale ==
===Equipe===
* Nicolas
* Morgan
* Lotfi
===Sujet ===
Serrure vocale :
* Enrôlement du locuteur
* Identification du locuteur
=== Technologies ===
* Utilisation de [http://www-lium.univ-lemans.fr/diarization/doku.php/welcome LIUM speaker]
=== Etapes ===
==== Enrôlement du locuteur ====
* Enregistrement de la parole du locuteur (création d'un fichier wav contenant la parole du locuteur)
* Transcription du fichier wav en mfcc [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
* Puis [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
==== Identification du locuteur ====
* Enregistrement de la parole du locuteur (récupération d'un fichier wav)
* Transcription du fichier wav en seg [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
* Identification du locuteur [http://www-lium.univ-lemans.fr/diarization/doku.php/speaker_identification lienLyum]

== Reconnaissance de visages ==
===Equipe===
* Rebecca
* Thomas
===Sujet ===
Serrure faciale :
* Ajout d'un individu dans la base de donnée
* Authentification d'un individus

=== Technologies ===
* Reconnaissance de visage avec OpenCV

=== Tâches ===
*Identification de la personne (authentification, identif sans connaissance, classe de rejet)
*BD : avec tous les visages (plusieurs photos par personne (10 avec la même position))
*Authentification
*Présentation de la personne, choix entre plusieurs profils, ok ou rejet
*2 phases : apprentissage et évaluation
*Algo : entrainement des modèles et évaluation
*Capture du visage + extraction des points d’intérêt (openCV)
*Tester rejet avec utilisateur sans profil
*Verifier centrage du visage
===Etapes===
*Regarder projet de l’an passé
*Tuto de openCV/Android
*Commencer application :
*Saisie d’image (prise photo + BD)
*Points d’intérêt (openCV ?)
*Authentification (entrainement et évaluation)
*Intégration avec IHM
*Multi-image (si simple)
*Identification avec rejet
*Identification sans rejet

===Tutoriel: installation du NDK et configuration avec Eclipse ===
* Téléchargement du NDK [http://developer.android.com/tools/sdk/ndk/index.html#Installing]
* Extraire le dossier
* Dans Eclipse : Window > Preferences > Android > NDK coller le path du lien vers le dossier d'installation
* Dans le projet : clic droit sur le projet > project properties > C/C++ Build > Tool Chain Editor et selectionné Android Builder en tant que builder.
* Tuto pour installer OpenCV [http://www.seneschal.fr/index.php/recherches/84-installation-android-et-opencv-pour-android]

=Projets des années passées =
* Reconnaissance faciale [http://air.imag.fr/index.php/PAGE_WIKI_ETUDIANTS_2012-13_RECONNAISSANCE_FACIALE]
* Reconnaissance de signatures [http://air.imag.fr/index.php/PAGE_WIKI_ETUDIANTS_2012-13_SIGNATURES]

=Avancement=
==Semaine 1==
* Constitution des groupes
* Prise en main du SDK android

==Semaine 2==
===Serrure faciale===
* Définitions des tâches
* Installation et configuration du SDK et connexion nos téléphones
* Installation et configuration du NDK android
* Installation de la librairie OpenCV pour android
* Etude des projets des années passées

===Serrure vocale===
* Définitions des tâches
* Installation et configuration du SDK
* Installation de [http://developer.android.com/tools/help/adb.html adb]
* Connexion des téléphones via adb

===IHM===

==Semaine 3==
===Serrure faciale===
* Configuration du système de gestion de version
* Premiers tests avec openCV
* Enregistrement d'images dans l'application en utilisant l'appareil photo

===Serrure vocale===

===IHM===

==Semaine 4==
===Serrure faciale===

===Serrure vocale===

===IHM===

==Semaine 5==

===Interruption pédagogique===

==Semaine 6==
===Serrure faciale===

===Serrure vocale===

===IHM===

==Semaine 7==
===Serrure faciale===

===Serrure vocale===

===IHM===

Projet biometrie-2013-2014

2014-03-17T13:45:59Z

Rebecca.Poustis: /* Semaine 8 */

Projet biométrie 2013-2014
= Présentation=
==Sujet==
Application android de serrure vocale et faciale.

Dépot git [https://github.com/thomasNDS/biometry-lock-facial-and-vocal]

==Technologies ==
* Android
* OpenCV
* Lium
* Eclipse
* git
=Sous projets =
== IHM ==
===Equipe===
* Walid
* Elisa
===Sujet ===
* Acquisition et comparaison de visages et voix avec la base de données
=== Technologies ===
* Utilisation de [http://developer.android.com/tools/sdk/eclipse-adt.html ADT]
=== Etapes ===
==== Interface générale ====
* Création d'une interface d'accueil (choix enregistrement ou identification)
==== Acquisition des données ====
* Interface globale pour l'acquisition de visage et de voix
** Ovale fixe sur l'écran pour centrer la tête de l'utilisateur
** Texte prédéfini à lire pendant l'acquisition faciale
** Prise de photos en rafale pendant la lecture
* Enregistrement dans la base de données de l'image et du fichier son
==== Identification ====
* Interface de sélection de profil
** Nom et Prénom
* Bouton de déconnexion

== Serrure vocale ==
===Equipe===
* Nicolas
* Morgan
* Lotfi
===Sujet ===
Serrure vocale :
* Enrôlement du locuteur
* Identification du locuteur
=== Technologies ===
* Utilisation de [http://www-lium.univ-lemans.fr/diarization/doku.php/welcome LIUM speaker]
=== Etapes ===
==== Enrôlement du locuteur ====
* Enregistrement de la parole du locuteur (création d'un fichier wav contenant la parole du locuteur)
* Transcription du fichier wav en mfcc [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
* Puis [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
==== Identification du locuteur ====
* Enregistrement de la parole du locuteur (récupération d'un fichier wav)
* Transcription du fichier wav en seg [http://www-lium.univ-lemans.fr/diarization/doku.php/feature_set lienLIUM]
* Identification du locuteur [http://www-lium.univ-lemans.fr/diarization/doku.php/speaker_identification lienLyum]

== Reconnaissance de visages ==
===Equipe===
* Rebecca
* Thomas
===Sujet ===
Serrure faciale :
* Ajout d'un individu dans la base de donnée
* Authentification d'un individus

=== Technologies ===
* Reconnaissance de visage avec OpenCV

=== Tâches ===
*Identification de la personne (authentification, identif sans connaissance, classe de rejet)
*BD : avec tous les visages (plusieurs photos par personne (10 avec la même position))
*Authentification
*Présentation de la personne, choix entre plusieurs profils, ok ou rejet
*2 phases : apprentissage et évaluation
*Algo : entrainement des modèles et évaluation
*Capture du visage + extraction des points d’intérêt (openCV)
*Tester rejet avec utilisateur sans profil
*Verifier centrage du visage
===Etapes===
*Regarder projet de l’an passé
*Tuto de openCV/Android
*Commencer application :
*Saisie d’image (prise photo + BD)
*Points d’intérêt (openCV ?)
*Authentification (entrainement et évaluation)
*Intégration avec IHM
*Multi-image (si simple)
*Identification avec rejet
*Identification sans rejet

===Tutoriel: installation du NDK et configuration avec Eclipse ===
* Téléchargement du NDK [http://developer.android.com/tools/sdk/ndk/index.html#Installing]
* Extraire le dossier
* Dans Eclipse : Window > Preferences > Android > NDK coller le path du lien vers le dossier d'installation
* Dans le projet : clic droit sur le projet > project properties > C/C++ Build > Tool Chain Editor et selectionné Android Builder en tant que builder.
* Tuto pour installer OpenCV [http://www.seneschal.fr/index.php/recherches/84-installation-android-et-opencv-pour-android]

=Projets des années passées =
* Reconnaissance faciale [http://air.imag.fr/index.php/PAGE_WIKI_ETUDIANTS_2012-13_RECONNAISSANCE_FACIALE]
* Reconnaissance de signatures [http://air.imag.fr/index.php/PAGE_WIKI_ETUDIANTS_2012-13_SIGNATURES]

=Avancement=
==Semaine 1==
* Constitution des groupes
* Prise en main du SDK android

==Semaine 2==
===Serrure faciale===
* Définitions des tâches
* Installation et configuration du SDK et connexion nos téléphones
* Installation et configuration du NDK android
* Installation de la librairie OpenCV pour android
* Etude des projets des années passées

===Serrure vocale===
* Définitions des tâches
* Installation et configuration du SDK
* Installation de [http://developer.android.com/tools/help/adb.html adb]
* Connexion des téléphones via adb

===IHM===

==Semaine 3==
===Serrure faciale===
* Configuration du système de gestion de version
* Premiers tests avec openCV
* Enregistrement d'images dans l'application en utilisant l'appareil photo

===Serrure vocale===

===IHM===

==Semaine 4==
===Serrure faciale===

===Serrure vocale===

===IHM===

==Semaine 5==
===Serrure faciale===

===Serrure vocale===

===IHM===

==Semaine 6==
===Serrure faciale===

===Serrure vocale===

===IHM===

==Semaine 7==
===Serrure faciale===

===Serrure vocale===

===IHM===

Extensions XBMC/FicheSuivi

2014-03-10T08:21:52Z

Rebecca.Poustis: /* Sprint 5 (semaine 9) : 24 au 28 février */