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 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.
 |  |
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 |
Pro Dimmer 0/1-10V PM | 2 | n/a | 1* | No |
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 |
DALI Dimmer 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.