Create, Configure, and Simulate Bluetooth BR/EDR Piconet

This example shows how to simulate a Bluetooth® basic rate/enhanced data ret (BR/EDR) piconet by using Bluetooth® Toolbox and Communications Toolbox™ Wireless Network Simulation Library.

Using this example, you can:

1. Create and configure a Bluetooth BR/EDR piconet with one Central and multiple Peripheral nodes.

2. Create, configure, and share connections between the Central and Peripheral nodes.

3. Simulate a Bluetooth BR/EDR piconet with synchronous connection-oriented (SCO) traffic, and retrieve the statistics of the Central and Peripheral nodes.

Check if the Communications Toolbox Wireless Network Simulation Library support package is installed. If the support package is not installed, MATLAB® returns an error with a link to download and install the support package.

wirelessnetworkSupportPackageCheck;

Create a wireless network simulator.

networkSimulator = wirelessNetworkSimulator.init;

Create a Bluetooth BR/EDR node, specifying the role as "central".

centralNode = bluetoothNode("central");

Create two Bluetooth BR/EDR Peripheral nodes and specify their positions in Cartesian x-, y-, and z-coordinates.

peripheralNode = bluetoothNode("peripheral",Position=[0 1 0; 2 1 2]); % In meters

Create a default Bluetooth BR/EDR connection configuration object to configure and share the connection between the Central and Peripheral nodes. Specify the SCO packet type.

cfgConnection = bluetoothConnectionConfig(SCOPacketType="HV3")

cfgConnection = 
  bluetoothConnectionConfig with properties:

    CentralToPeripheralACLPacketType: "DH1"
    PeripheralToCentralACLPacketType: "DH1"
                       SCOPacketType: "HV3"
                 HoppingSequenceType: "Connection adaptive"
                        UsedChannels: [0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 ... ] (1x79 double)
                        PollInterval: 40
                       InstantOffset: 240
                    TransmitterPower: 20
                  SupervisionTimeout: 32000
                      CentralAddress: [1x0 char]
                    PrimaryLTAddress: []

Configure connections between the Central and the Peripheral nodes. Note that, when you configure the connections, the SCO traffic is internally added as two-way traffic between the Central and Peripheral nodes.

connection = configureConnection(cfgConnection,centralNode,[peripheralNode(1) peripheralNode(2)]);

Create a Bluetooth piconet consisting of one Central and two Peripheral nodes.

nodes = [centralNode peripheralNode];

Add the Central and Peripheral nodes to the wireless network simulator.

addNodes(networkSimulator,nodes);

Set the simulation time in seconds, and run the simulation.

simulationTime = 0.5;
run(networkSimulator,simulationTime);

Retrieve application, baseband, and physical layer (PHY) statistics corresponding to the Central and Peripheral nodes.

nodeStats = statistics(nodes)

nodeStats=1×3 struct array with fields:
    Name
    ID
    App
    Baseband
    PHY

References

[1] Bluetooth^® Technology Website. “Bluetooth Technology Website | The Official Website of Bluetooth Technology.” Accessed June 22, 2022. https://www.bluetooth.com/.

[2] Bluetooth Special Interest Group (SIG). "Bluetooth Core Specification." Version 5.3. https://www.bluetooth.com/.