zephyr/samples/net/zperf
Tomasz Bursztyka 6158dfdda6 samples: net: STDOUT_CONSOLE is not necessary
printk can do the job properly.

Change-Id: Ib743328e046bdb29be26adfe5cd007aaa758cd64
Signed-off-by: Tomasz Bursztyka <tomasz.bursztyka@linux.intel.com>
2017-01-02 10:03:17 +01:00
..
src
Makefile
prj_frdm_k64f_prof.conf
prj_frdm_k64f.conf
prj_galileo_ethernet_prof.conf
prj_galileo_ethernet.conf
prj_qemu_x86.conf
prj_quark_se_c1000_devboard.conf
README.rst
testcase.ini

Zperf: Network Traffic Generator
################################

Description
===========

Zperf is a network traffic generator for Zephyr that may be used to
evaluate network bandwidth.

Features
=========

- Compatible with iPerf_2.0.5.
- Client or server mode allowed without need to modify the source code.
- Working with task profiler (PROFILER=1 to be set when building zperf)

Supported Boards
================

zperf is board-agnostic. However, zperf requires a network interface.
So far, zperf has been tested only on the Intel Galileo Development Board.

Usage
=====

If the zephyr is a client, then you can start the iperf in host with these
command line options if you want to test UDP:

$ iperf -s -l 1K -u -V -B 2001:db8::2

In zephyr start zperf like this

zperf> udp.upload 2001:db8::2 5001 10 1K 1M

or if you have set the zephyr and peer host IP addresses in config file,
then you can simply say

zperf> udp.upload2 v6 10 1K 1M


If the zephyr is acting as a server, then first start zephyr in download
mode like this:

zperf> udp.download 5001

and in host side start iperf like this

$ iperf -l 1K -u -V -c 2001:db8::1 -p 5001

Note the you might need to rate limit the output using -b option
if zephyr is not able to receive all the packets in orderly manner.