zephyr/samples/net/rpl-mesh-qemu
Pedro Martucci a495b31ee0 sample: net: RPL mesh sample over QEMU
Create a net sample to setup a multi-node RPL mesh network using QMEU.
To enable this, it was necessary implement a hw filter on IEEE 802.15.4
UART Pipe driver and create a QEMU pipe management on cmake.

This sample use a tool developed on zephyr net-tools repository called
virtual-hub.

Signed-off-by: Pedro Martucci <pedropaulomartucci@gmail.com>
2018-02-20 14:47:14 +02:00
..
node sample: net: RPL mesh sample over QEMU 2018-02-20 14:47:14 +02:00
root sample: net: RPL mesh sample over QEMU 2018-02-20 14:47:14 +02:00
README.md sample: net: RPL mesh sample over QEMU 2018-02-20 14:47:14 +02:00

README.md

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.