Main Content

Bluetooth Node Statistics

The Bluetooth® network simulation captures these statistics as a structure. This structure is returned as an output by the statistics object function of the bluetoothNode object. The structure includes various statistics captured at the application layer (APP), baseband layer, and physical layer (PHY) of the Bluetooth node. The output structure of the statistics object function contains these fields.

Field Description
Name

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

ID

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

App

APP statistics, returned as a structure.

Baseband

Baseband layer statistics, returned as a structure.

PHY

PHY statistics, returned as a structure.

APP Statistics

The APP field is a structure or an array of structures with these fields.

Field Description
TransmittedPackets

Total number of packets transmitted from the APP.

TransmittedBytes

Total number of bytes transmitted from the APP.

ReceivedPackets

Total number of packets successfully received by the APP.

ReceivedBytes

Total number of bytes successfully received by the APP.

TrafficSources

Information about traffic sources.

If the network contains multiple Peripheral nodes, this field returns an array of structures. The structure has these fields.

  • TransmittedPackets — Total number of packets transmitted from the APP to the specified destination node.

  • TransmittedBytes — Total number of bytes transmitted from the APP to the specified destination node.

  • TransmitQueueOverflow — Total number of times transmit queue overflowed.

  • DestinationNodeID — ID of the destination node.

  • DestinationNodeName — Name of the destination node.

Baseband Statistics

The Baseband field is a structure or an array of structures with these fields.

Field Description
InvalidReceivedPackets

Total number of packets received with an invalid logical transport address, payload length, or packet type.

ConnectionStats

Statistics corresponding to each connection.

If a node is connected to multiple nodes, this field returns an array of structures. If a node is connected to only one node, this field returns a structure.

PeerNodeName

Name of the peer node.

PeerNodeID

ID of the peer node.

TransmittedDataBytes

Total number of unique data bytes transmitted by the asynchronous connection-oriented logical (ACL) packets and the data field of DV packets.

ReceivedDataBytes

Total number of unique data bytes received from the ACL packets and the data field of DV packets.

TransmittedACLPackets

Total number of unique ACL data packets transmitted.

RetransmittedACLPackets

Total number of ACL data packets retransmitted.

ReceivedACLPackets

Total number of ACL data packets received.

TransmittedSCOPackets

Total number of synchronous connection-oriented (SCO) packets (excluding DV packets and control packets) transmitted.

ReceivedSCOPackets

Total number of SCO packets (excluding DV and control packets) received.

TransmittedDVPackets

Total number of DV packets transmitted.

DVWithRetransmittedData

Total number of the data fields of the DV packets retransmitted.

ReceivedDVPackets

Total number of DV packets received.

ReceivedDuplicatePackets

Total number of duplicate ACL data packets received.

TransmittedNullPackets

Total number of Null packets transmitted.

ReceivedNullPackets

Total number of Null packets received.

TransmittedPollPackets

Total number of Poll packets transmitted.

ReceivedPollPackets

Total number of Poll packets received.

TransmittedControlPackets

Total number of control packets transmitted.

RetransmittedControlPackets

Total number of control packets retransmitted.

ReceivedControlPackets

Total number of control packets received.

AverageACLPacketLatency

Average packet latency for ACL link, in seconds.

PHY Statistics

The PHY field is a structure or an array of structures with these fields.

Field Description
TransmittedPackets

Total number of packets transmitted by PHY.

TransmtitedBits

Total number of bits transmitted by PHY.

ReceivedPackets

Total number of packets received by PHY.

DecodeFailures

Total number of decoding failures at PHY.

PacketCollisions

Total number of packet collisions at PHY.

CoChannelCollisions

Total number of co-channel packet collisions at PHY.

CollisionsWithBREDR

Total number of packet collisions with other Bluetooth basic rate/enhanced data rate (BR/EDR) packets at PHY.

CollisionsWithNonBREDR

Total number of packet collisions with other non-Bluetooth BR/EDR packets at PHY.

CollisionsWithBREDRAndNonBREDR

Total number of packet collisions with other Bluetooth BR/EDR and non-Bluetooth BR/EDR packets at PHY.

See Also

Functions

Objects