General purpose flash memory
XLR PRO Radio Frequency (RF) Modem User Guide
69
Example:
To write 15 bytes of incrementing data to flash block 22 of a target radio with serial number of
0x0013a200407402ac a WRITE packet should be formatted as follows (spaces added to delineate fields):
7E 002B 11 01 0013A200407402AC FFFE E6 E6 0023 C105 00 C0 02 00 0016 0000 000F
0102030405060708090A0B0C0D0E0F C5
Assuming all transmissions were successful and that flash block 22 was previously erased, the following API
packets would be output the source node's serial interface:
7E 0007 8B 01 FFFE 00 00 00 76
7E 001A 91 0013A200407402AC FFFE E6 E6 0023 C105 C1 82 00 0016 0000 0000 4C
•
READ (0x04):
The READ command can be used to read the specified number of bytes from the GPM location
specified. Data can be queried from only one GPM block per 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.
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:
Field name
Command-specific description
GPM_CMD_ID
Set to READ (0x04).
GPM_OPTIONS
At present, there are no defined options for this command. Set this field to 0.
GPM_BLOCK_NUM
Set to the index of the GPM block to read.
GPM_START_INDEX
Set to the byte index within the GPM block where the data should be read.
GPM_NUM_BYTES
Set to the number of data bytes to read. Only one GPM block can be operated on per
command. For this reason, the GPM_START_INDEX plus the GPM_NUM_BYTES cannot be
greater than the GPM block size.
Note
The number of bytes sent in an explicit API frame (including the GPM command
fields) cannot exceed the maximum payload size of the radio. Use the ATNP
command to query the maximum payload size.
GPM_DATA
No data bytes should be specified for this command.
Field name
Command-specific description
GPM_CMD_ID
Set to READ_RESPONSE (0x84).
GPM_STATUS
A one (1) in the least-significant bit indicates an error occurred. All other bits are reserved.
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
Number of bytes in the GPM_DATA field.
GPM_DATA
Bytes read from the specified GPM block.