op_pk_interfering_pk_get()
Abstract
Obtains a reference to the interfering packet that prompted a pipeline stage invocation for another packet.
Syntax
op_pk_interfering_pk_get ()
| Argument | Type | Description |
|---|---|---|
| no arguments |
Return Type
Packet *
Pointer to the interfering packet (P₁, as described in Details) when called from a pipeline stage invoked for Pₙ; OPC_NIL otherwise.
Details
Packets arriving at a radio receiver potentially experience interference from other packets. Several radio pipeline stages (SNR, BER, and Error Allocation) are invoked both for a packet (P₁) being received and for each valid packet (Pₙ) also being received, to allow Pₙ to adjust to the start or end of any interference from P₁.
For example, Figure 49 shows reception of a packet (P₁) and two other valid packets (P₂ and P₃) whose reception overlaps P₁. The SNR pipeline stage will be invoked for P₁ and P₂ at time t_start. The BER and Error Allocation stages will be invoked for P₁ and P₃ at t_end.
Figure 49: Packet Interference Timing

Table 12-1 shows what will be returned by the op_pk_interfering_pk_get() and op_pk_transmission_phase_get() KPs when called from each pipeline stage invocation.
Table 12: Packet Interference KP Results
| Called from Pipeline Stage | For Packet | op_pk_interfering_pk_get() Return Value |
op_pk_transmission_phase_get() Return Value |
|---|---|---|---|
| SNR | P₁ | OPC_NIL |
OPC_PK_TRANSMISSION_RECV_START |
| SNR | P₂ | pointer to P₁ | OPC_PK_TRANSMISSION_RECV_START |
| BER, Error | P₁ | OPC_NIL |
OPC_PK_TRANSMISSION_RECV_END |
| BER, Error | P₃ | pointer to P₁ | OPC_PK_TRANSMISSION_RECV_END |
Purpose
This KP provides a way to identify the packet whose reception caused a pipeline stage to be invoked. This information is useful to allow complex power or noise computations that require information about both packets.
Errors
- None.
Reference
- Use the KP op_pk_transmission_phase_get() to get the transmission phase of the interfering packet.