zephyr/samples/net
Anas Nashif f75462984f doc: update networking with Qemu section
Copy the documentation from the Wiki over here, the cross linking
between online documentation and Wiki and duplication of information was
inconsistent and confusing. Put everything in one place.

Change-Id: Ia3aaec1b431477e2ec54dbec2ccaa655870b0ee3
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2017-02-03 15:59:19 +02:00
..
coaps_client net: correct in*_addr parameter of net_addr_pton() 2017-02-03 15:59:13 +02:00
coaps_server net: correct in*_addr parameter of net_addr_pton() 2017-02-03 15:59:13 +02:00
common license: Replace Apache boilerplate with SPDX tag 2017-01-19 03:50:58 +00:00
dhcpv4_client samples/net: Fix a tiny mistake in dhcpv4_client README.rst 2017-02-03 15:59:14 +02:00
dns_client samples/net/dns: Improve network configuration 2017-02-03 15:59:18 +02:00
echo_client net: correct in*_addr parameter of net_addr_pton() 2017-02-03 15:59:13 +02:00
echo_server net: echo_server: Enable TCP for frdm_k64f 2017-02-03 15:59:14 +02:00
ieee802154 net: Remove unused CONFIG_NET_IPV6_NO_DAD option 2017-01-27 12:35:54 +02:00
irc_bot samples: net: irc_bot: add DHCPv4 support 2017-02-03 15:59:17 +02:00
leds_demo net: samples: Use lighter printk() instead of printf() 2017-01-27 12:35:51 +02:00
mbedtls_dtlsclient net: correct in*_addr parameter of net_addr_pton() 2017-02-03 15:59:13 +02:00
mbedtls_dtlsserver net: correct in*_addr parameter of net_addr_pton() 2017-02-03 15:59:13 +02:00
mbedtls_sslclient license: Replace Apache boilerplate with SPDX tag 2017-01-19 03:50:58 +00:00
mqtt_publisher net/mqtt: Add the MQTT Publisher sample application 2017-02-03 15:59:18 +02:00
telnet samples/net: Add a simple telnet sample 2017-02-03 15:59:14 +02:00
wpan_serial net/ieee802154: Modify radio TX function signature 2017-01-27 12:35:53 +02:00
wpanusb net/ieee802154: Modify radio TX function signature 2017-01-27 12:35:53 +02:00
zoap_client doc: fix .rst headings in new sample docs 2017-01-30 14:54:22 -08:00
zoap_server samples/zoap_server: Fix errors for GET requests without payloads 2017-02-03 15:59:19 +02:00
zperf samples: zperf: Enable TCP for zperf configuration 2017-02-03 15:59:17 +02:00
net.rst doc: update networking with Qemu section 2017-02-03 15:59:19 +02:00
README

Description of various IP stack test applications
=================================================

echo_server
-----------

The echo server test implements a network server that listens
UDP sockets. If that socket receives data, the server reverses
the data and sends it back.

The echo client can be running in the host system in which
case you need to use SLIP to connect to qemu. This usage scenario
is described in net-tools project README file [1]. This is the default
if you type "make run" in echo_server test application directory.
The network IP stack hooks right under IP stack (network level)
and sends the IP packet to host using SLIP. The layer 2 is the
SLIP layer in this case, no radio layer is simulated or used.

The echo server qemu instance can also be running against echo
client that is running in another qemu. For this you need two
terminal windows. In terminal 1 go to echo_server directory
and type "make server". This will start the echo server and setup
qemu pipes in suitable way and it will also start monitor application
that will store the transferred network traffic into pcap file
for later analysis. Then in terminal 2 go to echo_client directory and
type "make client". This will start the echo client that will
start to send data to the server and verify that it has received
the data back correctly. In the two qemu case we are simulating
the whole radio network meaning that the saved pcap file will
contain 802.15.4 network packets.


echo_client
-----------

The echo client test implements a network client that will
send UDP data to the echo server. The client verifies that
it has received data to the sent message and that the data
is correct.

The echo server can be running in the host system in which case
you need to use SLIP to connect to qemu. This usage scenario
is described in net-tools project README file [1]. This is the default
if you type "make run" in echo_client test application directory.
The network IP stack hooks right under IP stack (network level)
and sends the IP packet to host using SLIP. The layer 2 is the
SLIP layer in this case, no radio layer is simulated or used.

The echo client qemu instance can also be running against echo
server that is running in another qemu. This test scenario is
described in echo_server chapter above.


zoap_server
-----------

The Zoap server application implements a trivial CoAP server
which exposes a single resource "a/light", that only provides the
GET method.

It can be run similar to the echo_server sample: using two terminals,
(1) for zoap_server, run 'make server' in its directory, (2) for
zoap_client, run 'make client' in the zoap_client test directory.


zoap_client
-----------

The Zoap client application does a single request against a 'a/light'
resource, which has the first response lost (so retransmissions are
basically verified).

Please refer to the section above about how to run these applications
together.

wpanusb
-------

The wpanusb application exports IEEE 802.15.4 radio over USB to be used in
other Operating Systems like Linux. In this scenario Linux SoftMAC driver
must be used implementing IEEE 802.15.4 stack inside Linux.

wpan_serial
-----------

The wpan_serial application implements IEEE 802.15.4 "serial-radio" protocol.
This is the protocol used in Contiki-based native border routers.

[1] https://gerrit.zephyrproject.org/r/gitweb?p=net-tools.git;a=summary