Digi 802.15.4 Xbee 3 Rf Module User Guide

802.15.4 XBee 3 RF Module DigiMesh
User Guide

Introduction

This guide will assist you with migration from the Digi XBee® 3 module to the Digi XBee RR module. While basic functionality and communication are similar and compatible, there are some differences to consider, which we describe in this guide, along with other migration considerations.
MicroPython
The XBee RR RF module does not support MicroPython mode.

Bluetooth

Bluetooth® Low Energy (BLE) is an RF protocol that enables you to connect your XBee device to another device Both devices must have BLE enabled. For example, you can use your cellphone to connect to your XBee device, and then from your phone, you can configure and program the device.
The XBee RR RF module offers basic BLE support. The XBee RR RF module supports acting as a peripheral device as described in getting started with BLE and BLE reference. BLE on the XBee RR is useful for configuring XBee RR modules remotely via an application. Scanning for and connecting to other peripheral devices is not available (MicroPython is needed).
Here’s a list of some of the additional things that you can do with Digi XBee RR and BLE:

• Securely configure an XBee RR from a phone or other BLE-capable device.
• Send advertisements from the XBee RR.
• Send custom configuration or data to a host processor using user data relay frames.
• Securely configure one XBee RR from another XBee RR or XBee 3. Note: this requires the use of a host processor.
• Securely send data between XBee RR modems. Note: this requires the use of a host processor.
• Securely bond to the XBee RR GATT server from an external device.

To utilize BLE on the Digi XBee RR, the XBee firmware provides the following mechanisms:

• AT commands (enable, XBee API security configuration, custom advertisement name)
• User data relay frames (BLE to serial)

The following table maps common use cases and the different mechanisms that support them. Note that most of these mechanisms are not mutually exclusive and can be combined to enhance your applications:

File system

The file system works mostly the same on the XBee RR RF module as it does on the XBee 3 except that there is no OTA support — its access is limited to the serial port only. Without MicroPython support, there is currently no use case for the file system on the XBee RR RF module. Almost any other device would be more useful for storing files.
IO and PWM
The DIO10 (PWM0/RSSI indicator) and DIO11 (PWM1) lines are not available on the XBee RR RF module. This means that the P0 and P1 commands are unavailable, as well as any other configuration related to those two lines. Additionally, DIO10 and DIO11 are tied together with a 4.7 kΩ resistor. The internal reference voltage used by the XBee RR RF module is different from that of the XBee 3. This affects the calculation used to determine a voltage from an ADC reading.

Compatibility options
The Legacy LQI calculation is now the only option for LQI compatibility. This means that either setting C8 bit 4 or leaving it as default will result in the same behavior. Digi does not recommend setting C8 bit 4, as Digi can’t guarantee that the bit won’t have different functionality in the future.
Power consumption
There are variances in the power consumption specifications between the XBee 3 and XBee RR. See the Hardware specifications table for details.
OTA updates
XBee RR firmware images are not compatible with XBee 3 firmware images, and vice-versa. OTA update servers should make sure to use the correct image for the radio they are updating, or the image will be rejected.
An OTA image can be identified by the Image Type field in the OTA file header. The value should be sent by the server in the Image Notify command and must match the value reported by the target device in the Query Next Image Request (see Create an OTA update server). The image type values for XBee RR and XBee 3 are:

Configuration

Using Digi® XCTU, you can load the appropriate firmware to fit your current needs within the regulatory guidance of the region of deployment. See the following user guides for more information:

• XBee RR Zigbee User Guide
• XBee RR DigiMesh® 2.4 User Guide
• XBee RR 802.15.4 User Guide

The ZigBee, DigiMesh®, and 802.15.4 protocols all run on the same XBee RR hardware and can be flashed on the modules as needed.
Boot time
The boot time of the XBee RR module may be different than the XBee 3 module. Boot times are subject to change between firmware loads and are not guaranteed. Applications should make the necessary checks of Clear to Send (CTS) or other pin signals to determine the readiness of the module.

Hardware specifications

See the XBee RR RF Module Hardware Reference Manual for more detail.
Low-power (non-PRO) variant

High-power (PRO) variant

XBee RR part number migration

The following table shows which Digi XBee RR module to migrate to depending on which XBee 3/ XBee 3-PRO module you are currently using.
For the latest list of available XBee RR modules, see below:
Part number migration

90002536 B