ZigBee Operator is a professional tool to learn, research, develop and test Digi’s ZigBee/XBee module. It implements both API encoder and decoder for Digi’s XBee & ZigBee Mesh and 802.15.4. Both AT and API commands are supported.
It’s only $141.29 from now to September 30, 2011.
It’s the lowest price for this year.
AO Command is for “API Options”. It query/configures options for API.
0 – Default receive API indicators enabled
1 – Explicit Rx data indicator API frame enabled (0×91)
3 – enable ZDO passthrough of ZDO requests to the UART which are not supported by the stack, as well as Simple_Desc_req, Active_EP_req, and Match_Desc_req.
To send AO command in ZigBee Operator, switch to XBee/XBee Pro ZB ZiBee Profile.
Input “AO” in command field and click “Send” button. It will query the value of AO.
Here are message in Log window.
Send:(21:59:47) 7E 00 04 08 01 41 4F 66
Data Parsed: 7E 00 04 08 01 41 4F 66
AT Command
Frame ID: 0×01
Command: AO
Para(Hex):
Para(Text):Rec:(21:59:47)7E 00 06 88 01 41 4F 00 00 E6
Data Parsed: 7E 00 06 88 01 41 4F 00 00 E6
AT Command Response
Frame ID: 1
Command: AO
Status: 0 = OK
Para: 00
To change the value of “AO”, input the value in “Parameters” field. The value are in hex.
Send:(22:00:55) 7E 00 05 08 01 41 4F 03 63
Data Parsed: 7E 00 05 08 01 41 4F 03 63
AT Command
Frame ID: 0×01
Command: AO
Para(Hex):03
Para(Text):Rec:(22:00:55)7E 00 05 88 01 41 4F 00 E6
Data Parsed: 7E 00 05 88 01 41 4F 00 E6
AT Command Response
Frame ID: 1
Command: AO
Status: 0 = OK
Para:
Tip
You can send a “WR” command to write the value to flash memory.
In ZigBee Operator, it is very easy to run AT command in API mode.
Here are the examples for run get firmware AT command “VR”.
In XBee/XBee-Pro ZB profile.
Steps:
Switch to XBee/XBee Pro ZB Profile.
Input ASCII characters “VR” in command field and click button “Send” will send the command.
Here is screenshot of the quick send panel.
Here is the message in log window.
Send:(21:25:54) 7E 00 04 08 01 56 52 4E
Data Parsed: 7E 00 04 08 01 56 52 4E
AT Command
Frame ID: 0×01
Command: VR
Para(Hex):
Para(Text):Rec:(21:25:54)7E 00 07 88 01 56 52 00 21 70 3D
Data Parsed: 7E 00 07 88 01 56 52 00 21 70 3D
AT Command Response
Frame ID: 1
Command: VR
Status: 0 = OK
Para: 21 70
ZigBee Operator will send a data frame to module. It starts with “7E” and “08” is the flag for AT command. The “0×56 0×52” are ASCII code for character “VR”. The command are not case sensitive. Both “VR” and “vr” works.
The module will send a “AT Command Response” data frame to ZigBee Operator. The last line “Para” is the command result. In this sample, it is “21 70”, means the firmware is 2170, the firmware for API Zigbee coordinator.
To run a command with a parameters, like “SN”command, which sets the number of sleep periods to not assert the On/Sleep pin on wakeup if no RF data is waiting for the end device. The default value for this command is 1. Send “SN” command without any parameter like example above will return the value.
Here are the message in Log window.
Send:(21:39:51) 7E 00 04 08 01 53 4E 55
Data Parsed: 7E 00 04 08 01 53 4E 55
AT Command
Frame ID: 0×01
Command: SN
Para(Hex):
Para(Text):Rec:(21:39:51)7E 00 07 88 01 53 4E 00 00 01 D4
Data Parsed: 7E 00 07 88 01 53 4E 00 00 01 D4
AT Command Response
Frame ID: 1
Command: SN
Status: 0 = OK
Para: 00 01
The value of SN is 1.
To set a value for SN, input the value in Parameters field. The value are in hex. Input “20” in parameters will set the value to 20.
Here are the message in Log window.
Send:(21:46:06) 7E 00 05 08 01 53 4E 20 35
Data Parsed: 7E 00 05 08 01 53 4E 20 35
AT Command
Frame ID: 0×01
Command: SN
Para(Hex):20
Para(Text):Rec:(21:46:06)7E 00 05 88 01 53 4E 00 D5
Data Parsed: 7E 00 05 88 01 53 4E 00 D5
AT Command Response
Frame ID: 1
Command: SN
Status: 0 = OK
Para:
It showed that command are run success.
Run “SN” command and leave parameters field blank will query the value of SN again.
Here are the message in Log window.
Send:(21:48:34) 7E 00 04 08 01 53 4E 55
Data Parsed: 7E 00 04 08 01 53 4E 55
AT Command
Frame ID: 0×01
Command: SN
Para(Hex):
Para(Text):Rec:(21:48:34)7E 00 07 88 01 53 4E 00 00 20 B5
Data Parsed: 7E 00 07 88 01 53 4E 00 00 20 B5
AT Command Response
Frame ID: 1
Command: SN
Status: 0 = OK
Para: 00 20
The value of SN is 20 now.
It is same for 802.15.4 devices, just switch to 802.15.4 profile and send command there.
Bee Explorer is a FREE tool to explorer all available ZigBee nodes in search range.
Features:
Product Page: http://www.zigbeeoperator.com
Download Link: http://www.zigbeeoperator.com/download/BeeExplorer.zip
ZigBee Operator support “Explicit Addressing ZigBee Command”. We can use Explicit Addressing ZigBee Command for link testing with API firmware.
Steps for Link Testing
Prepare the mesh network. The minimum requirement for a mesh network is a coordinator and an end device. We use a end device with API firmware.
Power on both coordinator and end devices. Connect the coordinator to the computer.
Open the ZigBee Operator and connect with serial port of XBee modules.
Go to “Tools-XBee Devices Properties” or “
” icon to open Properties window and check “API” check box. Click “Read” button to make sure the computer can talk to device correctly.
Go to “Tools->Search XBee Devices” or click “
”icon to open “Search Device” window and check “API Mode”. Click “Search Network” button to search the network to make sure the end device are connected with Coordinator.
Click “Add To Database” button to add all XBee modules’ information to database.
Close the search window.
Click “View->XBee & XBee Pro ZB ZigBee” or “
” icon to switch to “Mesh Network” panel.
Select “Explicit Addressing ZigBee Command” in type
Select Coordinator’s address in Address
Set “Cluster ID” to 12 and “Source Endpoint” to E8 and “Destination Endpoint” to E8.
Set “Profile ID” to C105
Select “TEXT” in format and input “Echo” in RF Data. It can be any text as long as it is not empty.
Click “Send” button.
It will send the data to coordinator endpoint E8 from source endpoint using cluster ID 12. This is setting for Loopback data. When coordinator received data from end point E8, it will send the data back.
Here is the data in log window.
Send:(09:03:46) 7E 00 18 11 01 00 13 A2 00 40 0A 2A 94 FF FE E8 E8 00 12 C1 05 00 00 45 63 68 6F 0C
Data Parsed: 7E 00 18 11 01 00 13 A2 00 40 0A 2A 94 FF FE E8 E8 00 12 C1 05 00 00 45 63 68 6F 0C
Explicit Addressing ZigBee Command
Frame ID: 0×01
64 Bits Address: 0013:A200-400A:2A94
16 Bits Network Address: FFFE
Source Endpoint: 0xE8
Destination Endpoint: 0xE8
Cluster ID: 0×0012
Profile ID: 0xC105
Broadcast Radius: 0×00
Options: 0×00
Data(Hex):45 63 68 6F
Data(Text):EchoRec:(09:03:47)7E 00 07 8B 01 85 BB 00 00 00 33 7E 00 10 90 00 13 A2 00 40 0A 2A 94 85 BB 41
Data Parsed: 7E 00 07 8B 01 85 BB 00 00 00 33
Transmit Status
Frame ID: 1
Network Address :0x85BB
Retries: 0×00
Delivery Status: 0×0 = Success
Discovery Status: 0×0 = No Discovery Overhead45 63 68 6F B2
Data Parsed: 7E 00 10 90 00 13 A2 00 40 0A 2A 94 85 BB 41 45 63 68 6F B2
ZigBee Receive Packet
64 Bits Address: 0013:A200-400A:2A94
16 Bits Network Address: 85BB
Options: 0×41
Packet Acknowledged
Data(Hex):45 63 68 6F
Data(Text):Echo
Sometimes, the data send won’t be echo back. Please keep sending until you get the data back. Some times you need reset the end devices.
To check the signal strength on the remote module.
Switch to “Remote AT Command”, and select the address of the remote module and send “DB” Command. It will return the signal strength of last hop.
Here is the data in log window.
Send:(09:04:51) 7E 00 0F 17 01 00 13 A2 00 40 0A 2A 94 FF FE 00 64 62 67
Data Parsed: 7E 00 0F 17 01 00 13 A2 00 40 0A 2A 94 FF FE 00 64 62 67
Remote AT Command
Frame ID: 0×01
64Bits Destination Address: 0013:A200-400A:2A94
16Bits Destination Network Address: FFFE
Command Options: 0×00
Command: db
Para(Hex):
Para(Text):Rec:(09:04:51)7E 00 10 97 01 00 13 A2 00 40 0A 2A 94 85 BB 64 62 00 24 80
Data Parsed: 7E 00 10 97 01 00 13 A2 00 40 0A 2A 94 85 BB 64 62 00 24 80
Remote AT Command Response
Frame ID: 0×01
64Bits Remote Module Address: 0013:A200-400A:2A94
16Bits Remote Module Network Address: 85BB
Command: db
Status: 0×00 = OK
Para: 24
The signal strength on remote module is 24.
To Check the signal strength on the local module.
Switch to “AT Command” and send “DB” command. It will return the strength of the last hop.
Here is the data in log window.
Send:(09:09:55) 7E 00 04 08 01 64 62 30
Data Parsed: 7E 00 04 08 01 64 62 30
AT Command
Frame ID: 0×01
Command: db
Para(Hex):
Para(Text):Rec:(09:09:55)7E 00 06 88 01 64 62 00 25 8B
Data Parsed: 7E 00 06 88 01 64 62 00 25 8B
AT Command Response
Frame ID: 1
Command: db
Status: 0 = OK
Para: 25
The signal strength of local module for last hop is 25.
We opened a new website for ZigBee Operator.
ZigBee Operator is a professional tool for Digi’s ZigBee/XBee module researching, learning, developing and testing. It implements both API coder and decoder for Digi’s XBee & ZigBee Mesh and 802.15.4. Both AT and API command are supported.
Features:
|
|
 |
|
|
Product Page: http://www.zigbeeoperator.com
Download link: http://www.zigbeeoperator.com/download/ZigBeeOperator.zip
E-Mail: zigbee@serialporttool.com
Updated on Nov 21, 2010.
We released the ZigBee Operator. The ZigBee Operator can create Digi’s ZigBee XBee and 802.15.4’s API package directly. Please check out ZigBee Operator.
Comm Operator 4.3 added a new quick send data panel, which is customized data panel. Customized quick send panel is designed for creating structured data. It supports both text data and binary data.
Structured data is also called as formatted data. It is widely used to store and transfer information. Most of the applications use structured data to transfer information through network and serial port. Most of structured data are in binary data, like data transferred through network. A lot of applications also use structured data in text format, like data from GPS module, and http protocol.
ZigBee module has two ways of communication, AT mode and API mode. AT mode is transparent mode, send data from one module to another just like two serial port connected directly. The remote end will received exactly what the local sends. API mode is different, it transfers data in formatted frame. The data will be formatted according the type. There are several advantage to use API mode, one most important advantage is that there is no need to enter command mode to change the destination address. That makes possible to switch destination quickly, as address of destination is included in the formatted data frame. The disadvantage is that extra work has to be done to create formatted data. In fact, although API mode is more powerful, most of zigbee application use AT mode as AT mode compile the traditional serial port application better.
With customized quick send panel, create formatted data for ZigBee API mode is much easier. It is almost just same as create data in AT mode. Let’s start with sending AT command in API mode.
Here is the API data frame of zigbee AT command
Each data frame is made of start delimiter, length, frame data and check sum.
The start delimiter is always 0x7E.
The length part has two bytes. The first byte is MSB(most significant byte) followed with LSB(least significant byte).
Then comes with Frame data. The length of frame data is variable, depends on command and parameters. It has two parts, command ID which is API identifier and cmdData which is identifier-specific data. The cmdData is made of Frame ID, AT Command and Parameter Value.
The last byte is check sum.
To send structured data in Comm Operator is create a template of customized data.
Here are steps.
Select [View]->[Customized Data] in Comm Operator to open Customzied Data quick send panel.
Click button[Edit] to open customized data editor.
Click [Delete All] to remove items.
Click [New] Add a new data field like below.
Click [New Var] to Add a field for length. We just create a variable field and will work on this later when all other fields are added.
Click [New] to add field for cmdID
Click [New] to add field for Frame ID
Click [New] to add field for AT Command
Click [New] to add field for parameter value
Click [New] to add field for checksum.
Select var “Length” in list and Click button [Edit"]. Select field cmdID and “Frame ID”, “AT Command”, and “Parameter Value” in fields list.
So far, we have created a templated for AT command API data frame.
For example, we want to get high bytes of zigbee modem address, the AT command is “SH”. To send command “SH”, we just input “SH” in “AT Command” Field. Then click “Send “ button.
Here is the API data been sent.
Send:(17:52:48) 7E 00 04 08 01 53 48 5B
The Start Delimiter is “7E”
The length is “00 4E”
The cmd ID is “08”
The Frame ID is “01”
The AT Command is “53 48”, which is ascii code of “SH” in hex
The Checksum is “5B”
To send other AT command, just change the content of field “AT Command” and Parameter Value, the data frame will be created by quick send panel and all variable will be calculated automatically. That make test with ZigBee API mode so easy!
Zigbee is a very cool technical. It makes point to point and point to multi point wireless communicate very easy. National Control Devices released ZR1x/ZR2x with Zigbee module. We will install Zigbee module in an electric outlet. It will be controlled by our timer software, Relay Timer R2x. The outlet can be Turn On/Off according the timers remotely.
ZigBee Outlet
Here are things we will use.
Materials
Car Power Adapter Outlet
Car Power Adapter Outlet
ZigBee One Relay Controller
ZigBee Modem
The voltage for ZR1x is 12v. We use two 5V mobile phone power adapter and connect them together to get 10v for ZR1x.
Two 5v mobile phone power adapter
Before we assemble the ZR1x with the outlet, we need configure and test the connection between ZigBee modem and ZR1x.
To make the two ZigBee modules talks to each other, they have to be in same protocol and using the same PAN ID. We will check Firmware version and destination of Zigbee module on ZR1x and Zigbee modem.
Let’s assume the Zigbee module on ZR1x named Z1 and Zigbee moduel on modem named Z2.
The default baudrate for setting of Z1 is 115200. The setting of Z2 is 9600. It is not necessary to set the same baudrate to Z1 and Z2. ZigBee module can talk in different baudrate. I’d like to change Z1 to 9600 so same configuration can work for both Z1 and Z2.
We will use Comm Operator for this.
Comm Operator v4.1 has plug-in for ZigBee. It is easy to test ZigBee application with it.
Put Z1 in modem board and connect it with computer.
Start Comm Operator, select the port that ZigBee modem used. The default setting for ZigBee modem is 115200, N, 8, 1
Open ZigBee Modem
Goto [Tool]->[XBee Device Properties] to confirm the setting of Zigbee modem.
Zigbee Modem Properties
Set the destination to Z2′s address. You can find the 64bits address from Zigbee module. It can also be get from properties window. Set the baudrate to 9600.
Click the “Write to Memory” to update. Exit the property window and change the setting to 9600, N, 8,1.
Enter property window again.
Click “Read” to verify.
Exit Comm Operator.
Unplug the ZigBee Modem and unmount the Z1 module. mount Z2 to Zigbee Modem board and run Comm Operator again. This time, set Z2′s destination to Z1′s address and write to memory of Z2. Exit Comm Operate after this.
Mount Z2 to ZR1x and Z1 to Zigbee modem.
Power ZR1x.
Start Comm Operator and switch to NCD panel by [View]->[NCD].
Send 254, 0 to turn off and 254 ,1 to turn on. The ZR1x should turn on/off. So far, we have make this two Zigbee module talk to each other.
The next step is test ZR1x from RelayTimer R2x. It can be download from here.
Install it and Run configuration, set com port and baudrate with same port and baudrate we used in Comm Operator.
Switch to manual mode and turn it On/Off manually.
So far we have made everything work together. The next steps is connect the power to ZR1x and put ZR1x and power circuit boards in to car power adapter’s enclosure.
Here is the car power outlet adapater we use.
Inside of APC power adapter
Let’s take everything out from it.
Take Everything Out
Connec the input 110 v power cable with ZR1x board. Then connect 12 v DC circuit board with 110 v power and Zigbee board.
Connect Parts Together
Drill a hold on side of car power adapter to fix the antenna.
Hole on side
We need to finish the bottom of circuit boards with insulation material to prevent them touch each other.
insulant material on bottom
Put three circuit boards into the outlet adapter.
Put Parts Together
Control it with Relay Timer R2x.
So far, we have a smart outlet that can be turned on/off automatically!
ZigBee Outlet
