Send A Firmware Image; Software Libraries; Xbee Network Assistant - Digi XBee 3 ZigBee User Manual

Configure the XBee 3 Zigbee RF Module
All serial communications with the module use 8 data bits, no parity bit, and 1 stop bit.
You can also invoke the bootloader from the XBee application by sending

Send a firmware image

After invoking the bootloader, a menu is sent out the UART at 115200 baud. To upload a firmware
image through the UART interface:
1. Look for the bootloader prompt BL > to ensure the bootloader is active.
2. Send an ASCII 1 character to initiate a firmware update.
3. After sending a 1, the device waits for an XModem CRC upload of a .gbl image over the serial
line at 115200 baud. Send the .gbl file to the device using standard XMODEM-CRC.
If the firmware image is successfully loaded, the bootloader outputs a "complete" string. Invoke the
newly loaded firmware by sending a 2 to the device.
If the firmware image is not successfully loaded, the bootloader outputs an "aborted string". It return
to the main bootloader menu. Some causes for failure are:
Over 1 minute passes after the command to send the firmware image and the first block of the
n
image has not yet been sent.
A power cycle or reset event occurs during the firmware load.
n
A file error or a flash error occurs during the firmware load. The following table contains errors
n
that could occur during the XMODEM transfer.
Error Cause
0x18 This error is observed when a serial upload attempt
has been abruptly discontinued by invoking Ctrl+C
and subsequently another attempt is made to
upload a gbl by pressing 1 on the bootloader menu.

Software libraries

One way to communicate with the XBee 3 Zigbee RF Module is by using a software library. The
libraries available for use with the XBee 3 Zigbee RF Module include:
XBee Java library
n
XBee Python library
n
The XBee Java Library is a Java API. The package includes the XBee library, its source code and a
collection of samples that help you develop Java applications to communicate with your XBee devices.
The XBee Python Library is a Python API that dramatically reduces the time to market of XBee
projects developed in Python and facilitates the development of these types of applications, making it
an easy process.

XBee Network Assistant

The XBee Network Assistant is an application designed to inspect and manage RF networks created
by Digi XBee devices. Features include:
Digi XBee® 3 Zigbee® RF Module
Send a firmware image
%P (Invoke Bootloader).
Workaround
Press 2 on the bootloader menu. The
bootloader performs a reboot and the
menu gets displayed again. Now
press 1 and begin uploading the gbl.
21