Gestión del protocolo xPL

De eedomus - Documentación

Contenido

Presentación del protocolo xPL

xPL es un protocolo de comunicaciones que envía a través de la red Ethernet mensajes cortos de texto, permitiendo de esta forma establecer un canal de comunicación entre dos periféricos.

Este protocolo, inventado en 2003, permite establecer de forma sencilla una vía de comunicación entre dos sistemas diferentes, sea cual sea la tecnología utilizada por cada uno de ellos.

Página web del proyecto xPL (en inglés): http://www.xplproject.org.uk

Artículo de prestation del protocolo xPL (en francés): El Protocolo xPL

Integración del protocolo xPL en eedomus

El controlador eedomus es capaz de establecer una comunicación bajo xPL mediante dos tipos de periféricos: los actuadores xPL y los sensores xPL (Periféricos xPL).

Los actuadores xPL permiten enviar comandos a través de la red para controlar otros periféricos, mientras que los sensores xPL sirven para obtener los valores transmitidos por otros periféricos xPL.

Actuadores xPL

Los actuadores xPL sont capaces de gestionar automáticamente dos tipos de esquemas de mensajes xPL, en función del protocolo seleccionado en la ventana de configuración del módulo.

Dichos esquemas son los siguientes: x10.basic (para los protocolos x10, domia y RTS) y ac.basic (para el protocolo Chacon/DIO).

Todos los mensajes xPL generados por un actuador xPL del tipo x10.basic tienen la siguiente estructura:

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

El atributo level sólo se especifica si el comando es dim. El atributo protocol sólo se especifica si es distinto de x10.

Los mensajes xPL generados por un actuador del tipo ac.basic tienen la siguiente estructura:

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

El atributo level sólo se especifica sí el comando es preset.

El driver xPL del controlador eedomus gestiona automáticamente el campo command enviado en función del protocolo y del valor del periférico (100 = on, 0 = off, comprendido entre 0 y 100 = dim o preset según el protocolo).

Sensores xPL

El controlador eedomus es capaz de descifrar automáticamente todos los mensajes xPL del tipo sensor.basic que recibe.

El mensaje debe tener el siguiente formato:

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

Cuando se añade un sensor xPL en el controlador eedomus y se especifica su dirección (correspondiente a id_du_device) y el tipo asociado (correspondiente a type_du_device), éste se actualiza automáticamente cada vez que recibe el mensaje xPL correspondiente.

Si quiere saber cómo configurar este tipo de periféricos, consulte la página Periféricos xPL.