Home Assistant

Other languages:

The Larnitech integration connects the Larnitech controller with Home Assistant over the local API2 (WebSocket, port 2041). No cloud and no MQTT broker are needed, and changes reach both sides instantly.

All items of the project appear in Home Assistant, grouped by Larnitech rooms (areas).
Home Assistant devices selected in the integration options become Larnitech items: they appear in the Larnitech app and can be used in scripts and Blockly.
Connection over the internet through SERIAL.in.larnitech.com:8443 is also possible.

Supported controllers

DE-MG, DE-MG.plus, DE-MG.knx, DE-MG.dali, Metaforsa, MF-14 (LT Setup 4.527 or newer).

What Home Assistant gets

Lights, dimmers, RGB and tunable white; relays and water valves; blinds and gates; climate controllers (modes, heating and cooling setpoints, automations as presets), air conditioners, fancoils, heating valves, ventilation; temperature, humidity, illumination and CO₂ sensors; motion, door and leak sensors; light schemes; scripts; wall switches, remotes and IR receivers (as events for automations). Service items are not passed on.

Connection

In LT Setup open Plugins → Home Assistant. If API access is off, press Enable API access. The page shows the controller address (local and over the internet), the port and the API key.
Install HACS in Home Assistant if it is not installed yet.
In HACS find Larnitech, install it and restart Home Assistant.
If it is not found, open ⋮ → Custom repositories, add https://github.com/larnitech/larnitech-ha with type Integration, install Larnitech and restart Home Assistant.
Press Add to Home Assistant on the plugin page, or open Settings → Devices & services → Add integration → Larnitech.
Enter the address, port 2041 and the API key from step 1.

Integration options

Home Assistant devices in Larnitech: Home Assistant entities (lights, switches, covers, climate, locks, fans, sensors) that are registered on the controller as Larnitech items. Commands from Larnitech control them in Home Assistant.
Hide element types: Larnitech item types that are not added to Home Assistant.

Services and events

larnitech_official.set_status: sends any status to an item, for example addr: "585:17", status: {"state": "on", "level": 50}.
larnitech_official.reload_devices: reloads the item list after the project was changed in LT Setup.
Wall switches, remotes and IR receivers fire the larnitech_official_event event and appear as event entities.

Updating from version 1.1.x

Version 1.2.0 changed the integration domain from larnitech to larnitech_official.

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