St Zigbee sndev-260 User manual

April 2009 Rev 6 1/40

UM0433

User manual

SNDEV-260 ZigBee® kit

Introduction

This document describes the SNDEV-260 ZigBee® kit which is a full-featured tool kit which

offers all the hardware and software needed for deployment of wireless networks for remote

monitoring, sensing, and control-network applications based on the ZigBee® standard.

The kit provides a complete hardware/software development environment and network

system (3 nodes) that uses the SN260 ZigBee® network processor and the EmberZnet™

ZigBee® advanced wireless protocol stack.

The kit facilitates application development with sample applications and a complete software

tool set that includes Ember's InSight™ Desktop with Network Traffic Analyzer to display

network and node activity in real time.

This user guide is intended to provide an overall description of the software and hardware

requirements for the SNDEV-260 ZigBee® kit, instructions for setting up the hardware and

building the wireless application examples as well as describing known limitations and

issues at release time.

Due to the total compatibility between the SN260 and EM260, and the partnership between

the two companies, some documents have been kindly supplied by Ember.

List of key words

EmberZNet: ZigBee® stack running over the SN260 silicon

EZSP: Ember ZigBee® Serial Protocol

HAL: Hardware Abstraction Layer

ISA: InSight™ Adapter

ISD: InSight™ Desktop

POE: Power Over Ethernet

RCM: Radio Communication Module

RIDE: Raisonance Integrated Development Environment

www.st.com

Obsolete Product(s) - Obsolete Product(s)

Downloaded from Elcodis.com electronic components distributor

Obsolete Product(s) - Obsolete Product(s)

Contents UM0433

2/40

Contents

1 Release notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 SNDEV-260 kit hardware and software content . . . . . . . . . . . . . . . . . . . 5

2.1 Hardware components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2.1.1 SN260 radio communication module (RCM) . . . . . . . . . . . . . . . . . . . . . . 5

2.1.2 REva board for ZigBee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.1.3 STM32F103RBT6 daughter board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.1.4 InSight adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.1.5 External equipment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.2 Software components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.2.1 EmberZnet™ ZigBee compliant networking stack . . . . . . . . . . . . . . . . . . 8

2.2.2 EZSP and HAL libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.2.3 Ride7 toolset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.2.4 IAR toolset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.2.5 InSight™ Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.3 Hardware setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.3.1 Module/cable connections for applications building and uploading . . . . 13

2.3.2 REva board jumper settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.3.3 REva power area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2.3.4 Daughter board jumper settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2.3.5 Raisonance RLink jumper settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

2.3.6 Setting up the InSight adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.4 Building the EZSP and HAL libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.5 Wireless application examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.5.1 Setup the application serial communication channel . . . . . . . . . . . . . . . 19

2.5.2 Sensor, sleepy sensor and sink applications . . . . . . . . . . . . . . . . . . . . . 21

2.5.3 Light and switch applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

2.5.4 Range test application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

2.5.5 Version application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

3 Setting up a network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

3.1 Setting up a sink and sensor ZigBee network . . . . . . . . . . . . . . . . . . . . . 30

3.2 Setting up a light and switch ZigBee network . . . . . . . . . . . . . . . . . . . . . . 32

3.3 Setting up a ZigBee network for RF testing . . . . . . . . . . . . . . . . . . . . . . . 34

3.4 Monitoring network activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

4 Updating the EmberZNet stack image . . . . . . . . . . . . . . . . . . . . . . . . . . 37

4.1 Update the stack image using the Insight adapter tool . . . . . . . . . . . . . . 37

4.2 SPI bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Downloaded from Elcodis.com electronic components distributor

Obsolete Product(s) - Obsolete Product(s)

UM0433 Contents

3/40

5 Limitations and support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

6 Revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Downloaded from Elcodis.com electronic components distributor

Obsolete Product(s) - Obsolete Product(s)

Release notes UM0433

4/40

1 Release notes

The SNDEV-260 kit library package supports the STMicroelectronics STM32F103x

microcontroller whose hardware daughterboard is supplied with the kit.

It also supports STMicroelectronics’ STR71xF, STR75xF and STR91xF microcontrollers

which are not part of the kit. The ST7LITE39 microcontroller is no longer supported.

Downloaded from Elcodis.com electronic components distributor

Obsolete Product(s) - Obsolete Product(s)

UM0433 SNDEV-260 kit hardware and software content

5/40

2 SNDEV-260 kit hardware and software content

This section describes the SNDEV-260 kit contents.

2.1 Hardware components

The SNDEV-260 ZigBee® kit includes 3 hardware nodes.

Each individual hardware node in SNDEV-260 kit consists of:

●1 radio communication module SN260 RCM

●1 REva board for ZigBee + RLink adapter attached + USB cable

●REva daughterboard (with the ST microcontroller)

●1 InSight Adapter (plus a USB connector) to monitor any type of exchange

●1 InSight Port cable

●1 small bag of jumpers

●1 USB-mini cable

2.1.1 SN260 radio communication module (RCM)

The SN260 radio communication module (RCM) offers a complete ZigBee wireless solution

for development and deployment of a low-data-rate, low-power ZigBee application. The

SN260 RCM works combined with a ST host microcontroller (STM32F103RBT6), using the

kit application board.

The RCM directly attaches to the kit application board which contains the ST microcontroller

daughter board. The ZigBee application runs from the ST microcontroller and

communicates with the SN260 through the EZSP APIs. Each radio communication module

is assigned a unique IEEE 64-bit identifier (EUI-64). This number is printed on a label affixed

to the bottom of the module and can also be viewed in InSight Desktop. For detailed

information about the radio communication module, see the technical specification in your

kit.

Note: The SN260 Network Processor is provided with the Ember ZigBee-compliant EmberZNet

stack image already downloaded on it. To update the stack image stack, follow the

instructions in Section 4: Updating the EmberZNet stack image on page 37.

Downloaded from Elcodis.com electronic components distributor

Obsolete Product(s) - Obsolete Product(s)

SNDEV-260 kit hardware and software content UM0433

6/40

2.1.2 REva board for ZigBee

The REva ZigBee Raisonance board is provided with the kit. This board hosts the SN260

RCM modules and the ST microcontroller daughter board allowing running ZigBee

applications.

The REva ZigBee Raisonance board is made up of a generic mother board with embedded

RLink in-circuit programmer and debugger, a daughter board featuring a target

microcontroller and a ZigBee network area. The REva ZigBee Raisonance board has the

following components:

●ZigBee area for hosting a SN260 RCM module

●Digital and analog I/O evaluation features including on-board LEDs, buttons, switches,

buzzer, etc.

●On-board RS232 driver and DB9 connector

●SPI, CAN and USB connections (depending on the target device)

●Embedded RLink for in-circuit debugging and in-circuit programming

●VDD settings for 1.8V, 3.3V and 5V microcontrollers

●USB powered, no external power required

In addition, an USB cable for programming the ST microcontroller using the RIDE toolset

(and also to power the overall board) is provided.

Note: It is also possible to power the REva board using an external power supply (9V) and setting

the REva power jumper to the specific position (in particular, this configuration is used with

the IAR toolset).

2.1.3 STM32F103RBT6 daughter board

The STM32F103RBT6 daughter board includes the following components:

●1 STM32F103 microcontroller

●various jumpers for the chip configuration (boot mode, etc.)

●a 8-MHz crystal clock and USB clock generation

●a 32-kHz crystal for RTC operation

●1 USB mini-B connector

●1 CAN bus driver

Note: The supported STR711FR2, STR750FV2 and STR912FW44 REva daugther boards are not

part of the kit.

Downloaded from Elcodis.com electronic components distributor

Obsolete Product(s) - Obsolete Product(s)

UM0433 SNDEV-260 kit hardware and software content

7/40

2.1.4 InSight adapter

The SNDEV-260 kit includes InSight Adapter which connects the application board to the

Ethernet. Each adapter transmits network data collected by InSight Port and conveys it over

its Ethernet connection to InSight Desktop tool. It also picks up any messages or new

software that is addressed to this board, and processes emulation and debug commands.

ISA allows the host PC interfacing to the hardware node during debugging and

programming.

The InSight Adapter has the following components:

●10-pin InSight Port for interfacing to the radio communication module (providing

programming and debugging services)

●TCP/IP 10/100 Ethernet interface with Power-over-Ethernet functionality.

It is possible to supply power to an Insight adapter over a standard Ethernet cable using a

Power-over-Ethernet switch (not provided with the kit).

The single ISA can be also powered through a DC power jack, for applications not using

Power-over-Ethernet.

Note: Power-over-Ethernet is disabled when the InSight Adapter is powered with the12V DC

power input. However, the Ethernet data is still available.

For detailed information about the InSight Adapter, see the relative document in your kit.

2.1.5 External equipment

To setup a ZigBee network, using the SNDEV-260 hardware and software components, the

minimum external equipment required is a PC (Windows 2000 or XP) with the Raisonance

Ride7 toolset. For more information, refer to Section 2.2.3: Ride7 toolset on page 11.

When using the IAR toolset, the following equipment is required for programming (and/or

debugging):

●IAR J-Link JTAG emulator hardware for programming/debugging

●External power supply (9 V) for powering the REva board

Cabling:

●Serial cable (for connecting the REva board serial SER1 to a PC RS232 port)

●USB mini cable (for connecting the STM32F103x or STR71x-9x USB mini-B connector

to a PC USB port)

Downloaded from Elcodis.com electronic components distributor

Obsolete Product(s) - Obsolete Product(s)

SNDEV-260 kit hardware and software content UM0433

8/40

2.2 Software components

The SNDEV-260 ZigBee kit includes the following software components:

●EmberZnet™ ZigBee compliant networking stack

●EZSP library for driving the SN260 (by STMicroelectronics) or EM260 (by Ember)

ZigBee devices

●HAL library for addressing some of the hardware platform devices and capabilities

●Certain wireless application examples:

– Sensor and sink

– Light switch

– Range test

●Ride7 toolset (Ride7 IDE Version 7.02.001 and RKit-Arm for Ride7 1.05.001) used for

the STM32F103x and STR7x-91x ARM microcontroller family libraries and applications

building and running

●InSight Desktop DEVeloper (3 nodes, 10k events)

2.2.1 EmberZnet™ ZigBee compliant networking stack

The EmberZnet™ ZigBee compliant networking stack is an advanced wireless protocol

stack that runs on the SN260 network processor, and provides algorithms for creating

reliable, flexible, and secure networks.

For information about the EmberZnet™ ZigBee stack, see the related documentation in your

kit.

2.2.2 EZSP and HAL libraries

Figure 1 describes the SNDEV-260 ZigBee® kit library package layout.

Downloaded from Elcodis.com electronic components distributor

Obsolete Product(s) - Obsolete Product(s)

UM0433 SNDEV-260 kit hardware and software content

9/40

Figure 1. SNDEV-260 ZigBee® kit library package layout

ezsp

hal

include

docs

bin

ezsp header files

ezsp sources files (EZSP APIs)

ezsp_hal.rprj Ride7 project for building the

ezsp_hal.lib library image (used for STM32F103x

and STR7x-STR9x microcontrollers)

Board/ST microcontroller dependencies

header files

HAL header files

HAL sources files (HAL APIs)

Header files (specific types, required by the

EZSP APIs and potentially available for

developing applications)

(Access point to all the available documents)

(User Guide, EZSP, HAL APIs …)

A pre-built library image (for STM32F103x)

Pre-built image of a simple ZigBee application

(for STM32F103x)

Pre-built images of the sensor and sink

applications (for STM32F103x)

EmberZNet stack image file

It contains the application loader files (which

allow loading the EmberZNstack image

em260-spi.hex into the SN260 silicon)

SN260 range test (RF quality statistics) image

files

include

src

libs

config

include

src

header files

index.html

other docs

ezsp_hal_2_x.lib

version.hex

sensor.hex, sink.hex

em260-spi.hex

em2xx_load

em260-rangetest.hex

Pre-built images of the light and switch

applications (for STM32F103x)

light.hex, switch.hex

It contains the STM32F103x utility for upload

the stack image through the SPI.

spi_bootloader

serialUSB virtual COM through USB serial

communication support

Support for STM32F103x and STR71x-91x

USB devices USB devices

virtualcom

usblib

stlib STM32F103x, STR7x-91x firmware libraries

header files

STM32F103x, STR7x-91x firmware libraries

binaries files

include

libs

STM32F103x, STR7x-91x firmware libraries

startup files

startup

Downloaded from Elcodis.com electronic components distributor

Obsolete Product(s) - Obsolete Product(s)

SNDEV-260 kit hardware and software content UM0433

10/40

The util directory includes functions for handling the ZigBee source routing, security,

fragmentation, network, ZDO and command line interface.

Figure 2 describes the util directory layout.

Figure 2. util directory layout

Certain application examples are provided to show ZigBee network functions. The kit

includes two simple applications (light and switch) to control a light source. There are also

three more complex applications (sink, sensor and sleepy sensor) to configure a distributed

sensors network and a prebuilt range test application to perform a simple send/receive test

on the device to determine its range and generally test its radio function.

An app directory is provided within the SNDEV-260 kit for hosting applications built over the

EZSP and HAL libraries.

Figure 2 describes the app directory layout.

table

security

Header file for source routing functions

Source routing functions

Header files for ZigBee security

functions

ZigBee security functions

include

src

include

src

util

fragmentation Header files for fragmentation

functions

Fragmentation functions

include

src

networkManager Header files for networkManager

functions

networkManager functions

include

src

zdo Header files for zdo functions

zdo functions

include

src

cli Header files for command line

interface functions

Command line interface functions

include

src

Downloaded from Elcodis.com electronic components distributor

Table of contents

Popular Computer Hardware manuals by other brands

Toshiba

Toshiba TOSVERT VF-MB1/S15 IPE002Z Function manual

Shenzhen

Shenzhen MEITRACK MVT380 user guide

TRENDnet

TRENDnet TEW-601PC - SUPER G MIMO WRLS PC CARD user guide

StarTech.com

StarTech.com CF2IDE18 instruction manual

Texas Instruments

Texas Instruments LMH0318 Programmer's guide

Gateway

Gateway 8510946 user guide

Devon IT

Devon IT TC2D Quick setup guide

Krüger & Matz

Krüger & Matz Air Shair2 owner's manual

Crystalio

Crystalio VPS-2300 quick guide

MYiR

MYiR FZ3 user manual

Protech Systems

Protech Systems BC-K200 Quick reference guide

Miranda

Miranda DENSITE series DAP-1781 Guide to installation and operation

Sierra Wireless

Sierra Wireless Sierra Wireless AirCard 890 quick start guide

Leadtek

Leadtek Killer Xeno Pro Quick installation guide

Star Cooperation

Star Cooperation FlexTiny 3 Series Instructions for use

Hotone

Hotone Ampero user manual

Connect Tech

Connect Tech Xtreme/104-Express user manual

Yealink

Yealink WF50 user guide

ST ZigBee SNDEV-260 User manual

Popular Computer Hardware manuals by other brands