mirror of
https://github.com/zephyrproject-rtos/zephyr
synced 2025-09-01 16:23:34 +00:00
7eabab2f5d
When using an IDE (e.g. Eclipse, Qt Creator), the project name gets displayed. This greatly simplifies the navigation between projects when having many of them open at the same time. Naming every project "NONE" defeats this functionality. This patch tries to use sensible project names while not duplicating too much of what is already represented in the path. This is done by using the name of the directory the relevant CMakeLists.txt file is stored in. To ensure unique project names in the samples (and again, in the tests folder) folder, small manual adjustments have been done. Signed-off-by: Reto Schneider <code@reto-schneider.ch> |
||
|---|---|---|
| .. | ||
| src | ||
| CMakeLists.txt | ||
| prj_frdm_k64f.conf | ||
| README.rst | ||
| sample.yaml | ||
.. _throughput-server-sample:
Throughput Server
#################
Overview
********
The throughput-server sample application for Zephyr implements a UDP server
that complements the throughput-client tool from Zephyr `net-tools`_ repository.
The throughput-server listens for incoming IPv4 or IPv6 packets (sent by the
throughput-client) and optionally sends the packets back.
Note that it makes sense to use this sample (only) with high-performance
bearer like Ethernet.
The source code for this sample application can be found at:
:file:`samples/net/throughput_server`.
Building and Running
********************
The application can be used on multiple boards and with different bearers.
Emulation using QEMU is not recommended because the ethernet connection in
QEMU is done using a serial port with SLIP, so it is very slow.
There are configuration files for different boards and setups in the
throughput-server directory:
- :file:`prj_frdm_k64f.conf`
Use this for FRDM-K64F board with built-in ethernet.
Build throughput-server sample application like this:
.. zephyr-app-commands::
:zephyr-app: samples/net/throughput_server
:board: <board to use>
:conf: <config file to use>
:goals: build
:compact:
Make will select the default configuration file based on the BOARD you
specified to CMake.
Note that shell support is not activated in the throughput-server so that
we can save some memory and have as many net_buf's configured in the system
as possible.
Running throughput-client in Linux Host
=======================================
In this example, the throughput-server is run on a board and throughput-client
is run on a Linux host. The throughput-client can be found at the `net-tools`_
project.
Open a terminal window and type:
.. code-block:: console
$ cd net-tools
$ ./throughput-client -F -s 200 2001:db8::1
Note that throughput-server must be running on the device under test before you
start the throughput-client application in a host terminal window.
.. _`net-tools`: https://github.com/zephyrproject-rtos/net-tools