RF Core HAL
23.3.5 Immediate Commands for Data Queue Manipulation
The following commands are immediate commands used for data queue manipulation for all radio
operations that use data queues.
23.3.5.1 CMD_ADD_DATA_ENTRY: Add Data Entry to Queue
Command ID number: 0x0005
CMD_ADD_DATA_ENTRY is an immediate command that takes the parameters listed in
.
Table 23-50. CMD_ADD_DATA_ENTRY Command Format
Byte Index Field Name
Bits
Bit Field Name
Type
Description
0–1
commandNo
W
The command ID number
2–3
Reserved
Pointer to the queue structure to which the
4–7
pQueue
W
entry is added
8–11
pEntry
W
Pointer to the entry
On reception, the radio CPU appends the provided data entry to the queue indicated. The radio CPU
performs the following operations:
Set pQueue-> pLastEntry-> pNextEntry = pEntry
Set pQueue-> pLastEntry = pEntry
If either of the pointers pQueue or pEntry are invalid (that is, in an address range that is not memory or
without 32-bit word alignment), the command fails, and the radio CPU sets the result byte of CMDSTA to
ParError. If the queue specified in pQueue is set up not to allow entries to be appended (see
), the command fails, and the radio CPU sets the result byte of CMDSTA to QueueError.
23.3.5.2 CMD_REMOVE_DATA_ENTRY: Remove First Data Entry From Queue
Command ID number: 0x0006
CMD_REMOVE_DATA_ENTRY is an immediate command that takes the parameters listed in
.
Table 23-51. CMD_REMOVE_DATA_ENTRY Command Format
Byte Index
Field Name
Bits
Bit Field Name
Type
Description
0–1
commandNo
W
The command ID number
2–3
Reserved
Pointer to the queue structure from which the
4–7
pQueue
W
entry is removed
8–11
pEntry
R
Pointer to the entry that was removed
On reception, the radio CPU removes the first data entry from the queue indicated. The command returns
a pointer to the entry that was removed. The radio CPU performs the following operations:
Set pEntry = pQueue->pCurrEntry
Set pQueue->pCurrEntry = pEntry->pNextEntry
Set pEntry->status = Finished
If the pointer pQueue is invalid, the command fails, and the radio CPU sets the result byte of CMDSTA to
ParError. If the queue specified in pQueue is empty, the command fails, and the radio CPU sets the result
byte of CMDSTA to QueueError. If the entry to be removed is in the BUSY state, the command fails, and
the radio CPU sets the result byte of CMDSTA to QueueBusy.
1514
Radio
SWCU117C – February 2015 – Revised September 2015
Copyright © 2015, Texas Instruments Incorporated