ZW098 LED Bulb

This describes the Z-Wave device ZW098, manufactured by AEON Labs with the thing type UID of aeon_zw098_00_000.

LED Bulb

Inclusion Information

Non-secure inclusion:

  1. Power on your LED Bulb.
  2. Set the primary controller into inclusion mode (If you don’t know how to do this, please refer to its manual).
  3. Turn off the LED Bulb and then turn on.
  4. If the inclusion is failed, please repeat the process from step 2. 

Secure inclusion:

  1. Power on your LED Bulb.
  2. Set the primary controller into inclusion mode (If you don’t know how to do this, please refer to its manual).
  3. Turn off the LED Bulb and then turn on it on 3 times within 2 seconds.
  4. If the inclusion fails, please repeat the process from step 2.

Note: If LED Bulb has been successfully included into your Z-Wave network, its warm white LED will be solid. If the linking was unsuccessful and the LED Bulb continues to be active with a colourful gradient. 

Exclusion Information

  1. Power on your LED Bulb.
  2. Set the primary controller into exclusion mode (If you don’t know how to do this, please refer to its manual).
  3. Turn off the LED Bulb and then turn on 3 times within 2 seconds.
  4. If the exclusion fails, please repeat the process from step 2.

Note: If LED Bulb has been successfully excluded from your Z-Wave network, its warm white LED will be active with a colourful gradient. If the exclusion was unsuccessful and the LED Bulb continues to be solid. 

Channels

The following table summarises the channels available for the ZW098 LED Bulb.

Channel Channel Id Channel Type UID Category Item Type
Dimmer switch_dimmer switch_dimmer DimmableLight Dimmer
Color Control color_color color_color   Color
Color Temperature color_temperature color_temperature ColorLight Dimmer

Dimmer

Restore Last Value

Restore Last Dimming level on ON.

Property Value      
Configuration ID config_restoreLastValue      
Data Type BOOLEAN   Default Value true
Options Restore Last Value (true)      
  Restore Full Brightness (false)      

Device Configuration

The following table provides a summary of the configuration parameters available in the ZW098 LED Bulb. Detailed information on each parameter can be found below.

Parameter Description
32: Toggle send report on color change Toggle send report on color change
34: Allow external switch to toggle bulb Allow external switch to toggle bulb
35: Allow external switch to change color Allow external switch to change color
37: Colour Residence Time Colour Residence Time
37: Colour Change Speed Colour Change Speed
37: Cycle count Cycle count
37: Color transitions (Value 1 MSB) see Overview Value 1 (MSB) see Overview
38: Color index configuration for multi mode (1,2) Color index configuration for multi mode (1,2)
38: Color index configuration for multi mode (3,4) Color index configuration for multi mode (3,4)
38: Color index configuration for multi mode (5.6) Color index configuration for multi mode (5,6)
38: Color index configuration for multi mode (7,8) Color index configuration for multi mode (7,8)
80: Enable notifications set send notifications type for Group 1
252: Lock configuration Enable/disable the ability to configure the device.
36: Control color mode Reboot/save/exit Colorful mode
1: Group 1  
2: Group 2  

32: Toggle send report on color change

Toggle send report on color change

Overview

Enable/disable to send out a report when the color is changed.
0=disable. 1=Hail CC. Others=ignore.

Property Value      
Configuration ID config_32_1      
Data Type INTEGER   Default Value 0
Options disable color updates (0)      
  send HAIL CC (1)      

34: Allow external switch to toggle bulb

Allow external switch to toggle bulb

Overview

Enable/disable the function of using External Switch to turn
on/off the bulb.
0=disable.
1=enable.
Others=ignore.

Property Value      
Configuration ID config_34_1      
Data Type INTEGER   Default Value 0
Options disabled (0)      
  enabled (1)      

35: Allow external switch to change color

Allow external switch to change color

Overview

Enable/disable the function of using External Switch to changes
the bulb’s color.
0=disable.
1=enable.
Others=ignore.

Property Value      
Configuration ID config_35_1      
Data Type INTEGER   Default Value 1
Options disabled (0)      
  enabled (1)      

37: Colour Residence Time

Colour Residence Time

Overview

0-254 : Corresponds from 0 to 25.4 seconds.

255 : no change

Property Value
Configuration ID config_37_4_000000FF
Data Type INTEGER
Range 0 to 255
Default Value 0

37: Colour Change Speed

Colour Change Speed

Overview

Colour Change Speed (8 bits)
This field specifies the transition speed when one colour changes to another.

0 is slowest adn 254 is fastest.  255 will have no effect.

Property Value
Configuration ID config_37_4_0000FF00
Data Type INTEGER
Range 0 to 255
Default Value 0

37: Cycle count

Cycle count

Overview

The Cycle Count is used to define the number of repetitions/cycles displayed by your LED Bulb in Colour
Display Cycle before stopping.

0 = Unlimited

1-254 = cycle this number and then stop

255 = no change to setting

For example:

When the Bulb is in Rainbow mode, the colour change from red to pink (Red Orange Yellow Green
Cyan Blue Purple Pink), going through the colours is regarded as 1 cycle.

Property Value
Configuration ID config_37_4_00FF0000
Data Type INTEGER
Range 0 to 255
Default Value 0

37: Color transitions (Value 1 MSB) see Overview

Value 1 (MSB) see Overview

Overview

scroll to bottom for examples.

bits 7 and 6 for colour transition style

bits 5 and 4 are reserved (always 0)

bits 3,2,1,0 are colour display

colour display options are:

0 single colour mode

1 Rainbow Mode(red, orange, yellow, green, cyan, blue, violet,pinkish)

2 Multi Colour Mode(colours cycle between selected colours)

3 Random mode

15 Inactive (keep current mode)

Single colour mode: The Bulb is solid with one colour in this mode. If you want to change its current
colour, you need to turn the Bulb off and on 2 times via wall switch within 1 second, the Bulb will enter
into colour change status. During this time, turning the wall switch off when your desired colour appears,
will be used as the colour of the bulb when it is on.

Rainbow mode: The Bulb has 8 colours to display and will change through a range of colors (Red
Orange Yellow Green Cyan Blue Violet pinkish).
Multi-colour mode: The Bulb can change between multiple colours according to the colour index which
is configurable through configuration parameter 38, see the configuration table of parameter 38 below.

Random mode: The Bulb’s colour will be displayed randomly.

Colour Transition Style (2 bits)

0 Smooth transitions

1 Fast/Direct transition

2 Fade out/Fade in

3 Inactive (keep current configuration)

examples:

Default is 00 single color mode with smooth color transitions. 

Set to 01 for rainbow mode with smooth color transitions

Set to 02 for multi color mode with smooth color transitions

Set to 03 for random mode with smooth color transitions

Set to 64 for single color mode with direct color transitions

Set to 65 for rainbow color mode with direct color transitions

Set to 66 for multi color mode with direct color transitions

Set to 67 for random color mode with direct color transitions

Note: The four modes below are available to the bulb, but not currently available in openHAB.

Set to 128 for single color mode with fade out/fade in transitions

Set to 129 for rainbow color mode with fade out/fade in transitions

Set to 130 for multi color mode with fade out/fade in transitions

Set to 131 for random color mode with fade out/fade in transitions

Property Value      
Configuration ID config_37_4_7F000000      
Data Type INTEGER   Default Value 0
Options single color mode with smooth color transitions (default) (0)      
  rainbow mode with smooth color transitions (1)      
  multi color mode with smooth color transitions (2)      
  random mode with smooth color transitions (3)      
  single color mode with direct color transitions (64)      
  rainbow color mode with direct color transitions (65)      
  multi color mode with direct color transitions (66)      
  random color mode with direct color transitions (67)      
  single color mode with fade out/fade in transitions (128)      
  rainbow color mode with fade out/fade in transitions (129)      
  multi color mode with fade out/fade in transitions (130)      
  random color mode with fade out/fade in transitions (131)      

38: Color index configuration for multi mode (1,2)

Color index configuration for multi mode (1,2)

Overview

The colour will be changed from index 1 to index 8 circularly when your bulb is in Multi colour mode.

This value controls indexes 1 and 2

Values are additive.  The smaller numbers control index 1, and the larger control index 2. 

Example:

You want to have the 1st color be red and the 2nd color switched to to be blue.  Set this value to 97 (1+96)

The colors are:

1,16 = red

2,32 = orange

3,48 = yellow

4,64 = green

5,80 = cyan

6,96 = blue

7,112 = violet

8,128 = pinkish (Aeon’s term)

Property Value
Configuration ID config_38_4_000000FF
Data Type INTEGER
Range 0 to 136
Default Value 0

38: Color index configuration for multi mode (3,4)

Color index configuration for multi mode (3,4)

Overview

The colour will be changed from index 1 to index 8 circularly when your bulb is in Multi colour mode.

This value controls indexes 3 and 4

Values are additive.  The smaller numbers control index 3, and the larger control index 4. 

Example:

You want to have the 3rd color be red and the 4th color switched to to be blue.  Set this value to 97 (1+96)

The colors are:

1,16 = red

2,32 = orange

3,48 = yellow

4,64 = green

5,80 = cyan

6,96 = blue

7,112 = violet

8,128 = pinkish (Aeon’s term)

Property Value
Configuration ID config_38_4_0000FF00
Data Type INTEGER
Range 0 to 136
Default Value 0

38: Color index configuration for multi mode (5.6)

Color index configuration for multi mode (5,6)

Overview

The colour will be changed from index 1 to index 8 circularly when your bulb is in Multi colour mode.

This value controls indexes 5 and 6

Values are additive.  The smaller numbers control index 5, and the larger control index 6. 

Example:

You want to have the 5th color be red and the 6th color switched to to be blue.  Set this value to 97 (1+96)

The colors are:

1,16 = red

2,32 = orange

3,48 = yellow

4,64 = green

5,80 = cyan

6,96 = blue

7,112 = violet

8,128 = pinkish (Aeon’s term)

Property Value
Configuration ID config_38_4_00FF0000
Data Type INTEGER
Range 0 to 136
Default Value 0

38: Color index configuration for multi mode (7,8)

Color index configuration for multi mode (7,8)

Overview

The colour will be changed from index 1 to index 8 circularly when your bulb is in Multi colour mode.

This is value 1, the MSB.  It controls indexes 7 and 8

Values are additive.  The smaller numbers control index 7, and the larger control index 8. 

Example:

You want to have the 7th color be red and the 8th color switched to to be blue.  Set this value to 97 (1+96)

The colors are:

1,16 = red

2,32 = orange

3,48 = yellow

4,64 = green

5,80 = cyan

6,96 = blue

7,112 = violet

8,128 = pinkish (Aeon’s term)

Property Value
Configuration ID config_38_4_7F000000
Data Type INTEGER
Range 0 to 136
Default Value 0

80: Enable notifications

set send notifications type for Group 1

Property Value      
Configuration ID config_80_1      
Data Type INTEGER   Default Value 0
Options Disable (0)      
  Hail (1)      
  Basic (2)      

252: Lock configuration

Enable/disable the ability to configure the device.

Property Value      
Configuration ID config_252_1      
Data Type INTEGER   Default Value 0
Options disabled (0)      
  enabled (1)      

36: Control color mode

Reboot/save/exit Colorful mode

Overview

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 exit

Property Value      
Configuration ID config_36_1_wo      
Data Type INTEGER   Default Value 0
Options reboot normal mode (0)      
  boot into color programming (1)      
  exit color programming (2)      
  save and exit color programming (3)      

1: Group 1

Property Value
Configuration ID group_1
Data Type TEXT
Range to

2: Group 2

Property Value
Configuration ID group_2
Data Type TEXT
Range to

Did you spot an error in the above definition or want to improve the content? You can edit the database here.