Establish Friendship Between Friend Node and LPN in Bluetooth Mesh Network

This example shows how to simulate a Bluetooth® mesh network by using Bluetooth® Toolbox and Communications Toolbox™ Wireless Network Simulation Library.

Using this example, you can:

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 default Bluetooth mesh profile configuration object, specifying the element address of the source node.

cfgMeshSource = bluetoothMeshProfileConfig(ElementAddress="0001");

Create a Bluetooth LE node, specifying the role as "broadcaster-observer". Specify the position of the source node. Assign the mesh profile configuration to the source node.

sourceNode = bluetoothLENode("broadcaster-observer",AdvertisingInterval=30e-3,ScanInterval=30e-3);
sourceNode.Position = [0 0 0];
sourceNode.MeshConfig = cfgMeshSource;

Create a default Bluetooth mesh profile configuration object, specifying the element address and enabling the relay feature of the Bluetooth LE node.

cfgMeshRelay = bluetoothMeshProfileConfig(ElementAddress="0002",Relay=true);

Create a Bluetooth LE node, specifying the role as "broadcaster-observer". Specify the position of the relay node. Assign the mesh profile configuration to the relay node.

relayNode = bluetoothLENode("broadcaster-observer",AdvertisingInterval=30e-3,ScanInterval=30e-3);
relayNode.Position = [25 0 0];
relayNode.MeshConfig = cfgMeshRelay;

Create a default Bluetooth mesh profile configuration object, specifying the element address and enabling the friend feature of the Bluetooth LE node.

cfgMeshFriend = bluetoothMeshProfileConfig(ElementAddress="0003",Friend=true);

Create a Bluetooth LE node, specifying the role as "broadcaster-observer". Specify the position of the friend node. Assign the mesh profile configuration to the friend node.

friendNode = bluetoothLENode("broadcaster-observer",AdvertisingInterval=30e-3,ScanInterval=30e-3);
friendNode.Position = [50 0 0];
friendNode.MeshConfig = cfgMeshFriend;

Create a default Bluetooth mesh profile configuration object, specifying the element address of the Bluetooth LE node.

cfgMeshLPN = bluetoothMeshProfileConfig(ElementAddress="0004",LowPower=true);

Create a Bluetooth LE node, specifying the role as "broadcaster-observer". Specify the position of the LPN node. Assign the mesh profile configuration to the LPN.

lowPowerNode = bluetoothLENode("broadcaster-observer",AdvertisingInterval=30e-3,ScanInterval=30e-3);
lowPowerNode.Position = [75 0 0];
lowPowerNode.MeshConfig = cfgMeshLPN;

Create a default Bluetooth mesh friendship configuration object. Specify the poll timeout to terminate a friendship, the receive window supported by Friend node, and the receive delay requested by LPN, in seconds.

cfgFriendship = bluetoothMeshFriendshipConfig;
cfgFriendship.PollTimeout = 6;          
cfgFriendship.ReceiveWindow = 180e-3; 
cfgFriendship.ReceiveDelay = 50e-3;

Configure the connection between the friend node and LPN by using the configureFriendship object function of the bluetoothMeshFriendshipConfig object.

configureFriendship(cfgFriendship,friendNode,lowPowerNode);

Create a networkTrafficOnOff object to generate an On-Off application traffic pattern. Specify the on time, data rate in kb/s, and packet size in bytes. Generate an application packet with a payload by enabling packet generation.

traffic = networkTrafficOnOff(OnTime=inf, ...
    DataRate=1, ...
    PacketSize=15, ...
    GeneratePacket=true);

Add application traffic between the source and destination node.

addTrafficSource(sourceNode,traffic, ...
    SourceAddress=cfgMeshSource.ElementAddress, ...
    DestinationAddress=cfgMeshLPN.ElementAddress,TTL=5);

Create a Bluetooth mesh network consisting of the source node, relay node, friend node and destination node.

nodes = {sourceNode relayNode friendNode lowPowerNode};

Add the mesh nodes to the wireless network simulator.

addNodes(networkSimulator,nodes)

Set the simulation time and run the simulation.

simulationTime = 5;                   % In seconds
run(networkSimulator,simulationTime);

Retrieve application, link layer (LL) , and physical layer (PHY) statistics related to the source, relay, and destination nodes by using the statistics object function. For more information about the statistics, see Bluetooth LE Node Statistics.

sourceStats = statistics(sourceNode)

sourceStats = struct with fields:
         Name: "Node1"
           ID: 1
          App: [1x1 struct]
    Transport: [1x1 struct]
      Network: [1x1 struct]
           LL: [1x1 struct]
          PHY: [1x1 struct]

relayStats = statistics(relayNode)

relayStats = struct with fields:
         Name: "Node2"
           ID: 2
          App: [1x1 struct]
    Transport: [1x1 struct]
      Network: [1x1 struct]
           LL: [1x1 struct]
          PHY: [1x1 struct]

friendStats = statistics(friendNode)

friendStats = struct with fields:
         Name: "Node3"
           ID: 3
          App: [1x1 struct]
    Transport: [1x1 struct]
      Network: [1x1 struct]
           LL: [1x1 struct]
          PHY: [1x1 struct]

LPNStats = statistics(lowPowerNode)

LPNStats = struct with fields:
         Name: "Node4"
           ID: 4
          App: [1x1 struct]
    Transport: [1x1 struct]
      Network: [1x1 struct]
           LL: [1x1 struct]
          PHY: [1x1 struct]

Display the number of data messages transmitted by the Friend node.

fprintf("Number of data messages transmitted by the Friend node = %d\n",friendStats.Transport.TransmittedDataMessages);

Number of data messages transmitted by the Friend node = 3

Display the number of received data messages at the LPN.

fprintf("Number of data messages received by the LPN = %d\n",LPNStats.Transport.ReceivedDataMessages);

Number of data messages received by the LPN = 3

See Also

Functions

• addTrafficSource | statistics | configureFriendship

Objects

• wirelessNetworkSimulator | bluetoothLENode | bluetoothMeshProfileConfig | bluetoothMeshFriendshipConfig

Related Topics

• Create, Configure and Simulate Bluetooth Mesh Network
• Create, Configure, and Simulate Bluetooth LE Network With Custom Channel
• Create, Configure, and Simulate Bluetooth LE Broadcast Audio Network
• Create and Visualize Bluetooth LE Broadcast Audio Residential Scenario
• Bluetooth LE Node Statistics
• Energy Profiling of Bluetooth Mesh Nodes in Wireless Sensor Networks
• Bluetooth Mesh Flooding in Wireless Sensor Networks