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
`DestinationNode`	Name of the destination node
`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
`AggregatePacketLatency`	Aggregate 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
`PeerNodeID`	ID of the peer node, returned as a numeric scalar
`TransmittedPackets`	Total number of packets transmitted from the LL
`TransmittedEmptyPackets`	Total number of empty packets transmitted from the LL
`TransmittedDataPackets`	Total number of unique 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
`TransmissionTime`	Time spent by the node in transmitting a packet, in seconds
`ListenTime`	Time spent by the node in listening and receiving a packet, in seconds
`IdleTime`	Time spent by the node in time inter-frame space (TIFS), in seconds. TIFS specifies the time between the transmission and reception of a packet.
`SleepTime`	Time during which the node is not in `TransmissionTime`, `ListenTime`, or `IdleTime`, in seconds
`AveragePacketLatency`	Average packet latency in seconds
`AverageRoundTripTime`	Average round trip 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
`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
`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 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
`SourceAddress`	Source address of messages originated from the mesh application layer
`DestinationAddress`	Destination address of messages originated from the mesh application layer
`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
`AggregatePacketLatency`	Aggregate packet latency in seconds

These are the fields of the Transport structure.

Structure Field	Description
`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
`QueueOverflowCount`	Total number of transmission queue overflows at the transport layer
`DroppedMessages`	Total number of messages dropped at the transport layer

These are the fields of the Network structure.

Structure Field	Description
`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
`QueueOverflowCount`	Total number of transmission queue overflows at the network layer
`DroppedMessages`	Total number of messages dropped at the network layer

These are the fields of the LL structure.

Structure Field	Description
`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
`TransmissionTime`	Time spent by the node in transmitting a packet, in seconds
`ListenTime`	Time spent by the node in listening and receiving a packet, in seconds
`IdleTime`	Time spent by the node in an advertising event, excluding the time taken to transmit a packet, in seconds
`SleepTime`	Time during which the node is not in `TransmissionTime`, `ListenTime`, or `IdleTime`, in seconds
`Throughput`	Throughput calculated at the LL based on the unique application bytes transmitted, in Kb/s
`TransmittedUpperLayerBytes`	Total number of upper-layer bytes transmitted by the LL
`ReceivedUpperLayerBytes`	Total 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
`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
`AggregatePacketLatency`	Aggregate packet latency in seconds

These are the fields of the LL structure.

Structure Field	Description
`TransmissionTime`	Time spent by the isochronous broadcaster node in transmitting a packet, in seconds
`ListenTime`	Time spent by the synchronized node in listening and receiving a packet, in seconds
`StandbyTime`	Time 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
`ReceivedDataPackets`	Total number of data protocol data units (PDUs) decoded successfully at the isochronous receiver node
`ReceivedEmptyPackets`	Total number of empty packets received at the isochronous receiver node
`ReceivedDuplicatePackets`	Total number of duplicate data packets received at the isochronous receiver node
`AggregatePacketlatency`	Sum 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
`ReceivedBytes`	Total number of bytes successfully received at the isochronous receiver node
`TransmittedDataPackets`	Total number of unique data packets transmitted by the isochronous broadcaster node in each broadcast isochronous stream (BIS)
`RetransmittedDataPackets`	Total number of data packets retransmitted by the isochronous broadcaster node
`TransmittedControlPackets`	Total number of control packets transmitted by the isochronous broadcaster node
`ReceivedControlPackets`	Total number of control packets received at the isochronous receiver node
`TransmittedEmptyPackets`	Total number of empty packets transmitted by the isochronous broadcaster node
`CRCFailedPackets`	Total number of packets at the isochronous receiver node with CRC failure
`AveragePacketLatency`	Average packet latency at the isochronous receiver node, in seconds
`Throughput`	LL throughput based on unique LL packets in Kb/s