Page 2
Information in this document is subject to change without notice and does not represent a commitment on the part of Digi International. Digi provides this document “as is,” without warranty of any kind, expressed or implied, including, but not limited to, the implied warranties of fitness or merchantability for a particular purpose.
Page 3
Digi Technical Support: Digi offers multiple technical support plans and service packages to help our customers get the most out of their Digi product. For information on Technical Support plans and pricing, contact us at +1 952.912.3444 or visit us at www.digi.com/support.
Technical specifications XBee 868LP RF Module Performance specifications LBT+AFA performance XBee 868LP RF Module Power requirements General specifications XBee 868LP RF Module Networking and security Regulatory approvals XBee 868LP RF Module Serial communications specifications UART serial connections SPI serial connections...
Page 5
Comparing Transparent and API modes Modes of operation Transmit mode Receive mode Command mode Sleep modes Force UART operation Advanced application features Remote configuration commands Send a remote command Apply changes on remote devices XBee 868LP RF Modules User Guide...
Page 6
Synchronous modes Normal mode Asynchronous pin sleep mode Asynchronous cyclic sleep mode Asynchronous cyclic sleep with pin wake up mode Synchronous sleep support mode Synchronous cyclic sleep mode Wake timer Indirect messaging and polling XBee 868LP RF Modules User Guide...
Page 7
SH (Serial Number High) SL (Serial Number Low) DH (Destination Address High) DL (Destination Address Low) TO (Transmit Options) NI (Node Identifier) NT (Node Discover Timeout) NO (Node Discovery Options) CI (Cluster ID) DE (Destination Endpoint) XBee 868LP RF Modules User Guide...
Page 8
LT (Associate LED Blink Time) RP (RSSI PWM Timer) I/O sampling commands AV (Analog Voltage Reference) IC (DIO Change Detection) IF (Sleep Sample Rate) IR (I/O Sample Rate) TP (Temperature) IS (Force Sample) %V (Voltage Supply Monitoring) XBee 868LP RF Modules User Guide...
XBee 868LP RF Modules User Guide The Digi XBee 868LP RF Modules provide wireless connectivity to end-point devices in mesh networks. With the XBee, users can have their network up-and-running in a matter of minutes without configuration or additional development. The Digi XBee 868LP RF Module consists of firmware loaded onto Digi XBee S8 hardware.
European acceptance The Digi XBee 868LP is manufactured under ISO 900:2015 registered standards. The Digi XBee 868LP RF Modules are optimized for use in Europe and other regions. For more information, see Certifications. XBee 868LP RF Modules User Guide...
Technical specifications XBee 868LP RF Module Performance specifications XBee 868LP RF Module Performance specifications This table describes the performance specifications for the devices. XBee Specification Indoor/urban range Up to 370 ft (112 m) with a 2.1 dBi antenna, up to 46 ft (14 m) with a PCB embedded antenna.
Technical specifications XBee 868LP RF Module Power requirements XBee 868LP RF Module Power requirements The following table describes the power requirements for the devices. XBee Specification Supply voltage (V 2.7 to 3.6 VDC Transmit current, high data rate 48 mA, (45 mA typical)
Technical specifications XBee 868LP RF Module Networking and security XBee 868LP RF Module Networking and security The following table describes the networking and security specifications for the devices. XBee Specification Supported network topologies Mesh, repeater, point-to-point, point-to-multipoint, peer- to-peer. Number of channels, user selectable...
For more information on SPI operation, see communications. GPIO specifications The Digi XBee 868LP RF Modules have General Purpose Input / Output (GPIO) ports available. The exact list depends on the module configuration, as some GPIO pads are used for purposes such as serial communication.
Part number: MC9S08QE32 Mechanical drawings The following mechanical drawings of the XBee 868LP RF Modules show all dimensions in inches. Antenna options are not shown. Pin signals The following table describes the pin assignments for the devices. A horizontal line above the signal name indicates low-asserted signals.
Page 20
GPIO/Serial Peripheral Interface not Select DIO16 / SPI_MOSI Input Input GPIO/Serial Peripheral Interface Data In DIO15 / SPI_MISO/ Output Output GPIO/Serial Peripheral Interface Data Out Tri-stated when SPI_SSEL is high [reserved]* Disabled Do not connect XBee 868LP RF Modules User Guide...
Page 21
RF I/O for RF Pad Variant [reserved] Disabled Do not connect Signal Direction is specified with respect to the device. Design notes for details on pin connections. * These pins are not available for customer use. XBee 868LP RF Modules User Guide...
Structure beams Concrete, which is usually reinforced with metal rods If you place the device inside a metal enclosure, use an external antenna. Common objects that have metal enclosures include: Vehicles Elevators Ventilation ducts XBee 868LP RF Modules User Guide...
For optimal performance, do not mount the device on the RF pad footprint described in the next section, because the footprint requires a ground plane within the PCB antenna keep out area. XBee 868LP RF Modules User Guide...
We recommend using a microstrip trace, although you can also use a coplanar waveguide if you need more isolation. Microstrip generally requires less area on the PCB than coplanar waveguide. We do not recommend stripline because sending the signal to different PCB layers can introduce matching and performance problems. XBee 868LP RF Modules User Guide...
Page 25
Implementing these design suggestions helps ensure that the RF pad device performs to its specifications. The following figures show a layout example of a host PCB that connects an RF pad device to a right angle, through-hole RPSMA jack. XBee 868LP RF Modules User Guide...
Page 26
Maintain a distance of at least 2 d between microstrip and ground fill. Device pin 36. 50 Ω microstrip trace. RF connection of RPSMA jack. The following illustration shows PCB layer 2 of an example RF layout. XBee 868LP RF Modules User Guide...
For the secondary processor to sample with ADCs, the XBee must be connected to a reference voltage. Digi provides a bootloader that can take care of programming the processor over-the-air or through the serial interface. This means that over-the-air updates can be supported through an XMODEM protocol.
Programmable XBee SDK: http://ftp1.digi.com/support/sampleapplications/40003003_D.exe If these revisions change, search for the part number on Digi’s website. For example, search for 40003003. Install the IDE first, and then install the SDK. The documentation for the Programmable XBee SDK is built into the SDK, so the Getting Started guide appears when you open CodeWarrior.
Getting Started The XBee 868LP RF modules support low-power, peer-to-peer or wireless mesh networks for Europe (868 MHz). The XBee modules provide reliable delivery of data between remote devices. This guide shows you how to set up an XBee mesh network using the DigiMesh protocol, send data between your XBee modules, and adjust your XBee module settings.
Verify XBee RF module kit contents Your XBee 868LP RF module development kit contains the following components: Gather required materials To complete the steps in this guide, you need the following items:...
CPU: Dual-core processor minimum, Quad-core processor recommended USB ports: Three available USB ports for the XBee/XBee-PRO DigiMesh 2.4 development kit Two available USB ports for the XBee 868LP development kit Note Only one computer is required to follow along with the steps in this guide.
1. Go to www.digi.com/xctu. 2. Click Download. 3. Under Download XCTU, click the Windows installer link. 4. Once the download is complete, run the executable file and follow the steps in the XCTU Setup Wizard. XBee 868LP RF Modules User Guide...
Page 33
6. Go to www.digi.com/xctu. 7. Click Download. 8. Under Download XCTU, click the OSX installer link. 9. Once the download is complete, unzip and run the executable file and follow the steps in the XCTU Setup Wizard. XBee 868LP RF Modules User Guide...
5. In the Discover radio devices dialog, select the serial ports where you want to look for XBee modules, and click Next. 6. In the Set port parameters window, maintain the default values and click Finish. As XCTU locates radio modules, they appear in the Discovering radio modules dialog box. XBee 868LP RF Modules User Guide...
Page 35
Configure the following parameters: ID: 2015 DH: 0013A200 DL: SL of XBEE_B (Enter the last eight characters of the MAC address for XBEE_B. Or select XBEE_B and find its SL value.) XBee 868LP RF Modules User Guide...
Page 36
DL: SL of XBEE_A (Enter the last eight characters of the MAC address for XBEE_A. Or select XBEE_A and find its SL value.) NI: XBEE_B d. Click the Write radio settings button After you write the radio settings for the XBee devices, their names appear in the Radio Modules area. XBee 868LP RF Modules User Guide...
Page 37
Once both XBee modules are configured, use XCTU to check that they are in the same network and can see each other. 1. Click the Discover radio nodes in the same network button of XBEE_A. The device searches for radio modules in the same network. XBee 868LP RF Modules User Guide...
Page 38
The message of the sender is in blue font, and the message of the receiver is in red font. 4. Close the window for XBEE_B. 5. Keep the serial connections open for both XBee modules. If the two XBee modules are unable to talk to each other: XBee 868LP RF Modules User Guide...
Verify that the following parameters are configured appropriately: XBee/XBee-PRO DigiMesh 2.4: The CH (Operating Channel) is the same for both XBee modules. XBee 868LP: The CM (Channel Mask) and HP (Preamble ID) are the same for both XBee modules. Step 4: Create a mesh network This section describes how to add a third XBee module to create a mesh network.
Page 40
XBEE_B. e. Type "Are you out of range?" In the illustration below, the message does not loop back, which means XBEE_B did not receive it and it is out of range of XBEE_A. XBee 868LP RF Modules User Guide...
Page 41
In the Add a radio module dialog, select the USB Serial Port for this XBee module and click Finish. e. Configure this XBee module as follows: ID: 2015 NI: XBEE_C f. Click the Write radio settings button XBee 868LP RF Modules User Guide...
Page 42
Send selected packet to send your message. Before you perform other tasks, change the loopback jumper on XBEE_B so it no longer bridges the two pins on its development board. It should look like this: XBee 868LP RF Modules User Guide...
Configure a device in API mode 1. Select XBEE_A and click the Configuration working modes button 2. Add this configuration: AP: API Mode 1 3. Click the Write radio settings button The Port indicates XBEE_A is in API mode. XBee 868LP RF Modules User Guide...
Page 44
Select XBEE_B and click . Then click to open a serial connection. 5. Select XBEE_A. 6. In the Send a single frame area, click the Add new frame to the list button XBee 868LP RF Modules User Guide...
Page 45
8. In the XBee API Frame generator dialog, configure the following parameters: Protocol: DigiMesh Mode: API 1 Frame type: 0x10 - Transmit Request 64-bit dest. address: MAC address of XBEE_B RF data: Type "Hello XBee_B!" in the ASCII tab 9. Click OK. XBee 868LP RF Modules User Guide...
Page 46
14. In the Frames log area, select Transmit Request and then Transmit Status to look at the Frame details for each. For example, select Transmit Status and scroll down in the Frame details area to see that your Delivery status is a success. XBee 868LP RF Modules User Guide...
3. Select a local or remote XBee module from the Radio Modules list. 4. Click the Update firmware button The Update firmware dialog displays the available and compatible firmware for the selected XBee module. XBee 868LP RF Modules User Guide...
3. Configure the second XBee module in either API or transparent mode, and name it XBEE_B. Configure the first two XBee devices in Transparent mode. 4. Disconnect XBEE_B from your computer and remove it from XCTU. XBee 868LP RF Modules User Guide...
For devices to communicate with each other, you configure them so they are in the same network. You also set the local device to API mode to obtain all possible data of the remote device. XBee 868LP RF Modules User Guide...
Page 50
After you write the radio settings for each device, their names appear in the Radio Modules area. The Port indicates XBEE_A is in API mode. 8. Disconnect XBEE_B from the computer and remove it from XCTU. XBee 868LP RF Modules User Guide...
Page 51
5. For Range Test type, select Cluster ID 0x12. 6. Click the Start Range Test button 7. If a notification dialog asks you to close the loopback jumper in the remote device, click OK. XBee 868LP RF Modules User Guide...
Page 52
In the following illustration, the percentage of packets successfully sent is 69% and received is 64%. The actual percentage of packets successfully sent or received may be higher. XBee 868LP RF Modules User Guide...
USB cable to connect and configure XBEE_C. 1. Add three devices to XCTU. See Add XBee modules to XCTU. 2. For each device, click the Load default firmware settings button and then the Write radio settings button XBee 868LP RF Modules User Guide...
Page 54
To simulate a sensor system such as water monitoring, you might set SP to 30 minutes and ST to 10 seconds, depending on the number of devices and amount of data that is transferred. XBee 868LP RF Modules User Guide...
Page 55
Observe XBEE_B or XBEE_C taking over the role of sleep coordinator by looking at the behavior of the LED lights. It could take three cycles for the new sleep coordinator to take effect. c. Re-connect XBEE_A to your computer. d. Observe XBEE_A re-assuming the role of sleep coordinator. XBee 868LP RF Modules User Guide...
Page 56
1. Click the Consoles working mode button 2. Select XBEE_A (the preferred sleep coordinator), and click to open a serial connection. 3. Select XBEE_B and click 4. Click the Detach view button to see both consoles at the same time. XBee 868LP RF Modules User Guide...
Page 57
XBee module is awake (the icon is highlighted) or asleep (the icon is not highlighted). Since XBEE_A is the sleep coordinator, it transmits its entire message to XBEE_B. The CTS icon for XBEE_A stays on the entire time. XBee 868LP RF Modules User Guide...
The information transmitted in an XBee network sometimes needs to be protected. For example, an XBee network transferring financial information must be carefully protected against external agents. These instructions show you how to configure XBee 868LP RF Modules for secure communication via encryption keys.
8. To return to the encryption disabled setting, change the EE parameter back to 0 for XBEE_A and XBEE_B. Learn more about XBee module features For more information about XBee 868LP RF modules, see the XBee 868LP RF Modules User Guide. You can find this guide on the Digi Support site.
DIN pin for RF transmission. When a device receives RF data, it sends the data out through the DOUT pin. You can set the configuration parameters using the AT Command interface. XBee 868LP RF Modules User Guide...
USB port. 3. Manually install the USB drivers. See Optional: Manually install USB drivers. Use LEDs to identify XBee modules You want to force LEDs to blink so you can easily locate an XBee module. XBee 868LP RF Modules User Guide...
Restore default settings If the XBee modules are properly connected and in the same network, restore default settings and configure them again. Port in use Message: "The port is already in use by other applications." XBee 868LP RF Modules User Guide...
3. (Windows) Open Computer management, find the failing device in the Device Manager section and remove it. 4. Download the appropriate driver. You can download drivers for all major operating systems from FTDI for manual installation. XBee 868LP RF Modules User Guide...
In the Device Selection area in the Radio Range Test dialog, click the Discover remote devices button and XCTU will discover devices on the local device's network. XCTU installation error An error is reported when installing XCTU. Condition XCTU requires Administrator permissions. XBee 868LP RF Modules User Guide...
Page 65
XCTU program. You must answer yes when prompted to allow the program to make changes to your computer, or XCTU will not work correctly. Note that you may also need to talk to your network manager to gain permission to install or run applications as administrator. XBee 868LP RF Modules User Guide...
Operation Listen Before Talk and Automatic Frequency Agility Single frequency mode band mode Serial communications Configuration considerations Data format SPI parameters Serial buffers UART flow control Serial interface protocols Modes of operation XBee 868LP RF Modules User Guide...
Operation Operation The XBee 868LP RF Module uses a multi-layered firmware base to order the flow of data, dependent on the hardware and software configuration you choose. The following configuration block diagram shows the host serial interface as the physical starting point and the antenna as the physical endpoint for the transferred data.
For example, if you enabled two channels you would have an effective duty cycle of 5.6%. The XBee 868LP RF Module uses a sliding bucket algorithm to calculate usage over the period of 1 hour for each channel. Each bucket accumulates for 6 minutes.
Serial communications For serial communication to occur, you must configure the UART of both devices (the microcontroller and the XBee 868LP RF Module) with compatible settings for the baud rate, parity, start bits, stop bits, and data bits. Each data byte consists of a start bit (low), 8 data bits (least significant bit first) and a stop bit (high).
SPI implementation The XBee 868LP RF Module operates as an SPI slave only. This means an external master provides the clock and decides when to send. The XBee 868LP RF Module supports an external clock rate of up to 3.5 Mb/s.
Page 71
UART operation. Full duplex operation SPI on the XBee 868LP RF Module requires that you use API mode (without escaping) to packetize data. By design, SPI is a full duplex protocol even when data is only available in one direction. This means that when a device receives data, it also transmits and that data is normally invalid.
Sleep modes generally work the same on SPI as they do on UART. However, due to the addition of SPI mode, there is the option of another sleep pin. By default, Digi configures DIO8 (SLEEP_REQUEST) as a peripheral and during pin sleep it wakes the device and puts it to sleep. This applies to both the UART and SPI serial interfaces.
Clock polarity (CPOL): first (leading) edge rises All XBee 868LP RF Modules use SPI mode 0 and MSB first. Mode 0 means that data is sampled on the leading edge and that the leading edge rises. MSB first means that bit 7 is the first bit of a byte sent over the interface.
If the device sends data out the UART when RTS is de-asserted (set high) the device could send up to five characters out the UART port after RTS is de-asserted. Serial interface protocols The XBee 868LP RF Module supports both Transparent and Application Programming Interface (API) serial interfaces. Transparent operating mode When operating in Transparent mode, the devices act as a serial line replacement.
API frames can provide indication of I/O samples from remote devices, diagnostics and node identification messages. Remote Configuration Set/read configuration commands can be sent to remote devices to configure them as needed using the API We recommend API mode when a device: XBee 868LP RF Modules User Guide...
Page 76
If the conditions listed above do not apply (for example, a sensor node, router, or a simple application), then Transparent operation might be suitable. It is acceptable to use a mixture of devices running API mode and Transparent mode in a network. XBee 868LP RF Modules User Guide...
Modes of operation Modes of operation The XBee 868LP RF Module is in Receive Mode when it is not transmitting data. The device shifts into the other modes of operation under the following conditions: Transmit Mode (Serial data in the serial receive buffer is ready to be packetized)
Receive mode This is the default mode for the XBee 868LP RF Module. The device is in Receive mode when it is not transmitting data. If a destination node receives a valid RF packet, the destination node transfers the data to its serial transmit buffer.
Page 79
Any changes you make to the configuration command registers using AT commands do not take effect until you apply the changes. For example, if you send the BD command to change the baud rate, the actual baud rate does not change until you apply the changes. To apply changes: XBee 868LP RF Modules User Guide...
You can send the appropriate commands to the device to configure it for UART operation. 3. If you write these parameters to the device, the module comes up with the UART enabled on the next reset. XBee 868LP RF Modules User Guide...
You can configure XBee devices locally through serial commands (AT or API) or remotely through remote API commands. API devices can send configuration commands to set or read the configuration settings of any device in the network. XBee 868LP RF Modules User Guide...
DH/DL registers of nodes in the network. To update only the routing table information without affecting the DH/DL registers, use Example 2. To update the DH/DL registers of the network, use the method in the following example. XBee 868LP RF Modules User Guide...
Mode). The following sections list the steps based on the device's mode. Transparent operating mode configuration (AP = 0) To send data to the loopback cluster ID on the data endpoint of a remote device: XBee 868LP RF Modules User Guide...
Network link testing To determine the success rate of many transmissions, send unicast data through the network from one device to another to measure the performance of the mesh network. XBee 868LP RF Modules User Guide...
Page 86
Test Link Result Cluster (0x0094) on endpoint (0xE6). If the requesting device is operating in API mode, the device outputs the following information as an API Explicit RX Indicator Frame: XBee 868LP RF Modules User Guide...
Page 87
For more information, see API operating mode. Example: Suppose you unicast a data packet with the trace route enabled from radio A to radio E, through radios B, C, and D. The following sequence occurs: XBee 868LP RF Modules User Guide...
XBee devices support a set of commissioning pushbutton and LED behaviors to aid in device deployment and commissioning. These include the commissioning push button definitions and associate LED behaviors. The following features can be supported in hardware: XBee 868LP RF Modules User Guide...
Page 89
Advanced application features Network commissioning and diagnostics A pushbutton and an LED can be connected to XBee 868LP RF Module pins 33 and 28 (SMT), or pins 20 and 15 (TH) respectively to support the commissioning pushbutton and associate LED functionalities.
Page 90
API Node Identification Indicator frame (0x95). Associate LED The Associate pin (pin 15) provides an indication of the device's sleep status and diagnostic information. To take advantage of these indications, connect an LED to the Associate pin. XBee 868LP RF Modules User Guide...
Associate pin rapidly for one second. I/O line monitoring I/O samples The XBee 868LP RF Module supports both analog input and digital I/O line modes on several configurable pins. Queried sampling Pin configuration commands include the following parameters:...
Page 92
Use the PR command to enable internal pull up/down resistors for each digital input. Use the PD command to determine the direction of the internal pull up/down resistor. Field Name Description Sample Number of sample sets in the packet. Always set to 1. sets XBee 868LP RF Modules User Guide...
Page 93
AT command response API frame with the I/O data included in the command data portion of the packet. Example Sample AT response 0x01 [1 sample set] 0x0C0C [Digital Inputs: DIO 2, 3, 10, 11 enabled] 0x03 [Analog Inputs: A/D 0, 1 enabled] XBee 868LP RF Modules User Guide...
General Purpose Flash Memory XBee 868LP RF Modules provide 119 512-byte blocks of flash memory that an application can read and write to. This memory provides a non-volatile data storage area that an application uses for many purposes.
The format of the response is similar to the request packet: Byte offset in Number of payload bytes Field name General field description GPM_CMD_ID This field is the same as the request field. GPM_STATUS Status indicating whether the command was successful. XBee 868LP RF Modules User Guide...
Indicates the size, in bytes, of a GPM block. GPM_NUM_BYTES The number of bytes in the GPM_DATA field. For this command, this field will be set to 0. GPM_DATA No data bytes are specified for this command. XBee 868LP RF Modules User Guide...
Page 97
Matches the parameter passed in the request frame. GPM_NUM_BYTES The number of bytes in the GPM_DATA field. For this command, this field will be set to 0. GPM_DATA No data bytes are specified for this command. XBee 868LP RF Modules User Guide...
Page 98
Should be set to WRITE_RESPONSE (0x82) or ERASE_THEN_WRITE_ RESPONSE (0x83) GPM_STATUS A 1 in the least significant bit indicates an error occurred. All other bits are reserved at this time GPM_BLOCK_NUM Matches the parameter passed in the request frame XBee 868LP RF Modules User Guide...
Page 99
No data bytes should be specified for this command. READ_RESPONSE (0x84) When a READ command request has been unicast to a node, that node sends a response in the following format to the source endpoint specified in the requesting frame. XBee 868LP RF Modules User Guide...
Page 100
This field is unused for this command FIRMWARE_VERIFY_RESPONSE (0x85) When a FIRMWARE_VERIFY command request has been unicast to a node, that node sends a response in the following format to the source endpoint specified in the requesting frame. XBee 868LP RF Modules User Guide...
7E 0007 8B 01 FFFE 00 00 00 76 7E 001A 91 0013A200407402AC FFFE E6 E6 0023 C105 C1 85 00 0000 0000 0000 5F Work with flash memory When working with the General Purpose Memory, observe the following limitations: XBee 868LP RF Modules User Guide...
Flash memory has a limited lifetime. The flash memory on which the GPM is based is rated at 20,000 erase cycles before failure. Take care to ensure that the frequency of erase/write operations allows for the desired product lifetime. Digi's warranty does not cover products that have exceeded the allowed number of erase cycles.
Because explicit API Tx frames can be addressed to a local node (accessible via the SPI or UART) or a remote node (accessible over the RF port) the same process can be used to update firmware on a device in either case. XBee 868LP RF Modules User Guide...
Networking methods This section explains the basic layers and the three networking methods available on the XBee 868LP RF Modules, building from the simplest to the most complex. Directed Broadcast/Repeater mode Point to Point/Multipoint mode DigiMesh networking Networking concepts Data transmission and routing...
Peer-to-peer architecture. No hierarchy and no parent-child relationships are needed. Quiet protocol. Routing overhead will be reduced by using a reactive protocol similar to AODV. Route discovery. Rather than maintaining a network map, routes will be discovered and created only when needed. XBee 868LP RF Modules User Guide...
Rather than maintaining a network map, routes will be discovered and created only when needed. Selective acknowledgments Only the destination node will reply to route requests. Reliable delivery Reliable delivery of data is accomplished by means of acknowledgments. XBee 868LP RF Modules User Guide...
This results in all nodes repeating the transmission four times as well. In order to avoid RF packet collisions, the network inserts a random delay before each router relays the broadcast message. You can change this random delay time with the NN parameter. XBee 868LP RF Modules User Guide...
The following table shows the results of our empirical testing of throughput performance in a robust operating environment (low interference). The results apply to the 80 kb/s version, 115.2 kb/s serial data rate, 100 KB. XBee 868LP RF Modules User Guide...
Unicast one hop time unicastOneHopTime is a building block of many of the following calculations. It represents the amount of time it takes to send a unicast transmission between two adjacent nodes. The time depends on the XBee 868LP RF Modules User Guide...
Page 110
After it fails, it initiates route discovery and, when the route discovery finishes, transmits the data along the new route. You can estimate the timeout associated with the entire operation as follows: brokenRouteUnicastTime=BroadcastTxTime+(NH*unicastOneHopTime)+ (2*knownRouteUnicastTime) XBee 868LP RF Modules User Guide...
Page 111
Asynchronous cyclic sleep mode Asynchronous cyclic sleep with pin wake up mode Synchronous sleep support mode Synchronous cyclic sleep mode Wake timer Indirect messaging and polling Sleeping routers Sleep coordinator sleep modes in the DigiMesh network XBee 868LP RF Modules User Guide...
When synchronized, a device in Normal mode relays sync messages that sleep-compatible nodes generate, but does not generate sync messages itself. Once a device in Normal mode synchronizes with a sleeping network, you can put it into a sleep- compatible sleep mode at any time. XBee 868LP RF Modules User Guide...
When a device has synchronized with the network, you can query its sleep and wake times with the OS and OW commands respectively. If D9 = 1 (ON_SLEEP enabled) on a cyclic sleep node, the ON_SLEEP line asserts when the device is awake and de-asserts when the device is asleep. XBee 868LP RF Modules User Guide...
100 ms. When the device sends normal data to the destination specified by the DH/DL of end device module, the data also functions as a poll. XBee 868LP RF Modules User Guide...
If a node exits deployment mode and then receives a sync message from a sleep coordinator that is in Deployment mode, it rejects the sync message and sends a corrective sync to the sleep coordinator. Use the SO (sleep options) command to disable deployment mode. This option is enabled by default. XBee 868LP RF Modules User Guide...
Page 116
If you use the SO command to configure nodes as non-coordinators, and if the non-coordinators go six or more sleep cycles without hearing a sync, they send a message requesting sync at the beginning of their wake period. The following diagram illustrates the synchronization behavior of sleep compatible devices. XBee 868LP RF Modules User Guide...
Page 117
Sleep modes Sleep coordinator sleep modes in the DigiMesh network XBee 868LP RF Modules User Guide...
It is possible for multiple nodes to declare themselves as the sleep coordinator. If this occurs, the firmware uses the following resolution criteria to identify the sleep coordinator from among the nodes using the selection process: XBee 868LP RF Modules User Guide...
Page 119
As a node misses more and more consecutive sync messages, the sleep guard time increases in duration and decreases the available transmission time. XBee 868LP RF Modules User Guide...
Start a sleeping synchronous network By default, all new nodes operate in normal (non-sleep) mode. To start a synchronous sleeping network, follow these steps: XBee 868LP RF Modules User Guide...
1. Power the new node on within range of a sleep support node. Sleep support nodes are always awake and able to respond to sync requests promptly. XBee 868LP RF Modules User Guide...
N is an integer. Rejoin nodes that lose sync DigiMesh networks get their robustness from routing redundancies which may be available. We recommend architecting the network with redundant mesh nodes to increase robustness. XBee 868LP RF Modules User Guide...
The following diagnostics are useful in applications that manage a sleeping router network: Query sleep cycle Use the OS and OW commands to query the current operational sleep and wake times that a device uses. XBee 868LP RF Modules User Guide...
Page 124
Sleep status API messages When you use the SO command to enable this option, a device that is in API operating mode outputs modem status frames immediately after it wakes up and prior to going to sleep. XBee 868LP RF Modules User Guide...
Writes parameter values to non-volatile memory so that parameter modifications persist through subsequent resets. Note Once you issue a WR command, do not send any additional characters to the device until after you receive the OK response. Parameter range Default XBee 868LP RF Modules User Guide...
When receiving a packet, the device check this after the preamble ID. If you are using Original equipment manufacturer (OEM) network IDs, 0xFFFF uses the factory value. During join via commissioner, ID determines the extended pan ID of the network to join. Parameter range 0 - 0x7FFF XBee 868LP RF Modules User Guide...
Sets or reads the power level at which the device transmits conducted power. These values include the gain of a 2 dBi antenna. The conducted power is 2 dBi less. Parameter range These parameters equate to the following settings for the XBee 868LP RF Module. Setting Power level 2 mW e.i.r.p.
-96 dBm. An XBee-PRO 900 module only reports RSSI values within approximately 15 dBm of the sensitivity level of the device. Signals which exceed approximately -85 dBm are reported as approximately -85 dBm. Parameter range 0 - 0xFF [read-only] Default XBee 868LP RF Modules User Guide...
MAC acknowledgment message from the destination node. Once the number reaches 0xFFFF, it does not count further events. To reset the counter to any 16-bit value, append a hexadecimal parameter to the command. Parameter range 0 - 0xFFFF Default XBee 868LP RF Modules User Guide...
Setting a device as an end device causes it to regularly send polls to its Indirect Messaging Coordinator. Nodes can also be configured to route, or not route, multi-hop packets. XBee 868LP RF Modules User Guide...
Both variants are supported. Parameter range 1 - 0x20 Default NN (Network Delay Slots) Set or read the maximum random number of network delay slots before rebroadcasting a network packet. Parameter range 1 - 5 XBee 868LP RF Modules User Guide...
DH (Destination Address High) Set or read the upper 32 bits of the 64-bit destination address. When you combine DH with DL, it defines the destination address that the device uses for transmissions in Transparent mode. XBee 868LP RF Modules User Guide...
Disable ACK Disable acknowledgments on all unicasts Example 1: Set TO to 0x80 to send all transmissions using repeater mode. Example 2: Set TO to 0xC1 to send transmissions to DigiMesh, with network acknowledgments disabled. XBee 868LP RF Modules User Guide...
The options bit field value changes the behavior of the ND command and what optional values the local device returns when it receives an ND command or API Node Identification Indicator (0x95) frame. Parameter range 0x0 - 0x7 (bit field) XBee 868LP RF Modules User Guide...
AT commands Addressing commands Option Description Append the DD (Digi Device Identifier) value to ND responses or API node identification 0x01 frames. Local device sends ND or FN (Find Neighbors) response frame when the ND is issued. 0x02 Append the RSSI of the last hop to ND, FN, and responses or API node identification 0x04 frames.
Discovers and reports all of the devices it finds on a network. The command reports the following information after a jittered time delay. MY<CR> SH<CR> SL<CR> DB<CR> (Contains the detected signal strength of the response in negative dBm units) XBee 868LP RF Modules User Guide...
STATUS<CR> (1 Byte: Reserved) PROFILE_ID<CR> (2 Bytes) MANUFACTURER_ID<CR> (2 Bytes) DIGI DEVICE TYPE<CR> (4 Bytes. Optionally included based on NO settings.) RSSI OF LAST HOP<CR> (1 Byte. Optionally included based on NO settings. <CR> If you send the FN command in Command mode, after (NT*100) ms + overhead time, the command ends by returning a carriage return, represented by <CR>.
Set this command parameter the same on all devices in a network. The value passes in as hex characters when you set it from AT command mode, and as binary bytes when you set it in API mode. Parameter range 128-bit value Default XBee 868LP RF Modules User Guide...
The baud rate limit is 7 Mb/s. Default 0x03 (9600 b/s) NB (Parity) Set or read the serial parity settings for UART communications. Parameter range 0x00 - 0x02 Parameter Description 0x00 No parity 0x01 Even parity 0x02 Odd parity XBee 868LP RF Modules User Guide...
FT-16 bytes are in the UART receive buffer. Parameter range 0x11 - 0x16F bytes Default 0x13F AP (API Mode) Set or read the UART API mode. Parameter range 0 - 2 The following settings are allowed: XBee 868LP RF Modules User Guide...
Set the parameter value to the number of button presses that you want to simulate. For example, send CB1 to perform the action of pressing the Commissioning Pushbutton once. Parameter range 0 - 4 Default XBee 868LP RF Modules User Guide...
The DIO1/AD1 pin configuration (pin 32). Parameter range 0, 2 - 5 Parameter Description Disabled Digital input Digital output, low Digital output, high PTI_EN Default D2 (DIO2/AD2) The DIO2/AD2 pin configuration (pin 31). Parameter range 0, 2 - 5 XBee 868LP RF Modules User Guide...
Digital input Digital output, low Digital output, high Default D4 (DIO4/AD4) The DIO4 pin configuration (pin 24). Parameter range 0, 3 - 5 Parameter Description Disabled Digital input Digital output, low Digital output, high XBee 868LP RF Modules User Guide...
0, 1, 3 - 5 Parameter Description Disabled RTS flow control Digital input Digital output, low Digital output, high Default D7 (DIO7/CTS) Sets or displays the DIO7/CTS pin configuration (pin 25). Parameter range 0, 1, 3 - 7 XBee 868LP RF Modules User Guide...
SPI_MOSI Digital output low Digital output, high Default P7 (DIO17/SPI_SSEL ) The DIO17/SPI_SSEL pin configuration (pin 15). Parameter range 0, 1, 4, 5 Parameter Description Disabled SPI_SSEL Digital output low Digital output, high Default XBee 868LP RF Modules User Guide...
PD (Pull Up/Down Direction) The resistor pull direction bit field (1 = pull-up, 0 = pull-down) for corresponding I/O lines that are set by the PR command. Parameter range 0x0 - 0xFFFFF (bit field) Default XBee 868LP RF Modules User Guide...
Parameter range 0 - 0x3FF Default M1 (PWM1 Duty Cycle) The duty cycle of the PWM1 line (pin 8). Use the P1 command to configure the line as PWM output. Parameter range 0 - 0x3FF XBee 868LP RF Modules User Guide...
I/O, you can use the IC command to force an immediate I/O sample transmission when the DIO state changes. IC is a bitmask that you can use to enable or disable edge detection on individual channels. XBee 868LP RF Modules User Guide...
I/O and analog inputs every IR milliseconds. I/O Samples transmit to the address specified by DT. To enable periodic sampling, set IR to a non-zero value, and enable the analog or digital I/O functionality of at least one device pin. The sample rate is measured in milliseconds. XBee 868LP RF Modules User Guide...
Displays the supply voltage of the device in mV units. Parameter range This is a read-only parameter Default Sleep commands The following AT commands are sleep commands. SM (Sleep Mode) Sets or reads the sleep mode of the device. XBee 868LP RF Modules User Guide...
Disable early wake-up for missed syncs Enable node type equality (disables seniority based on device type) Disable lone coordinator sync repeat For asynchronous sleep devices, the following sleep bit field options are defined: Option Always wake for ST time XBee 868LP RF Modules User Guide...
The command adjusts the value upwards automatically if it is too small to function properly based on other settings. Parameter range 0x1 - 0x36EE80 (x 1 ms) Default 0x1F40 (8 seconds) XBee 868LP RF Modules User Guide...
This bit is true if you request that the node nominate itself as the sleep coordinator using the Commissioning Pushbutton or the CB2 command. This bit is true if the node is currently in deployment mode. All other bits Reserved. Ignore all non-documented bits. Parameter range [read-only] Default 0x40 XBee 868LP RF Modules User Guide...
Set the value to 0 to reset this value. When the value reaches 0xFFFF it does not increment anymore. Parameter range 0 - 0xFFFF Default Command mode options The following commands are Command mode option commands. XBee 868LP RF Modules User Guide...
Command mode sequence (GT + CC + GT). The period of silence prevents inadvertently entering Command mode. Parameter range 0x2 - 0x95C (x 1 ms) Default 0x3E8 (one second) Firmware commands The following AT commands are firmware commands. XBee 868LP RF Modules User Guide...
Parameter range 0-0xFFFF [read-only] Default Set in the factory DD (Device Type Identifier) The Digi device type identifier value. Use this value to differentiate between multiple devices. Parameter range 0 - 0xFFFFFFFF [read-only] Default 0xC0000 XBee 868LP RF Modules User Guide...
Displays the cyclic redundancy check (CRC) of the current AT command configuration settings. This command allows you to detect an unexpected configuration change on a device. After a firmware update this command may return a different value. Parameter range Default XBee 868LP RF Modules User Guide...
The cmdID frame (API-identifier) indicates which API messages contains the cmdData frame (Identifier-specific data). The device sends multi-byte values big endian format. The XBee 868LP RF Module supports the following API frames: XBee 868LP RF Modules User Guide...
The following image shows the API frame exchange that takes place at the UART when you send a 0x08 AT Command Request or 0x09 AT Command-Queue Request to read or set a device parameter. To disable the 0x88 AT Command Response, set the frame ID to 0 in the request. XBee 868LP RF Modules User Guide...
API frames (sent out the module's DOUT pin) might look like this: voidXBee_HandleRxAPIFrame(_apiFrameUnion *papiFrame){ switch(papiFrame->api_id){ case RX_RF_DATA_FRAME: //process received RF data frame break; case RX_IO_SAMPLE_FRAME: //process IO sample frame break; case NODE_IDENTIFICATION_FRAME: //process node identification frame break; default: XBee 868LP RF Modules User Guide...
Data field organizes the information. Data contains the data itself. This information and its order depend on the what type of frame that the Frame type field defines. Multi-byte values are sent big-endian. XBee 868LP RF Modules User Guide...
Up to NP bytes per packet. Sent to the destination device. 17-n Transmit Options bit field Bit field: Meaning Description Disable ACK Disable acknowledgments on all unicasts. Disable RD Disable Route Discovery. NACK Enable unicast NACK messages. Trace route Enable unicast trace route messages. XBee 868LP RF Modules User Guide...
Page 173
0x00 0x54 0x78 0x44 0x61 0x74 0x61 0x30 0x41 0x7D 0x33 The device calculates the checksum (on all non-escaped bytes) as [0xFF - (sum of all bytes from API frame type through data payload)]. XBee 868LP RF Modules User Guide...
Destination endpoint 16 Destination endpoint for the transmission. Cluster ID 17-18 The Cluster ID that the host uses in the transmission. Profile ID 19-20 The Profile ID that the host uses in the transmission. XBee 868LP RF Modules User Guide...
Page 175
Frame data fields Offset Example Start delimiter 0x7E Length MSB 1 0x00 LSB 2 0x1A Frame type 0x11 Frame ID 0x01 64-bit destination address MSB 5 0x00 0x13 0xA2 0x00 0x01 0x23 0x84 LSB12 0x00 XBee 868LP RF Modules User Guide...
Apply changes so the new configuration value takes effect immediately. In this example, the 64-bit address of the remote device is 0x0013A200 40401122. Frame data fields Offset Example Start delimiter 0x7E Length MSB 1 0x00 LSB 2 0x10 XBee 868LP RF Modules User Guide...
If you change the BD parameter on a local device with a frame ID of 0x01, and the parameter is valid, the user receives the following response. Frame data fields Offset Example Start delimiter 0x7E Length MSB 1 0x00 LSB 2 0x05 Frame type 0x88 Frame ID 0x01 XBee 868LP RF Modules User Guide...
Page 180
Operate in API mode Frame data Frame data fields Offset Example AT command 0x42 (B) 0x44 (D) Command status 0x00 Command data Checksum 0xF0 XBee 868LP RF Modules User Guide...
When a device powers up, it returns the following API frame. Frame data fields Offset Example Start delimiter 0x7E Length MSB 1 0x00 LSB 2 LSB 2 0x02 Frame type 0x8A Status 0x00 Checksum 0x75 XBee 868LP RF Modules User Guide...
In the following example, the destination device reports a successful unicast data transmission. The outgoing Transmit Request that this response frame uses Frame ID of 0x47. Frame Fields Offset Example Start delimiter 0x7E Length MSB 1 0x00 LSB 2 0x07 Frame type 0x8B Frame ID 0x47 XBee 868LP RF Modules User Guide...
Page 183
Operate in API mode Frame data Frame Fields Offset Example Reserved 0xFF 0xFE Transmit retry count 0x00 Delivery status 0x00 Discovery status 0x02 Checksum 0x2E XBee 868LP RF Modules User Guide...
(serial number 0x0013A200 4052AAAA) to another (serial number 0x0013A200 4052DDDD). This particular frame indicates that the network successfully forwards the transmission from one device (serial number 0x0013A200 4052BBBB) to another device (serial number 0x0013A200 4052CCCC). XBee 868LP RF Modules User Guide...
In the following example, a device with destination address (DH/DL) of 0x0013A200 4052AAAA updates its destination address to 0x0013A200 4052BBBB. Frame data fields Offset Example Start delimiter 0x7E Length MSB 1 0x00 LSB 2 0x12 Frame type 0x8E Format ID 0x00 XBee 868LP RF Modules User Guide...
Page 188
Operate in API mode Frame data Frame data fields Offset Example New address MSB 5 0x00 0x13 0xA2 0x00 0x40 0x52 0xBB LSB 12 0xBB Old address 0x00 0x13 0xA2 0x00 0x40 0x52 0xAA 0xAA Checksum 0x2E XBee 868LP RF Modules User Guide...
RxData. If AO=0 on the receiving device, it sends the following frame out its serial interface. Frame data fields Offset Example Start delimiter 0x7E Length MSB 1 0x00 LSB 2 0x12 0x90 Frame type XBee 868LP RF Modules User Guide...
Page 190
Frame data fields Offset Example MSB 4 0x00 64-bit source address 0x13 0xA2 0x00 0x40 0x52 0x2B LSB 11 0xAA Reserved 0xFF 0xFE Receive options 0x01 Received data 0x52 0x78 0x44 0x61 0x74 0x61 Checksum 0x11 XBee 868LP RF Modules User Guide...
If a device sends the transmission: With source and destination endpoints of 0xE0 Cluster ID = 0x2211 Profile ID = 0xC105 If AO = 1 on the receiving device, it sends the following frame out its serial interface. XBee 868LP RF Modules User Guide...
Page 192
0x2B LSB 11 0xAA Reserved 0xFF 0xFE Source endpoint 0xE0 Destination endpoint 0xE0 Cluster ID 0x22 0x11 Profile ID 0xC1 0x05 Receive options 0x02 Received data 0x52 0x78 0x44 0x61 0x74 0x61 Checksum 0x56 XBee 868LP RF Modules User Guide...
AD1. It reads the digital lines to be 0x0014 and the analog sample value is 0x0225. The complete example frame is: 7E00 1492 0013 A200 4052 2BAA FFFE 0101 001C 0200 1402 25F9 XBee 868LP RF Modules User Guide...
Page 194
MSB 12 0xfffe LSB 13 0x84 Receive options 0x01 Number of samples 0x01 Digital channel mask 0x00 0x1C Analog channel mask 0x02 Digital samples (if included) 0x00 0x14 Analog sample 0x02 0x25 Checksum 0xF5 XBee 868LP RF Modules User Guide...
MSB first, LSB last. Indicates the 64-bit address of the remote device that 17-24 remote transmitted the Node Identification Indicator frame. address NI string 25-26 Node identifier string on the remote device. The NI string is terminated with a NULL byte (0x00). Reserved Reserved. 27-28 XBee 868LP RF Modules User Guide...
Page 196
For more options, see NO (Node Discovery Options). Source event 1=Frame sent by node identification pushbutton event. Digi Profile ID 31-32 Set to the Digi application profile ID. Digi 33-34 Set to the Digi Manufacturer ID. Manufacturer Digi DD value Reports the DD value of the responding device.
Page 197
0x20 0x00 Reserved 0xFF 0xFE Device type 0x01 Source event 0x01 Digi Profile ID 0xC1 0x05 Digi Manufacturer ID 0x10 0x1E Digi DD value 0x00 (optional) 0x0C 0x00 0x00 RSSI (optional) 0x2E Checksum 0x33 XBee 868LP RF Modules User Guide...
SL command, and if the frame ID = 0x55, the response would look like the following example. Frame data fields Offset Example Start delimiter 0x7E Length MSB 1 0x00 LSB 2 0x13 XBee 868LP RF Modules User Guide...
Europe Europe The XBee XBee 868LP RF Modules (non-PRO versions only ) have been tested for use in several European countries. For a complete list, refer to www.digi.com. If the XBee RF Modules are incorporated into a product, the manufacturer must ensure compliance of the final product with articles 3.1a and 3.1b of the R&TTE Directive.
The surface-mount form factor has more I/O pins. Because the XBee device was originally offered in only the through-hole form factor, we offer this section to help you migrate from the through-hole to the surface-mount form factor. Pin mapping Mounting XBee 868LP RF Modules User Guide...
Migrate from XBee through-hole to surface-mount devices Pin mapping Pin mapping XBee 868LP RF Module modules are designed to be compatible with the XBee through-hole modules. The SMT modules have all the features of the through-hole modules, and offer the increased feature set.
We designed a footprint that allows either device to be attached to a PCB as shown in the following diagram. The dimensions without brackets are in inches, and those in brackets are in millimeters. XBee 868LP RF Modules User Guide...
Page 205
(see mapping). By using diagonal traces to connect the appropriate pins, the layout works for both modules. For information on attaching the SMT device, see Manufacturing information. XBee 868LP RF Modules User Guide...
Manufacturing information The surface-mount XBee 868LP RF Module is designed for surface-mount on the OEM PCB. It has castellated pads to allow for easy solder attach inspection. The pads are all located on the edge of the device so there are no hidden solder joints on these devices.
Hand soldering is possible and should be done in accordance with approved standards. Recommended footprint We recommend that you use the following PCB footprint for surface-mounting. The dimensions without brackets are in inches, and those in brackets are in millimeters. XBee 868LP RF Modules User Guide...
Page 208
RF test points on the bottom of the device as shown in the following diagram. These devices have a ground plane in the middle on the back side for shielding purposes, which can be affected by copper traces directly below the device. XBee 868LP RF Modules User Guide...
The device may be removed from the OEM PCB by the use of a hot air rework station, or hot plate. Be careful not to overheat the device. During rework, the device temperature may rise above its internal solder melting point and care should be taken not to dislodge internal components from their intended positions. XBee 868LP RF Modules User Guide...