Point-to-Point Receiver Channel Object
Each point-to-point receiver manages an arbitrary number of point-to-point receiver channels which are bound to corresponding transmitter channels in another node via a point-to-point link. The channels are named "channel [0]" through "channel [n]-1]", for receivers with n channels. Point-to-point 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 point-to-point receiver module.
For more information about compound attributes, see Chapter 4 "Modeling Framework" on page 80.
Point-to-Point Receiver Channel Object Attributes
The following table lists the built-in attributes of a point-to-point receiver channel object.
Table 16: Point-to-Point Receiver Channel Object Built-In Attributes
| Name | Data Type |
|---|---|
| data rate | double |
| packet formats | string |
Point-to-Point Receiver Channel Object Statistics
The following table lists the statistics available for the point-to-point receiver channel object.
Table 17: Point-to-Point Receiver Channel
| Name | Units |
|---|---|
| bit error rate | errors/bit |
| bit errors per packet | errors |
| busy | N/A |
| packet loss ratio | N/A |
| throughput (bits/sec) | bits/second |
| throughput (packets/sec) | packets/second |
| utilization | n/a |
The following table lists the events that update the indicated statistics of a point-to-point receiver channel.
Table 18: Point-to-Point Receiver Channel Object Statistic Events
| Event | Statistics Updated |
|---|---|
| packet reception start | busy |
| packet reception complete | bit error rate, bit errors per packet, busy, packet loss ratio, throughput (bits/sec), throughput (packets/sec), utilization |
Each statistic of a point-to-point receiver channel object is described below. An initial value of "undef" means that a statistic is initially undefined.
bit error rate
This statistic represents the bit error rate among the bits of the packet which is completing arrival at the receiver channel. It is computed by dividing the number of bit errors (determined in the transceiver pipeline stage error model) by the total number of bits in the packet. A new sample of bit error rate is generated whenever a packet completes arrival at the receiver channel (the last bit of the packet is received).
Note: Do not use "bit error rate" as the source statistic for a statistic wire.
| Units | error/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 transceiver pipeline stage error model. A new sample of bit errors per packet is generated whenever a packet completes arrival at the receiver channel (the last bit of the packet is received).
| Units | errors/packet |
| Initial Value | undef |
busy
This statistic is a Boolean value (0.0 or 1.0) which represents whether any packets are currently being received on the receiver channel. This statistic goes high at the instant a packet first starts to arrive at the receiver channel, and goes low when the trailing edge of the packet has completed reception.
| Units | not applicable |
| 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 transceiver pipeline stage ecc model. 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 | not applicable |
| 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 unit time, in bits per second. For the purposes of computing this statistic, a bit is considered successfully received 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 |
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, measured in packets per second. throughput (packets/sec) 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 |
utilization
This statistic has two possible meanings, depending on collection method.
- When collected by statistic probe, this statistic is a measure of the consumption to date of an available channel bandwidth. This statistic is expressed as a percentage, with 100 indicating full usage.
- When collected by statistic wire, this statistic has one of two values: 0 and 100. Instantaneous utilization is not accumulated.
| Units | not applicable |
| Initial Value | undef |