You are on page 1of 26

AT-Commands Users Manual (V3.1.

1b)

AT-Commands Users Manual (V3.1.1b)

Holley Group Co., Ltd.


Add1: No.8 Liansheng Rd. Wuchang, Yuhang District, Hangzhou, 310023, P.R.C Add2: 12E&15D, Tiantang Software Park, No.3 Xidoumen Rd., Hangzhou, 310012, P.R.C Tel: 86 571 88471702 Fax: 86 571 28116981 www.holley.cn www.hornetone.com

12/22/2008

AT-Commands Users Manual (V3.1.1b)

Version Control
Date 2008.06.04 2008.06.17 2008.06.27 2008-9-4 Version 1.0 1.0.1 2.1.6 3.1.1b Notes 1st Issue of Preliminary Manual Add AT+SLEEP=XX to AT-Command set Add management AT-Commands such as AT+JOIN etc. Add Hand Hold Unit and enable message transferring between Routers

* Holley reserves the right to make changes to the product specification at anytime without notice.

12/22/2008

AT-Commands Users Manual (V3.1.1b)

Contents
Version Control ...............................................................................................................................2 1. Introduction...................................................................................................................................5 2. Device Type ..................................................................................................................................6 3. Configuration AT-Command set....................................................................................................6 3.1 AT-Command Summary......................................................................................................6 3.1 AT+SETUART=XX-P ........................................................................................................8 3.2 AT+SETPID=XXXX ..........................................................................................................9 3.3 AT+SETCH=XX .................................................................................................................9 3.4 AT+SETEXPID=XXXX (8bytes, 16 characters) ......................................................10 3.5 AT+SETADVGAP=XX ....................................................................................................10 3.6 AT+COORPTADVREP=01/00 .........................................................................................12 3.7 AT+COOSENDADV ........................................................................................................12 3.8 AT+HHUSENDADV=01/02.............................................................................................13 3.9 AT+LIST ...........................................................................................................................13 3.10 AT+ENABLEDIP=00/01 ................................................................................................14 3.11 AT+RESET......................................................................................................................14 3.12 AT+VER..........................................................................................................................15 3.13 AT+SLEEP=XX ..............................................................................................................15 3.14 AT+BOOTLDR...............................................................................................................15 3.15 AT+SHOWADDR ...........................................................................................................15 3.16 AT+GETNETINFO.........................................................................................................16 3.17 AT+SHOWPARA............................................................................................................16 3.18 AT+GETSINK.................................................................................................................18 3.19 AT+SCAN=XXXXXXXX..............................................................................................18 3.20 AT+JOIN; AT+JOIN=XX ...............................................................................................19 3.21 AT+LEAVE .....................................................................................................................19 3.22 AT+RTSENDMAC=01/00 ..............................................................................................20 3.23 AT+RTBCAST=00/01.....................................................................................................20 3.24 AT+RTRXPEER=00/01 ..................................................................................................21 3.25 AT+ADDRESSING=00/01 .............................................................................................21 3.26 AT+FLASHLED=00/01 ..................................................................................................22 3.27 AT+SETUARTGAP=XX ................................................................................................23 3.28 AT+SETPRCSGAP=XX.................................................................................................23 3.29 AT+SETLKEY=XXXX (16bytes, 32 characters) ...................................................23 3.30 AT+GETLKEY ...............................................................................................................23 3.31 AT+SETNKEY=XXXX (16bytes, 32 characters)...................................................24 3.32 AT+GETNKEY...............................................................................................................24 3.33 AT+RTOKEN..................................................................................................................24 4. Known Limitations .....................................................................................................................24 4.1 Density of Routers ............................................................................................................24 4.2 Serial Frame Gap ..............................................................................................................25 4.3 Serial Frame Size ..............................................................................................................25

12/22/2008

AT-Commands Users Manual (V3.1.1b)

Appendix A: Contact Details .......................................................................................................26

12/22/2008

AT-Commands Users Manual (V3.1.1b)

AT-Commands Users Manual


1. Introduction
This product includes hardware platform and firmware applications. A single set of the product is composed of 1 COO device, multiple Router devices (including Non-Routing-Router, NRR), and optionally, a Hand-Hold-Unit (HHU). The COO forms a ZigBee network and acts as the data concentrator of the network. Routers and HHU join the network formed by COO and communication with each other. All kind of the devices are based on same hardware platform but with different firmware running. The product provides standard ZigBeePRO wireless communication ability. Network management and routing discovering are automatically supported. Users application connects to device with serial interface and application data delivered transparently.

COO

Router

Router Router

Router

HHU

12/22/2008

AT-Commands Users Manual (V3.1.1b)

2. Device Type
COO COO is the coordinator of a ZigBee network. It forms and maintains a network and normally acts as gateway, transforms data in and out of the ZigBee network. Device type code is EMBER_COORDINATOR (0x01). Router Router has routing ability but could not form a ZigBee network. It joins in an existing network and act as a router. It also allows other devices join in after itself has joined network. Device type code is EMBER_ROUTER (0x02). Non-Routing-Router (NRR) Non-Routing-Router is a Router but does not have routing ability. It is end device and not allows other devices join. Device code is 0x0A. Hand Hold Unit (HHU) HHU is a moving device and usually act as a survey tool of ZigBee network. It scans available ZigBee networks and joins in one of them and then sends diagnostic commands to target nodes. Device code is EMBER_MOBILE_END_DEVICE (0x05).

3. Configuration AT-Command set


3.1 AT-Command Summary
This product provides a set of AT-Commands to configure the executing strategy. Table 1: summary of AT-Commands
Command AT+SETUART AT+SETPID AT+SETCH COO Router NRR HHU Default value 38400-8-N-1 0x5452 0x19 Function Set UART port feature Set PANID Set communication

frequency AT+SETEXPID 0x5452414E534D4954 Set extended PANID

12/22/2008

AT-Commands Users Manual (V3.1.1b)

AT+SETADVGAP

COO: 2 (minutes) Router: 30 (seconds)

COO:

set

advertisement cycle; Router: set heart beat cycle

AT+COORPTADVREP

00

Configure

if

COO

report Advertisement Reply message to

UART or not AT+COOSENDADV Force COO send

Advertisement frame AT+HHUSENDADV Force HHU send

Advertisement frame AT+LIST Ask COO list all the nodes that have joined network. AT+ENABLEDIP 00 Enable dipper

configure or not. If this function is

enabled, PANID, parameters

configured Channel will be

tuned based on dipper settings. AT+RESET AT+VER Force device reset Return firmware

version, as well as device type AT+SLEEP Force device enter

sleep mode AT+BOOTLDR Force device enter

bootloader mode AT+SHOWADDR Returns both MAC address and ZigBee node ID AT+GETNETINFO Return basic network information, such as PANID, Channel, etc. AT+SHOWPARA Return configured

parameter value AT+GETSINK Return address AT+SCAN 7 Scan for available COO MAC

ZigBee network AT+JOIN Router: join network 12/22/2008

AT-Commands Users Manual (V3.1.1b)

with

configured

network parameter. HHU: join a scanned network AT+LEAVE Force device leave

joined network AT+RTSENDMAC 00 Configure if Router send its MAC address together application data AT+RTBCAST 00 Configure Router send application data by with

broadcast or unicast. AT+RTRXPEER 00 Configure if Router receives data from

other Router AT+ADDRESSING 00 Enable addressing or not AT+FLASHLED 01 Configure if device flash LED to indicate its status or not AT+SETUARTGAP 0x05 Configure time gap between two UART frames AT+SETPRCSGAP 0x0F Configure cycle of process buffered

UART fames AT+SETLKEY 0x486F6C6C65792054 72616E736D69742E AT+GETLKEY AT+SETNKEY 0x486F726E65746F6E 65205472616E736D AT+GETNKEY AT+RTOKEN Return Link Key Configure Key Return Network Key Set all parameters to default value listed in this table. Network Configure Link Key

3.1 AT+SETUART=XX-P
Function: Configure baud rate and parity of serial port. XX: Baud rate setting, HEX format. Supports following value:
BAUD_1200 = 03, BAUD_2400
8

= 04,

BAUD_4800

= 05,
12/22/2008

AT-Commands Users Manual (V3.1.1b)

BAUD_9600 BAUD_28800 BAUD_57600 BAUD_115200

= = = =

06, BAUD_14400 = 07, 09, BAUD_38400 = 0A, 0C, BAUD_76800 = 0D, 0F

BAUD_19200 BAUD_50000 BAUD_100000

= 08, = 0B, = 0E,

P: Parity setting. Supports following value:


N = no parity; O = odd parity; E = even parity

Example: AT+SETUART=0A-N Set UART to be: 38400-8-N-1 Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command. Note: The UART port only supports 8-bit byte format, and stop bit is fixed to 1 bit.

3.2 AT+SETPID=XXXX
Function: Configure 16 bit PANID of ZigBee network. Configured PANID will be stored in Non-Volatile (NV) memory and will not lose after power cycle. XXXX: 16 bit PANID, HEX format. Accept all value except 0xFFFF it is reserved for ZigBee specification. Device Type: COO, Router, and Non-Routing-Router. HHU does not support this command as it does not use a static PANID to join network. It scans for existing ZigBee network to join instead. Note1: ZigBee uses a 16-bit PANID to distinguish different networks which are running in same channel. ZigBee device will use this configured PANID to form/join network. Note2: Newly configured value will take effect after the ZigBee device is rebooted.

3.3 AT+SETCH=XX
Function: Configure communication channel (Frequency) of ZigBee devices. Configured channel will be stored in Non-Volatile (NV) memory and will not lose after power cycle. XX: ZigBee channel number, HEX format. Accept value from 0x0B 0x1A. Device Type: COO, Router, and Non-Routing-Router. HHU does not support this
9 12/22/2008

AT-Commands Users Manual (V3.1.1b)

command as it does not use pre-configured channel to join network. It scans for existing ZigBee network to join instead. Note1: ZigBee supports 16 communication channels (frequencies): channel 11 to channel 26, corresponding to frequencies of 2405MHz to 2480MHz, 5MHz for each channel. ZigBee device will use this configured channel to communicate with other ZigBee devices. Note2: Newly configured value will take effect after the ZigBee device is rebooted.

3.4 AT+SETEXPID=XXXX

(8bytes, 16 characters)

Function: Configure 64 bit extended PANID of ZigBee network. Configured extended PANID will be stored in Non-Volatile (NV) memory and will not lose after power cycle. XXXX: 64 bit extended PANID, HEX format. Device Type: COO, Router, and Non-Routing-Router. HHU does not support this command as it dose not a static extended PANID to join network. It scans for existing ZigBee network to join instead. Note1: Newly released ZigBee specification supports a 64-bit extended PANID to distinguish different networks which are running in same channel. ZigBee device will use this configured extended PANID to form/join network. Note2: Newly configured value will take effect after the ZigBee device is rebooted.

3.5 AT+SETADVGAP=XX
Function: This command has different function for COO and for Router. For COO, this command configures COO Advertisement cycle; while for Router, this command configures heart beat cycle. Configured value will be stored in Non-Volatile (NV) memory and will not lose after power cycle. XX: Advertisement or heat beat cycle value, HEX format. For COO, XX value in minutes. Minimum value is 0x01. Set to 0x00 will be treated as 0x01 since COO sending Advertisement is necessary and should not be disabled.

10

12/22/2008

AT-Commands Users Manual (V3.1.1b)

For Router, XX value in seconds. Minimum value is 0x0F since Router should not send heart beat frame to COO too frequent. Set value lower than 0x0F will be treated as 0x0F. Set to 0x00 will disable the heart beat function, i.e., Router will never send heart beat frame to COO. Device Type: COO, Router, and Non-Routing-Router. HHU does not support this command as it sends Advertisement manually instead of periodically. Note1: COO sends Advertisement periodically and asks all receiving Routers return their address information, as well as neighbor tables. With all the returned information, it is possible to calculate topology of the ZigBee network. This command sets the time gap between 2 Advertisement frames. The structure of the Advertisement frame is defined as below:
4 bytes Low 4 bytes of MAC Address 2 Node ID 1 Type 1 Contents

Low 4 bytes of MAC Address: The MAC address of a ZigBee device is composed of 8 bytes but in our product, the high 4 bytes is fixed to [00 0D 6F 00]. As a result, placing low 4 bytes of MAC address into the Advertisement frame is enough the receivers could make up senders full MAC address easily. Node ID: The 16-bit Node ID of the sender. Type: Device type of the sender. Not only COO, but also HHU could send Advertisement frame. Contents: Reserved for future use. On receiving the Advertisement frame, all Routers should return an Advertisement Reply frame. The structure of the Advertisement Reply frame is defined as below:
4 bytes Low 4 bytes of MAC Address 2 Node ID 1 Type 1 Number of Neighbors Variable Node ID of Neighbors

Low 4 bytes of MAC Address: Low 4 bytes MAC address of the replier. Node ID: The 16-bit Node ID of the replier. Type: Device type of the replier.
11 12/22/2008

AT-Commands Users Manual (V3.1.1b)

Number of Neighbors: Routers will include their neighbor table in the Reply frame. This field indicates the number of the neighbors. Node ID of Neighbors: The Node ID of the repliers neighbors. Note2: If not receiving any message from COO for a configured time, Router may send a heart beat frame to COO. This feature can be disabled by setting to 0x00 to reduce network transmission. The heart beat frame format is just same as Advertisement Reply frame.

3.6 AT+COORPTADVREP=01/00
Function: Configure if COO report Advertisement Reply frame to UART port. Set to 01 will enable this function and 00 otherwise. Device Type: Only COO supports this command. Note: On receiving the Advertisement frame, all Routers will return Advertisement Reply frame. It is very likely that several Reply frames returned at almost same time and when reporting them to UART port, they conjunct together. To make it easier to distinguish each of the connected Reply frame, device add Header, Length and Footer to each of Reply frame when reporting to UART port as below:
Header * Length L Payload Advertisement Reply Frame Footer #

Header: Indicate the start of a Reply frame, use * (ASCII 0x2A) Length: Length of the Advertisement Reply frame Payload: The body of Advertisement Reply Frame Footer: Indicate the end of a Reply frame, use # (ASCII 0x23)

3.7 AT+COOSENDADV
Function: Force COO send Advertisement frame right away, even if the Advertisement cycle time is not up. Device Type: Only COO supports this command.

12

12/22/2008

AT-Commands Users Manual (V3.1.1b)

Note: After sending the Advertisement frame, the cycle time is reset to beginning.

3.8 AT+HHUSENDADV=01/02
Function: Force HHU send Advertisement frame right away. HHU supports 2 types of Advertisement: a) Command parameter set to 01, HHU sends 1-hop Advertisement, i.e., only HHUs neighbors could receive the frame; b) Command parameter set to 02, HHU sends full Advertisement, i.e., the all the joined nodes could received the frame. Device Type: Only HHU supports this command. Note1: Besides COO, HHU also sends Advertisement frame and receiving Router returns Advertisement Reply frame, too. Moreover, formats of both Advertisement and Reply frame are identical with those of COOs. Note2: HHU only send Advertisement frame when this command is issued not periodically.

3.9 AT+LIST
Function: Lists the Router members of network. Device Type: Only HHU supports this command. Note: COO will list the MAC address, Node ID and type of each joined members.

13

12/22/2008

AT-Commands Users Manual (V3.1.1b)

3.10 AT+ENABLEDIP=00/01
Function: Configure if enable tuning PANID, Extended PANID and Channel parameters by dipper settings. Set to 01 will enable this function and 00 otherwise. Device Type: COO, Router, and Non-Routing-Router. HHU does not support this command as it does not use static network parameters to join. Note: More detail about this function will be described later.

3.11 AT+RESET
Function: Force the device reset itself. Device Type: COO, Router, and Non-Routing-Router. HHU does not support this command as it could be manually reset by operator. Note: There will be a 6 seconds delay before the device resets itself after the command is issued. During the time, the device will perform some actions such as save certain values into non-volatile(NV) medium, deliver/process buffered messages if any, etc.
14 12/22/2008

AT-Commands Users Manual (V3.1.1b)

3.12 AT+VER
Function: Returns the firmware version of the device. Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command.

3.13 AT+SLEEP=XX
Function: Force device enter sleep mode to save power consumption. XX: Specifies sleep duration, HEX format, in seconds. After XX-second sleep, device automatically wakes up and proceeds process. XX=00 will set device into endless sleep and device could only be woke up by GPIO event. Wake up Condition: Device in sleep mode will wake up if: 1) Sleep duration time out. 2) GPIO event - any voltage level exchange on any of GPIOs will woke up the device. Device Type: COO, Router, and Non-Routing-Router. HHU does not support this command as it could be manually turned off to save power consumption. Note: If AT+SLEEP=00 is issued, the device will enter sleep mode and could only be woke up by GPIO event.

3.14 AT+BOOTLDR
Function: Force the device enters bootload state at once, for firmware update purpose. Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command. Note: The firmware of the devices could be updated via serial communication port when the devices were in bootload state.

3.15 AT+SHOWADDR
Function: Returns the address information of the device, includes both MAC address and ZigBee Node ID.
15 12/22/2008

AT-Commands Users Manual (V3.1.1b)

Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command. Note: The MAC address of the device is universal unique one and never changes. The ZigBee Node ID is assigned by COO randomly when the device joins network. Before the device is joined network, the Node ID will be 0xFFFE. The Node ID of COO is fixed to 0x0000.

3.16 AT+GETNETINFO
Function: Returns the basic configuration information of the device, including PANID, Channel, UART settings and Extended PANID value. Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command.

3.17 AT+SHOWPARA
Function: Return parameters value. Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command.
16 12/22/2008

AT-Commands Users Manual (V3.1.1b)

Note: The values of the parameters are arrayed as below:


typedef struct { int16u uiPAN_ID; int8u ucChannel; // int8s cPower; int8u ucBaud_Rate; // int8u ucOutput_MAC; int8u ucParity; // int8u ucReport_Adv; int8u ucDIP_CFG; int8u ucAdv_Gap; int8u ucUART_Gap; int8u ucProcess_Gap; int8u ucRT_Send_Bcast; int8u ucRT_Send_MAC; int8u ucRT_RX_Peer_Data; int8u ucAddressing; int8u ucLED; }

Transmit power, fixed to 0x03

this parameter has been canceled, read as 0

COO report Advertisement Reply to UART or not

17

12/22/2008

AT-Commands Users Manual (V3.1.1b)

3.18 AT+GETSINK
Function: Get COOs both MAC address and ZigBee Node ID. Device Type: All devices except COO support this command. Note: This command will return COOs address as 0xFFFF if the Router has not joined ZigBee network yet.

3.19 AT+SCAN=XXXXXXXX
Function: Force HHU starts an active scan procedure to scan for existing ZigBee network. If a network is found, report its Channel, PANID and Extended PANID. Each found network is assigned an index number, with which to select a network to join in AT+JOIN command. XXXXXXXX: Bitmask for the channels to be scanned, HEX format. ZigBee in 2.4GHz supports 16 channels and each bit stand for 1 channel. Set to 07FFF800 to scan all of the 16 channels.

Reserved

2.4GHz

915MHz

Device Type: For HHU only.

18

12/22/2008

AT-Commands Users Manual (V3.1.1b)

3.20 AT+JOIN; AT+JOIN=XX


Function: This command has different functions for Router and HHU. For Router, this command ask Router that has not joined network to try to join network with configured network parameters, the command has no parameter followed in this case. For HHU, this command should issued right after the AT+SCAN command. HHU selects one from the scanned result and try to join the selected network. XX: Index of the network just found by AT+SCAN, HEX format. For HHU only. Device Type: All devices except COO support this command. Note: Device that has already joined network will discard this command.

3.21 AT+LEAVE
Function: Force joined ZigBee device leave network. Device Type: All devices except COO support this command.
19 12/22/2008

AT-Commands Users Manual (V3.1.1b)

Note1: Left Router will not try to join network until AT+JOIN command is issued. Note2: This command will return network status information if the Device is not joined network yet. Network status could be: 0x00: EMBER_NO_NETWORK, Device not joined network yet. 0x01: EMBER_JOINING_NETWORK, device is joining network but not successfully joined. 0x04: EMBER_LEAVING_NETWORK, device is leaving network. Note3: Leaving Router will send a message to COO to notify its leaving. HHU wont notify its leaving as it is a temporary device.

3.22 AT+RTSENDMAC=01/00
Function: Configure if Router (including Non-Routing-Router) device reports its MAC address when sending a wireless message to other node. Set to 01 will enable this function and 00 otherwise. Device Type: Only Router and Non-Routing-Router support this command. Example:
Router [00 0D 6F 00 00 5C 61 1C] sends application data ABC[0x41 0x42 0x43] to COO

AT+RTSENDMAC=00
Router only send the 3-byte application data to COO and COO will report received data to serial port as below: 41 42 43

AT+ RTSENDMAC=01
Router automatically adds its 8-byte MAC address in front of the 3-byte application data and then sends all of the data to COO. COO will receive 11-byte data and report to serial port as below: 00 0D 6F 00 00 5C 61 1C 41 42 43

3.23 AT+RTBCAST=00/01
Function: Enable Router send data frame to other Routers or not. Set to 01 will enable Router this function and 00 otherwise. In most of applications, Routers do not exchange data between each other. They just send/receive data to/from COO and HHU. If this function is enabled, Routers will send data to all nodes, including other Routers.

20

12/22/2008

AT-Commands Users Manual (V3.1.1b)

Device Type: Only Router and Non-Routing-Router support this command.

3.24 AT+RTRXPEER=00/01
Function: Enable Router receive data frame from other Routers or not. Set to 01 will enable this function and 00 otherwise. Routers only accept data frames from COO or HHU, and will discard those from other Routers when this function is disabled, even if the sender has enabled sending data to other Routers. If this function is enabled, Routers will accept data frames from other Routers as well. Device Type: Only Router and Non-Routing-Router support this command.

3.25 AT+ADDRESSING=00/01
Function: Enable devices addressing or not. Set to 01 will enable this function and 00 otherwise. When addressing is disabled: a) COO sends data frames to all other devices transparently; b) Router sends data frames to COO and HHU only if AT+RTBCAST=01, to all devices if AT+RTBCAST=00. If addressing is enabled, all devices send data only to the addressing target device, other devices wont receive the data frame. Device Type: COO, Router, and Non-Routing-Router are support this command. HHU does not support this command as it always enables this function and can not be disabled. Note1: When addressing is enabled, users application must add target devices MAC address in front of the application data and send them together to the local device through UART port. The local device will always treat first 8-byte data received from UART as target MAC address and send application data only to the addressed remote device. On the other hand, the receiver will only receive the application data, not include its MAC address.. Example:

21

12/22/2008

AT-Commands Users Manual (V3.1.1b)

COO sends application data ABC[0x41 0x42 0x43] to Router [00 0D 6F 00 00 5C 61 1C] only. Users application should send target devices MAC address together with the application data to COO through UART port, and first 8 bytes are target MAC address.

Sender: COO
COO send following data: 00 0D 6F 00 00 5C 61 1C 41 42 43

Receiver: Router

Only Router [00 0D 6F 00 00 5C 61 1C] will receive the data and it only report 3-byte application data to it UART port as below: 41 42 43

Note2: When addressing is enabled, device will check if the first 8 bytes data received from UART were valid MAC address. High 4 bytes of the MAC address should be [00 0D 6F 00]. Any data with invalid MAC address will be discarded. Note3: There are 2 special MAC addresses for broadcast: [FF FF FF FF FF FF FF FF]: Broadcast address to all devices. [00 00 00 00 00 00 00 00]: 1-hop broadcast address, for HHU only.

3.26 AT+FLASHLED=00/01
Function: Configure if ZigBee device flash LEDs to indicate its status or not. There are 3 LEDs on the ZigBee device. LED1 is used to indicate network status: if the device has successfully joined network, LED1 will flash regularly. LED1 will off if the device is out of network. LED2 is used to indicate an incoming RF frame. LED3 is used to indicate an out going RF frame. Device Type: COO, Router, and Non-Routing-Router are support this command. HHU does not support this command since flashing LED will waste much battery power. Note: In some battery powered application, disable LED flashing will save much power.

22

12/22/2008

AT-Commands Users Manual (V3.1.1b)

3.27 AT+SETUARTGAP=XX
Function: Configure idle time gap between 2 UART frames. XX: UART idle time gap, HEX format, in ms. Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command. Note: The shorter the UART gap, the faster the UART frame be confirmed. The minimum value is 5ms. Setting value lower than 5 will be treated as 5ms.

3.28 AT+SETPRCSGAP=XX
Function: Configure process buffered UART frames cycle time. UART frames are buffered first and be processed later. If process the buffered frame too fast, the network will be too busy and may cause wireless data transfer failure, especially when there are many devices in same network. XX: Process time gap, HEX format, in ms. Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command. Note: The shorter the process gap, the faster the buffered frame will be processed. User should configured this value depend on network condition. The minimum value is 10ms. Setting value lower than 10 will be treated as 10ms.

3.29 AT+SETLKEY=XXXX
Function: Configure security link key.

(16bytes, 32 characters)

XXXX: 16-byte (128-bit) security key, HEX format. Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command.

3.30 AT+GETLKEY
Function: Returns security link key.
23 12/22/2008

AT-Commands Users Manual (V3.1.1b)

Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command.

3.31 AT+SETNKEY=XXXX
Function: Configure security network key.

(16bytes, 32 characters)

XXXX: 16-byte (128-bit) security key, HEX format. Device Type: Only COO supports this command.

3.32 AT+GETNKEY
Function: Returns security network key. Device Type: Only COO supports this command.

3.33 AT+RTOKEN
Function: Reset all the parameters to default value. Configurations of all parameters are stored in NV memory. Issuing this command will reset all the parameters to default values. Device Type: All of the 4 device types, COO, Router, Non-Routing-Router, and HHU support this command. Note: Default values are listed in table 1.

4. Known Limitations
4.1 Density of Routers
ZigBee network is mainly composed of Routers and NRRs. It is recommended a Router only has 4-8 Router neighbors. If there are too many Routers inside a Routers communication range, messages delivering will be blocked some time because every Router will repeat broadcast.

24

12/22/2008

AT-Commands Users Manual (V3.1.1b)

4.2 Serial Frame Gap


ZigBee device requires a 100ms gap between two serial frames. If the gap between 2 serial frames is too short, it is possible fail to transfer the frame to target device. See figure below:

Serial frame 1

100ms gap

Serial frame 2

4.3 Serial Frame Size


Serial frame size is limited to 300 bytes due to insufficient buffering RAM.

25

12/22/2008

AT-Commands Users Manual (V3.1.1b)

Appendix A: Contact Details


Holley Group Co., Ltd. Add1: No.8 Liansheng Rd. Wuchang, Yuhang District, Hangzhou, 310023, P.R.C Add2: 12E&15D, Tiantang Software Park, No.3 Xidoumen Rd., Hangzhou, 310012, P.R.C Tel: 86 571 88471702 Fax: 86 571 28116981 http:// www.holley.cn www.hornetone.com E-mail : Marketing@hornetone.com

26

12/22/2008