General Purpose Flash Memory General Purpose Flash Memory commands
XBee®-PRO 900HP/XSC RF Modules
178
Field name Command-specific description
GPM_NUM_BYTES Set to the number of data bytes to be read. Only one GPM block can
be operated on per command. For this reason, GPM_START_INDEX +
GPM_NUM_BYTES cannot be greater than the GPM block size. The
number of bytes sent in an explicit API frame (including the GPM
command fields) cannot exceed the maximum payload size of the
device. You can query the maximum payload size with the NP AT
command.
GPM_DATA 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.
Field name Command-specific description
GPM_CMD_ID Should be set to READ_RESPONSE (0x84).
GPM_STATUS 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.
GPM_NUM_BYTES The number of bytes in the GPM_DATA field.
GPM_DATA The bytes read from the GPM block specified.
Example
To read 15 bytes of previously written data from flash block 22 of a target radio with serial number of
0x0013a200407402ac a READ packet should be formatted as follows (spaces added to delineate
fields):
7E 001C 11 01 0013A200407402AC FFFE E6 E6 0023 C105 00 C0 04 00 0016 0000 000F 3B
Assuming all transmissions were successful and that flash block 22 was previously written with
incrementing data, the following API packets would be output the source node's serial interface:
7E 0007 8B 01 FFFE 00 00 00 76
7E 0029 91 0013A200407402AC FFFE E6 E6 0023 C105 C1 84 00 0016 0000 000F
0102030405060708090A0B0C0D0E0F C3
FIRMWARE_VERIFY (0x05) and FIRMWARE_VERIFY_AND_INSTALL
(0x06)
Use the FIRMWARE_VERIFY and FIRMWARE_VERIFY_AND_INSTALL commands when remotely
updating firmware on a device. For more inoformation about firmware updates. These commands
check if the GPM contains a valid over-the-air update file. For the FIRMWARE_VERIFY_AND_INSTALL
command, if the GPM contains a valid firmware image then the device resets and begins using the
new firmware.