zephyr

History

Gil Pitney a4cc88ad30 samples: net: sockets: echo-client: fix sock fd test, allow zero. Per: http://pubs.opengroup.org/onlinepubs/009695399/functions/socket.html "Upon successful completion, socket() shall return a non-negative integer, the socket file descriptor." The test in prepare_fds() however fails if socket fd is zero (non-negative), which should be a valid value. This was found while testing the SimpleLink socket offload driver, which can return a zero-valued socket fd, per the POSIX spec. Signed-off-by: Gil Pitney <gil.pitney@linaro.org>		2018-08-22 15:37:15 -07:00
..
boards	samples: net: Add DTLS support to socket echo_client/echo_server	2018-08-13 15:24:34 +03:00
src	samples: net: sockets: echo-client: fix sock fd test, allow zero.	2018-08-22 15:37:15 -07:00
CMakeLists.txt	cmake: Prepend 'cmake_minimum_required()' into 'app' build scripts	2018-08-15 04:06:50 -07:00
README.rst	…
overlay-tls.conf	samples: net: Add DTLS support to socket echo_client/echo_server	2018-08-13 15:24:34 +03:00
prj.conf	net: config: Rename Kconfig options to correspond to library name	2018-08-13 18:42:31 -07:00
sample.yaml	…

README.rst

.. _sockets-echo-client-sample:

Echo Client
###########

Overview
********

The echo-client sample application for Zephyr implements a UDP/TCP client
that will send IPv4 or IPv6 packets, wait for the data to be sent back,
and then verify it matches the data that was sent.

This sample is a port of the :ref:`echo-client-sample`. It has been rewritten
to use socket API instead of native net-app API.

The source code for this sample application can be found at:
:file:`samples/net/sockets/echo_client`.

Requirements
************

- :ref:`networking_with_qemu`

Building and Running
********************

There are multiple ways to use this application. One of the most common
usage scenario is to run echo-client application inside QEMU. This is
described in :ref:`networking_with_qemu`.

Build echo-client sample application like this:

.. zephyr-app-commands::
   :zephyr-app: samples/net/sockets/echo_client
   :board: <board_to_use>
   :goals: build
   :compact:

``board_to_use`` defaults to ``qemu_x86``. In this case, you can run the
application in QEMU using ``make run``. If you used another BOARD, you
will need to consult its documentation for application deployment
instructions. You can read about Zephyr support for specific boards in
the documentation at :ref:`boards`.

Running echo-server in Linux Host
=================================

There is one useful testing scenario that can be used with Linux host.
Here echo-client is run in QEMU and echo-server is run in Linux host.

To use QEMU for testing, follow the :ref:`networking_with_qemu` guide.

In a terminal window:

.. code-block:: console

    $ sudo ./echo-server -i tap0

Run echo-client application in QEMU:

.. zephyr-app-commands::
   :zephyr-app: samples/net/sockets/echo_client
   :host-os: unix
   :board: qemu_x86
   :goals: run
   :compact:

Note that echo-server must be running in the Linux host terminal window
before you start the echo-client application in QEMU.

See the :ref:`sockets-echo-server-sample` documentation for an alternate
way of running, with the echo-client on the Linux host and the echo-server
in QEMU.