Shelly Dimmer device integration with Ilevia

How to connect a Shelly Dimmer device to the Ilevia system via MQTT and control switching on/off and brightness from Ilevia Manager.

Introduction

The Shelly Dimmer lets you control the brightness of lamps.

With a single device, you can turn a light on or off and control its brightness.

Step 1:

After making the necessary connections, connect to the hotspot created by the device and enter the device's default IP address (192.168.33.1) in the browser address bar.

How to connect to the shelly device web interface

Step 2:

To set Wi-Fi client mode:

1. Go to Internet & Security settings.

2. Select WiFi client.

3. Select the Connect the Shelly device to an existing WiFi network checkbox.

How to set the shelly device to wifi client mode

Step 3:

To set the MQTT protocol on the device:

1. Internet & Security settings

2. Advanced - Developer settings

3. Select the Enable action execution via MQTT checkbox.

4. Set the server IP address.

5. Set the Quality of Service (QoS) to 2.

How to set the MQTT protocol within the web interface

Step 4:

Open your configuration software (Ilevia Manager) and create a new MQTT gateway: this guide explains how to do it.

Creating the MQTT gateway within the configuration software

Step 5:

Add a Switch component to the project and change its gateway to the one you created.

How to change the gateway for components within the configuration software

Step 6:

Set the topic: you can check the topic structure on the Shelly website.

Each of the three configured topics is explained in detail in the file indicated below.

Click this link to view the topics shown.

How to set the topics within the components

HOW TO SET THE DIMMING FUNCTION

Step 7:

To set up the dimmer function on a light with Shelly MQTT, add a Slider component to the project.
Change the component gateway to the MQTT gateway.
Set the topics as shown in the image below.

Click this link to view the topics shown.

How to set the topics in the dimmer component within the Ilevia Manager configuration software

Step 8:

Add a Dimmer component to the project and select the two Switch and Slider components from the respective drop-down menus within the component.

How to set components with the MQTT protocol within the Ilevia automation software

Step 9:

Let's verify that everything has been configured correctly: download and install the MQTT fx debug software (see the guide).
Subscribe to the topic: shellies/shellydimmer-<deviceID>/light/0/#
and try turning the light on and off.
You should see the messages exchanged between the devices.

Setting up the MQTT fx debug software

TROUBLESHOOTING

1- Make sure you have the latest available version of Ilevia Manager and the X1 server firmware.

2- Make sure the Shelly device is correctly connected to your network.

3- If you cannot connect to the broker, check that your X1 has been configured correctly.

Learn more about our Shelly dedicated solution.

Get in touch with us.

FAQ:

My device does not connect to my Wi-Fi

Check that your network has no restrictions or IP address assignment issues and that the entered credentials are correct.

Last updated: