KNX Cover

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

note

Cover support is available as of version 1.6.0-beta1.

Configuration

Properties:

Property	Type	Description
cmd	object	Collection of KNX group addresses on which the component listens for commands from KNX. Property Type Description move array of strings List of KNX group addresses to engage movement (open[0]/close[1]). pause array of strings List of KNX group addresses to stop movement (regardless of value). If slat control is enabled and the cover is not moving the same addresses are used to open[0] or close[1] slats with one step as configured in the cover component. pos array of strings List of KNX group addresses to set absolute postion (0%=open/100%=close, scaled to 0..255). slat_pos array of strings List of KNX group addresses to set absolute slats postion if slat control is enabled (0%=open/100%=close, scaled to 0..255).
fb	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 dir array of strings List of KNX group addresses to report last directon of movement (open[0]/close[1]). movement array of strings List of KNX group addresses to report moving state (stopped[0]/moving[1]). pos_val array of strings List of KNX group addresses to report current absolute postion (0%=open/100%=close, scaled to 0..255). slat_val array of strings List of KNX group addresses to report current absolute slats postion if slat control is enabled (0%=open/100%=close, scaled to 0..255). obst array of strings List of KNX group addresses to report obstruction alarm (0=no_obstruction/1=obstruction). apower array of strings List of KNX group addresses to report active power in W. current array of strings List of KNX group addresses to report electrical current in A. voltage array of strings List of KNX group addresses to report electrical potential in V. aenergy array of strings List of KNX group addresses to report total consumed energy in W/h.

Functionality

• move - GroupValueWrite requests from KNX to these addresses start openeing or closing the cover until stopped or reached end position.

• puase - GroupValueWrite requests from KNX to these addresses stop the cover movement or move slats with one step if slat control is enabled and the cover is not moving.

• pos - GroupValueWrite requests from KNX to these addresses advance the cover to the specified position.

• slat_pos - GroupValueWrite requests from KNX to these addresses move the slats to the specified position if slat control is enabled.

• dir - Changing Shelly cover direction of movement results in sending GroupValueWrite request to KNX with the direction value. Last known direction is also sent on boot and when connected to the KNX router.

• movement - Changing Shelly cover state (moving/not moving) results in sending GroupValueWrite request to KNX. State is also sent on boot and when connected to the KNX router.

• pos_val - Changing Shelly cover position results in sending GroupValueWrite request to KNX with the new position. Initial position is also sent on boot and when connected to the KNX router. If set to null will default to the first address of cmd/pos.

• slat_val - Changing Shelly cover slats position results in sending GroupValueWrite request to KNX with the new slats position if slat control is enabled. Initial position is also sent on boot and when connected to the KNX router. If set to null will default to the first address of cmd/slat_pos.

• obst - Detecting Shelly cover obstruction present results in sending GroupValueWrite request to KNX with setting or clearing alarm. Obstruction presence is also reported on boot and when connected to the KNX router.

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

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

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

• aenergy - Accummulated total is sent after each movement of the Cover via GroupValueWrite requests to KNX. Current total is also sent on boot and when connected to the KNX router.