Перейти к содержанию

Knx-connection: различия между версиями

Материал из XIOT Wiki
OLD-04A: обновлена инструкция по KNX и добавлен прямой редирект
Английские адреса Wiki: обновление ссылок с сохранением русских подписей
 
(не показаны 3 промежуточные версии этого же участника)
Строка 1: Строка 1:
{{DISPLAYTITLE:Подключение KNX}}
'''KNX''' — шина автоматизации зданий. XIOT работает с групповыми адресами KNX и поддерживаемыми типами данных DPT через XIOT-PLC.
'''KNX''' — шина автоматизации зданий. XIOT работает с групповыми адресами KNX и поддерживаемыми типами данных DPT через XIOT-PLC.


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


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


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


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


== DPT и адреса XIOT ==
== DPT и адреса XIOT ==
Строка 109: Строка 110:
* '''адрес состояния''' — откуда XIOT получает фактическое состояние.
* '''адрес состояния''' — откуда XIOT получает фактическое состояние.


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


== Если проверка не прошла ==
== Если проверка не прошла ==
Строка 119: Строка 120:
* '''Команда проходит, состояние не меняется:''' проверьте объект обратной связи в ETS и назначенный адрес состояния.
* '''Команда проходит, состояние не меняется:''' проверьте объект обратной связи в ETS и назначенный адрес состояния.


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


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


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


== Официальные источники ==
== Официальные источники ==
Строка 141: Строка 142:
[[Категория:Интеграции]]
[[Категория:Интеграции]]
[[Категория:KNX]]
[[Категория:KNX]]
{{DEFAULTSORT:Подключение KNX}}

Текущая версия от 22:15, 2 октября 2026

KNX — шина автоматизации зданий. XIOT работает с групповыми адресами KNX и поддерживаемыми типами данных DPT через XIOT-PLC.

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

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

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

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

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

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

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

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

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

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

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

Контроллер Совместимые слоты
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». Проверьте таблицу совместимости и инструкцию WBE2-I-KNX для своей ревизии. Для некоторых сочетаний слота и корпуса производитель указывает дополнительные требования к установке.

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

  1. Установите WBE2-I-KNX в совместимый внутренний слот по инструкции производителя.
  2. Подключите шину к выходу соответствующего слота mod_out_N: O1 — KNX (+), O3 — KNX (−). Соблюдайте полярность.
  3. Подключите к линии специализированный источник питания KNX с дросселем. Для работы модуля требуется питание на шине KNX.
  4. В веб-интерфейсе Wiren Board откройте Настройки → Конфигурационные файлы → Модули расширения и порты.
  5. Выберите тот внутренний слот, куда установлен модуль, укажите WBE2-I-KNX и нажмите Сохранить. Название пункта может немного отличаться в разных выпусках ПО контроллера.
  6. Проверьте, что knxd настроен и запущен. Используйте официальную инструкцию Wiren Board по knxd.

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

  1. В ETS откройте раздел групповых адресов и выберите Экспорт групповых адресов.
  2. Сохраните обычный XML с трёхуровневой структурой «главная группа → средняя группа → групповой адрес».
  3. Не выбирайте CSV или вариант XML ETS4: XIOT ожидает обычный XML с типами данных DPT.
Экспорт групповых адресов в интерфейсе ETS5. В других версиях расположение команды может отличаться.
Выбор обычного XML при экспорте из ETS5. Не используйте «XML (формат ETS4)» или CSV.

Подробности формата экспорта: справка KNX Association.

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

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

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

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

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

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

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

DPT и адреса XIOT

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

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

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

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

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

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

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

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

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

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

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

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

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