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 |