Просмотр кода страницы Подключение KNX

__NOTOC__

=  Подключение 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 можно найти в официальной документации:  
[https://wirenboard.com/wiki/KNX_Quick_start](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.
* Устанавливайте галочку у тега статуса, если требуется подтверждение от физического устройства.
* Подробнее: [https://wirenboard.com/wiki/KNX_Quick_start](https://wirenboard.com/wiki/KNX_Quick_start)