Radio Receiver Object
Radio receiver objects act as the entry points in a node for packets received on radio communication links. They can contain multiple channel objects, each of which can be accessed by appropriate radio transmitter channels in remote nodes via a radio link. The processes of detecting, demodulating, and error-correcting packets arriving over radio links are modeled to the extent that they affect the correct reception of a packet.
Receivers can have multiple output streams, each one corresponding to a separate radio channel, and each connected to another module in the node. There is a direct correspondence between output stream indices and channel indices. In other words, a packet that is received on radio channel j is forwarded on output stream j of the radio receiver module. Radio receivers are considered as data sources from the perspective of other modules within the node. Therefore, they cannot have incoming packet streams. A single exception is made to this rule to allow the receiver to connect to an antenna module via an input stream.
In the Node Editor, radio receivers are represented by default as square boxes with a circle representing the node, an inwardly directed arrow representing the direction of packet flow, and waves representing the propagation of the radio signal and the broadcast nature of the medium. The receiver’s name is displayed beneath the representation, shown in the following figure.
Figure 63: Radio Receiver Representation

Radio receiver objects are the interface between a node and the radio transmission medium. Because this communication medium is not explicitly represented by an object in the Network Domain, its attributes are located on the link end points. In other words, the link attributes are divided between the radio transmitter and the radio receiver. Each receiver object can participate in the simultaneous evaluation of multiple radio links. Properties associated with transmission are specified as attributes of the radio transmitter while properties associated with reception are specified as attributes of the radio receiver. To learn more about radio link modeling, refer to “Wireless Communication Basics” on page 4.
Radio Receiver Object Attributes
The built-in attributes of the radio receiver object are listed below, in alphabetical order.
Table 23: Radio Receiver Object Built-In Attributes
| Name | Data Type |
|---|---|
| ber model | typed file |
| bkgnoise model | typed file |
| channel | compound |
| ecc model | typed file |
| ecc threshold | double |
| error model | typed file |
| icon name | icon |
| inoise model | typed file |
| modulation | typed file |
| name | string |
| noise figure | double |
| power model | typed file |
| ragain model | typed file |
| snr model | typed file |
ber model
This attribute specifies the name of a compiled pipeline procedure capable of computing expected bit error rate for an incoming radio transmission. The default model is dra_ber, which evaluates the bit error rate based on average power signal-to-noise ratio and the specified modulation curve. The result of this pipeline stage is typically used in the error model stage of the transceiver pipeline to compute actual bit error rate.
If this attribute is set to NONE, the pipeline stage is skipped and the Simulation Kernel uses a default value, as described in “Default Models” on page 284.
Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write | read |
| Default Value | dra_ber | |
| Units | ||
| Constraints |
bkgnoise model
This attribute specifies the name of a compiled pipeline procedure that computes the background noise affecting incoming radio transmissions. The default model is dra_bkgnoise which accounts for a constant ambient noise level, and a constant thermal noise at the receiver. The result of this computation is typically used to calculate signal to noise ratio in the snr model stage of the Radio Transceiver Pipeline.
If this attribute is set to NONE, the pipeline stage is skipped and the Simulation Kernel uses a default value, as described in “Default Models” on page 284.
Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write | read |
| Default Value | dra_bkgnoise | |
| Units | ||
| Constraints |
channel
This attribute specifies the incoming channels supported by the receiver. It consists of any number of radio receiver channel objects, one for each channel supported by the receiver. The attributes of each individual channel are described in Radio Receiver Channel Object.
| Editing | Simulation | |
|---|---|---|
| Data Type | compound | compound |
| Access | read / write / promote | read |
| Default Value | ||
| Units | ||
| Constraints |
ecc model
This attribute specifies the name of a compiled pipeline procedure capable of determining the acceptability of an incoming radio transmission. The result of this pipeline stage decides whether or not the packet can be forwarded by the radio receiver module over one of its output streams and to the higher level modules in the node. The default model is dra_ecc which determines whether a packet can be accepted based on two tests. The first test eliminates packets which did not complete transmission. The second tests compares the proportion of bit errors with the value of ecc_threshold. If the proportion of bit errors is greater than this threshold, the packet is rejected.
If this attribute is set to NONE, the pipeline stage is skipped and the Simulation Kernel uses a default value, as described in “Default Models” on page 284.
Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write | read |
| Default Value | dra_ecc | |
| Units | ||
| Constraints |
ecc threshold
This attribute specifies the highest proportion of bit errors allowed in a packet in order for the packet to be accepted by the receiver and forwarded to an output stream. As an example, a receiver with an ecc threshold value of 0.20 cannot accept packets with more than 20 percent of their bits in error. This attribute provides a coarse model of error correction capability at the receiver module. The value of this attribute is typically used by the error correction stage (ecc model) of the Radio Transceiver Pipeline.
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write / promote | read / write |
| Default Value | 0.0 | |
| Units | errors / bit | |
| Constraints | 0.0 <= ecc threshold <= 1.0 |
error model
This attribute specifies the name of a compiled pipeline procedure capable of computing the number of bit errors in a segment of an incoming radio transmission. The default model is dra_error which allocates a number of bit errors to a packet segment based on the average bit error rate computed in the ber pipeline stage and the length of the segment. The result of this pipeline stage is typically used in the ecc model stage of the transceiver pipeline to determine packet acceptability.
If this attribute is set to NONE, the pipeline stage is skipped and the Simulation Kernel uses a default value, as described in “Default Models” on page 284.
Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write | read |
| Default Value | dra_error | |
| Units | ||
| Constraints |
icon name
This attribute is the name of the icon used to represent the radio receiver module in the node diagrams. Icons can be created with the icon editor. The value of this attribute has no effect on simulation behavior.
| Editing | Simulation | |
|---|---|---|
| Data Type | icon | N/A |
| Access | read / write | N/A |
| Default Value | ra_rx | |
| Units | ||
| Constraints |
inoise model
This attribute specifies the name of a compiled pipeline procedure capable of computing interference noise affecting a particular incoming radio transmission.
The default model is dra_inoise, which checks if a non-zero width collision has occurred. If it has, it increments the number of collisions for the packet, determines if the packets are interference or valid packets, and retrieves the received power level of the collided packets to compute their effect on each other. The result of this pipeline stage is typically used in the snr model stage of the transceiver pipeline to compute signal to noise ratio.
If this attribute is set to NONE, the pipeline stage is skipped and the Simulation Kernel uses a default value, as described in “Default Models” on page 284.
Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write | read |
| Default Value | dra_inoise | |
| Units | ||
| Constraints |
modulation
This attribute specifies the name of a modulation table used to look up the bit error rate as a function of the effective signal to noise ratio. Antenna tables can be constructed in the PDF Editor or via the External Model Access (EMA) package. The bit error rate calculation is typically performed in the ber model stage of the Radio Transceiver Pipeline. The calculated bit error rate is used in later stages to estimate the number of bit errors in each packet. This attribute is also used by the chanmatch model pipeline stage to determine whether a receiver and transmitter are compatible.
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write / promote | read / write |
| Default Value | bpsk | |
| Units | ||
| Constraints |
name
This attribute is a user-assigned identification for the radio receiver module. The value assigned to this attribute appears beneath the module’s icon in the node diagram. It can also be used to refer to the object during simulation. Refer to the documentation on the KP op_id_from_name() for more information.
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | rr_n, n >= 0 |
|
| Units | ||
| Constraints | unique in node model, no dots |
noise figure
This attribute is used to represent the effect of thermal noise on radio transmission. Thermal noise is caused by thermal agitation of electrons in resistances and is typically computed as one of the components of background noise by the Radio Transceiver Pipeline stage bkgnoise model. This result is then used to evaluate the signal-to-noise ratio. The default value of this attribute, 1.0, corresponds to a temperature of 290 K.
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write / promote | read / write |
| Default Value | 1.0 | |
| Units | ||
| Constraints | noise figure >= 1.0 |
power model
This attribute specifies the name of a compiled pipeline procedure capable of computing the received power level for an incoming radio transmission. The default model is dra_power which calculates received power by taking into account the initial transmitted power, the path loss, and receiver and transmitter antenna gains. The result of this pipeline stage is typically used in the snr model stage of the transceiver pipeline to compute signal to noise ratio.
If this attribute is set to NONE, the pipeline stage is skipped and the Simulation Kernel uses a default value, as described in “Default Models” on page 284.
Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write | read |
| Default Value | dra_power | |
| Units | ||
| Constraints |
ragain model
This attribute specifies the name of a compiled pipeline procedure capable of computing antenna gain associated with the receiver’s antenna for a particular incoming radio transmission. The default model is dra_ragain which computes gain based on the vector separating the receiver and transmitter, and the pointing attributes of the receiver’s associated antenna. The result of this pipeline stage is later used in a link budget calculation in the power model stage of the transceiver pipeline.
If this attribute is set to NONE, the pipeline stage is skipped and the Simulation Kernel uses a default value, as described in “Default Models” on page 284.
Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write | read |
| Default Value | dra_ragain | |
| Units | ||
| Constraints |
snr model
This attribute specifies the name of a compiled pipeline procedure capable of computing signal to noise ratio for a particular incoming radio transmission. The default model is dra_snr which computes the ratio of the information signal power to the accumulated average power of all background and interference noise sources. The result of this pipeline stage is typically used in the ber model stage of the transceiver pipeline to compute expected bit error rate.
If this attribute is set to NONE, the pipeline stage is skipped and the Simulation Kernel uses a default value, as described in “Default Models” on page 284.
Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write | read |
| Default Value | dra_snr | |
| Units | ||
| Constraints |