Просмотр кода страницы Knx-connection

{{DISPLAYTITLE:Подключение KNX}}
'''KNX''' — шина автоматизации зданий. XIOT работает с групповыми адресами KNX и поддерживаемыми типами данных DPT через XIOT-PLC.

Эта инструкция относится к штатному подключению проводной шины KNX TP к контроллеру Wiren Board 6, 7 или 8 с внутренним модулем '''WBE2-I-KNX''' и работающим сервисом <code>knxd</code>. Проектирование топологии KNX, программирование устройств в ETS и KNX Secure рассматриваются отдельно.

'''Результат:''' групповые адреса импортированы из ETS в XIOT-EDITOR, KNX-драйвер загружен на XIOT-PLC, а команда и обратная связь проверены на реальном устройстве.

== Как устроено подключение ==

<code>Шина KNX TP → WBE2-I-KNX → knxd → XIOT-PLC → виртуальные устройства XIOT</code>

* '''WBE2-I-KNX''' обеспечивает физическое подключение Wiren Board к шине KNX TP.
* '''knxd''' предоставляет программный доступ к шине на контроллере.
* '''XIOT-PLC''' получает и отправляет значения групповых адресов через <code>knxd</code>.
* '''XIOT-EDITOR''' импортирует структуру групповых адресов из XML-файла ETS и создаёт адреса вида <code>/knx/главная_группа/средняя_группа/групповой_адрес</code>.

В текущей реализации XIOT-PLC подключается к <code>knxd</code> на том же контроллере по адресу <code>localhost:6720</code>.

== Перед началом ==

* Определите точную модель и ревизию Wiren Board.
* Подготовьте модуль WBE2-I-KNX и специализированный источник питания KNX со встроенным дросселем.
* Настройте KNX-устройства и групповые адреса в ETS; каждому используемому адресу назначьте правильный DPT.
* Убедитесь, что XIOT-PLC установлен на этом контроллере и привязан к проекту: [[Подключение Wiren Board]].
* Сохраните резервную копию конфигурации Wiren Board и проекта ETS.

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

== Выберите совместимый слот ==

WBE2-I-KNX поддерживается контроллерами Wiren Board 6, 7 и 8, но совместимый слот '''зависит от модели и ревизии контроллера'''.

{| class="wikitable"
! Контроллер !! Совместимые слоты
|-
| Wiren Board 6.3–6.6 || MOD1, MOD2
|-
| Wiren Board 6.7 и Wiren Board 7 || MOD1, MOD2, MOD3
|-
| Wiren Board 8.4 || MOD2, MOD3
|-
| Wiren Board 8.5 || MOD1, MOD2, MOD3, MOD4
|}

Не выбирайте слот по общей нумерации «1–4». Проверьте [https://wiki.wirenboard.com/wiki/index.php?title=WBE2-I-KNX_KNX_Extension_Module&oldid=95231 таблицу совместимости и инструкцию WBE2-I-KNX] для своей ревизии. Для некоторых сочетаний слота и корпуса производитель указывает дополнительные требования к установке.

== Подключите и настройте модуль ==

# Установите WBE2-I-KNX в совместимый внутренний слот по инструкции производителя.
# Подключите шину к выходу соответствующего слота <code>mod_out_N</code>: '''O1 — KNX (+)''', '''O3 — KNX (−)'''. Соблюдайте полярность.
# Подключите к линии специализированный источник питания KNX с дросселем. Для работы модуля требуется питание на шине KNX.
# В веб-интерфейсе Wiren Board откройте '''Настройки → Конфигурационные файлы → Модули расширения и порты'''.
# Выберите тот внутренний слот, куда установлен модуль, укажите WBE2-I-KNX и нажмите '''Сохранить'''. Название пункта может немного отличаться в разных выпусках ПО контроллера.
# Проверьте, что <code>knxd</code> настроен и запущен. Используйте [https://wiki.wirenboard.com/wiki/index.php?title=Knxd&oldid=60953 официальную инструкцию Wiren Board по knxd].

== Экспортируйте адреса из ETS ==

# В ETS откройте раздел групповых адресов и выберите '''Экспорт групповых адресов'''.
# Сохраните '''обычный XML''' с трёхуровневой структурой «главная группа → средняя группа → групповой адрес».
# Не выбирайте CSV или вариант '''XML ETS4''': XIOT ожидает обычный XML с типами данных DPT.

[[Файл:Xiot 31.png|800px|thumb|center|Экспорт групповых адресов в интерфейсе ETS5. В других версиях расположение команды может отличаться.]]

[[Файл:Xiot 32.png|800px|thumb|center|Выбор обычного XML при экспорте из ETS5. Не используйте «XML (формат ETS4)» или CSV.]]

Подробности формата экспорта: [https://support.knx.org/hc/en-us/articles/115001825324-Group-Address-Export справка KNX Association].

== Импортируйте XML в XIOT-EDITOR ==

# Откройте проект и перейдите в '''Драйверы → KNX'''.
# Включите переключатель '''Активен'''.
# Нажмите '''Загрузить ETS XML''' и выберите экспортированный файл.
# Проверьте счётчики '''Областей''', '''Линий''' и '''Адресов'''. Раскройте дерево, убедитесь, что названия и адреса совпадают с ETS, и отдельно сверьте DPT каждого используемого адреса. Отсутствующий в XML DPT текущий импортёр может без предупреждения принять за <code>1.001</code>, поэтому нулевого счётчика предупреждений недостаточно.
# Если показано '''DPT не распознаны''', не продолжайте настройку. Исправьте DPT в ETS и повторите обычный XML-экспорт только тогда, когда тип действительно отсутствует или задан ошибочно. Если тип в ETS верен, но XIOT его не распознал либо для адреса указано несколько DPT, не подменяйте тип ради исчезновения предупреждения: остановитесь и обратитесь в поддержку.

Импорт XML подтверждает только то, что XIOT-EDITOR прочитал структуру файла. Для этого шага связь с контроллером и физической шиной не требуется.

== Загрузите конфигурацию и проверьте связь ==

# Нажмите '''Загрузить конфигурацию на контроллер'''. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.
# Вернитесь в '''Драйверы → KNX''' и дождитесь статуса '''ПОДКЛЮЧЕН'''.
# Откройте заведомо безопасный групповой адрес и выполните '''Прочитать'''. Проверьте полученное значение.
# При допустимости ручной команды выполните '''Отправить''' и подтвердите фактическую реакцию устройства.

Статус '''ПОДКЛЮЧЕН''' означает, что XIOT-PLC установил соединение с <code>knxd</code>. Сам по себе этот статус не подтверждает питание шины, полярность, прохождение телеграмм или ответ конкретного KNX-устройства. Завершённой проверкой считается реальное чтение или команда с ожидаемой обратной связью.

Отдельная команда '''Сохранить проект''' остаётся самостоятельной контрольной точкой. Проверьте результат сохранения по истории версий; во время сохранения и загрузки не редактируйте проект.

== DPT и адреса XIOT ==

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

{| class="wikitable"
! DPT !! Назначение !! Пример применения
|-
| 1.001 || переключение 0/1 || включение света
|-
| 3.007 || относительное управление яркостью || команда «ярче/темнее»
|-
| 5.001 || абсолютное значение 0…100% || заданная яркость
|-
| 9.001 || температура || текущее значение датчика
|}

После импорта групповой адрес <code>1/0/10</code> доступен в XIOT как <code>/knx/1/0/10</code>.

Для характеристики устройства укажите:

* '''адрес управления''' — куда XIOT отправляет команду;
* '''адрес состояния''' — откуда XIOT получает фактическое состояние.

В KNX эти адреса часто различаются. Если устройство использует один адрес в обе стороны, один и тот же адрес можно назначить на управление и состояние. Подробный порядок: [[Привязка реальных устройств к виртуальным]] и [[Механизм работы тегов в XIOT|Адреса управления и состояния в XIOT]].

== Если проверка не прошла ==

* '''Дерево пустое:''' проверьте, что выбран обычный XML и используется трёхуровневая структура групповых адресов.
* '''Есть предупреждение о DPT:''' назначьте или исправьте DPT в ETS и повторите экспорт. Не подменяйте тип вручную в XIOT.
* '''Нет статуса ПОДКЛЮЧЕН:''' проверьте загрузку актуальной конфигурации, состояние XIOT-PLC и <code>knxd</code>.
* '''Статус есть, но устройство не отвечает:''' отдельно проверьте питание и полярность шины, конфигурацию WBE2-I-KNX, адреса и DPT в ETS, а также прохождение телеграмм средствами Wiren Board.
* '''Команда проходит, состояние не меняется:''' проверьте объект обратной связи в ETS и назначенный адрес состояния.

Для обращения подготовьте модель и ревизию Wiren Board, версию XIOT-PLC, скриншот раздела KNX, XML без конфиденциальных данных и результат проверки <code>knxd</code>: [[Связь с поддержкой]].

== Следующие шаги ==

# Назначьте адреса управления и состояния: [[Привязка реальных устройств к виртуальным]].
# Загрузите конфигурацию и проверьте физическое оборудование.
# Перейдите к логике автоматизации: [[Создание сценариев]].
# Для другого протокола вернитесь к обзору: [[Настройка драйверов]].

== Официальные источники ==

* [https://wiki.wirenboard.com/wiki/index.php?title=WBE2-I-KNX_KNX_Extension_Module&oldid=95231 WBE2-I-KNX: совместимость, подключение и настройка]
* [https://wiki.wirenboard.com/wiki/index.php?title=KNX&oldid=90728 Архитектура KNX в Wiren Board]
* [https://wiki.wirenboard.com/wiki/index.php?title=Knxd&oldid=60953 Настройка knxd]
* [https://support.knx.org/hc/en-us/articles/115001825324-Group-Address-Export Экспорт групповых адресов из ETS]

''Проверено 13 сентября 2026 года по опубликованному интерфейсу XIOT-EDITOR и указанным официальным источникам.''

[[Категория:XIOT-PLC]]
[[Категория:Драйверы]]
[[Категория:Интеграции]]
[[Категория:KNX]]