Home Assistant/ru

Интеграция Larnitech связывает контроллер Larnitech с Home Assistant через локальный API2 (WebSocket, порт 2041). Облако и MQTT-брокер не нужны, изменения мгновенно доходят в обе стороны.

• Все элементы проекта появляются в Home Assistant, сгруппированные по комнатам (зонам) Larnitech.
• Устройства Home Assistant, выбранные в настройках интеграции, становятся элементами Larnitech: они видны в приложении Larnitech и доступны в сценариях и Blockly.
• Можно подключаться и через интернет, по адресу SERIAL.in.larnitech.com:8443.

Поддерживаемые контроллеры

DE-MG, DE-MG.plus, DE-MG.knx, DE-MG.dali, Metaforsa, MF-14 (LT Setup 4.527 и новее).

Что получает Home Assistant

Светильники, диммеры, RGB и регулируемый белый; реле и краны воды; шторы и ворота; климат-контроллеры (режимы, уставки отопления и охлаждения, автоматизации как пресеты), кондиционеры, фанкойлы, клапаны отопления, вентиляция; датчики температуры, влажности, освещённости и CO₂; датчики движения, открытия и протечки; световые сцены; сценарии; настенные выключатели, пульты и ИК-приёмники (как события для автоматизаций). Служебные элементы не передаются.

Подключение

1. В LT Setup откройте Plugins → Home Assistant. Если API access выключен, нажмите Enable API access. На странице показаны адрес контроллера (в локальной сети и через интернет), порт и ключ API.
2. Установите HACS в Home Assistant, если его ещё нет.
3. В HACS найдите Larnitech, установите и перезапустите Home Assistant.
   Если не находится: ⋮ → Custom repositories, добавьте https://github.com/larnitech/larnitech-ha с типом Integration, установите Larnitech и перезапустите Home Assistant.
4. Нажмите Add to Home Assistant на странице плагина или откройте Настройки → Устройства и службы → Добавить интеграцию → Larnitech.
5. Введите адрес, порт 2041 и ключ API из шага 1.

Настройки интеграции

• Home Assistant devices in Larnitech: объекты Home Assistant (свет, выключатели, шторы, климат, замки, вентиляторы, датчики), которые регистрируются на контроллере как элементы Larnitech. Команды из Larnitech управляют ими в Home Assistant.
• Hide element types: типы элементов Larnitech, которые не добавляются в Home Assistant.

Службы и события

• larnitech_official.set_status: отправляет элементу любой статус, например addr: "585:17", status: {"state": "on", "level": 50}.
• larnitech_official.reload_devices: перечитывает список элементов после изменения проекта в LT Setup.
• Настенные выключатели, пульты и ИК-приёмники создают событие larnitech_official_event и видны как объекты-события.

Updating from version 1.1.x

Version 1.2.0 changed the integration domain from larnitech to larnitech_official.

1. Remove the old Larnitech integration in Settings → Devices & services.
2. Update to 1.2.0 in HACS and restart Home Assistant. Delete the custom_components/larnitech folder if it remains.
3. Add the integration again.
4. In automations and scripts replace the services with larnitech_official.* and the event with larnitech_official_event.