| Download: |  |
| Mirror Download [FCC.gov] | |
| Document ID | 1471903 |
| Application ID | 6nxKE6z5Oniy8FXDe8dWpA== |
| Document Description | USERS MANUAL |
| Short Term Confidential | No |
| Permanent Confidential | No |
| Supercede | No |
| Document Type | User Manual |
| Display Format | Adobe Acrobat PDF - pdf |
| Filesize | 68.16kB (851964 bits) |
| Date Submitted | 2011-05-25 00:00:00 |
| Date Available | 2011-11-21 00:00:00 |
| Creation Date | 2017-11-05 12:27:42 |
| Producing Software | GPL Ghostscript 9.18 |
| Document Lastmod | 2017-11-05 12:27:42 |
| Document Title | Microsoft Word - manual_probee_ze20s-v0.0.1_eng_certification |
| Document Creator | PScript5.dll Version 5.2 |
| Document Author: | ckhun |
ProBee-ZE20S Series User Guide Rev.0.1
ZigBee OEM Module
ProBee-ZE20S Series
User Guide
Sena Technologies, Inc.
Rev 0.1
ProBee-ZE20S Series User Guide Rev.0.1
ProBee-ZE20S Series User Guide
Firmware version PTv1.X
Copyright
Copyright 2010 Sena Technologies, Inc. All rights reserved.
Sena Technologies reserves the right to make changes and improvements to its product without providing
notice.
Trademark
ProBee™ is a trademark of Sena Technologies, Inc.
Windows® is a registered trademark of Microsoft Corporation.
Ethernet® is a registered trademark of XEROX Corporation.
Notice to Users
When a system failure may cause serious consequences, protecting life and property against such
consequences with a backup system or safety device is essential. The user agrees that protection against
consequences resulting from system failure is the user's responsibility.
This device is not approved for life-support or medical systems.
Changes or modifications to this device not explicitly approved by Sena Technologies will void the user's
authority to operate this device.
Technical Support
Email: support@sena.com
Website: http://www.sena.com
ProBee-ZE20S Series User Guide Rev.0.1
Contents
INTRODUCTION ....................................................................................................... 9
1.1
About This Document ..................................................................................................................... 9
1.2
Overview ......................................................................................................................................... 9
GETTING STARTED ............................................................................................... 11
2.1
2.1.1
Development Board Layout ................................................................................................... 11
2.1.2
Antenna Installation ............................................................................................................... 12
2.1.3
Module Installation on the Development Board .................................................................... 12
2.1.4
Serial/USB Cable Installation ................................................................................................ 13
2.1.5
Powering Development Board............................................................................................... 14
2.1.6
USB Driver Installation .......................................................................................................... 14
2.2
Using Terminal Software for AT Commands ................................................................................. 15
2.3
Using ProBee Manager for Configuration .................................................................................... 17
ZIGBEE NETWORK CONFIGURATION................................................................. 18
3.1
Setting up ZE20S as a Coordinator .............................................................................................. 18
3.1.1
Node Type Selection for Coordinator .................................................................................... 19
3.1.2
Channel Mask Configuration for Coordinator ........................................................................ 19
3.1.3
PAN ID Configuration for Coordinator ................................................................................... 20
3.1.4
Permit Joining ........................................................................................................................ 20
3.2
Hardware Installation .................................................................................................................... 11
Setting up ZE20S as a Router ...................................................................................................... 21
3.2.1
Node Type Selection for Router ............................................................................................ 21
3.2.2
Channel Mask Configuration for Router ................................................................................ 22
3.2.3
PAN ID Configuration for Router ........................................................................................... 22
3.2.4
Permit Joining ........................................................................................................................ 22
3.3
Setting up ZE20S as an End Device ............................................................................................ 23
3.4
Setting up ZE20S as a Sleepy End Device .................................................................................. 23
3.5
ZigBee Security ............................................................................................................................ 25
3.5.1
Security Level ........................................................................................................................ 26
3.5.2
Link Key ................................................................................................................................. 26
3.5.3
Network Key .......................................................................................................................... 26
3.5.4
Update Key ............................................................................................................................ 26
DATA TRANSMISSION........................................................................................... 27
4.1
Command Mode ........................................................................................................................... 27
4.1.1
Unicast................................................................................................................................... 27
ProBee-ZE20S Series User Guide Rev.0.1
4.1.2
Multicast ................................................................................................................................ 27
4.1.3
Broadcast .............................................................................................................................. 28
4.1.4
Sending Binary Data ............................................................................................................. 28
4.1.5
Display Incoming Message ................................................................................................... 28
4.2
Data Mode .................................................................................................................................... 29
4.2.1
Unicast Data Mode ................................................................................................................ 29
4.2.2
Multicast Data Mode .............................................................................................................. 31
4.2.3
Broadcast Data Mode............................................................................................................ 33
DIGITAL AND ANALOG I/O.................................................................................... 35
5.1
GPIO Configuration ...................................................................................................................... 35
5.2
I/O Sampling ................................................................................................................................. 36
5.2.1
Queried Sampling .................................................................................................................. 36
5.2.2
Periodic Sampling ................................................................................................................. 38
5.2.3
Change Detection Sampling.................................................................................................. 38
5.2.4
GPIO Remote Control ........................................................................................................... 39
WORKING WITH DEVELOPMENT KIT ................................................................. 40
6.1
Development Kit Contents ............................................................................................................ 40
6.2
Development Board Features....................................................................................................... 40
6.3
Development Board Hardware Descriptions ................................................................................ 41
6.3.1
Power .................................................................................................................................... 41
6.3.2
RS232 Port ............................................................................................................................ 42
6.3.3
USB Port................................................................................................................................ 42
6.3.4
ZE20S GPIO Interface .......................................................................................................... 42
6.3.5
LEDs (CR12-19) .................................................................................................................... 43
6.3.6
Button Switches (SW10-17) .................................................................................................. 43
6.3.7
Variable Resistors (VR1, VR2) .............................................................................................. 43
6.3.8
Temperature Sensor .............................................................................................................. 43
6.3.9
Light Sensor .......................................................................................................................... 43
6.3.10
Terminal Block ....................................................................................................................... 44
6.4
Configuration Example #1: 1 Coordinator, 1 Router and 1 End-Device ....................................... 44
6.4.1
Coordinator Configuration ..................................................................................................... 45
6.4.2
Router Configuration ............................................................................................................. 45
6.4.3
End-device Configuration ...................................................................................................... 46
6.4.4
Monitoring the Sensors ......................................................................................................... 46
6.5
Configuration Example #2: 1 Coordinator and 2 End-Devices ..................................................... 46
6.5.1
Coordinator Configuration ..................................................................................................... 47
6.5.2
End-devices Configuration .................................................................................................... 47
6.5.3
Turning on/off the LEDs ......................................................................................................... 48
ProBee-ZE20S Series User Guide Rev.0.1
AT COMMAND REFERENCE................................................................................. 49
7.1
Command Line Format ................................................................................................................. 49
7.2
Standard AT Commands............................................................................................................... 49
7.2.1
AT .......................................................................................................................................... 49
7.2.2
ATB ........................................................................................................................................ 49
7.2.3
ATD ........................................................................................................................................ 49
7.2.4
ATE ........................................................................................................................................ 50
7.2.5
ATM ....................................................................................................................................... 50
7.2.6
ATO........................................................................................................................................ 50
7.2.7
ATR ........................................................................................................................................ 50
7.2.8
ATS ........................................................................................................................................ 50
7.2.9
ATZ ........................................................................................................................................ 50
7.2.10
AT&F ...................................................................................................................................... 50
7.2.11
+++ ........................................................................................................................................ 51
7.3
Node Specific Information ............................................................................................................ 51
7.3.1
AT+LONGADDR or AT+LA .................................................................................................... 51
7.3.2
AT+SHORTADDR or AT+SA ................................................................................................. 51
7.3.3
AT+ADDRDISCOVERY or AT+AD ........................................................................................ 51
7.3.4
AT+OPCH or AT+OC ............................................................................................................. 51
7.3.5
AT+OPPANID or AT+OI ......................................................................................................... 52
7.3.6
AT+OPEPID or AT+OE .......................................................................................................... 52
7.3.7
AT+VERSION or AT+VR ....................................................................................................... 52
7.3.8
AT+PRODUCTNAME or AT+PN ........................................................................................... 52
7.4
Network Specific Parameters ....................................................................................................... 52
7.4.1
AT+CHMASK or AT+CM ....................................................................................................... 52
7.4.2
AT+PANID or AT+PI .............................................................................................................. 53
7.4.3
AT+EPID or AT+EI ................................................................................................................. 53
7.4.4
AT+GROUPID or AT+GI ........................................................................................................ 53
7.4.5
AT+POWER or AT+PW ......................................................................................................... 53
7.4.6
AT+STACK or AT+ZS ............................................................................................................ 53
7.4.7
AT+NODENAME or AT+NN .................................................................................................. 54
7.5
Network Formation and Join......................................................................................................... 54
7.5.1
AT+ASCAN or AT+AS ........................................................................................................... 54
7.5.2
AT+ESCAN or AT+ES ........................................................................................................... 54
7.5.3
AT+DSCAN or AT+DS ........................................................................................................... 54
7.5.4
AT+NODETYPE or AT+NT .................................................................................................... 55
7.5.5
AT+PERMIT or AT+PJ ........................................................................................................... 55
7.5.6
AT+LEAVE or AT+LV ............................................................................................................. 55
7.6
End-device .................................................................................................................................... 55
ProBee-ZE20S Series User Guide Rev.0.1
7.6.1
AT+SLEEP or AT+SM............................................................................................................ 55
7.6.2
AT+PARENTLA or AT+PL ..................................................................................................... 55
7.6.3
AT+PARENTSA or AT+PS ..................................................................................................... 56
7.6.4
AT+CHILDTABLE or AT+CT .................................................................................................. 56
7.7
7.7.1
AT+DESTLA or AT+DL .......................................................................................................... 56
7.7.2
AT+DESTGROUPID or AT+DG............................................................................................. 56
7.7.3
AT+SINKINFO or AT+SI ........................................................................................................ 56
7.7.4
AT+MAXPAYLOAD or AT+MP ............................................................................................... 57
7.7.5
AT+TRASNSMITMODE or AT+TM........................................................................................ 57
7.7.6
AT+UNICAST or AT+UC ....................................................................................................... 57
7.7.7
AT+MULTICAST or AT+MC ................................................................................................... 57
7.7.8
AT+BROADCAST or AT+BC ................................................................................................. 57
7.7.9
AT+REMOTE or AT+RC ........................................................................................................ 57
7.8
UART ............................................................................................................................................ 58
7.8.1
AT+BAUDRATE or AT+UB .................................................................................................... 58
7.8.2
AT+DATABIT or AT+UD......................................................................................................... 58
7.8.3
AT+PARITY or AT+UP ........................................................................................................... 58
7.8.4
AT+STOPBIT or AT+US ........................................................................................................ 58
7.8.5
AT+FLOWCTRL or AT+UF .................................................................................................... 59
7.9
Security ......................................................................................................................................... 59
7.9.1
AT+SECURITY or AT+SE...................................................................................................... 59
7.9.2
AT+LINKKEY or AT+LK ......................................................................................................... 59
7.9.3
AT+NWKKEY or AT+NK ........................................................................................................ 59
7.9.4
AT+UPDATEKEY or AT+UK .................................................................................................. 59
7.10
GPIO ............................................................................................................................................. 60
7.10.1
AT+GPIO or AT+IO ................................................................................................................ 60
7.10.2
AT+DIO .................................................................................................................................. 60
7.10.3
AT+AI ..................................................................................................................................... 60
7.10.4
AT+ SOURCELA or AT+SL ................................................................................................... 60
7.11
Data Transmission and Reception................................................................................................ 56
Firmware Upload and Help ........................................................................................................... 61
7.11.1
AT+BOOTLOAD or AT+BL .................................................................................................... 61
7.11.2
AT+HELP or AT+HP .............................................................................................................. 61
AT COMMAND EXAMPLES ................................................................................... 62
8.1
Network configuration ................................................................................................................... 62
8.1.1
Coordinator ............................................................................................................................ 62
8.1.2
Router .................................................................................................................................... 62
8.1.3
End-device............................................................................................................................. 62
8.1.4
Sleepy End-device ................................................................................................................ 62
ProBee-ZE20S Series User Guide Rev.0.1
8.1.5
8.2
Data Transmission ........................................................................................................................ 63
8.2.1
Command Mode .................................................................................................................... 63
8.2.2
Data Mode ............................................................................................................................. 63
8.3
UART Settings .............................................................................................................................. 64
8.4
Security ......................................................................................................................................... 65
8.5
GPIO ............................................................................................................................................. 65
8.6
Firmware Upload .......................................................................................................................... 65
8.6.1
Specifying Network ................................................................................................................ 62
Local Node ............................................................................................................................ 65
8.6.2
Remote Node ........................................................................................................................ 66
8.6.3
Clone ..................................................................................................................................... 66
S-REGISTERS ........................................................................................................ 67
9.1
Display Options............................................................................................................................. 67
9.1.1
S11......................................................................................................................................... 67
9.1.2
S12 ........................................................................................................................................ 68
9.1.3
S13 ........................................................................................................................................ 68
9.1.4
S14 ........................................................................................................................................ 68
9.2
Network Settings........................................................................................................................... 68
9.2.1
S21 ........................................................................................................................................ 68
9.2.2
S22 ........................................................................................................................................ 69
9.2.3
S23 ........................................................................................................................................ 69
9.3
Data Transmissions ...................................................................................................................... 69
9.3.1
S31 ........................................................................................................................................ 69
9.3.2
S32 ........................................................................................................................................ 69
9.3.3
S33 ........................................................................................................................................ 70
9.3.4
S34 ........................................................................................................................................ 70
9.3.5
S35 ........................................................................................................................................ 70
9.3.6
S36 ........................................................................................................................................ 71
9.3.7
S37 ........................................................................................................................................ 71
9.3.8
S38 ........................................................................................................................................ 71
9.3.9
S39 ........................................................................................................................................ 71
9.4
GPIO ............................................................................................................................................. 72
9.4.1
S41 ........................................................................................................................................ 72
9.4.2
S42 ........................................................................................................................................ 72
9.4.3
S43 ........................................................................................................................................ 72
9.4.4
S44 ........................................................................................................................................ 72
9.4.5
S45 ........................................................................................................................................ 73
9.5
End Device ................................................................................................................................... 73
9.5.1
S51 ........................................................................................................................................ 73
ProBee-ZE20S Series User Guide Rev.0.1
9.5.2
S52 ........................................................................................................................................ 73
9.5.3
S53 ........................................................................................................................................ 73
9.5.4
S54 ........................................................................................................................................ 74
9.5.5
S55 ........................................................................................................................................ 74
9.5.6
S56 ........................................................................................................................................ 74
9.6
Sink ............................................................................................................................................... 75
9.6.1
S61 ........................................................................................................................................ 75
9.6.2
S62 ........................................................................................................................................ 75
10
PIN ASSIGNMENTS ............................................................................................ 76
11
MECHANICAL DRAWINGS................................................................................. 78
12
WARRANTY......................................................................................................... 83
12.1
GENERAL WARRANTY POLICY ................................................................................................. 83
12.2
LIMITATION OF LIABILITY........................................................................................................... 83
12.3
HARDWARE PRODUCT WARRANTY DETAILS ......................................................................... 83
12.4
SOFTWARE PRODUCT WARRANTY DETAILS ......................................................................... 84
12.5
THIRD-PARTY SOFTWARE PRODUCT WARRANTY DETAILS ................................................ 84
13
REGULATORY INFORMATION ........................................................................... 85
13.1
FCC .............................................................................................................................................. 85
13.2
CE ................................................................................................................................................. 85
13.3
TELEC .......................................................................................................................................... 86
13.4
KCC .............................................................................................................................................. 86
13.5
ZigBee Alliance ............................................................................................................................. 86
14
RF INFORMATION .............................................................................................. 87
ProBee-ZE20S Series User Guide Rev.0.1
Introduction
1.1
About This Document
This document provides an introduction on configuration and operation of the ProBee-ZE20S ZigBee
OEM module. This document assumes the user is using the ZE20S starter kit for evaluation hence the
pictures and configuration examples shown in this document are all based on the ZE20S starter kit.
This document does not provide full detail of the hardware specifications. Please refer to the ProBeeZE20S data sheet for further references on the hardware design.
1.2
Overview
The ProBee-ZE20S is an all-in-one ZigBee OEM module with integrated ZigBee core and radio/antenna
circuits together with high level software library. Using the ZE20S, OEM manufacturers can easily and
cost-effectively integrate ZigBee functionality into target products in timely manner.
The ZE20S OEM module is designed to meet specific requirements of low cost and low power wireless
applications such as home automation or smart energy by adopting the ZigBee technology. The ZE20S is
based on the Ember EM250 ZigBee core and fully certified under the latest ZigBee Pro standard for the
maximum compatibility.
Despite of its low cost and low power consumptions, the ZE20S provides high performance and robust
data transfer capability for wide range of applications. The ZE20S can transfer data at up to 250 kbps and
reach up to 1.6 km (0.99 miles) outdoor line-of-sight.
Key Features
•
Integrated 2.4GHz, IEEE 802.15.4-compliant transceiver
•
ZigBee Pro Certified
•
ZigBee core: Ember EM357
•
Transmit Power: +8dBm (max.)
•
Receiver Sensitivity: -100dBm @1% BER
•
TX current : 33mA (typ.) / 45mA (max. boost mode) @3.3V
•
RX current: 28mA (typ.) / 31ma (max. boost mode) @3.3V
•
Sleep Current: ≤ 1uA
•
Working Distance: 400m outdoor, 40m indoor
•
Various Antenna/Connector Options: Dipole 1/3/5dBi, RPSMA, U.FL, Chip
•
Full UART Signals Support: UART_TXD/RXD, RTS/CTS, DTR/DSR
•
6 Analog Inputs
•
22 Digital Inputs/Outputs
•
RoHS Compliant
ProBee-ZE20S Series User Guide Rev.0.1
Applications
•
Advanced Metering Infrastructure
•
Home Area Networks (HAN)
•
Neighborhood Area Networks (NAN)
•
Home Automation
•
Advanced lighting, entertainment, and climate control systems
•
Service-based monitoring, security, and awareness systems
•
Commercial Building Automation
•
Climate & lighting control systems
•
Industrial and Domestic Applications
Model despription
Antenna
Model name
Interface
Connector
Type1
Type2
Type3
ProBee-ZE20SDU
DIP, pin
U.FL
5dBi dipole
3dBi dipole
1dBi stub
ProBee-ZE20SDS
DIP, pin
RPSMA
5dBi dipole
3dBi dipole
1dBi stub
ProBee-ZE20SDC
DIP, pin
CHIP
0dBi Chip
ProBee-ZE20SSU
SMD, pad
U.FL
5dBi dipole
3dBi dipole
1dBi stub
ProBee-ZE20SSC
SMD, pad
CHIP
0dBi Chip
10
ProBee-ZE20S Series User Guide Rev.0.1
Getting Started
Creating a ZigBee network using the ZE20S modules consists of the following steps:
•
Install the ZE20S module on the development board
•
Create a ZigBee network by configuring a ZE20S module as the coordinator
•
Configure ZE20S modules as routers. This step is optional since the coordinator works as a
router too.
•
Configure ZE20S modules as end devices
•
Transmit data between ZE20S devices
This chapter describes how to install the ZE20S modules on to the development boards and how to use
terminal software programs to access the ZE20S modules using AT commands for configurations and
operations. The rest of the steps including ZigBee network creation, coordinator/router/end-device
configurations and data transmissions are described in the following chapters. The more detailed
information on the development kit and the configuration examples are also provided in the later chapter.
2.1
Hardware Installation
2.1.1
Development Board Layout
Figure 2-1 shows the layout of the development board. The development board provides the interface
between the ZE20S and the external serial port or USB port together with input/output terminals for
convenient tests.
TBD
Figure 2-1 Development Board Layout
11
ProBee-ZE20S Series User Guide Rev.0.1
2.1.2
Antenna Installation
The ZE20S starter kit includes the several antennas for evaluation purposes. You can try different
antennas for testing purpose and select the appropriate antenna for the actual applications. Figure 2-2
shows how to install the RP-SMA dipole antenna to the ZE20S module.
TBD
Figure 2-2 RP-SMA Dipole Antenna Installation
2.1.3
Module Installation on the Development Board
Once the antenna is installed on the ZE20S module, the ZE20S module can be installed on the
development board.
TBD
Figure 2-3 ZE20S Installation on the Development Board
12
ProBee-ZE20S Series User Guide Rev.0.1
2.1.4
Serial/USB Cable Installation
After the ZE20S is securely installed on the development board, please connect the included serial cable
between the development board and your computer so AT commands can be sent from the computer to
the ZE20S module. The serial port of the development board is DB9 male as a DTE terminal, and the
serial cable included is a cross-over cable for DTE-DTE connection. To use the serial port, the HOST
(SW2) switch should be set to UART.
TBD
Figure 2-4 Serial Cable Installation
In case the serial port is not available for the computer, you can use the USB port of the development
board instead. In this case, the internal USB-RS232 converter of the development board will convert the
USB signal to the RS232 signal and vice versa. To use the USB port, the HOST (SW2) switch should be
set to USB and the software driver for the USB in the CD should be installed on the computer. For the
USB driver installation, please refer to the section 2.1.6.
TBD
Figure 2-5 USB Cable Installation
13
ProBee-ZE20S Series User Guide Rev.0.1
2.1.5
Powering Development Board
Once all the installations are completed, please plug in the power connector using the included DC power
adapter. The RS_PWR, USB_PWR and BATT_EN jumpers should be all OPEN to use the DC power
adapter. Alternatively, the development board can be powered using batteries, or from the USB port or
through the RS232 port pin 9. In these cases, the power source jumpers should be set accordingly. For
details about the power source jumper settings, please refer to the section 6.3.1 Power.
TBD
Figure 2-6 Plugging DC Power Adapter
2.1.6
USB Driver Installation
In case the USB interface is used for the communication between the development board and the
computer, the corresponding software driver needs to be installed on the computer. Windows XP and later
versions already include the USB driver. When Windows asks for the location of the USB driver, you can
select the option to “install the software automatically” as shown in Figure 2-7. You can also choose to
install the driver from the CD included if the driver is not installed correctly for some reason.
Figure 2-7 USB Driver Installation
14
ProBee-ZE20S Series User Guide Rev.0.1
2.2
Using Terminal Software for AT Commands
Once the hardware installation is complete, the ZE20S unit is ready to communicate with the computer
using the AT commands using a terminal emulation software. You can use any kind of terminal emulation
software. This document assumes HyperTerminal is used. If you are using Windows Vista or 7,
HyperTerminal is no longer included in the Windows so you need to download HyperTerminal from the
Internet. For more details on HyperTerminal, please refer to Microsoft web page.
Once the HyperTerminal is installed, launch HyperTerminal and select the serial port that is connected to
the ZE20S development board and enter the serial settings to use. The default serial settings of the
ZE20S are 9600 bps, 8 data bit, none parity, 1 stop bit, hardware flow control.
Figure 2-8 HyperTerminal Serial Settings
15
ProBee-ZE20S Series User Guide Rev.0.1
To display the AT commands that are being typed, you need to enable the local echo option on the
HyperTerminal. To enable this option, Go to File->Properties->Settings->ASCII setup and select the
“Echo typed characters locally” option. To verify the connection, type AT and press the Enter key. If the
AT command is accepted by the ZE20S, OK string will be displayed on the screen.
Figure 2-9 Testing AT Command on HyperTerminal
16
ProBee-ZE20S Series User Guide Rev.0.1
2.3
Using ProBee Manager for Configuration
Figure 2-10 ProBee Manager
It is possible to set or get the configurations of the ZE20S using ProBee Manager. This PC utility helps
that a user can configure several setting values easily without a terminal program and upload the
firmware file to local and/or remote node.
17
ProBee-ZE20S Series User Guide Rev.0.1
ZigBee Network Configuration
A ZigBee Network consists of a coordinator, routers and end devices. A minimal ZigBee network consists
of one coordinator and multiple end devices which directly connect to the coordinator. For larger ZigBee
networks, routers are required to provide redundant routings to form mesh networks.
•
ZigBee Coordinator: The coordinator forms the root of the network tree and might bridge to
other networks. There is exactly one ZigBee coordinator in each network since the coordinator
starts the ZigBee network itself. It also stores information about the network, including acting as
the Trust Center & repository for security keys.
•
ZigBee Router: The routers are able to route messages between other devices. Since the
coordinator provides the routing functionality too, the routers are optional to form a ZigBee
network.
•
ZigBee End Device: The end device contains just enough functionality to talk to the parent node
which is either the coordinator or a router. It cannot relay data from other devices.
•
ZigBee Sleepy End Device: The sleepy end device is the same with normal end device except it
can stay in the sleep mode much longer. This relationship allows the end device to sleep
significant amount of the time and achieve the long battery life.
The ZE20S can be configured to work either as a coordinator, a router or an end device. Once the
operation mode of the ZE20S is selected, corresponding parameters need to be set up appropriately. This
chapter explains how to configure the ZE20S operation mode and other parameters related to the ZigBee
network itself.
Table 3-1 ZigBee Node Types
Node Type
Recommendation when to use ZE20S
Coordinator
It should be selected when it is first time to establish the network.
Router
It is recommended when there is a network already and it needs to be expanded. A
router is suitable for fast and stable data transmissions and receptions.
End Device
It is recommended when it doesn’t need to expand the network anymore and there
are enough nodes as parents. An end-device consumes less power than a router.
Sleepy End Device
It is recommended when the data transmissions occur rarely and in very small
quantities. A sleepy end device can lose data if sleep duration is too long, but it is
possible to consume extremely low power as low as 2uA.
3.1
Setting up ZE20S as a Coordinator
A coordinator relays messages and can act as a parent to other nodes. Every personal area network
(PAN) must be started by a node acting as the coordinator. This device is normally always powered on.
To set up the ZE20S to work as the coordinator, please follow the steps as below
18
ProBee-ZE20S Series User Guide Rev.0.1
•
Configure the ZE20S node type as the coordinator
•
Optionally, select the channel mask. Otherwise, the ZE20S will use the default channel mask.
•
Optionally, set up the PAN ID and/or the extended PAN ID. Otherwise, the ZE20S will generate
the PAN ID and/or the extended PAN ID automatically.
•
3.1.1
Permit joining when other router or end device tries to join the ZigBee network.
Node Type Selection for Coordinator
The ZE20S module can be configured as a ZigBee coordinator by the AT command as below:
AT+NODETYPE=n or AT+NT=n
Where n is 0 = none, 1 = coordinator, 2 = router, 3 = end-device, 4 = sleepy end-device
After the operation mode is selected, ATZ command should be performed to reset the unit to have the
change applied.
Example)
AT+NODETYPE=1
# Set node type as the coordinator
OK
# Response
ATZ
# Apply the change
OK
# Response
3.1.2
Channel Mask Configuration for Coordinator
When the ZigBee coordinator starts, it scans predefined frequency channels to find the best frequency
channel to use without causing interference with other wireless devices. The user is able to specify the
channels to use with the AT command as below:
AT+CHMASK=n
Where n = channel mask to use. Default = 0x03FFF000
This value has a 32-bit hexadecimal unsigned integer. Each bit represents whether a channel will be used
or not. For example, to use a channel between 12 and 15, the 12, 13, 14 and 15 bits of the channel mask
should be 1 and all other bits should be 0. The default setting is 0x3FFF000 which means that all the
channels from 12 to 25 can be used. The ZE20S supports only the channels between 12 and 25, so 0~11
bits and 26~31 bits should be 0. Table 3-2 shows the bit mask for each channel.
19
ProBee-ZE20S Series User Guide Rev.0.1
Table 3-2 Channel Bitmask
Channel
12
13
14
15
16
17
18
Bit mask
00001000
00002000
00004000
00008000
00010000
00020000
00040000
Channel
19
20
21
22
23
24
25
Bit mask
00080000
00100000
00200000
00400000
00800000
01000000
02000000
3.1.3
PAN ID Configuration for Coordinator
Every ZigBee network should be assigned a PAN ID to identify the network. If the PAN ID is 0000, the
ZE20S will generate a random 16-bit PAN ID to start the ZigBee network. Otherwise, the user can enter
the PAN ID using the AT command as below:
AT+PANID=xxxx
Where xxxx is PAN ID to use. For example, 12AB. Default setting is 0000
When choosing a PAN ID, the user needs to make sure that there is no ZigBee network using the same
PAN ID. If the PAN ID is already used by another ZigBee network, the PAN ID is unavailable and the user
should choose a new PAN ID. In order to avoid this, PAN ID auto-generation is strongly recommended.
The user can also assign the 64-bit extended PAN ID to the ZE20S using the AT command below. If the
extended PAN ID is 0000000000000000, the ZE20S uses its IEEE address as the extended PAN ID. The
extended PAN ID cannot be shared with other ZigBee networks either.
AT+EPID=xxx…xxx
Where xxx…xxx is EPID to use. For example, 0123456789ABCDEF. Default setting is 000…000.
3.1.4
Permit Joining
When a router or an end device tries to join the ZigBee network, there should be at least one coordinator
or router which is permitting joining. If there is no router in the ZigBee network yet, the coordinator should
permit joining. The ZE20S provides three ways to permit joining are as follows:
•
Permanently permitting by configuration
•
Transiently permitting by AT command
•
Transiently permitting by digital input signal
If joining is permanently permitted, any device can join anytime. Since this will allow even an unidentified
device to join the network anytime, this mode should be selected with extra caution. The AT command to
permit joining permanently is as follows:
AT+PERMIT=255 or AT+PJ=255
20
ProBee-ZE20S Series User Guide Rev.0.1
The user can permit joining for a moment at need. The AT command to permit joining is
AT+PERMIT=n or AT+PJ=n
Where n is the duration to permit in seconds ranging 1~254 seconds.
The user can also configure the ZE20S to permit joining when the digital input GPIO0 is active. The AT
command to enable this functionality is as follows:
AT+GPIO0=5 or AT+IO0=5
When the ZE20S detects falling edge of the GPIO0, the ZE20S permits joining for the duration that is
configured in S-register 22 (S22). The AT command to change the duration is as follows:
ATS22=n
Where n is the duration to permit in seconds ranging 1~254 seconds. Default is 60.
S22 value determines the time that the device will allow other devices to join to it. If set to 255, the device
will always permit other nodes joining. If the user reboots the coordinator (or a router), the device allows
other nodes to join the network for the period defined by S-register 22.
Note: When a device that has joined a network reboots, the device is able to join the network regardless
of permitting. But, after the device has joined other network, rejoining the previous network should be
permitted by the coordinator or a router.
3.2
Setting up ZE20S as a Router
A router is a full-function routing device that relays messages and can act as a parent to other nodes.
These devices must be always powered on.
To configure the ZE20S as a ZigBee router, please follow the steps below.
•
Configure the ZE20S node type as a router.
•
Optionally, select the channel mask. Otherwise, the ZE20S will use the default channel mask.
•
Optionally, set up the PAN ID and/or the extended PAN ID. Otherwise, the ZE20S will scan and
join the ZigBee network found automatically.
•
3.2.1
Permit joining when other router or end device tries to join the ZigBee network.
Node Type Selection for Router
The ZE20S module can be configured as a ZigBee router by the AT command as below:
AT+NODETYPE=n or AT+NT=n
Where n is 0 = none, 1 = coordinator, 2 = router, 3 = end-device, 4 = sleepy end-device
21
ProBee-ZE20S Series User Guide Rev.0.1
After the operation mode is selected, ATZ command should be performed to reset the unit to have the
change applied.
Example)
AT+NODETYPE=2
# Select router mode
OK
# Response
ATZ
# Apply the change
OK
# Response
3.2.2
Channel Mask Configuration for Router
When the ZE20S as a ZigBee router or a ZigBee end device tries to join, it scans all the channels
configured by channel mask to find the ZigBee network to join. The channel mask of router or end device
should include the channel on which the coordinator is operating. For example, we assume that the
coordinator of the network to join is operating on channel 12. The router or end device trying to join
should has a channel mask of which 12th bit is 1
3.2.3
PAN ID Configuration for Router
The PAN ID of a ZigBee router or a ZigBee end device should be the same with the PAN ID of the ZigBee
coordinator. If the coordinator is using a randomly generated PAN ID, the user can get the operating PAN
ID by running the AT command below on the coordinator:
AT+OPPANID
If the PAN ID of a ZigBee router or a ZigBee end device is 0000, the PAN ID is ignored. After checking the
PAN ID, the ZE20S trying to join compares the extended PAN ID to make sure whether the network is the
right network to join. If the extended PAN ID is the same with its configured extended PAN ID, it will try to
join the network. Otherwise, it will try to find another network. The user can get the operating extended
PAN ID by running the AT command below on the coordinator:
AT+OPEPID
If the extended PAN ID of a ZigBee router or a ZigBee end device is 0000000000000000, the extended
PAN ID is ignored
3.2.4
Permit Joining
The ZigBee router is configured and works the same way with the coordinator to permit joining of other
nodes. Please refer to the section 3.1.4 Permit Joining for the configuration.
22
ProBee-ZE20S Series User Guide Rev.0.1
3.3
Setting up ZE20S as an End Device
An end device is a leaf node which communicates only with its parent node and will not relay messages
directly. To configure the ZE20S as a ZigBee end device, please follow the steps below.
•
Configure the ZE20S node as an end device
•
Optionally, select the channel mask. Otherwise, the ZE20S will use the default channel mask.
•
Optionally, set up the PAN ID and/or the extended PAN ID. Otherwise, the ZE20S will scan and
join the ZigBee network found automatically.
•
Configure the poll timeout and the poll period
Please refer to the section 3.2 Setting up ZE20S as a Router for the AT commands regarding the node
type selection through the PAN ID configurations.
When an end device joins the network, the power LED blinks periodically if GPIO1 is set to specific
functionality. The end device belongs to a parent node which is either the coordinator or a router, and the
parent node registers the end device to its internal child table for message relaying. This table is
maintained as long as the end device polls the parent node periodically within the poll timeout value of the
parent node. If the end device does not poll for the poll timeout value of the parent node, the parent node
removes the end device from its child table and does not relay the message any more. Hence, the poll
period of the end device should be equal or shorter than the poll timeout of the parent node to avoid
accidental removal of the end device from the parent node’s child table.
The ZE20S poll interval can be configured by setting the S-registers using the AT commands as below.
ATS51=n, where n is poll timeout in seconds and the default is 60.
ATS56=n, where n is poll period in seconds and the default is 5.
End device polls the parent node at poll period defined by S56 periodically. It is for the connection to the
parent node and data transmission with other nodes in the network.
Even though the end device needs to poll the parent node continuously, it does not go into the sleep
mode and it can send and receive messages any time unlike the sleepy end device.
3.4
Setting up ZE20S as a Sleepy End Device
A sleepy end device can turn off radio to save power. To configure the ZE20S as a ZigBee sleepy end
device, please follow the steps below.
•
Configure the ZE20S node as a sleepy end device.
•
Optionally, select the channel mask. Otherwise, the ZE20S will use the default channel mask.
•
Optionally, set up the PAN ID and/or the extended PAN ID. Otherwise, the ZE20S will scan and
23
ProBee-ZE20S Series User Guide Rev.0.1
join the ZigBee network found automatically.
•
Configure the settings for sleep interval.
Please refer to the section 3.2 Setting up ZE20S as a Router for the AT commands regarding the node
type selection through the PAN ID configurations.
One of the unique features of the ZigBee device is its extreme low power consumption which is mainly
achieved by its efficient sleep and wake-up mechanism. While ZigBee coordinator and routers are
required to be in operation always, ZigBee sleepy end devices can be configured to be in the sleep mode
most of the time and only wake up at pre-configured time interval for data transmission before it goes into
the sleep mode again. The ZE20S sleep interval can be configured by setting the S-registers using the AT
commands as below.
ATS51=n, where n is poll timeout in seconds and the default is 60.
This value is for a parent node. If an end device does not send a poll request to its parent coordinator or
router within the poll timeout, the end device is removed from the child table. Unlike the non-sleepy end
device, sleepy end device does not use S51 as the poll period. Instead, it uses S53 as the sleep duration
which works similar to the poll period, except it goes to sleep mode.
ATS53=n, where n is sleep duration in quarter seconds and the default is 8.
The ZE20S sleeps at sleep duration and turns off radio.
ATS52=n, where n is poll period in milliseconds and the default is 100.
Sleepy end device wakes up from the sleep mode if S53 timer expires or GPIO0 interrupt is generated or
serial data is received. Once the sleepy end device wakes up, it polls the parent node at poll period
defined by S52 until it goes to sleep mode again. Since the sleepy end device exchanges data with the
parent node only by polling, S52 poll period is usually configured as around 100 ms.
ATS54=n, where n is standby timeout in seconds and the default is 5.
If there is no RF data or serial data for S54 seconds, the sleepy end device goes to sleep mode again. If
any serial or RF data is sent or received, the timer will reset and the sleepy end device waits for another
S54 seconds before it goes to sleep mode again.
ATS55=n, where n is rejoin timeout and the default is 10.
When the connection to the parent node is broken for S55 in seconds, the child node tries to rejoin the
current network.
24
ProBee-ZE20S Series User Guide Rev.0.1
Parent Node
S52
S53
Sleep
S54
Wake-Up
Sleep
Sleepy End Device
Poll Request
Data Exchange
Figure 3-1 Sleep Interval and Wake-up Timing
The sleepy end device can also wake up from the sleep mode by GPIO0 interrupt or incoming serial data.
Once it wakes up, it also polls with the parent node at S52 interval and goes into sleep mode after S54
time elapses after the last data exchange.
Note: If the sleepy end device wakes up by incoming serial data, the integrity of the first incoming byte is
not guaranteed. It is strongly recommended to wake up the sleepy end device by using GPIO0 first before
sending the serial data or use higher level serial data protocol to check the data integrity.
3.5
ZigBee Security
Security is a major concern in the ZigBee architecture. Although ZigBee uses the basic security elements
in IEEE 802.15.4 (e.g., AES encryption & CCM security modes), the ZE20S increase the security level
with:
•
128 bit AES encryption algorithms
•
Strong, NIST-approved security
•
Defined Key Types (Link, Network)
•
Defined Key setup and maintenance
•
CCM (Unified/Simpler mode of operation)
•
Trust Centers
25
ProBee-ZE20S Series User Guide Rev.0.1
3.5.1
Security Level
In order to use security in the application, a user should set security level using the AT command below.
Set 1 defines both Authentication and Encryption at the network layer. Set 0 defines no security. Disabling
security in the application is not ZigBee compliant. All nodes in the network should have the same
security level setup. The security level is configured using the AT command below.
AT+SECURITY=n, where n is encryption level. (0=disable, 1=enable)
3.5.2
Link Key
The trust center (normally coordinator in network) requests link key before a device is trying to join
network. If link key the device has is wrong, joining process will be denied. Hence, all nodes in the
network should have the same link key setup before joining the network.
AT+LINKKEY=xxx…xxx, where xxx…xxx is 128-bit hexadecimal trust center link key. Default is FFF…FF.
3.5.3
Network Key
It is the network-wide key used to secure transmissions at the Network Layer. The network key encrypts
all transmissions at the Network Layer. The network key only needs to be set up for the coordinator.
AT+NWKKEY=xxx…xxx, where xxx…xxx is 128-bit hexadecimal network key. Default is FFF…FF.
3.5.4
Update Key
A trust center can update the Network Key to help minimize the risk associated with a particular instance
of the network key being compromised. Key updates are broadcast by the trust center throughout the
network, encrypted using the current network key. Devices that hear the broadcast will not immediately
use the key, but simply store it. Later, a key switch is broadcast by the trust center to tell all nodes to start
using the new key. At a minimum, the trust center should allow adequate time for the broadcast of the
new key to propagate throughout the network before switching.
AT+UPDATEKEY
26
ProBee-ZE20S Series User Guide Rev.0.1
Data Transmission
The ZE20S supports three different types of data transmissions: unicast, multicast and broadcast. Unicast
is to transmit data to a specific ZigBee device. Multicast is to transmit data to a group of ZigBee devices
that are assigned a specific group ID. Broadcast is to transmit data to all ZigBee devices (or specific type
of ZigBee nodes if specified) in the network.
There are also two different methods to transmit data to other device as below:
•
Command mode: It sends only one packet up to allowed payload length by a form of command.
•
Data mode: It is possible to send data consecutively until leave the data mode using “+++”.
4.1
Command Mode
4.1.1
Unicast
Unicast transmissions are sent from a source device to a destination device. The destination device can
be any ZigBee device in the ZigBee network. To specify the destination device, the ZigBee address of the
destination device should be known.
There are two different ZigBee addresses assigned to each ZigBee device. The 64-bit address is a
unique device address assigned during manufacturing. The 64-bit address is also called IEEE address or
extended address. The 16-bit address is assigned to the device when it joins a ZigBee network. The
ZE20S can send unicast messages based on either 16-bit address or 64-bit address. The AT command
for the unicast transmissions is as below:
AT+UNICAST=,
Where = 16-bit or 64-bit address, = data to transmit
The maximum payload of the message is 90 bytes (or 72 bytes under security enabled). If the message
length exceeds the maximum payload, the message cannot transmit and the error message will be
presented.
4.1.2
Multicast
Multicast transmissions are sent from a source device to destination devices with the specific group ID.
The group ID is assigned to the devices using the AT+GROUPID command. The AT command for the
multicast transmissions is as below.
AT+MULTICAST=,
Where = group ID, = data to transmit
The data transmission range can be set using the AT commands below. Please refer to the 9 S-Registers
for more details.
27
ProBee-ZE20S Series User Guide Rev.0.1
ATS36=n, where n is the radius.
ATS37=n, where n is the number of hops through nonmembers.
4.1.3
Broadcast
Broadcast transmissions are sent from a source device to all devices in the ZigBee network. The AT
command for the broadcast transmissions is as below.
AT+BROADCAST=
Where = data to transmit
The user can also specify the transmit range by changing the S35 register value as below. Please refer to
the 9 S-Registers for more details.
ATS35=n, where n is the broadcast range.
ATS36=n, where n is the radius.
4.1.4
Sending Binary Data
There are some characters, e.g. carriage return, line feed and back space, that are not allowed or have
special meanings in command mode. In order to transmit these characters in command mode, these
characters must be encoded in a command line. The special characters encoding table is shown in Table
4-1.
Table 4-1 Special Characters Encoding Table
HEX
Abbreviation Glyph
Encoded
Description
00
NULL
\00
Null character
0D
CR
\0D
Carriage return
0A
LF
\0A
Line feed
08
BS
\08
Backspace
09
HT
\09
Horizontal Tab
7F
DEL
\7F
Delete
5C
\5C
Control character for binary encoding
For example, when sending abc with AT+BROADCAST command, the command should be as
follows:
AT+BROADCAST=abc\0D
4.1.5
Display Incoming Message
S11 register determines whether incoming message will be presented or not in the command mode. In
28
ProBee-ZE20S Series User Guide Rev.0.1
the data mode, on the other hand, incoming data is always displayed. To change the S11 register, please
use the AT command as below:
ATS11=,
where = 0 to hide incoming message, 1 to show incoming message.
If user wants to display incoming message in command mode, S11 should be enabled. It is presented by
a form of +|.
When displaying incoming messages in command mode, some characters are encoded in the same way
with sending binary data as in Table 4-1. For example, when receiving abc from
0001950000000001, the displaying message is as follows:
+0001950000000001| abc\0D
4.2
Data Mode
If the data is too long to send using the command mode, Data Mode can be used instead. Once the
ZE20S enters a Data Mode session, the ZE20S can send data continuously to a specific node or current
network until the data mode is escaped. The data is packetized and transmitted at every inter-character
timeout. This data link to the designated device is maintained until the escape command “+++” is entered.
To return to the last data mode after the ZE20S is escaped by “+++”, use the AT command as below.
ATO
4.2.1
Unicast Data Mode
Unicast data mode can be used for continuous data transmission to a particular node. Unicast data mode
can be entered using either ATD or AT+TRANSMITMODE=1 (or 4). If ATD command is used, the device
will enter the unicast data mode immediately until escaped using “+++” or reset by ATZ. If the device is
reset, it will not enter the unicast data mode in this case.
On the other hand, if AT+TRANSMITMODE=1 (or 4) is used to enter the unicast data mode, the device
enters the unicast data mode again whenever the device is reset. To disable the unicast data mode,
escape the data mode first by using “+++” string and use AT+TRANSMITMODE=0 and reset the device to
apply the setting permanently.
AT commands used for the unicast data mode are as below.
AT+DESTLA=
Set the destination address, where is 64-bit IEEE address of destination node for unicast data
mode.
29
ProBee-ZE20S Series User Guide Rev.0.1
ATD
Set unicast data mode to the preconfigured destination IEEE address without reset.
ATD
Set unicast data mode and can be either 16-bit node ID or 64-bit IEEE address of remote node.
AT+TRANSMITMODE=1
Set the transmit mode to unicast to a destination IEEE address. The device should be reset to apply the
mode.
AT+TRANSMITMODE=4
Set the transmit mode to unicast to a sink node. A sink node is determined if s-register 61 is set. The
device should be reset to apply the mode.
Example)
AT+DESTLA=00019500002FDC40
# Set the destination IEEE address
OK
# Response
ATD
# Enter the unicast mode using destination IEEE address
OK
# Response
Send unicast msg
# Put the unicast message
+++
# Leave data mode
OK
# Response
ATD0000
# Enter the unicast mode using 16-bit node ID
OK
# Response
Send unicast msg
# Put the unicast message
+++
# Leave data mode
OK
# Response
ATD00019500002FDC40
# Enter the unicast mode using 64-bit IEEE address
OK
# Response
Send unicast msg
# Put the unicast message
+++
# Leave data mode
OK
# Response
AT+DESTLA=00019500002FDC40
OK
# Set the destination IEEE address
# Response
30
ProBee-ZE20S Series User Guide Rev.0.1
AT+TRANSMITMODE=1
# Set transmit mode to destination IEEE address
OK
# Response
ATZ
# Apply to change
OK
# Response
Send unicast msg
# Put the unicast message
+++
# Leave data mode
OK
# Response
AT+TRANSMITMODE=4
# Set transmit mode to sink node in the network
OK
# Response
ATZ
# Apply to change
OK
# Response
Send unicast msg
# Put the unicast message
+++
# Leave data mode
OK
# Response
4.2.2
Multicast Data Mode
Multicast data mode can be used for continuous data transmission to a particular group of multiple
devices. Every ZE20S belongs to a certain group by predetermined group ID when form or join the
network.
Multicast data mode can be entered using either ATM or AT+TRANSMITMODE=2. If ATD command is
used, the device will enter the multicast data mode immediately until escaped using “+++” or reset by ATZ.
If the device is reset, it will not enter the multicast data mode in this case.
On the other hand, if AT+TRANSMITMODE=2 is used to enter the multicast data mode, the device enters
the multicast data mode again whenever the device is reset. To disable the multicast data mode, escape
the data mode first by using “+++” string and use AT+TRANSMITMODE=0 and reset the device to apply
the setting permanently.
AT commands used for the multicast data mode are as below.
AT+GROUPID=, where is 16-bit group ID for multicast data mode.
Set Group ID of the device. The device will receive the multicast data sent to this Group ID.
AT+DESTGROUPID=, where is 16-bit destination group ID for multicast data mode.
Set destination Group ID of the device.
31
ProBee-ZE20S Series User Guide Rev.0.1
ATM
Set multicast data mode to preconfigured destination group ID without reset.
ATM
Set multicast data mode and can be 16-bit group ID.
AT+TRANSMITMODE=2
Set the transmit mode to multicast mode. The device should be reset to apply the mode.
ATS36=n, where n is the radius.
ATS37=n, where n is the number of hops through nonmembers.
Set data relay and forwarding options. Please refer to the 9 S-Registers for more details.
Example)
AT+DESTGROUPID=0001
# Set the destination group ID
OK
# Response
ATM
# Enter the multicast mode using destination group ID
OK
# Response
Send multicast msg
# Put the multicast message
+++
# Leave data mode
OK
# Response
ATM0001
# Enter the multicast mode using 16-bit group ID
OK
# Response
OK
# Response
Send multicast msg
# Put the multicast message
+++
# Leave data mode
OK
# Response
AT+DESTGROUPID=0001
# Set the destination group ID
OK
# Response
AT+TRANSMITMODE=2
# Set transmit mode to destination group ID
OK
# Response
ATZ
# Apply to change
OK
# Response
Send multicast msg
# Put the multicast message
+++
# Leave data mode
32
ProBee-ZE20S Series User Guide Rev.0.1
OK
4.2.3
# Response
Broadcast Data Mode
Broadcast data mode can be used for continuous data transmission to all devices in the current network.
The destination address or group ID of the remote nodes is not necessary for broadcast data mode. The
transmit range is determined by the S-register 35.
Broadcast data mode can be entered using either ATB or AT+TRANSMITMODE=3. If ATB command is
used, the device will enter the broadcast data mode immediately until escaped using “+++” or reset by
ATZ. If the device is reset, it will not enter the broadcast data mode in this case.
On the other hand, if AT+TRANSMITMODE=3 is used to enter the broadcast data mode, the device
enters the broadcast data mode again whenever the device is reset. To disable the broadcast data mode,
escape the data mode first by using “+++” string and use AT+TRANSMITMODE=0 and reset the device to
apply the setting permanently.
AT commands used for the broadcast data mode are as below.
ATB
Set broadcast data mode.
AT+TRANSMITMODE=3
Set the transmit mode to broadcast. It should be reset to apply the mode.
ATS35=n, where n is the broadcast range.
ATS36=n, where n is the radius.
Set data transmission range. Please refer to the chapter 9 S-Registers for more details.
Example)
ATS35=2
# Set broadcast range to all nodes in the network
OK
# Response
ATB
# Enter the broadcast mode
OK
# Response
Send broadcast msg
# Put the broadcast message
+++
# Leave data mode
OK
# Response
AT+TRANSMITMODE=3
# Set transmit mode to current network
33
ProBee-ZE20S Series User Guide Rev.0.1
OK
# Response
ATZ
# Apply to change
OK
# Response
Send broadcast msg
# Put the broadcast message
+++
# Leave data mode
OK
# Response
34
ProBee-ZE20S Series User Guide Rev.0.1
Digital and Analog I/O
5.1
GPIO Configuration
The ZE20S module has total 14 I/O pins. Among these pins, I/O pin 6 is assigned to factory reset only
and the user can use the rest 13 pins for general purpose inputs and outputs. The I/O pin assignments
are shown in Table 5-1. As shown in Table 5-1, some pins provide special functions built into the firmware.
Table 5-2 describes the special functions tied to the specific pins.
Table 5-1 Default I/O Pin Assignments (ZE20S)
Pin Number
GPIO Number
Special Functions
The AT command below can be used to change the GPIO settings.
AT+GPIO= or AT+GPIO=
Where, is a number between 0~5 as explained below:
Disabled (unmonitored digital input)
Digital input, monitored
Digital output, default low
Digital output, default high
Analog input, single ended (only valid for GPIO3~6)
Reserved for pin-specific alternate functionalities (See Table 5-2)
AI Enable
35
ProBee-ZE20S Series User Guide Rev.0.1
Table 5-2 Special GPIO Pins
Function
GPIO#
Type
Description
This input is dedicated for the factory reset button. If user wants to
restore the ZE20S device settings to factory default, this input needs
Factory_reset
/ Bootloader
DI
to be pressed for more than two seconds. It will be applied after the
input released again. If this input is pressed while the ZE20S starts,
the local node enters bootloader menu and it is possible to upload the
firmware.
This input (falling edge, i.e. High to Low change) is used to permit
joining or interrupt sleeping. This function is activated when GPIO0 is
Permit_joining
/ Wake-up
DI
set to 5. The functions depend on the node type of the ZE20S. If the
node is set to coordinator or router, this input works to permit other
nodes joining for S-register 22 value. If the node is set to sleepy enddevice, it is used for wake-up signal when the node is sleeping.
If GPIO1 is set to 5, this output turns ON (High) when power is
Power LED
DO
supplied. If the node is set to an end-device, it will blink periodically.
Please refer to 9 S-Registers for S14 regarding the management of
the LED status.
If GPIO2 is set to 5, this output turns ON (High) when the device joins
Status LED
DO
a network, blinks when joining is permitted, and turns OFF (Low)
when leaves the network. Please refer to 9 S-Registers for S14
regarding the management of the LED status.
This input is used for UART CTS if GPIO8 is set to 5. It should be
UART_CTS
DI
UART_RTS
DO
UART_DTR
DO
This output is used for UART DTR if GPIO10 is set to 5.
UATR_DSR
DI
This input is used for UART DSR if GPIO11 is set to 5.
5.2
enabled when CTS flow control is used.
This output is used for UART RTS if GPIO9 is set to 5. It should be
enabled when RTS flow control is used.
I/O Sampling
The I/O status can be monitored and controlled using the local or remote AT commands. Also the ZE20S
can be configured to sample the I/O status and send to a remote device periodically or at specific events.
5.2.1
Queried Sampling
The I/O status can be monitored and controlled using the AT commands either locally or remotely. To read
the digital I/O line values, the AT+DIO command can be used as below. Return value is a combination of
0 (Low) and 1 (High) if the pins are configured as digital I/O lines. If the pins are configured as analog
inputs, the corresponding return values are shown as *.
36
ProBee-ZE20S Series User Guide Rev.0.1
AT+DIO? or AT+DIO?
Where is the specific IO number to read ranges 0~12
AT+DIO command can also be used to set the digital output lines.
AT+DIO= or AT+DIO=
Where is the specific IO number to read ranges 0~12, and the is a combination of 0
or 1, 0 = Low, 1 = High
The analog input values can be read using the AT+AI command. Return value is a combination of 16-bit
hexadecimal integer between 0~2EE0(0~1200mV) or D120-FFFF(-1200~-1mV) which unit value
corresponds to 0.1 mv. To convert the hexadecimal value to the actual voltage, please use the formula
below. If the pins are configured as digital I/Os, the corresponding return values are shown as *.
AT+AI? or AT+AI?
Where is the specific IO number to read ranges 0~2
If the Value is between 0 ~ 2EE0, Voltage (mV) = Value * 0.1
If the Value is between D120 ~ FFFF, Voltage (mV) = (Value – 65536) * 0.1
Example)
AT+DIO?
10001**011100
analog inputs
Å DIO 0, 4, 8, 9, 10 are ON. Pins 5, 6 are configured as
OK
AT+DIO0=0
OK
AT+DIO?
00001**011100
analog inputs
Å DIO 0, 4, 8, 9, 10 are ON. Pins 5, 6 are configured as
OK
AT+AIO?
****,****,192A,13E8
configured as DIO.
Å AI 2, 3 are used. (GPIO5, 6) The others are
OK
To get/set the I/O values of the remote devices, remote AT commands can be used as below.
AT+REMOTE=,
37
ProBee-ZE20S Series User Guide Rev.0.1
Example)
AT+REMOTE=00019500000F3BA1,AT+DIO?
10001**011100
OK
5.2.2
Periodic Sampling
The ZE20S can be configured to send its I/O status to a remote device at a periodic rate. To configure this
way, please use the AT commands below:
AT+DESTLA=
Where is the long address of a remote node to send sampled GPIO values of local node.
ATS42=
Where is the GPIO sampling period in seconds. If set to 0, GPIO monitoring is disabled.
ATS43=
Where is the GPIO monitoring node. If set to 0, the monitoring node is selected by AT+DESTLA.
If set to is 1, the sink node is set as the monitoring node.
ATZ
Reset the device to apply the changes
Also the ZE20S can be configured to display periodic sampling data coming from the other nodes. To
enable this feature, please use the AT command below:
ATS11=, where determines whether incoming message will be presented or not. If
a user wants to display incoming message in command mode, S11 should be enabled.
If this feature is enabled, incoming message will display in the form of:
++|.
5.2.3
Change Detection Sampling
The ZE20S module can take an I/O sample and transmit it to a remote device immediately whenever a
monitored digital I/O pin changes state. It is possible to configure it with periodic sampling simultaneously.
To configure this way, please use the AT commands below:
AT+DESTLA=
Where is the long address of a remote node to send sampled GPIO values of local node.
38
ProBee-ZE20S Series User Guide Rev.0.1
ATS44=
Set GPIO change detection sampling mode. If is set to 0, GPIO sampling is disabled.
ATZ
Reset the device to apply the changes
5.2.4
GPIO Remote Control
The ZE20S module supports that a node can change the digital output status of a remote node by
switching local digital input pin and the local node should be possible to monitor the GPIO status. To
configure this way, please use the AT commands below:
AT+SOURCELA=
Where is the long address of a specific source node for changing the status of digital
output pin. If this address is set to “FFFFFFFFFFFFFFFF”, a local node allows that any node can control
the GPIO status.
ATS45=
Set GPIO remote control mode. If is set to 0, GPIO control is disabled.
39
ProBee-ZE20S Series User Guide Rev.0.1
Working with Development Kit
The ZE20S development kit provides a quick and easy way to be familiar with the ZE20S and test its
functionalities before you build your own PCB board to carry the ZE20S. It is always recommended to
start with the ZE20S development kit before your own design.
6.1
Development Kit Contents
The development kit consists of ZE20S modules and development boards to carry them. The
development board provides RS232 and USB interface to interface with computers and/or your target
devices. It also provides terminals for digital inputs/outputs and analog inputs. It also provides on/off
switches and LEDs to simulate and verify digital inputs/outputs. It also has temperature and light sensor
so you can test more practical applications. Below is the list of the items included in the package.
•
ProBee ZE20S ZigBee OEM Module w/ Chip Antenna (1)
•
ProBee ZE20S ZigBee OEM Module w/ U.FL Connector (1)
•
ProBee ZE20S ZigBee OEM Module w/ RPSMA Connector (1)
•
3 dBi Dipole Antenna, RP-SMA Plug, Right-hand Thread (2)
•
12cm U.FL to RPSMA Cable, Right-Hand Thread (1)
•
Development Boards (3)
•
DC Power Adapters (3)
•
RS232 Serial Cable (3)
•
USB Cable (3)
6.2
Development Board Features
The development board is designed to provide convenient access to the ZE20S interface pins. The
development board provides external interfaces as below. Also Figure 6-1 shows the layout of those
interfaces of the development board.
•
RS232 Interface
•
USB Interface
•
3 Pre-defined Digital Inputs: Permit Joining, Factory Default Reset, Hardware Reset
•
8 User Configurable Digital Inputs
•
8 Digital Outputs with LEDs (Active High)
•
4 Analog Inputs
•
Temperature Sensor
•
Light Sensor
40
ProBee-ZE20S Series User Guide Rev.0.1
TBD
Figure 6-1 Development Board Layout
6.3
Development Board Hardware Descriptions
6.3.1
Power
There are four ways to supply power to the development board:
•
5V Power Port
•
USB Port
•
AA Batteries
•
RS232 Port, 5V through 9th Pin
The RS_PWR, USB_PWR and BATT_EN jumpers MUST be configured properly according to the way.
Table 6-1 shows jumpers configuration
Table 6-1 Jumpers Configuration
RS_PWR
USB_PWR
BATT_EN
5V Power Port
Open
Open
Open
USB Port
Open
Close
Open
AA Batteries
Open
Open
Close
RS232 Port
Close
Open
Open
41
ProBee-ZE20S Series User Guide Rev.0.1
6.3.2
RS232 Port
The development board has an RS232 interface for UART communication. The UART_TXD, UART_RXD,
UART_DSR (GPIO_11), UART_DTR (GPIO_10), UART_CTS (GPIO_8) and UART_RTS (GPIO_9) pins
of the ZE20S are connected with the RS232 port. To enable the RS232 port, the HOST (SW2) switch
should be set to UART.
In addition to the data communication via RS232 port, the RS232 port is capable of supplying power to
the development board. In order to use this feature, supply 5V power via the 9th pin of the DB9 socket.
6.3.3
USB Port
The development board also has a USB interface for UART communication. To use the USB port, the
HOST (SW2) switch should be set to USB and the software driver should be installed on the host
computer. The installation CD contains the software.
6.3.4
ZE20S GPIO Interface
The development board’s external GPIO interfaces as well as functional buttons such as factory default
reset switches are internally routed to the ZE20S GPIO pins. Table 6-2 summarizes the development
board’s interfaces and their corresponding GPIO pin numbers of the ZE20S.
Table 6-2 Development Board GPIO Interface Allocation
ZE20S
Name
Description
Pin Number
Digital Output with LED(CR12) Display (Active High)
Digital Input with Button Switch (SW10, Active Low or Active High)
Digital Output with LED(CR13) Display (Active High)
Digital Input with Switch (SW11, Active Low or Active High)
Permit Joining Switch (SW9)
Factory Default Reset Switch (SW8)
Digital Output with LED(CR14) Display (Active High)
Digital Input with Button Switch (SW12, Active Low or Active High)
Analog Input with Variable Register (VR1)
Digital Output with LED(CR15) Display (Active High)
Digital Input with Button Switch (SW13, Active Low or Active High)
Analog Input with Variable Register (VR2)
Hardware Reset Switch
Digital Output with LED(CR16) Display (Active High)
Digital Input with Button Switch (SW14, Active Low or Active High)
Analog Input with Temperature Sensor (U6)
Digital Output with LED(CR17) Display (Active High)
42
ProBee-ZE20S Series User Guide Rev.0.1
Digital Input with Button Switch (SW15, Active Low or Active High)
Analog Input with Light Sensor (U7)
Digital Output with LED(CR19) Display (Active High)
Digital Input with Button Switch (SW17, Active Low or Active High)
UART DSR Input
UART DTR Output
UART Data Input
UART Data Output
UART CTS Input
UART RTS Output
Digital Output with LED(CR18) Display (Active High)
Digital Input with Button Switch (SW16, Active Low or Active High)
6.3.5
LEDs (CR)
The development board has 8 LEDs for digital output. To enable the LEDs, the GPIO_OUT (SW?) switch
should be set to LED_ON. The LEDs are turned on when the related GPIO pins of the ZE20S are high.
6.3.6
Button Switches (SW)
The development board has 8 button switches for digital input. The switches can be configured as active
high or active low with the GPIO_IN (SW?) switch.
6.3.7
Variable Resistors (VR)
There are two variable resistors for analog inputs on the development board. The analog inputs can be
read with the GPIO_? and GPIO_?. To enable the variable resistors, the ADC_0 and ADC_1 switches
should be placed to VR_? and VR_?.
6.3.8
Temperature Sensor
The GPIO_? of the ZE20S is routed to the temperature sensor. The relationship between temperature
and analog input is as follows:
Temperature(°C) ={ Volt(mV) -600(mV)} * 0.1(℃/mV)
6.3.9
Light Sensor
The GPIO_? of the ZE20S is routed to the light sensor. Approximately, the relationship between
illumination and analog input is as follows:
Illumination(Lux) = Volt(mV) * 0.25(Lux/mV)
43
ProBee-ZE20S Series User Guide Rev.0.1
6.3.10 Terminal Block
The development board has a terminal block for external analog inputs. Figure 6-2 shows the layout of
the terminal block. To use external analog inputs instead of the variable resistors, temperature sensor or
light sensor, the ADC_0 (SW?), ADC_1 (SW?), ADC_2 (SW?) or ADC_3 (SW?) should be placed on
EXT_?, EXT_?, EXT_?, or EXT_?.
Figure 6-2 Terminal Block for External Anlalog Inputs
6.4
Configuration Example #1: 1 Coordinator, 1 Router and 1 End-Device
Here is the example configuration to help to start with the ZE20S and the development kit. The goal of
this example is to provide hardware configuration and AT commands for the scenario as below:
•
One ZE20S module acts as a coordinator and it is connected to a host computer via USB cable.
•
One ZE20S module acts as a router and it sends temperature sensor, light sensor and digital
inputs to the coordinator every second.
•
One ZE20S module acts as a sleepy end device and it sends temperature sensor, light sensor
and digital inputs to the coordinator every second.
TBD
Figure 6-3 Example #1: 1 Coordinator, 1 Router and 1 End Device
44
ProBee-ZE20S Series User Guide Rev.0.1
6.4.1
Coordinator Configuration
Hardware configuration for the coordinator is as follows:
•
Set the HOST switch to USB
•
Close the USB_PWR jumper and open the RS_PWR and BATT_PWR jumpers.
•
Connect a USB cable between a host computer and the coordinator
The AT commands for the coordinator are as follows:
AT+NODETYPE=1
OK
AT+PANID=7772
OK
ATS11=1
OK
AT+LONGADDR
0001950000000001
OK
ATZ
OK
6.4.2
Router Configuration
Hardware configuration for the coordinator is as follows:
•
Set the ADC_2 and ADC_3 switch to TEMP_SENS and LIGHT_SENS
The AT commands for the router are as follows:
AT+NODETYPE=2
OK
AT+PANID=7772
OK
ATS42=1
OK
AT+DESTLA=0001950000000001
OK
AT+GPIO=1111144111111
OK
ATZ
OK
45
ProBee-ZE20S Series User Guide Rev.0.1
6.4.3
End-device Configuration
Hardware configuration for the end device is as follows:
•
Set the ADC_2 and ADC_3 switch to TEMP_SENS and LIGHT_SENS
The AT commands for coordinator configuration is as follows:
AT+NODETYPE=4
OK
AT+PANID=7772
OK
ATS42=1
OK
AT+DESTLA=0001950000000001
OK
AT+GPIO=1111144111111
OK
ATZ
OK
6.4.4
Monitoring the Sensors
Once the configurations are done and the system is running, the terminal (computer) connected to the
coordinator will print out the incoming data as follows:
++0001950000000002|10000**000000|****,****,233E,006A
++0001950000000003|10000**000000|****,****,2254,0B23
++0001950000000002|10000**000000|****,****,2235,004E
++0001950000000003|10000**000000|****,****,226C,0B8B
6.5
Configuration Example #2: 1 Coordinator and 2 End-Devices
Here is another example assuming different system configurations. This example can be described as
follows:
•
One ZE20S module acts as a coordinator and it is connected to a host computer via serial cable.
•
Two ZE20S modules act as end devices.
•
Turn on/off the LEDs of the end devices remotely through the coordinator
46
ProBee-ZE20S Series User Guide Rev.0.1
TBD
Figure 6-4 Example #2: 1 Coordinator and 2 End Devices
6.5.1
Coordinator Configuration
Hardware configuration for the coordinator is as follows:
•
Set the HOST switch to UART
•
Connect a serial cable between a host computer and the coordinator
The AT commands for coordinator configuration is as follows:
AT+NODETYPE=1
OK
AT+PANID=7772
OK
ATZ
OK
6.5.2
End-devices Configuration
Hardware configuration for the coordinator is as follows:
•
Set the GPIO_OUT switch to LED_ON
The AT commands for the end devices are as follows:
AT+NODETYPE=4
OK
AT+PANID=7772
OK
AT+GPIO=3333333333333
OK
47
ProBee-ZE20S Series User Guide Rev.0.1
AT+LONGADDR
0001950000000003
OK
ATZ
OK
6.5.3
Turning on/off the LEDs
The AT commands to control the LEDs are as follows:
AT+REMOTE=0001950000000003,AT+DIO=0000000000000
OK
AT+REMOTE=0001950000000003,AT+DIO=1111111111111
OK
48
ProBee-ZE20S Series User Guide Rev.0.1
AT Command Reference
7.1
Command Line Format
Each command line is composed of a prefix, body and terminator. Only “AT” can be used for the prefix.
The body is a string of characters. The terminator is or . A command can be one of the
followings:
•
Read a configuration parameter:
AT?
•
Do something:
AT
•
Write a configuration parameter:
AT=,,,…
Commands denoted with a “+” character are extended AT commands.
S-registers are supported. Multiple commands in the same command line are not supported.
7.2
Standard AT Commands
7.2.1
AT
Description
Check the state of the connection between host and ProBee device.
Execute
AT
Response
OK
7.2.2
ATB
Description
Enter the broadcast data mode. Every data is packetized at intervals of inter character
timeout (S12) and transmit range is determined by broadcast range(S35).
Execute
ATB
Response
OK
7.2.3
ATD
Enter the unicast data mode to specific node. If there’s no argument after the
Description
command, it will connect to the preconfigured destination IEEE address. Successful
transmission guarantees successful reception and every data is packetized at intervals
of inter character timeout(S12).
Execute
ATD
Response
OK or ERROR
ATD
ATD
49
ProBee-ZE20S Series User Guide Rev.0.1
7.2.4
ATE
Description
Echo(1) or No Echo(0).
Execute
ATE
Response
OK
7.2.5
ATM
Enter the multicast mode. If there’s no argument after the command, it will connect to
Description
the preconfigured destination group ID. Every data is packetized at intervals of inter
character timeout(S12).
Execute
ATM
Response
OK
7.2.6
ATM
ATO
Description
Return to data mode.
Execute
ATO
Response
7.2.7
ATR
Description
Response(1) or No Response(0).
Execute
ATR
Response
OK
7.2.8
ATS
Description
Get/Set the S-registers.
Execute
ATS
ATS?
List of the S-register and
description
OK
Response
7.2.9
ATZ
Description
Reset the node.
Execute
ATZ
Response
OK
7.2.10 AT&F
Description
Factory reset.
Execute
AT&F
Response
OK
ATS=
OK or ERROR
50
ProBee-ZE20S Series User Guide Rev.0.1
7.2.11 +++
Description
Interrupt data mode. “+++” must be entered within 500ms.
Execute
+++
Response
OK
7.3
Node Specific Information
7.3.1
AT+LONGADDR or AT+LA
Get the 64-bit IEEE address. (EUI address, long address) The IEEE address is a
Description
unique device address assigned during manufacturing. This address is unique to each
physical device.
Execute
Response
7.3.2
AT+LONGADDR?
OK
AT+SHORTADDR or AT+SA
Get the 16-bit Node ID. (network address, short address) The node ID of “0000” is
reserved for the coordinator. All other devices receive a randomly generated address
Description
from the router or coordinator device that allows the join. This value can change if an
address conflict is detected where two devices are found to have the same address or
a device leaves the network and later joins.
Execute
Response
7.3.3
AT+SHORTADDR?
OK
AT+ADDRDISCOVERY or AT+AD
Description
Get the corresponding address of a node whose long or short address is known.
Execute
AT+ADDRDISCOVERY=
AT+ADDRDISCOVERY=
OK
OK
Response
7.3.4
AT+OPCH or AT+OC
Get the operating channel number used for transmitting and receiving between RF
Description
modules. Uses 802.15.4 channel numbers. A value of “0” means the device has not
joined a PAN and is not operating on any channel.
Execute
Response
AT+OPCH?
OK
51
ProBee-ZE20S Series User Guide Rev.0.1
7.3.5
AT+OPPANID or AT+OI
Get the operating 16-bit PAN ID. If PAN ID is set specific value not 0s, operating PAN
Description
ID will equal designated PAN ID. A value of “FFFF” means the device is not joined a
network.
Execute
Response
7.3.6
OK
AT+OPEPID or AT+OE
Description
Execute
Response
7.3.7
AT+OPPANID?
Get the operating 64-bit extended PAN ID. A value of “FFFFFFFFFFFFFFFF” means
the device is not joined a network.
AT+OPEPID?
OK
AT+VERSION or AT+VR
Description
Get firmware version of the module. The firmware version returns a form of “PTvx.x”.
Execute
AT+VERSION?
Response
7.3.8
OK
AT+PRODUCTNAME or AT+PN
Description
Execute
Response
Get the product name. It can be used to distinguish among different hardware
platforms.
AT+PRODUCTNAME?
OK
7.4
Network Specific Parameters
7.4.1
AT+CHMASK or AT+CM
Get/Set the channel mask to use. Bits set as 1 indicate that this particular channel can
be used. Bits set as 0 indicate that this particular channel should not be used. For
Description
example, a channel mask value of 0x00000001 indicates that only channel 0 should be
used. Valid channels range from 12 to 25 inclusive. (14 channels are available.) This
translates to a channel mask value of “0x03FFF000”.
Execute
Response
Default
AT+CHMASK?
OK
03FFF000
AT+CHMASK=