KNX Light

KNX Light configuration and functionality are applicable to Shelly Light components.

Configuration

Properties:

Property	Type	Description
cmd(command)	object	Collection of KNX group addresses on which the component listens for commands from KNX. Property Type Description control array of strings List of KNX group addresses on which command to turn the light on/off is expected. value array of strings List of KNX group addresses on which one byte value command (percent scaled to 0..255) to set absolute brightness is expected. dimming array of strings List of KNX group addresses on which relative dimming command (4-bit direction+step) is expected.
fb(feedback)	object	Collection of KNX group addresses to which component reports its state to KNX. Same addresses may be used by KNX to query component via GroupValueRead requests. Property Type Description status array of strings List of KNX group addresses to report light state (on/off). brightness array of strings List of KNX group addresses to report absolute brightness value in percent (scaled to 0..255). apower array of strings List of KNX group addresses to report active power in W. only for PM components. current array of strings List of KNX group addresses to report electrical current in A. only for PM components. voltage array of strings List of KNX group addresses to report electrical potential in V. only for PM components. aenergy array of strings List of KNX group addresses to report total consumed energy in W/h. only for PM components.

Functionality

• control - GroupValueWrite requests from KNX to these addresses turn the Shelly light component on/off.

• value - GroupValueWrite requests from KNX to these addresses set the Shelly light component brightness value to the supplied one.

• dimming - GroupValueWrite requests from KNX to these addresses cause the Shelly light component to dim up or down. There are start and stop commands which include 1-bit direction (1 for up and 0 for down) and 3-bit step specifying the interval (0 denotes stop command and non-zero denotes start command. Currently any non-zero value will trigger full dimming, steps are not supported).

• status - Turning Shelly light on/off from external source results in sending GroupValueWrite request to KNX. Initial status is also sent on boot and when connected to the KNX router. If set to null will default to the first address of cmd/control.

• brightness - Any change in Shelly light brightness value caused by external source results in sending GroupValueWrite request to KNX with the changed value. Initial brightness value is also sent on boot and when connected to the KNX router. 0 is sent when the light is off. If set to null will default to the first address of cmd/value.

• apower - Any change in the reported value from the power meter results in sending GroupValueWrite request with the changed value to KNX. Current value is also sent on boot and when connected to the KNX router or when turning the switch on/off. Turning the switch off sends 0.

• current - Any change in the reported value from the power meter results in sending GroupValueWrite request with the changed value to KNX. Current value is also sent on boot and when connected to the KNX router or when turning the switch on/off. Turning the switch off sends 0.

• voltage - Any change in the reported value from the power meter results in sending GroupValueWrite request with the changed value to KNX. Current value is also sent on boot and when connected to the KNX router or when turning the switch on/off. Turning the switch off sends 0.

• aenergy - Accummulated total is sent periodically via GroupValueWrite requests to KNX. Current total is also sent on boot and when connected to the KNX router.