Configuration of Outputs
Outputs
Shelly devices containing an output switch or light component have built in associated input for user input for control. When using device outputs for integration into a KNX system the recommendation is to de-associate the input from the output and continue with the described configuration method below.
In case the pair of input and output can not be de-associated keep in mind that the internal to the Shelly device logic and the logic implemented in the KNX system will execute in parallel.
Regardless of the configuration of the Input/Output settings, every output represented into KNX as Switch object always have the following KNX access flags:
write - other KNX devices may write to this object
transmit - object transmits state upon every status change to the KNX network
In the right side of every Group address field two buttons are available - Save and Delete, giving you the option either to save or delete the entered configuration.
Keep in mind that entered Group addresses must share the same DPT type. Shelly embedded web interface can not check that!
Up to three Group addresses may be added for every command object, which represents an output. These command objects inherit the access flags mentioned above.
Each Group address assigned represents separate command object, meaning that it has its Sending attribute always Enabled, a.k.a. Sending Group Address!
The Group address assigned to Feedback object is used to “write” the current state of Shelly Output, i.e. ON or OFF.
Only one Group address may be assigned to Feedback object.
How to configure an Input to be detached from an Output
To limit side effect of internal to the Shelly device logic conflicting with the KNX programmed logic this is the recommended mode of operation.
Navigate to the Output configuration, Input/Output settings and select the Detached option
NOTE: In case device inputs are not used disregard this step.
Configuring Output Component for KNX Communication
Navigate to the KNX configuration section and select Outputs from the menu.
Configure the switching actuator
Step 1 - Switch object
The Switch object is used to command the state of the output relay. The relay is energized by receiving logical “1” and de-energized respectively with logical “0”.
Encoding: 1-bit; DPT 1.001 (switch)
To add aGroup address to the Switch object press the Add button. Provide the desired Group address in the newly appeared field and then click on Save button.
Step 2 - Feedback object
The Feedback object serves to provide the state of the output relay (energized/de-energized) to other KNX devices present in the given Group address. By default the check-box for Same as ... object is active, meaning that the device is going to "write" its own state upon every change at the Group Address provided in the Switch object field.
If you wish to add separate Group Address to the Feedback object you should uncheck the check-box Same as ... object and add the desired address in the fields provided below it. To save the new added configuration click on Save button.
Encoding: 1-bit; DPT 1.001 (switch)
NOTE: In case more than one Group address is provided for Switch object command and the check-box for Same as ... object is active, the the status of the output channel is provided to the first Group address field only!
Configure the dimming actuator
Step 1 - Switch object
Shelly dimming output uses the Switch object simply to command the state of the output - ON or OFF. The output is energized by receiving logical “1” and de-energized respectively when a logical “0” is received.
Encoding: 1-bit; DPT 1.001 (switch)
To add aGroup address to the Switch object press the Add button. Provide the desired Group address in the newly appeared field and then click on Save button.
Step 2 - Relative dimming object
A Relative dimming object allows for adjusting the brightness level of dimmable lights relative to their current state, enabling incremental/decremental adjustments for lighting control. The step value (currently set to full always, see note below) of the brightness change and the dimming direction are defined by the telegram value.
The output channel can only be switched on by relative dimming telegrams. If it is switched on and the setpoint falls below the value set in Minimum brightness on toggle in % using relative dimming telegrams, the output remains switched on at the given dimming value. When the channel is switched off and on again it starts with the preset value in Minimum brightness on toggle.
After a relative dimming telegram has been received, a new nominal value is calculated using the current value, the received dimming direction and the received step value.
Encoding: 4-bit; DPT 3.007 (dimming)
To add aGroup address to the Relative dimming object press the Add button. Provide the desired Group address in the newly appeared field and then click on Save button.
NOTE: Shelly dimmer actuators controlled via Relative dimming object currently support full dimming step only!
When a telegram containing Relative dimming object with encoded dimming step other than full is received, the step information is disregarded and the dimming output is always in full range.
Step 3 - Absolute dimming object
The absolute dimming function is used to set the required brightness directly. To do this, the Absolute dimming object of the command channel sends the desired brightness value as a percentage between 0% and 100%. The value range is divided up into 255 brightness levels. A level has a step value of approximately 0.4%. The telegrams for dimming with absolute values have a 1-byte data format (0 to 255).
The desired brightness values may fall below the limit which is defined by the Minimum brightness on toggle only if the channel is switched on. When the channel is switched off and on again it starts with the preset value in Minimum brightness on toggle.
This parameter setting prevents switching, i.e. the channel remains at the current value.
Encoding: 1-byte; DPT 5.001 (percentage)
To add aGroup address to the Absolute dimming object press the Add button. Provide the desired Group address in the newly appeared field and then click on Save button.
NOTE: Some visualization distributions (KNX servers) expect standard behavior related to this object, i.e. any manipulation of Absolute dimming object should turn ON the controlled channel to the given value, which is not the case with Shelly dimmers. Such manipulation may lead to desynchronization between the controlled channel and the visualization software used.
Step 4 - Feedback object
The Feedback object always corresponds to the current output state (ON or OFF). Dimmed corresponds to the ON setting. Every time the state changes from OFF to ON or vice versa, the current object value is sent to other KNX devices present in the given Group address. By default the check-box for Same as ... object is active, meaning that the device is going to "write" its own state upon every change at the Group Address provided in the Switch object field.
Encoding: 1-bit; DPT 1.001 (switch)
If you wish to add separate Group Address to the Feedback object you should uncheck the check-box Same as ... object and add the desired address in the fields provided below it. To save the new added configuration click on Save button.
Step 5 - Lighting level
A Lighting Level object provides real-time feedback on the current brightness level in percentage of the dimmer output, allowing users to monitor lighting levels accurately. By default the check-box for Same as ... object is active, meaning that the device is going to "write" its own state upon every change at the Group Address provided in the Absolute dimming object field.
Encoding: 1-byte; DPT 5.001 (percentage)
If you wish to add separate Group Address to the Lighting Level object you should uncheck the check-box Same as ... object and add the desired address in the fields provided below it. To save the new added configuration click on Save button.
