Default Receiver Group Model (dra_rxgroup)
This section describes the functionality and implementation of the default model occupying stage zero of the Radio Transceiver Pipeline. This model is named dra_rxgroup. The source code is provided in the file dra_rxgroup.ps.c, which resides in the <reldir>/models/std/wireless directory. An alternate version of this stage, for networks not using receiver channel state information, is in the file dra_rxgroup_no_rxstate.ps.c.
Invocation Context
The Receiver Group Model pipeline stage is invoked once at simulation time 0 (before any begsim interrupts) to evaluate connectivity between each radio transmitter channel and each radio receiver channel in the network. It is different from other pipeline stages in that its invocation does not dynamically occur with each new packet transmission, nor does it operate on packets. (However, you can use the Radio package of Kernel Procedures to dynamically change and recalculate a transmitter channel’s receiver group in response to simulation events.) This initialization stage expects two arguments: the object ID of a transmitter channel and the object ID of a receiver channel.
Because this stage is invoked at simulation time 0, it is used to initialize the state information for each receiver channel. The receiver channel state information is used to pass information between stages in the default radio pipeline models.
The result of the Receiver Group Model invocation for a transmitter and receiver channel is a single integer value, interpreted as a Boolean (i.e., OPC_TRUE or OPC_FALSE) which indicates if there is the potential for communication between the transmitter channel and the receiver channel.
Receiver Eligibility
The purpose of the Receiver Group Model is to filter out ineligible receiver channels with respect to each transmitter channel, thus improving simulation performance. In the default model, dra_rxgroup, all receivers are considered as potential destinations. That is, this model always returns OPC_TRUE indicating that the receiver channel and transmitter channel have the potential to communicate.