Integration of Shelly Plus H&T with the Ilevia server

How to configure the Shelly Plus H&T sensor (temperature, humidity, battery) via MQTT and connect it to Ilevia Manager with Info components.

Introduction

This device from Shelly’s “Plus” generation provides a complete measurement of the temperature and humidity in the area where the device has been installed. This guide explains how to configure it so that it can be integrated with your Ilevia server.

Configuration from the Shelly device web interface

Step 1:

Access the Shelly device web interface by entering its local IP address in the browser address bar.

Main web interface of the Shelly Plus HT device

Step 2:

Go to the “Settings” menu and then open the MQTT configuration menu.

How to access the MQTT settings from the Shelly Plus HT device configuration page to integrate it with the Ilevia server

Step 3:

1. Open the MQTT menu and enable Enable MQTT network; 2. do the same for Generic status update over MQTT; 3. enter the IP address of your Ilevia server; 4. finally click Save settings and restart the device.

MQTT configuration within the Shelly device user interface to integrate it with the Ilevia server.

Creating the project in Ilevia Manager

Step 4:

Go to the Gateway section in Ilevia Manager and add a new MQTT gateway. 1. Click the “+” icon in the upper-right corner of the screen. 2. Select the MQTT gateway from the drop-down menu in the gateway properties. 3. In the Address text field, set “localhost” as the IP address. 4. Finally, set Exactly once as the QoS.

Creating the MQTT protocol within the Ilevia Manager configuration software.

Step 5:

1. Go to the Components section of Ilevia Manager, 2. open the Base drop-down menu in the Component Library on the left, 3. then add an Info component.

Adding the first Info component, which will represent the temperature value

Step 6:

Make sure the component has MQTT selected as the gateway in its properties. The first topic we configure is the Event topic. This component receives the temperature value from the Shelly device through the following topic: shellyplusht-<device-ID>/status/temperature:0, where <device-ID> must be replaced with the ID of your Shelly device. Finally, add the script that parses the payload received from the Shelly device.

Click the following link to view the topic and script settings.

Configuration of the Info component that represents the temperature received from the Shelly device in Ilevia Manager

Step 7:

Add a second Info component to the project. This component will receive the humidity value from the Shelly device through the following topic: shellyplusht-<device-ID>/status/humidity:0, where <device-ID> must be replaced with the ID of your Shelly device. Finally, add the script that parses the payload received from the Shelly device.

Click the following link to view the topic and script settings.

Configuration of the Info component that represents the humidity received from the Shelly device in Ilevia Manager

Step 8:

Add a third Info component to the project. This component will receive the battery level from the Shelly device through the following topic: shellyplusht-<device-ID>/status/devicepower:0, where <device-ID> must be replaced with the ID of your Shelly device. Finally, add the script that parses the payload received from the Shelly device.

Click the following link to view the topic and script settings.

Configuration of the Info component that shows the battery level of the Shelly device in Ilevia Manager

Step 9:

Finally add the components to the user interface and upload the project to the server.

Uploading components within the Ilevia server.

Component display in the interface

This is an example of how the components can be displayed in the two interface types (Classic and Maps).

Classic User Interface

Display of components within the classic Ilevia interface.

Maps User Interface

Display of components within the Ilevia maps interface.