Knx-connection: различия между версиями
Admin (обсуждение | вклад) COR-06: единый словарь действий и адресов управления/состояния |
Admin (обсуждение | вклад) Английские адреса Wiki: обновление ссылок с сохранением русских подписей |
||
| (не показаны 4 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
'''KNX''' — | {{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> | |||
* '''KNX- | * '''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-connection|Подключение Wiren Board]]. | |||
* Сохраните резервную копию конфигурации Wiren Board и проекта ETS. | |||
Монтаж внутри контроллера и работы в щите выполняются при снятом питании квалифицированным специалистом. Инструкция производителя для точной ревизии оборудования имеет приоритет. | |||
== Выберите совместимый слот == | |||
WBE2-I-KNX поддерживается контроллерами Wiren Board 6, 7 и 8, но совместимый слот '''зависит от модели и ревизии контроллера'''. | |||
6. | {| 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 эти адреса часто различаются. Если устройство использует один адрес в обе стороны, один и тот же адрес можно назначить на управление и состояние. Подробный порядок: [[Device-bindings|Привязка реальных устройств к виртуальным]] и [[Xiot-tags|Адреса управления и состояния в 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>: [[Support|Связь с поддержкой]]. | |||
== Следующие шаги == | |||
# Назначьте адреса управления и состояния: [[Device-bindings|Привязка реальных устройств к виртуальным]]. | |||
# Загрузите конфигурацию и проверьте физическое оборудование. | |||
# Перейдите к логике автоматизации: [[Creating-scenarios|Создание сценариев]]. | |||
# Для другого протокола вернитесь к обзору: [[Driver-setup|Настройка драйверов]]. | |||
== Официальные источники == | |||
* [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]] | |||
{{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 для своей ревизии. Для некоторых сочетаний слота и корпуса производитель указывает дополнительные требования к установке.
Подключите и настройте модуль
- Установите WBE2-I-KNX в совместимый внутренний слот по инструкции производителя.
- Подключите шину к выходу соответствующего слота
mod_out_N: O1 — KNX (+), O3 — KNX (−). Соблюдайте полярность. - Подключите к линии специализированный источник питания KNX с дросселем. Для работы модуля требуется питание на шине KNX.
- В веб-интерфейсе Wiren Board откройте Настройки → Конфигурационные файлы → Модули расширения и порты.
- Выберите тот внутренний слот, куда установлен модуль, укажите WBE2-I-KNX и нажмите Сохранить. Название пункта может немного отличаться в разных выпусках ПО контроллера.
- Проверьте, что
knxdнастроен и запущен. Используйте официальную инструкцию Wiren Board по knxd.
Экспортируйте адреса из ETS
- В ETS откройте раздел групповых адресов и выберите Экспорт групповых адресов.
- Сохраните обычный XML с трёхуровневой структурой «главная группа → средняя группа → групповой адрес».
- Не выбирайте CSV или вариант XML ETS4: XIOT ожидает обычный XML с типами данных DPT.


Подробности формата экспорта: справка KNX Association.
Импортируйте XML в XIOT-EDITOR
- Откройте проект и перейдите в Драйверы → KNX.
- Включите переключатель Активен.
- Нажмите Загрузить ETS XML и выберите экспортированный файл.
- Проверьте счётчики Областей, Линий и Адресов. Раскройте дерево, убедитесь, что названия и адреса совпадают с ETS, и отдельно сверьте DPT каждого используемого адреса. Отсутствующий в XML DPT текущий импортёр может без предупреждения принять за
1.001, поэтому нулевого счётчика предупреждений недостаточно. - Если показано DPT не распознаны, не продолжайте настройку. Исправьте DPT в ETS и повторите обычный XML-экспорт только тогда, когда тип действительно отсутствует или задан ошибочно. Если тип в ETS верен, но XIOT его не распознал либо для адреса указано несколько DPT, не подменяйте тип ради исчезновения предупреждения: остановитесь и обратитесь в поддержку.
Импорт XML подтверждает только то, что XIOT-EDITOR прочитал структуру файла. Для этого шага связь с контроллером и физической шиной не требуется.
Загрузите конфигурацию и проверьте связь
- Нажмите Загрузить конфигурацию на контроллер. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.
- Вернитесь в Драйверы → KNX и дождитесь статуса ПОДКЛЮЧЕН.
- Откройте заведомо безопасный групповой адрес и выполните Прочитать. Проверьте полученное значение.
- При допустимости ручной команды выполните Отправить и подтвердите фактическую реакцию устройства.
Статус ПОДКЛЮЧЕН означает, что 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: Связь с поддержкой.
Следующие шаги
- Назначьте адреса управления и состояния: Привязка реальных устройств к виртуальным.
- Загрузите конфигурацию и проверьте физическое оборудование.
- Перейдите к логике автоматизации: Создание сценариев.
- Для другого протокола вернитесь к обзору: Настройка драйверов.
Официальные источники
- WBE2-I-KNX: совместимость, подключение и настройка
- Архитектура KNX в Wiren Board
- Настройка knxd
- Экспорт групповых адресов из ETS
Проверено 13 сентября 2026 года по опубликованному интерфейсу XIOT-EDITOR и указанным официальным источникам.