1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/examples/benchmark_udp/README.md

42 lines
1.3 KiB
Markdown
Raw Normal View History

# UDP Benchmark
This example uses the `benchmark_udp` module to create a stress-test for the RIOT
network stack.
This firmware will act as a client and connect to the benchmark server you can find
in `dist/tools/benchmark_udp`.
## Setup on Hardware
Determine the address of your host machine that will communicate with the RIOT node.
This could be the address of your ethernet interface, or `fd00:dead:beef::1` if you
used the `gnrc_border_router` example and want to run the benchmark on a 6LoWPAN node.
You can either start the benchmark manually by using the `bench_udp start` shell command
or you can configure it to start automatically:
USEMODULE += auto_init_benchmark_udp
CFLAGS += -DBENCH_SERVER_DEFAULT=\"fd00:dead:beef::1\"
## Setup on RIOT native
First, make sure you've compiled the application by calling `make`.
Now, create a tap interface:
sudo ip tuntap add tap0 mode tap user ${USER}
sudo ip link set tap0 up
If you only have a single tap device you can just use the broadcast address
bench_udp start ff02::1
Otherwise use the link-local address of the `tapbr0` interface (if you did set up the tap
devices using `tapsetup`.
## Running the benchmark server
To run the benchmark server on your host machine, follow the instructions found in
dist/tools/benchmark_udp