XBee® Wi-Fi RF Module WiFi RF Modules by Digi International Firmware version: 200x 11001 Bren Road East Minnetonka, MN 55343 877 912-3444 or 952 912-3444 http://www.digi.
XBee® Wi-Fi RF Modules © 2012 Digi International, Inc. All rights reserved No part of the contents of this manual may be transmitted or reproduced in any form or by any means without the written permission of Digi International, Inc. XBee® is a registered trademark of Digi International, Inc. Technical Support Phone: (866) 765-9885 toll-free U.S.A. & Canada (801) 765-9885 Worldwide 8:00 am - 5:00 pm [U.S. Mountain Time] Online Support: http://www.digi.com/support/eservice/login.jsp rf-experts@digi.
XBee® Wi-Fi RF Modules Contents XBee® Wi-Fi RF Module .......................................................................................................................... 1 1.Overview.............................................................................................................................................. 7 Specifications ...................................................................................................................................... 7 General Specifications ..
XBee® Wi-Fi RF Modules Configuration Mode ......................................................................................................................... 29 Forcing Entry into Configuration Mode ........................................................................................ 29 Using X-CTU to Enter Configuration Mode................................................................................... 30 Sleep Mode..............................................................................
XBee® Wi-Fi RF Modules I/O Examples................................................................................................................................. 49 General Purpose Flash Memory ....................................................................................................... 49 Accessing General Purpose Flash Memory .................................................................................. 50 Working with Flash Memory ........................................................
XBee® Wi-Fi RF Modules I/O Settings ....................................................................................................................................... 80 Diagnostics Interfacing ..................................................................................................................... 83 AT Command Options ...................................................................................................................... 84 Sleep Commands ...................................
XBee® Wi-Fi RF Modules 1.Overview The XBee® Wi-Fi RF module provides wireless connectivity to end-point devices in 802.11 bgn networks. Using the 802.11 feature set, these modules are interoperable with other 802.11 bgn devices, including devices from other vendors. With XBee, users can have their 802.11 bgn network up-and running in a matter of minutes. The XBee® Wi-Fi modules are compatible with other devices that use 802.11 bgn technology. These include Digi external 802.
XBee® Wi-Fi RF Modules RF Data Rates RF Data Rates Standard Data rates (Mbps) 802.11b 1, 2, 5.5, 11 802.11g 6, 9, 12, 18, 24, 36, 48, 54 Data rates (Mbps) Standard 802.11n © 2012 Digi International, Inc. MCS index 800 ns guard interval 400 ns guard interval 0 6.5 7.22 1 13 14.44 2 19.5 21.67 3 26 28.89 4 39 43.33 5 52 57.78 6 58.5 65 7 65 72.
XBee® Wi-Fi RF Modules Receiver Sensitivity Standard 802.11b 802.11g 802.11n © 2012 Digi International, Inc. Receiver Sensitivity (25 ℃, < 10% PER) Data rate Sensitivity (dBm) 1 Mbps -93 2 Mbps -91 5.5 Mbps -90 11 Mbps -87 6 Mbps -91 9 Mbps -89 12 Mbps -88 18 Mbps -86 24 Mbps -83 36 Mbps -80 48 Mbps -76 54 Mbps -74 MCS 0 6.5/7.22 Mbps -91 MCS 1 13/14.44 Mbps -88 MCS 2 19.5/21.67 Mbps -85 MCS 3 26/28.89 Mbps -82 MCS 4 39/43.33 Mbps -78 MCS 5 52/57.
XBee® Wi-Fi RF Modules RF Transmit Power - Typical RF Transmit Power (Average) Standard Data rate Power (dBm) North America Europe 1 Mbps 802.11b 2 Mbps 5.5 Mbps 11 Mbps 16 15 36 Mbps 16 15 48 Mbps 14 14 54 Mbps 14 14 MCS 5 52/57.78 Mbps 15 15 MCS 6 58.5/65 Mbps 14 14 MCS 7 65/72.22 Mbps 8.5 8.5 6 Mbps 9 Mbps 12 Mbps 802.11g 18 Mbps 24 Mbps MCS 0 6.5/7.22 Mbps MCS 1 13/14.44 Mbps MCS 2 19.5/21.67 Mbps 802.11n MCS 3 26/28.89 Mbps MCS 4 39/43.
XBee® Wi-Fi RF Modules EVM – Typical, Maximum Output Power Standard 802.11b 802.11g 802.11n © 2012 Digi International, Inc. EVM (25 ℃, max output power) Data rate EVM (dB) 1 Mbps -40 2 Mbps -40 5.5 Mbps -36 11 Mbps -38 6 Mbps -23 9 Mbps -23 12 Mbps -23 18 Mbps -23 24 Mbps -23 36 Mbps -23 48 Mbps -26 54 Mbps -26 MCS 0 6.5/7.22 Mbps -24 MCS 1 13/14.44 Mbps -24 MCS 2 19.5/21.67 Mbps -24 MCS 3 26/28.89 Mbps -25 MCS 4 39/43.33 Mbps -25 MCS 5 52/57.78 Mbps -25 MCS 6 58.
XBee® Wi-Fi RF Modules Electrical Specifications Specification XBee Wi-Fi 3.14 - 3.46 VDC Supply Voltage 1 Mbps 2 Mbps 5.5 Mbps 11 Mbps 6 Mbps 9 Mbps 12 Mbps 18 Mbps 24 Mbps 36 Mbps 48 Mbps 54 Mbps MCS 0 6.5/7.22 Mbps MCS 1 13/14.44 Mbps MCS 2 19.5/21.67 Mbps MCS 3 26/28.89 Mbps MCS 4 39/43.33 Mbps MCS 5 52/57.78 Mbps MCS 6 58.5/65 Mbps MCS 7 65/72.22 Mbps 802.11b 802.11g Operating Current (transmit, max output power) 802.
XBee® Wi-Fi RF Modules SPI Specification XBee Wi-Fi Through-hole XBee Wi-Fi Surface Mount SPI Pins Module Pin Number Module Pin Number DIO2/SPI_SCLK 18 14 DIO3/SPI_nSSEL 17 15 DIO4/SPI_MOSI 11 16 DIO12/SPI_MISO 4 17 DIO1/SPI_nATTN 19 12 For more information on SPI operation see the SPI section in chapter 2. GPIO Specifications The XBee Wi-Fi modules have 14 GPIO (General Purpose Input Output) ports available.
XBee® Wi-Fi RF Modules Agency Approvals Specification United States (FCC Part 15.247) Industry Canada (IC) XBee Wi-Fi Through-hole XBee Wi-Fi Surface Mount FCC ID: MCQ-XBS6B FCC ID: MCQ-S6BSM IC: 1846A-XBS6B IC: 1846A-S6BSM Europe (DC) ETSI ETSI Australia Pending Pending Brazil Pending Pending Japan Pending Pending FCC Approval (USA) Refer to Chapter 12 FCC Requirements. Systems that contain XBee Wi-Fi modules inherit Digi Certifications.
XBee® Wi-Fi RF Modules Pin Assignment for the XBee Wi-Fi Surface Mount module (Low‐asserted signals are distinguished with a lower case n before the signal name.
XBee® Wi-Fi RF Modules Poor power supply can lead to poor radio performance, especially if the supply voltage is not kept within tolerance or is excessively noisy. To help reduce noise, a 1µF and 8.2pF capacitor are recommended to be placed as near to pin 1 on the PCB as possible. If using a switching regulator for your power supply, switching frequencies above 500 kHz are preferred. Power supply ripple should be limited to a maximum 50mV peak to peak.
XBee® Wi-Fi RF Modules Antennas should reside above or away from any metal objects like batteries, tall electrolytic capacitors or metal enclosures. Antenna elements radiate perpendicular to the direction they point. Thus a vertical antenna emits across the horizon. PCB Antennas should not have any ground planes or metal objects above or below the module at the antenna location. For best results, the module should be in a plastic enclosure instead of a metal one.
XBee® Wi-Fi RF Modules © 2012 Digi International, Inc.
XBee® Wi-Fi RF Modules Mounting Considerations – Xbee Wi-Fi Through-hole XBee Through-hole modules were designed to mount into a receptacle (socket) and therefore do not require any soldering when mounting to a board. XBee interface boards provided in XBee Wi-Fi Development Kits have two ten pin receptacles for connecting the module. The receptacles used on Digi development boards are manufactured by Century Interconnect.
XBee® Wi-Fi RF Modules 2. RF Module Operation Serial Communications The XBee RF Modules interface to a host device through a logic-level asynchronous serial port, or a Serial Peripheral Interface (SPI) port. Through its serial ports, the module can communicate with any logic and voltage compatible UART or SPI; or through a level translator to any serial device (for example: through a RS-232 or USB interface board).
XBee® Wi-Fi RF Modules Serial communications depend on the two UARTs (the microcontroller's and the RF module's) to be configured with compatible settings (baud rate, parity, start bits, stop bits, data bits). The UART baud rate, parity, and stop bits settings on the XBee module can be configured with the BD, NB, and SB commands respectively. See the command table in chapter 10 for details.
XBee® Wi-Fi RF Modules SPI mode is chip to chip communication. Digi does not supply SPI communication option on the Device Development Evaluation Boards. SPI mode can be forced by holding DIO13/DOUT (pin 2) low while resetting the module until SPI_nATTN asserts. By this means, the XBee Wi-Fi module will disable the UART and go straight into SPI communication mode. Once configuration is completed, a modem status frame is queued by the module to the SPI port which will cause the SPI_nATTN line to assert.
XBee® Wi-Fi RF Modules Serial Buffers The XBee modules maintain buffers to collect received serial and RF data, which is illustrated in the figure below. The serial receive buffer collects incoming serial characters and holds them until they can be processed. The serial transmit buffer collects data that is received via the RF link that will be transmitted out the UART or SPI port.
XBee® Wi-Fi RF Modules UART Flow Control The nRTS and nCTS module pins can be used to provide RTS and/or CTS flow control. CTS flow control provides an indication to the host to stop sending serial data to the module. RTS flow control allows the host to signal the module to not send data in the serial transmit buffer out the UART. RTS and CTS flow control are enabled using the D6 and D7 commands.
XBee® Wi-Fi RF Modules Serial Interface Protocols The XBee modules support both transparent and API (Application Programming Interface) serial interfaces. Transparent Operation When operating in transparent mode, the modules act as a serial line replacement. All UART data received is queued up for RF transmission. When RF data is received, the data is sent out through the UART. The module configuration parameters are configured using the AT command mode interface.
XBee® Wi-Fi RF Modules The API provides an alternative means of configuring modules and of routing data at the local host application layer. A local host application can send data frames to the module that contain address and payload information instead of using command mode to modify addresses. The module will send data frames to the application containing status packets; as well as source, and payload information from received data packets.
XBee® Wi-Fi RF Modules Modes of Operation Idle Mode When not receiving or transmitting data, the RF module is in Idle Mode.
XBee® Wi-Fi RF Modules NOTE: Failure to enter AT Command Mode is most commonly due to baud rate mismatch. By default, the BD (Baud Rate) parameter = 3 (9600 bps). To Send AT Commands, send AT commands and parameters using the syntax shown below: To read a parameter value stored in the RF module’s register, omit the parameter field. The preceding example would change the RF module baud rate to 7, which would allow operation at 115,200bps.
XBee® Wi-Fi RF Modules Configuration Mode The user may not always know the parameters with which the XBee module is configured. If those parameters affect the means by which command mode is entered (and the parameters were previously written to non-volatile memory), then command mode is not available to either read the parameters or to set them to known values. This makes configuration of the XBee difficult unless the user can successfully guess the configuration to allow entry into command mode.
XBee® Wi-Fi RF Modules Using X-CTU to Enter Configuration Mode X-CTU is designed to support a forced configuration on a UART interface following the steps below. (Currently, X-CTU will not work over a SPI interface directly.) 1. Connect an asynchronous serial port of the PC (either RS-232 or USB) to the development board into which the XBee module is plugged. 2. Start X-CTU and go to the PC settings tab. 3.
XBee® Wi-Fi RF Modules 3. 802.11 bgn Networks Infrastructure Networks The main type of wireless network will involve a number of wireless devices (called stations) talking through a master wireless device known as an Access Point (AP for short). This type of setup is called an Infrastructure or BSS (Basic Service Set) network. Most wireless networks are of this type.
XBee® Wi-Fi RF Modules Note that ad hoc networks are point to point and that there can only be two nodes in the network, a creator and a joiner. Set up the creator first, and then the joiner. Ad Hoc Creator Set up the following parameters for the creator: • AH1 designates the node as an Ad hoc creator. • MA1 specifies static IP addresses. (No DHCP is supported in Ad Hoc mode.) • EE0 specifies no security. (Security is not available in Ad Hoc mode.) • CH may be any channel from 1 to 0xB.
XBee® Wi-Fi RF Modules XBee® Wi-Fi Standards The XBee Wi-Fi module will operate in three of the available 802.11 standards. 802.11 b The 802.11b standard was approved in July 1999 and can be considered the second generation. 802.11b operates in the 2.4 GHz frequency ISM band. The data rate is from 1 to 11 Mbps. 802.11 g The 802.11g standard was approved in 2003. It provides a maximum data rate of 54 Mbps. In addition, the standard is also fully backwards-compatible with existing 802.
XBee® Wi-Fi RF Modules The center frequencies of the 14 possible channels range from 2.412 GHz to 2.484 GHz, with each channel being 22 MHz wide and centered in 5 MHz intervals. This means that only 3 channels (1, 6, and 11) in North America are not subject to overlapping. © 2012 Digi International, Inc.
XBee® Wi-Fi RF Modules 4. XBee IP Services The XBee provides services using IP (Internet Protocol) for XBee and other clients on the network. IP services provide functionality to allow XBee configuration and direct serial port access. There are two XBee services: • • XBee Application Service Serial Communication Service XBee Application Service This service primarily provides for XBee configuration. It also provides API compatibility for customers who have designed around other XBees.
XBee® Wi-Fi RF Modules Transmitting Data The local host uses the TX64 frame to send data to another XBee using this service. When the frame is received through the serial port the XBee converts the contents of the frame to a serial data transfer command as defined by the XBee application service. Receiving Data A received Serial data transfer command will go to the serial port. The mode of the serial port will determine the format of the data.
XBee® Wi-Fi RF Modules Sending Configuration Commands AT commands can be sent to the XBee Wi-Fi module from a network client.
XBee® Wi-Fi RF Modules Sending Serial Data Command to XBee Using this service to send data out the serial port is not required. Most users will choose to use the Serial Communication Service (see below) for sending data from a network client. One reason to use the XBee Application Service to send the serial data command from a network client is to receive an acknowledgment when sending a UDP packet.
XBee® Wi-Fi RF Modules Frame Fields Application Header Offset Example Number1 0 0x4242 Number2 2 0x0000 Packet ID 4 0x00 Encryption Pad 5 0x00 Command ID 6 0x04 Indicates I/O Sample data Command Options 7 0x00 Options not available for this response Number Samples Digital Mask Command Specific Data Analog Mask Digital Sample Analog Sample Description Number1 ^ Number2 = 0x4242 Reserved for later use (0 for now) 8 0x01 Indicates one sample set MSB 9 0x01 LSB 10 0x01 Bit
XBee® Wi-Fi RF Modules Serial Communication Service The serial communication service connects an IP port to the serial peripheral (UART or SPI) of the XBee. No additional formatting or header is required and data will be transferred between the RF hardware and Serial Communication hardware as received. The IP ports are configured using the C0 and DE commands. Note that port 0xBEE is reserved for the XBee Application Service and should not be used for the Serial Communication Service.
XBee® Wi-Fi RF Modules TCP packets may be sent on an existing connection or on a new connection. In order to send data on an existing TCP connection, the destination IP address and port in the API packet must match the remote IP address and port in an existing socket. In a sample application, a packet may arrive that expects return data on the same socket. The API frame (Rx IPv4) will contain the remote IP address and port. While the remote IP address may be predicted, the remote IP address cannot.
XBee® Wi-Fi RF Modules 5. Sleep The XBee Wi-Fi module supports two different sleep modes. • Pin Sleep • Cyclic Sleep In addition the sleep mode current draw can be modified with the following sleep options. • AP Associated Sleep • Deep Sleep Pin sleep allows an external microcontroller to determine when the XBee should sleep and when it should wake by using either the SleepRq pin (default) or the SPI_nSSEL pin.
XBee® Wi-Fi RF Modules 19 is to indicate when the XBee has data to send to the host, it may legitimately be driven high or low while the module is awake. When using the SPI, either SleepRq or SPI_nSSEL may be used for pin sleep. If D8 is configured as a peripheral (1), then it will be used for pin sleep. If not, and SPI_nSSEL is configured as a peripheral (which it must be to enable SPI operation), then SPI_nSSEL is used for pin sleep.
XBee® Wi-Fi RF Modules incoming data. But, if SleepRq is being used to control sleep, then SPI_nSSEL must be asserted and SleepRq must be de-asserted to awaken the module to receive the data. This wakes up the module, which will then accept the incoming data. However data will be queued and not sent until the next DTIM. Cyclic Sleep Mode The module remains associated to the AP and will sleep based on the SP parameter.
XBee® Wi-Fi RF Modules Sample Rate (ATIR) If multiple samples are wanted during the wake period then IR can be used. This will provide ST/IR+1 samples. Each sample will be sent separately. Wake Host Wake host parameter (ATWH) delays UART and sample data from being initiated until the timer has expired. This allows the host to wake up before receiving data or a sensor to power up before an I/O sample is taken. Digital outputs and special function outputs such as ON_SLEEP and CTS are not affected by WH.
XBee® Wi-Fi RF Modules 6. Advanced Application Features XBee Analog and Digital I/O Lines XBee Wi-Fi firmware supports a number of analog and digital I/O pins that are configured through software commands. Analog and digital I/O lines can be set or queried. The following table lists the configurable I/O pins and the corresponding configuration commands.
XBee® Wi-Fi RF Modules I/O Sampling The XBee modules have the ability to monitor and sample the analog and digital I/O lines. I/O samples can be read locally or transmitted to a remote device to provide indication of the current I/O line states. There are three ways to obtain I/O samples, either locally or remotely: • Queried Sampling • Periodic Sampling • Change Detection Sampling.
XBee® Wi-Fi RF Modules default. The analog inputs on the module are capped at 0x3FF. Analog samples are returned in order starting with AD0 and finishing with AD4. Only enabled analog input channels return data as shown in the example below. To convert the A/D reading to mV, do the following: AD (mV) = (A/D reading (converted to decimal) * VREF) / 1023 where VREF may be 1250 or 2500 Assuming that AV is set to the default value, the reading in the sample frame represents voltage inputs of 2385.
XBee® Wi-Fi RF Modules their serial port. Network clients will receive the I/O data packet as described in the XBee IP Services chapter. IR can be used with sleep. A module will transmit periodic I/O samples at the IR rate until the ST timer expires, the SleepRq line is asserted, and the device can resume sleeping. Even if the IR rate is set longer than the ST defined wake time, at least one I/O sample will still be sent before the module returns to sleep because it sends one immediately upon wake up.
XBee® Wi-Fi RF Modules Accessing General Purpose Flash Memory The GPM of a target node can be accessed from the XBee serial port or from a non-XBee network client. Serial port access is done by sending explicit API frames to the MEMORY_ACCESS cluster ID (0x23) on the DIGI_DEVICE endpoint (0xE6) of the target node. (Explicit API frames have frame identifier 0x11 and are described in the API Operation section.
XBee® Wi-Fi RF Modules The following commands exist for interacting with GPM: PLATFORM_INFO_REQUEST (0x00): A PLATFORM_INFO_REQUEST frame can be sent to query details of the GPM structure. Field Name GPM_CMD_ID Command –Specific Description Should be set to PLATFORM_INFO_REQUEST (0x00). GPM_OPTIONS GPM_BLOCK_NUM GPM_START_INDEX This field is unused for this command. Set to 0. GPM_NUM_BYTES GPM_DATA No data bytes should be specified for this command.
XBee® Wi-Fi RF Modules ERASE (0x01): The ERASE command erases (writes all bits to binary 1) one or all of the GPM flash blocks. The ERASE command can also be used to erase all blocks of the GPM by setting the GPM_NUM_BYTES field to 0. Field Name GPM_CMD_ID GPM_OPTIONS GPM_BLOCK_NUM GPM_START_INDEX GPM_NUM_BYTES GPM_DATA Command –Specific Description Should be set to ERASE (0x01). There are currently no options defined for the ERASE command. Set this field to 0.
XBee® Wi-Fi RF Modules 7E 001A 91 0013A200407402AC FFFE E6 E6 0023 C105 C1 81 00 002A 0000 0000 39 WRITE (0x02) and ERASE_THEN_WRITE (0x03): The WRITE command writes the specified bytes to the GPM location specified. Before writing bytes to a GPM block it is important that the bytes have been erased previously. The ERASE_THEN_WRITE command performs an ERASE of the entire GPM block specified with the GPM_BLOCK_NUM field prior to doing a WRITE.
XBee® Wi-Fi RF Modules Assuming all transmissions were successful and that flash block 22 was previously erased, the following API packets would be output the source node's serial interface: 7E 0007 8B 01 FFFE 00 00 00 76 7E 001A 91 0013A200407402AC FFFE E6 E6 0023 C105 C1 82 00 0016 0000 0000 4C READ (0x04): The READ command can be used to read the specified number of bytes from the GPM location specified. Data can be queried from only one GPM block per command.
XBee® Wi-Fi RF Modules 7E 0007 8B 01 FFFE 00 00 00 76 7E 0029 91 0013A200407402AC FFFE E6 E6 0023 C105 C1 84 00 0016 0000 000F 0102030405060708090A0B0C0D0E0F C3 FIRMWARE_VERIFY (0x05) and FIRMWARE_VERIFY_AND_INSTALL(0x06): The FIRMWARE_VERIFY and FIRMWARE_VERIFY_AND_INSTALL commands are used when remotely updating firmware on a module. Remote firmware upgrades are covered in detail in the next section. These commands check if the General Purpose Memory contains a valid over-the-air update file.
XBee® Wi-Fi RF Modules Field Name GPM_CMD_ID GPM_OPTIONS Command –Specific Description Should be set to FIRMWARE_VERIFY_AND_INSTALL_RESPONSE (0x86). A 1 in the least significant bit indicates the GPM does not contain a valid firmware image. All other bits are reserved at this time. GPM_BLOCK_NUM GPM_START_INDEX These fields are unused for this command. Set to 0. GPM_NUM_BYTES GPM_DATA This field is unused for this command.
XBee® Wi-Fi RF Modules utility provided by Digi) using the radio's serial port interface. Firmware can also be updated using the radios' RF interface (Over-the-Air Updating.) The over-the-air firmware upgrading method provided is a robust and versatile technique which can be tailored to many different networks and applications. It has been engineered to be reliable and minimize disruption of normal network operations.
XBee® Wi-Fi RF Modules Verifying the New Application For an uploaded application to function correctly every single byte from the .ebin file must be properly transferred to the GPM. To guarantee that this is the case GPM VERIFY functions exist to ensure that all bytes are properly in place. The FIRMWARE_VERIFY function reports whether or not the uploaded data is valid. The FIRMWARE_VERIFY_AND_INSTALL command will report if the uploaded data is invalid.
XBee® Wi-Fi RF Modules 7. API Operation As an alternative to Transparent Operation, API (Application Programming Interface) Operations are available. API operation requires that communication with the module be done through a structured interface (data is communicated in frames in a defined order). The API specifies how commands, command responses and module status messages are sent and received from the module using a UART or SPI Data Frame.
XBee® Wi-Fi RF Modules interfering data byte, insert 0x7D and follow it with the byte to be escaped XOR’d with 0x20.
XBee® Wi-Fi RF Modules Checksum To test data integrity, a checksum is calculated and verified on non-escaped data. To calculate: Not including frame delimiters and length, add all bytes keeping only the lowest 8 bits of the result and subtract the result from 0xFF. To verify: Add all bytes (include checksum, but not the delimiter and length). If the checksum is correct, the sum will equal 0xFF. API Examples Example: Create an API AT command frame to configure an XBee baud rate to 230,400 (set BD to 0x08).
XBee® Wi-Fi RF Modules Transmitting and Receiving RF Data The following image shows the API exchanges that take place at the UART or SPI when sending RF data to another device. The transmit status frame is always sent at the end of a data transmission unless the frame ID is set to 0 in the transmit request. If the packet cannot be delivered to the destination, the transmit status frame will indicate the cause of failure. The received data frame (0x80 or 0xB0) is set by the AP command.
XBee® Wi-Fi RF Modules Supporting the API Applications that support the API should make provisions to deal with new API frames that may be introduced in future releases.
XBee® Wi-Fi RF Modules API Frames The following sections illustrate the types of frames encountered while using the API. TX (Transmit) Request: 64-Bit Frame Type: 0x0 This frame type uses the XBee Application Service. This command allows for software compatibility with other XBee module such as the 802.15.4 module.
XBee® Wi-Fi RF Modules AT Command Frame Type: 0x08 Used to query or set module parameters on the local device. This API command applies changes after executing the command. (Changes made to module parameters take effect once changes are applied.) The API example below illustrates an API frame when modifying the NI parameter value of the module.
XBee® Wi-Fi RF Modules AT Command-Queue Parameter Value Frame Type: 0x09 This API type allows module parameters to be queried or set. In contrast to the “AT Command” API type, new parameter values are queued and not applied until either the “AT Command” (0x08) API type or the AC (Apply Changes) command is issued. Register queries (reading parameter values) are returned immediately. Example: Send a command to change the baud rate (BD) to 115200 baud, but don't apply changes yet.
XBee® Wi-Fi RF Modules Remote AT Command Request Frame Type: 0x07 Used to query or set module parameters on a remote device. For parameter changes on the remote device to take effect, changes must be applied, either by setting the apply changes options bit, or by sending an AC command to the remote. Example: Send a remote command to query the DL register on a remote device. In this example, the IP address of the remote is 192.168.0.100.
XBee® Wi-Fi RF Modules Transmit (TX) Request: IPv4 Frame Type: 0x20 This frame type utilizes the serial data service. The frame gives greater control to the application over the IP setting for the data.
XBee® Wi-Fi RF Modules Rx (Receive) Packet: 64-bit Frame Type: 0x80 This frame type is used by XBee when RF data is received using the XBee application service. It allows for software compatibility with other XBee modules such as 802.15.4.
XBee® Wi-Fi RF Modules AT Command Response Frame Type: 0x88 In response to an AT Command message, the module will send an AT Command Response message. Some commands will send back multiple frames (for example, the AS (Active Scan) command). Example: Suppose the BD parameter is changed on the local device with a frame ID of 0x01. If successful (parameter was valid), the response below would be received.
XBee® Wi-Fi RF Modules Modem Status Frame Type: (0x8A) RF module status messages are sent from the module in response to specific conditions. Example: The following API frame is returned when a module is powered on in API mode.
XBee® Wi-Fi RF Modules Transmission Status Frame Type: (0x89) RF transmission status messages are sent from the module in response to transmission attempts. Example: The following API frame is returned when a successful transmission occurs on an API transmission using frame ID 01.
XBee® Wi-Fi RF Modules IO Data Sample RX Indicator Frame Type: 0x8F When the module receives an IO sample frame from a remote device, it sends the sample out the UART or SPI using this frame type. Only modules running API mode will be able to receive IO samples. Example: The following is the IO sample response from a radio at IP address 192.168.0.103 reporting one active DIO (DIO8) and one active analog input (AN1).
XBee® Wi-Fi RF Modules © 2012 Digi International, Inc.
XBee® Wi-Fi RF Modules Remote Command Response Frame Type: 0x87 If a module receives a remote command response RF data frame in response to a Remote AT Command Request, the module will send a Remote AT Command Response message out the UART or SPI. Example: If a remote command is sent to a remote device with an IP address of 192.168.0.103 to set the D1 parameter to 3 (digital input), the response is shown in the example API frame in the table below.
XBee® Wi-Fi RF Modules RX (Receive) Packet: IPv4 Frame Type: 0xB0 This frame is used by XBee when RF data is received using the Serial Data service on the port defined by the C0 command. Example: When a module in API mode receives an IPv4 transmission, it will produce an RX notification (0xB0) and send it out the UART or SPI. This example is the response to a UDP transmission to IP address 192.168.0.103 with data ‘Hello’ from the source address 192.168.0.104.
XBee® Wi-Fi RF Modules 8. XBee Command Reference Tables Addressing AT Command DL MY MK GW SH SL NI DE C0 DD NP Name and Description Destination Address Low. Set/Get the 32 bits of the IPv4 destination address. Using AT command mode this value is entered using dotted notation (example 192.168.0.100). IP Network Address. Read the 32-bit network address of the module when using DHCP. Set/Read values when using static IP address. IP Address Mask. This command is read only when DHCP is enabled.
XBee® Wi-Fi RF Modules Networking Commands AT Command ID Name and Description SSID. Set/read the SSID of the access point, which may be up to 31 ASCII characters AH Network Type. Set/read network type. Network types supported are Infrastructure (using an access point) and Adhoc (IBSS). IP IP Protocol. Set/Read the protocol used for the serial communication service. This is the port used by the C0 command. MA TM TS IP Addressing Mode. Set / read the IP addressing mode. TCP timeout.
XBee® Wi-Fi RF Modules Serial Interfacing AT Command Name and Description AP API Enable. Enable API Mode. AO API Output Options. Indicates the type of frame to output when data is received on the IP services port BD Interface Data Rate. Set/Read the serial interface data rate for communication between the module serial port and host. Any value above 0x0A will be interpreted as an actual baud rate.
XBee® Wi-Fi RF Modules I/O Settings AT Command IS IR IC IF Name and Description Force Sample Forces a read of all enabled digital and analog input lines. IO Sample Rate. Set/Read the IO sample rate to enable periodic sampling. For periodic sampling to be enabled, IR must be set to a non-zero value, and at least one module pin must have analog or digital IO functionality enabled (see D0-D8, P0-P2 commands). The sample rate is measured in milliseconds.
XBee® Wi-Fi RF Modules AT Command Name and Description D0 DIO0/AD0 Configuration. Select/Read function for DIO0/AD0. D1 DIO1/AD1 Configuration. Select/Read function for DIO1/AD1 D2 DIO2/AD2 Configuration. Select/Read function for DIO2/AD2 D3 DIO3/AD3 Configuration. Select/Read function for DIO3/AD3 D4 DIO4 Configuration. Select/Read function for DIO4 D5 DIO5 Configuration. Select/Read function for DIO5 © 2012 Digi International, Inc.
XBee® Wi-Fi RF Modules AT Command Name and Description D8 DIO8 Configuration. Select/Read function for DIO8 D9 DIO9 Configuration. Select/Read function for DIO9 LT PR PD DS AV M0 M1 Assoc LED Blink Time. Set/Read the Associate LED blink time. If the Associate LED functionality is enabled (D5 command), this value determines the on and off blink times for the LED when the module has joined a network. If LT=0, the default blink rate of 250ms will be used.
XBee® Wi-Fi RF Modules Diagnostics Interfacing AT Command VR HV HS AI AS Name and Description Firmware Version. Read firmware version of the module. The firmware version returns 4 hexadecimal values (2 bytes) "ABCD". Digits ABC are the main release number and D is the revision number from the main release. "B" is a variant designator where 0 means standard release. Hardware Version. Read the hardware version of the module. This command can be used to distinguish among different hardware platforms.
XBee® Wi-Fi RF Modules AT Command Options AT Command CT CN GT CC Command Mode Timeout. Set/Read the period of inactivity (no valid commands received) after which the RF module automatically exits AT Command Mode and returns to Idle Mode. This time can be up to ten minutes. Exit Command Mode. Explicitly exit the module from AT Command Mode. (Whether command mode is left by the CN command or by CT timing out, changes will be applied upon exit. Guard Times.
XBee® Wi-Fi RF Modules Execution Commands Where most AT commands set or query register values, execution commands cause an action to be executed on the module. Execution commands are executed immediately and do not require changes to be applied. AT Command Name and Description Parameter Range Default AC Apply Changes. Applies changes to all command registers causing queued command register values to be applied.
XBee® Wi-Fi RF Modules 9. Module Support This chapter provides customization information for the XBee Wi-Fi module. In addition to providing an extremely flexible and powerful API, the XBee module is a robust development platform that has passed FCC and ETSI testing. X-CTU Configuration Tool Digi provides a Windows X-CTU configuration tool for configuring module parameters and updating firmware.
XBee® Wi-Fi RF Modules 10. Agency Certifications United States FCC This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference and (2) this device must accept any interference received, including interference that may cause undesired operation. The XBee Wi-Fi Module complies with Part 15 of the FCC rules and regulations.
XBee® Wi-Fi RF Modules IMPORTANT: OEMs must test final product to comply with unintentional radiators (FCC section 15.107 & 15.109) before declaring compliance of their final product to Part 15 of the FCC Rules. IMPORTANT: The RF module has been certified for remote and base radio applications. If the module will be used for portable applications, the device must undergo SAR testing.
XBee® Wi-Fi RF Modules Part Number A24-HASM-450 A24-HABSM A24-HABUF-P5I A24-HASM-525 Type (Description) Dipole (Half-wave articulated RPSMA-4.5") Dipole (Articulated RPSMA) Dipole (Half-wave bulkhead mount U.FL s/ 5" pigtail) Dipole (Half-wave articulated RPSMA-5.25") © 2012 Digi International, Inc. Gain 2.1 dBi 2.1 dBi 2.1 dBi 2.
XBee® Wi-Fi RF Modules Omni-Directional Antennas Minimum Cable Loss/Power Reduction/Attenuation Required Part Number Type (Description) Gain Application Min Separation b mode A24-F2NF Omni-Directional (Fiberglass base station) 2.1 dBi Fixed/Mobile 20 cm N/A 20 cm N/A Fixed 20 cm Fixed A24-W7NF Omni-Directional ( base station) 3.0 dBi 5.0 dBi 8.0 dBi 9.5 dBi 10 dBi 12 dBi 15 dBi 7.
XBee® Wi-Fi RF Modules YAGI CLASS ANTENNAS A24-Y6NF Yagi (6 element) 8.8 dBi Fixed 2m Minimum Cable Loss/Power Reduction/Attenuation Required g mode n mode b mode 1.7 dB 1.7 dB N/A A24-Y7NF Yagi (7 element) 9.0 dBi Fixed 2m N/A 1.9 dB A24-Y9NF Yagi (9 element) 10.0 dBi Fixed 2m 0.9 dB 2.9 dB 2.9 dB A24-Y10NF Yagi (10 element) 11.0 dBi Fixed 2m 1.9 dB 3.9 dB 3.9 dB A24-Y12NF Yagi (12 element) 12.0 dBi Fixed 2m 2.9 dB 4.9 dB 4.9 dB A24-Y13NF Yagi (13 element) 12.
XBee® Wi-Fi RF Modules Omni-Directional Antennas Minimum Cable Loss/Power Reduction/Attenuation Required Part Number Type (Description) Gain Application Min Separation b mode A24-F2NF Omni-Directional (Fiberglass base station) 2.1 dBi Fixed/Mobile 20 cm N/A 20 cm N/A Fixed 20 cm Fixed A24-W7NF Omni-Directional ( base station) 3.0 dBi 5.0 dBi 8.0 dBi 9.5 dBi 10 dBi 12 dBi 15 dBi 7.
XBee® Wi-Fi RF Modules YAGI CLASS ANTENNAS A24-Y6NF Yagi (6 element) 8.8 dBi Fixed 2m Minimum Cable Loss/Power Reduction/Attenuation Required g mode n mode b mode 0.8 dB 1.2 dB N/A A24-Y7NF Yagi (7 element) 9.0 dBi Fixed 2m N/A 1.0 dB 1.5 dB A24-Y9NF Yagi (9 element) 10.0 dBi Fixed 2m 0.5 dB 2.0 dB 2.5 dB A24-Y10NF Yagi (10 element) 11.0 dBi Fixed 2m Part Number Type (Description) Gain Application Min Separation 1.5 dB 3.0 dB 3.5 dB 4.0 dB 4.
XBee® Wi-Fi RF Modules Europe (ETSI) The XBee Wi-Fi RF Module has been certified for use in several European countries. For a complete list, refer to www.digi.com If the module is incorporated into a product, the manufacturer must ensure compliance of the final product to the European harmonized EMC and low-voltage/safety standards. A Declaration of Conformity must be issued for each of these standards and kept on file as described in Annex II of the R&TTE Directive.
XBee® Wi-Fi RF Modules Restrictions Declarations of Conformity Digi has issued Declarations of Conformity for the XBee RF Modules concerning emissions, EMC and safety. Files can be obtained by contacting Digi Support. © 2012 Digi International, Inc.
XBee® Wi-Fi RF Modules Important Note: Digi does not list the entire set of standards that must be met for each country. Digi customers assume full responsibility for learning and meeting the required guidelines for each country in their distribution market.
XBee® Wi-Fi RF Modules Canada (IC) This device complies with Industry Canada licence-exempt RSS standard(s). Operation is subject to the following two conditions: (1) this device may not cause interference, and (2) this device must accept any interference, including interference that may cause undesired operation of the device. Le présent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils radio exempts de licence.
XBee® Wi-Fi RF Modules Under Industry Canada regulations, this radio transmitter may only operate using an antenna of a type and maximum (or lesser) gain approved for the transmitter by Industry Canada. To reduce potential radio interference to other users, the antenna type and its gain should be so chosen that the equivalent isotropically radiated power (e.i.r.p.) is not more than that necessary for successful communication.
XBee® Wi-Fi RF Modules 11. Warranty Information 1-Year Warranty XBee RF Modules from Digi International, Inc. (the "Product") are warranted against defects in materials and workmanship under normal use, for a period of 1-year from the date of purchase. In the event of a product failure due to materials or workmanship, Digi will repair or replace the defective product. For warranty service, return the defective product to Digi International, shipping prepaid, for prompt repair or replacement.
XBee® Wi-Fi RF Modules 12.Glossary of Terms Definitions Local Host A device which is electrically connected to an XBee. Typically this is a microcontroller connected to the serial pins of the module. MAC address A unique network identifier. All network devices are required to have their own unique MAC address. The MAC address is on a sticker on your Digi device server. The number is displayed as 12 hexadecimal digits, usually starting with 00:40:9D.
XBee® Wi-Fi RF Modules Systems Interconnection (OSI) communication model, TCP is in layer 4, the Transport Layer. UDP See User Datagram Protocol. User Datagram Protocol (UDP) A communications protocol that offers a limited amount of service when messages are exchanged between computers in a network that uses the Internet Protocol (IP). UDP is an alternative to the Transmission Control Protocol (TCP) and, together with IP, is sometimes referred to as UDP/IP.