Bus Receiver Channel Object
Each bus receiver manages an arbitrary number of bus receiver channels which are bound to corresponding bus transmitter channels in other nodes via a bus link. The channels are labeled channel [0] through channel [n-1], for receivers with n channels. Bus 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 bus receiver module.
For more information about compound attributes, see "Modeling Framework".
Bus Receiver Channel Object Attributes
The following table lists the built-in attributes of the bus receiver channel object.
Table 4: Bus Receiver Channel Object Built-In Attributes
| Name | Data Type |
|---|---|
| data rate | double |
| packet formats | string |
Bus Receiver Channel Object Statistics
The following table lists the statistics available for the bus receiver channel object.
Table 5: Bus Receiver Channel Object Statistics
| Name | Units |
|---|---|
| bit error rate | errors / bit |
| bit errors per packet | errors |
| busy | N/A |
| collision status | N/A |
| packet loss ratio | N/A |
| throughput (bits/sec) | bits / second |
| throughput (packets/sec) | packets / second |
| utilization | N/A |
The following events update the indicated statistics of the bus receiver channel.
Table 6: Bus Receiver Channel Object Statistic Events
| Event | Statistics Updated |
|---|---|
| packet reception start | busy |
| packet reception complete | bit error rate, bit errors per packet, throughput (bits/sec), busy, packet loss ratio, throughput (packets/sec), utilization |
| collision begin or end | collision status |
The following paragraphs describe each bus 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) of the packet that is completing arrival at the receiver channel. It is computed by dividing the number of bit errors (determined in the "error model" stage of the transceiver pipeline) 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 binary value (0.0 or 1.0) that represents whether any packets are currently being received on the bus 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 |
collision status
This statistic is a binary 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, and 0.0 whenever one or zero packets are present. A new sample of collision status is generated if a packet is present at the receiver channel and another packet arrives, or if at least two packets are present at the receiver channel and one of the packets is removed.
| 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 that 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 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 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 represents a measure of the consumption to date of available channel bandwidth. It is expressed as a percentage, where 100 indicates complete saturation. This statistic 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 completes reception of a packet.
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 or collided packets that occupy the channel for some period, even if they are not successfully received.
| Units | not applicable |
| Initial Value | 0.0 |