Skip to main content
Skip table of contents

Shelly KNX documentation

This documentation applies to Shelly devices with built-in KNXnet/IP support and access to them via a web browser.

KNXnet/IP functionality is available for selected Gen2+ devices (see table below), firmware 1.4 and later.

The KNX organization classifies all of the supported objects and the type of data they are allowed to transmit, therefore each object has a pre-defined DPT (data point type).

The length of data and its corresponding DPT is displayed in the KNX configuration interface of Shelly.

Using a Shelly device in a KNX network requires a KNXnet/IP gateway device.

Shelly devices do not support KNX Security (KNX IP Security and KNX Data Security).

Shelly device configuration may affect the available KNX options.

For the purposes of this documentation a KNXnet/IP gateway device LK-IP/KNXs REG by B.E.G. Brück Electronic GmbH was used.

Without Bulbs.png
With Bulbs - 1 working.png

Shelly FW+QA Panel.pdf (Wiring diagram of the KNX testing panel)

Shelly FW+QA GA Report.pdf (KNX Group addresses used)

KNX support in Shelly devices

What is supported?

Shelly IP devices (Wi-Fi and Ethernet) can be included in KNXnet/IP networks.

Supported as KNX objects are:

  • Inputs

  • Output actuators (Switch actuator in KNX)

  • Light actuators (Dimming actuator in KNX)

  • Measurements

Supported devices:

Device

Inputs

Outputs

Light

Measurement

Shelly Pro 1

2

1

n/a

No

Shelly Pro 1PM

2

1

n/a

Yes

Shelly Pro 2

2

2

n/a

No

Shelly Pro 2PM

2

2

n/a

Yes

Pro 3

3

3

n/a

No

Pro 4PM

4

4

n/a

Yes

Pro Dimmer 1

2

n/a

1

Yes

Pro Dimmer 2

4

n/a

2

Yes

Mini 1 GEN3

1

1

n/a

No

Mini 1PM GEN3

1

1

n/a

Yes

Shelly 1 GEN3

1

1

n/a

No

Shelly 1PM GEN3

1

1

n/a

Yes

I4 GEN3

4

n/a

n/a

No

Dimmer 0/1-10VPM GEN3

2

n/a

1*

No

  • * more than one actual luminaries can be connected and controlled as a single group

Prerequisites for setting up KNX in Shelly devices

  • Web browser

  • IP network to which the Shelly device is connected and the device IP address is known. In this case the embedded web interface is available if you visit the web address http://<device-ip>

  • Alternatively connection to the device wireless access point (AP). In this case the embedded web interface is available if you visit the address http://192.168.33.1

  • Using the device embedded web interface is described here.

Process of configuration

  • The process is a step by step configuration following the procedure as described in this documentation.

  • Certain configuration changes require a restart of firmware which is clearly indicated in the UI.

  • A notification will be displayed in the embedded web interface if a reboot is required. To continue simply click on "Reboot now" and wait for your device to boot again (approx. 3 seconds).

  • Same configuration can be done over one of the available RPC channels. There is no need or requirement to only do it manually.

  • Non valid values entered in any of the fields are outlined in red.

Developers documentation

For developers of systems that use Shelly devices who would directly integrate the devices into their platform and need information on how to control programmatically the configuration described above, please visit our API documentation site.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.