Gestion du protocole xPL

Da eedomus - Documentazione.

Indice

Présentation du protocole xPL

Le protocole xPL correspond à de petits messages textes qui sont envoyés sur le réseau Ethernet afin de permettre à deux périphériques de communiquer entre eux.

Ce protocole, créé en 2003 permet de créer une abstraction de la technologie utilisée et de rendre plus facile le dialogue entre deux systèmes différents.

Site du projet xPL (en anglais) : http://www.xplproject.org.uk

Article de présentation du protocole xPL : Le Protocole xPL

Intégration du protocole xPL à l'eeDomus

La box eeDomus sait communiquer en xPL avec deux périphériques différents : Les Actionneurs xPL et les Capteurs xPL (Périphériques xPL)

Les actionneurs xPL permettent d'envoyer des commandes sur le réseau pour piloter d'autres périphériques alors que les capteurs xPL permettent de récupérer les valeurs transmises par d'autres périphériques xPL.

Actionneurs xPL

Les actionneurs gèrent deux schémas xPL qui sont automatiquement adaptés en fonction du protocole sélectionné dans la configuration du module.

Les schémas sont x10.basic (pour les protocoles x10, domia, rts) et le schéma ac.basic (pour le protocole Chacon/DIO)

Tous les messages xPL générés pour un actionneur xPL de type x10.basic seront de la forme :

 xpl-cmnd
 {
     hop=1
     source=eedomus-rfxcom.xxxxxxxxx
     target=*
 }
 x10.basic
 {
     command=on|off|dim
     device=[A1-P16]
     [level=0-100]
     [protocol=arc|rts]
 }

L'attribut level n'est spécifié que si la commande est dim L'attribut protocol n'est spécifié que si celui ci n'est pas x10

Les messages xPL générés pour un actionneur de type ac.basic seront de la forme :

 xpl-cmnd
 {
     hop=1
     source=eedomus-rfxcom.xxxxxxxxx
     target=*
 }
 ac.basic
 {
     address=(0x01 - 0x3FFFFFF)
     unit = (1-16)
     command=on|off|preset
     [level=0-15]
 }

L'attribut level n'est spécifié que si la commande est preset.

Le drivers xPL de la box eeDomus va automatiquement gérer le champ command envoyée en fonction du protocole et de la valeur du périphérique (100 = on, 0 = off, compris entre 0 et 100 = dim ou preset suivant le protocole)


Capteurs xPL

La box eeDomus saura automatiquement décoder tous messages xPL quel reçoit de type sensor.basic.

Le message doit être formaté de la manière suivante :

 xpl-stat
 {
     hop=1
     source=*
     target=[eedomus-rfxcom.xxxxxxxxx | *]
 }
 sensor.basic
 {
     device= id_du_device
     type= type_du_device
     current= valeur_du_device
 }

L'ajout d'un capteur xPL sur la box eeDomus en spécifiant dans ses paramètres l'adresse (correspondant à id_du_device) et le type associé (correspondant à type_du_device) sera automatiquement mis à jour à chaque réception du message xPL correspondant.

Pour la configuration des périphériques de ce type, voir la page Périphériques xPL