CC2531EMK ZLL Remote

The CC2531EMK USB dongle was included in older ZLL kits before the ZLLRC was available.

The CC2531EKM USB dongle Remote is not a supported HW platform in the ZStack-Lighting-1.0.x release and now that the ZLLRC is available is longer supplied as part of the kit. This wiki page has been created for customers that already have the old kit.

The FW source for the CC2531EMK USB Dongle remote is available in the kit FW patch here.

Using The CC2531EMK ZLL Remote

The CC2531EMK ZLL Remote exposes the following functionality through the button S1 and S2:

CC2531EMK ZLL Remote user feedback is given through the LEDs, with the following meaning:

More Advanced Control

The Zlight is a Color Light and the CC2531EMK is a Color Scene Remote, but up until now you have only turned the Lights on and off. To do more you need to use the "Host Interface" of the ZStack-Lighting-1.0.x Remote. The full source for Linux and Window command line application is available here: https://git.ti.com/zllhostinterfaceexample/zllhostinterfaceexample/archive-tarball/master

To use the ZStack-Lighting-1.0.x Remote Host Interface with the CC2531EMK ZLL Remote:

• 1. Download the Windows ZLL Command Line Controller: https://git.ti.com/zllhostinterfaceexample/zllhostinterfaceexample/blobs/master/Win32/zllCmdLine/Release/zllCmdLine.exe
• 2. Extract usb_cdc_driver_cc2531.inf and zllCmdLine.exe to a dirrectory.
• 3. Plug in the CC2531EMK ZLL Remote USB Dongle into your Windows PC
• 4. When prompted for a driver use File:Usb cdc driver cc2531.zip.
• 5. Find the COM port number Windows has been assigned to it:
  • a. Open device manager: Windows start menu -> Right click my computer -> Manage -> device manager
  • b. Find the CC2531 listed under ports:

• 6. Launch the windows console application zllCmdLine.exe:
  • a. Click windows start menu and type run in the search box and enter, then type the path you extracted zllCmdLine.exe to in step 2 and the COM number and enter:

• 7. Place one of the Zlights close (within 0.5m) of the CC2530EMK USB dongle.
• 8. Type "touchlink" in the console. It does not matter if the Zlight has already been touchlinked as part of Connecting The CC2531EMK ZLL Remote To The ZLights The First Time They Are Powered.
• 9. The Zlight should Flash and the following text should be printed to the console:

C:\Users\a0741319\Documents\temp\zllCmdLine.exe -- Mar 24 2013 17:02:45
touchlink
touchlink command executed
 
processRpcSysApp: Command Received Successfully
 
tlIndicationCb:
    Network Addr : 0x0002
    End Point    : 0x0b
    Profile ID   : 0xc05e
    Device ID    : 0x0200
    Version      : 0x02
    Status       : 0x57

Make a note of the Network Addr and End Point.

• 10. To control he Light type:

setstate -n0x0002 -e0x0b -m2 -v1

Your should see the following in the console and the Zlight should turn on.

setstate -n0x0002 -e0x0b -m2 -v1
setstate command executed with params:
    Network Addr    :0x0002
    End Point       :0x0b
    Addr Mode       :0x02
    Value           :0x01
 
processRpcSysApp: Command Received Successfully

• 11. Now set the Saturation to the highest (not you can now omit the other parameters as you are controlling the same light):

setsat -v0xfe
setsat command executed with params:
    Network Addr    :0x0002
    End Point       :0x0b
    Addr Mode       :0x02
    Value           :0xfe
    Transition Time :0x0001
 
processRpcSysApp: Command Received Successfully

• 12. Now set the hue to red (hue of 0):

sethue -v0
sethue command executed with params:
    Network Addr    :0x0002
    End Point       :0x0b
    Addr Mode       :0x02
    Value           :0x00
    Transition Time :0x0001
 
processRpcSysApp: Command Received Successfully

• 12. Now set the hue to transition to blue (hue of 0xAA) over 3s:

sethue -v0xAA -t30
sethue command executed with params:
    Network Addr    :0x0002
    End Point       :0x0b
    Addr Mode       :0x02
    Value           :0xaa
    Transition Time :0x001e
 
processRpcSysApp: Command Received Successfully

• Other Lights can be controlled by touchlink'ing and recording there Network Addr and End Point
• All Light can be controlled by addressing the group, use -m1 to select group mode and -n0x0001 for group 1 which the Lights are added to by default after touchlink. The broadcast End Point of -e0xFF should be used in case you are controlling ZLL Lights other than the TI ZStack-Lighting-1.0.x Lights.

The Host interface is part of the standard ZStack-Lighting-1.0.x release and is described in more detail here.

Generating the ZStack-Lighting Kit FW from ZStack-Lighitng-1.0.x Release

The ZStack-Lighting-1.0.1 Release is available for down load from http://www.ti.com/tool/z-stack. To update this release to generate the FW pre-programmed in to the Zlight in the kit a patch is required. The patch is available here: File:Z-Stack-Lighting-add-on-lighting-kit.zip. Instruction for applying the patch are incuded in the patch installer, this must be installed in to the ZStack-Lighting-1.0.1 folder. You will notice that this patch creates a "USB - EndDevice" configuration in the Remote project, this is for the CC2531EMK USB Dongle that was included in an earlier release of the kit. More information on this HW platform can be found here. Currently there is no source code released for the ZLLRC HW platform, this will be included in the ZStack-Lighting-1.0.2 release.

Updating the Kit FW image using the Windows bootloader tool

To update the Zlight or REmote FW:

• 1. Download the Windows serial bootloader: File:SBDemo.zip
• 2. Extract usb_cdc_driver_cc2531.inf and SBDemo.exe to a directory.
• 3. Plug in the Zlight while holding the button or CC2531EMK ZLL Remote USB Dongle while holding S1 into your Windows PC.
  • a. Holding the button while powering will put the device into bootloader mode. The green LED will flash while it is waiting for a new image.
• 4. When prompted for a driver use File:Usb cdc driver cc2531.zip.
• 5. Find the COM port number Windows has been assigned to it:
  • a. Open device manager: Windows start menu -> Right click my computer -> Manage -> device manager
  • b. Find the CC2531 listed under ports:

• 6. Launch the SBDemo.exe
  • a. Select the file to update.
  • b. Select the COM port.
  • c. Click Load Image.

• 7. While updating the Green LED will blink rapidly for short intervals.
• 8. Once updated the RED and Green LED will Flash and the new image will boot.