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 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

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com