addTrafficSource

Add data traffic source to Bluetooth BR/EDR node on ACL connection

Since R2022b

collapse all in page

    Download Required: To use addTrafficSource, first download the Communications Toolbox Wireless Network Simulation Library add-on. For more information, see Get and Manage Add-Ons.

    Syntax

    addTrafficSource(bluetoothBRNodeObj,trafficSource,DestinationNode=connectedNode)

    Description

    addTrafficSource(bluetoothBRNodeObj,trafficSource,DestinationNode=connectedNode) adds a data traffic source object, trafficSource, to the specified Bluetooth® basic rate/enhanced data rate (BR/EDR) node for sending data to the specified connected destination node, connectedNode.

    Note

    Each time you call this object function, you add a traffic generator (source) to a Bluetooth BR/EDR node. You can add multiple traffic sources to a node, directing them to the same or different destination nodes.

    example

    Examples

    collapse all

    This example uses:

    Open Live Script

    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;

    Initialize the wireless network simulator.

    networkSimulator = wirelessNetworkSimulator.init;

    Create two Bluetooth BR nodes, one with the "central" role and the other with the "peripheral" role. Specify the position of the Peripheral node, in meters.

    centralNode = bluetoothNode("central");
peripheralNode = bluetoothNode("peripheral",Position=[1 0 0]);

    Add a random waypoint mobility model to the peripheral node. Set the shape of the node's mobility area to "circle".

    addMobility(peripheralNode,BoundaryShape="circle")

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

    cfgConnection = bluetoothConnectionConfig;

    Configure the connection between the Central and the Peripheral nodes.

    connection = configureConnection(cfgConnection,centralNode,peripheralNode)
    connection = 
  bluetoothConnectionConfig with properties:

    CentralToPeripheralACLPacketType: "DH1"
    PeripheralToCentralACLPacketType: "DH1"
                       SCOPacketType: "None"
                 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 … ] (1×79 double)
                        PollInterval: 40
                       InstantOffset: 240
                    TransmitterPower: 20
                  SupervisionTimeout: 32000
                      CentralAddress: "D091BBE70001"
                    PrimaryLTAddress: 1

    Create and configure a networkTrafficOnOff object to generate an On-Off application traffic pattern.

    traffic = networkTrafficOnOff(DataRate=200,PacketSize=27, ...
    GeneratePacket=true,OnTime=inf);

    Add application traffic from the Central to the Peripheral node.

    addTrafficSource(centralNode,traffic,DestinationNode=peripheralNode);

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

    addNodes(networkSimulator,[centralNode peripheralNode]);

    Specify the simulation time, in seconds.

    simulationTime = 0.3;

    Run the simulation for the specified simulation time.

    run(networkSimulator,simulationTime);

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

    centralStats = statistics(centralNode)
    centralStats = struct with fields:
        Name: "Node1"
          ID: 1
         App: [1×1 struct]
    Baseband: [1×1 struct]
         PHY: [1×1 struct]


    peripheralStats = statistics(peripheralNode)
    peripheralStats = struct with fields:
        Name: "Node2"
          ID: 2
         App: [1×1 struct]
    Baseband: [1×1 struct]
         PHY: [1×1 struct]

    Input Arguments

    collapse all

    Bluetooth BR/EDR node object, specified as a bluetoothNode object.

    On-Off application traffic pattern object, specified as a networkTrafficOnOff object. The object function uses this input to transport data traffic over the asynchronous connection-oriented logical (ACL) link of the connection. If you specify this input, the generatePacket property of the networkTrafficOnOff object is not applicable because the Bluetooth BR/EDR node will always generate the packets.

    When you add the application traffic to a Bluetooth BR/EDR node by using this object function, the bluetoothBRNodeObj automatically calls the generate object function associated with the networkTrafficOnOff object to generate the corresponding application traffic packet.

    Name of the destination node, specified as a bluetoothNode object.

    Data Types: char | string

    References

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

    [2] Bluetooth Core Specifications Working Group. "Bluetooth Core Specification" v5.3. https://www.bluetooth.com/.

    Version History

    Introduced in R2022b

    See Also

    Objects

    Functions