Документация Shelly KNX
Данная документация относится к устройствам Shelly со встроенной поддержкой KNXnet/IP и доступом через веб-браузер. Функциональность KNXnet/IP доступна для устройств линейки Gen 2 PRO и Gen 3+ (см. таблицу ниже) начиная с прошивки версии 1.4.0.
Организация KNX классифицирует все поддерживаемые объекты и типы данных, поэтому каждый объект имеет предопределённый DPT (тип точки данных). Длина данных и соответствующий DPT отображаются в интерфейсе конфигурации KNX в Shelly. Для работы устройства Shelly в сети KNX требуется шлюз KNXnet/IP. Устройства Shelly не поддерживают безопасность KNX (KNX IP Security и KNX Data Security). Конфигурация устройства Shelly может влиять на доступные параметры KNX.
В данной документации использовался шлюз KNXnet/IP LK-IP/KNXs REG производства B.E.G. Brück Electronic GmbH.
Поддержка KNX в устройствах Shelly
Поддерживаемые типы объектов KNX
ETS v6.3.0 больше не поддерживает ручное редактирование таблицы фильтров. Информация о том, как справиться с этим изменением, доступна в разделе FAQ, пункт 15.
Устройства Shelly с поддержкой KNXnet/IP могут функционировать как различные типы объектов KNX:
- Бинарные входы — отправка команд ВКЛ/ВЫКЛ или «Переключение» для управления устройствами KNX; поддержка 1-битных (короткое нажатие) и 4-битных (длительное нажатие) команд диммирования.
- Выходы переключателей — управление состояниями ВКЛ/ВЫКЛ выходов Shelly с помощью команд KNX; передача обратной связи о состоянии выхода в сеть KNX.
- Выходы освещения — управление яркостью командами относительного и абсолютного диммирования; передача текущего уровня диммирования в сеть KNX.
- Режим крышки (устройства с 2 выходами) — управление рольставнями, жалюзи и венецианскими жалюзи командами Открыть/Закрыть/Пауза; точное управление положением с обратной связью; регулировка угла наклона ламелей (только для жалюзи); генерация тревожных уведомлений при обнаружении препятствий.
- Измерения — передача ключевых электрических значений для мониторинга и управления энергопотреблением в системе KNX.
Поддерживаемые устройства
KNXnet/IP не поддерживается ни на каких устройствах Shelly Plus (Gen 2).
| Устройство | Входы | Выходы | Тип выхода | Измерения | Примечания |
|---|---|---|---|---|---|
| Shelly Pro 1 | 2 | 1 | Переключатель | Нет | Прошивка 1.4.0+ |
| Shelly Pro 1PM | 2 | 1 | Переключатель | ✓ (5 точек) | Прошивка 1.4.0+ |
| Shelly Pro 2 | 2 | 2 | Переключатель | Нет | Прошивка 1.4.0+ |
| Shelly Pro 2PM | 2 | 2 / 1 | Переключатель / Крышка | ✓ (5 точек) | Прошивка 1.4.0+ (только переключатель); поддержка крышек и жалюзи — с 1.6.0 |
| Shelly Pro 3 | 3 | 3 | Переключатель | Нет | Прошивка 1.4.0+ |
| Shelly Pro 4PM | 4 | 4 | Переключатель | ✓ (5 точек) | Прошивка 1.4.0+ |
| Shelly Dual Cover / Shutter PM | 4 | 2 | Крышка | ✓ (5 точек) | Прошивка 1.6.0+ |
| Pro Dimmer 1PM | 2 | 1 | Свет | ✓ (4 точки) | Прошивка 1.4.0+ |
| Pro Dimmer 2PM | 4 | 2 | Свет | ✓ (4 точки) | Прошивка 1.4.0+ |
| Pro Dimmer 0/1-10V PM | 2 | 1* | 0/1-10 В | ✓ (4 точки) | Прошивка 1.4.0+ |
| I4 GEN3 | 4 | н/д | н/д | Нет | Прошивка 1.4.0+ |
| Mini 1 GEN3/GEN4 | 1 | 1 | Переключатель | Нет | Прошивка 1.4.0+ |
| Mini 1PM GEN3/GEN4 | 1 | 1 | Переключатель | ✓ (5 точек) | Прошивка 1.4.0+ |
| Shelly 1 GEN3/GEN4 | 1 | 1 | Переключатель | Нет | Прошивка 1.4.0+ |
| Shelly 1PM GEN3/GEN4 | 1 | 1 | Переключатель | ✓ (5 точек) | Прошивка 1.4.0+ |
| Shelly 1L GEN3 | 2 | 1 | Переключатель | Нет | Прошивка 1.6.0+ |
| Shelly 2L GEN3 | 2 | 2 | Переключатель | Нет | Прошивка 1.6.0+ |
| Shelly 2PM GEN3 | 2 | 2 / 1 | Переключатель / Крышка | ✓ (5 точек) | Прошивка 1.5.0+ (только переключатель); поддержка крышек и жалюзи — с 1.6.0 |
| Shelly Shutter GEN3 | 2 | 1 | Крышка | ✓ (5 точек) | Прошивка 1.6.0+ |
| Shelly Plug S GEN3 | н/д | 1 | Переключатель | ✓ (5 точек) | Прошивка 1.7.0+ |
| Shelly Plug S Outdoor GEN3 | н/д | 1 | Переключатель | ✓ (5 точек) | Прошивка 1.7.0+ |
| Shelly Dimmer GEN3 | 2 | 1 | Свет | ✓ (4 точки) | Прошивка 1.5.0+ |
| Dimmer 0/1-10V PM GEN3 | 2 | 1* | 0/1-10 В | ✓ (4 точки) | Прошивка 1.4.0+ |
| Dimmer DALI GEN3 | 2 | 1* | DALI | Нет | Прошивка 1.4.0+ |
| Ogemray Smart Relay 25A | 1 | 1 | Переключатель | ✓ (5 точек) | Powered by Shelly. Прошивка 1.6.0+ |
* К одному выходу можно подключить несколько светильников и управлять ими как одной группой.
Предварительные условия
- Веб-браузер.
- IP-сеть с известным IP-адресом устройства Shelly — встроенный веб-интерфейс доступен по адресу http://<IP-адрес устройства>. Альтернативно: прямое подключение к точке доступа устройства, в этом случае веб-интерфейс доступен по адресу 192.168.33.1.
Процесс настройки
Настройка выполняется пошагово в соответствии с процедурой, описанной в данной документации. Для некоторых изменений конфигурации требуется перезагрузка устройства — это явно указывается в интерфейсе. При необходимости перезагрузки нажмите Перезагрузить сейчас и подождите около 3 секунд. Аналогичную настройку можно выполнить через доступные каналы RPC. Недопустимые значения в полях ввода выделяются красным цветом.
Документация для разработчиков
Разработчикам систем, которые хотят программно интегрировать устройства Shelly в свою платформу, следует обратиться к документации API на сайте shelly-api-docs.shelly.cloud.