Texas Instruments CC2431ZDK User manual

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

Z-Stack User's Guide - CC2431ZDK F8W-2006-0025 Version 1.4.3
i Copyright 2006-2007 Texas Instruments, Inc. All rights reserved.
Revision Description Date
1.0 Initial release. 12/13/2006
1.1 Changed IAR compiler version to 7.30B in Section 4.2. 12/21/2007

Z-Stack User's Guide - CC2431ZDK F8W-2006-0025 Version 1.4.3
ii Copyright 2006-2007 Texas Instruments, Inc. All rights reserved.
Table of Contents
1. INTRODUCTION................................................................................................................. 1
1.1. SCOPE .............................................................................................................................. 1
1.2. SCOPE .............................................................................................................................. 1
2. PRODUCT PACKAGE DESCRIPTION........................................................................... 1
2.1. INSTALLATION PACKAGE CONTENTS ............................................................................... 1
2.2. DEVELOPMENT BOARDS .................................................................................................. 1
2.3. CABLES ............................................................................................................................ 2
3. INSTALLATION REQUIREMENTS................................................................................ 2
3.1. HOST COMPUTER REQUIREMENTS ................................................................................... 2
3.2. TARGET DEVELOPMENT SYSTEM REQUIREMENTS ........................................................... 3
4. PRODUCT INSTALLATION PROCEDURES ................................................................ 3
4.1. INSTALL Z-STACK PACKAGE ........................................................................................... 3
INSTALL IAR EW8051 PACKAGE ........................................................................................ 3
4.2................................................................................................................................................ 3
4.3. DEVICE IEEE ADDRESSES ............................................................................................... 3
5. CONFIGURING AND USING Z-STACK ......................................................................... 3
5.1. CONFIGURING Z-STACK................................................................................................... 3
5.2. LOGICAL DEVICE TYPES .................................................................................................. 4
5.3. SELECTING THE APPLICATION PROFILE............................................................................ 4
5.4. BUILDING THE SAMPLE DEVICES ..................................................................................... 4
5.5. BUILDING A LOCATION DONGLE COORDINATOR DEVICE ................................................ 4
5.6. BUILDING A REFERENCE NODE ROUTER DEVICE ............................................................. 8
5.7. BUILDING A BLIND NODE ROUTER DEVICE ................................................................... 11
6. Z-LOCATION DEMONSTRATION ............................................................................... 14
6.1. SWITCHES AND LEDS.................................................................................................... 14
6.2. INITIAL LOADING OF 64-BIT IEEE ADDRESS ................................................................. 15
6.3. NON-VOLATILE MEMORY.............................................................................................. 15
6.4. RUNNING THE SAMPLE APPLICATIONS........................................................................... 15
7. CHANNEL SELECTION .................................................................................................. 16
7.1. ENERGY LEVEL.............................................................................................................. 17
APPLICABLE DOCUMENTS.................................................................................................. 17

Z-Stack User's Guide - CC2431ZDK F8W-2006-0025 Version 1.4.3
iii Copyright 2006-2007 Texas Instruments, Inc. All rights reserved.
Table of Figures
FIGURE 1: CHIPCON SMARTRF04EB WITH CC243XEM ................................................................. 1
FIGURE 2: CHIPCON SOC_BB BATTERY BOARD WITH CC243XEM................................................ 2
Table of Tables
TABLE 1: DEFAULT CHANNEL SELECT BIT MAP ........................................................................... 16

Z-Stack User's Guide - CC2431ZDK F8W-2006-0025 Version 1.4.3
1 Copyright 2006-2007 Texas Instruments, Inc. All rights reserved.
1. Introduction
1.1. Scope
This document accompanies the Texas Instruments Z-Location Z-Stack™ Development kit and
is essentially the same as the document that accompanies the basic Texas Instruments Z-Stack
Development kit: The Z-Stack User’s Guide – CC2430ZDK. The primary difference is that this
document uses Z-Location as the sample application. Z-Location is a sophisticated radio location
solution built on top of Z-Stack, conforming to ZigBee Alliance standards (www.zigbee.org).
1.2. Scope
The CC2430EM and the CC2431EM are interchangeable, except that a device intended to run as
a Blind Node must be fitted with the CC2431EM.
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
There are two Chipcon SmartRF04EB evaluation boards, each to be fitted with a CC243xEM
evaluation module.
Figure 1: Chipcon SmartRF04EB with CC243xEM

Z-Stack User's Guide - CC2431ZDK F8W-2006-0025 Version 1.4.3
2 Copyright 2006-2007 Texas Instruments, Inc. All rights reserved.
There are ten compact Chipcon SOC_BB evaluation boards, each to be fitted with a CC243xEM.
Figure 2: Chipcon SOC_BB Battery Board with CC243xEM
2.3. Cables
All necessary cabling has been included with the development kit. To support program download
and debugging on the SmartRF04EB, a USB cable must be connected from the target board to
the host PC. An RS232 cable may be connected between the serial port on the SmartRF04EB (9-
pin connector) and the host PC to enable communication with the Z-Tool or Z-Location PC
application 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 boards

Z-Stack User's Guide - CC2431ZDK F8W-2006-0025 Version 1.4.3
3 Copyright 2006-2007 Texas Instruments, Inc. All rights reserved.
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-1.2.0.exe, to 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 require the use of EW8051 version 7.30B or
newer. 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 CC243xEM 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 CC243x processor. The IEEE address is
displayed on a sticker affixed to the bottom of each CC243xEM.
This FLASH memory location would also be used for factory commissioning of IEEE addresses
on devices that use Z-Stack. For CC243x-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 Logical Device Type and Profile are pre-configured. Details
on configuring and programming the sample applications for the Z-Location are provided in the
sections beginning with “Building the Sample Devices”.

Z-Stack User's Guide - CC2431ZDK F8W-2006-0025 Version 1.4.3
4 Copyright 2006-2007 Texas Instruments, Inc. All rights reserved.
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. Selecting the Application Profile
Once the Logical Device Type has been selected, devices can be configured for an application.
Supported sample applications for this release of Z-Location include:
•Location Profile – Dongle
•Location Profile – Reference Node
•Location Profile – Blind Node
Multiple application profiles can be configured on a ZigBee device. Profiles are configured to
operate overtop Endpoints which provide unique addressing for the application. By convention,
Endpoint 0 is reserved for the ZigBee Device Object, which performs device specific processing
and implements functions required to support the selected Logical Device Type.
5.4. Building the Sample Devices
The remainder of this document describes setting up a network with 6 or more nodes: a Location
Dongle as Coordinator, 4 or more Reference Node Routers, and 1 or more Blind Node Router(s).
Notice that the procedures in Sections 5.5 thru 5.7 are identical, only folder names and filenames
are different. Other Z-Location sample applications (e.g. a Blind Node End Device) can be built
and loaded using the same general procedures.
5.5. Building a Location Dongle Coordinator Device
•Make sure all tools have been installed (Sections 4.1 – 4.2)

Z-Stack User's Guide - CC2431ZDK F8W-2006-0025 Version 1.4.3
5 Copyright 2006-2007 Texas Instruments, Inc. All rights reserved.
•Navigate to the SampleApp project directory and launch the IAR Embedded Workshop
by double clicking on the SampleApp.eww file.
•Select the CoordinatorEB project from the Workspace pull-down menu:

Z-Stack User's Guide - CC2431ZDK F8W-2006-0025 Version 1.4.3
6 Copyright 2006-2007 Texas Instruments, Inc. All rights reserved.
•Open LocationProfile.h file by clicking the ‘+’ next to the folder ‘App’ and then double-
clicking on the file name. Uncomment only the line that defines the Location Dongle.
•Build the application by pulling down the Project menu and clicking on Rebuild All: