mirror of
https://github.com/zephyrproject-rtos/zephyr
synced 2025-08-14 02:36:08 +00:00
25307d5331
For stream-based protocols (TCP), adding less data than requested
("short write") is generally not a problem - the rest of data can
be sent in the next packet. So, make net_pkt_append() return length
of written data instead of just bool flag, which makes it closer
to the behavior of POSIX send()/write() calls.
There're many users of older net_pkt_append() in the codebase
however, so net_pkt_append_all() convenience function is added which
keeps returning a boolean flag. All current users were converted to
this function, except for two:
samples/net/http_server/src/ssl_utils.c
samples/net/mbedtls_sslclient/src/tcp.c
Both are related to TLS and implement mbedTLS "tx callback", which
follows POSIX short-write semantics. Both cases also had a code to
workaround previous boolean-only behavior of net_pkt_append() - after
calling it, they measured length of the actual data added (but only
in case of successful return of net_pkt_append(), so that didn't
really help). So, these 2 cases are already improved.
Jira: ZEP-1984
Change-Id: Ibaf7c029b15e91b516d73dab3612eed190ee982b
Signed-off-by: Paul Sokolovsky <paul.sokolovsky@linaro.org>
|
||
|---|---|---|
| .. | ||
| src | ||
| Makefile | ||
| prj_arduino_101_cc2520.conf | ||
| prj_arduino_101.conf | ||
| prj_bt.conf | ||
| prj_cc2520.conf | ||
| prj_frdm_k64f_cc2520.conf | ||
| prj_frdm_k64f_mcr20a.conf | ||
| prj_frdm_k64f.conf | ||
| prj_nrf5.conf | ||
| prj_qemu_802154.conf | ||
| prj_qemu_cortex_m3.conf | ||
| prj_qemu_x86.conf | ||
| prj_sam_e70_xplained.conf | ||
| README.rst | ||
| testcase.ini | ||
.. _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.
The source code for this sample application can be found at:
:file:`samples/net/echo_client`.
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 <networking_with_qemu>`.
There are configuration files for different boards and setups in the
echo-client directory:
- :file:`prj_arduino_101_cc2520.conf`
Use this for Arduino 101 with external IEEE 802.15.4 cc2520 board.
- :file:`prj_arduino_101.conf`
Use this for Arduino 101 with external enc28j60 ethernet board.
- :file:`prj_bt.conf`
Use this for Bluetooth IPSP connectivity.
- :file:`prj_cc2520.conf`
Use this for devices that have support for IEEE 802.15.4 cc2520 chip.
- :file:`prj_frdm_k64f_cc2520.conf`
Use this for FRDM-K64F board with external IEEE 802.15.4 cc2520 board.
- :file:`prj_frdm_k64f.conf`
Use this for FRDM-K64F board with built-in ethernet.
- :file:`prj_frdm_k64f_mcr20a.conf`
Use this for FRDM-K64F board with IEEE 802.15.4 mcr20a board.
- :file:`prj_qemu_802154.conf`
Use this when simulating IEEE 802.15.4 network using two QEMU's that
are connected together.
- :file:`prj_qemu_cortex_m3.conf`
Use this for ARM QEMU.
- :file:`prj_qemu_x86.conf`
Use this for x86 QEMU.
- :file:`prj_sam_e70_xplained.conf`
Use this for Atmel SMART SAM E70 Xplained board with ethernet.
Build echo-client sample application like this:
.. code-block:: console
$ cd $ZEPHYR_BASE/samples/net/echo_client
$ make pristine && make CONF_FILE=<your desired conf file> \
BOARD=<board to use>
Make can select the default configuration file based on the BOARD you've
specified automatically so you might not always need to mention it.
Running echo-server 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.
Run 'loop_socat' and 'loop-slip-tap' scripts from net-tools in Linux host.
.. code-block:: console
$ ./loop_socat.sh
In another window:
.. code-block:: console
$ sudo ./loop-slip-tap.sh
In third window:
.. code-block:: console
$ sudo ./echo-server -i tap0
Run echo-client application in QEMU:
.. code-block:: console
$ cd $ZEPHYR_BASE/samples/net/echo-client
$ make pristine && make qemu