samples/net/rpl-mesh-qemu/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
```

2. Build and run the first RPL node application:
```
cd node
mkdir build-1 && cd build-1
cmake -DQEMU_PIPE_ID=2 ..
make
make node
```

3. Build and run the second RPL node application:
```
cd node
mkdir build-2 && cd build-2
cmake -DQEMU_PIPE_ID=3 ..
make
make node
```

4. 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
```

5. 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.