KNX + Home Assistant

KNX и Home Assistant: полное руководство по подключению и настройке

KNX хорошо подходит для надежной проводной автоматизации здания, а Home Assistant расширяет его визуализацией, сценариями, мобильным приложением и интеграцией с оборудованием других производителей. Разбираемся, как правильно связать эти две системы, чем отличаются KNX/IP Tunneling и Routing, зачем нужны Group Address и DPT, как использовать проект ETS и почему обратная связь через state_address важнее красивой панели управления.

Ключевой принцип: Home Assistant лучше использовать как дополнительный уровень автоматизации, а базовые функции здания оставлять работоспособными внутри KNX. Выключатели, освещение, жалюзи и критические функции не должны переставать работать только из-за перезагрузки сервера Home Assistant.

Что дает интеграция KNX и Home Assistant

KNX уже является полноценной системой автоматизации здания. Для его работы Home Assistant не требуется. Исполнительные устройства, сенсоры и настенные клавиши могут взаимодействовать непосредственно через KNX-шину.

Home Assistant нужен тогда, когда требуется объединить KNX с другими системами. Например:

управлять KNX со смартфона;
создать единую панель управления домом;
связать KNX с Zigbee, Matter, Wi-Fi и Bluetooth;
интегрировать видеонаблюдение и домофонию;
использовать погодные сервисы;
управлять климатом по сложным сценариям;
связать KNX с солнечным инвертором и аккумулятором;
управлять зарядной станцией электромобиля;
собирать историю температуры, энергии и других параметров;
создавать автоматизации между устройствами разных протоколов.

Пример. KNX управляет освещением, отоплением и жалюзи независимо от сервера. Home Assistant получает состояния KNX и дополнительно учитывает прогноз погоды, солнечную генерацию, присутствие людей и стоимость электроэнергии.

Как Home Assistant подключается к KNX

Home Assistant не подключается непосредственно к двухпроводной шине KNX TP. Между локальной Ethernet-сетью и KNX необходим KNX/IP интерфейс или KNX/IP Router.

Home Assistant

Ethernet / IP

KNX/IP Interface
или Router

KNX TP

Датчики, клавиши,
актуаторы KNX

Home Assistant обменивается KNX-телеграммами через локальную сеть. Облачный сервер для базовой работы интеграции не требуется.

Практическое преимущество: связь между Home Assistant и KNX может полностью работать локально, без доступа в интернет.

KNX/IP Interface или KNX/IP Router

Оба устройства позволяют связать KNX TP с IP-сетью, но работают несколько по-разному.

Характеристика	KNX/IP Interface	KNX/IP Router
Доступ к KNX через IP	Да	Да
KNXnet/IP Tunneling	Да	Обычно да
KNXnet/IP Routing	Нет	Да
Работа как связующее устройство топологии KNX	Нет	Да
Multicast	Для обычного tunneling не требуется	Используется при routing

Для обычного дома или квартиры чаще всего достаточно KNX/IP Interface. Если IP используется как часть топологии KNX или требуется KNXnet/IP Routing, нужен Router.

KNX Tunneling и Routing: что выбрать

Tunneling

При tunneling Home Assistant создает логическое соединение с конкретным KNX/IP устройством. Официальная документация Home Assistant рекомендует tunneling как стандартный вариант подключения.

Поддерживаются:

UDP Tunneling;
TCP Tunneling;
Secure Tunneling.

Современные интерфейсы могут иметь несколько tunnel endpoints. Важно, чтобы один endpoint одновременно использовал только один клиент.

Не стоит назначать Home Assistant тот же туннельный endpoint, который постоянно используется ETS или другой системой визуализации.

Routing

KNXnet/IP Routing передает телеграммы через IP Multicast. Home Assistant становится участником KNX IP-сети и обменивается телеграммами через KNX/IP Router.

При Routing Home Assistant должен иметь уникальный Individual Address. В ETS рекомендуется добавить dummy device с тем же Individual Address и связать с ним используемые Home Assistant групповые адреса.

Это важно в том числе для корректного формирования filter tables линейных и магистральных coupler.

Что выбрать

Для большинства домов

KNX/IP Tunneling проще и обычно является оптимальным решением.

Для сложной KNX-топологии

Routing может быть удобнее, если IP уже используется как backbone.

Зачем нужен ETS

ETS является официальным программным обеспечением для проектирования, конфигурирования и ввода KNX-систем в эксплуатацию.

Именно в ETS задаются:

топология KNX;
Individual Address устройств;
параметры устройств;
Group Address;
связи коммуникационных объектов;
Datapoint Type;
KNX Secure;
параметры KNX/IP устройств.

Home Assistant не является заменой ETS. Он использует уже созданную KNX-инфраструктуру.

Что такое Group Address в KNX

Group Address, или групповой адрес, используется для логической связи между функциями KNX.

Например:

1/1/1 = Свет кухни, включение

К этому адресу может быть привязан коммуникационный объект настенной кнопки и соответствующий объект релейного актуатора.

Когда кнопка отправит значение 1 в 1/1/1, актуатор включит освещение.

Форматы групповых адресов

KNX поддерживает несколько способов представления Group Address:

1/2/3 — трехуровневый;
1/25 — двухуровневый;
свободная структура.

Сама структура является способом представления и организации адресов. KNX Association рекомендует строить Group Address исходя из функциональной структуры проекта, а не подгонять функции под выбранную схему адресации.

Удобная структура для дома

Главная группа	Назначение
0/x/x	Центральные функции
1/x/x	Освещение
2/x/x	Жалюзи и шторы
3/x/x	Отопление и климат
4/x/x	Вентиляция
5/x/x	Сигналы и состояния
6/x/x	Энергия и измерения

Это только пример организации. Универсальной обязательной структуры групповых адресов для каждого объекта нет.

Что такое DPT и почему без него Home Assistant может показывать ерунду

DPT, Datapoint Type, определяет смысл и формат данных, передаваемых внутри KNX-телеграммы.

Один и тот же набор байтов без правильного DPT невозможно корректно интерпретировать как температуру, процент, состояние или другое значение.

Применение	Пример DPT
Включить / выключить	DPT 1
Управление диммированием	DPT 3
Процентное значение	DPT 5.001
Температура	Обычно DPT 9.001
Время	DPT 10.001
Дата	DPT 11.001
Текст	DPT 16
Номер сцены	DPT 17

DPT должен соответствовать коммуникационным объектам реального оборудования. Нельзя выбирать его в Home Assistant только потому, что полученное число визуально кажется правильным.

Ошибка DPT может приводить к неправильным значениям, некорректному управлению и странному поведению автоматизаций.

В Home Assistant 2026.8 в KNX Panel появился встроенный справочник DPT, что заметно упрощает диагностику и создание сущностей.

address и state_address: одна из самых важных настроек KNX

Рассмотрим обычное реле освещения.

address используется Home Assistant для отправки команды:

1/1/1 → включить или выключить свет

Но знание отправленной команды еще не означает знание фактического состояния выходного канала.

Поэтому желательно использовать отдельный групповой адрес обратной связи:

1/1/101 → фактическое состояние канала

И уже его задавать как state_address.

Почему это важно

Состояние исполнительного устройства может измениться:

с другой настенной клавиши;
через сцену KNX;
по внутреннему таймеру актуатора;
через ETS;
из другой системы автоматизации;
из-за внутренней логики устройства.

Если Home Assistant ориентируется только на собственную последнюю команду, интерфейс может показывать неправильное состояние.

Правильный подход: для важных исполнительных функций использовать отдельный объект status/feedback актуатора и назначать его state_address.

Что изменилось в Home Assistant 2026.8

Сущности KNX без отдельного state_address могут восстанавливать последнее состояние после перезапуска Home Assistant.

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

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

Подключите KNX/IP устройство. Оно должно иметь доступ одновременно к KNX и локальной IP-сети.
Проверьте сетевую доступность. Home Assistant и KNX/IP Interface или Router должны иметь возможность обмениваться локальным IP-трафиком.
Откройте Home Assistant. Перейдите в Настройки → Устройства и службы.
Добавьте интеграцию KNX. В большинстве случаев Home Assistant обнаруживает подходящее KNX/IP устройство автоматически.
Выберите способ подключения. Для обычного объекта обычно используется Tunneling.
Выберите tunnel endpoint. На современных интерфейсах он может настраиваться отдельно.
Импортируйте KNX Project. Это существенно упрощает работу с адресами, названиями и DPT.
Добавьте нужные сущности. Проверьте управление и получение состояния.

Зачем импортировать KNX Project из ETS

Home Assistant может работать и с вручную введенными групповыми адресами, но импорт проекта ETS дает значительно больше информации.

Home Assistant получает:

названия Group Address;
Datapoint Type;
структуру проекта;
сведения об устройствах;
Individual Address;
связи KNX-проекта.

В результате KNX Panel может показывать не просто 3/2/14, а понятное имя функции и правильный тип данных.

Это особенно важно для диагностики

При входящей телеграмме Home Assistant способен показывать название источника, назначения и декодированное значение, если нужная информация присутствует в данных проекта.

KNX IP Secure и KNX Data Secure

Home Assistant поддерживает KNX IP Secure и KNX Data Secure. Это две связанные, но разные технологии.

KNX IP Secure

Защищает KNX-коммуникацию на IP-уровне. Актуально для KNX/IP Tunneling и Routing.

KNX Data Secure

Защищает данные между поддерживающими Secure устройствами на уровне KNX-приложения.

KNX Association указывает, что KNX Secure использует современные криптографические механизмы для защиты от чтения и модификации KNX-коммуникации.

.knxkeys

Для защищенного проекта ETS может экспортировать Keyring-файл с расширением .knxkeys.

Home Assistant умеет импортировать этот файл. Для Data Secure учетные данные берутся именно из Keyring.

Не публикуйте .knxkeys. Это файл с чувствительной информацией безопасности KNX-проекта. Его нельзя выкладывать на сайт, форум, GitHub или отправлять посторонним.

Если в проект добавляются новые защищенные Group Address или меняются Secure-настройки, Keyring необходимо экспортировать повторно и обновить в Home Assistant.

KNX telegram: главный инструмент диагностики

KNX работает посредством телеграмм. Home Assistant может отслеживать входящие и исходящие сообщения KNX в реальном времени.

Для каждой телеграммы полезно смотреть:

source;
destination;
direction;
telegram type;
DPT;
raw payload;
декодированное value.

Что означает source

Это Individual Address устройства, отправившего телеграмму. Например:

1.1.27

Что означает destination

Это Group Address назначения:

1/1/1

GroupValueWrite

Телеграмма записывает новое значение в групповой адрес. Обычное включение света является типичным примером.

GroupValueRead

Устройство или Home Assistant запрашивает текущее значение.

GroupValueResponse

Другой участник KNX отвечает на запрос GroupValueRead.

Send telegram в Home Assistant 2026.8

В KNX Panel теперь можно вручную отправить KNX telegram. Это очень удобно при диагностике.

Например, можно отправить значение 1 в групповой адрес освещения и проверить, включится ли релейный актуатор.

Ручная отправка KNX-телеграмм требует понимания Group Address и DPT. Не следует отправлять произвольные значения в неизвестные адреса рабочей установки.

Практические примеры KNX + Home Assistant

Пример 1. Освещение

Команда: 1/1/1
Состояние: 1/1/101
DPT: 1.xxx

Home Assistant отправляет команду на адрес управления, а фактическое состояние получает с объекта status актуатора.

Пример 2. Температура

Group Address: 3/1/20
Назначение: температура гостиной
DPT: 9.001

Home Assistant может использовать температуру KNX не только для отображения, но и в автоматизациях с вентиляцией, кондиционером или другими системами.

Пример 3. Центральное отключение света

Базовую команду «Выключить весь свет» разумно реализовать непосредственно в KNX, чтобы функция работала независимо от Home Assistant.

Home Assistant при этом может отправлять ту же центральную команду по дополнительному условию, например при постановке дома в режим «Никого нет».

Пример 4. Жалюзи по положению солнца

KNX управляет приводами и локальными кнопками. Home Assistant получает положение солнца и прогноз погоды и при необходимости отправляет KNX-команды на затенение.

Пример 5. KNX + Zigbee

Zigbee-датчик протечки Home Assistant может использовать как внешний источник события, после которого через KNX закрывается электропривод водоснабжения.

При проектировании защитных функций необходимо отдельно оценивать, допустима ли зависимость функции от Home Assistant и беспроводного устройства. Критические функции безопаснее реализовывать максимально автономно.

Типовые ошибки при подключении KNX к Home Assistant

1. Неправильный DPT

Адрес найден правильно, но Home Assistant неверно декодирует значение. Нужно проверить DPT в ETS.

2. Нет state_address

Команда работает, но состояние Home Assistant расходится с фактическим состоянием актуатора.

3. Один tunneling endpoint используют два клиента

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

4. Неправильный Individual Address

Особенно критично при Routing. Адрес Home Assistant не должен дублировать другой участник KNX.

5. Filter Table не пропускает нужные Group Address

Проблема характерна для проектов с coupler и сложной топологией. Адрес необходимо корректно связать в ETS.

6. Secure Group Address не работает

Нужно проверить Keyring, привязку адреса к tunnel endpoint или dummy device и актуальность Secure-конфигурации.

7. VLAN блокирует KNX

Если Home Assistant и KNX/IP находятся в разных VLAN, маршрутизация, firewall и multicast должны быть настроены корректно.

8. Home Assistant используют вместо KNX-логики

После отключения сервера перестают работать базовые функции здания. Архитектуру лучше строить иначе.

Что лучше оставлять в KNX, а что переносить в Home Assistant

Функция	Предпочтительное место
Настенная кнопка → свет	KNX
Кнопка → жалюзи	KNX
Базовый термостат помещения	KNX
Центральное выключение света	KNX
Сценарий KNX + Zigbee + Matter	Home Assistant
Мобильный интерфейс	Home Assistant
История и графики	Home Assistant
Прогноз погоды → жалюзи	Home Assistant + KNX
Солнечная генерация → управление нагрузкой	Home Assistant + KNX

Хорошая архитектура строится так, чтобы отказ Home Assistant уменьшал «интеллектуальные» возможности дома, но не превращал обычные выключатели и инженерные системы в неработоспособные устройства.

Диагностика: KNX не работает в Home Assistant

Проверить сам KNX. Работает ли функция непосредственно с настенной клавиши?
Открыть Group Monitor ETS. Есть ли нужная телеграмма на шине?
Проверить Group Address. Совпадает ли он с Home Assistant?
Проверить DPT. Правильно ли декодируется payload?
Проверить KNX/IP. Доступно ли устройство из сети Home Assistant?
Проверить tunneling endpoint. Не занят ли он другим клиентом?
Проверить KNX Panel. Видит ли Home Assistant входящие telegram?
Проверить Secure. Актуален ли .knxkeys и разрешен ли нужный Group Address?

Такой порядок позволяет сначала отделить проблему KNX-шины от проблемы IP-сети и только затем искать ошибку в Home Assistant.

Частые вопросы

Нужен ли ETS для Home Assistant?

Для работы Home Assistant с уже настроенной KNX-системой некоторые сущности можно создать вручную. Но для полноценного проектирования и конфигурирования KNX используется ETS. Импорт проекта ETS также значительно упрощает интеграцию с Home Assistant.

Можно ли подключить Home Assistant прямо к KNX-шине?

Обычно используется KNX/IP Interface или KNX/IP Router, через который Home Assistant получает доступ к KNX.

Что лучше: KNX/IP Interface или Router?

Для большинства небольших и средних объектов достаточно KNX/IP Interface с tunneling. Router нужен, когда требуется KNXnet/IP Routing или он является частью топологии KNX.

Работает ли KNX без интернета?

Да. KNX является локальной системой. Связка KNX и Home Assistant через локальный KNX/IP также может работать без интернета.

Что такое state_address?

Это групповой адрес, с которого Home Assistant получает состояние функции. Для исполнительных устройств желательно использовать реальный объект обратной связи актуатора.

Можно ли использовать один Group Address как address и state_address?

Да, в некоторых конфигурациях это возможно, если актуатор отправляет состояние на этот же адрес и значение можно прочитать с KNX-шины. При наличии отдельного объекта status обычно предпочтительнее использовать его.

Поддерживает ли Home Assistant KNX Secure?

Да. Поддерживаются KNX IP Secure и KNX Data Secure. Для защищенных проектов может использоваться Keyring-файл .knxkeys, экспортированный из ETS.

Почему Home Assistant показывает неправильное состояние света?

Частая причина заключается в отсутствии корректного state_address. Home Assistant знает отправленную команду, но не получает фактическое состояние исполнительного канала KNX.

Можно ли управлять Zigbee-устройством с KNX-кнопки?

Да. Home Assistant может отследить KNX telegram от кнопки и запустить действие для Zigbee, Matter, Wi-Fi или другой поддерживаемой системы.

Вывод

KNX и Home Assistant хорошо дополняют друг друга, если правильно разделить ответственность систем.

KNX целесообразно оставить нижним надежным уровнем автоматизации: клавиши, исполнительные устройства, освещение, жалюзи, отопление и основные локальные функции.

Home Assistant становится верхним интеграционным уровнем: визуализация, смартфон, аналитика, сложные сценарии, видеонаблюдение, Zigbee, Matter, энергетика, зарядные станции и другие внешние системы.

При настройке особое внимание следует уделять Group Address, DPT, реальным адресам обратной связи, KNX/IP соединению и Secure-конфигурации. Именно ошибки в этих местах чаще всего приводят к ситуации, когда «команда работает, но состояние неправильное» или Home Assistant вообще не видит часть KNX-телеграмм.