matlab-simulate-bluetooth-network

Simulate Bluetooth system-level networks including BLE, LE Audio, and Classic BR/EDR in MATLAB.

995|122|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/matlab/matlab-agentic-toolkit --skill matlab-simulate-bluetooth-network
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: matlab-simulate-bluetooth-network
Source: https://github.com/matlab/matlab-agentic-toolkit/tree/main/skills-catalog/wireless-communications/matlab-simulate-bluetooth-network
Command: npx skills add https://github.com/matlab/matlab-agentic-toolkit --skill matlab-simulate-bluetooth-network

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Configuring Bluetooth system-level simulations in MATLAB involves many interdependent parameters—connection intervals, CIS timing, SCO slot reservations, and adaptive frequency hopping—where small mistakes cause runtime errors or invalid results. This Skill provides validated configuration patterns, constraint rules, and complete code templates for every Bluetooth topology.

Core Features & Use Cases

  • BLE ACL and GAP Connections: Configure central-peripheral data links with pre-configured connections or realistic advertising/scanning-based connection establishment.
  • LE Audio via CIS: Simulate stereo speakers, hearing aids, and multi-channel audio with pre-validated CIS timing templates aligned to LC3 codec intervals.
  • Classic BR/EDR Piconets: Model SCO voice links (HV1/HV2/HV3) and ACL data with packet-type compatibility rules and slot reservation constraints.
  • Coexistence and AFH: Run mixed BLE + BR/EDR scenarios with data-driven adaptive frequency hopping via updateChannelList.
  • Use Case: Simulate a stereo true-wireless earbud scenario by creating a BLE central with two peripherals, applying the Stereo TWS CIS template, and measuring throughput and latency with kpi().

Quick Start

Ask your AI agent to simulate a BLE star network with one central and four peripherals in MATLAB and report per-connection throughput using the Bluetooth Toolbox.

Frequently Asked Questions about matlab-simulate-bluetooth-network

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I simulate a BLE connection in MATLAB?

Create bluetoothLENode objects for central and peripheral roles, configure the link with bluetoothLEConnectionConfig and configureConnection, attach traffic with addTrafficSource, then add nodes to wirelessNetworkSimulator and call run. Each connection needs a unique AccessAddress.

How do I simulate LE Audio with CIS in MATLAB?

Create a bluetoothLECISConfig with ISOInterval matching the LC3 frame interval (typically 0.02s), pass it to configureConnection, and use the returned CIS config in addTrafficSource. ConnectionInterval must equal NumPeripherals times ISOInterval.

What is the difference between bluetoothNode and bluetoothLENode?

bluetoothLENode is for Bluetooth Low Energy simulations (ACL, CIS, GAP), while bluetoothNode is for Classic BR/EDR piconets with SCO voice and ACL data. Using the wrong node type for a topology is a common error.

Why does my BLE multi-peripheral simulation fail with configureConnection?

BLE configureConnection does not accept a vector of peripherals; call it once per peripheral in a loop with staggered ConnectionOffset values and unique AccessAddress values. ActivePeriod must also be a multiple of 1.25ms to avoid scheduling loops.

Can SCO voice and ACL data coexist in a BR/EDR simulation?

Yes, but with constraints: 5-slot ACL packets never work with any SCO type, HV3 supports asymmetric 3-slot ACL in one direction only, and HV2 allows 1-slot ACL only. SCO traffic is implicit via SCOPacketType and needs no addTrafficSource call.

When should I not use system-level Bluetooth simulation?

Avoid it for PHY-layer or link-level work such as waveform generation, receiver analysis, or BER testing, which require different Bluetooth Toolbox workflows. This approach models network behavior, throughput, and latency, not physical-layer signal processing.