KNX Quick start: различия между версиями
Brainroot (обсуждение | вклад) |
Brainroot (обсуждение | вклад) (Добавил правило) |
||
Строка 140: | Строка 140: | ||
== Взаимодействие KNX устройств с Wirenboard == | == Взаимодействие KNX устройств с Wirenboard == | ||
Настройку на стороне контроллера Wiren Board смотрите в [[MQTT_KNX_V2 | описании сервиса wb-mqtt-knx]]. | Настройку на стороне контроллера Wiren Board смотрите в [[MQTT_KNX_V2 | описании сервиса wb-mqtt-knx]]. | ||
=== настройка KNX устройств === | |||
Для примера, настраиваем канал A устройства US/U2.2 (адрес '''устройства''', индивидуальный 1.1.5) так: | Для примера, настраиваем канал A устройства US/U2.2 (адрес '''устройства''', индивидуальный 1.1.5) так: | ||
[[Image: ETS sampleProject_config_A.png |400px|thumb|right| Конфигурирование канала А как кнопки]] | [[Image: ETS sampleProject_config_A.png |400px|thumb|right| Конфигурирование канала А как кнопки]] | ||
Строка 159: | Строка 159: | ||
Это же в ETS: | Это же в ETS: | ||
[[Image: ETS sampleProject_bus monitor.png |400px|thumb|left| Мониторинг шины]] | [[Image: ETS sampleProject_bus monitor.png |400px|thumb|left| Мониторинг шины]] | ||
=== настройка KNX устройств === | |||
Настраиваем устройство в веб интерфейсе так: | |||
[[Image: ETS sampleProject_wb-mqtt-knx.conf_01.png.png |400px|thumb|right| создание группового адреса]] | |||
* '''Device ID''' будет именем '''устройства''', то есть частью пути к MQTT топику | |||
* '''Title''' - именем окна в Devices, произвольное | |||
* '''Control ID''' - именем канала устройства | |||
* '''Title''' именем канала в Devices, произвольное | |||
В '''Devices''' KNX групповой адрес выглядит так: | |||
[[Image: ETS sampleProject_devices switch.png.png |200px|thumb|left| Групповой адрес]] | |||
=== Взаимодействие с правилами === | |||
Изменение состояния контрола 1.1.5/SwitchA можно использовать для управления любыми устройствамиЮ, подключенными к контроллеру, в том числе и другими KNX устройствами. | |||
Допустим, нужно включить выход [[Wiren_Board_6#.D0.A3.D0.BD.D0.B8.D0.B2.D0.B5.D1.80.D1.81.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.B2.D1.85.D0.BE.D0.B4.D1.8B.2F.D0.B2.D1.8B.D1.85.D0.BE.D0.B4.D1.8B_A1-A4 |A1]] | |||
Правило [https://github.com/wirenboard/wb-rules | wb-rules]: | |||
<syntaxhighlight lang="bash"> | |||
//KNX_integration_01.js | |||
var KNXdev = "1.1.5/SwitchA" | |||
var WBdev ="wb-gpio/A1_OUT" | |||
defineRule("SwitchKNX_01", { | |||
whenChanged: KNXdev, //при изменении переключателя | |||
then: function (newValue, devName, cellName) { //выполняй следующие действия | |||
log.info("Устройство", devName, "контрол", cellName, "новое значение", newValue) | |||
dev[WBdev] = newValue; | |||
} | |||
}); | |||
</syntaxhighlight> | |||
вызывается при любом изменении контрола (при приходе телеграммы) и устанавливает устройство "wb-gpio/A1_OUT" в состояние указанное в телерамме. Можно убедиться в логе: | |||
[[Image: ETS sampleProject devices rule.png |200px|thumb|right| вывод в лог из правила]] | |||
== Полезные ссылки == | == Полезные ссылки == | ||
* [[MQTT_KNX_V2 | Описание сервиса wb-mqtt-knx в Вики]] | * [[MQTT_KNX_V2 | Описание сервиса wb-mqtt-knx в Вики]] | ||
* [[WBE2-I-KNX_KNX_Extension_Module | Модуль расширения WBE2-I-KNX]] | * [[WBE2-I-KNX_KNX_Extension_Module | Модуль расширения WBE2-I-KNX]] |
Версия 18:44, 11 апреля 2022
Используемое оборудование
Чтобы на примере показать работу с KNX-устрйоствами мы взяли оборудование:
- Контроллер Wiren Board 6.7.
- Модуль расширения WBE2-I-KNX.
- Термостат KNX Albrecht Jung A2178.
- Выключатель двухканальный ABB US/U2.2 Universal-Schnittstelle, 2fach.
- Блок питания KNX Mean Well KNX-20E-640.
- Компьютер с ОС Windows.
Подготовка
Контроллер
- Установите и настройте модуль расширения WBE2-I-KNX.
- Подключите шину KNX на клеммы модуля. Например, модуль установлен в разъем MOD1, значит шину нужно подключить к разъёму mod_out_1 по схеме: положительный провод на клемму O1, отрицательный — клемма O3.
- Подключите на шину блок питания KNX и термостат.
- Включите питание — светодиоды на термостате начнут мигать примерно раз в секунду (1Гц).
Компьютер
- Скачайте программу ETS5 с официального сайта.
- Проверьте, чтобы в системе был Microsoft NET framework 4.8. Если его нет — установите. В комплекте с программой идёт Microsoft NET framework 4.6, но с ним программа работает плохо.
- Установите ETS5.
- Настройте связь с контроллером. Контроллер Wirenboard будет работать в качестве шлюза в сеть KNX.
- Добавьте новый интерфейс, для этого перейдите Системная шина → Показать интерфейсы, выделите IP Tunneling и укажите имя из настроек knxd.
- Нажмите справа внизу кнопку Тест. Если вы получили ответ ОК — интерфейс настроен верно.
- Нажмите кнопку Выбрать.
Теория KNX
Адресация
Про групповые адреса и телеграммы читайте на странице KNX.
Примеры групповых адресов:
- Выключатели с адресами 0.0.1 и 0.0.2
- Реле с адресом 0.0.5
Реализация в контроллере Wiren Board
Сервис wb-mqtt-knx получает и отправляет телеграммы через knxd и модуль расширения WBE2-I-KNX.
Обнаружение KNX-устройства
Обычно адрес нового устройства на шине неизвестен.
Но его легко обнаружить:
- Из документации на термостат видно, что есть кнопка L и светодиод K, в нормальном режиме скрытые под регулятором.
- Нажимаем отвёрткой кнопку — светодиод начнёт мигать, сигнализируя от том, что устройство перешло в режим программирования.
- В программе ETS5 переходим Системная шина → Диагностирование → Индивидуальные адреса → Режим программирования и нажимаем кнопку Старт.
- После того, как устройство будет найдено — нажмите кнопку Стоп, чтобы не занимать шину.
Диагностика неисправностей
В процессе обнаружения устройств, ETS5 отправляет в KNX-шину телеграммы, которые можно отследить. Для этого нужно подписаться на топик /devices/knx/controls/data
:
mosquitto_sub -v -t /devices/knx/#
/devices/knx/controls/data/meta/type data
/devices/knx/meta/name wb-knx
/devices/knx/controls/data i:0/0/36 g:0/0/0 IndividualAddrRequest 0x00
/devices/knx/controls/data i:15/15/255 g:0/0/0 IndividualAddrResponse 0x00
/devices/knx/controls/data i:0/0/36 g:0/0/0 IndividualAddrRequest 0x00
/devices/knx/controls/data i:15/15/255 g:0/0/0 IndividualAddrResponse 0x00
/devices/knx/controls/data i:0/0/36 g:0/0/0 IndividualAddrRequest 0x00
/devices/knx/controls/data i:15/15/255 g:0/0/0 IndividualAddrResponse 0x00
/devices/knx/controls/data i:0/0/36 g:0/0/0 IndividualAddrRequest 0x00
/devices/knx/controls/data i:15/15/255 g:0/0/0 IndividualAddrResponse 0x00
Также для диагностики можно вывести телеграммы из шины с помощью knxtool:
knxtool vbusmonitor1 local:/var/run/knx
L_Busmon: B0 00 18 00 00 E1 01 00 B7 :L_Data system from 0.0.24 to 0/0/0 hops: 06 T_Data_Broadcast A_IndividualAddress_Read
L_Busmon: B0 FF FF 00 00 E1 01 40 EF :L_Data system from 15.15.255 to 0/0/0 hops: 06 T_Data_Broadcast A_IndividualAddress_Response
Ещё можно управлять светодиодом K из ETS5, для этого перейдите в меню Системная шина → Диагностирование → Индивидуальные адреса → Проверка индивидуального адреса
Создание проекта
Новый проект
Создадим в программе ETS5 проект.
Если это первый проект на этом компьютере, то нужно скачать и импортировать базу устройств:
- Скачайте базу устройств по с сайта производителя.
- Распакуйте архив и импортируйте нужные устройства.
После установки базы устройств:
- Создайте новый проект, для этого нажмите кнопку с зелёным плюсом «+».
- Укажите произвольное имя проекта.
- В разделе Топология оставьте TP (Twisted Pair).
Всё, у нас есть автоматически созданное «здание», которе называется так же как проект.
Устройство
Физическое размещение — это этаж, комната или строение.
Добавим новую комнату:
- В окне Задания, нажмите на стрелку рядом с названием функции.
- Из открывшегося списка выберем пункт Комнаты.
- Далее нажмите на кнопку Добавить комнату и введите наименование.
Теперь, когда у нас есть физическое размещения для устройства (комната), мы можем добавить само устройство:
- В окне Задания, в списке комнат выберите ту, где стоит устройство.
- Нажмите кнопку Добавить устройство. Откроется каталог устройств.
- В каталоге устройств выберите Производитель → Тип устройства и найдите наш термостат 2178TS. Здесь важно не ошибиться и выбрать устройство с полностью совпадающим наименованием — все буквы и цифры важны.
- Нажимаем кнопку Добавить.
- Смените адрес устройства. Зайдите в свойства устройства и в правой части экрана измените адрес. В нашем примере мы установили 1.1.4.
По алгоритму выше, добавьте второе устройство — выключатель. Он сразу есть в каталоге ETS5 и скачивать базу не нужно. Ему назначим адрес 1.1.5
Теперь в проекте есть два устройства.
Взаимодействие KNX устройств с Wirenboard
Настройку на стороне контроллера Wiren Board смотрите в описании сервиса wb-mqtt-knx.
настройка KNX устройств
Для примера, настраиваем канал A устройства US/U2.2 (адрес устройства, индивидуальный 1.1.5) так:
И создадим групповой адрес 1/1/55
В нотации KNX принято индивидуальные адреса записывать через точки а групповые - через слеши.
Можно сразу же загрузить в модуль прикладную программу и проверить что при замыкании входа A отправляются телеграммы на групповой адрес
knxtool vbusmonitor1 local:/var/run/knx
L_Busmon: BC 11 05 09 37 E1 00 81 09 :L_Data low from 1.1.5 to 1/1/55 hops: 06 T_Data_Group A_GroupValue_Write (small) 01
L_Busmon: BC 11 05 09 37 E1 00 80 08 :L_Data low from 1.1.5 to 1/1/55 hops: 06 T_Data_Group A_GroupValue_Write (small) 00
L_Busmon: BC 11 05 09 37 E1 00 81 09 :L_Data low from 1.1.5 to 1/1/55 hops: 06 T_Data_Group A_GroupValue_Write (small) 01
Это же в ETS:
настройка KNX устройств
Настраиваем устройство в веб интерфейсе так:
- Device ID будет именем устройства, то есть частью пути к MQTT топику
- Title - именем окна в Devices, произвольное
- Control ID - именем канала устройства
- Title именем канала в Devices, произвольное
В Devices KNX групповой адрес выглядит так:
Взаимодействие с правилами
Изменение состояния контрола 1.1.5/SwitchA можно использовать для управления любыми устройствамиЮ, подключенными к контроллеру, в том числе и другими KNX устройствами. Допустим, нужно включить выход A1 Правило | wb-rules:
//KNX_integration_01.js
var KNXdev = "1.1.5/SwitchA"
var WBdev ="wb-gpio/A1_OUT"
defineRule("SwitchKNX_01", {
whenChanged: KNXdev, //при изменении переключателя
then: function (newValue, devName, cellName) { //выполняй следующие действия
log.info("Устройство", devName, "контрол", cellName, "новое значение", newValue)
dev[WBdev] = newValue;
}
});
вызывается при любом изменении контрола (при приходе телеграммы) и устанавливает устройство "wb-gpio/A1_OUT" в состояние указанное в телерамме. Можно убедиться в логе: