Using the Zipato RGBW Bulb in VERA

This guide shows how to use the recently released Zipato RGBW LED Bulb in the VERA Z-Wave Controller.

The Zipato RGBW LED Bulb is one of the new "Generation 5" / "Gen5" / "Z-Wave+" / "Z-Wave Plus" devices.

These devices are unfortunately presenting some issues when used with current Z-Wave Controllers and it will likely be some time before the Z-Wave Controller manufacturers issue updated firmware that includes support for the new devices out-of-the-box.

In the meantime, this application note will detail some workarounds to allow you to use the Zipato RGBW LED Bulb in VERA.

NOTE: These steps work in VERA Lite / VERA 3 using at least firmware version UI5 (1.5.672) or later and they also work in the new VERA Edge!

We still recommend using UI5 series firmware on VERA where possible!

Prerequisites


If you are still using the UI5 series firmware, then your VERA will need to be running the latest BETA release (1.5.672) to allow the Zipato RGBW LED Bulb to be Included correctly.

This is due to the fact that the device uses "V2" of the "Version" Z-Wave Command Class.

Fortunately, MiCasaVerde released version 1.5.672 firmware for VERA at the end of 2013 to allow support for the Fibaro Smoke Sensor and Fibaro Motion Sensor devices.

Follow our related KB article for either the Motion Sensor or Smoke Sensor in order to update your VERA firmware to the required version if necessary!

Including the Zipato RGBW LED Bulb


When you Include the Zipato RGBW LED Bulb it will install as an "_Dimmable Light".

Zipato RGBW LED Bulb in VERA UI5Zipato RGBW LED Bulb in VERA UI5

Zipato RGBW LED Bulb in VERA EdgeZipato RGBW LED Bulb in VERA Edge

Looks good, but only the white colour works!


Indeed, unfortunately out-of-the-box VERA can't control the individual colour channels and the single dimmer device VERA creates only controls the "Cool White" colour channel - not very useful!

By reverse-engineering the Z-Wave protocol used to communicate with the device, we have discovered that the device uses the "Color Control" Z-Wave Command Class and VERA does not currently support this.

VERA uses the "Multi-Level Switch" Z-Wave Command Class to communicate with the device and this is mapped to only the "Cool White" colour channel in the device itself.

So it's just an expensive white LED then?


Nope - fortunately we can turn to some simple LUA to control each of the colour channels independently, thus making the device slightly more usable :-)

While this won't help with controlling the device in a meaningful way from the UI or from an App, it does at least mean that the device can have the colour changed from a Scene, which is likely the most common way of wishing to control it anyway.

By using LUA, we can set the level of all five of the available colour channels - Cool White, Warm White, Red, Green, Blue.

The dimmer device in the VERA UI then controls the intensity / brightness of the overall colour set.

NOTE: The Cool White colour channel is mutually exclusive with the other colour channels - that is, if the Cool White colour channel is set to anything greater than ZERO, changes to the other colour channels will not take effect until you turn the Cool White channel OFF by setting it to ZERO.

Gimme the code!


Make a note of the "ID" that VERA has given to the device - this is the Z-Wave ID, shown on the "Settings" tab of the device in the VERA UI.


Cool White

The LUA required to control the Cool White colour channel is as follows:

luup.call_action('urn:micasaverde-com:serviceId:ZWaveNetwork1','SendData',{Node='56',Data='51 5 2 1 0'},1)

  • 56 = Z-Wave Device ID
  • 51 = Color Control Command Class (0x33)
  • 5 = Color Set Command
  • 2 = Size of following data
  • 1 = Cool White colour channel
  • 0 = OFF (0%) - 255 = ON (100%)

Warm White

The LUA required to control the Warm White colour channel is as follows:

luup.call_action('urn:micasaverde-com:serviceId:ZWaveNetwork1','SendData',{Node='56',Data='51 5 2 0 0'},1)

  • 56 = Z-Wave Device ID
  • 51 = Color Control Command Class (0x33)
  • 5 = Color Set Command
  • 2 = Size of following data
  • 0 = Warm White colour channel
  • 0 = OFF (0%) - 255 = ON (100%)

Red

The LUA required to control the Red colour channel is as follows:

luup.call_action('urn:micasaverde-com:serviceId:ZWaveNetwork1','SendData',{Node='56',Data='51 5 2 2 0'},1)

  • 56 = Z-Wave Device ID
  • 51 = Color Control Command Class (0x33)
  • 5 = Color Set Command
  • 2 = Size of following data
  • 2 = Red colour channel
  • 0 = OFF (0%) - 255 = ON (100%)

Green

The LUA required to control the Green colour channel is as follows:

luup.call_action('urn:micasaverde-com:serviceId:ZWaveNetwork1','SendData',{Node='56',Data='51 5 2 3 0'},1)

  • 56 = Z-Wave Device ID
  • 51 = Color Control Command Class (0x33)
  • 5 = Color Set Command
  • 2 = Size of following data
  • 3 = Green colour channel
  • 0 = OFF (0%) - 255 = ON (100%)

Blue

The LUA required to control the Blue colour channel is as follows:

luup.call_action('urn:micasaverde-com:serviceId:ZWaveNetwork1','SendData',{Node='56',Data='51 5 2 4 0'},1)

  • 56 = Z-Wave Device ID
  • 51 = Color Control Command Class (0x33)
  • 5 = Color Set Command
  • 2 = Size of following data
  • 4 = Blue colour channel
  • 0 = OFF (0%) - 255 = ON (100%)

All the above LUA commands would be entered on the LUUP tab of either a Trigger or a Scene:

Zipato RGBW LED Bulb in VERA LUA Single Colour ChannelZipato RGBW LED Bulb in VERA LUA Single Colour Channel


Multiple Colour Channels

It's also possible to control multiple channels at the same time, the LUA required to do that is as follows:

luup.call_action('urn:micasaverde-com:serviceId:ZWaveNetwork1','SendData',{Node='56',
Data='51 5 10 0 0 1 0 2 50 3 75 4 125'},1)

  • 56 = Z-Wave Device ID
  • 51 = Color Control Command Class (0x33)
  • 5 = Color Set Command
  • 10 = Size of following data
  • 0 = Warm White colour channel
  • 0 = OFF @ 0
  • 1 = Cool White colour channel
  • 0 = OFF @ 0
  • 2 = Red colour channel
  • 50 = ON @ 50
  • 3 = Green colour channel
  • 75 = ON @ 75
  • 4 = Blue colour channel
  • 125 = ON @ 125

The above would be entered on the LUUP tab of either a Trigger or a Scene:

Zipato RGBW LED Bulb in VERA LUA Multiple Colour ChannelsZipato RGBW LED Bulb in VERA LUA Multiple Colour Channels

Conclusion


We hope that you've found this application note useful and are now able to make full use of the Zipato RGBW LED Bulb!

Related Information



 

Copyright Vesternet 2015

Updated: 29/01/15