This is the documentation for the latest (main) development branch of Zephyr. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

Networking with QEMU and IEEE 802.15.4

This page describes how to set up a virtual network between two QEMUs that are connected together via UART and are running IEEE 802.15.4 link layer between them. Note that this only works in Linux host.

Basic Setup

For the steps below, you will need two terminal windows:

  • Terminal #1 is terminal window with echo-server Zephyr sample application.

  • Terminal #2 is terminal window with echo-client Zephyr sample application.

If you want to capture the transferred network data, you must compile the monitor_15_4 program in net-tools directory.

Open a terminal window and type:

cd $ZEPHYR_BASE/../net-tools
make monitor_15_4

Step 1 - Compile and start echo-server

In terminal #1, type:

west build -b qemu_x86 -d build/server samples/net/sockets/echo_server -- -DEXTRA_CONF_FILE=overlay-qemu_802154.conf
west build -t server -d build/server

If you want to capture the network traffic between the two QEMUs, type:

west build -b qemu_x86 -d build/server samples/net/sockets/echo_server -- -G'Unix Makefiles' -DEXTRA_CONF_FILE=overlay-qemu_802154.conf -DPCAP=capture.pcap
west build -t server -d build/server

Note that the make must be used for server target if packet capture option is set in command line. The build/server/capture.pcap file will contain the transferred data.

Step 2 - Compile and start echo-client

In terminal #2, type:

west build -b qemu_x86 -d build/client samples/net/sockets/echo_client -- -DEXTRA_CONF_FILE=overlay-qemu_802154.conf
west build -t client -d build/client

You should see data passed between the two QEMUs. Exit QEMU by pressing CTRL+A x.