Main Content

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 Field Description
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 Field Description
DestinationNameName of the destination node
TransmittedPacketsTotal number of packets transmitted by the application layer
TransmittedBytesTotal number of bytes transmitted from the application layer
ReceivedPacketsTotal number of packets received at the application layer
ReceivedBytesTotal number of bytes received at the application layer
AveragePacketLatencyAverage packet latency in seconds
AggregatePacketLatencyAggregate packet latency in seconds

These are the fields of the LL structure.

Structure Field Description
TransmittedPacketsTotal number of packets transmitted from the LL
TransmittedEmptyPacketsTotal number of empty packets transmitted from the LL
TransmittedDataPacketsTotal number of unique data packets transmitted from the LL
RetransmittedDataPacketsTotal number of data packets retransmitted from the LL
TransmittedControlPacketsTotal number of control packets transmitted from the LL
RetransmittedControlPacketsTotal number of control packets retransmitted from the LL
TransmitQueueOverflowTotal number of times LL transmit queue overflowed
TransmittedBytesTotal number of transmitted and retransmitted bytes from the LL
TransmittedPayloadBytesTotal number of unique bytes from the higher layers transmitted from the LL
AcknowledgedPacketsTotal number of packets acknowledged at the LL
ReceivedPacketsTotal number of packets received by the LL
ReceivedDataPacketsTotal number of data packets received by the LL
ReceivedControlPacketsTotal number of control packets received by the LL
ReceivedDuplicatePacketsTotal number of duplicate packets received by the LL
CRCFailedPacketsTotal number of cyclic redundancy check (CRC) failed packets received by the LL
ReceivedBytesTotal number of bytes received by the LL
ReceivedPayloadBytesTotal number of bytes received by the LL from the higher layers
ReceivedEmptyPacketsTotal number of empty packets received by the LL
SleepTimeTime spent by LL in the sleep state, in seconds
IdleTimeTime spent by LL in the idle state, in seconds
ListenTimeTime spent by LL in the listen state, in seconds
TransmissionTimeTime spent by LL in the transmission state, in seconds
AveragePacketLatencyAverage packet latency in seconds
AverageRoundTripTimeAverage roundtrip time captured at the LL in seconds
PacketLossRatioRatio of total number of transmitted packets to the total number of acknowledged packets
ThroughputThroughput calculated at the LL based on the unique application bytes transmitted, in kb/s

These are the fields of the PHY structure.

Structure Field Description
TransmittedPacketsTotal number of packets transmitted by the PHY
TransmittedBitsTotal number of bits transmitted by the PHY
ReceivedPacketsTotal number of packets received at the PHY
DecodeFailuresTotal number of packets that are unsuccessfully decoded at the PHY receiver
InvalidAccessAddressPacketsTotal number of decoded packets whose decoded access address does not match the expected access address
InvalidLengthPacketsTotal number of decoded packets whose length (in bytes) is less than the length field in the decoded header
ReceivedBitsTotal number of bits received and successfully decoded
PacketCollisionsTotal number of packets that experienced collision from other packets
CoChannelCollisionsTotal number of packets that experienced co-channel collisions
CollisionsWithBLETotal number of packets that experienced collision in the time domain with Bluetooth LE packets
CollisionsWithNonBLETotal number of packets that experienced collision in the time domain with non-Bluetooth LE packets
CollisionsWithBLEAndNonBLETotal 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 Field Description
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 Field Description
SourceAddressSource address of messages originated from the mesh application layer
DestinationAddressDestination address of messages originated from the mesh profile
TransmittedPacketsTotal number of packets transmitted by the mesh application layer
TransmittedBytesTotal number of bytes transmitted from the mesh application layer
ReceivedPacketsTotal number of packets received at the mesh application layer
ReceivedBytesTotal number of bytes received at the mesh application layer
AveragePacketLatencyAverage packet latency in seconds
AggregatePacketLatencyAggregate packet latency in seconds

These are the fields of the Transport structure.

Structure Field Description
TransmittedDataMessagesTotal number of data messages transmitted from the transport layer
ReceivedDataMessagesTotal number of data messages received by the transport layer
TransmittedControlMessagesTotal number of control messages transmitted by the transport layer
ReceivedControlMessagesTotal number of control messages received by the transport layer
TransmittedDataBytesTotal number of data bytes transmitted by the transport layer
ReceivedDataBytesTotal number of data bytes received by the transport layer
QueueOverflowCountTotal number of transmission queue overflows at the transport layer
DroppedMessagesTotal number of messages dropped at the transport layer

These are the fields of the Network structure.

Structure Field Description
TransmittedMessagesTotal number of messages transmitted from the network layer
ReceivedMessagesTotal number of messages received by the network layer
AcceptedMessagesTotal number of messages accepted at the network layer for further processing
RelayedMessagesTotal number of messages relayed at the network layer
QueueOverflowCountTotal number of transmission queue overflows at the network layer
DroppedMessagesTotal number of messages dropped at the network layer

These are the fields of the LL structure.

Structure Field Description
TransmittedPacketsTotal number of packets transmitted from the LL
ReceivedPacketsTotal number of packets received by the LL
DroppedPacketsTotal number of packets dropped by the LL
TransmittedBytesTotal number of bytes transmitted and retransmitted from the LL
ReceivedBytesTotal number of bytes received by the LL
CRCFailedPacketsTotal number of CRC failed packets received by the LL
SleepTimeTime spent by the LL in the sleep state, in seconds
IdleTimeTime spent by the LL in the idle state, in seconds
ListenTimeTime spent by the LL in the listen state, in seconds
TransmissionTimeTime spent by the LL in the transmission state, in seconds
ThroughputThroughput calculated at the LL based on the unique application bytes transmitted, in kb/s
TransmittedUpperLayerBytesTotal number of upper-layer bytes transmitted by the LL
ReceivedUpperLayerBytesTotal number of upper-layer bytes received by the LL

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 Field Description
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 Field Description
TransmittedPacketsTotal number of packets transmitted by the application layer
TransmittedBytesTotal number of bytes transmitted from the application layer
ReceivedPacketsTotal number of packets received at the application layer
ReceivedBytesTotal number of bytes received at the application layer
AveragePacketLatencyAverage packet latency averaged over all the values captured in the packet latency vector, in seconds
AggregatePacketLatencyAggregate packet latency in seconds

These are the fields of the LL structure.

Structure Field Description
StandbyTimeTime spent by the LL in the standby state, in seconds
SleepTimeTime spent by the LL in the sleep/idle state, in seconds
ListenTimeTime spent by the LL in the listen state, in seconds
TransmissionTimeTime spent by the LL in the transmit state, in seconds
ReceivedDataPacketsTotal number of data protocol data units (PDUs) decoded successfully at the receiver
ReceivedEmptyPacketsTotal number of empty packets received
ReceivedDuplicatePacketsTotal number of duplicate data packets received
AggregatePacketlatencySum of packet latencies of all the successfully received data packets in seconds
ReceivedBytesTotal number of bytes received successfully
TransmittedDataPacketsTotal number of unique data packets transmitted by the broadcaster in each broadcast isochronous stream (BIS)
TransmittedControlPacketsTotal number of control packets transmitted by the broadcaster
TransmittedEmptyPacketsTotal number of empty packets transmitted by the broadcaster
CRCFailedPacketsTotal number of packets at the receiver with CRC failure
AveragePacketLatencyAverage packet latency in seconds

See Also

Functions

Objects

Related Topics