Sending Over-The-Air Firmware Upgrades - Digi XBee Manual

XBee® Wi-Fi RF Modules
Frame Fields
Number1
Number2
Packet ID
Application
Header
Encryption Pad
Command ID
Command Options
Number of Samples
Digital Mask
Analog Mask
Command
Specific Data
Digital Sample
Analog Sample

Sending Over-the-Air Firmware Upgrades

A network client can also use the XBee IP services to send a firmware upgrade to the
module. This is done by sending a frame formatted with an application header,
followed by a GPM header, following by GPM data. The format of the application
header is given above. The format of the various GPM headers is given in chapter 6, but
each of those GPM headers need to be preceded by an application header. The
following frame shows an example of the final step of a firmware upgrade process:
Packet Fields
Number1
Number2
Application
Packet ID
Header
EncPad
Command ID
Command Options
GPM_CMD_ID
GPM_OPTIONS
GPM_BLOCK_NUM
Command
Specific Data
GPM_START_INDEX
GPM_NUM_BYTES
GPM_DATA
© 2013 Digi International, Inc.
Offset Example
0 0x4242
2 0x0000 Number1 ^ Number2 = 0x4242
4 0x00
Reserved for later use (0 for now)
5 0x00
6 0x04 Indicates I/O Sample data
7 0x00 Options not available for this response
8 0x01 Indicates one sample set
MSB 9 0x01
Bit Mask. Each bit represents an enabled DIO line
starting with DIO0 at bit 0.
LSB 10 0x01
Bit Mask. Each bit represents an enabled ADC starting
11 0x02 with ADC0 at bit 0. This selects ADC1 for analog
sampling.
This field is only present if at least one DIO line is
MSB 12 0x00
enabled in the digital mask specified above. Each bit
LSB 13 0x01
represents a DIO line. Start with bit 0 for DIO0.
MSB 14 0x02 0x200 indicates that reading is half of VREF. For a
default VREF of 2.5V, 0x200 represents 1.25 volts on
LSB 15 0x00
ADC1 in this example.
Offset Example
0 0x4242 This is an easy number to create an accepted frame.
Number1 ^ Number2 = 0x4242 (This is an easy way to
2 0x0000
send a frame that software won't reject.)
4 0x00
Reserved for later use (0 for now)
5 0x00
6 0x03 General Purpose Memory Command
7 0x00 Don't request an acknowledgment
8 0x06 Firmware verify and install command
9 0x00
10 0x00
Reserved for later use (0 for now)
12 0x00
14 0x0000
16 This field is unused for this command
Description
Description
45