3,907 bytes added
, 12:36
<languages/>
The '''Matter''' plugin connects the Larnitech system with [https://csa-iot.org/all-solutions/matter/ Matter]. It works in both directions:
* Larnitech devices appear in Apple Home, Google Home, Amazon Alexa and SmartThings;
* Matter devices (including new devices paired over Bluetooth) are added to Larnitech and can be used in the app, scripts and Blockly.
The plugin runs on the controller itself. No cloud and no extra hardware are needed.
== Supported controllers ==
DE-MG.C, DE-MG.plus.C, DE-MG.knx, DE-MG.dali, MF-14.C.
== Installation ==
<ol>
<li>Make sure the latest versions of LT Setup and LT Server are installed.</li>
<li>In LT Setup open the '''Plugins''' tab and find '''Matter bridge'''.</li>
<li>Press '''Install'''. When the installation is finished, press '''Enable'''.</li>
<li>Open the plugin page. It shows the bridge status, the pairing QR code and the list of devices.</li>
</ol>
== Adding Larnitech devices to Apple Home, Google Home, Alexa, SmartThings ==
<ol>
<li>Open the Matter plugin page in LT Setup.</li>
<li>In the smart home app press ''Add accessory'' (''Add device'') and scan the QR code from the plugin page, or enter the manual pairing code.</li>
<li>Larnitech devices appear in the app, together with their current state.</li>
</ol>
Matter supports several controllers at once. To add a second app (for example, Google Home next to Apple Home), press '''Open commissioning window''' on the plugin page and scan the same QR code within about 3 minutes. The QR code and the pairing code never change.
=== What is bridged ===
{|class="wikitable"
!Larnitech item!!Matter device
|-
|[[Lamp element|lamp]], [[Light-scheme|light-scheme]]||On/Off Light
|-
|[[Dimmer-lamp|dimmer-lamp]]||Dimmable Light
|-
|[[RGB-lamp|rgb-lamp]]||Extended Color Light
|-
|[[Valve-heating|valve-heating]]||Thermostat (heating)
|-
|[[Conditioner|conditioner]], climate-control||Room Air Conditioner
|-
|[[Fancoil|fancoil]]||Fan
|-
|[[Valve|valve]]||On/Off (opened = on)
|-
|[[Blinds|blinds]], [[Jalousie|jalousie]], [[Gate|gate]]||Window Covering
|-
|[[Script|script]]||On/Off (runs the script)
|-
|[[Virtual|virtual]] (ventilation)||Room Air Conditioner
|-
|[[Temperature-sensor|temperature-sensor]]||Temperature Sensor
|-
|[[Humidity-sensor|humidity-sensor]]||Humidity Sensor
|-
|[[Illumination-sensor|illumination-sensor]]||Light Sensor
|-
|[[CO2-sensor|co2-sensor]]||Air Quality Sensor
|-
|[[Motion-sensor|motion-sensor]]||Occupancy Sensor
|-
|[[Door-sensor|door-sensor]]||Contact Sensor
|-
|[[Leak-sensor|leak-sensor]]||Water Leak Detector
|}
Items marked as system (<code>system="yes"</code>) and items that have no Matter equivalent (cameras, IR receivers and so on) are skipped.
== Adding Matter devices to Larnitech ==
<ol>
<li>Open the Matter plugin page in LT Setup.</li>
<li>In the '''Pair Matter device''' form enter the device pairing code or QR code (<code>MT:…</code>).</li>
<li>A device that is already in the network is found over the network. A new or factory-reset device is found over Bluetooth, and the plugin passes the Wi-Fi settings to it.</li>
<li>After pairing, the device appears in Larnitech as an item.</li>
</ol>
A pairing code shared from another app expires after a few minutes. If pairing fails with "Could not connect to device", share the code again and repeat.
== Troubleshooting ==
* '''The plugin page says "The Matter bridge does not answer"''': the service is still starting or has stopped. Wait a minute and press '''Reload'''. If it does not help, disable and enable the plugin.
* '''Apple Home shows the bridge as "Not Responding" after a reinstall''': the pairing data was deleted. Remove the bridge from Apple Home and pair it again with the QR code from the plugin page.
* Removing the plugin keeps its settings and pairings. They are deleted only on full removal (purge); after that all apps and devices must be paired again.