Integratie van het Shelly Motion-apparaat met Ilevia

Hoe je de Shelly Motion-sensor integreert met de Ilevia-server via MQTT: configuratie van het apparaat, de gateway en de componenten in Ilevia Manager.

Inleiding

De Shelly Motion is een apparaat van de eerste generatie Shelly-producten. Naast bewegingsdetectie meldt het ook andere informatie, zoals vibratiedetectie bij sabotage, luxmeting en meer. In deze handleiding wordt uitgelegd hoe je al deze informatie met de Ilevia-server integreert via MQTT.

Configuratie van de webinterface

Stap 1:

Verbind met de webinterface van Shelly: open een browser, voer het IP-adres van het Shelly-apparaat in de adresbalk in en druk op Enter.

Webinterface van het Shelly Motion-apparaat

Stap 2:

Ga naar het menu “Internet & Security” en open daarna het menu MQTT setting.

Hoe je het MQTT-instellingenmenu van het Shelly Motion-apparaat opent om het met Ilevia te integreren

Stap 3:

Vink “Enable MQTT” aan, voer het IP-adres van je Ilevia-server in het tekstveld “Server” in, stel de QoS in op 1 en klik ten slotte op Save.

Instelling van de MQTT-configuratie om de communicatie tussen de Ilevia-server en het Shelly-apparaat tot stand te brengen

Projectconfiguratie in Ilevia Manager

Stap 4:

1. Open Ilevia Manager en maak een nieuwe gateway aan; 2. stel het protocol van de gateway in op MQTT broker; 3. stel het serveradres in op localhost; 4. stel ten slotte de QoS in op “At most once”.

Aanmaken van een MQTT-gateway binnen de configuratiesoftware van Ilevia Manager.

Stap 5:

1. Ga in Ilevia Manager naar de sectie Componenten. 2. Open het vervolgmenu Base binnen de “Componentenbibliotheek”. 3. Voeg een nieuw component Gekleurde info toe aan het project. Zorg er ten slotte voor dat in het component de zojuist aangemaakte MQTT-gateway is ingesteld.

Toevoegen van het component gekleurde info om de status van de bewegingssensor te ontvangen binnen de configuratiesoftware van Ilevia Manager.

Stap 6:

De volgende stap is het instellen van de Topic Event. Dit component toont de informatie van het Shelly-apparaat in de vorm van een status. Het gebruikte topic is het volgende: shellies/shellymotion2-<device-ID>/status, waarbij <device-ID> moet worden vervangen door de ID van het Shelly-apparaat. Voeg ten slotte het benodigde script toe voor het parseren van de payload afkomstig van het Shelly-apparaat.

Klik op de link om de configuraties van het topic en het script te bekijken.

Configuratie van het topic van het component gekleurde info om de status van de Shelly Motion-bewegingssensor te ontvangen.

Stap 7:

Voeg een tweede component Gekleurde info toe aan het project. Het gebruikte topic is het volgende: shellies/shellymotion2-<device-ID>/status, waarbij <device-ID> moet worden vervangen door de ID van het Shelly-apparaat. Voeg ten slotte het benodigde script toe voor het parseren van de payload afkomstig van het Shelly-apparaat.

Klik op de link om de configuraties van het topic en het script te bekijken.

Configuratie van het topic van het component Gekleurde info om de status van het Shelly-apparaat te ontvangen

Stap 8:

Voeg een nieuw component Info toe aan het project. Dit component toont de temperatuur van de omgeving waarin het apparaat is geplaatst. Het gebruikte topic is het volgende: shellies/shellymotion2-<device-ID>/status, waarbij <device-ID> moet worden vervangen door de ID van je Shelly-apparaat. Voeg ten slotte het benodigde script toe voor het parseren van de payload afkomstig van het Shelly-apparaat.

Klik op de link om de configuraties van het topic en het script te bekijken.

Configuratie van het component info om de omgevings-temperatuurwaarde van het Shelly-component te ontvangen binnen de configuratiesoftware van Ilevia Manager.

Stap 9:

Voeg een nieuw component Info toe aan het project. Dit component toont de waarde in Lux van de omgeving waarin het apparaat is geplaatst. Het te configureren topic is het volgende: shellies/shellymotion2-<device-ID>/status, waarbij <device-ID> moet worden vervangen door de ID van het Shelly-apparaat. Voeg ten slotte het script toe dat de payload van het Shelly-apparaat parseert.

Klik op de link om de configuraties van het topic en het script te bekijken.

Configuratie van het component info om de luxsensorwaarde van het Shelly-apparaat te ontvangen binnen de configuratiesoftware van Ilevia Manager.

Stap 10:

Voeg een nieuw component Info toe aan het project. Dit component toont het batterijniveau van het apparaat. Het te configureren topic is het volgende: shellies/shellymotion2-<device-ID>/status, waarbij <device-ID> moet worden vervangen door de ID van je Shelly-apparaat. Voeg ten slotte het script toe dat de payload van het Shelly-apparaat parseert.

Klik op de link om de configuraties van het topic en het script te bekijken.

Configuratie van het component Info voor weergave van de batterijniveauwaarde van het Shelly Motion-apparaat binnen de configuratiesoftware van Ilevia Manager.

Stap 11:

Voeg een nieuw component Info toe aan het project. Dit component toont de waarde van de verlichting van de omgeving waarin het apparaat is geplaatst. Het te configureren topic is het volgende: shellies/shellymotion2-<device-ID>/status, waarbij <device-ID> moet worden vervangen door de ID van je Shelly-apparaat. Voeg ten slotte het script toe dat de payload van het Shelly-apparaat parseert.

Klik op de link om de configuraties van het topic en het script te raadplegen.

Configuratie van het Info-component voor weergave van de waarde van de omgevingsverlichting van het Shelly motion-apparaat binnen de configuratiesoftware van Ilevia Manager.

Weergave in de interface

Hier kunt u enkele voorbeelden zien van hoe de componenten kunnen worden weergegeven in de interfaces van de Ilevia Remote Plus-applicatie (Klassiek en op kaarten).

Klassieke gebruikersinterface

Klassieke weergave van de componenten die zijn geconfigureerd met het Shelly motion-apparaat binnen de Ilevia Remote Plus-applicatie.

Gebruikersinterface op kaarten

Componenten ingesteld met MQTT-protocol binnen de Ilevia-applicatie | Weergave op kaarten

Klik op de onderstaande link om het demo-project van de Shelly Motion te downloaden.

Download het demo-project.

Laatst bijgewerkt: