Skip to main content
Version: 1.0

KNX Switch

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

Configuration

Properties:

PropertyTypeDescription

cmd(command)

object

Collection of KNX group addresses on which the component listens for commands from KNX.

PropertyTypeDescription

control

array of strings

List of KNX group addresses on which command to turn the output on/off 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.

PropertyTypeDescription

status

array of strings

List of KNX group addresses to report on/off.

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.

ret_energy

array of strings

List of KNX group addresses to report total returned energy in W/h. 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 switch on/off.

  • status - Turning Shelly switch 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.

  • 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.

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

  • 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.