Ubisys C4 Integrator Manual Download Page 14

3.7. Double Momentary Switch (Push Buttons) as Dimmer Switch

Related C++ class: CZigBeeDeviceSetupInputPatternDoublePushLevel.

This is a more complex recipe designed for dimming a light, or generally speaking adjusting the level
(intensity, speed, brightness, …) of a level controllable output utilizing two momentary switches (push
buttons, one stable position). Users are able to turn a light on with a short press on one button (e.g.
left button of a double switch), i.e. tapping the button for less than a second; and also dim up with a
long press on the same button, i.e. keeping the button pressed for more than a second; the second
button is used for the opposite actions, i.e. a short press on the second (e.g. right button of a double
switch) will turn the lights off; a long press on this button will dim the lights down.

The idea is that each transition from the pressed state to the released state fires an “on” command for
the first button (“off” command for the second button), and each transition from the pressed to the
kept-pressed state fires a “move with on/off” command, where the direction is “up” for the first button
(“down” for the second button). Notice that the command templates for moving also contain a
configurable move rate. Finally, a transition from the kept-pressed to the released state fires a “stop”
command (same for both buttons).

3.7.1. Examples

The following example shows the input action micro-code for using two push-buttons to control a
target dimmer (whether it be the local output or a remote device) in an up/down manner, i.e. one
button is used to turn the light(s) on and dim brighter, the other one to turn the light(s) off and dim
darker:

12

Summary of Contents for C4

Page 1: ...ZIGBEE DEVICE PHYSICAL INPUT CONFIGURATIONS INTEGRATOR S GUIDE...

Page 2: ...off Switch 8 3 5 1 Example 8 3 5 2 Example 9 3 6 Single Momentary Switch Push Button as Dimmer Switch 10 3 6 1 Examples 10 3 7 Double Momentary Switch Push Buttons as Dimmer Switch 12 3 7 1 Examples...

Page 3: ...standard the ZigBee Application Foundation including the ZigBee Cluster Library and related technologies and specifications The intended audience mainly comprises system integrators who want to take a...

Page 4: ...put and the input configured to send on commands in one position and off commands the other position or toggle commands in each position Other options include momentary push button switches with toggl...

Page 5: ...e move rates specific target levels time spans for automatically turning off to be embedded into the command templates It is also easily extensible Sending new commands or supporting new clusters does...

Page 6: ...elated C class CZigBeeDeviceSetupInputPatternSwitchToggle This is similar to the push button version but intended for switches with two stable positions Sends a toggle command on every flip It is usef...

Page 7: ...ource Endpoint 2 hosts secondary on off client cluster on C4 29 06 00 Cluster ID 0x0006 on off 30 02 ZCL Command Template Toggle 31 32 06 element 5 six bytes 33 02 InputAndOptions 0x02 34 0D Transitio...

Page 8: ...e in such a scenario is that the lights are inherently synchronized to the same final state even if they initially had different states i e the lights will be all on or all off after flipping the swit...

Page 9: ...2 Source Endpoint 2 hosts secondary on off client cluster on C4 29 06 00 Cluster ID 0x0006 on off 30 00 ZCL Command Template Off 31 32 06 element 5 six bytes 33 02 InputAndOptions 0x02 34 0D Transitio...

Page 10: ...it is frequently triggered to either turn on or remain on and thus tolerates missing an off command for equipment that could potentially be damaged or cause damage when operated continuously The idea...

Page 11: ...24 0B element 3 11 bytes 25 00 InputAndOptions 0x00 26 0D Transition released pressed 27 03 Source Endpoint 3 hosts primary on off client cluster on C4 28 06 00 Cluster ID 0x0006 on off 29 42 ZCL Comm...

Page 12: ...generally speaking adjusting the level intensity speed brightness of a level controllable output Users are able to turn a light on or off with a short press i e tapping the button for less than a seco...

Page 13: ...e Toggle 38 39 08 element 6 eight bytes 40 01 InputAndOptions 0x01 41 86 Transition pressed kept pressed has alternate 42 03 Source Endpoint 3 hosts secondary level control client cluster on D1 43 08...

Page 14: ...witch will turn the lights off a long press on this button will dim the lights down The idea is that each transition from the pressed state to the released state fires an on command for the first butt...

Page 15: ...sed 28 02 Source Endpoint 2 hosts primary on off client cluster on D1 29 06 00 Cluster ID 0x0006 on off 30 00 ZCL Command Template Turn off 31 32 08 element 5 eight bytes 33 01 InputAndOptions 0x01 34...

Page 16: ...ID 0x0102 window covering 16 02 ZCL Command Template Stop 17 18 06 element 3 six bytes 19 01 InputAndOptions 0x01 20 0D Transition released pressed 21 02 Source Endpoint 2 hosts window covering client...

Page 17: ...window covering 16 02 ZCL Command Template Stop 17 18 06 element 3 six bytes 19 01 InputAndOptions 0x01 20 0D Transition released pressed 21 02 Source Endpoint 2 hosts window covering client cluster...

Page 18: ...pressed 7 01 Source Endpoint 1 hosts primary scene client cluster on C4 8 05 00 Cluster ID 0x0005 scenes 9 05 34 12 56 ZCL Command Template Recall scene group ID 0x1234 scene ID 0x56 10 11 06 element...

Page 19: ...all other input actions a recall scene command will always be sent as groupcast to the group specified in the payload of the recall scene command The idea is that each transition from the pressed stat...

Page 20: ...1 31 32 06 element 5 six bytes 33 02 InputAndOptions 0x02 34 07 Transition pressed released 35 03 Source Endpoint 3 hosts tertiary scene client cluster on C4 36 05 00 Cluster ID 0x0005 scenes 37 05 44...

Page 21: ...e logical control unit endpoint or introduces a new endpoint with the new cluster to facilitate finding binding For the raw functionality it is not strictly required though 2 Qualified customers may l...

Page 22: ...ommand Recall scene commands are now always sent to the group ID in the payload and don t require an entry in the binding table 0 9 11 25 2014 Preliminary version for internal use only 1 0 05 31 2017...

Page 23: ...5 Contact ubisys technologies GmbH Neumannstr 10 40235 D sseldorf Germany T 49 211 54 21 55 19 F 49 211 54 21 55 99 www ubisys de info ubisys de 21...

Reviews: