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.

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