Подключение KNX в XIOT

KNX — это международный стандарт автоматизации зданий. В системе XIOT реализована полная поддержка KNX: вы можете загружать групповые адреса, привязывать их к устройствам и управлять системой напрямую через контроллер.

🧩 Необходимое оборудование

Для подключения к шине KNX необходимо использовать модуль WBE2-I-KNX — это дополнительная плата для контроллеров Wiren Board:

Подключается в слот расширения контроллера
Обеспечивает обмен KNX-телеграммами по TP1 (витая пара)
Поддерживается контроллерами Wiren Board 6, 7, 8
Работает в составе XIOT-PLC

Также требуется внешний источник питания для шины KNX. В качестве примера можно использовать:

KNX-20E-640 — компактный блок питания 640 мА с интегрированной дроссельной развязкой

🔌 Как подключить KNX

1. Установите модуль WBE2-I-KNX в контроллер Wiren Board.

  В веб-интерфейсе Wiren Board перейдите в раздел Модули расширения и порты.  
  Модуль может быть установлен в один из четырёх внутренних слотов: Внутренний слот 1–4.  
  Выберите нужный слот и укажите тип модуля: WBE2-I-KNX: KNX/EIB TP-UART, затем нажмите кнопку Записать.

2. Подключите шину KNX к стандартным клеммам TP1 на модуле.

3. Подключите источник питания к шине KNX.

  Например, блок питания KNX-20E-640 с гальванической развязкой.

4. В редакторе XIOT откройте раздел Драйверы, перейдите на вкладку KNX и активируйте переключатель.

5. Загрузите файл групповых адресов формата .xml, экспортированный из ETS.

  Для этого нажмите кнопку Загрузить и выберите XML-файл.

6. Нажмите кнопку Загрузить конфигурацию, чтобы передать настройки на XIOT-PLC.

7. Вернитесь на вкладку KNX и убедитесь, что статус подключения изменился на ПОДКЛЮЧЕН.

  После подключения вы увидите структуру KNX-групп с адресами, именами и типами данных (например, 1.001 switch).

Дополнительно: Инструкцию по быстрой настройке KNX в контроллере Wiren Board можно найти в официальной документации: [1](https://wirenboard.com/wiki/KNX_Quick_start)

📤 Экспорт групповых адресов из ETS

1. В ETS откройте раздел Групповые адреса.

2. Щёлкните правой кнопкой мыши и выберите пункт Экспорт групповых адресов.

3. Выберите формат: XML и нажмите OK.

4. В редакторе XIOT нажмите кнопку ЗАГРУЗИТЬ и выберите сохранённый XML-файл.

🧱 Работа с групповыми адресами

После загрузки XML-файла из ETS структура KNX будет отображаться в виде дерева:

Главная группа → Средняя группа → Подгруппа

Каждому групповому адресу соответствует тип данных (DPT), который определяет способ обработки значений:

`1.001 switch` — бинарное значение (вкл/выкл)
`5.001 dimming` — значение яркости от 0 до 100%
`9.001 temperature` — значение температуры с плавающей точкой

Тип данных загружается автоматически из файла ETS и используется в XIOT при настройке тегов.

Важно: Тип данных необходимо правильно задать в ETS — изменить его в редакторе XIOT невозможно. Некорректный DPT может привести к ошибочной интерпретации значения и некорректной работе устройств.

🔗 Привязка к устройствам XIOT

1. Создайте виртуальное устройство, например, Лампу, в нужной комнате проекта.

2. Перейдите в её настройки и активируйте необходимые характеристики в зависимости от возможностей устройства:

  * включение — для включения и выключения света
  * яркость — для управления уровнем освещения
  * температура цвета — для изменения оттенка света (тёплый/холодный)
  * цвет — если используется RGB-управление

3. Привяжите каждую активную характеристику к соответствующим групповым адресам KNX:

  * Укажите адрес управления и адрес статуса, если они разделены (что типично для KNX)
  * Пример: 
    * тег управления: `/knx/1/0/10`
    * тег статуса: `/knx/1/0/11`

KNX использует разные групповые адреса для отправки команды и получения состояния, поэтому важно указать оба тега.

Важно:

Тип данных (DPT), назначенный каждому групповому адресу в ETS, должен точно соответствовать выбранной характеристике.
Тип нельзя изменить в XIOT — он загружается из XML-файла ETS. Убедитесь, что все DPT заданы корректно в ETS перед экспортом.
Если в настройках тега статуса установлена галочка, XIOT будет обновлять характеристику лампы только после получения значения из шины KNX. Это обеспечивает точную обратную связь и исключает несогласованность между интерфейсом и физическим состоянием.

Таким образом, виртуальная лампа в XIOT будет надёжно связана с физическим устройством в сети KNX.

⚙️ Расширенные возможности

В XIOT вы можете строить сценарии, в которых устройства из разных протоколов (KNX, Wiren Board, MQTT) взаимодействуют между собой — через виртуальные устройства.
Например, можно использовать эстетичный и надёжный выключатель KNX:

 * Добавить его в проект XIOT
 * Настроить на нём кнопки в редакторе
 * Связать каждую кнопку с виртуальным устройством в XIOT
 * Настроить включение светильников, подключённых через Wiren Board, при нажатии на кнопки KNX

Панели KNX могут использоваться не только для управления устройствами KNX, но и для взаимодействия с оборудованием Wiren Board или другими системами, поддерживаемыми XIOT. Это позволяет:

 * Управлять светом, климатом или другими функциями в разных подсистемах из одного интерфейса
 * Отображать на панели актуальные состояния устройств, подключённых по другим протоколам

Это обеспечивает единый пользовательский опыт при сохранении гибкости и надёжности архитектуры: каждая система выполняет свою функцию, а вся логика и визуализация объединяются на уровне виртуальных устройств и сценариев XIOT.

📝 Примечания

Один групповой адрес может использоваться в нескольких виртуальных устройствах.
Для загрузки структуры используйте XML из ETS5 или ETS6.
Без установленного модуля WBE2-I-KNX работа с KNX невозможна.
Источник питания KNX должен быть сертифицированным — например, KNX-20E-640.
Тип данных нельзя изменить в XIOT — он задаётся только в ETS.
Устанавливайте галочку у тега статуса, если требуется подтверждение от физического устройства.
Подробнее: [2](https://wirenboard.com/wiki/KNX_Quick_start)

Подключение KNX