16 KiB
| layout | title |
|---|---|
| documentation | ZW121 - ZWave |
{% include base.html %}
ZW121 Aeotec LED Strip
This describes the Z-Wave device ZW121, manufactured by AEON Labs with the thing type UID of aeon_zw121_00_000.
The device is in the category of Light Bulb, defining Devices that illuminate something, such as bulbs, etc..
The ZW121 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
Aeotec LED Strip has been crafted to power connected lighting using Z-Wave Plus. It is powered by Aeotec’s Gen5 technology. The LED Strip is a multi-colored LED Strip which allows control (on/off/dim/color change) via Z-Wave commands.
Note that configuration parameters 37 and 39 only apply when the strip is in color transition mode. Color transition mode is entered when a change to parameter 37 or 39 is submitted. Color transition mode is exited when a change to any of the channels is submitted.
Inclusion Information
- Set your Z-Wave controller into pairing mode.
- Press the Action Button located on the back of the LED Strip's white controller box once (The network LED will blink green as an indication it is pairing insecurely, please refer to section "Enabling Security Encryption" in the Advanced Function section of the manual to pair it securely).
- If the LED Strip has been successfully added to your Z-Wave network, its Network LED will become solid. If the pairing was unsuccessful, the red LED will be on for 2 seconds and then remain a colorful gradient, repeat the instructions above from step 1.
Exclusion Information
- Set your Z-Wave controller into device removal mode.
- Press the Action Button located on the back of the LED Strip's white controller box once.
- If the LED Strip has been successfully removed from your Z-Wave network, its Network LED will remain colorful gradient. If the removal was unsuccessful, the Network LED will still be solid, repeat the instructions above from step 1.
Channels
The following table summarises the channels available for the ZW121 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Dimmer | switch_dimmer | switch_dimmer | DimmableLight | Dimmer |
| Scene Number | scene_number | scene_number | Number | |
| Color Control | color_color | color_color | ColorLight | Color |
| Color Temperature | color_temperature | color_temperature | ColorLight | Dimmer |
| Configuration Parameter 37 | meter_current | meter_current | Energy | 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.
Color Control
The color channel allows to control the color of a light. It is also possible to dim values and switch the light on and off.
The color_color channel is of type color_color and supports the Color item and is in the ColorLight category.
Color Temperature
The color temperature channel allows to set the color temperature of a light from 0 (cold) to 100 (warm).
The color_temperature channel is of type color_temperature and supports the Dimmer item and is in the ColorLight category.
Configuration Parameter 37
Indicates the instantaneous current consumption.
The meter_current channel is of type meter_current and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
Device Configuration
The following table provides a summary of the 17 configuration parameters available in the ZW121. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 34 | Enable/disable last brightness level | Enable/disable last brightness level when using the Color Switch Set CC |
| 36 | Reboot/save/exit Colorful mode. | Reboot/save/exit Colorful mode. |
| 37 | Color Change Speed Level | Applies only when the Color Transition Style is set to Fade Out/In |
| 37 | Time Base of Color Change Speed | Applies only when the Color Transition Style is set to Fade Out/In |
| 37 | Cycle Count | Defines the number of repetitions of the color transition cycle |
| 37 | Brightness | Brightness when in color transition mode |
| 37 | Color Display Cycle | Defines the mode for determining colors used in color transitions |
| 37 | Color Change Speed Option | Applies only when the Color Transition Style is set to Fade Out/In |
| 37 | Color Transition Style | Defines how the strip transitions between colors |
| 38 | Change speed | Change speed |
| 39 | Multi Color, Single Color or Random Mode - Byte 4 | todo |
| 39 | Multi Color, Single Color, or Random Mode - Byte 3 | todo |
| 39 | Multi Color, Single Color, or Random Mode - Byte 2 | todo |
| 39 | Multi Color, Single Color, or Random Mode - Byte 1 | todo |
| 40 | Colorful mode configuration | Colorful mode configuration |
| 80 | Notifications for Association Group 1 | Send notifications about strip state changes to association group 1 |
| 112 | Dimmer mode | Dimmer mode: |
| Switch All Mode | Set the mode for the switch when receiving SWITCH ALL commands |
Parameter 34: Enable/disable last brightness level
Enable/disable last brightness level when using the Color Switch Set CC Enable/disable to turn on the last brightness level of the LED Strip when using the Color Switch Set CC to change its color.
0=disable.
1=enable.
Others=ignore. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | disable |
| 1 | enable |
The manufacturer defined default value is 0 (disable).
This parameter has the configuration ID config_34_1 and is of type INTEGER.
Parameter 36: Reboot/save/exit Colorful mode.
Reboot/save/exit Colorful mode. Reboot/save/exit Colorful mode.
0=Un-reboot Colorful mode.
1=Reboot Colorful mode.
2=Exit Colorful mode.
3=Save the current Colorful mode value and then to be exited. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Un-reboot Colorful mode |
| 1 | Reboot Colorful mode |
| 2 | Exit Colorful mode |
| 3 | Save the current Colorful mode value |
The manufacturer defined default value is 0 (Un-reboot Colorful mode).
This parameter has the configuration ID config_36_1 and is of type INTEGER.
Parameter 37: Color Change Speed Level
Applies only when the Color Transition Style is set to Fade Out/In Value 0 means constant speed. Value 1-30 sets the speed to accelerate/decelerate. The following option values may be configured, in addition to values in the range 0 to 30 -:
| Value | Description |
|---|---|
| 0 | Constant Speed |
The manufacturer defined default value is 0 (Constant Speed).
This parameter has the configuration ID config_37_4_0000001F and is of type INTEGER.
Parameter 37: Time Base of Color Change Speed
Applies only when the Color Transition Style is set to Fade Out/In Amount of time spent to transition between colors. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Time base is 1s |
| 1 | Time base is 10ms |
| 2 | Time base is 100ms |
The manufacturer defined default value is 0 (Time base is 1s).
This parameter has the configuration ID config_37_4_000000E0 and is of type INTEGER.
Parameter 37: Cycle Count
Defines the number of repetitions of the color transition cycle When the end is reached the strip turns off. Values in the range 0 to 254 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_37_4_0000FF00 and is of type INTEGER.
Parameter 37: Brightness
Brightness when in color transition mode Note that this setting only affects the brightness when in color transition mode. Use the "Brightness" channel to set the brightness outside of color transition mode. Values in the range 1 to 99 may be set.
The manufacturer defined default value is 99.
This parameter has the configuration ID config_37_4_00FF0000 and is of type INTEGER.
Parameter 37: Color Display Cycle
Defines the mode for determining colors used in color transitions Note that "Single Color Mode" does not select a constant single color (as the "Color Control" channel does), but instead cycles through a single color. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Inactive (keep the current configuration value) |
| 1 | Rainbow mode |
| 2 | Multi color mode |
| 3 | Random mode |
| 4 | Single color mode |
The manufacturer defined default value is 1 (Rainbow mode).
This parameter has the configuration ID config_37_4_07000000 and is of type INTEGER.
Parameter 37: Color Change Speed Option
Applies only when the Color Transition Style is set to Fade Out/In
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Fade in for 1/2 second and fade out for 1/2 second |
| 1 | Fade in for 5ms and fade out for 5ms |
| 2 | Fade in for 50ms and fade out for 50ms |
The manufacturer defined default value is 0 (Fade in for 1/2 second and fade out for 1/2 second).
This parameter has the configuration ID config_37_4_38000000 and is of type INTEGER.
Parameter 37: Color Transition Style
Defines how the strip transitions between colors Note that "Smooth Color Transition" will lead to invisible transitions when "Color Display Cycle" is set to "Single Color Mode". The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Smooth color transition |
| 1 | Fade out fade in transition |
The manufacturer defined default value is 0 (Smooth color transition).
This parameter has the configuration ID config_37_4_40000000 and is of type INTEGER.
Parameter 38: Change speed
Change speed Change speed:
Value 1: The speed from OFF to ON.
Value 2: The speed from ON to OFF.
Value 3: Pause time of ON.
Value 4: Pause time of OFF. Values in the range 0 to 0 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_38_4 and is of type INTEGER.
Parameter 39: Multi Color, Single Color or Random Mode - Byte 4
todo
Values in the range 0 to 5 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_39_4_000000FF and is of type INTEGER.
Parameter 39: Multi Color, Single Color, or Random Mode - Byte 3
todo
Values in the range 0 to 5 may be set.
The manufacturer defined default value is 3.
This parameter has the configuration ID config_39_4_0000FF00 and is of type INTEGER.
Parameter 39: Multi Color, Single Color, or Random Mode - Byte 2
todo
Values in the range 0 to 0 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_39_4_00FF0000 and is of type INTEGER.
Parameter 39: Multi Color, Single Color, or Random Mode - Byte 1
todo
Values in the range 0 to 5 may be set.
The manufacturer defined default value is 3.
This parameter has the configuration ID config_39_4_7F000000 and is of type INTEGER.
Parameter 40: Colorful mode configuration
Colorful mode configuration Colorful mode configuration.
1 = Rainbow mode.
2 = Multi color mode.
3 = Fade out and fade in (Red).
4 = Fade out and fade in (Green).
5 = Fade out and fade in (Blue). The following option values may be configured -:
| Value | Description |
|---|---|
| 1 | Rainbow mode |
| 2 | Multi color mode |
| 3 | Fade out and fade in (Red) |
| 4 | Fade out and fade in (Green) |
| 5 | Fade out and fade in (Blue) |
The manufacturer defined default value is 0.
This parameter has the configuration ID config_40_1 and is of type INTEGER.
Parameter 80: Notifications for Association Group 1
Send notifications about strip state changes to association group 1
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | No notifications |
| 1 | Hail CC |
| 2 | Basic CC report |
The manufacturer defined default value is 1 (Hail CC).
This parameter has the configuration ID config_80_1 and is of type INTEGER.
Parameter 112: Dimmer mode
Dimmer mode: Dimmer mode:
0 = Parabolic curve.
1 = Index curve.
2 = (Parabolic + Index)/2.
3 = Linear. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Parabolic curve |
| 1 | Index curve |
| 2 | (Parabolic + Index)/2 |
| 3 | Linear |
The manufacturer defined default value is 0 (Parabolic curve).
This parameter has the configuration ID config_112_1 and is of type INTEGER.
Switch All Mode
Set the mode for the switch when receiving SWITCH ALL commands.
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Exclude from All On and All Off groups |
| 1 | Include in All On group |
| 2 | Include in All Off group |
| 255 | Include in All On and All Off groups |
This parameter has the configuration ID switchall_mode 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 ZW121 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. Notification group for strip state changes Use configuration parameter 80 to define what notifications this group receives.
Association group 1 supports 5 nodes.
Group 2: Retransmit
Retransmit commands to associated nodes Forward the Basic Set, Switch Binary Set, Switch Multilevel Start Level Change, Switch Multilevel Stop Level Change, Switch Multilevel Set, Scene Activation Set to associated nodes in this group when the LED Strip receives the Basic Set, Switch Binary Set, Switch Multilevel Start Level Change, Switch Multilevel Stop Level Change, Switch Multilevel Set, Scene Activation Set commands from the main controller.
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_SWITCH_MULTILEVEL_V2 | Linked to BASIC |
| COMMAND_CLASS_SWITCH_ALL_V1 | |
| COMMAND_CLASS_SCENE_ACTIVATION_V1 | |
| COMMAND_CLASS_SCENE_ACTUATOR_CONF_V1 | |
| COMMAND_CLASS_SWITCH_COLOR_V1 | |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1 | |
| 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_SECURITY_V1 |
Documentation Links
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.