Протокол XPL

Хаб (hub) — первый обязательный компонент XPL на каждом компьютере с XPL-устройствами.

Все устройства регулярно, обычно раз в 5 минут, отправляют харт-бит

хабу. При отключении устройства могут отправить специальное сообщение об окончании "сигнала жизни" (heartbeat end message), чтобы удалить себя из списка хаба.

Хаб пересылает все полученные сообщения всем зарегистрированным устройствам, не осуществляя фильтрации: всё происходит по принципу широковещательной ретрансляции.

Приложения на устройствах расширяют функционал домашней автоматизации (управление освещением, отслеживание времени восхода/захода солнца, погодные данные и прочее).

Устройство выбирает свободный UDP-порт и посылает с него heartbeat-сообщения хабу на IANA-регистрированный порт 3865.

С этого момента оно прослушивает свой приватный порт, а свои сообщения отправляет как широковещательные по XPL-порту 3865. Существуют три типа сообщений:

• command — команды для управления другими устройствами;
• status — ответы на команды;
• trigger — уведомления об изменении состояния устройства.

Полный перечень приложений и наборов инструментов для самостоятельной разработки доступен на официальном сайте сообщества.

Основной транспортный протокол XPL — UDP/IP, однако это не является обязательным. Для передачи сообщений между различными средами передачи данных (например, между UDP/IP и RS-232) необходим мост.

В среде Windows приложение xPL HAL обрабатывает входящие XPL-сообщения и запускает сценарии для выполнения различных задач. Конфигурирование производится через менеджер под Windows или браузер, также имеется конфигурационный менеджер XPL.

На Linux и MacOS программа xpl-central отслеживает все приходящие XPL-сообщения и может порождать новые сообщения согласно заданным в XML-файле правилам.

Все устройства XPL транслируют свои сообщения по протоколу UDP на IANA-регистрированный порт 3865.

Так как одновременное прослушивание порта возможно только одним приложением, XPL использует хаб, который ретранслирует широковещательные сообщения нужным приложениям. Приложения регистрируются у хаба на свободном порту, отправляя heartbeat, где указывается прослушиваемый порт; хаб затем рассылает все сообщения из своей очереди каждому из приложений.

XPL-сообщения представляют собой строки, каждая из которых заканчивается символом перевода строки (ASCII 10). Пример сообщения:

xpl-cmnd
{
hop=1
source=xpl-xplhal.myhouse
target=acme-cm12.server
}
x10.basic
{
command=dim
device=a1
level=75
}

Каждое сообщение XPL состоит из следующих частей:

• Тип сообщения (xpl-cmnd, xpl-stat или xpl-trig);
• Заголовочный блок в фигурных скобках c полями:
  • hop — счётчик переходов (hop count), увеличивается каждый раз при передаче сообщения между физическими сетями;
  • source — идентификатор источника (vendor_id-device_id.instance_id);
  • target — идентификатор цели (vendor_id-device_id.instance_id);
• Схема сообщения (class.type);
• Тело сообщения — пары имя=значение в фигурных скобках.

В заголовке, имя цели может быть заменено на символ * для широковещательных сообщений, что характерно для сообщений типа trigger и status.

В XPL применяются чётко определённые схемы сообщений, что позволяет приложениям от разных производителей корректно взаимодействовать друг с другом. Схемы сообщений расширяемы и задают не только обязательные элементы сообщения, но и порядок их следования.

Это облегчает синтаксический разбор сообщений даже для простых устройств.

Полный список существующих схем размещён на официальной вики проекта XPL. Разработчики могут создавать новые схемы по мере необходимости.