XPL Protocol

xPL is an open protocol intended to permit the control and monitoring of home automation devices. The primary design goal of xPL is to provide a rich set of features and functionality, whilst maintaining an elegant, uncomplicated message structure. The protocol includes complete discovery and auto-configuration capabilities which support a fully "plug-n-play" architecture - essential to ensure a good end-user experience.

xPL benefits from a strongly specified message structure, required to ensure that xPL-enabled devices from different vendors are able to communicate without the risk of incompatibilities.

Communications between xPL applications on a Local Area Network (LAN) use UDP on port 3865.

xPL development has primarily occurred in the DIY community, where users have written connecting software to existing protocols and devices. Some examples include bridges to other home automation protocols like Z-Wave and UPB. Commercially, the Logitech SqueezeCenter software for the Squeezebox supports xPL.

Architecture

Different devices communicate using xPL within a local network.
They all broadcast their messages on th
IANA registered UDP port
3865
for the other devices to handle.

As on modern operating systems only one program can listen to a given port,
there is a need for a hub forwarding the messages to all devices on the same machine.
The devices register to the hub on a private UDP port and the hub then forwards all incoming message to these private ports.

HUB

A hub is the first xPL component required on a machine running xPL devices.

All devices send
heartbeat message
to the hub on a regular basis (typically 5 minutes).
When disconnecting, they also can send a special heartbeat end message for the hub to radiate them out of his list.

The hu
forwards all messages
to every device in its list.
There is no filtering of messages: a blind redistribution of all messages is carried out.

XPL device

Applications add functionality to a home automation solution such as light control, sun rise/set, weather information and so on.

A device chooses a free UDP port and sends heartbeat messages from that port to the hub on th
IANA registered UDP port
3865.

From that time, the devices listens for messages on its private port but sends messages as broadcast on the xPL port 3865.
Th
message types
are one of the following:
* ''command'', targeted to control other devices
* ''status'', generally as an answer to a command
* ''trigger'', used to notify a change in a device's state

An extensive list o
applications
can be downloaded from the net
Tooklits
are also provided for users wishing to develop their own devices.

Bridge

It is assumed that your network protocol is UDP/IP but this is by no means a requirement.
If you wish for your XPL message to cross from one transport medium to another (UDP/IP to RS232 for example) then you will need a Bridge.

Rules

On Windows
xPL HAL
processes incoming xPL messages
and executes scripts to perform a wide variety of tasks.
Configuration is done either through a Windows-based Manager or via a browser.
xPL HAL also includes an xPL Configuration Manager.

On Linux or Mac OS
xpl-central
monitors all xPL messages
and can trigger other messages based on a set of rules stored in an XML file.

Transmission media

The xPL protocol can operate over a variety of transmission media, including Ethernet, RS232 and RS485.

Ethernet

All xPL devices broadcast their messages over UDP, o
IANA registered port
3865.

But, as only one application can listen at a time to a given port, the xPL protocol uses a hub to retransmit all broadcast messages to the different applications on the same machine.
The applications subscribe to the hub on a free port by sending heartbeat messages which specifies the port they are listening to.
In turn, the hub forwards all xPL broadcast messages it receives to every application in his list.

Protocol

Lite on the wire, by design

Example

xPL Messages are line based, with each line ending with a linefeed (ASCII: 10 decimal) character.
The following is an example of a typical xPL Message:

xpl-cmnd

x10.basic

Message Structure

All messages are made out of:
* The message type (''xpl-cmnd'', ''xpl-stat'' or ''xpl-trig'')
* The header block, inside curly braces, containing:
** hop=''n'', the hop count which is incremented each time the xPL message is transferred from one physical network to another
** source=''vendor_id''-''device_id''.''instance_id'', which serves to identify the sender of the message
** target=''vendor_id''-''device_id''.''instance_id'', which serves to identify the destination of the message
* The message schema, in the format ''class''.''type''
* The message body, inside curly braces, containing ''name''=''value'' pairs

In the header block, the target name is replaced by the wildcard symbol "*" for broadcast messages.
This is the case for tigger and status messages.

Message Schema

xPL use
well defined message schemas
to ensure that applications from different vendors can interact sensibly. Message Schemas are extensible, and define not only the elements which should be present in a message, but also the order in which they appear.

This allows simple devices and applications to parse messages more easily.

All of the existing message schemas can be found on th
xPL project home page

Developers looking to create a new schema are invited to do so.

See also

* xAP Home Automation protocol - A substantially similar home automation protocol

References

External links

Official

xPL Home Automation Project homepage

xPL Home Automation Project WIki

xPL Forum

xPL Project URL links

Development

Perl toolkit

xPL Perl

Perl and Python xPL scripts

implementation of the xPL Protocol for Arduino

Arduino xPL Library

Other

Misterhouse supports xPL

Logitech Media Server supports xPL

{{List of Automation Protocols

Home automation
Industrial computing
Industrial automation