zephyr/samples/net/rpl-mesh-qemu/README.md

1.5 KiB

RPL Mesh Network over QEMU

Overview


This sample uses virtual-hub tool from zephyrproject-rtos/net-tools to setup a multi-node RPL network on top of QEMU. This way, is possible to validate different network topologies in virtualized environment.

In this sample, we will build a three node graph connected like a row:

root <-> node1 <-> node2

Requirements


First of all, we must clone net-tools repository, and build virtual-hub:

cd virtual-hub
mkdir build && cd build
cmake ..
make

Building and Running


  1. Build and run the RPL root application:
cd root
mkdir build && cd build
cmake -DQEMU_PIPE_ID=1 ..
make
make node
  1. Build and run the first RPL node application:
cd node
mkdir build-1 && cd build-1
cmake -DQEMU_PIPE_ID=2 ..
make
make node
  1. Build and run the second RPL node application:
cd node
mkdir build-2 && cd build-2
cmake -DQEMU_PIPE_ID=3 ..
make
make node
  1. Now we should run the virtual-hub, which will connect all the pipes according to the csv file:
cd virtual-hub/build
./hub ../input.csv
  1. Wait until the network is fine, you can check it using net shell on root application:
select net
route

You should see two routes pointing to both clients application.

Virtual-Hub Notes


When trying to reboot/drop a node from network you must also reboot the virtual-hub to keep it working properly.

For more details about how to customize the network, follow the README instructions from virtual-hub repository.