Matlab Simulate Bluetooth Network

Bluetooth BR/EDR Simulation

Simulate Classic Bluetooth (BR/EDR) networks with ACL data and SCO voice connections.

When to Use

• BR/EDR piconets (earbuds, headsets, audio accessories)

• SCO voice links (HV1, HV2, HV3) with or without ACL data

• ACL data packet types (DH1–DH5, 3-DH1–3-DH5) and throughput

Critical Rules

• Uses bluetoothNode (not bluetoothLENode) and bluetoothConnectionConfig

• configureConnection(cfg, central, peripherals) — accepts vector of peripherals (unlike BLE)

• kpi(..., Layer="Baseband") — only layer available; no latency via kpi (use statistics())

• Max 7 peripherals per central — use multiple centrals for more

• SCO is implicit: setting cfg.SCOPacketType = "HV3" reserves SCO slots automatically. Only add traffic for ACL data, never for SCO.

Latency from statistics()

Latency is populated on the receiving node (the node that receives the traffic).

stats = statistics(peripheral);  % receiver of the traffic
latency = stats.Baseband.ConnectionStats(1).AverageACLPacketLatency;

SCO Earbud Piconet

sim = wirelessNetworkSimulator.init;

central = bluetoothNode("central", Position=[0 0 0], Name="Phone");
peripherals = bluetoothNode("peripheral", ...
    Position=[0.3 0 0; 0 0.3 0], Name=["LeftEar", "RightEar"]);

cfg = bluetoothConnectionConfig;
cfg.SCOPacketType = "HV3";
cfg.CentralToPeripheralACLPacketType = "DH1";
configureConnection(cfg, central, peripherals);

% ACL data traffic (SCO voice is automatic)
traffic = networkTrafficOnOff(DataRate=50, PacketSize=27, OnTime=Inf);
addTrafficSource(central, traffic, DestinationNode=peripherals);

addNodes(sim, [central; peripherals(:)]);
run(sim, 0.5);

% Results
for i = 1:numel(peripherals)
    tput = kpi(central, peripherals(i), "throughput", Layer="Baseband");
    plr = kpi(central, peripherals(i), "PLR", Layer="Baseband");
    fprintf('%s: %.2f kbps, PLR=%.4f\n', peripherals(i).Name, tput, plr);
end

Traffic DataRate is in Kbps — use DataRate=50 for 50 Kbps, not DataRate=50000.

SCO Packet Types and Slot Reservation

HV3 is the most common — reserves 1/6 of available slots (least overhead).

Multi-SCO and SCO+ACL Constraints

• Max SCO links: HV1=1, HV2=2, HV3=3. All links in a piconet must use the same type (mixing is rejected).

• 5-slot ACL never works with any SCO. HV3 supports asymmetric 3-slot (one dir only). HV2 supports 1-slot only.

• At max SCO links, no ACL capacity remains. Keep SCO links below max for ACL+SCO coexistence.

SCO + ACL Packet Compatibility

When SCO is active, ACL packet type must fit in remaining slots:

Key rules:

• 5-slot types (DH5, 2-DH5, 3-DH5) never work with any SCO — always rejected

• HV3 + 3-slot ACL works only if one direction uses 1-slot (asymmetric config)

• HV2 + multi-slot ACL never works — even asymmetric is rejected

• HV1 leaves no ACL capacity; toolbox substitutes DV packet (max 9 bytes, 0 ACL packets in practice)

% HV3 + asymmetric ACL — VALID
cfg.SCOPacketType = "HV3";
cfg.CentralToPeripheralACLPacketType = "3-DH3";  % 3-slot downlink
cfg.PeripheralToCentralACLPacketType = "3-DH1";  % 1-slot uplink

% HV3 + symmetric 3-slot — INVALID (runtime error)
cfg.CentralToPeripheralACLPacketType = "3-DH3";
cfg.PeripheralToCentralACLPacketType = "3-DH3";  % Error!

ACL Packet Types

Connection Config Properties

PHY mode consistency: Both ACL directions must use the same PHY family — either both 1 Mbps (DM/DH), both 2 Mbps (2-DH), or both 3 Mbps (3-DH). Mixing (e.g., DH5 + 3-DH1) causes a runtime error.

Statistics Structure (BR/EDR)

statistics(node).Baseband.ConnectionStats (per peer): PeerNodeName, TransmittedDataBytes, ReceivedDataBytes, TransmittedACLPackets, RetransmittedACLPackets, ReceivedACLPackets, TransmittedSCOPackets, ReceivedSCOPackets, AverageACLPacketLatency

Event Callbacks (BR/EDR)

Single-argument signature: function myCallback(eventData). Fields: eventData.EventData.LogicalTransport ("ACL"/"SCO"), eventData.EventData.PHYMode ("BR"/"EDR2M"/"EDR3M").

registerEventCallback(node, "ReceptionEnded", @myCallback);

<!-- Copyright 2026 The MathWorks, Inc. -->