background image

 

 

Atmel AVR2060: BitCloud ZigBee Light Link Quick Start Guide [APPLICATION NOTE] 

42004B

AVR

08/2012 

3

1. 

Overview 

1.1 

SDK’s contents 

The SDK includes the BitCloud implementation of ZigBee Pro protocol and ZigBee Cluster Library, the Light Link demo 
application and a set of pre-built firmware images and development tools. 

The BitCloud stack included in this package contains the ZigBee Cluster Library implementation, and is very similar to 
the BitCloud Profile Suite stack. However, a few enhancements are made to adjust to the behavior needed for ZigBee 
Light Link profile. 

Table 1-1

 describes the file structure of the software package supplied with the SDK. 

Table 1-1.  BitCloud ZigBee Light Link SDK’s structure. 

Name 

Location 

/BitCloud/Components

 

Header files and source code for some components (HAL, 
BSP, and drivers) 

/BitCloud/Components/ZCL/ZLL

 

Header files with definitions of clusters used by Light Link 
applications, and ZLL’s specific API definitions 

/BitCloud/lib

 

BitCloud compiled libraries 

/Applications/ZLLDemo

 

Demo application’s sources and projects 

/Evaluation Tools/ZLLDemo

 

Demo application’s pre-compiled images 

/Documentation

 

Documentation for this package 

In addition to this document, the documentation includes the API Reference, which contains specification of functions 
and times available for the user, and the developer guides. 

1.2 

Supported platforms and tools 

Supported platforms and development tools are described in 

Table 1-2

Table 1-2.  System requirements for BitCloud ZigBee Light Link SDK. 

Parameter 

Value 

Note 

MCU/RF 

Atmel

®

 ATmega128RFA1 SoC 

Atmel ATmega256RFR2 SoC 

 

Evaluation Board 

RCB128RFA1 for a color lightc; 
RCB128RFA1 hosted on a Key 
Remote Control board for a color 
scene controller 

Boards are available with 
 Evaluation Kit 

JTAG emulator 

Atmel AVR

®

 JTAGICE mkII or 

Atmel JTAGICE 3 

Required to upload firmware onto the 
boards and debug through JTAG 

IDE 

IAR Embedded Workbench

®

 for AVR 

6.11 (with IAR™ C/C++ Compiler for 
AVR v6.11.1.50453) 

Required to develop applications using 
API and to upload firmware images 
through JTAG 

 

Summary of Contents for AVR2060

Page 1: ...of the BitCloud ZigBee Light Link software development kit SDK a software package for developing ZigBee Light Link profile applications Chapter 1 gives an overview of the software package and support...

Page 2: ...6 2 3 1 1 Precompiled images 6 2 3 1 2 Application workspace 6 2 3 2 Programming with Atmel AVR Studio 6 3 Demo application 7 3 1 Launching the demo 7 3 2 Color light s functions 7 3 2 1 Touch link wi...

Page 3: ...ific API definitions BitCloud lib BitCloud compiled libraries Applications ZLLDemo Demo application s sources and projects Evaluation Tools ZLLDemo Demo application s pre compiled images Documentation...

Page 4: ...s used with BitCloud may be found in 3 or 4 2 2 Hardware configuration 2 2 1 Assembling devices Both color scene controller and color light use RCB128RFA1 RCB as a base board For a color scene control...

Page 5: ...d fuse bits settings are shown in Table 2 1 Table 2 1 Fuse bits for Atmel ATmega128RFA1 Option Required value for 8MHz Required value for 16MHz BODLEVEL 1V8 1V8 OCDEN Enabled Enabled JTAGEN Enabled En...

Page 6: ...n a workspace for example ZLLDemo eww and select JTAGICE mkII Fuse Handler JTAGICE 3 Fuse Handler 2 Click Read Fuses and make sure that the device fuses are set as specified in Section 2 2 2 3 If fuse...

Page 7: ...lor light are needed More devices lights or controllers may be added as required Assemble devices as described in Section 2 2 1 Program devices with pre built images of the demo application via JTAG a...

Page 8: ...ify command to the color light which blinks several times with its LEDs or the LCD screen The touch link procedure may be aborted at this moment if the PWR button is released To complete the procedure...

Page 9: ...all scene if pressed for less that three seconds 7 8 9 Set minimum middle maximum light level 4 Triggers network update the color scene controller applies a standard ZigBee mechanism to select a new o...

Page 10: ...te If touch link between controller devices is not performed pairing a new controller device with a color light that is already in the network will cause the color light to leaving this network and fo...

Page 11: ...ene E Add Scene Remove Scene Store Scene hold Recall Scene Add Scene E Add Scene Remove Scene 4 5 6 Network Update Read ZLL version Trigger Breathe Trigger Finish Trigger Stop 7 8 9 MoveToLevel MoveTo...

Page 12: ...by color light and color scene controller Such file initializes structures needed for the cluster and implements callback functions that are called to indicate commands responses For example see the...

Page 13: ...ght Link Profile Specification Version 1 0 2 AVR2056 BitCloud Profile Suite Developer Guide 3 AVR2052 BitCloud Quick Start Guide 4 AVR2055 BitCloud Profile Suite Quick Start Guide 5 AVR2104 RF4CE EK R...

Page 14: ...y this document or in connection with the sale of Atmel products EXCEPT AS SET FORTH IN THE ATMEL TERMS AND CONDITIONS OF SALES LOCATED ON THE ATMEL WEBSITE ATMEL ASSUMES NO LIABILITY WHATSOEVER AND D...

Reviews: