mbed-os/TEST_APPS/testcases/netsocket/README.md

##Netsocket tests

This folder contains netsocket tests for Icetea The tests located in this folder are dependent of the application socket_app

The test cases in this folder are similar to Network Socket test plan.

Icetea test cases are processed by passing commands through the mbed-client-cli command line. It is possible to manually replicate most test cases by following the instructions below.

In test cases with more than one device under test (DUT) the target device is given in the instructions as DUT1, DUT2 or DUT3.

Test cases

SOCKET_BIND_PORT

Description:

Open and bind port.

Preconditions:

1. Network interface and stack are initialized.
2. Network connection is up.

Test steps:

1. Create a object by calling socket new TCPSocket on device
2. Call socket TCPSocket open
3. Call socket TCPSocket bind port <any non-used port number>
4. Destroy socket socket TCPSocket delete
5. Create a object by calling socket new UDPSocket on device
6. Call socket UDPSocket open
7. Call socket UDPSocket bind port <any non-used port number>
8. Destroy socket socket UDPSocket delete

Expected result:

The test exits with status PASS without timeouts.

TCPSERVER_ACCEPT

Description:

Test that TCPServer::bind(), TCPServer::listen() and TCPServer::accept() works.

Requires 2 devices.

Preconditions:

1. Network interface and stack are initialized.
2. Network connection is up.

Test steps:

1. DUT1: socket new TCPServer Command returns server base socket ID
2. DUT1: socket <base socket ID> open)
3. DUT1: socket <base socket ID> bind port <port>)
4. DUT1: socket <base socket ID> listen)
5. DUT1: Create a new TCPSocket socket new TCPSocket Command returns server socket ID
6. DUT1: socket <server socket ID> open
7. DUT2: Create a new TCPSocket socket new TCPSocket Command returns client socket ID
8. DUT2: socket <client socket ID> open
9. DUT2: socket <client socket ID> connect <dut1 IP> <port>
10. DUT1: socket <base socket id> accept <server socket id> Command should return new socket ID
11. DUT1: socket <new socket ID> send hello
12. DUT2: socket <client socket ID> recv 5
13. DUT2: Verify that it received "hello"
14. Destroy all sockets.

Expected result:

On DUT1 accept() call blocks until connection is received. Duration of call verified to be within threshold.

The test exits with status PASS without timeouts.

TCPSOCKET_ECHOTEST_BURST_SHORT

Description:

Send burst of packets to echo server and read incoming packets back.

Preconditions:

1. Network interface and stack are initialized.
2. Network connection is up.
3. TCPSocket is open.

Test steps:

1. Call socket <socket ID> open
2. Call socket <socket ID> connect echo.mbedcloudtesting.com 7
   1. Create 5 randomized strings (100, 200, 300, 120 and 500 characters)
   2. Send each string socket <socket ID> send <string>
   3. Receive total size of sent data socket <socket ID> recv <total size>
   4. Verify that received data is identical to sent data
3. Repeat 2 times
4. Destroy the socket

Expected result:

All send() calls should return the packet size.

The received data matches the sent data.

The test exits with status PASS without timeouts.