Matlab Simulate Bluetooth Network

MathWorksOfficialCreated by MathWorks

Skill
Tool integration
Science and research
BSD-2-Clause
No issues found

From the author

Simulate Bluetooth system-level networks using the Bluetooth Toolbox. Use this skill for any Bluetooth topology: BLE ACL (Asynchronous Connection-Less) data connections, CIS (Connected Isochronous Stream) and LE Audio for stereo speakers or hearing aids, BLE GAP (Generic Access Profile) connection establishment with advertising and scanning, Classic BR/EDR piconets with ACL data and SCO (Synchronous Connection-Oriented) voice links, and BLE+BR/EDR coexistence with adaptive frequency hopping. Covers bluetoothLENode, bluetoothNode, bluetoothLEConnectionConfig, bluetoothLECISConfig, bluetoothLEGAPConfig, bluetoothConnectionConfig, configureConnection, kpi (), updateChannelList, and all Bluetooth statistics.

— the description by MathWorks

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides the framework for performing system-level simulations of Bluetooth networks using the Bluetooth Toolbox. It enables the modeling of various Bluetooth topologies, including BLE ACL data connections, LE Audio streams (CIS/CIG), Classic BR/EDR piconets, and coexistence scenarios with adaptive frequency hopping. The skill integrates with the wireless network simulator to allow for node configuration, traffic generation, and performance analysis through KPIs.

What it does

Simulates BLE ACL connections and LE Audio streams like CIS/CIG.
Models Classic BR/EDR piconets with ACL data and SCO voice links.
Supports BLE and BR/EDR coexistence with adaptive frequency hopping.
Configures connection parameters such as intervals, offsets, and PHY modes.
Provides KPI tracking for throughput, latency, and packet loss rates.
Facilitates node setup using specialized Bluetooth node objects.

When to use it

When evaluating Bluetooth network performance at the system level.
For simulating multi-peripheral star networks or LE Audio use cases.
When testing connection establishment and timing in BLE GAP scenarios.
For analyzing coexistence between different Bluetooth technologies.
When you need to model specific Bluetooth topologies like stereo TWS or hearing aids.

Advantages

Enables system-level performance analysis without needing full PHY-layer modeling.
Provides pre-validated templates for common audio and data use cases.
Allows for flexible configuration of connection parameters and channel selection.
Supports complex multi-node topologies with specific traffic requirements.
Integrates seamlessly with standard wireless network simulation workflows.

Usage examples

“How do I set up a basic BLE point-to-point connection?”: The skill provides a pattern using bluetoothLENode and configureConnection to establish an ACL link between a central and peripheral node.
“Can I simulate LE Audio for stereo speakers?”: Yes, the skill supports CIS configuration for LE Audio, allowing you to define ISO intervals and subevents for multi-peripheral audio streams.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/matlab/matlab-simulate-bluetooth-network/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip matlab-simulate-bluetooth-network.zip -d .agents/skills

Documentation by MathWorks

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.

Files

ATTRIBUTION.mdAdded by AutoGineer1.1 KiB
LICENSELicence file added by AutoGineer1.4 KiB
SKILL.md4.7 KiB
manifest.yaml522 B
references/ble-cis.md5.9 KiB
references/ble-connection.md4.9 KiB
references/ble-gap-connection.md6.3 KiB
references/bluetooth-bredr.md6.2 KiB
references/bluetooth-coexistence.md5.1 KiB

LICENSE

Copyright 2026 The MathWorks, Inc.
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. In all cases, the software is, and all modifications and derivatives of the software shall be, licensed to you solely for use in conjunction with MathWorks products and service offerings.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

The author says: >=R2026a

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by

MathWorks

Publisher

MathWorks (Official)

Source

matlab/matlab-agentic-toolkit · skills-catalog/wireless-communications/matlab-simulate-bluetooth-network · commit 2a7f215

Licence

BSD 2-Clause License (redistribution allowed)

LICENSE (added by AutoGineer from LICENSE.md)
ATTRIBUTION.md (written by AutoGineer)

Synced

2026-11-08

AutoGineer is not affiliated with or endorsed by MathWorks.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download matlab-simulate-bluetooth-network.zip