20 KiB
| layout | title |
|---|---|
| documentation | ZEN27 - ZWave |
{% include base.html %}
ZEN27 Z-Wave Plus S2 Dimmer Light Switch V2
This describes the Z-Wave device ZEN27, manufactured by Zooz with the thing type UID of zooz_zen27v2_02_000.
This version of the device is limited to firmware versions above 2.0
The device is in the category of Wall Switch, defining Any device attached to the wall that controls a binary status of something, for ex. a light switch.
The ZEN27 supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is also able to participate in the routing of data between other devices in the mesh network.
Overview
- Manual or Z-Wave on/off and brightness control
- Simple Direct 3-Way: connect with existing on/off switches in 3-way,4-way, and 5-way set-ups, no add-on needed (neutral wire required)
- Fully adjustable ramp rate for just the right on/off speed
- Double tap to full brightness feature
- Remembers and restores on/off status after power failure
- Built-in Z-Wave Plus signal repeater to extend network range
- Extended compatibility with LED bulbs, no more flickering!
- S2 security protocol and the latest 500 Z-Wave chip
- Customizable LED indicator and air-gap switch for added safety
Inclusion Information
- Initiate inclusion (pairing) in the app (or web interface).
- Finalize inclusion at the switch. TAP 3 TIMES QUICKLY. The LED indicator will blink to signal communication and remain on for 2 seconds to confirm inclusion.
Exclusion Information
- Bring your Z-Wave gateway (hub) close to the switch if possible
- Put the Z-Wave hub into exclusion mode
- Tap the lower paddle on the switch 3 times quickly
- Your hub will confirm exclusion and the device will disappear from your controller's device list
Channels
The following table summarises the channels available for the ZEN27 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Dimmer | switch_dimmer | switch_dimmer | DimmableLight | Dimmer |
| Scene Number | scene_number | scene_number | Number | |
| Custom Brightness Level | config_decimal | config_decimal | Number |
Dimmer
The brightness channel allows to control the brightness of a light. It is also possible to switch the light on and off.
The switch_dimmer channel is of type switch_dimmer and supports the Dimmer item and is in the DimmableLight category.
Scene Number
Triggers when a scene button is pressed.
The scene_number channel is of type scene_number and supports the Number item.
This channel provides the scene, and the event as a decimal value in the form <scene>.<event>. The scene number is set by the device, and the event is as follows -:
| Event ID | Event Description |
|---|---|
| 0 | Single key press |
| 1 | Key released |
| 2 | Key held down |
| 3 | Double keypress |
| 4 | Tripple keypress |
| 5 | 4 x keypress |
| 6 | 5 x keypress |
Custom Brightness Level
Generic class for configuration parameter.
The config_decimal channel is of type config_decimal and supports the Number item.
Device Configuration
The following table provides a summary of the 19 configuration parameters available in the ZEN27. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 1 | Paddle Control | Choose Paddle Functionality |
| 2 | LED Indicator Control | Change behavior of the LED indicator |
| 3 | Auto Turn-Off Timer | enable the Auto Turn-Off Timer |
| 4 | Auto Turn-Off Timer Duration | set Auto Turn-Off Timer Duration |
| 5 | Auto Turn-On Timer | enable the Auto Turn-On Timer |
| 6 | Auto Turn-On Timer Duration | set Auto Turn-On Timer Duration |
| 7 | Association Reports | Association Reports |
| 8 | On Off Status After Power Failure | Set the on off status for the switch after power failure. |
| 9 | Ramp Rate Control | Adjust the ramp rate for your dimmer |
| 10 | Minimum Brightness | Set the minimum brightness level % |
| 11 | Maximum Brightness | Set the maximum brightness level % |
| 12 | Double Tap Function | brightness level after you double-tap upper paddle |
| 13 | Scene enable/disable | Enable or disable scene control functionality for quick double tap triggers. |
| 14 | Enable/Disable double tap | Move double tap functionality to single tap |
| 15 | Local on/off control | Enable or disable local on/off control |
| 16 | Physical dimming speed | Physical dimming speed |
| 17 | Z-Wave ramp rate | Z-Wave ramp rate |
| 18 | Custom brightness level | Custom brightness level |
| 20 | Brightness reporting | Brightness reporting |
Parameter 1: Paddle Control
Choose Paddle Functionality Paddle Control
Parameter 1: Choose if you want the upper paddle to turn the light on or turn the light off when tapped
Values:
0 – Upper paddle turns the light on, lower paddle turns the light off (default);
1 – Upper paddle turns the light off, lower paddle turns the light on
Size: 1 byte dec. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Upper light on, lower light off |
| 1 | Upper light off, lower light on |
| 2 | Both toggle |
The manufacturer defined default value is 0 (Upper light on, lower light off).
This parameter has the configuration ID config_1_1 and is of type INTEGER.
Parameter 2: LED Indicator Control
Change behavior of the LED indicator LED Indicator Control
Parameter 2: Choose if you want the LED indicator to turn on when the switch (light) is on or off, or if you want it to remain on or off at all times
Values:
0 – LED indicator is on when switch is off, LED indicator is off when switch is on (default);
1 – LED indicator is on when switch is on, LED indicator is off when switch is off;
2 – LED indicator is always OFF
3 – LED indicator is always ON
Size: 1 byte dec.
OR
6 x TAP PADDLE to change the LED indicator mode The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | LED on when switch off, LED off when switch on |
| 1 | LED on when switch on, LED off when switch off |
| 2 | LED indicator is always OFF |
| 3 | LED indicator is always ON |
The manufacturer defined default value is 0 (LED on when switch off, LED off when switch on).
This parameter has the configuration ID config_2_1 and is of type INTEGER.
Parameter 3: Auto Turn-Off Timer
enable the Auto Turn-Off Timer Auto Turn-Off Timer
Parameter 3: Use this parameter to enable or disable the auto turn-off timer function
Values:
0 – timer disabled (default);
1 – timer enabled.
Size: 1 byte dec. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | timer disabled |
| 1 | timer enabled |
The manufacturer defined default value is 0 (timer disabled).
This parameter has the configuration ID config_3_1 and is of type INTEGER.
Parameter 4: Auto Turn-Off Timer Duration
set Auto Turn-Off Timer Duration Parameter 4: Use this parameter to set the time a?er which you want the switch to automatically turn off once it has been turned on. The number entered as value corresponds to the number of minutes.
Values: 1 – 65535 (minutes). 60 –default.
Size: 4 byte dec. Values in the range 1 to 65535 may be set.
The manufacturer defined default value is 60.
This parameter has the configuration ID config_4_4 and is of type INTEGER.
Parameter 5: Auto Turn-On Timer
enable the Auto Turn-On Timer Auto Turn-On Timer
Parameter 5: Use this parameter to enable or disable the auto turn-on timer function
Values:
0 – timer disabled (default);
1 – timer enabled.
Size: 1 byte dec. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | timer disabled |
| 1 | timer enabled |
The manufacturer defined default value is 0 (timer disabled).
This parameter has the configuration ID config_5_1 and is of type INTEGER.
Parameter 6: Auto Turn-On Timer Duration
set Auto Turn-On Timer Duration Parameter 6: Use this parameter to set the time a?er which you want the switch to automatically turn on once it has been turned off. The number entered as value corresponds to the number of minutes.
Values: 1 – 65535 (minutes). Default
set to 60.
Size: 4 byte dec. Values in the range 1 to 65535 may be set.
The manufacturer defined default value is 30.
This parameter has the configuration ID config_6_4 and is of type INTEGER.
Parameter 7: Association Reports
Association Reports Choose which physical and Z-Wave triggers should prompt the dimmer to send a status change report to associated devices.
0 – none;
1 – physical tap on ZEN27 only;
2 – physical tap on connected 3-way switch only;
3 – physical tap on ZEN27 or connected 3-way switch;
4 – Z-Wave command from hub;
5 – physical tap on ZEN27 or Z-Wave command from hub;
6 – physical tap on connected 3-way switch or Z-Wave command from hub;
7 – physical tap on ZEN27 / connected 3-way switch or Z-Wave command from hub;
8 – timer only;
9 – physical tap on ZEN27 or timer;
10 – physical tap on connected 3-way switch or timer;
11 – physical tap on ZEN27 / connected 3-way switch or timer;
12 – Z-Wave command from hub or timer;
13 – physical tap on ZEN27, Z-Wave command from hub, or timer;
14 – physical tap on ZEN27 / connected 3-way switch, Z-Wave command from hub, or timer;
15 – all of the above (Default) Values in the range 0 to 15 may be set.
The manufacturer defined default value is 15.
This parameter has the configuration ID config_7_1 and is of type INTEGER.
Parameter 8: On Off Status After Power Failure
Set the on off status for the switch after power failure. On Off Status After Power Failure
Parameter 8: Set the on off status for the switch after power failure.
Values:
0 – forced to OFF (regardless of state prior to power outage);
1 – forced to ON (regardless of state prior to power outage);
2 – remembers and restores on/off status a?er power failure (default)
Size: 1 byte dec. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | forced to OFF |
| 1 | forced to ON |
| 2 | remembers on/off status |
The manufacturer defined default value is 2 (remembers on/off status).
This parameter has the configuration ID config_8_1 and is of type INTEGER.
Parameter 9: Ramp Rate Control
Adjust the ramp rate for your dimmer Adjust the ramp rate for your dimmer (fade-in / fade-out effect for on / off operation). Values correspond to the number of seconds
it takes for the dimmer to reach full brightness or turn off when operated manually.
Values: 0 – 99 (seconds). Default set to 1.
Size: 1 byte dec. Values in the range 0 to 99 may be set.
The manufacturer defined default value is 1.
This parameter has the configuration ID config_9_1 and is of type INTEGER.
Parameter 10: Minimum Brightness
Set the minimum brightness level % Minimum and Maximum Brightness
Parameter 10: Set the minimum brightness level (in %) for your dimmer. You won’t be able to dim the light below the set value.
Values: 1 – 99 (%). Default set to 1.
Size: 1 byte dec. Values in the range 1 to 99 may be set.
The manufacturer defined default value is 1.
This parameter has the configuration ID config_10_1 and is of type INTEGER.
Parameter 11: Maximum Brightness
Set the maximum brightness level % Minimum and Maximum Brightness
Parameter 11: Set the maximum brightness level (in %) for your dimmer. You won’t be able to add brightness to the light beyond the set value. Note: if Parameter 12 is set to value 0, Parameter 11 is automatically disabled.
Values: 1 – 99 (%). Default set to 99.
Size: 1 byte dec. Values in the range 1 to 99 may be set.
The manufacturer defined default value is 99.
This parameter has the configuration ID config_11_1 and is of type INTEGER.
Parameter 12: Double Tap Function
brightness level after you double-tap upper paddle Double Tap Function
Parameter 12: Choose if you want the dimmer to turn on to full brightness or custom brightness level after you double-tap the upper paddle.
Values:
0 – the light will turn on to full brightness with double tap (default).
1 – the light will turn on to the maximum brightness level set in Parameter 11 with double tap.
Size: 1 byte dec. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | full brightness |
| 1 | maximum brightness level set |
The manufacturer defined default value is 0 (full brightness).
This parameter has the configuration ID config_12_1 and is of type INTEGER.
Parameter 13: Scene enable/disable
Enable or disable scene control functionality for quick double tap triggers. Enable or disable scene control functionality for quick double tap triggers.
0 – scene control disabled (default). 1 – scene control enabled. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Scene control disabled |
| 1 | Scene control enabled |
The manufacturer defined default value is 0 (Scene control disabled).
This parameter has the configuration ID config_13_1 and is of type INTEGER.
Parameter 14: Enable/Disable double tap
Move double tap functionality to single tap Enable or disable the double tap function and assign brightness level to single tap.
0 – double tap to full / maximum brightness level enabled (default).
1 – double tap to full / maximum brightness level disabled, single tap turns light on to last brightness level.
2 – double tap to full / maximum brightness level disabled, single tap turns light on to full / maximum brightness level. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | double tap max |
| 1 | single tap last |
| 2 | single tap max |
The manufacturer defined default value is 0 (double tap max).
This parameter has the configuration ID config_14_1 and is of type INTEGER.
Parameter 15: Local on/off control
Enable or disable local on/off control Enable or disable local on/off control. If enabled, you’ll only be able to control the connected light via Z-Wave. Scenes and other functionality will still be available through paddles.
0 – physical paddle control disabled.
1 – physical paddle control enabled (default).
2 – physical paddle and Z-Wave control disabled.
NOTE: tap the upper paddle 10 times quickly to change this mode. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | physical paddle control disabled |
| 1 | physical paddle control enabled |
| 2 | physical paddle and Z-Wave control disabled |
The manufacturer defined default value is 1 (physical paddle control enabled).
This parameter has the configuration ID config_15_1 and is of type INTEGER.
Parameter 16: Physical dimming speed
Physical dimming speed Set the time it takes to get from 0% to 100% brightness when pressing and holding the paddle (physical dimming). The number entered as value corresponds to the number of seconds.
1 – 99 (seconds). Default: 4 Values in the range 1 to 99 may be set.
The manufacturer defined default value is 4.
This parameter has the configuration ID config_16_1 and is of type INTEGER.
Parameter 17: Z-Wave ramp rate
Z-Wave ramp rate Choose if you want to set the Z-Wave ramp rate independently of the physical ramp rate (using an appropriate command in your hub) or if you want them to match.
0 – Z-Wave ramp rate matches the physical ramp rate set in parameter 9;
1 – Z-Wave ramp rate is set independently using appropriate Z-Wave commands (default). The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Match physical ramp rate |
| 1 | Independent ramp rate |
The manufacturer defined default value is 1 (Independent ramp rate).
This parameter has the configuration ID config_17_1 and is of type INTEGER.
Parameter 18: Custom brightness level
Custom brightness level Set the custom brightness level (instead of the last set brightness level) you want the dimmer to come on to when you single tap the upper paddle.
0 – last brightness level (default);
1 – 99 (%) for custom brightness level. Values in the range 0 to 99 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_18_1 and is of type INTEGER.
Parameter 20: Brightness reporting
Brightness reporting Choose how you'd like the dimmer to report when paddles are tapped and held and physical / Z-Wave control is enabled or disabled.
0 – report each brightness level to hub when physical / Z-Wave control is disabled for physical dimming (final level only reported if physical / Z-Wave control is enabled).
1 – report final brightness level only for physical dimming, regardless of the physical / Z-Wave control mode The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Report each level if control is diabled |
| 1 | Only report final brightness level always |
The manufacturer defined default value is 0 (Report each level if control is diabled).
This parameter has the configuration ID config_20_1 and is of type INTEGER.
Association Groups
Association groups allow the device to send unsolicited reports to the controller, or other devices in the network. Using association groups can allow you to eliminate polling, providing instant feedback of a device state change without unnecessary network traffic.
The ZEN27 supports 2 association groups.
Group 1: Lifeline
The Lifeline association group reports device status to a hub and is not designed to control other devices directly. When using the Lineline group with a hub, in most cases, only the lifeline group will need to be configured and normally the hub will perform this automatically during the device initialisation. This dimmer switch supports Group 1 with up to 1 devices for lifeline communication
and Group 2 with up to 5 devices. This device will send
MULTILEVEL REPORT to Group 1 and 2 when operated manually.
Association group 1 supports 1 node.
Group 2: Status
This dimmer switch supports Group 1 with up to 1 devices for lifeline communication and Group 2 with up to 5 devices. This device will send MULTILEVEL REPORT to Group 1 and 2 when operated manually.
Association group 2 supports 5 nodes.
Technical Information
Endpoints
Endpoint 0
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_NO_OPERATION_V1 | |
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_APPLICATION_STATUS_V1 | |
| COMMAND_CLASS_SWITCH_MULTILEVEL_V3 | Linked to BASIC |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1 | |
| COMMAND_CLASS_CENTRAL_SCENE_V3 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| COMMAND_CLASS_CONFIGURATION_V1 | |
| COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1 | |
| COMMAND_CLASS_POWERLEVEL_V1 | |
| COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1 | |
| COMMAND_CLASS_ASSOCIATION_V2 | |
| COMMAND_CLASS_VERSION_V2 | |
| COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3 |
Documentation Links
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.