Friday, 03 June 2022 21:37

Bluetooth LE Node Statistics

The Bluetooth low energy (LE) network simulation captures these statistics as a structure. This structure is returned as an output by the statistics object function of the bluetoothLENode object. The fields of this structure depend on the value of the Role property of the bluetoothLENode object.

Statistics of Central and Peripheral Nodes

If you set the Role property of the bluetoothLENode object to "central" or "peripheral", these are the fields of the structure.

Structure FieldDescription
App

Application statistics, returned as a structure. If the network contains multiple Peripheral nodes, this field returns an array of structures.

LL

Link layer (LL) statistics, returned as a structure. If the network contains multiple Peripheral nodes, this field returns an array of structures.

PHY

Physical layer (PHY) statistics, returned as a structure.

These are the fields of the App structure.

Structure FieldDescription
DestinationID Destination node ID for the packets transmitted from the application layer
TransmittedPackets Total number of packets transmitted by the application layer
TransmittedBytes Total number of bytes transmitted from the application layer
ReceivedPackets Total number of packets received at the application layer
ReceivedBytes Total number of bytes received at the application layer
AveragePacketLatency Average packet latency in seconds

These are the fields of the LL structure.

Structure FieldDescription
TransmittedPackets Total number of packets transmitted from the LL
TransmittedEmptyPackets Total number of empty packets transmitted from the LL
TransmittedDataPackets Total number of data packets transmitted from the LL
RetransmittedDataPackets Total number of data packets retransmitted from the LL
TransmittedControlPackets Total number of control packets transmitted from the LL
RetransmittedControlPackets Total number of control packets retransmitted from the LL
TransmitQueueOverflow Total number of times LL transmit queue overflowed
TransmittedBytes Total number of transmitted and retransmitted bytes from the LL
TransmittedPayloadBytes Total number of unique bytes from the higher layers transmitted from the LL
AcknowledgedPackets Total number of packets acknowledged at the LL
ReceivedPackets Total number of packets received by the LL
ReceivedDataPackets Total number of data packets received by the LL
ReceivedControlPackets Total number of control packets received by the LL
ReceivedDuplicatePackets Total number of duplicate packets received by the LL
CRCFailedPackets Total number of cyclic redundancy check (CRC) failed packets received by the LL
ReceivedBytes Total number of bytes received by the LL
ReceivedPayloadBytes Total number of bytes received by the LL from the higher layers
ReceivedEmptyPackets Total number of empty packets received by the LL
SleepTime Time spent by LL in the sleep state, in seconds
IdleTime Time spent by LL in the idle state, in seconds
ListenTime Time spent by LL in the listen state, in seconds
TransmissionTime Time spent by LL in the transmission state, in seconds
AveragePacketLatency Average packet latency in seconds
AverageRoundTripTime Average roundtrip time captured at the LL in seconds
PacketLossRatio Ratio of total number of transmitted packets to the total number of acknowledged packets
Throughput Throughput calculated at the LL based on the unique application bytes transmitted, in kb/s

These are the fields of the PHY structure.

Structure FieldDescription
TransmittedPackets Total number of packets transmitted by the PHY
TransmittedBits Total number of bits transmitted by the PHY
ReceivedPackets Total number of packets received at the PHY
DecodeFailures Total number of packets that are unsuccessfully decoded at the PHY receiver
InvalidAccessAddressPackets Total number of decoded packets whose decoded access address does not match the expected access address
InvalidLengthPackets Total number of decoded packets whose length (in bytes) is less than the length field in the decoded header
ReceivedBits Total number of bits received and successfully decoded
PacketCollisions Total number of packets that experienced collision from other packets
CoChannelCollisions Total number of packets that experienced co-channel collisions
CollisionsWithBLE Total number of packets that experienced collision in the time domain with Bluetooth LE packets
CollisionsWithNonBLE Total number of packets that experienced collision in the time domain with non-Bluetooth LE packets
CollisionsWithBLEAndNonBLE Total number of packets that experienced collision in the time domain with Bluetooth LE packets and non-Bluetooth LE packets

Statistics of Broadcaster-Observer Node

If you set the Role property of the bluetoothLENode object to "broadcaster-observer", these are the fields of the structure. The fields of the PHY structure for a node with the "broadcaster-observer" role are same as those for a node with the "central" or "peripheral" role.

Structure FieldDescription
App

Application statistics, returned as a structure. If the network contains multiple Peripheral nodes, this field returns an array of structures.

Transport

Mesh transport layer statistics, returned as a structure.

Network

Mesh network layer statistics, returned as a structure.

LL

Mesh LL layer statistics, returned as a structure.

PHY

PHY statistics, returned as a structure.

These are the fields of the App structure.

Structure FieldDescription
SourceAddress Source address of messages originated from the mesh application layer
DestinationAddress Destination address of messages originated from the mesh profile
TransmittedPackets Total number of packets transmitted by the mesh application layer
TransmittedBytes Total number of bytes transmitted from the mesh application layer
ReceivedPackets Total number of packets received at the mesh application layer
ReceivedBytes Total number of bytes received at the mesh application layer
AveragePacketLatency Average packet latency in seconds

These are the fields of the Transport structure.

Structure FieldDescription
TransmittedDataMessages Total number of data messages transmitted from the transport layer
ReceivedDataMessages Total number of data messages received by the transport layer
TransmittedControlMessages Total number of control messages transmitted by the transport layer
ReceivedControlMessages Total number of control messages received by the transport layer
TransmittedDataBytes Total number of data bytes transmitted by the transport layer
ReceivedDataBytes Total number of data bytes received by the transport layer

These are the fields of the Network structure.

Structure FieldDescription
TransmittedMessages Total number of messages transmitted from the network layer
ReceivedMessages Total number of messages received by the network layer
AcceptedMessages Total number of messages accepted at the network layer for further processing
RelayedMessages Total number of messages relayed at the network layer
DroppedMessages Total number of messages dropped at the network layer

These are the fields of the LL structure.

Structure FieldDescription
TransmittedPackets Total number of packets transmitted from the LL
ReceivedPackets Total number of packets received by the LL
DroppedPackets Total number of packets dropped by the LL
TransmittedBytes Total number of bytes transmitted and retransmitted from the LL
ReceivedBytes Total number of bytes received by the LL
CRCFailedPackets Total number of CRC failed packets received by the LL
SleepTime Time spent by the LL in the sleep state, in seconds
IdleTime Time spent by the LL in the idle state, in seconds
ListenTime Time spent by the LL in the listen state, in seconds
TransmissionTime Time spent by the LL in the transmission state, in seconds
Throughput Throughput calculated at the LL based on the unique application bytes transmitted, in kb/s

Statistics of Isochronous-Broadcaster and Receiver Nodes

If you set the Role property of the bluetoothLENode object to "isochronous-broadcaster" or "synchronized-receiver", these are the fields of the structure. The fields of the PHY structure for a node with the "isochronous-broadcaster" or "synchronized-receiver" roles are the same as those for a node with the "central""peripheral", or "broadcaster-observer" role.

Structure FieldDescription
App

Application statistics, returned as a structure.

LL

LL statistics, returned as a structure.

PHY

PHY statistics, returned as a structure

These are the fields of the App structure.

Structure FieldDescription
TransmittedPackets Total number of packets transmitted by the application layer
TransmittedBytes Total number of bytes transmitted from the application layer
ReceivedPackets Total number of packets received at the application layer
ReceivedBytes Total number of bytes received at the application layer
AveragePacketLatency Average packet latency averaged over all the values captured in the packet latency vector, in seconds

These are the fields of the LL structure.

Structure FieldDescription
StandbyTime Time spent by the LL in the standby state, in seconds
SleepTime Time spent by the LL in the sleep/idle state, in seconds
ListenTime Time spent by the LL in the listen state, in seconds
TransmissionTime Time spent by the LL in the transmit state, in seconds
ReceivedDataPackets Number of data protocol data units (PDUs) decoded successfully at the receiver
ReceivedEmptyPackets Number of empty packets received
ReceivedDuplicatePackets Number of duplicate data packets received
AggregatePacketlatency Sum of packet latencies of all the successfully received data packets in seconds
ReceivedBytes Total number of bytes received successfully
TransmittedDataPackets Number of unique data packets transmitted by the broadcaster in each broadcast isochronous stream (BIS)
TransmittedControlPackets Number of control packets transmitted by the broadcaster
TransmittedEmptyPackets Number of empty packets transmitted by the broadcaster
CRCFailedPackets Number of packets at the receiver with CRC failure
AveragePacketLatency Average packet latency in seconds
Read 20154 times