EN - 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 Gen2 PRO line and Gen 3+ devices (see table below), firmware 1.4.0 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.
 |  |
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:
Listed Shelly PRO devices
Listed Shelly Gen 3 and later devices
Due to high customer interest and frequently asked questions, we would like to point out that KINXnet/IP is not supported on any Shelly Plus (Gen 2) devices!
Device | Inputs | Outputs | Light | Measurements | Notes |
|---|---|---|---|---|---|
Shelly Pro 1 | 2 | 1 | n/a | No | Supported with Firmware version 1.4.0 and later. |
Shelly Pro 1PM | 2 | 1 | n/a | Yes (5 points) | Supported with Firmware version 1.4.0 and later. |
Shelly Pro 2 | 2 | 2 | n/a | No | Supported with Firmware version 1.4.0 and later. |
Shelly Pro 2PM | 2 | 2 | n/a | Yes (5 points) | Supported with Firmware version 1.4.0 and later. Cover support will be available at later stage. |
Pro 3 | 3 | 3 | n/a | No | Supported with Firmware version 1.4.0 and later. |
Pro 4PM | 4 | 4 | n/a | Yes (5 points) | Supported with Firmware version 1.4.0 and later. |
Pro Dimmer 1PM | 2 | n/a | 1 | Yes (4 points) | Supported with Firmware version 1.4.0 and later. |
Pro Dimmer 2PM | 4 | n/a | 2 | Yes (4 points) | Supported with Firmware version 1.4.0 and later. |
Pro Dimmer 0/1-10V PM | 2 | n/a | 1* | Yes (4 points) | Supported with Firmware version 1.4.0 and later. |
I4 GEN3 | 4 | n/a | n/a | No | Supported with Firmware version 1.4.0 and later. |
Mini 1 GEN3 | 1 | 1 | n/a | No | Supported with Firmware version 1.4.0 and later. |
Mini 1PM GEN3 | 1 | 1 | n/a | Yes (5 points) | Supported with Firmware version 1.4.0 and later. |
Shelly 1 GEN3 | 1 | 1 | n/a | No | Supported with Firmware version 1.4.0 and later. |
Shelly 1PM GEN3 | 1 | 1 | n/a | Yes (5 points) | Supported with Firmware version 1.4.0 and later. |
NEW Shelly 2PM GEN3 | 2 | 2 | n/a | Yes (5 points) | Supported with Firmware version 1.5.0 and later. Cover support will be available at later stage. |
NEW Shelly Plug S GEN3 | 1 | 1 | n/a | Yes (5 points) | Supported with Firmware version 1.5.0 and later. Firmware updates are currently blocked by the CSA, the organization responsible for Matter certification! |
NEW Shelly Dimmer GEN3 | 2 | n/a | 1 | Yes (4 points) | Supported with Firmware version 1.5.0 and later. |
Dimmer 0/1-10VPM GEN3 | 2 | n/a | 1* | Yes (4 points) | Supported with Firmware version 1.4.0 and later. |
DALI Dimmer GEN3 | 2 | n/a | 1* | No | Supported with Firmware version 1.4.0 and later. |
* 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.