Bluetooth System-Level Simulation
Entry point for all Bluetooth system-level simulation. All Bluetooth simulations use sim = wirelessNetworkSimulator.init and follow the workflow defined in matlab-simulate-wireless-network (simulator init, traffic, mobility, instrumentation, addNodes, run).
When to Use
- BLE ACL point-to-point or star network connections
- LE Audio unicast with CIS/CIG (stereo speakers, hearing aids)
- BLE GAP connection establishment (advertising, scanning, connection timing)
- Classic BR/EDR piconets with ACL data or SCO voice
- BLE + BR/EDR coexistence with adaptive frequency hopping
- Any simulation using
bluetoothLENode, bluetoothNode
When Not to Use
- Non-Bluetooth wireless simulations (use
matlab-simulate-wireless-network instead)
- PHY-layer or link level Bluetooth waveform generation, receiver analysis or BER analysis
- Generic simulator setup, traffic models, or mobility (use
matlab-simulate-wireless-network)
Scenario → Reference Routing
| Scenario |
Reference |
| BLE realistic connection setup (advertising, scanning, GAP) |
references/ble-gap-connection.md |
| BLE point-to-point data, star network, ACL connections |
references/ble-connection.md |
| LE Audio unicast (stereo speakers, hearing aids, CIS/CIG) |
references/ble-cis.md |
| Classic Bluetooth earbuds, SCO voice, ACL data |
references/bluetooth-bredr.md |
| BLE + BR/EDR coexistence, adaptive frequency hopping |
references/bluetooth-coexistence.md |
| Capture and visualization (PCAP, IQ, event tracing, traffic viewer) |
See matlab-simulate-wireless-network skill |
Node Roles
- BLE (ACL, CIS):
bluetoothLENode("central"), bluetoothLENode("peripheral")
- BR/EDR:
bluetoothNode("central"), bluetoothNode("peripheral") — max 7 peripherals per central
Traffic Attachment Rules
addTrafficSource(sourceNode, traffic, ...):
- ACL/CIS/BR/EDR:
DestinationNode=peer required. CIS also needs CISConfig=cfgCISOut.
- BR/EDR SCO: No traffic call — implicit via
SCOPacketType in connection config.
kpi() Availability
| Topology |
"throughput" |
"latency" |
"PLR" / "PDR" |
Layer |
| BLE ACL |
LL only |
App only |
Both LL and App |
"LL" or "App" |
| BLE CIS |
LL only |
App only |
Both LL and App |
"LL" or "App" |
| BR/EDR |
Baseband |
— |
Baseband |
"Baseband" |
Connection/Configuration Setup
| Topology |
Config Object |
Function |
Notes |
| BLE ACL |
bluetoothLEConnectionConfig |
configureConnection(cfg, central, peripheral) |
Per-peripheral in loop; unique AccessAddress per connection |
| BLE CIS |
bluetoothLEConnectionConfig + bluetoothLECISConfig |
[~, cfgCISOut] = configureConnection(cfg, central, peripheral, CISConfig=cfgCIS) |
Pass cfgCISOut to addTrafficSource(..., CISConfig=cfgCISOut) |
| BR/EDR |
bluetoothConnectionConfig |
configureConnection(cfg, central, peripherals) |
Single call with vector of peripherals |
Common Mistakes
bluetoothNode for BLE (or vice versa): BR/EDR = bluetoothNode, BLE = bluetoothLENode- Wrong kpi Layer: BLE throughput →
"LL", BLE latency → "App", BR/EDR → "Baseband" only
- Properties locked after
run(): Node/connection properties cannot change mid-sim. Use updateChannelList for mid-sim channel updates.
configureConnection with peripheral vector for BLE: Must call per-peripheral in loop (BR/EDR accepts vector)- Unique
AccessAddress per connection: Each BLE connection on same central needs different AccessAddress
- DataRate in Kbps:
DataRate=100 means 100 Kbps, not 100 bps
GeneratePacket=true is not valid: Not applicable for network-level simulation. Use OnTime=Inf for continuous traffic.
