Radio Receiver Channel Object

Each radio receiver manages an arbitrary number of radio receiver channels which are capable of receiving packets broadcast via the radio medium. The channels are labeled “channel [0]” through “channel [n]-1]”, for receivers with n channels. Radio receiver channels are children of a special object called a compound attribute object (CA object). The CA object is the value of the “channel” attribute of a radio receiver module.

Radio Receiver Channel Object Attributes

The built-in attributes of the radio receiver channel object are listed below, in alphabetical order.

Table 24: Radio Receiver Channel Object Built-In Attributes

Name Data Type
bandwidth double
data rate double
min frequency double
packet formats string
processing gain toggle-double
signal lock toggle
spreading code toggle-double

bandwidth

This attribute specifies the bandwidth of the channel. The value of this attribute is typically used to determine matches and overlaps between transmitter and receiver channels, and to compute processing gain. Together with the min frequency attribute, it is also used to compute the center-frequency of the channel, which factors into the link budget performed by the power model stage of the Radio Transceiver Pipeline.

Editing Simulation
Data Type double double
Access read / write / promote read
Default Value 10
Units kilohertz
Constraints bandwidth > 0.0

data rate

This attribute specifies the rate at which information can be accepted over the data transmission channel. The value of this attribute is typically used by the txdel model transceiver pipeline stage to compute transmission delay and by the chanmatch model transceiver pipeline stage to determine whether the transmitter and receiver channels have matching characteristics.

Editing Simulation
Data Type double double
Access read / write / promote read / write
Default Value 1024.0
Units bits / second
Constraints data rate > 0.0

min frequency

This attribute specifies the base frequency of the channel. The value of this attribute is used to determine matches and overlaps between transmitter and receiver channels and, together with the attribute bandwidth, to compute the center-frequency of the channel, which factors into the link budget performed by the power model stage of the transceiver pipeline.

Editing Simulation
Data Type double double
Access read / write / promote read / write
Default Value 30.0
Units megahertz
Constraints min frequency >= 0.0

packet formats

This attribute specifies the types of packets a channel can receive and forward to other modules in its node. Other types of packets are rejected by the receiver once they have been fully received. This mechanism is called link consistency and its purpose of this attribute is to prevent packets from being received that are inappropriate and cannot be properly processed by the modules connected to the receiver.

Note: this attribute is stored as a comma-separated string which concatenates sub-strings for each of the supported packet formats. The special sub-string “unformatted” is used to allow unformatted packets to be received by the channel.

Editing Simulation
Data Type string string
Access read / write read
Default Value all formatted, unformatted
Units
Constraints

processing gain

This attribute allows the specification of a user-determined processing gain for the receiver channel. The value of this attribute is used by the transceiver pipeline to compute effective signal to noise ratio for received signals in the “ber model” stage. Effective SNR is in turn used to compute an expected bit error rate for the channel. When disabled, the value of this attribute is assigned the channel’s bandwidth divided by the channel’s data rate (bandwidth / data rate).

Editing Simulation
Data Type toggle-double toggle-double
Access read / write / promote read / write
Default Value channel bandwidth / data rate
Units dB
Constraints

signal lock

This attribute is intended to be dynamically modified during execution of the simulation to model the precedence of earlier arriving packets and the serial nature of the receiver channel. In the default configuration of the transceiver pipeline, the signal lock attribute is used as a semaphore that is set to “enabled” when a packet arrives at an empty channel and reset to “disabled” when a packet completes reception. Packets arriving at a channel with an enabled signal lock attribute can therefore be rejected or considered as interference.

Editing Simulation
Data Type N/A toggle
Access N/A read / write
Default Value disabled
Units
Constraints

spreading code

This attribute can be used to specify a user-assigned code for the channel. This allows the channel match model within the Radio Transceiver Pipeline to group transmitter and receiver channels into compatibility classes defined by commonality of spreading code. This has the effect of creating radio subnetworks within the overall network model. By default the value of this attribute is disabled, meaning that the channel is compatible only with transmitter channels whose spreading code attributes are also disabled.

Editing Simulation
Data Type toggle-double toggle-double
Access read / write / promote read / write
Default Value disabled
Units
Constraints

Radio Receiver Channel Object Statistics

The supported statistics of the radio receiver channel object are listed below, in alphabetical order.

Table 25: Radio Receiver Channel Object Statistics

Name Units
bit error rate errors/bit
bit errors per packet errors
throughput (bits/sec) bits/second
busy N/A
collision status N/A
packet loss ratio errors/packet
throughput (packets/sec) packets/second
received power watts
signal/noise ratio decibels
utilization N/A

The following events affect the radio receiver channel object, and cause it to update the indicated statistics.

Table 26: Radio Receiver Channel Object Statistic Events

Event Statistics Updated
packet reception start busy, received power, signal/noise ratio
packet reception complete bit error rate, bit errors per packet, busy, throughput (bits/sec), packet loss ratio, throughput (packets/sec), received power, signal/noise ratio, utilization
collision begin or end collision status
packet segment start or complete bit error rate, signal/noise ratio

The following sections describe each radio receiver channel object statistic. An initial value of “undef” means that a statistic is initially undefined.

bit error rate

This statistic represents the bit error rate (BER) among the bits of the packet segment that is completing arrival at the receiver channel. It is computed by dividing the number of bit errors (determined in the error model transceiver pipeline stage) by the total number of bits in the packet segment. A new sample of bit error rate is generated whenever a packet segment completes arrival at the receiver channel.

Note: Do not use bit error rate as the source statistic for a statistic wire.

Units errors/bit
Initial Value undef

bit errors per packet

This statistic represents the number of bit errors within the packet completing arrival at the receiver channel. Its value is determined in the error model transceiver pipeline stage. A new sample of bit errors per packet is generated whenever a packet segment completes arrival at the receiver channel (the last bit of the packet is received).

Units errors/packet
Initial Value undef

throughput (bits/sec)

This statistic has two possible meanings, depending on collection method.

  • When collected by statistic probe, this statistic represents the average number of bits successfully received by the receiver channel per second. For the purposes of computing this statistic, a bit is considered successfully received if and only if it is part of a packet that is successfully received. throughput (bits/sec) is computed by dividing the number of bits contained in accepted packets to date by the current simulation time.
  • When collected by statistic wire, this statistic has one of two values: 0 and the channel data rate. Instantaneous throughput is not accumulated.

New samples of this statistic are generated whenever a packet completes reception.

Units bits/second
Initial Value 0.0

busy

This statistic is a Boolean value (0.0 or 1.0) which represents whether any packets are currently being received on the radio receiver channel. This statistic goes high at the instant that a packet first starts to arrive at the receiver channel, and goes low when the trailing edge of the packet has completed reception, provided no other packets are currently being received on the channel.

Units N/A
Initial Value 0.0

collision status

This statistic is a Boolean value (0.0 or 1.0) that reflects the collision of packets at the receiver channel. It has a value of 1.0 when two or more packets are simultaneously present at the receiver channel. It has a value of 0.0 whenever one or zero packets are present. A new sample of collision status is generated if at least one packet is present at the receiver and another packet arrives, or if exactly two packets are present at the receiver and one is removed.

Units N/A
Initial Value 0.0

packet loss ratio

This statistic is a Boolean value (0.0 or 1.0) that corresponds to the acceptance or rejection of a packet, respectively. It is an instantaneous statistic which is updated when the trailing edge of the packet arrives at the receiver. The determination of acceptance or rejection is made by the ecc model transceiver pipeline stage. A new sample of packet loss ratio is generated whenever a packet completes arrival at the receiver channel (the last bit of the packet is received).

Units N/A
Initial Value undef

throughput (packets/sec)

This statistic has two possible meanings, depending on collection method.

  • When collected by statistic probe, this statistic represents the average number of packets successfully received by the receiver channel per second. It is computed by dividing the number of packets accepted to date by the current simulation time.
  • When collected by statistic wire, this statistic has one of two values: 0 and the channel data rate. Instantaneous throughput is not accumulated.

New samples of this statistic are generated whenever a packet completes reception.

Units packets/second
Initial Value 0.0

received power

This statistic represents the average power of a packet arriving at a receiver channel. The received power is updated at the start of each packet, and drops to zero when the packet ends. The value of this statistic is computed by the receiver power stage of the radio transceiver pipeline. Received power is computed for valid and noise packets being received, but not for ignored packets.

Units watts
Initial Value 0.0

signal/noise ratio

This statistic represents the ratio of the average power of a packet segment being received at a receiver channel and the combined average power of all relevant interference sources. signal/noise ratio is updated at the start of each packet segment, and holds constant for the duration of that segment. It becomes undefined when the packet ends. The value of this statistic is computed by the snr model transceiver pipeline stage.

Units dB
Initial Value undef

utilization

This statistic has two possible meanings, depending on collection method.

  • When collected by statistic probe, this statistic represents a measure of the consumption to date of available channel bandwidth. This statistic is expressed as a percentage, where 100 indicates full usage. It provides a value equivalent to the running time-average of the busy statistic. utilization is computed by dividing the cumulative time the channel has been busy to date by the current simulation time.
  • When collected by statistic wire, this statistic has one of two values: 0 and 100. Instantaneous utilization is not accumulated.

New samples of utilization are generated whenever the receiver channel begins a new packet reception.

Note: Because utilization is based on the busy statistic of the receiver channel, it does not necessarily correspond to useful utilization. In other words, it includes the contributions of aborted packets and invalid packets that occupy the channel for some period but which are not successfully received.

Units N/A
Initial Value 0.0

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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