zephyr/samples/net/zperf
Anas Nashif 4b20b634be samples: fix RST syntax and add headers
Change-Id: Ic94213f97698bd861516de0bd159fb37f9124883
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-12-22 08:01:49 -05:00
..
src samples: zperf: Port to native IP stack 2016-12-02 12:41:19 +02:00
Makefile samples: zperf: Port to native IP stack 2016-12-02 12:41:19 +02:00
README.rst samples: fix RST syntax and add headers 2016-12-22 08:01:49 -05:00
prj_frdm_k64f.conf libc: rework libc selection and reduce Kconfigs 2016-12-15 22:31:28 +00:00
prj_frdm_k64f_prof.conf libc: rework libc selection and reduce Kconfigs 2016-12-15 22:31:28 +00:00
prj_galileo_ethernet.conf libc: rework libc selection and reduce Kconfigs 2016-12-15 22:31:28 +00:00
prj_galileo_ethernet_prof.conf libc: rework libc selection and reduce Kconfigs 2016-12-15 22:31:28 +00:00
prj_qemu_x86.conf libc: rework libc selection and reduce Kconfigs 2016-12-15 22:31:28 +00:00
prj_quark_se_c1000_devboard.conf libc: rework libc selection and reduce Kconfigs 2016-12-15 22:31:28 +00:00
testcase.ini samples: zperf: Port to native IP stack 2016-12-02 12:41:19 +02:00

README.rst

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.