Digi XBee 868LP User Manual
  1. Manuals
  2. Brands
  3. Digi Manuals
  4. Control Unit
  5. XBee 868LP
  6. User manual

Digi XBee 868LP User Manual

Radio frequency (rf) modules
Hide thumbs Also See for XBee 868LP:
Table of Contents

Advertisement

Quick Links

Download this manual
XBee® 868LP
Radio Frequency (RF) Modules
User Guide

Advertisement

Table of Contents
loading

Related Manuals for Digi XBee 868LP

Summary of Contents for Digi XBee 868LP

  • Page 1 XBee® 868LP Radio Frequency (RF) Modules User Guide...
  • 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 Feedback To provide feedback on this document, email your comments to techcomm@digi.com Include the document title and part number (XBee 868LP RF Modules User Guide, 90002126 S) in the subject line of your email. XBee 868LP RF Modules User Guide...

  • Page 4: Table Of Contents

    Contents XBee 868LP RF Modules User Guide XBee S8 hardware description European acceptance Technical specifications Performance specifications LBT and AFA specifications Power requirements General specifications Networking and security Regulatory conformity summary Serial communication specifications UART pin assignments SPI pin assignments...
  • Page 5 Port in use XCTU cannot discover devices XCTU cannot discover remote devices XCTU cannot discover remote devices for a range test XCTU installation error Configure the XBee 868LP RF Module Software libraries XBee Network Assistant Operation Operation Listen Before Talk and Automatic Frequency Agility...
  • Page 6 Send a remote command Apply changes on remote devices Remote command responses Network commissioning and diagnostics Configure devices Network link establishment and maintenance Place devices Device discovery Link reliability Commissioning pushbutton and associate LED I/O line monitoring XBee 868LP RF Modules User Guide...
  • Page 7 Broadcast addressing Routing Route discovery DigiMesh throughput Transmission timeouts AT commands Special commands AC (Apply Changes) FR (Software Reset) RE (Restore Defaults) WR (Write MAC/PHY commands CM (Channel Mask) HP (Preamble ID) ID (Network ID) XBee 868LP RF Modules User Guide...
  • Page 8 BD (Baud Rate) NB (Parity) SB (Stop Bits) RO (Packetization Timeout) FT (Flow Control Threshold) AP (API Mode) AO (API Options) I/O settings commands CB (Commissioning Pushbutton) D0 (AD0/DIO0 Configuration) D1 (DIO1/AD1) D2 (DIO2/AD2) XBee 868LP RF Modules User Guide...
  • Page 9 Command mode options CC (Command Sequence Character) CT (Command Mode Timeout) CN (Exit Command Mode) GT (Guard Times) Firmware commands VL (Version Long) VR (Firmware Version) HV (Hardware Version) HS (Hardware Series) DD (Device Type Identifier) XBee 868LP RF Modules User Guide...
  • Page 10 Migrate from XBee through-hole to surface-mount devices Pin mapping Mounting Manufacturing information Recommended solder reflow cycle Recommended footprint and keepout Flux and cleaning Reworking Regulatory information Europe Maximum power and frequency specifications OEM labeling requirements Declarations of conformity Antennas XBee 868LP RF Modules User Guide...

  • Page 11: 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.

  • Page 12: Xbee S8 Hardware Description

    Analog Devices ADF7023 radio transceiver, and in the Programmable version, a NXP MC9S08QE32 microcontroller. 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 Regulatory information.

  • Page 13: Technical Specifications

    Technical specifications Performance specifications LBT and AFA specifications Power requirements General specifications Networking and security Regulatory conformity summary Serial communication specifications GPIO specifications Hardware specifications for the programmable variant XBee 868LP RF Modules User Guide...

  • Page 14: Performance Specifications

    To determine your indoor/urban range or outdoor RF line-of-sight range, perform a range test under your operating conditions. LBT and AFA specifications The following table provides the Listen Before Talk (LBT) and Adaptive Frequency Agility (AFA) specifications. XBee 868LP RF Modules User Guide...

  • Page 15: Power Requirements

    LBT threshold < -88 dBm TX on time < 1 second Power requirements The following table describes the power requirements for the XBee 868LP RF Module. XBee Specification Supply voltage (V 2.7 to 3.6 VDC Transmit current, high data rate...

  • Page 16: Networking And Security

    This table describes the agency approvals for the devices. Specification XBee Europe (CE) Serial communication specifications The XBee 868LP RF Module supports both Universal Asynchronous Receiver / Transmitter (UART) and Serial Peripheral Interface (SPI) serial connections. UART pin assignments UART Pins Device Pin Number...

  • Page 17: Spi Pin Assignments

    For more information on SPI operation, see communications. GPIO specifications The 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.
  • Page 18 20 MHz Runtime current for 32 k running +1 mA at 1 MHz +0.5 µA typical Sleep current 1.8 VDC to V Range NXP Flexis 8-bit S08 microcontroller NXP S08QE Family Microcontroller Part number: MC9S08QE32 XBee 868LP RF Modules User Guide...

  • Page 19: Hardware

    Hardware Mechanical drawings Pin signals Design notes Module operation for the programmable variant Programmable XBee SDK XBee 868LP RF Modules User Guide...

  • Page 20: Mechanical Drawings

    Hardware Mechanical drawings 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 21 Do not connect [reserved]* Disabled Do not connect Ground [reserved] Disabled Do not connect DIO4 Both Disabled GPIO DIO7 / CTS/ Both Output GPIO/Clear to Send Flow Control ON/SLEEP/DIO9 Both Output GPIO/Module Status Indicator XBee 868LP RF Modules User Guide...

  • Page 22: Design Notes

    For designs using the programmable modules, we recommend an additional 10 µF decoupling cap near pin 2 of the device. The nearest proximity to pin 2 of the three caps should be in the following order: XBee 868LP RF Modules User Guide...

  • Page 23: Board Layout

    Recommended pin connections The only required pin connections for two-way communication are VDD, GND, DOUT and DIN. To support serial firmware updates, you must connect VDD, GND, DOUT, DIN, RTS, and DTR. XBee 868LP RF Modules User Guide...

  • Page 24: Design Notes For Pcb Antenna Devices

    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...

  • Page 25: Design Notes For Rf Pad Devices

    A microstrip generally requires less area on the PCB than a coplanar waveguide. We do not recommend using a stripline because sending the signal to different PCB layers can introduce matching and performance problems. XBee 868LP RF Modules User Guide...
  • Page 26 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 27 We do not recommend using a trace wider than the pad width, and using a very narrow trace (under 0.010") can cause unwanted RF loss. The following illustration shows PCB layer 2 of an example RF layout. XBee 868LP RF Modules User Guide...

  • Page 28: Module Operation For The Programmable Variant

    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.

  • Page 29: Programmable Xbee Sdk

    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.

  • Page 30: Get Started

    The XBee 868LP RF Modules support low-power, peer-to-peer or wireless mesh networks for Europe (868 MHz). The XBee 868LP RF Modules provide reliable delivery of data between remote devices. This guide shows you how to set up a mesh network using the DigiMesh protocol, send data between devices, and adjust XBee 868LP RF Module settings.

  • Page 31: Set Up The Devices

    To get started with your XBee RF module development kit, verify that your kit has all of the components and that you meet the system requirements. Verify kit contents The XBee 868LP RF Module development kit contains the following components: XBee U.FL module (3)

  • Page 32: Connect The Hardware

    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.

  • Page 33: Step 1: Download And Install Xctu

    Get started Set up the devices 1. Attach the XBee 868LP RF Modules to the development boards. 2. Attach the antennas to the devices. 3. Connect the USB cables to the development boards. CAUTION! Before you remove a device from a development board, make sure the board is not powered by a USB cable or a battery.
  • Page 34 5. Click the Anywhere radio button and, in the confirmation window, click Allow From Anywhere. Note We recommend you set this option back to Mac App Store or Mac App Store and identified developers once you have finished installing XCTU. XBee 868LP RF Modules User Guide...

  • Page 35: Step 2: Set Up Your First Wireless Connection

    These instructions show you how to add two devices to XCTU. However, you can use these instructions to add any number of devices. 1. Connect two XBee 868LP RF Modules to your computer using the USB cables. Connect the two shorter range XBee modules instead of the longer range XBee-PRO modules.
  • Page 36 1. Select the first XBee device. 2. Click the Load default firmware settings button In the following steps, type parameter letters in the Search box quickly find a parameter. 3. Configure the following parameters: ID: 2015 DH: 0013A200 XBee 868LP RF Modules User Guide...
  • Page 37 The default NI value is a blank space. Delete the space when you change the value. Check the network Once both XBee 868LP RF Modules are configured, use XCTU to check that they are in the same network and can see each other. XBee 868LP RF Modules User Guide...
  • Page 38 1. Click the Discover radio nodes in the same network button of XBEE_A. The XBee 868LP RF Module searches for radio modules in the same network. When the discovery process is finished, XCTU lists discovered devices found within the network in the Discovering remote devices dialog.

  • Page 39: Step 3: Create A Mesh Network

    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 3: Create a mesh network This section describes how to add a third XBee module to create a mesh network.
  • Page 40 Connect XBEE_B to a power supply (or laptop or portable battery) and move it away from XBEE_A until it is out of range. The approximate indoor range is 500 ft (150 m), and the approximate outdoor range is 2.5 miles (4 km). XBee 868LP RF Modules User Guide...
  • Page 41 Click the Add a radio module button d. 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 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...

  • Page 43: Step 4: Use Api Mode To Talk To Xbee Modules

    API Tx frames are the instructions that allow one XBee module to send data to another XBee module. In these instructions, XBEE_A uses the API frame type "Transmit Request" to send some text data to XBee 868LP RF Modules User Guide...
  • Page 44 6. In the Send a single frame area, click the Add new frame to the list button 7. In the Add API frame to the list dialog, click the Create frame using 'Frames Generator' tool button. XBee 868LP RF Modules User Guide...
  • Page 45 64-bit dest. address: MAC address of XBEE_B RF data: Type "Hello XBee_B!" in the ASCII tab 9. Click OK. 10. In the Add API frame to the list dialog, type a name for your frame. 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...

  • Page 47: Do More With Your Xbee Modules

    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...

  • Page 48: Configure Remote Devices

    Configure the first two devices in Transparent mode. 4. Disconnect XBEE_B from your computer and remove it from XCTU. 5. Connect XBEE_B to a power supply (or laptop or portable battery). The Radio Modules area should look something like this. XBee 868LP RF Modules User Guide...

  • Page 49: Set Up And Perform A Range Test

    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 9. Connect XBEE_B to a power supply (or laptop or portable battery) and move it away from XBEE_A to the desired location for the range test. The approximate indoor range is 500 ft (150 m), and the approximate outdoor range is 2.5 miles (4 km). XBee 868LP RF Modules User Guide...
  • Page 51 Place a metal box over an XBee module. Move the remote XBee module to a different room or floor of the building. The Received Signal Strength Indicator (RSSI) value will decrease and some packets may even be lost. XBee 868LP RF Modules User Guide...

  • Page 52: Configure Basic Synchronous Sleep Support

    The sleep support XBee device is always awake and can receive serial or over-the-air data at any time, whereas the synchronized sleeping devices cannot send or receive data during their sleep periods. When receivers are asleep, the messages are buffered and forwarded to their destination once they XBee 868LP RF Modules User Guide...
  • Page 53 4. Select XBEE_A and configure the following parameters: SM: 7 SO: 1 (preferred sleep coordinator) SP: 1F4 (hexidecimal) = 500 (decimal) x 10 ms = 5 seconds ST: 1388 (hexidecimal) = 5000 (decimal) x 1ms = 5 seconds XBee 868LP RF Modules User Guide...
  • Page 54 Once XBEE_B and XBEE_C sync up to the network, their wake and sleep times are controlled by the OS and OW settings on the sleep support node (XBEE_A). If you want to change the wake and sleep times, change the SP and ST values for XBEE_A. XBee 868LP RF Modules User Guide...
  • Page 55 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...
  • Page 56 Since XBEE_B is a synchronized sleeping module, it only transmits the part of the message that is typed while it is awake. In the illustration below, it was only able to transmit "Hello XBee_ A!" The CTS icon for XBEE_B turned off after this part of the message was typed. XBee 868LP RF Modules User Guide...

  • Page 57: Set Up Basic Encryption For An Xbee Network

    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.

  • Page 58: Learn More About Xbee Module Features

    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.

  • Page 59: Sleep Modes

    (0x7E). Troubleshooting If you get stuck while performing any of the tasks in this guide, try one of these troubleshooting tips. Cannot install device driver Device driver software was not successfully installed. XBee 868LP RF Modules User Guide...

  • Page 60: Use Leds To Identify Xbee Modules

    Check the XBee device orientation The angled "nose" of the XBee 868LP RF Module should match the lines on the silk screening of the board and point away from the USB socket on the development board.

  • Page 61: Port In Use

    Port in use Message: "The port is already in use by other applications." Condition The serial port where the local XBee 868LP RF Module is connected can only be in use by one application. Solution Make sure the connection with the XBee 868LP RF Module in the XCTU console is closed and there are no other applications using the port.

  • Page 62: Xctu Cannot Discover Remote Devices

    (LED off). When an XBee module is sleeping, XCTU cannot discover it, so press the Commissioning button to wake it up for 30 seconds. XCTU cannot discover remote devices XCTU does not discover remote XBee 868LP RF Module. Potential cause The devices do not have the appropriate values for the following parameters:...

  • Page 63: Xctu Installation Error

    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 64 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...

  • Page 65: Configure The Xbee 868Lp Rf Module

    Configure the XBee 868LP RF Module Software libraries XBee Network Assistant XBee 868LP RF Modules User Guide...

  • Page 66: Software Libraries

    Configure the XBee 868LP RF Module Software libraries Software libraries One way to communicate with the XBee 868LP RF Module is by using a software library. The libraries available for use with the XBee 868LP RF Module include: XBee Java library XBee Python library The XBee Java Library is a Java API.

  • Page 67: Operation

    Operation Operation Listen Before Talk and Automatic Frequency Agility Single frequency mode band mode Serial communications Configuration considerations Serial buffers UART flow control Force UART operation Serial interface protocols XBee 868LP RF Modules User Guide...

  • Page 68: Operation

    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.

  • Page 69: Single Frequency Mode Band Mode

    Low-asserted signals have a horizontal line over the signal name. Serial data A device sends data to the XBee 868LP RF Module's UART through pin 4 DIN as an asynchronous serial signal. When the device is not transmitting data, the signals should idle high.

  • Page 70: Spi Communications

    Enables serial communication with the slave (Slave Select) SPI_ATTN (Attention) Alerts the master that slave has data queued to send. The XBee 868LP RF Module asserts this pin as soon as data is available to send to the SPI master and it remains asserted until the SPI master has clocked out all available data.

  • Page 71: Spi Operation

    The XBee 868LP RF Module operates as a SPI slave only. This means an external master provides the clock and decides when to send data. The XBee 868LP RF Module supports an external clock rate of up to 3.5 Mb/s.
  • Page 72 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.

  • Page 73: Configuration Considerations

    SPI interface until a reset occurs. If you enable only the UART, the XBee 868LP RF Module uses only the UART, and ignores the SPI_SSEL. If you enable only the SPI, the XBee 868LP RF Module uses only the SPI, and ignores UART communications.

  • Page 74: Spi Parameters

    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.

  • Page 75: Cts Flow Control

    3. If you write these parameters to the device, the module comes up with the UART enabled on the next reset. Serial interface protocols The XBee 868LP RF Module supports both Transparent and Application Programming Interface (API) serial interfaces. XBee 868LP RF Modules User Guide...

  • Page 76: Transparent Operating Mode

    Simple interface All received serial data is transmitted unless the device is in Command mode Easy to support It is easier for an application to support Transparent operation and Command mode API mode features XBee 868LP RF Modules User Guide...
  • Page 77 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...
  • Page 78 Modes 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)

  • Page 79: Transmit Mode

    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 80: Enter Command Mode

    To read a parameter value stored in the device’s register, omit the parameter field. The preceding example changes NI (Node Identifier) to My XBee. XBee 868LP RF Modules User Guide...

  • Page 81: Response To At Commands

    Response to AT commands When using AT commands to set parameters the XBee 868LP RF Module responds with OK<cr> if successful and ERROR<cr> if not. For devices with a file system: ATAP1<cr>...

  • Page 82: Sleep Mode

    Sleep modes allow the device to enter states of low power consumption when not in use. XBee devices support both pin sleep, where the device enters sleep mode upon pin transition, and cyclic sleep, where the device sleeps for a fixed time. For more information, see Sleep modes. XBee 868LP RF Modules User Guide...
  • Page 83 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...

  • Page 84: Sleep Modes

    Once a device in Normal mode synchronizes with a sleeping network, you can put it into a sleep- compatible sleep mode at any time. Asynchronous pin sleep mode Set SM to 1 to enter asynchronous pin sleep mode. XBee 868LP RF Modules User Guide...

  • Page 85: Asynchronous Cyclic Sleep Mode

    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. If D7 = 1, the device de-asserts CTS while asleep. XBee 868LP RF Modules User Guide...

  • Page 86: Wake Timer

    To enable polling on a device, configure it as an end device with the CE command. When you enable polling, the device sends a poll request a minimum of once every 100 ms. When the device XBee 868LP RF Modules User Guide...

  • Page 87: Sleeping Routers

    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 88 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 89 Sleep modes Sleep coordinator sleep modes in the DigiMesh network XBee 868LP RF Modules User Guide...

  • Page 90: Become A Sleep Coordinator

    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 91 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...

  • Page 92: Select Sleep Parameters

    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...

  • Page 93: Add A New Node To An Existing Network

    Place the new node in range of the existing cyclic sleep node. Wake the existing node by holding down the Commissioning Pushbutton for two seconds, or until the node wakes. The existing node stays awake for 30 seconds and responds to sync requests while it is awake. XBee 868LP RF Modules User Guide...

  • Page 94: Change Sleep Parameters

    When this occurs the first task is to repair, replace, and strengthen the weak link with new and/or redundant devices to fix the problem and prevent it from occurring in the future. XBee 868LP RF Modules User Guide...

  • Page 95: Diagnostics

    Missed sync messages command Use the MS command to query the number of cycles that elapsed since the device received a sync message. XBee 868LP RF Modules User Guide...
  • Page 96 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...

  • Page 97: Advanced Application Features

    Advanced application features Remote configuration commands Network commissioning and diagnostics I/O line monitoring General Purpose Flash Memory General Purpose Flash Memory commands Over-the-air firmware updates XBee 868LP RF Modules User Guide...

  • Page 98: Remote Configuration Commands

    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...

  • Page 99: Network Link Establishment And Maintenance

    You can also use the AG command to update the routing table and DH/DL registers in the network after a device is replaced, and you can update the DH/DL registers of nodes in the network. XBee 868LP RF Modules User Guide...

  • Page 100: Place Devices

    The configuration steps for sending data to the loopback cluster ID depend on what mode the device is in. For details on setting the mode, see AP (API Mode). The following sections list the steps based on the device's mode. XBee 868LP RF Modules User Guide...

  • Page 101: Device Discovery

    Link reliability To install a successful mesh network, you must be able to determine where to place individual XBee devices to establish reliable links throughout the mesh network. XBee 868LP RF Modules User Guide...
  • Page 102 Payload size The size of the test packet. Use the MP command to query the maximum payload size for this device. Iterations The number of packets to send. Use a number between 1 and 4000. XBee 868LP RF Modules User Guide...
  • Page 103 Use the Trace Route API option of Tx Request Packets to transmit routing information packets to the originator of a DigiMesh unicast by the intermediate nodes. For a description of the API frames, see API operating mode. XBee 868LP RF Modules User Guide...

  • Page 104: Commissioning Pushbutton And Associate Led

    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 105 Network commissioning and diagnostics TH RF Module A pushbutton and an LED can be connected to the 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 106 The device has power and is operating properly 1, 4, 5 The device is in a low power mode 1, 4, 5 On, blinking The device has power, is awake and is operating properly XBee 868LP RF Modules User Guide...

  • Page 107: I/O Line Monitoring

    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 108 9 = ON_SLEEP / DIO9 bit 10 = RSSI/DIO10 bit 11 = PWM/DIO11 bit 12 = CD/DIO12 For example, a digital channel mask of 0x002F means DIO0,1,2,3, and 5 are enabled as digital I/O. XBee 868LP RF Modules User Guide...

  • Page 109: Periodic I/O Sampling

    A device with sleep enabled transmits periodic I/O samples at the IR rate until the ST time expires and the device can resume sleeping. For more information about setting sleep modes, see Sleep modes. XBee 868LP RF Modules User Guide...

  • Page 110: Detect Digital I/O Changes

    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.

  • Page 111: Work With Flash Memory

    0s to binary 1s. For this reason, you should erase a flash block before performing a write operation. When performing an erase operation, you must erase the entire flash memory block—you cannot erase parts of a flash memory block. XBee 868LP RF Modules User Guide...

  • Page 112: General Purpose Flash Memory Commands

    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.

  • Page 113: Erase (0X01)

    No data bytes are specified for this command. Example To erase flash block 42 of a target radio with serial number of 0x0013a200407402ac format an ERASE packet as follows (spaces added to delineate fields): XBee 868LP RF Modules User Guide...

  • Page 114: Write (0X02) And Erase_Then_Write (0X03)

    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 GPM_START_INDEX Matches the parameter passed in the request frame XBee 868LP RF Modules User Guide...

  • Page 115: Read (0X04)

    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 116: Firmware_Verify (0X05) And Firmware_Verify_And_Install(0X06)

    This field is unused for this command. Set to 0. GPM_START_INDEX This field is unused for this command. Set to 0. GPM_NUM_BYTES This field is unused for this command. Set to 0. GPM_DATA This field is unused for this command XBee 868LP RF Modules User Guide...

  • Page 117: Firmware_Verify_Response (0X85)

    GPM is valid, 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 85 00 0000 0000 0000 5F XBee 868LP RF Modules User Guide...

  • Page 118: Over-The-Air Firmware Updates

    128 byte packet every 30 seconds minimizes network disruption. For this reason, you would divide and address the .ebin as follows: GPM_BLOCK_NUM GPM_START_INDEX GPM_NUM_BYTES .ebin bytes 0 to 127 128 to 255 256 to 383 384 to 511 512 to 639 640 to 767 XBee 868LP RF Modules User Guide...

  • Page 119: Verify The New Application

    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...

  • Page 120: Networking Methods

    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...

  • Page 121: Directed Broadcast/Repeater Mode

    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. Selective acknowledgments. Only the destination node will reply to route requests. XBee 868LP RF Modules User Guide...

  • Page 122: Digimesh Feature Set

    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...

  • Page 123: Networking Concepts

    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. Sending frequent broadcast transmissions can quickly reduce the available network bandwidth. Use broadcast transmissions sparingly. XBee 868LP RF Modules User Guide...

  • Page 124: Routing

    Throughput in a DigiMesh network can vary due to a number of variables, including: The number of hops. If you enable or disable encryption. Sleeping end devices. Failures and route discoveries. The results apply to the 80 kb/s version, 115.2 kb/s serial data rate, 100 KB. XBee 868LP RF Modules User Guide...

  • Page 125: Transmission Timeouts

    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 amount of time XBee 868LP RF Modules User Guide...
  • Page 126 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 127: At Commands

    Network commands Addressing commands Addressing discovery/configuration commands Diagnostic - addressing commands Security commands Serial interfacing commands I/O settings commands I/O sampling commands Sleep commands Diagnostic - sleep status/timing commands Command mode options Firmware commands XBee 868LP RF Modules User Guide...

  • Page 128: Special Commands

    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...

  • Page 129: Mac/Phy Commands

    Devices must have the same network identifier to communicate with each other. 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. Parameter range 0 - 0x7FFF XBee 868LP RF Modules User Guide...

  • Page 130: Mt (Broadcast Multi-Transmits)

    Sets or displays the power level at which the device transmits conducted power. Power levels are approximate. 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 EIRP...

  • Page 131: Ed (Energy Detect)

    For example, if DB returns 0x60, then the RSSI of the last packet received was -96 dBm. The XBee 868LP RF Module 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.

  • Page 132: Er (Received Error Count)

    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...

  • Page 133: Ua (Mac Unicast Transmission Count)

    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...

  • Page 134: Bh (Broadcast Hops)

    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. XBee 868LP RF Modules User Guide...

  • Page 135: Mr (Mesh Unicast Retries)

    SL (Serial Number Low) Displays the lower 32 bits of the unique IEEE 64-bit RF extended address assigned to the XBee in the factory. Parameter range 0 - 0xFFFFFFFF [read-only] Default Set in the factory XBee 868LP RF Modules User Guide...

  • Page 136: Dh (Destination Address High)

    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 using DigiMesh, with network acknowledgments disabled. XBee 868LP RF Modules User Guide...

  • Page 137: Ni (Node Identifier)

    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. XBee 868LP RF Modules User Guide...

  • Page 138: Ci (Cluster Id)

    Parameter range 0x0 - 0x7 (bit field) 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.

  • Page 139: Addressing Discovery/Configuration Commands

    Discovers and reports all devices found in the network after a jittered time delay. For each discovered device, the following information is returned: MY<CR> (2 bytes) (always 0xFFFE) SH<CR> (4 bytes) SL<CR> (4 bytes) DB<CR> (Contains the detected signal strength of the response in negative dBm units) XBee 868LP RF Modules User Guide...

  • Page 140: Fn (Find Neighbors)

    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.) After (NT * 100) milliseconds, the command ends by returning a <CR>. ND also accepts a...

  • Page 141: Diagnostic - Addressing Commands

    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 XBee 868LP RF Modules User Guide...

  • Page 142: Serial Interfacing Commands

    230400 b/s 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 XBee 868LP RF Modules User Guide...

  • Page 143: Sb (Stop Bits)

    Set or display the flow control threshold. The device de-asserts CTS and/or send XOFF when FT bytes are in the UART receive buffer. It re- asserts CTS when less than FT-16 bytes are in the UART receive buffer. XBee 868LP RF Modules User Guide...

  • Page 144: Ap (Api Mode)

    API Rx Indicator - 0x90, this is for standard data frames. API Explicit Rx Indicator - 0x91, this is for Explicit Addressing data frames. Default I/O settings commands The following AT commands are I/O settings commands. XBee 868LP RF Modules User Guide...

  • Page 145: Cb (Commissioning Pushbutton)

    Description Disabled Commissioning Pushbutton Digital input Digital output, low Digital output, high Default D1 (DIO1/AD1) Sets or displays the DIO1/AD1 configuration (pin 32). Parameter range 0, 2 - 5 Parameter Description Disabled Commissioning button XBee 868LP RF Modules User Guide...

  • Page 146: D2 (Dio2/Ad2)

    Digital output, low Digital output, high Default D3 (DIO3/AD3) Sets or displays the DIO3/AD3 configuration (pin 30). Parameter range 0, 2 - 5 Parameter Description Disabled Digital input Digital output, low Digital output, high XBee 868LP RF Modules User Guide...

  • Page 147: D4 (Dio4/Ad4)

    Associate LED indicator - blinks when associated Digital input Digital output, default low Digital output, default high Default D6 (DIO6/RTS) Sets or displays the DIO6/RTS configuration (pin 29). Parameter range 0, 1, 3 - 5 XBee 868LP RF Modules User Guide...

  • Page 148: D7 (Dio7/Cts)

    Default D8 (DIO8/SLEEP_REQUEST) Sets or displays the DIO8/SLEEP_REQUEST configuration (pin 10). The XBee 868LP RF Module does not support sleep. The SLEEP_REQUEST option is provided for compatibility purposes and does not affect the device. Parameter range 0, 1, 3 - 5...

  • Page 149: D9 (Dio9/On_Sleep)

    ON/SLEEP output Digital input Digital output, low Digital output, high Default P0 (DIO10/RSSI/PWM0 Configuration) Sets or displays the PWM0/RSSI/DIO10 configuration (pin 7). Parameter range 0 - 5 Parameter Description Disabled RSSI PWM0 output PWM0 output XBee 868LP RF Modules User Guide...

  • Page 150: P1 (Dio11/Pwm1 Configuration)

    Digital output, low Digital output, high Default P2 (DIO12 Configuration) Sets or displays the DIO12 configuration (pin 5). Parameter range 0, 3 - 5 Parameter Description Disabled Digital input Digital output, low Digital output, high Default XBee 868LP RF Modules User Guide...

  • Page 151: P3 (Dio13/Dout)

    Description Disabled UART DIN/input Default P5 (SPI_MISO) Sets or displays the DIO15/SPI_MISO configuration (pin 17). Parameter range 0, 1 0, 1, 4, 5 Parameter Description Disabled SPI_MISO Digital output low Digital output high Default XBee 868LP RF Modules User Guide...

  • Page 152: P6 (Spi_Mosi Configuration)

    0, 1, 4, 5 Parameter Description Disabled SPI_SSEL Digital output low Digital output, high Default P8 (DIO18/SPI_SCLK) Sets or displays the DIO18/SPI_SCLK configuration (pin 14). Parameter range 0, 1, 4, 5 Parameter Description Disabled XBee 868LP RF Modules User Guide...

  • Page 153: P9 (Spi_Attn)

    If you set a PR bit to 0, it specifies no internal pull-up/down resistor. PR and PD only affect lines that are configured as digital inputs or disabled. The following table defines the bit-field map for PR and PD commands. XBee 868LP RF Modules User Guide...

  • Page 154: M0 (Pwm0 Duty Cycle)

    0 - 0xFFFFF (bit field) Default 0xFFFFF M0 (PWM0 Duty Cycle) The duty cycle of the PWM0 line (pin 7). Use the P0 command to configure the line as a PWM output. Parameter range 0 - 0x3FF Default XBee 868LP RF Modules User Guide...

  • Page 155: M1 (Pwm1 Duty Cycle)

    Default 0x28 (four seconds) I/O sampling commands The following AT commands configure I/O sampling parameters. AV (Analog Voltage Reference) The analog voltage reference used for A/D sampling. Parameter range 0 - 2 0, 1 XBee 868LP RF Modules User Guide...

  • Page 156: Ic (Dio Change Detection)

    IC is a bitmask that you can use to enable or disable edge detection on individual channels. Set unused bits to 0. I/O line DIO0 DIO1 DIO2 DIO3 DIO4 DIO5 DIO6 DIO7 DIO8 DIO9 DIO10 DIO11 DIO12 Parameter range 0 - 0xFFFF (bit field) Default XBee 868LP RF Modules User Guide...

  • Page 157: If (Sleep Sample Rate)

    The current module temperature in degrees Celsius in 8-bit two’s compliment format. For example 0x1A = 26 °C, and 0xF6 = -10 °C. Parameter range 0 - 0xFF [read-only] Default IS (Force Sample) Forces a read of all enabled digital and analog input lines. Parameter range Default XBee 868LP RF Modules User Guide...

  • Page 158: Voltage Supply Monitoring)

    Set or read the sleep options bit field of a device. This command is a bitmask. You cannot set bit 0 and bit 1 at the same time. Parameter range 0 - 0x13E [bit field] For synchronous sleep devices, the following sleep bit field options are defined: XBee 868LP RF Modules User Guide...

  • Page 159: Sn (Number Of Cylcles Between On_Sleep)

    For a node operating as an Indirect Messaging Coordinator, this command defines the amount of time that it will hold an indirect message for an end device. The coordinator will hold the message for (2.5 * SP). Parameter range 0x1 - 0x15F900 (x 10 ms) XBee 868LP RF Modules User Guide...

  • Page 160: St (Wake Time)

    Queries a number of Boolean values that describe the device's status. Description This bit is true when the network is in its wake state. This bit is true if the node currently acts as a network sleep coordinator. XBee 868LP RF Modules User Guide...

  • Page 161: Os (Operating Sleep Time)

    If the device synchronizes with a sleeping router network, OW may differ from ST. Parameter range [read-only] Default MS (Missed Sync Messages) Reads the number of sleep or wake cycles since the device received a sync message. Supported in the 80k firmware only. XBee 868LP RF Modules User Guide...

  • Page 162: Sq (Missed Sleep Sync Count)

    Idle mode from Command mode. Parameter range 2 - 0x1770 (x 100 ms) Default 0x64 (10 seconds) CN (Exit Command Mode) Immediately exits Command Mode and applies pending changes. XBee 868LP RF Modules User Guide...

  • Page 163: Gt (Guard Times)

    Reads the firmware version on a device. Parameter range 0 - 0xFFFFFFFF [read-only] Default Set in firmware HV (Hardware Version) Display the hardware version number of the device. Parameter range 0 - 0xFFFF [read-only] XBee 868LP RF Modules User Guide...

  • Page 164: Hs (Hardware Series)

    0 - 0xFFFF [read-only] Default Set in the firmware DD (Device Type Identifier) Stores the Digi device type identifier value. Use this value to differentiate between multiple XBee devices. If you change DD, RE (Restore Defaults) will not restore defaults. The only way to get DD back to default values is to explicitly set it to defaults.

  • Page 165: Operate In Api Mode

    Operate in API mode API mode overview Frame data XBee 868LP RF Modules User Guide...

  • Page 166: Api Mode Overview

    Frame fields Byte Description Start delimiter 1 0x7E Length 2 - 3 Most Significant Byte, Least Significant Byte Characters escaped if needed Frame data 4 - n API-specific structure Checksum n + 1 1 byte XBee 868LP RF Modules User Guide...

  • Page 167: Data Bytes That Need To Be Escaped

    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...

  • Page 168: Calculate And Verify Checksums

    Consider the following sample data packet: 7E 00 0A 01 01 50 01 00 48 65 6C 6C 6F B8+ Byte(s) Description Start delimiter 00 0A Length bytes API identifier API frame ID 50 01 Destination address low XBee 868LP RF Modules User Guide...

  • Page 169: Api Frame Exchanges

    Subtract 0x47 from 0xFF and you get 0xB8 (0xFF - 0x47 = 0xB8). 0xB8 is the checksum for this data packet. If an API data packet is composed with an incorrect checksum, the XBee 868LP RF Module will consider the packet invalid and will ignore the data.

  • Page 170: Code To Support Future Api Frames

    API frames that are sent out the device's DOUT pin: void XBee_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 XBee 868LP RF Modules User Guide...

  • Page 171: Frame Data

    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...

  • Page 172: At Command Frame - 0X08

    Frame data fields Offset Example Start delimiter 0x7E Length MSB 1 0x00 LSB 2 0x04 Frame type 0x08 Frame ID 0x52 (R) AT command 0x4E (N) 0x48 (H) Parameter value (optional) Checksum 0x0F XBee 868LP RF Modules User Guide...

  • Page 173: At Command - Queue Parameter Value Frame - 0X09

    In this example, you could send the parameter as a zero-padded 2-byte or 4-byte value. Frame data fields Start delimiter 0x7E Length MSB 1 0x00 LSB 2 0x05 Frame type 0x09 Frame ID 0x01 XBee 868LP RF Modules User Guide...
  • Page 174 Operate in API mode Frame data Frame data fields AT command 0x42 (B) 0x44 (D) Parameter value (BD7 = 115200 baud) 0x07 Checksum 0x68 XBee 868LP RF Modules User Guide...

  • Page 175: Transmit Request Frame - 0X10

    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. XBee 868LP RF Modules User Guide...
  • Page 176 0x16 Frame type 0x10 Frame ID 0x01 64-bit destination MSB 5 0x00 address 0x13 0xA2 0x00 0x40 0x0A 0x01 LSB 12 0x27 0xFF Reserved MSB 13 0xFE LSB 14 Broadcast radius 0x00 Options 0x40 XBee 868LP RF Modules User Guide...
  • Page 177 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...

  • Page 178: Explicit Addressing Command Frame - 0X11

    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 179 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...
  • Page 180 MSB 13 0xFE LSB 14 Source endpoint 0xA0 Destination endpoint 0xA1 Cluster ID 0x15 0x54 Profile ID 0xC1 0x05 Broadcast radius 0x00 Transmit options 0x00 Data payload 0x54 0x78 0x44 0x61 0x74 0x61 Checksum 0xDD XBee 868LP RF Modules User Guide...

  • Page 181: Remote At Command Request Frame - 0X17

    Change the broadcast hops register on a remote device to 1 (broadcasts go to 1-hop neighbors only). 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 XBee 868LP RF Modules User Guide...
  • Page 182 64-bit destination address MSB 5 0x00 0x13 0xA2 0x00 0x40 0x40 0x11 LSB 12 0x22 Reserved 0xFF 0xFE Remote command options 0x02 (apply changes) AT command 0x42 (B) 0x48 (H) Command parameter 0x01 Checksum 0xF5 XBee 868LP RF Modules User Guide...

  • Page 183: At Command Response Frame - 0X88

    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 XBee 868LP RF Modules User Guide...
  • Page 184 MSB 1 0x00 LSB 2 0x05 Frame type 0x88 Frame ID 0x01 AT command 0x42 (B) 0x44 (D) Command status 0x00 Command data (No command data implies the parameter was set rather than queried) Checksum 0xF0 XBee 868LP RF Modules User Guide...

  • Page 185: Modem Status Frame - 0X8A

    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...

  • Page 186: Transmit Status Frame - 0X8B

    Example 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 XBee 868LP RF Modules User Guide...
  • Page 187 Frame data Frame Fields Offset Example Length MSB 1 0x00 LSB 2 0x07 Frame type 0x8B Frame ID 0x47 Reserved 0xFF 0xFE Transmit retry count 0x00 Delivery status 0x00 Discovery status 0x02 Checksum 0x2E XBee 868LP RF Modules User Guide...

  • Page 188: Route Information Packet Frame - 0X8D

    The following example represents a possible Route Information Packet. A device receives the packet when it performs a trace route on a transmission from one device (serial number 0x0013A200 4052AAAA) to another (serial number 0x0013A200 4052DDDD). XBee 868LP RF Modules User Guide...
  • Page 189 0X2B Timestamp MSB 6 0x9C 0x93 0x81 LSB 9 0x7F ACK timeout count 0x00 TX blocked count 0x00 Reserved 0x00 Destination address MSB 13 0x00 0x13 0xA2 0x00 0x40 0x52 0xAA LSB 20 0xAA XBee 868LP RF Modules User Guide...
  • Page 190 0xDD LSB 28 0xDD Responder address MSB 29 0x00 0x13 0xA2 0x00 0x40 0x52 0xBB LSB 36 0xBB Receiver address MSB 37 0x00 0x13 0xA2 0x00 0x40 0x52 0xCC LSB 44 0xCC Checksum 0xCE XBee 868LP RF Modules User Guide...

  • Page 191: Aggregate Addressing Update Frame - 0X8E

    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 192 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...

  • Page 193: Receive Packet Frame - 0X90

    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 194 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...

  • Page 195: Explicit Rx Indicator Frame - 0X91

    Received RF data. Example In the following example, a device with a 64-bit address of 0x0013A200 40522BAA sends a broadcast data transmission to a remote device with payload RxData. If a device sends the transmission: XBee 868LP RF Modules User Guide...
  • Page 196 64-bit source address MSB 4 0x00 0x13 0xA2 0x00 0x40 0x52 0x2B LSB 11 0xAA Reserved 0xFF 0xFE Source endpoint 0xE0 Destination endpoint 0xE0 Cluster ID 0x22 0x11 Profile ID 0xC1 0x05 Receive options 0x02 XBee 868LP RF Modules User Guide...

  • Page 197: Data Sample Rx Indicator Frame - 0X92

    0), these two bytes contain samples for all enabled digital I/O lines. DIO lines that do not have sampling enabled return 0. Bits in these two bytes map the same as they do in the Digital channel mask field. XBee 868LP RF Modules User Guide...
  • Page 198 MSB 4 0x00 0x13 0xA2 0x00 0x40 0x52 0x2B LSB 11 0xAA Reserved MSB 12 0xfffe LSB 13 0x84 Receive options 0x01 Number of samples 0x01 Digital channel mask 0x00 0x1C Analog channel mask 0x02 XBee 868LP RF Modules User Guide...
  • Page 199 Operate in API mode Frame data Frame fields Offset Example Digital samples (if included) 0x00 0x14 Analog sample 0x02 0x25 Checksum 0xF5 XBee 868LP RF Modules User Guide...

  • Page 200: Node Identification Indicator Frame - 0X95

    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 201 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 202 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...

  • Page 203: Remote Command Response Frame - 0X97

    If a device sends a remote command to a remote device with 64-bit address 0x0013A200 40522BAA to query the SL command, and if the frame ID = 0x55, the response would look like the following example. Frame data fields Offset Example Start delimiter 0x7E XBee 868LP RF Modules User Guide...
  • Page 204 64-bit source (remote) address MSB 5 0x00 0x13 0xA2 0x00 0x40 0x52 0x2B LSB 12 0xAA Reserved 0xFF 0xFE AT commands 0x53 0x4C Command status 0x00 Command data 0x40 0x52 0x2B 0xAA Checksum 0xF4 XBee 868LP RF Modules User Guide...

  • Page 205: Migrate From Xbee Through-Hole To Surface-Mount Devices

    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...

  • Page 206: Pin Mapping

    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.

  • Page 207: Mounting

    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 208 (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...

  • Page 209: Manufacturing Information

    Manufacturing information The XBee 868LP RF Module is designed for surface-mounting on the OEM PCB. It has castellated pads to allow for easy solder attaching and inspection. The pads are all located on the edge of the device so there are no hidden solder joints on these devices.

  • Page 210: Recommended Solder Reflow Cycle

    Match the solder footprint to the copper pads, but may need to be adjusted depending on the specific needs of assembly and product standards. XBee 868LP RF Modules User Guide...
  • Page 211 RF test points on the bottom of the module (see below). Furthermore, these modules have a ground plane in the middle on the back side for shielding purposes, which can be affected by copper traces directly below the module. XBee 868LP RF Modules User Guide...

  • Page 212: Flux And Cleaning

    Never perform rework on the device itself. The device has been optimized to give the best possible performance, and reworking the device itself will void warranty coverage and certifications. We recognize that some customers choose to rework and void the warranty. The following information XBee 868LP RF Modules User Guide...
  • Page 213 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...

  • Page 214: Regulatory Information

    Regulatory information Europe Antennas XBee 868LP RF Modules User Guide...

  • Page 215: Europe

    Regulatory information Europe Europe The XBee 868LP RF Modules 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 EU Directive 2014/53/EU (Radio Equipment...

  • Page 216: Oem Labeling Requirements

    The CE marking must have a height of at least 5 mm except where this is not possible on account of the nature of the apparatus. The CE marking must be affixed visibly, legibly, and indelibly. XBee 868LP RF Modules User Guide...

  • Page 217: Declarations Of Conformity

    For more information, see www.digi.com/resources/certifications. Antennas The following antennas have been tested and approved for use with the XBee 868LP RF Module: All antenna part numbers followed by an asterisk (*) are not available from Digi. Consult with an antenna manufacturer for an equivalent option.

Table of Contents