User guide

ManualsBrandsSENA ManualsComputer AccessoriesProBee-ZE20S-SEME

ProBee-ZE20S-SExx User Guide Rev 1.8

ZigBee OEM Module

ProBee-ZE20S-SESI

ProBee-ZE20S-SEID

ProBee-ZE20S-SEME

User Guide

Sena Technologies, Inc.

Rev 1.8

Summary of content (118 pages)

PAGE 1
ProBee-ZE20S-SExx User Guide Rev 1.8 ZigBee OEM Module ProBee-ZE20S-SESI ProBee-ZE20S-SEID ProBee-ZE20S-SEME User Guide Sena Technologies, Inc. Rev 1.
PAGE 2
ProBee-ZE20S-SExx User Guide Rev 1.8 ProBee-ZE20S-SESI, ProBee-ZE20S-SEID, ProBee-ZE20S-SEME User Guide Firmware version SESIv1.X Firmware version SEIDv1.X Firmware version SEMEv1.X Copyright Copyright 2011 ~ 2013, 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.
PAGE 3
ProBee-ZE20S-SExx User Guide Rev 1.8 Revision Date Name V1.
PAGE 4
ProBee-ZE20S-SExx User Guide Rev 1.8 Contents 1 2 INTRODUCTION ..................................................................................................... 11 1.1 About This Document......................................................................................................................... 11 1.2 ZE20S Overview ................................................................................................................................. 11 1.3 ZigBee Smart Energy Profile ....
PAGE 5
ProBee-ZE20S-SExx User Guide Rev 1.8 3.4.2 Node Type Selection for Coordinator ........................................................................................31 3.4.3 Channel Mask Configuration for Coordinator ...........................................................................31 3.4.4 PAN ID Configuration for Coordinator .......................................................................................32 3.4.5 Permit Joining......................................................
PAGE 6
ProBee-ZE20S-SExx User Guide Rev 1.8 6 7 5.4.6 Key Establishment Process........................................................................................................59 5.4.7 Cluster Command for Binding ....................................................................................................63 5.4.8 Showing Attribute Information ....................................................................................................64 5.4.9 Reading Attribute .......................
PAGE 7
ProBee-ZE20S-SExx User Guide Rev 1.8 7.4.3 AT+EPID or AT+EI ......................................................................................................................82 7.4.4 AT+GROUPID or AT+GI .............................................................................................................83 7.4.5 AT+POWER or AT+PW ..............................................................................................................83 7.4.6 AT+STACK or AT+ZS ........................
PAGE 8
ProBee-ZE20S-SExx User Guide Rev 1.8 7.12.1 AT+ATTR or AT+AR ....................................................................................................................90 7.12.2 AT+INFO or AT+IF ......................................................................................................................90 7.12.3 AT+DEST or AT+DE ...................................................................................................................91 7.12.4 AT+SREAD or AT+SR ............
PAGE 9
ProBee-ZE20S-SExx User Guide Rev 1.8 7.14.4 AT+SMENDTIME or AT+SET.....................................................................................................98 7.14.5 AT+PRGETCUR or AT+PGC .....................................................................................................98 7.14.6 AT+PRGETSCH or AT+PGS......................................................................................................98 7.14.7 AT+PRGETBLKPR or AT+PGB .....................................
PAGE 10
ProBee-ZE20S-SExx User Guide Rev 1.8 8.4.5 S55 .............................................................................................................................................106 8.4.6 S56 .............................................................................................................................................106 8.5 Frequency Agility ..............................................................................................................................107 8.5.
PAGE 11
ProBee-ZE20S-SExx User Guide Rev 1.8 1 Introduction 1.
PAGE 12
ProBee-ZE20S-SExx User Guide Rev 1.8  Working Distance: 300 m (0.19 miles) @ 3.3V, +5dBi Dipole Antenna  Various Antenna/Connector Options: Dipole 1/3/5dBi, U.
PAGE 13
ProBee-ZE20S-SExx User Guide Rev 1.8 1.4.4 Endpoint Endpoint is a particular component within a unit. Each ZigBee device may support up to 240 such components. ZE20S has just 1 endpoint. 1.4.5 Client Client is a cluster interface which is listed in the output cluster list of the simple descriptor on an endpoint. Typically this interface sends commands that manipulate the attributes on the corresponding server cluster. 1.4.
PAGE 14
ProBee-ZE20S-SExx User Guide Rev 1.8 2 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.
PAGE 15
ProBee-ZE20S-SExx User Guide Rev 1.8 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. Figure 2-2 RP-SMA Dipole Antenna Installation 2.1.
PAGE 16
ProBee-ZE20S-SExx User Guide Rev 1.8 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 female as a DTE terminal, and the serial cable included is a cross-over cable for DTE-DTE connection.
PAGE 17
ProBee-ZE20S-SExx User Guide Rev 1.8 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.
PAGE 18
ProBee-ZE20S-SExx User Guide Rev 1.8 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.
PAGE 19
ProBee-ZE20S-SExx User Guide Rev 1.8 Figure 2-9 Testing AT Command on HyperTerminal 2.3 Using ProBee Manager for Configuration 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 of local node and remote node easily without a terminal program. It is possible to export current configuration and import it to other nodes. It is also possible to restore to factory default configuration.
PAGE 20
ProBee-ZE20S-SExx User Guide Rev 1.8 Figure 2-11 ProBee Manager Main Window Clicking ‘Reboot’ button reboots the local node. Users can reload and refresh the recent configuration of the local node at ProBee manager by clicking ‘Reload’ button. ‘Configuration’ tab and ‘Firmware Update’ tab can help move to the ‘Configuration’ screen and the ‘Firmware Update’ screen. 2.3.2 Configuration The Configuration Pane appears when the ‘Configuration’ tab is selected.
PAGE 21
ProBee-ZE20S-SExx User Guide Rev 1.8 in order not lose it moving to other properties. To apply changes, please reboot the device by clicking ‘Reboot’ button. The ‘Save’ button is disabled for read-only property. Figure 2-12 ProBee Manager Configuration Pane In Figure 2-12, the ‘Node Information’ category is selected and the ‘IEEE Address’ property is selected, so Its description is displayed. The ‘Save’ button is disabled because the ‘IEEE Address’ property is readonly.
PAGE 22
ProBee-ZE20S-SExx User Guide Rev 1.8  Click the ‘Reboot’ button whose caption used to be ‘Restore to Factory Default’ to apply changes. To export the configuration, please follow the steps as below:  Click the ‘Export’ button at the ‘Configuration Management’ section and the ‘Save As’ dialog pops up.  Select the path and enter the file name to store the configuration at.  Click the ‘Save’ button’ and the configuration is exported to the designated file.
PAGE 23
ProBee-ZE20S-SExx User Guide Rev 1.8 To update firmware at local node, please follow the steps as below:  Select a firmware file to update at the ‘Firmware Update’ section. The ‘Choose file in local PC’ button pops up the dialog where users can select the firmware file at local PC and the ‘Download from web server’ button helps users download the firmware from web server.  Click the ‘Update’ button at the ‘Device Update’ section to update the local node.
PAGE 24
ProBee-ZE20S-SExx User Guide Rev 1.8 3 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.
PAGE 25
ProBee-ZE20S-SExx User Guide Rev 1.8 3.1 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 increases 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 3.1.
PAGE 26
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 27
ProBee-ZE20S-SExx User Guide Rev 1.8 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 or AT+UK 3.2 Configuring CBKE Data Token Generated link key is required to support Smart Energy security, which is based on CBKE using EllipticCurve Cryptography (ECC).
PAGE 28
ProBee-ZE20S-SExx User Guide Rev 1.8 6. Leave the Public Key field empty. 7. Click the Generate button. You can see resulting page as below. Device Public Key will not be used. Results! CA Pub Key: 0200fde8a7f3d1084224962a4e7c54e69ac3f04da6b8 03022cd8b45f0f21676e4184470d34c3626fc10485741 Device Implicit Cert: 1223344556677885445535453454341112233445566 77889900 Device Private Key: 03b546c41cad5b6c4407144149362c478f844b0d6d Device Public Key: 03075012564096b1b93d6fd5d450401410fa50d9994b 8.
PAGE 29
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 30
ProBee-ZE20S-SExx User Guide Rev 1.8 Example) Bad CBKE Data Token AT+INFO Security Level: 05, Security Profile: SE Full SE Security Info: RealEcc, RealCbke, BadCert # Bad CBKE Data Token End-point count: 1 … Note: Once the node is locked with BAD CBKE Data Token, it cannot work as Smart Energy node and its CBKE Data Token cannot be changed and erased. There is no way to change or erase CBKE Data Token. Even Factory Reset does not erase its CBKE Data Token.
PAGE 31
ProBee-ZE20S-SExx User Guide Rev 1.8  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.  Permit joining when other router or end-device tries to join the ZigBee network.  Add Pre-configured Link Key to Key Table for Smart Energy Security. 3.4.
PAGE 32
ProBee-ZE20S-SExx User Guide Rev 1.8 Table 3-2 Channel Bitmask Channel 11* 12 13 14* 15* 16 17 18 Bit mask 00000800 00001000 00002000 00004000 00008000 00010000 00020000 00040000 Channel 19* 20* 21 22 23 24* 25* 26 Bit mask 00080000 00100000 00200000 00400000 00800000 01000000 02000000 04000000 * Preferred Channel Usage in Smart Energy Network (Default channel) 3.4.
PAGE 33
ProBee-ZE20S-SExx User Guide Rev 1.8 AT+PERMIT=255 or AT+PJ=255 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.
PAGE 34
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 35
ProBee-ZE20S-SExx User Guide Rev 1.8 Token for using Smart Energy security. Please refer to the section 3.2 Configuring CBKE Data Token for getting certificate and setting CBKE Data Token. 3.5.2 Install Code Configuration Router and end-device can set Install Code optionally for enhanced Smart Energy security. Install Code is used to generate Pre-configured Link Key. Nodes other than Trust Center in a Smart Energy network must have same Install Code if they are able to communicate with each other.
PAGE 36
ProBee-ZE20S-SExx User Guide Rev 1.8 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 or AT+OE If the extended PAN ID of a ZigBee router or a ZigBee end-device is 0000000000000000, the extended PAN ID is ignored 3.5.
PAGE 37
ProBee-ZE20S-SExx User Guide Rev 1.8 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. 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. ATS56=n, where n is poll period in seconds and the default is 5.
PAGE 38
ProBee-ZE20S-SExx User Guide Rev 1.8 ATS51=n, where n is poll timeout in seconds and the default is 60. This value is for a parent node. If a sleepy end-device does not send a poll request to its parent coordinator or router within the poll timeout, the sleepy end-device is removed from the child table. Unlike the non-sleepy end-device, sleepy end-device does not use S56 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.
PAGE 39
ProBee-ZE20S-SExx User Guide Rev 1.8 Parent Node S53 S52 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.
PAGE 40
ProBee-ZE20S-SExx User Guide Rev 1.8 Table. Key Establishment process can be triggered by running the AT commands as below. AT+CBKESTART=addr,ep ,where addr is short or long address of destination node and ep is endpoint of destination node. AT+CBKEPARTNER=addr,ep ,where addr is short or long address of destination node and ep is endpoint of destination node. AT+CBKESTART is used to initiate Key Establishment between Trust Center(coordinator) and the other node(router or end-device).
PAGE 41
ProBee-ZE20S-SExx User Guide Rev 1.8 4 Digital and Analog I/O 4.1 GPIO (General Purpose Inputs and Outputs) Configuration The ZE20S module has total 18 I/O pins. Among these pins, I/O pin 2 is assigned to factory reset only and the user can use the rest 17 pins for general purpose inputs and outputs. The I/O pin assignments are shown in Table 4-1. As shown in Table 4-1, some pins provide special functions built into the firmware. Table 4-2 describes the special functions tied to the specific pins.
PAGE 42
ProBee-ZE20S-SExx User Guide Rev 1.8 Smart Energy GPIO is treated in this document. Please refer to ProBee-ZE20S User Guide for usage of such options digital input, digital output and analog input. Table 4-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 (falling Factory_reset / Bootloader edge, i.e.
PAGE 43
ProBee-ZE20S-SExx User Guide Rev 1.8 5 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. 5.1 Development Kit Contents The development kit consists of ZE20S modules and development boards to carry them.
PAGE 44
ProBee-ZE20S-SExx User Guide Rev 1.8 Figure 5-1 Development Board Layout 5.3 Development Board Hardware Descriptions 5.3.1 Power There are four ways to supply power to the development board:  5V Power Adapter  USB Port  Batteries (AA 1.5V x 4)  RS232 Port (5V through 9th Pin) The PWR_SEL(JP1) jumper MUST be configured properly according to the way to supply power. Table 51 shows jumper configuration. Table 5-1 Jumpers Configuration PWR_SEL 5V Power Adapter 5.3.
PAGE 45
ProBee-ZE20S-SExx User Guide Rev 1.8 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. 5.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. 5.3.
PAGE 46
ProBee-ZE20S-SExx User Guide Rev 1.8 31 GPIO_10 Digital Output with LED(CR13) Display (Active High) Digital Input with Button Switch (SW11, Active Low or Active High) Analog Input with Variable Register (VR2) 32 GPIO_9 Digital Output with LED(CR12) Display (Active High) Digital Input with Button Switch (SW10, Active Low or Active High) Analog Input with Variable Register (VR1) 5.3.5 LEDs (CR12-19) The development board has 8 LEDs for digital output.
PAGE 47
ProBee-ZE20S-SExx User Guide Rev 1.8 illumination and analog input is as follows: Illumination(Lux) = Volt(mV) * 0.25(Lux/mV) Note: The LED On/Off switch (SW20) should be placed to LED_OFF. 5.3.10 Terminal Block The development board has a terminal block for external analog inputs. Figure 5-2 shows the layout of the terminal block.
PAGE 48
ProBee-ZE20S-SExx User Guide Rev 1.8 Figure 5-3 Example: 1 Coordinator and 2 End-Devices 5.4.1 CBKE Data Token Configuration Hardware configuration for all devices is as follows:  Set the HOST switch to UART  Update ProBeeSESI firmware to a node for coordinator (See Chapter 2.3.3)  Update ProBeeSEID firmware to a node for end-device (See Chapter 2.3.3)  Update ProBeeSEME firmware to a node for end-device (See Chapter 2.3.
PAGE 49
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 50
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 51
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 52
ProBee-ZE20S-SExx User Guide Rev 1.8 CA PUBLIC KEY & DEVICE PRIVATE KEY(BUFFER): 0200FDE8A7F3D1084224962A4E7C54E69AC3F04DA6B8037EE06D90CADF5D399F0358260F70607E 4F584F14 OK If CBKE Data Token is vaild and it is locked successfully, you can see ‘GoodCert’ message in AT+INFO. AT+INFO Security Level: 05, Security Profile: SE Full SE Security Info: RealEcc, RealCbke, GoodCert # GoodCert when # CBKE Data Token is End-point count: 1 # valid and locked End-point No.
PAGE 53
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 54
ProBee-ZE20S-SExx User Guide Rev 1.8 End-point No.1: ProfileID-0x0109, DeviceID-0x0501 Server-side cluster: 0x0000 (Basic) Client-side cluster: 0x000A (Time) Server-side cluster: 0x0702 (Simple Metering) Client-side cluster: 0x0703 (Messaging) Client-side cluster: 0x0800 (Key establishment) Server-side cluster: 0x0800 (Key establishment) OK 5.4.2 Install Code Configuration Each device can set Install Code optionally for enhanced Smart Energy security.
PAGE 55
ProBee-ZE20S-SExx User Guide Rev 1.8 INSTALL CODE: 1122334455667788 # Successfully changed OK 5.4.3 ProBeeSESI 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: #Screen of ProBeeSESI(coordinator) AT+NODETYPE=1 OK AT+PANID=7772 OK ATZ OK Channel:14, PanID:7772 5.4.
PAGE 56
ProBee-ZE20S-SExx User Guide Rev 1.8 AT+KEYTABLE # Get Pre-configured Link Key NETWORK KEY: FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF LINK KEY TABLE #|IEEE_ADDRESS |TYPE|AUTH|KEY *|0000000000000000|LINK|NO |41618FC0C83B0E14A589954B16E31466 1/6 ENTRIES USED OK ‘FAILED TO JOIN(AD)’ means that ProBeeSEID node failed to join the network because Trust Center(coordinator) had no Pre-configured link key of ProBeeSEID and denied to join.
PAGE 57
ProBee-ZE20S-SExx User Guide Rev 1.8 NETWORK KEY: FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF LINK KEY TABLE #|IEEE_ADDRESS |TYPE|AUTH|KEY *|000195AABBCC0000|LINK|NO |41618FC0C83B0E14A589954B16E31466 1/6 ENTRIES USED OK # IEEE_ADDRESS changed to # long address of Trust Center 5.4.
PAGE 58
ProBee-ZE20S-SExx User Guide Rev 1.8 ‘FAILED TO JOIN(AD)’ means that ProBeeSEME node failed to join the network because Trust Center(coordinator) had no Pre-configured link key of ProBeeSEME and denied to join. To fix it, Trust Center(coordinator) node must add Pre-configured link key of end-device.
PAGE 59
ProBee-ZE20S-SExx User Guide Rev 1.8 5.4.6 Key Establishment Process To complete security authentication, use AT+CBKESTART and AT+CBKEPARTNER command.  Use AT+CBKESTART for Trust Center(coordinator)↔end-device Key Establishment.  Use AT+CBKEPARTNER for Partner Key Exchange between nodes other than Trust Center.
PAGE 60
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 61
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 62
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 63
ProBee-ZE20S-SExx User Guide Rev 1.8 5.4.7 Cluster Command for Binding Each Smart Energy node can communicate with the other by cluster command. A cluster consists of server-side cluster and client-side cluster, and both of them have their own commands. If a Smart Energy node has server-side or client-side cluster, the node can send cluster command to other node that has the other side cluster. Here is an example for sending cluster command.
PAGE 64
ProBee-ZE20S-SExx User Guide Rev 1.8 Then ProBeeSEME node receives following message: #Screen of ProBeeSEME(end-device) +0000|SE_DISPLAY_MESSAGE|11335577|01|0200|Test Message|08-22-2013/15:08:30 5.4.8 Showing Attribute Information Each Smart Energy node has its own attributes.
PAGE 65
ProBee-ZE20S-SExx User Guide Rev 1.8 5.4.9 Reading Attribute User can read attribute of local node or remote node by running the AT command as below:  AT+SREAD can be used for reading attribute of local node.  AT+CREAD can be used for reading attribute of remote node.  User should set destination address by AT+DEST before running AT+CREAD.  Destination node must implement corresponding attribute and cluster. Example) Read attribute of local node.
PAGE 66
ProBee-ZE20S-SExx User Guide Rev 1.8 Example) Write attribute to local node. #Screen of ProBeeSESI(coordinator) AT+SWRITE=0000,0012,00 # Write device attribute # Basic cluster(0x0000), # Device Enabled attribute(0x0012) # Set to 0x00 (Disabled) OK # Response Example) Write attribute to remote node.
PAGE 67
ProBee-ZE20S-SExx User Guide Rev 1.8 Example) Send ‘Get Profile’ command from ProBeeSEID to ProBeeSEME with ‘Delivered’.
PAGE 68
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 69
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 70
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 71
ProBee-ZE20S-SExx User Guide Rev 1.8 6 SE(Smart Energy) Profile Descriptions 6.1 Device Descriptions Device descriptions specified in this profile are summarized in following Table 6-1, “Devices Specified in the SE Profile”. The devices are organized according the end application areas they address.
PAGE 72
ProBee-ZE20S-SExx User Guide Rev 1.8 6.3 Cluster Binding Figure 6-1 The ZCL Client Server Model A cluster is a related collection of commands and attributes, which together define an interface to specific functionality. Typically, the entity that stores the attributes of a cluster is referred to as the server of that cluster and an entity that affects or manipulates those attributes is referred to as the client of that cluster.
PAGE 73
ProBee-ZE20S-SExx User Guide Rev 1.8 6.4 ProBee SE Profiles Description 6.4.1 ProBeeSESI (Energy Service Interface) The Energy Service Interface connects the energy supply company communication network to the metering and energy management devices within the home. It routes messages to and from the relevant end points. It may be installed within a meter, thermostat, or In-Premises Display, or may be a standalone device, and it will contain another non-ZigBee communication module (e.g.
PAGE 74
ProBee-ZE20S-SExx User Guide Rev 1.8 0x000A Time 0x0000 Time 0x0001 Time Status UTC_TIME INT8U 0x0800 Key establishment (Server Side) 0x0000 Key establishment suite ENUM16 0x0800 Key establishment (Client Side) 0x0000 Key establishment suite ENUM16 6.4.1.
PAGE 75
ProBee-ZE20S-SExx User Guide Rev 1.8 6.4.2.1 Cluster Support Table 6-5 ProBeeSEID Cluster Support Server Side Client Side Basic Time Identify Demand Response and Load Control Metering Price Messaging Key establishment Key establishment 6.4.2.
PAGE 76
ProBee-ZE20S-SExx User Guide Rev 1.8 6.4.2.
PAGE 77
ProBee-ZE20S-SExx User Guide Rev 1.8 autonomously send readings periodically. A Metering end device may also be capable of communicating certain status indicators (e.g. battery low, tamper detected). 6.4.3.1 Cluster Support Table 6-8 ProBeeSEME Cluster Support Server Side Client Side Basic Time Identify Messaging Metering Key establishment Key establishment 6.4.3.
PAGE 78
ProBee-ZE20S-SExx User Guide Rev 1.8 0x0300 Unit of measure ENUM8 0x0303 Summation formatting BITMAP8 0x0306 Metering device type BITMAP8 0x0800 Key establishment (Server Side) 0x0000 Key establishment suite ENUM16 0x0800 Key establishment (Client Side) 0x0000 Key establishment suite ENUM16 6.4.3.
PAGE 79
ProBee-ZE20S-SExx User Guide Rev 1.8 7 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 .
PAGE 80
ProBee-ZE20S-SExx User Guide Rev 1.8 Response 7.2.5 List of the S-register and description OK ATZ Description Reset the node. Execute ATZ Response OK 7.2.6 AT&F Description Factory reset. Execute AT&F Response OK 7.2.7 OK or ERROR ATU Get/Set UTC time format type for input/output. (0: 32-bit hexadecimal ranging 0x00000000 ~ 0xFFFFFFFF, Description 1: MM-DD-YYYY/hh:mm:ss, 2: DD-MM-YYYY/hh:mm:ss, 3: YYYY-MM-DD/hh:mm:ss).
PAGE 81
ProBee-ZE20S-SExx User Guide Rev 1.8 same address or a device leaves the network and later joins. Execute AT+SHORTADDR? Response 7.3.3 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.
PAGE 82
ProBee-ZE20S-SExx User Guide Rev 1.8 OK 7.3.8 AT+PRODUCTNAME or AT+PN Description Execute Get the product name. It can be used to distinguish among different hardware platforms. AT+PRODUCTNAME? Response 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 Description be used.
PAGE 83
ProBee-ZE20S-SExx User Guide Rev 1.8 Execute AT+EPID? Response OK AT+EPID= OK or ERROR Default 0000000000000000 Range 0000000000000000 – FFFFFFFFFFFFFFFF 7.4.4 AT+GROUPID or AT+GI Description Get/Set the 16-bit Group ID. It is used for multicast data reception. Execute AT+GROUPID? Response OK Default 0000 Range 0000 – FFFF 7.4.
PAGE 84
ProBee-ZE20S-SExx User Guide Rev 1.8 Default ProBee-SExx Range Up to 16 characters 7.5 Network Formation and Join 7.5.1 AT+ASCAN or AT+AS Description Execute Perform a scanning for existing network. It can take up to 5 seconds. (CAUTION: It is possible to cause a link error if a node is a parent of an end-device.) AT+ASCAN AT+ASCAN= |||| Response List of the existing networks … OK 7.5.
PAGE 85
ProBee-ZE20S-SExx User Guide Rev 1.8 Scan duration: 1 – 10 Range 7.5.4 Node type: 0 – 4 (Zero indicates all node types.) AT+RSSI or AT+RS Get RSSI and LQI information respectively for the delivery of the recent packet across the last hot of the incoming route. The LQI value ranges from 0 to 255 Description with the maximum value representing the best possible link quality.
PAGE 86
ProBee-ZE20S-SExx User Guide Rev 1.8 Response 7.6.2 OK AT+PARENTLA or AT+PL Description Get the 64-bit IEEE address of the parent node. Execute AT+PARENTLA? Response 7.6.3 OK AT+PARENTSA or AT+PS Description Get the 16-bit Node ID of the parent node. Execute AT+PARENTSA? Response 7.6.4 OK AT+CHILDTABLE or AT+CT Description Get the child table composed of the end-devices.
PAGE 87
ProBee-ZE20S-SExx User Guide Rev 1.8 7.8.2 AT+NWKKEY or AT+NK Description Get/Set the 128-bit network key. (0 or 0s: generate random 128-bit number) Execute AT+NWKKEY? Response Default 7.8.3 AT+NWKKEY= OK or ERROR OK FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF AT+UPDATEKEY or AT+UK Update the network key with a new generated key.
PAGE 88
ProBee-ZE20S-SExx User Guide Rev 1.8 Response OK Default 8 Range 7–8 7.9.3 OK or ERROR AT+PARITY or AT+UP Description Get/Set the serial parity setting on the module. Execute AT+PARITY? Response OK Default 0 Range 0–2 7.9.4 AT+PARITY= OK or ERROR AT+STOPBIT or AT+US Description Get/Set the serial stop bit setting on the module. Execute AT+STOPBIT? Response OK Default 1 Range 1–2 7.9.
PAGE 89
ProBee-ZE20S-SExx User Guide Rev 1.8 0 Disabled (unmonitored digital input) 1 Digital input, monitored 2 Digital output, default low 3 Digital output, default high 4 Analog input, single ended (only valid for GPIO9~14) 5 Reserved for pin-specific alternate functionalities 7.10.2 AT+DIO Get/Set the digital IO value individually or all at once. All GPIO pins can be used Description as digital IO and it is only possible to set 0 or 1.
PAGE 90
ProBee-ZE20S-SExx User Guide Rev 1.8 7.11 Firmware Upload and Help 7.11.1 AT+BOOTLOAD or AT+BL Start bootloader to upload firmware. (blank: local, 1: passthru) The device leaves the AT command line and enters the bootloader menu for Description uploading new ProBee firmware. There’s no restrict to use local upload but a sleepy end-device cannot upload to remote node over the air. The current UART should be set 115200bps, 8 data bits, no parity, 1 stop bit and none flow control.
PAGE 91
ProBee-ZE20S-SExx User Guide Rev 1.8 OK 7.12.3 AT+DEST or AT+DE Description Execute Response Set address of destination node. This address will be used in AT+CREAD, AT+CWRITE, AT+CCMD, AT+SCMD and other SE commands. AT+DEST=, or AT+DEST=, OK or ERROR 7.12.4 AT+SREAD or AT+SR Description Read attribute from local node. (server-side command) Execute AT+SREAD=, Response OK or ERROR 7.12.
PAGE 92
ProBee-ZE20S-SExx User Guide Rev 1.8 7.12.9 AT+CCMD or AT+CC Description Execute Response Send client-side command message to destination node. (client-side command) AT+DEST=
, AT+CCMD=, OK or ERROR 7.12.10 AT+FACTORYRESET or AT+FR Description Execute Response Send ‘Factory Reset’ command(Basic cluster) to destination node. (client-side command) AT+DEST=
, AT+FACTORYRESET? OK or ERROR 7.12.
PAGE 93
ProBee-ZE20S-SExx User Guide Rev 1.8 AT+TSYNC +
|SE_GLOBAL_COMMAND|000A|01 Response +
|SE_TIME_SYNC| 7.12.15 AT+CBKESTART or AT+CS Start ‘Initiate Key Establishment Request’ command(Key Establishment cluster) to Description destination node and exchange static and ephemeral data. This command should be performed at Trust Center(coordinator) node or destination node should be Trust Center(coordinator) node.
PAGE 94
ProBee-ZE20S-SExx User Guide Rev 1.8 CA PUBLIC KEY & DEVICE PRIVATE KEY: OK 7.12.19 AT+SETCBKEKEY Description Execute Lock CBKE Data Token. Once the CBKE Data Token is locked, it cannot be changed and erased. AT+SETCBKEKEY CBKE DATA TOKEN IS LOCKED Response DEVICE IMPLICIT CERT: CA PUBLIC KEY & DEVICE PRIVATE KEY: OK 7.13 ProBeeSESI (Energy Service Interface) Profile Commands 7.13.
PAGE 95
ProBee-ZE20S-SExx User Guide Rev 1.8 format of time is determined by ATU value. Execute Response AT+PRSTARTTIME? OK AT+PRSTARTTIME= OK or ERROR Default 01-01-2000/00:00:00 Range 01-01-2000/00:00:00 - 02-07-2136/06:28:15 7.13.5 AT+MSID or AT+MID Description Execute Response Get/Set Message ID. This value will be used in AT+MSDISPLAY and AT+MSCANCEL.
PAGE 96
ProBee-ZE20S-SExx User Guide Rev 1.8 Default 0000 Range 0000 – FFFF 7.13.9 AT+MSDISPLAY or AT+MDI Description Execute Response Send ‘Display Message’ command(Messaging cluster) to destination node. (server-side command) AT+DEST=
, AT+MSDISPLAY=? OK or ERROR 7.13.10 AT+MSCANCEL or AT+MCA Description Execute Response Send ‘Cancel Message’ command(Messaging cluster) to destination node.
PAGE 97
ProBee-ZE20S-SExx User Guide Rev 1.8 Response OK or ERROR 7.13.14 AT+DLDEL or AT+DLD Description Delete DRLC Event. Execute AT+DLDEL= Response OK or ERROR 7.13.15 AT+DLLOADCTRL or AT+DLC Description Send ‘Load Control Event’ command(DRLC cluster) to destination node. (serverside command) AT+DEST=
, Execute AT+DLLOADCTRL= Response OK or ERROR 7.13.
PAGE 98
ProBee-ZE20S-SExx User Guide Rev 1.8 Execute Response AT+DEST=
, AT+SMFPMODE=, OK or ERROR 7.14.4 AT+SMENDTIME or AT+SET Description Execute Response Get/Set Metering End Time. This value will be used in AT+SMGETPROFD and AT+SMGETPROFR. The format of time is determined by ATU value. AT+SMENDTIME? OK AT+SMENDTIME= OK or ERROR Default 01-01-2000/00:00:00 Range 01-01-2000/00:00:00 - 02-07-2136/06:28:15 7.14.
PAGE 99
ProBee-ZE20S-SExx User Guide Rev 1.8 Response OK or ERROR OK Default 01-01-2000/00:00:00 Range 01-01-2000/00:00:00 - 02-07-2136/06:28:15 7.14.9 AT+MSGETLAST or AT+MGL Description Execute Response Send ‘Get Last Message’ command(Messaging cluster) to destination node. (client-side command) AT+DEST=
, AT+MSGETLAST OK or ERROR 7.14.10 AT+DLLIST or AT+DLT Description Show DRLC Event List.
PAGE 100
ProBee-ZE20S-SExx User Guide Rev 1.8 AT+DLREPORTES=, Response OK or ERROR 7.14.14 AT+DLGETSCH or AT+DGS Description (client-side command) AT+DEST=
, Execute AT+DLGETSCH= Response 7.15 Send ‘Get Scheduled Events’ command(DRLC cluster) to destination node. OK or ERROR ProBeeSEME (Metering Device) Profile Commands 7.15.
PAGE 101
ProBee-ZE20S-SExx User Guide Rev 1.8 7.15.4 AT+SMFPENDTIME or AT+SFT Get/Set Metering Fast Poll Mode End Time. This value will be used in ‘Request Description Fast Poll Mode Response’ command. The format of time is determined by ATU value. Execute Response AT+SMFPENDTIME? OK AT+SMFPENDTIME= OK or ERROR Default 01-01-2000/00:00:00 Range 01-01-2000/00:00:00 - 02-07-2136/06:28:15 7.15.
PAGE 102
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 103
ProBee-ZE20S-SExx User Guide Rev 1.8 8.1.3 S13 Description Get/Set the command responses mode. Execute ATS13? Response OK Default 1 Range 0-1 8.1.4 ATS13= OK S14 Get/Set the LED mode. It causes the LED operation if the device is ZE20S set GPIO15, 16 to specific functionality. Description 0: LEDs are always OFF regardless of configuration or status. 1: LEDs are OFF when the node is under sleep status. 2: LEDs always operate by the case.
PAGE 104
ProBee-ZE20S-SExx User Guide Rev 1.8 Default 0 Range 0–1 8.3 GPIO 8.3.1 S41 Description Execute Response Get/Set the GPIO pull up/down option. If GPIOs are set to DI(Digital Input), it is possible to pull-up or pull-down with this value. Pull-down = 0, Pull-up = 1. ATS41? OK Default 0 Range 0-1 8.3.2 ATS41= OK S42 Get/Set the GPIO monitoring period in seconds.
PAGE 105
ProBee-ZE20S-SExx User Guide Rev 1.8 node according to GPIO monitoring node (S43). If set to 0, GPIO change detection sampling is disabled. Execute Response ATS44? OK Default 0 Range 0–1 8.3.5 ATS44= OK S45 Get/Set the GPIO remote control mode. If any GPIO pin is set to digital input, a node can control the I/O status of a remote node if the I/O pin of the remote node is set to Description digital output.
PAGE 106
ProBee-ZE20S-SExx User Guide Rev 1.8 8.4.3 S53 Get/Set the sleep duration in quarter seconds. An end-device sleeps for this time and Description turns off radio every sleep cycle. If a node sleeps over poll timeout of parent node, the device will be removed from the child table. Execute Response ATS53? OK Default 8 Range 0 – 16711680 8.4.4 ATS53= OK S54 Get/Set the standby timeout in seconds.
PAGE 107
ProBee-ZE20S-SExx User Guide Rev 1.8 Default 5 Range 0 - 10000 8.5 Frequency Agility 8.5.1 S71 Get/Set the Frequency agility function. If it is enabled in coordinator mode, node will Description automatically shift operating channel to one of channel masks when its unicasts fail more than threshold.
PAGE 108
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 109
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 110
ProBee-ZE20S-SExx User Guide Rev 1.8 10 Connections 10.1 Serial Port Pin Outs ProBee-ZE20S is a DCE device compatible with the RS232 standard, a DB9 female interface.
PAGE 111
ProBee-ZE20S-SExx User Guide Rev 1.8 10.2 Serial Wiring Diagram 10.2.1 To Host with DTE Interface 10.2.
PAGE 112
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 113
ProBee-ZE20S-SExx User Guide Rev 1.
PAGE 114
ProBee-ZE20S-SExx User Guide Rev 1.8 12 Warranty 12.1 GENERAL WARRANTY POLICY Sena Technologies, Inc. (hereinafter referred to as Sena) warrants that the Product shall conform to and perform in accordance with published technical specifications and the accompanying written materials, and shall be free of defects in materials and workmanship, for the period of time herein indicated, such warranty period commencing upon receipt of the Product.
PAGE 115
ProBee-ZE20S-SExx User Guide Rev 1.8 12.3 HARDWARE PRODUCT WARRANTY DETAILS WARRANTY PERIOD: Sena warranties embedded hardware Product for a period of one (1) year, and external hardware Product for a period of three (3) or five (5) years according to the Product type. WARRANTY PROCEDURE: Upon return of the hardware Product Sena will, at its option, repair or replace Product at no additional charge, freight prepaid, except as set forth below.
PAGE 116
ProBee-ZE20S-SExx User Guide Rev 1.8 13 Regulatory Information 13.1 FCC FCC Rule: Part 15 Subpart C Section 15.247 FCCID: S7AIW01 FCC Compliance Statement This device complies with part 15 of the FCC Rules.
PAGE 117
ProBee-ZE20S-SExx User Guide Rev 1.8 13.2 CE CE1177(!) We, Sena Technologies, Inc., declare that the product(s):  ProBee-ZE20S ZigBee OEM Module to which this declaration relates is in conformity with the following standard(s) or other normative document(s)  EN 60950-1  ETSI EN 301 489-1  ETSI EN 301 489-17  ETSI EN 300 328 Following the provisions of  13.
PAGE 118
ProBee-ZE20S-SExx User Guide Rev 1.8 14 RF Information Radio Frequency Range 2.405~2.480GHz Number of Frequency Channel 16 channels Transmission Method DSSS (Direct Sequence Spread Spectrum) Modulation Method O-QPSK (Offset Quadrate Phase Shift Keying) Radio Output Power +8dBm Receiving Sensitivity -102dBm Power Supply DC3.