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
Name

Name of the Bluetooth LE node, returned as a string scalar.

ID

ID of the Bluetooth LE node, returned as a numeric scalar.

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
DestinationNodeName 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
PeerNodeName

Name of the peer node, returned as a string scalar

PeerNodeIDID of the peer node, returned as a numeric scalar
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
TransmissionTimeTime spent by the node in transmitting a packet, in seconds
ListenTimeTime spent by the node in listening and receiving a packet, in seconds
IdleTimeTime spent by the node in time inter-frame space (TIFS), in seconds. TIFS specifies the time between the transmission and reception of a packet.
SleepTimeTime during which the node is not in TransmissionTime, ListenTime, or IdleTime, in seconds
AveragePacketLatencyAverage packet latency in seconds
AverageRoundTripTimeAverage round trip 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
CISStatistics
  • If you configure a connected isochronous stream (CIS) connection between Central and Peripheral nodes, this field specifies the CIS statistics as a structure. If multiple CIS connections exist at a node, this field is an array of structures, where each structure is associated with a CIS connection.

    The structure has these fields.

    • CISID – ID of the CIS connection

    • TransmittedPackets – Total number of transmitted packets, including retransmissions

    • TransmittedBytes – Total number of transmitted bytes, including retransmissions

    • TransmittedPayloadBytes – Total number of transmitted payload bytes

    • ReceivedPackets – Total number of received packets

    • ReceivedBytes – Total number of received bytes

    • RetransmittedPackets – Total number of retransmitted packets

    • AcknowledgedPackets – Total number of acknowledged packets

    • CRCFailedPackets – Total number of CRC failed packets

  • If you do not configure the CIS connection, this field is empty.

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 and Observer Nodes

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

Structure Field Description
Name

Name of the Bluetooth LE node, returned as a string scalar.

ID

ID of the Bluetooth LE node, returned as a numeric scalar.

App

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

LL

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

PHY

PHY statistics, returned as a structure.

By default, the LL structure contains statistics of the legacy Broadcaster and Observer nodes. The LL structure of the legacy Broadcaster node contains these fields.

Structure Field Description
TransmissionTime

Time spent by the node in transmitting a packet, in seconds

SleepTime

Time during which the node is not transmitting a packet, in seconds

TransmittedPackets

Total number of packets transmitted from the LL

TransmittedBytes

Total number of bytes transmitted from the LL

TransmittedPayloadBytes

Total number of advertising payload bytes transmitted from the LL

The LL structure of the legacy Observer node contains these additional fields.

Structure Field Description
ListenTime

Time spent by the node in listening and receiving a packet, in seconds

SleepTime

Time during which the node neither listens nor receives a packet, in seconds

ReceivedPackets

Total number of packets received by the LL

ReceivedBytes

Total number of bytes received by the LL

DroppedPackets

Total number of packets dropped by the LL

CRCFailedPackets

Total number of CRC failed packets received by the LL

If you enable periodic advertisements at the node, the LL structure of the periodic Broadcaster node contains these additional fields.

Structure Field Description
PeerNodeName

Name of the periodic Observer(s) associated with this Broadcaster

PeerNodeID

ID of the periodic Observer(s) associated with this Broadcaster

TransmissionTime

Time spent by the node in transmitting a packet, in seconds

SleepTime

Time during which the node is not transmitting a packet, in seconds

TransmittedPackets

Total number of packets transmitted from the LL

RetransmittedPackets

Total number of packets retransmitted with the same advertising payload because the higher layers (host) failed to provide new advertising payload

TransmittedBytes

Total number of bytes transmitted from the LL

TransmittedPayloadBytes

Total number of advertising payload bytes transmitted from the LL

If you enable periodic advertisements at the node, the LL structure of the periodic Observer node contains these additional fields. If the periodic Observer node is synchronized with multiple periodic advertisements, each of these fields is an array of structures, where each structure corresponds to a specific periodic advertisement train from the Broadcaster node.

Structure Field Description
PeerNodeName

Name of the periodic broadcaster associated with this Observer

PeerNodeID

ID of the periodic Broadcaster associated with this Observer

ListenTime

Time spent by the node in listening and receiving a packet, in seconds

SleepTime

Time during which the node neither listens nor receives a packet, in seconds

ReceivedPackets

Total number of packets received by the LL

ReceivedBytes

Total number of bytes received by the LL

CRCFailedPackets

Total number of CRC failed packets received by the LL

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
Name

Name of the Bluetooth LE node, returned as a string scalar.

ID

ID of the Bluetooth LE node, returned as a numeric scalar.

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 application layer
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
TransmissionTimeTime spent by the node in transmitting a packet, in seconds
ListenTimeTime spent by the node in listening and receiving a packet, in seconds
IdleTimeTime spent by the node in an advertising event, excluding the time taken to transmit a packet, in seconds
SleepTimeTime during which the node is not in TransmissionTime, ListenTime, or IdleTime, 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
AveragePacketLatency Average packet latency in seconds

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" or "peripheral" role.

Structure Field Description
Name

Name of the Bluetooth LE node, returned as a string scalar.

ID

ID of the Bluetooth LE node, returned as a numeric scalar.

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
TransmissionTimeTime spent by the isochronous broadcaster node in transmitting a packet, in seconds
ListenTimeTime spent by the synchronized node in listening and receiving a packet, in seconds
StandbyTimeTime spent by the node before synchronization and after losing synchronization, in seconds
SleepTime

  • Time during which the isochronous broadcaster node is not transmitting a packet, in seconds

  • Time during which the synchronized receiver node is neither listening nor receiving a packet, in seconds

ReceivedDataPacketsTotal number of data protocol data units (PDUs) decoded successfully at the isochronous receiver node
ReceivedEmptyPacketsTotal number of empty packets received at the isochronous receiver node
ReceivedDuplicatePacketsTotal number of duplicate data packets received at the isochronous receiver node
AggregatePacketlatencySum of packet latencies of all the successfully received data packets at the isochronous receiver node, in seconds
TransmitteBytes Total number of bytes successfully transmitted by the isochronous receiver node
ReceivedBytesTotal number of bytes successfully received at the isochronous receiver node
TransmittedDataPacketsTotal number of unique data packets transmitted by the isochronous broadcaster node in each broadcast isochronous stream (BIS)
RetransmittedDataPacketsTotal number of data packets retransmitted by the isochronous broadcaster node
TransmittedControlPacketsTotal number of control packets transmitted by the isochronous broadcaster node
ReceivedControlPacketsTotal number of control packets received at the isochronous receiver node
TransmittedEmptyPacketsTotal number of empty packets transmitted by the isochronous broadcaster node
CRCFailedPacketsTotal number of packets at the isochronous receiver node with CRC failure
AveragePacketLatencyAverage packet latency at the isochronous receiver node, in seconds
ThroughputLL throughput based on unique LL packets in Kb/s

See Also

Functions

Objects

Related Topics