EZBee series Manual / Ver. 1.0 -------------------------------------------------------------------------------------------------------------------------- EZBee series Manual 2008. 11.
EZBee series Manual / Ver. 1.0 -------------------------------------------------------------------------------------------------------------------------- CONTENTS Contents ............................................................................................................................................................................ 2 1. Products Overview .............................................................................................................................................
5. EZBee L100 ..................................................................................................................................................................18 5.1. Specificaion of EZBee L100 .................................................................................................................. 18 5.2. Configuration of EZBee L100 ............................................................................................................... 19 5.3. Network Setting ..............
7.2.5. Receiver ID setting for Bypass mode .................................................................................. 33 7.2.6. Automatic start mode setting ................................................................................................ 33 7.2.7. Starting EZBee network ............................................................................................................. 34 7.3. Network message transmission.......................................................................
8.3.2. EBI_TYPE_GROUP_MSG .............................................................................................................. 48 8.3.3. EBI_TYPE_BROAD_MSG............................................................................................................... 49 8.3.4. EBI_TYPE_ACK ................................................................................................................................. 49 8.3.5. EBI_TYPE_IO_REQ ........................................................
1. Products Overview EZBeeTM formats include OEM modules (M100), industrial serial adapters (S100), USB type serial adapters (U100), and internet access points (L100) for supporting various customers who need to get wireless solutions in industrial automation, medical automation, building automation, information technology, retail/ POS and so on. The EZBeeTM series is a 2.4GHz ISM band transceiver, based on the Chipcon CC2420 chip for IEEE 802.15.4.
customers for more flexible and effective communication. A specified own ID and an extended/ short address are assigned for each modem of EZBee formats. The specified own ID is used for pointing a data receiving modem in every data transmission modes.
2. EZBee M100 EZBee M100 based on IEEE 802.5.4 specification, is designed for an embedded solution to provide stable wireless communication with low power consumption. 2.1 Specification of EZBee M100 General Specifications Operating Frequency ISM 2.4 GHz ISM 2.4 GHz Dimension* 32.0mm(L) x 22.0mm(W) x 10.5mm(H) Operating Temperature -25 ~ 85º C Electrical Specifications Supply Voltage 2.7~3.6V Transmit Current(typical) 190mA Idle/Receive Current(typical) 27mA EZBee series Manual / Ver. 1.
2.
2.3 EZBee M100 Dimension Dimension* 2.4 EZBee M100 LED Display LED display ACT LED (blue colour) STA LED (orange colour) Flash when data are transmitted (Tx/Rx mode) When the device is not joined in PAN - Repeat Turning ON during 1 second and OFF during 1 second When the device is joined in PAN - In ASCII MODE : ON continuously In EBI MODE : Repeat flashing twice every 0.5 second and turning OFF during 0.5 second In BYPASS MODE : Repeat Turning ON during 0.5 second and OFF during 0.
3 EZBee S100 EZBee S100 is designed to communicate with other devices based on IEEE 802.5.4 specification without installing any serial cable. Two EZBee S100 serial adaptors are connected to each other immediately when power is supplied. If 38,400 baud rate is set for stable transmission, a pair of S100 is able to connect without any extra setting. 3.1 Specification of EZBee S100 General Specifications Voltage DC 4.5V~DC 5.
3.2 Configuration of EZBee S100 Configuration method for a serial adaptor can be divided for RS- 232 and RS- 422/ 485 communication mode. The baud rate of each communication mode is set by only DIP switches on the EZBee S100. 3.2.1 RSRS- 232 communication mode 1 Selection switch for 232 or 422/ 485 is pushed to the 232 side. 2 Flow control method and baud rate for serial communication are set by DIP switches. 3 EZBee S100 is connected to the serial port of a PC or DTE.
3.3 Dip switch setting ON 1 ► ► 2 3 4 DIP1 mode setting RS-232 mode RS-422/485 mode DIP1 ON Hardware Flow Control ON RS-422 DIP1 OFF Hardware Flow Control OFF RS-485 Baud rate setting Baud rate DIP2 DIP3 DIP4 38400 bps OFF OFF OFF 2400 bps OFF OFF ON 9600 bps OFF ON OFF 19200 bps OFF ON ON 38400 bps ON OFF OFF 57600 bps ON OFF ON 115K bps ON ON OFF 38400 bps ON ON ON EZBee series Manual / Ver. 1.
► DSUB 9 Pin Definition 5 4 9 Pin Number RS-232 1 DCD 2 3 8 2 7 1 6 RS-422 RS-485 TXD RXD- TXD-/RXD- 3 RXD TXD- 4 DTS 5 GND 6 DTR 7 CTS RXD+ 8 RTS TXD+ TXD+/RXD+ 9 DC Input DC Input DC Input 3.
4 EZBee U100 EZBee U100, a dongle type EZBee format, makes it easy monitor and control the devices on a PC or hand- held device. In addition, it can be utilized as a router for IEEE 802.15.4 network for extending communication range or overcoming weak signal strength in certain area. 4.1 Specification of EZBee U100 General Specifications Voltage DC 4.5V~DC 5.5V (mini usb type jack) Hardware interface USB 2.
4.2 Configuration of EZBee U100 1 To use the EZBee U100 on a PC, a USB port connecting U100 should be set as a virtual conventional COM port in the PC. 2 For virtual COM port setting, the FTDI driver should be installed on PC by running the CDM 2.04.06 on the enclosed CD. Suporting OS : Window, MAC, Linux 3 The FTDI driver is installed automatically as shown. EZBee series Manual / Ver. 1.
4 After virtual COM port setting, please find the COM port number at port (COM or LPT) of device manager. 4.3 EZBee U100 LED display LED display ACT LED (blue colour) STA LED (orange colour) Flash when data are transmitted (Tx/Rx mode) When the device is not joined in PAN - Repeat Turning ON during 1 second and OFF during 1 second When the device is joined in PAN - In ASCII MODE : ON continuously In EBI MODE : Repeat flashing twice every 0.5 second and turning OFF during 0.
5 EZBee L100 EZBee L100 acts as a bridge between the devices based on IEEE 802.5.4 network and conventional TCP/ IP network. When sensor data are collected through wireless network, EZBee L100 provides the sensor data into the TCP/ IP network enables user to monitor the process. 5.1 Specification of EZBee L100 General Specifications Voltage DC 4.5V~DC 5.
5.2 Configuration of EZBee L100 Firstly a LAN connector for TCP/ IP network should be connected to a LAN port prepared on EZBee L100. For the power supply, please connect a mini USB cable protruded from a PC USB port or DC adaptor into the mini USB port on EZBee L100. 5.3 Network Setting Initial setting IP 172.17.52.164 Netmask 0.0.0.0 Gateway 0.0.0.0 default password enus 5.3.1 Using web browser 1 Connect to http:/ / 172.17.52.164 on web browser.
to default IP. 2 Type enus as the default password 3 After set your network IP at [ TCP/ IP configuration ] , reboot the EZBee L100. EZBee series Manual / Ver. 1.
5.3.2 Using EZBee manager program The EZBee manager program is an utility program developed for easy setting and management of a EZBee L100. Useful function for setting : The useful function of the EZBee manager program is a scanning broadcasting device. It searches and shows all list of EZBee L100 connecting to the same network of a user computer. 1 Click the button denoting [start search].
5.4 Menu related to communication of EZBee L100 Status Monitoring Port configuration Shows current status of the EZBee L100 Set operation of the EZBee L100 - Active connection : EZBEE L100 acts as a client of TCP/IP network, and tries to connect to a designated server. - client connecting time (period) : When a port is assigned as TCP/IP client, the assigned port tries to connect to the specified host IP by the period of client connecting time.
Configuration 5.5 Communication modes of EZBee L100 EZBee- L100 supports the TCP/ IP socket programming. It can be assigned as a client or server according to each ports and handles data as unit of packet. The packet format is selectable among the EBI mode, P- P(Peer to Peer, Bypass mode), according to the port. The default setting is the EBI mode, enables to communicate any modules connecting to same socket.
6. AT Command The EZBee formats support various AT commands for controlling the modem. Customers can configure the desired characteristics of a specific network using the rich AT commands 6.
= +PID Set Get/Set PAN ID +GID Set Get/Set Group ID +AS Set Get/Set Network auto start/Join +PMJ System Permit join +SA? System Show 16-bit short address +IO System Access GPIO ?/= +IOD System Access GPIO direction ?/= +ADC? System Query ADC value +RA System Permit remote access &MSG Network Send Message &PS Network Start/Join PAN manually 6.
6.3 Result message Every modem of EZBee formats returns a resulting message after executing the AT command as following: Message OK Description Denotes execution of AT command is success ERROR Means an undefined AT command or un-allowed parameter is inputted FAIL Display an internal error is generated during execution of AT command NO_MEM Shows shortage of memory space for execution of AT command EZBee series Manual / Ver. 1.
7 Description of AT commands 7.1 Serial communication interface 7.1.1 Serial port setting EZBee formats support a standard serial communication port (RS232C). The basic setting parameters for a serial communication of the EZBee are shown as followings. parameters Baud rate 38400 Data 8-bit Parity None Stop bit 1-bit Flow control H/W flow control ON The setting parameters of the EZBee can be changed using the following AT commands.
The possible values for each parameter are summarized as: Parameter baud value description 2400, 9600, 19200, 38400, 57600, 115200 flow Baudrate possible to use 0 No Hardware follow control 1 Use hardware follow control When a very high baudrate is set, the data transmitted can be lost because the I/ O buffer size of EZBee is 128 byte each. recommended to use a hardware follow control.
7.2 EZBee Modem setting In order to communicate using the EZBees, each EZBees should be joined in PAN (personal area network). All EZBees in a specific PAN should have an identical channel ID and PAN ID. If the channel IDs are identical but different PAN IDs, then the EZBee belongs to other PAN. Further, if the PAN IDs are identical but different channel IDs, then the EZBee also belongs to other network. Only one coordinator is allowed in a specific PAN. 7.2.
of routers should be changed as that of coordinator. When you select a channel number, check the overlapping with other wireless devices in the vicinity of the EZBee to avoid interference between channels. The frequency of each channel is assigned as following. 7.2.
If the EZBee is already joined in PAN using AT&PS command, it should be rebooted after setting a PAN ID for the effectiveness of PAN ID setting. 7.2.3 Modem ID setting Each modem embedded in EZBee formats has the own 64bit address, called as an extended address, and it is used to identify a specific modem among various modems in PAN. However, the extended address is difficult to use due to its big size. The short- address is mostly used in real practical communication.
If the characteristics of a coordinator is changed or the other modem is assigned as a coordinator in PAN already established, all modems in a PAN should be reset to erase network states using ‘ ATNZ’ ATNZ and rebooted. In case of the ID command for a remote modem ‘ $ID@’, means a short- address and display as ASCII- HEX format. When the ID command for a remote modem is conducted successfully, the following return message is returned. Message Description $ID@= 7.2.
When the group ID command for a remote modem is conducted successfully, the following return message is returned. Message Description $GID@= Group ID < GroupID> setting in a remote modem 7.2.5 Receiver ID setting for Bypass mode The EZBee formats supports the bypass mode communication which all data are collected by a specified modem as if all modem in a network is wired to a specified modem.
Command Parameter Result AT+AS? None 0 or 1 0 OK Cancel a automatic start mode 1 OK Activate a automatic start mode AT+AS= 7.2.7 Description Show a current automatic start mode Starting EZBee network In case of setting a modem for the first time or turning a automatic start mode off, a following command initiates a PAN. A coordinator establishes the PAN and routers try to join the PAN.
7.3 Network message transmission The EZBee formats support 3 different communication mode including ASCII mode, Bypass mode and EBI mode for data transmission. 7.3.1 Data transmission in ASCII mode In ASCII mode, all data are transmitted as ASCII HEX format to a pointed modem.
In here, means the transaction ID which is generated by a modem automatically after finishing the transmission, thereby every transmission generates different transaction IDs. shows the result of data transmission. If transmission is succeeded, it shows as 1, if failed, number except 1. Besides, if a modem is not joined in the PAN yet, or the format of transmission message is wrong, following error messages may be returned.
mode. A modem 1 sends a message (0x13F7E53) to a modem 2. The modem 2 received data from a sender having the ID=1, the shortaddress=0x0001. The receiving sensitivity is 134 and the received message is 0x13F7E536. While, a modem 2 sends the message(0x55AA7038) to a modem 1. The received data by a modem 1 is shown as 0x55AA7038 with a receiving sensitivity 120. 7.3.
Command Parameter ATD Result OK/ERROR/FA IL/NO_MEM /NWK_STOP ? = OK /ERROR None OK AT+DST +++ Description Convert from ASCII mode to Bypass mode Read a receiver ID of the Bypass mode Set a receiver ID of the Bypass mode Convert from Bypass mode to ASCII mode In Bypass mode, all data are transmitted to the assigned receiving modem.
It is not necessary the receiver and sender have been set as same communication mode. The communication mode is selected according to the operating environment. If a sender is set as Bypass mode and a receiver as ASCII mode, and the sender sends a long message, the receiver can receive the message as divided length of messages due to the size of internal buffer or transmission delay.
7.4 Reading a ShortShort- address A 16 bit short- address assigned during the process of joining in the PAN can be obtained by utilizing following AT commands. A short- address is mainly used in practical communication instead of an extended address.
Command Parameter Result AT+EA? None AT+EA@ ? OK/ERROR/NWK _STOP Description Read an extended address of a current modem. Read an extended address of a remote modem having In case of a remote modem, it returns a following message when a message transmission is succeeded. Message Parameter $EA@ = 7.6 Description Show an extended address of a remote modem . Resetting a Modem The command for modem resetting is shown as following.
7.8 Reading a modem version It is checked the firmware version of a modem using following AT command. Command Parameter ATV None 7.9 Result Description EZB300FV1.0 EZBEE300 FFD version 1.0 EZB300RV1.0 EZBEE300 RFD version 1.0 Reading a modem status It is checked the current status of a modem using following AT command.
7.10.1 GPIO direction setting The GPIO direction of a local or remote modem can be set by utilizing following AT commands. Command Parameter Result AT+IOD? None AT+IOD= ? OK AT+IOD@ = Description Read the GPIO direction of a local modem Set the GPIO direction of a local modem Read the GPIO direction of a remote modem. Set the GPIO direction of a remote modem The format of GPIO is shown as following.
7.10.2 GPIO control For control or monitor GPIO of a local or remote modem, following AT commands are utilized. Command Parameter Result AT+IO? None AT+IO= AT+IO@ ? OK AT+IO@ = OK Description Read the GPIO status value of a local modem Set the GPIO status value of a local modem Read the GPIO status value of a remote modem Set the GPIO status value of a remote modem The format of GPIO is shown as following.
7.10.3 ADC reading The status value of a local or remote modem can be checked by following AT commands. Command Parameter Result AT+ADC? None < CH1>, AT+ADC@ ? OK Description Read the ADC status value of a local modem Read the ADC status value of a remote modem The ADCs in EZBee modem are 2 channels having 10 bit resolution, and operated based on 3.3V reference voltage. The status value of the ADC is expressed as ASCII HEX format. For example, if 1.25V and 2.
Command AT+RA? Parameter Result None 1/0 1 AT+RA= Description Check the current allowance assigned Allow a remote control. OK 0 Does not allow a remote control 7.12 PAN joining allowance setting The allowance for joining in PAN is selectable. The EZBee formats can set a parameter which is a decision value for other modem to join in the PAN via a local modem.
8 EBI Commands 8.1 EBI mode overview To provide more flexible communication method in EZBee formats, the EBI (EZBee Binary Interface) communication mode is developed. mode, the receiving modem can be assigned. In EBI Furthermore, the data are transmitted to a specific group modems or to all modems in a PAN. Following AT command is useful to enter EBI mode from ASCII mode. Command Parameter Result ATB None OK 8.
8.3 EBI packet type The packet type and its meanings are summarized as following.
Direction send/receive Data length Variable data length ID sender/receiver modem group ID 8.3.3 EBI_TYPE_BROAD_MSG Description Sending/receiving broadcast data in the PAN Direction send/receive Data length Variable data length ID Broadcast ID (0xFF) 8.3.
EBI_TYPE_ACK packet always returns ‘ success’ for the broadcast or group message transmission. In unicast message transmission, if a short- address of a receiver modem ID does not exist, the data are transmitted as a broadcast message in order to fix the short- address problem. Accordingly, even the modem having identical modem ID with a receiver does not exist in the PAN, the transmission result can be returned as ‘ success’ . 8.3.
Data length and parameter: parameter: Value 0x00~0xFF 8.3.7 Description Show the GPIO status value of a local or remote modem EBI_TYPE_IOD_REQ Description Set a GPIO input/output mode, or request a current setting value of a local or remote modem send 0 or 1 A local or remote modem ID Direction Data length ID Data length and parameter: Data length Parameter 0 None 1 0x00~0xFF 8.3.
8.3.9 Description Direction Data length ID EBI_TYPE_ADC_REQ Request the ADC status value of a local or remote send 0 A local or remote modem ID 8.3.10 Description Direction Data length ID EBI_TYPE_ADC_ACK Response according to EBI_TYPE_ADC_REQ receive 4 A local or remote modem ID Data format: format: Channel-1 value Channel-2 value 2 byte 2 byte 8.3.
Appendix How to use EZBee M100 1. Setting Serial Port 1 2 Install the ‘ FTDI USB to Serial’ driver on a user PC. Connect a EZBee M100 to the user PC. 3 After running a terminal emulator such as Hyper Terminal or Tera Term, set the parameters as followings. ※ Displaying parameters may be different from the PC environment. 4 If “OK” OK” message is displayed on the terminal when “AT” AT” command is typed, the EZBee M100 is installed successfully to a serial port. EZBee series Manual / Ver. 1.
2. Start PAN Network For starting a PAN, type the AT commands related to a module ID, PAN ID and channel number as shown in the following figure. The module ID should be 0 for a coordinator setting. Finally type “ AT&PS” AT&PS” to start the PAN. If the PAN is started successfully, “ $NWK=COORD ” displayed. message is It means the EZBee M100 connected to a serial port is assigned as a coordinator in the PAN. The PAN ID and channel number can be assigned differently as user‘ s wish.
3. Joining the PAN After running another terminal emulator, set the serial port and EZBee M100 as shown in 1 and 2 steps above. Then, type the AT commands related to a module ID, PAN ID and channel number. except ‘ 0’ . In this moment, the module ID can be any number However, a PAN ID and channel number should be same numbers as coordinator setting for joining in the PAN established already. Finally type “AT&PS” AT&PS” for a new EZBee M100 to join in the PAN.
coordinator. In this example, a short- address of EZBEE module is assigned as 0001(hexadecimal). 0001 Now, we call this terminal as a Router Terminal, and the EZBee M100 connected to the coordinator terminal as a Router Module. 4. Testing message transmission in ASCII mode To transmit a message in ASCII mode, type a following command on a coordinator terminal. “AT&MSG=, , ” ” AT&MSG= In here, DstID and Msg mean a receiver ID and a sending message, respectively.
is returned. In here, Transaction ID ‘ 0’ is returned as shown in second line of above example. Furthermore, an event message related to the transmission result is displayed as “$SND=, , ” ”. $SND= means a Transaction ID, 0 in this example, and shows the transmission result, 0 in this example means the transmission is succeeded. If failed, non- zero value is shown as .
where, is a sender ID, is a short- address of sender, means a receiving sensitivity, and means the received message having same ASCII Hexadecimal format as sending message In this example, is 0, and it means a sender is a coordinator. is 0000. 0000 It shows that the short- address of the coordinator is always 0000. is 218. 218 The value of receiving sensitivity is between 0 and 255. Finally, is 3030303030303030.
When the command is completed successfully, the event message related to the message arrival is shown on a coordinator terminal. EZBee series Manual / Ver. 1.
5. Testing message transmission in Bypass mode 1) Enter “ATD 1” 1” command on a coordinator terminal, and “ATD 0” 0” on a router terminal. 2) Type any keys on one terminal, and verify successful data transmission on the other terminal. 3) To end Bypass mode, enter “+++” +++” on each terminals. 6. Testing Input/ output function of EZBee M100 EZBee M100 supports total 8 ports of GPIO from DIO0 through DIO7 which are set or controlled by a local or remote modem of EZBee.
Next, enter “AT+IO?” AT+IO?” command in order to read the input value of a current I/ O ports. The return value is “BF” BF”, it is interpreted that DIO6 is 0, the others are all 1. During pushing DIO3 of a coordinator module, enter “ AT+IO?” AT+IO? ” on coordinator terminal again. EZBee series Manual / Ver. 1.
The return value is changed to “B7” B7”. It means the input of DIO3 is changed from 1 to 0. Now, enter “ AT+IOD=FF” AT+IOD=FF ” command on a coordinator terminal. The GPIO I/ O direction is changed, thereby all ports acts as output ports. If command is completed successfully, the direction value of input/ output is displayed as shown in a figure. EZBee series Manual / Ver. 1.
In this moment, enter “AT+IO=00” AT+IO=00” command again. You can see that DIO0 and DIO1 LED in the coordinator module are turning ON. Using similar philosophy, the GPIO of a remote modem is able to set and control. EZBee series Manual / Ver. 1.
Enter “ AT+IOD@1? ” command on a coordinator and read GPIO input/ output status. When the command is completed successfully, the response message, “ $IOD@1=00” $IOD@1=00 ” is displayed, which means all GPIO of a router is set as inputs. To read GPIO input status value of a router module, enter “AT+IO@1?” AT+IO@1?” on a coordinator terminal. If the command is completed successfully, the response message such as “$IO@1=BF” $IO@1=BF” is outputted.
Enter “AT+IO@1?” AT+IO@1?” on a coordinator terminal while the button of DIO3 is pushed. When the command is completed successfully, “ $IO@1=B7” $IO@1=B7 ” message is outputted, and it means the input value of DIO3 is changed to 0. EZBee series Manual / Ver. 1.
7. Testing ADC of EZBee M100 EZBee- M100 provides 2 channel ADC having 10- bit resolution and is possible to read the ADC value of a local or remote modem. Enter “ AT+ADC?” AT+ADC?” command for reading ADC value of a coordinator module. When the command is completed successfully, the value of “,, ” are displayed as shown in above figure. In this example, the channel values of ADC are 008B for and 0000 for . In similar manner, the ADC value of a remote modem is able to read.
When the command is completed successfully, the result message such as “$ADC@= = ,, ” ” is displayed. $ADC@ In here, is a remote modem ID, and means the ADC channel value of each modem. In this example, is 1, and are 0000 and 0000, 0000 respectively. ※ The usage of EZBee U100 and EZBee L100 is same as EZBee M100.
FCC Information This device complies with Part 15 of the FCC Results. Operation is subject to the following two conditions : (1) This Device may not cause harmful interface, and (2) This Device must accept any interference received, including interference that may cause undesired operation. Note : This equipment has been tested and found to comply with the limits for CLASS B digital device, pursuant to Part 15 FCC Rules.