Texas Instruments CC2430ZDK User manual

Copyright 2005-2007 Texas Instruments, Inc. All rights reserved.
Z-Stack
User’s Guide For
CC2430ZDK
ZigBee 2006 Release
Version 1.4.3
Document Number: F8W-2005-0036
Texas Instruments, Inc.
San Diego, California USA
[phone]

Z-Stack User's Guide - CC2430ZDK F8W-2005-0036 Version 1.4.3
ii Copyright 2005-2007 Texas Instruments, Inc. All rights reserved.
Revision Description Date
1.0 Initial release. 12/22/2005
1.1 Changed logo on title page, changed copyright on page footer. 02/27/2006
1.2 Added Figure 3 showing SOC_BB Battery Board. 06/25/2006
1.3 Changed sample applications to SampleSwitch and SampleLight. 12/13/2006
1.4 Changed sample applications to SampleApp. 04/10/2007
1.5 Removed reference to Chipcon web site from Section 4.2. 05/31/2007
1.6 Changed IAR compiler version to 7.30B in Section 4.2. 12/21/2007

Z-Stack User's Guide - CC2430ZDK F8W-2005-0036 Version 1.4.3
iii Copyright 2005-2007 Texas Instruments, Inc. All rights reserved.
Table of Contents
1. INTRODUCTION................................................................................................................. 1
1.1. SCOPE .............................................................................................................................. 1
2. PRODUCT PACKAGE DESCRIPTION........................................................................... 1
2.1. INSTALLATION PACKAGE CONTENTS ............................................................................... 1
2.2. DEVELOPMENT BOARDS .................................................................................................. 1
2.3. CABLES ............................................................................................................................ 3
3. INSTALLATION REQUIREMENTS................................................................................ 3
3.1. HOST COMPUTER REQUIREMENTS ................................................................................... 3
3.2. TARGET DEVELOPMENT SYSTEM REQUIREMENTS ........................................................... 3
4. PRODUCT INSTALLATION PROCEDURES ................................................................ 3
4.1. INSTALL Z-STACK PACKAGE ........................................................................................... 3
4.2. INSTALL IAR EW8051 PACKAGE .................................................................................... 3
4.3. DEVICE IEEE ADDRESSES ............................................................................................... 3
5. CONFIGURING AND USING Z-STACK ......................................................................... 4
5.1. CONFIGURING Z-STACK................................................................................................... 4
5.2. LOGICAL DEVICE TYPES .................................................................................................. 4
5.3. BUILDING SAMPLEAPP DEVICES...................................................................................... 4
5.4. BUILDING A SAMPLELIGHT COORDINATOR DEVICE ........................................................ 4
6. Z-STACK DEMONSTRATION.......................................................................................... 7
6.1. SWITCHES AND LEDS...................................................................................................... 7
6.2. INITIAL LOADING OF 64-BIT IEEE ADDRESS ................................................................... 9
6.3. RUNNING THE SAMPLE APPLICATION............................................................................... 9
7. PANID AND CHANNEL SELECTION........................................................................... 10
7.1. ENERGY LEVEL.............................................................................................................. 11
APPLICABLE DOCUMENTS.................................................................................................. 12
Table of Figures
FIGURE 1: CHIPCON SMARTRF04EB EVALUATION BOARD WITH CC2430EM ............................... 1
FIGURE 2: CHIPCON CC2430DB DEVELOPMENT BOARD................................................................ 2
FIGURE 3: CHIPCON SOC_BB BATTERY BOARD ............................................................................ 2
FIGURE 4: CC2430DB JOYSTICK .................................................................................................... 8
FIGURE 5: CC2430DB LEDS.......................................................................................................... 8
FIGURE 6: SMARTRF04EB LEDS................................................................................................... 8
FIGURE 7: SMARTRF04EB COORDINATOR JUMPER ........................................................................ 9
Table of Tables
TABLE 1: DEFAULT CHANNEL SELECT BIT MAP ........................................................................... 10

Z-Stack User's Guide - CC2430ZDK F8W-2005-0036 Version 1.4.3
1 Copyright 2005-2007 Texas Instruments, Inc. All rights reserved.
1. Introduction
1.1. Scope
This document accompanies the Texas Instruments Z-Stack™ solution for use with the CC2430
ZigBee Development Kit. Z-Stack is a complete protocol stack and solution conforming to
ZigBee Alliance standards (www.zigbee.org).
2. Product Package Description
2.1. Installation Package Contents
The downloaded Z-Stack installation package contains all of the documentation and software
required to install, configure, and develop applications using Z-Stack. The package employs a
Microsoft Windows-based installation application which guides the installation process.
2.2. Development Boards
Two Chipcon SmartRF04EB evaluation boards, each to be fitted with a CC2430EM evaluation
module, may be used to demonstrate or develop ZigBee applications based on the Z-Stack
software package:
Figure 1: Chipcon SmartRF04EB Evaluation Board with CC2430EM

Z-Stack User's Guide - CC2430ZDK F8W-2005-0036 Version 1.4.3
2 Copyright 2005-2007 Texas Instruments, Inc. All rights reserved.
Five smaller Chipcon CC2430DB evaluation boards are also contained in CC2430ZDK and
CC2431ZDK ZigBee development kits:
Figure 2: Chipcon CC2430DB Development Board
Ten compact Chipcon SOC_BB evaluation boards, each to be fitted with a CC2430EM or a
CC2431EM evaluation module, are contained in CC2431ZDK ZigBee development kits:
Figure 3: Chipcon SOC_BB Battery Board

Z-Stack User's Guide - CC2430ZDK F8W-2005-0036 Version 1.4.3
3 Copyright 2005-2007 Texas Instruments, Inc. All rights reserved.
2.3. Cables
All necessary cabling has been included with the development kit. To support program download
and debugging of SmartRF04EB and CC2430DB boards, a USB cable should be connected from
each target board to the host PC. RS232 cables may be connected between the serial port on
SmartRF04EB boards (9-pin connector) and the host PC to utilize Z-Tool™ and other programs
included with the Z-Stack package.
3. Installation Requirements
3.1. Host Computer Requirements
Z-Stack and Z-Tool are designed for installation on a personal computer running Microsoft
Windows XP Professional or Windows 2000. The following are the minimum requirements for
the platform hosting Z-Stack and Z-Tool:
•.NET 1.1 Framework
•Windows XP Service Pack 1 (if using Windows XP)
•1 serial port for Z-Tool communication with the SmartRF04EB board
•1 USB port for download/debug of SmartRF04EB and CC2430DB boards
3.2. Target Development System Requirements
Z-Stack provides a complementary offering to the IAR Embedded Workbench (EW8051) suite
of software development tools. These tools support project management, compiling, assembling,
linking, downloading, and debugging for various 8051-based processors, including the Chipcon
CC243x family. The following is required support for the Z-Stack target development system:
•IAR EW8051 ( http://www.iar.com/ )
4. Product Installation Procedures
4.1. Install Z-Stack Package
Install the Texas Instruments Z-Stack files and programs from the downloaded package. Run the
windows-based installation program, ZStack-CC2430-1.4.3.exe, which will create the required
directory structure and load all software and documentation files. Review the README.txt file
for a synopsis of new features and changes with this Z-Stack release.
4.2. Install IAR EW8051 Package
Install the Embedded Workbench for 8051 from IAR Systems: http://www.iar.com/. The project
and library files included in this release of Z-Stack were built and tested with EW8051 version
7.30B. When considering an upgrade to a newer version of EW8051, it is necessary to verify that
installed project and library files are compatible with the newer development tools.
4.3. Device IEEE Addresses
Each CC2430DB, CC2430EM, and CC2431EM board in the development kit has been pre-
programmed with a unique 64-bit IEEE address. These addresses, assigned by Chipcon, are
stored in Little-Endian format, located in the upper 8 bytes of FLASH memory on the CC2430 or
CC2431 processor. The IEEE address is displayed on a sticker affixed to the bottom of each
CC2430DB, CC2430EM, or CC2431EM board

Z-Stack User's Guide - CC2430ZDK F8W-2005-0036 Version 1.4.3
4 Copyright 2005-2007 Texas Instruments, Inc. All rights reserved.
This FLASH memory location would also be used for factory commissioning of IEEE addresses
on devices that use Z-Stack. For CC2430-F128 devices, used on all boards in the development
kit, the least significant byte of the IEEE address is located at “linear” FLASH memory address
0x1FFF8, corresponding to “banked” address 0x3FFF8.
Z-Stack treats the IEEE address area of FLASH as “write once” memory. When an attempt is
made to write an IEEE address to that location (via Z-Tool, etc.), it will succeed only if the
current contents are empty (0xFFFFFFFFFFFFFFFF). In other words, any 8-byte pattern other
than all 0xFF values, is considered to be a valid IEEE address and won’t be modified.
5. Configuring and Using Z-Stack
5.1. Configuring Z-Stack
For the purposes of this release, the ZigBee Logical Device Type and Profile are pre-configured.
Details on configuring and programming sample applications for Z-Stack are provided in the
sections beginning with “Building the SampleApp Devices”.
5.2. Logical Device Types
Z-Stack can be configured in one of three ways:
•ZigBee Coordinator – This device is configured to start the IEEE 802.15.4 network and
will serve as the PAN Coordinator in that network.
•ZigBee Router – This device is configured to join an existing network, associate to a
Coordinator or Router, and then allow other devices to associate to it. It will route data
packets in the network.
•ZigBee End Device – This device is configured to join an existing network and will
associate with a Coordinator or Router.
5.3. Building SampleApp Devices
The remainder of this section describes programming SmartRF04EB+CC2430EM boards to set
up a simple ZigBee network with 2 or more nodes, a SampleApp Coordinator and one or more
SampleApp Routers. The SampleApp project file provides configurations to uniquely build
either of these devices, a well as, to build a generalized “Demo” device which permits selection
of Coordinator and Router operation by setting one jumper on the SmartRF04EB board. The
following examples provide details on building and running the “Demo” sample application on
two or more devices.
5.4. Building a SampleLight Coordinator Device
•Make sure all tools have been installed (Sections 4.1 – 4.2)
•Connect a SmartRF04EB board to the development PC with a USB cable. Apply power
by moving switch S3 toward the CC2430EM board. If Windows needs to install a driver,
browse to C:\Program Files\IAR Systems\Embedded Workbench 4.0\8051\drivers\Chipcon to
locate the necessary files.
•Navigate to the SampleApp project directory and launch the IAR Embedded Workshop
by double clicking on the SampleApp.eww file:

Z-Stack User's Guide - CC2430ZDK F8W-2005-0036 Version 1.4.3
5 Copyright 2005-2007 Texas Instruments, Inc. All rights reserved.
•Select the DemoEB project from the Workspace pull-down menu:
•Build the application by pulling down the Project menu and clicking on Rebuild All:

Z-Stack User's Guide - CC2430ZDK F8W-2005-0036 Version 1.4.3
6 Copyright 2005-2007 Texas Instruments, Inc. All rights reserved.
•Download the application by pulling down the Project menu and clicking on Debug:
•After downloading to the CC2430EM is complete, exit the debugger by pulling down the
Debug menu and clicking on Stop Debugging:

Z-Stack User's Guide - CC2430ZDK F8W-2005-0036 Version 1.4.3
7 Copyright 2005-2007 Texas Instruments, Inc. All rights reserved.
•Remove power from the SmartRF04EB by moving switch S3 away from the CC2430EM
board. Disconnect the SmartRF04EB from the USB cable and set it aside.
•Repeat the previous steps to program more CC2430EM boards. At least two boards must
be programmed to run the “Demo” sample application.
•When all devices have been programmed, exit the Embedded Workbench IDE.
6. Z-Stack Demonstration
6.1. Switches and LEDs
In this, and other Z-Stack sample application documents, references are made to switches and
LEDs located on evaluation boards. These devices are used to control certain Z-Stack features
and display status.
Certain procedures require user input via switches, commonly referred to as SW1 through SW5.
The SmartRF04EB and CC2430DB boards have a 5-position joystick, designated U400, which
provides these switch inputs as shown in the table below. Pressing the joystick toward the U400
label (up position) activates the SW1 input. Switch inputs SW2 – SW4 result from pressing the
joystick to the right, down (away from U400), and left positions, respectively. SW5 occurs when
the joystick is pressed straight down when in the center position.