405
edits
Changes
Marked this version for translation
<languages/>
<languages/>
<translate>
<translate>
<!--T:1-->
The '''Larnitech''' integration connects the Larnitech controller with [https://www.home-assistant.io/ Home Assistant] over the local [[API2]] (WebSocket, port 2041). No cloud and no MQTT broker are needed, and changes reach both sides instantly.
The '''Larnitech''' integration connects the Larnitech controller with [https://www.home-assistant.io/ Home Assistant] over the local [[API2]] (WebSocket, port 2041). No cloud and no MQTT broker are needed, and changes reach both sides instantly.
<!--T:2-->
* All items of the project appear in Home Assistant, grouped by Larnitech rooms (areas).
* 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.
* 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 <code>SERIAL.in.larnitech.com:8443</code> is also possible.
* Connection over the internet through <code>SERIAL.in.larnitech.com:8443</code> is also possible.
== Supported controllers ==
== Supported controllers == <!--T:3-->
DE-MG, DE-MG.plus, DE-MG.knx, DE-MG.dali, Metaforsa, MF-14 (LT Setup 4.527 or newer).
DE-MG, DE-MG.plus, DE-MG.knx, DE-MG.dali, Metaforsa, MF-14 (LT Setup 4.527 or newer).
== What Home Assistant gets ==
== What Home Assistant gets == <!--T:4-->
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.
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 ==
== Connection == <!--T:5-->
<ol>
<ol>
<li>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.</li>
<li>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.</li>
</ol>
</ol>
== Integration options ==
== Integration options == <!--T:6-->
* '''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.
* '''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.
* '''Hide element types''': Larnitech item types that are not added to Home Assistant.
== Services and events ==
== Services and events == <!--T:7-->
* <code>larnitech_official.set_status</code>: sends any status to an item, for example <code>addr: "585:17"</code>, <code>status: {"state": "on", "level": 50}</code>.
* <code>larnitech_official.set_status</code>: sends any status to an item, for example <code>addr: "585:17"</code>, <code>status: {"state": "on", "level": 50}</code>.
* <code>larnitech_official.reload_devices</code>: reloads the item list after the project was changed in LT Setup.
* <code>larnitech_official.reload_devices</code>: reloads the item list after the project was changed in LT Setup.
* Wall switches, remotes and IR receivers fire the <code>larnitech_official_event</code> event and appear as event entities.
* Wall switches, remotes and IR receivers fire the <code>larnitech_official_event</code> event and appear as event entities.
== Updating from version 1.1.x ==
== Updating from version 1.1.x == <!--T:8-->
Version 1.2.0 changed the integration domain from <code>larnitech</code> to <code>larnitech_official</code>.
Version 1.2.0 changed the integration domain from <code>larnitech</code> to <code>larnitech_official</code>.
<ol>
<ol>