DIGI 802.15.4 XBee 3 RF Module User Guide

June 3, 2024
DIGI

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:

Use case| AT commands| Use data relay frames with the host processor
---|---|---
AT configuration| ✓| ✓
XBee RR to XBee RR/XBee 3 configuration| | ✓
XBee RR to XBee RR/XBee 3 data| | ✓
Enable/disable| ✓|
Scan and send advertisements| ✓|
Send custom advertisements| ✓  *|

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.

Value of AV parameter| XBee RR analog reference| XBee 3 analog reference
---|---|---
0| 1.21 V| 1.25 V
1| 2.42 V| 2.5 V
3| VCC| VCC

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:

Type Value
XBee 3 0x0000
XBee RR 0x0001

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:

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

Considerations XBee 3 XBee RR Comments
Indoor/Urban range Up to 60 m (200 ft) Up to 60 m (200 ft) Same
Outdoor RF line-of-sight Up to 1200 m (4000 ft) Up to 1200 m (4000 ft) Same
Transmit power output 6.3 mW (+8 dBm) 6.3 mW (+8 dBm) Channel 26 max power
is +3 dBm Similar
Receive sensitivity -103 dBm -103 dBm Same
Operating current (transmit) 40 mA @ +3.3 V, + 8 dBm 32 mA at 3.3 V, +8 dBm

Improved
Operating current (receive)| 17 mA| 14 mA| Improved
Sleep current| 2 uA| 8 uA| Increased
Supply voltage| 2.1 – 3.6 V| 1.71 – 3.8 V| Improved
GPIO| | DIO 10 and 11 are not supported| Decreased
FCC ID| MCQ-XBEE3| MCQ-XBRR| You will need to change the label on the end product to show the appropriate regulatory ID
Industry Canada (IC) ID| 1846A-XBEE3| 1846A-XBRR|

High-power (PRO) variant

Considerations XBee 3 PRO Digi XBee Pro RR Comments
Indoor/Urban range Up to 90 m (300 ft) Up to 90 m (300 ft) Same
Outdoor RF line-of-sight Up to 3200 m (2 mi) Up to 3200 m (2 mi) Same
Transmit power output 79 mW (+19 dBm)
Channel 26 max power is +8 dBm 79 mW (+19 dBm)
Channel 26 max power is +3 dBm Similar
Receive sensitivity -103 dBm -103 dBm Same
Operating current (transmit) 135 mA @ +3.3 V, +19 dBm 193 mA @ 3.3 V, +19
dBm Increased
Operating current (receive) 17 mA 14 mA Improved
Sleep current 2 uA 8 uA Increased
Supply voltage 2.1 – 3.6 V 1.71 – 3.8 V Larger voltage range
GPIO DIO 10 and 11 are not supported Decreased
FCC ID MCQ-XBEE3 MCQ-XBPRR You will need to change the label on the end

product to show the appropriate regulatory ID
Industry Canada (IC) ID| 1846A-XBEE3| 1846A-XBPRR|

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

Current part number Description Migrate to
XB3-24ACM XBee RR PRO, 2.4 GHz, 802.15.4, Chip Ant, MMT XBRR-24ACM
XB3-24ACM-J XBee RR, 2.4 GHz, 802.15.4, Chip Ant, MMT XBRR-24ACM-J
XB3-24DMUM XBee RR PRO, 2.4 GHz, DigiMesh, U.FL Ant, MMT XBRR-24DMUM
XB3-24DMRM XBee RR PRO, 2.4 GHz, DigiMesh, RF Pad Ant, MMT XBRR-24DMRM
XB3-24Z8CM XBee RR PRO, 2.4 GHz, Zigbee, Chip Ant, MMT XBRR-24Z8CM
XB3-24Z8CM-J XBee RR, 2.4 GHz, Zigbee, Chip Ant, MMT XBRR-24Z8CM-J
XB3-24Z8PS XBee RR PRO, 2.4 GHz, Zigbee, PCB Ant, SMT XBRR-24Z8PS
XB3-24Z8PS-J XBee RR, 2.4 GHz, Zigbee, PCB Ant, SMT XBRR-24Z8PS-J
XB3-24Z8PT XBee RR PRO, 2.4 GHz, Zigbee, PCB Ant, XBRR-24Z8PT
XB3-24Z8PT-J XBee RR, 2.4 GHz, Zigbee, PCB Ant, XBRR-24Z8PT-J
XB3-24Z8RM XBee RR PRO, 2.4 GHz, Zigbee, RF Pad Ant, MMT XBRR-24Z8RM
XB3-24Z8RM-J XBee RR, 2.4 GHz, Zigbee, RF Pad Ant, MMT XBRR-24Z8RM-J
XB3-24Z8RM-R15 XBee RR PRO, 2.4 GHz, Zigbee, RF Pad Ant, MMT, T&R on 15″
reel XBRR-24Z8RM- R15
XB3-24Z8ST XBee RR PRO, 2.4 GHz, Zigbee, SMA Ant, Through-hole XBRR-24Z8ST
XB3-24Z8ST-J XBee RR, 2.4 GHz, Zigbee, SMA Ant, Through-hole XBRR-24Z8ST-J
XB3-24Z8UM XBee RR PRO, 2.4 GHz, Zigbee, U.FL Ant, MMT XBRR-24Z8UM
XB3-24Z8UM-J XBee RR, 2.4 GHz, Zigbee, U.FL Ant, MMT XBRR-24Z8UM-J
XB3-24Z8US XBee RR PRO, 2.4 GHz, Zigbee, U.FL Ant, SMT XBRR-24Z8US
XB3-24Z8US-J XBee RR, 2.4 GHz, Zigbee, U.FL Ant, SMT XBRR-24Z8US-J
XB3-24Z8UT XBee RR PRO, 2.4 GHz, Zigbee, U.FL Ant, Through-hole XBRR-24Z8UT
XB3-24Z8UT-J XBee RR, 2.4 GHz, Zigbee, U.FL Ant, Through-hole XBRR-24Z8UT-J

90002536 B

Documents / Resources

| DIGI 802.15.4 XBee 3 RF Module [pdf] User Guide
802.15.4, XBee 3, RF Module, XBee 3 RF Module, 802.15.4 XBee 3 RF Module, Module
---|---

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals