Nucleo446_SSD1331 - Color Oled(SSD1331) connect to STMicroelectronics…

Users » kadonotakashi » Code » Nucleo446_SSD1331

takashi kadono / Mbed OS Nucleo446_SSD1331

Color Oled(SSD1331) connect to STMicroelectronics Nucleo-F466

mbed-os/TESTS/netsocket/README.md@0:8fdf9a60065b, 2018-10-10 (annotated)

Committer:: kadonotakashi
Date:: Wed Oct 10 00:33:53 2018 +0000
Revision:: 0:8fdf9a60065b

how to make mbed librry

Who changed what in which revision?

User	Revision	Line number	New contents of line
kadonotakashi	0:8fdf9a60065b	1	Network Socket test plan
kadonotakashi	0:8fdf9a60065b	2	========================
kadonotakashi	0:8fdf9a60065b	3
kadonotakashi	0:8fdf9a60065b	4	This is a test plan for the Mbed OS Socket API. This describes all test
kadonotakashi	0:8fdf9a60065b	5	cases and their intended behaviors. When an API document is not clear, use
kadonotakashi	0:8fdf9a60065b	6	this as a reference for implementing correct behavior.
kadonotakashi	0:8fdf9a60065b	7
kadonotakashi	0:8fdf9a60065b	8	NOTE: Because testing is a moving target, this test plan might define more test cases than Mbed OS
kadonotakashi	0:8fdf9a60065b	9	implements. Refer to [test case priorities](#test-case-priorities) for a list of test cases that the target must pass to be compliant with the Mbed OS socket API.
kadonotakashi	0:8fdf9a60065b	10
kadonotakashi	0:8fdf9a60065b	11
kadonotakashi	0:8fdf9a60065b	12	Target API
kadonotakashi	0:8fdf9a60065b	13	----------
kadonotakashi	0:8fdf9a60065b	14
kadonotakashi	0:8fdf9a60065b	15	The target for this plan is to test:
kadonotakashi	0:8fdf9a60065b	16
kadonotakashi	0:8fdf9a60065b	17	- [Socket](https://github.com/ARMmbed/mbed-os/blob/master/features/netsocket/Socket.h).
kadonotakashi	0:8fdf9a60065b	18	- [UDPSocket](https://github.com/ARMmbed/mbed-os/blob/master/features/netsocket/UDPSocket.h).
kadonotakashi	0:8fdf9a60065b	19	- [TCPSocket](https://github.com/ARMmbed/mbed-os/blob/master/features/netsocket/TCPSocket.h).
kadonotakashi	0:8fdf9a60065b	20	- [TCPServer](https://github.com/ARMmbed/mbed-os/blob/master/features/netsocket/TCPServer.h).
kadonotakashi	0:8fdf9a60065b	21
kadonotakashi	0:8fdf9a60065b	22	Reference documentation: https://os.mbed.com/docs/latest/reference/network-socket.html
kadonotakashi	0:8fdf9a60065b	23
kadonotakashi	0:8fdf9a60065b	24	Tools to use
kadonotakashi	0:8fdf9a60065b	25	----------------
kadonotakashi	0:8fdf9a60065b	26
kadonotakashi	0:8fdf9a60065b	27	- Mbed OS.
kadonotakashi	0:8fdf9a60065b	28	- Standard Mbed OS development tools as described in https://os.mbed.com/docs/latest/tools/index.html.
kadonotakashi	0:8fdf9a60065b	29	- Test server.
kadonotakashi	0:8fdf9a60065b	30
kadonotakashi	0:8fdf9a60065b	31	These test cases themselves do not require any special tooling, other than
kadonotakashi	0:8fdf9a60065b	32	the test server described in "Test environment" chapter.
kadonotakashi	0:8fdf9a60065b	33
kadonotakashi	0:8fdf9a60065b	34	Test environment
kadonotakashi	0:8fdf9a60065b	35	----------------
kadonotakashi	0:8fdf9a60065b	36
kadonotakashi	0:8fdf9a60065b	37	As a general guideline, network connectivity with public Internet access
kadonotakashi	0:8fdf9a60065b	38	is required. This satisfies Socket tests, but specific connectivity
kadonotakashi	0:8fdf9a60065b	39	methods might require some extra configuration or devices within the
kadonotakashi	0:8fdf9a60065b	40	network.
kadonotakashi	0:8fdf9a60065b	41
kadonotakashi	0:8fdf9a60065b	42	The test environment consist of DUTs, network connection and the test
kadonotakashi	0:8fdf9a60065b	43	server. Arm provides a public test server, but it can be installed locally
kadonotakashi	0:8fdf9a60065b	44	as well, if an isolated test environment is required.
kadonotakashi	0:8fdf9a60065b	45
kadonotakashi	0:8fdf9a60065b	46	### Public test server
kadonotakashi	0:8fdf9a60065b	47
kadonotakashi	0:8fdf9a60065b	48	Address: `echo.mbedcloudtesting.com`
kadonotakashi	0:8fdf9a60065b	49
kadonotakashi	0:8fdf9a60065b	50	Both IPv4 and IPv6 addresses are available from a public DNS service:
kadonotakashi	0:8fdf9a60065b	51
kadonotakashi	0:8fdf9a60065b	52	```.sh
kadonotakashi	0:8fdf9a60065b	53	$ host echo.mbedcloudtesting.com
kadonotakashi	0:8fdf9a60065b	54	echo.mbedcloudtesting.com has address 52.215.34.155
kadonotakashi	0:8fdf9a60065b	55	echo.mbedcloudtesting.com has IPv6 address 2a05:d018:21f:3800:8584:60f8:bc9f:e614
kadonotakashi	0:8fdf9a60065b	56	```
kadonotakashi	0:8fdf9a60065b	57
kadonotakashi	0:8fdf9a60065b	58	Open services in the test server
kadonotakashi	0:8fdf9a60065b	59
kadonotakashi	0:8fdf9a60065b	60	- Echo protocol, [RFC 862](https://tools.ietf.org/html/rfc862) is
kadonotakashi	0:8fdf9a60065b	61	enabled in both TCP and UDP. Port 7.
kadonotakashi	0:8fdf9a60065b	62	- Discard protocol, [RFC 863](https://tools.ietf.org/html/rfc863) is
kadonotakashi	0:8fdf9a60065b	63	enabled in both TCP and UDP. Port 9.
kadonotakashi	0:8fdf9a60065b	64	- Character generator protocol, [RFC 864](https://tools.ietf.org/html/rfc864) is
kadonotakashi	0:8fdf9a60065b	65	enabled in both TCP and UDP. Port 19. Output pattern should follow
kadonotakashi	0:8fdf9a60065b	66	the proposed example pattern in RFC.
kadonotakashi	0:8fdf9a60065b	67	- Daytime protocol, [RFC 867](https://tools.ietf.org/html/rfc867) in
kadonotakashi	0:8fdf9a60065b	68	both TCP and UDP. Port 13.
kadonotakashi	0:8fdf9a60065b	69	- Time protocol, [RFC 868](https://tools.ietf.org/html/rfc868) in
kadonotakashi	0:8fdf9a60065b	70	both TCP and UDP. Port 37.
kadonotakashi	0:8fdf9a60065b	71
kadonotakashi	0:8fdf9a60065b	72	Configure the firewall to allow this traffic to access the test server.
kadonotakashi	0:8fdf9a60065b	73
kadonotakashi	0:8fdf9a60065b	74	Example configuration for Debian/Ubuntu Linux
kadonotakashi	0:8fdf9a60065b	75
kadonotakashi	0:8fdf9a60065b	76	These services are available on many operating systems, and installing them is out of
kadonotakashi	0:8fdf9a60065b	77	scope of this document. Below is an
kadonotakashi	0:8fdf9a60065b	78	example of how to install these services into a Debian/Ubuntu based Linux distribution
kadonotakashi	0:8fdf9a60065b	79	using standard Inet Daemon:
kadonotakashi	0:8fdf9a60065b	80
kadonotakashi	0:8fdf9a60065b	81	```.sh
kadonotakashi	0:8fdf9a60065b	82	$ sudo apt install inetutils-inetd
kadonotakashi	0:8fdf9a60065b	83	$ nano /etc/inetd.conf
kadonotakashi	0:8fdf9a60065b	84	```
kadonotakashi	0:8fdf9a60065b	85
kadonotakashi	0:8fdf9a60065b	86	Enable following services from /etc/inetd.conf:
kadonotakashi	0:8fdf9a60065b	87
kadonotakashi	0:8fdf9a60065b	88	```
kadonotakashi	0:8fdf9a60065b	89	#:INTERNAL: Internal services
kadonotakashi	0:8fdf9a60065b	90	discard stream tcp6 nowait root internal
kadonotakashi	0:8fdf9a60065b	91	discard dgram udp6 wait root internal
kadonotakashi	0:8fdf9a60065b	92	echo stream tcp6 nowait root internal
kadonotakashi	0:8fdf9a60065b	93	echo dgram udp6 wait root internal
kadonotakashi	0:8fdf9a60065b	94	chargen stream tcp6 nowait root internal
kadonotakashi	0:8fdf9a60065b	95	chargen dgram udp6 wait root internal
kadonotakashi	0:8fdf9a60065b	96	daytime stream tcp6 nowait root internal
kadonotakashi	0:8fdf9a60065b	97	time stream tcp6 nowait root internal
kadonotakashi	0:8fdf9a60065b	98	```
kadonotakashi	0:8fdf9a60065b	99
kadonotakashi	0:8fdf9a60065b	100	Testing the connectivity
kadonotakashi	0:8fdf9a60065b	101
kadonotakashi	0:8fdf9a60065b	102	You can connect to the test server with an NMAP tool like this:
kadonotakashi	0:8fdf9a60065b	103
kadonotakashi	0:8fdf9a60065b	104	```.sh
kadonotakashi	0:8fdf9a60065b	105	$ nmap -sT -p7,9,13,37 echo.mbedcloudtesting.com
kadonotakashi	0:8fdf9a60065b	106
kadonotakashi	0:8fdf9a60065b	107	Starting Nmap 7.12 ( https://nmap.org ) at 2018-04-05 16:17 EEST
kadonotakashi	0:8fdf9a60065b	108	Nmap scan report for echo.mbedcloudtesting.com (52.215.34.155)
kadonotakashi	0:8fdf9a60065b	109	Host is up (0.065s latency).
kadonotakashi	0:8fdf9a60065b	110	Other addresses for echo.mbedcloudtesting.com (not scanned): 2a05:d018:21f:3800:8584:60f8:bc9f:e614
kadonotakashi	0:8fdf9a60065b	111	rDNS record for 52.215.34.155: ec2-52-215-34-155.eu-west-1.compute.amazonaws.com
kadonotakashi	0:8fdf9a60065b	112	PORT STATE SERVICE
kadonotakashi	0:8fdf9a60065b	113	7/tcp open echo
kadonotakashi	0:8fdf9a60065b	114	9/tcp open discard
kadonotakashi	0:8fdf9a60065b	115	13/tcp open daytime
kadonotakashi	0:8fdf9a60065b	116	37/tcp open time
kadonotakashi	0:8fdf9a60065b	117
kadonotakashi	0:8fdf9a60065b	118	Nmap done: 1 IP address (1 host up) scanned in 0.17 seconds
kadonotakashi	0:8fdf9a60065b	119
kadonotakashi	0:8fdf9a60065b	120	$ sudo nmap -sT -p7,9,13,37 echo.mbedcloudtesting.com
kadonotakashi	0:8fdf9a60065b	121
kadonotakashi	0:8fdf9a60065b	122	Starting Nmap 7.12 ( https://nmap.org ) at 2018-04-05 16:16 EEST
kadonotakashi	0:8fdf9a60065b	123	Nmap scan report for echo.mbedcloudtesting.com (52.215.34.155)
kadonotakashi	0:8fdf9a60065b	124	Host is up (0.068s latency).
kadonotakashi	0:8fdf9a60065b	125	Other addresses for echo.mbedcloudtesting.com (not scanned): 2a05:d018:21f:3800:8584:60f8:bc9f:e614
kadonotakashi	0:8fdf9a60065b	126	rDNS record for 52.215.34.155: ec2-52-215-34-155.eu-west-1.compute.amazonaws.com
kadonotakashi	0:8fdf9a60065b	127	PORT STATE SERVICE
kadonotakashi	0:8fdf9a60065b	128	7/tcp open echo
kadonotakashi	0:8fdf9a60065b	129	9/tcp open discard
kadonotakashi	0:8fdf9a60065b	130	13/tcp open daytime
kadonotakashi	0:8fdf9a60065b	131	37/tcp open time
kadonotakashi	0:8fdf9a60065b	132
kadonotakashi	0:8fdf9a60065b	133	Nmap done: 1 IP address (1 host up) scanned in 0.20 seconds
kadonotakashi	0:8fdf9a60065b	134	```
kadonotakashi	0:8fdf9a60065b	135
kadonotakashi	0:8fdf9a60065b	136	### Ethernet test environment
kadonotakashi	0:8fdf9a60065b	137
kadonotakashi	0:8fdf9a60065b	138	![Ethernet](eth_environment.png)
kadonotakashi	0:8fdf9a60065b	139
kadonotakashi	0:8fdf9a60065b	140	The Ethernet test environment consists of devices, an ethernet switch and an optional
kadonotakashi	0:8fdf9a60065b	141	firewall that allows connecting to the Echo server.
kadonotakashi	0:8fdf9a60065b	142
kadonotakashi	0:8fdf9a60065b	143	### Wi-Fi test environment
kadonotakashi	0:8fdf9a60065b	144
kadonotakashi	0:8fdf9a60065b	145	![Wi-Fi](wifi_environment.png)
kadonotakashi	0:8fdf9a60065b	146
kadonotakashi	0:8fdf9a60065b	147	The Wi-Fi test environment is equivalent to the Ethernet test environment, except that the
kadonotakashi	0:8fdf9a60065b	148	Wi-Fi test environment has two separate access points or one with dual SSID. Connectivity to
kadonotakashi	0:8fdf9a60065b	149	echo server is required, but it can be hosted locally, as specified in
kadonotakashi	0:8fdf9a60065b	150	the Ethernet environment.
kadonotakashi	0:8fdf9a60065b	151
kadonotakashi	0:8fdf9a60065b	152	Test case priorities
kadonotakashi	0:8fdf9a60065b	153	--------------------
kadonotakashi	0:8fdf9a60065b	154
kadonotakashi	0:8fdf9a60065b	155	Please refer to the following table for priorities of test cases. Priorities
kadonotakashi	0:8fdf9a60065b	156	are labeled as MUST and SHOULD. MUST means this is a requirement and
kadonotakashi	0:8fdf9a60065b	157	therefore mandatory to pass the test. SHOULD means it is recommended to
kadonotakashi	0:8fdf9a60065b	158	pass the test if the driver implements the feature in question.
kadonotakashi	0:8fdf9a60065b	159
kadonotakashi	0:8fdf9a60065b	160	\| \| Test case \| Priority \|
kadonotakashi	0:8fdf9a60065b	161	\|-----\|-----------------------------------------\|----------\|
kadonotakashi	0:8fdf9a60065b	162	\| 1 \| UDPSOCKET_OPEN_DESTRUCT \| MUST \|
kadonotakashi	0:8fdf9a60065b	163	\| 2 \| UDPSOCKET_OPEN_LIMIT \| MUST \|
kadonotakashi	0:8fdf9a60065b	164	\| 3 \| UDPSOCKET_OPEN_TWICE \| MUST \|
kadonotakashi	0:8fdf9a60065b	165	\| 4 \| UDPSOCKET_OPEN_CLOSE_REPEAT \| MUST \|
kadonotakashi	0:8fdf9a60065b	166	\| 5 \| UDPSOCKET_BIND_PORT \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	167	\| 6 \| UDPSOCKET_BIND_PORT_FAIL \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	168	\| 7 \| UDPSOCKET_BIND_ADDRESS_PORT \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	169	\| 8 \| UDPSOCKET_BIND_ADDRESS_NULL \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	170	\| 9 \| UDPSOCKET_BIND_ADDRESS_INVALID \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	171	\| 10 \| UDPSOCKET_BIND_WRONG_TYPE \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	172	\| 11 \| UDPSOCKET_BIND_ADDRESS \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	173	\| 12 \| UDPSOCKET_BIND_UNOPENED \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	174	\| 13 \| UDPSOCKET_SENDTO_INVALID \| MUST \|
kadonotakashi	0:8fdf9a60065b	175	\| 14 \| UDPSOCKET_SENDTO_REPEAT \| MUST \|
kadonotakashi	0:8fdf9a60065b	176	\| 15 \| UDPSOCKET_BIND_SENDTO \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	177	\| 16 \| UDPSOCKET_ECHOTEST \| MUST \|
kadonotakashi	0:8fdf9a60065b	178	\| 17 \| UDPSOCKET_ECHOTEST_NONBLOCK \| MUST \|
kadonotakashi	0:8fdf9a60065b	179	\| 18 \| UDPSOCKET_RECV_TIMEOUT \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	180	\| 19 \| UDPSOCKET_SENDTO_TIMEOUT \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	181	\| 20 \| TCPSOCKET_OPEN_DESTRUCT \| MUST \|
kadonotakashi	0:8fdf9a60065b	182	\| 21 \| TCPSOCKET_OPEN_LIMIT \| MUST \|
kadonotakashi	0:8fdf9a60065b	183	\| 22 \| TCPSOCKET_OPEN_TWICE \| MUST \|
kadonotakashi	0:8fdf9a60065b	184	\| 23 \| TCPSOCKET_OPEN_CLOSE_REPEAT \| MUST \|
kadonotakashi	0:8fdf9a60065b	185	\| 24 \| TCPSOCKET_BIND_PORT \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	186	\| 25 \| TCPSOCKET_BIND_PORT_FAIL \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	187	\| 26 \| TCPSOCKET_BIND_ADDRESS_PORT \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	188	\| 27 \| TCPSOCKET_BIND_ADDRESS_NULL \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	189	\| 28 \| TCPSOCKET_BIND_ADDRESS_INVALID \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	190	\| 29 \| TCPSOCKET_BIND_WRONG_TYPE \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	191	\| 30 \| TCPSOCKET_BIND_ADDRESS \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	192	\| 31 \| TCPSOCKET_BIND_UNOPENED \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	193	\| 32 \| TCPSOCKET_CONNECT_INVALID \| MUST \|
kadonotakashi	0:8fdf9a60065b	194	\| 33 \| TCPSOCKET_SEND_REPEAT \| MUST \|
kadonotakashi	0:8fdf9a60065b	195	\| 34 \| TCPSOCKET_ECHOTEST \| MUST \|
kadonotakashi	0:8fdf9a60065b	196	\| 35 \| TCPSOCKET_ECHOTEST_NONBLOCK \| MUST \|
kadonotakashi	0:8fdf9a60065b	197	\| 36 \| TCPSOCKET_RECV_TIMEOUT \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	198	\| 37 \| TCPSOCKET_SEND_TIMEOUT \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	199	\| 38 \| TCPSOCKET_ENDPOINT_CLOSE \| MUST \|
kadonotakashi	0:8fdf9a60065b	200	\| 39 \| TCPSERVER_ACCEPT \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	201	\| 40 \| TCPSERVER_LISTEN \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	202	\| 41 \| TCPSERVER_LISTEN_WITHOUT_BIND \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	203	\| 42 \| TCPSERVER_ACCEPT_WITHOUT_LISTEN \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	204	\| 43 \| UDPSOCKET_ECHOTEST_BURST \| MUST \|
kadonotakashi	0:8fdf9a60065b	205	\| 44 \| UDPSOCKET_ECHOTEST_BURST_NONBLOCK \| MUST \|
kadonotakashi	0:8fdf9a60065b	206	\| 45 \| TCPSOCKET_ECHOTEST_BURST \| MUST \|
kadonotakashi	0:8fdf9a60065b	207	\| 46 \| TCPSOCKET_ECHOTEST_BURST_NONBLOCK \| MUST \|
kadonotakashi	0:8fdf9a60065b	208	\| 47 \| TCPSOCKET_RECV_100K \| MUST \|
kadonotakashi	0:8fdf9a60065b	209	\| 48 \| TCPSOCKET_RECV_100K_NONBLOCK \| MUST \|
kadonotakashi	0:8fdf9a60065b	210	\| 49 \| TCPSOCKET_THREAD_PER_SOCKET_SAFETY \| MUST \|
kadonotakashi	0:8fdf9a60065b	211	\| 50 \| TCPSOCKET_SETSOCKOPT_KEEPALIVE_VALID \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	212	\| 51 \| TCPSOCKET_SETSOCKOPT_KEEPALIVE_INVALID \| SHOULD \|
kadonotakashi	0:8fdf9a60065b	213
kadonotakashi	0:8fdf9a60065b	214
kadonotakashi	0:8fdf9a60065b	215	Building test binaries
kadonotakashi	0:8fdf9a60065b	216	--------------------------
kadonotakashi	0:8fdf9a60065b	217
kadonotakashi	0:8fdf9a60065b	218	For testing the board and driver, test against the Mbed OS
kadonotakashi	0:8fdf9a60065b	219	master branch to get the most recent, up-to-date test cases and drivers.
kadonotakashi	0:8fdf9a60065b	220
kadonotakashi	0:8fdf9a60065b	221	To create a build environment:
kadonotakashi	0:8fdf9a60065b	222
kadonotakashi	0:8fdf9a60065b	223	```.sh
kadonotakashi	0:8fdf9a60065b	224	mbed new network_test
kadonotakashi	0:8fdf9a60065b	225	cd network_test
kadonotakashi	0:8fdf9a60065b	226	cd mbed-os
kadonotakashi	0:8fdf9a60065b	227	git checkout master
kadonotakashi	0:8fdf9a60065b	228	cd ..
kadonotakashi	0:8fdf9a60065b	229	```
kadonotakashi	0:8fdf9a60065b	230
kadonotakashi	0:8fdf9a60065b	231	Also, building socket test cases requires a special macro to
kadonotakashi	0:8fdf9a60065b	232	enable all tests, so create an `mbed_app.json` file with the following
kadonotakashi	0:8fdf9a60065b	233	content at minimum:
kadonotakashi	0:8fdf9a60065b	234
kadonotakashi	0:8fdf9a60065b	235	```
kadonotakashi	0:8fdf9a60065b	236	{
kadonotakashi	0:8fdf9a60065b	237	"config": {
kadonotakashi	0:8fdf9a60065b	238	"echo-server-addr" : {
kadonotakashi	0:8fdf9a60065b	239	"help" : "IP address of echo server",
kadonotakashi	0:8fdf9a60065b	240	"value" : "\"echo.mbedcloudtesting.com\""
kadonotakashi	0:8fdf9a60065b	241	},
kadonotakashi	0:8fdf9a60065b	242	"echo-server-port" : {
kadonotakashi	0:8fdf9a60065b	243	"help" : "Port of echo server",
kadonotakashi	0:8fdf9a60065b	244	"value" : "7"
kadonotakashi	0:8fdf9a60065b	245	}
kadonotakashi	0:8fdf9a60065b	246	},
kadonotakashi	0:8fdf9a60065b	247	"macros": ["MBED_EXTENDED_TESTS"]
kadonotakashi	0:8fdf9a60065b	248	}
kadonotakashi	0:8fdf9a60065b	249	```
kadonotakashi	0:8fdf9a60065b	250
kadonotakashi	0:8fdf9a60065b	251	Wi-Fi tests require some more configuration, so for Wi-Fi purposes,
kadonotakashi	0:8fdf9a60065b	252	the `mbed_app.json` might look like this:
kadonotakashi	0:8fdf9a60065b	253
kadonotakashi	0:8fdf9a60065b	254	```
kadonotakashi	0:8fdf9a60065b	255	{
kadonotakashi	0:8fdf9a60065b	256	"config": {
kadonotakashi	0:8fdf9a60065b	257	"wifi-secure-ssid": {
kadonotakashi	0:8fdf9a60065b	258	"help": "WiFi SSID for WPA2 secured network",
kadonotakashi	0:8fdf9a60065b	259	"value": "\"test-network\""
kadonotakashi	0:8fdf9a60065b	260	},
kadonotakashi	0:8fdf9a60065b	261	"wifi-unsecure-ssid": {
kadonotakashi	0:8fdf9a60065b	262	"help": "WiFi SSID for unsecure netwrok",
kadonotakashi	0:8fdf9a60065b	263	"value": "\"unsecure-test-net\""
kadonotakashi	0:8fdf9a60065b	264	},
kadonotakashi	0:8fdf9a60065b	265	"wifi-password": {
kadonotakashi	0:8fdf9a60065b	266	"help": "WiFi Password",
kadonotakashi	0:8fdf9a60065b	267	"value": "\"password\""
kadonotakashi	0:8fdf9a60065b	268	},
kadonotakashi	0:8fdf9a60065b	269	"wifi-secure-protocol": {
kadonotakashi	0:8fdf9a60065b	270	"help": "WiFi security protocol, valid values are WEP, WPA, WPA2, WPA_WPA2",
kadonotakashi	0:8fdf9a60065b	271	"value": "\"WPA2\""
kadonotakashi	0:8fdf9a60065b	272	},
kadonotakashi	0:8fdf9a60065b	273	"wifi-ch-secure": {
kadonotakashi	0:8fdf9a60065b	274	"help": "Channel number of secure SSID",
kadonotakashi	0:8fdf9a60065b	275	"value": 6
kadonotakashi	0:8fdf9a60065b	276	},
kadonotakashi	0:8fdf9a60065b	277	"wifi-ch-unsecure": {
kadonotakashi	0:8fdf9a60065b	278	"help": "Channel number of unsecure SSID",
kadonotakashi	0:8fdf9a60065b	279	"value": 6
kadonotakashi	0:8fdf9a60065b	280	},
kadonotakashi	0:8fdf9a60065b	281	"ap-mac-secure": {
kadonotakashi	0:8fdf9a60065b	282	"help": "BSSID of secure AP in form of AA:BB:CC:DD:EE:FF",
kadonotakashi	0:8fdf9a60065b	283	"value": "\"58:8b:f3:99:f2:9c\""
kadonotakashi	0:8fdf9a60065b	284	},
kadonotakashi	0:8fdf9a60065b	285	"ap-mac-unsecure": {
kadonotakashi	0:8fdf9a60065b	286	"help": "BSSID of unsecure AP in form of \"AA:BB:CC:DD:EE:FF\"",
kadonotakashi	0:8fdf9a60065b	287	"value": "\"58:8b:f3:99:c2:08\""
kadonotakashi	0:8fdf9a60065b	288	},
kadonotakashi	0:8fdf9a60065b	289	"max-scan-size": {
kadonotakashi	0:8fdf9a60065b	290	"help": "How many networks may appear in Wifi scan result",
kadonotakashi	0:8fdf9a60065b	291	"value": 30
kadonotakashi	0:8fdf9a60065b	292	},
kadonotakashi	0:8fdf9a60065b	293	"echo-server-addr" : {
kadonotakashi	0:8fdf9a60065b	294	"help" : "IP address of echo server",
kadonotakashi	0:8fdf9a60065b	295	"value" : "\"echo.mbedcloudtesting.com\""
kadonotakashi	0:8fdf9a60065b	296	},
kadonotakashi	0:8fdf9a60065b	297	"echo-server-port" : {
kadonotakashi	0:8fdf9a60065b	298	"help" : "Port of echo server",
kadonotakashi	0:8fdf9a60065b	299	"value" : "7"
kadonotakashi	0:8fdf9a60065b	300	}
kadonotakashi	0:8fdf9a60065b	301	},
kadonotakashi	0:8fdf9a60065b	302	"macros": ["MBED_EXTENDED_TESTS"],
kadonotakashi	0:8fdf9a60065b	303	"target_overrides": {
kadonotakashi	0:8fdf9a60065b	304	"*": {
kadonotakashi	0:8fdf9a60065b	305	"target.network-default-interface-type": "WIFI",
kadonotakashi	0:8fdf9a60065b	306	"nsapi.default-wifi-ssid": "\"WIFI_SSID\"",
kadonotakashi	0:8fdf9a60065b	307	"nsapi.default-wifi-password": "\"WIFI_PASSWORD\"",
kadonotakashi	0:8fdf9a60065b	308	"nsapi.default-wifi-security": "WPA_WPA2"
kadonotakashi	0:8fdf9a60065b	309	}
kadonotakashi	0:8fdf9a60065b	310	}
kadonotakashi	0:8fdf9a60065b	311	}
kadonotakashi	0:8fdf9a60065b	312	```
kadonotakashi	0:8fdf9a60065b	313	See `mbed-os/tools/test_configs` folder for examples.
kadonotakashi	0:8fdf9a60065b	314
kadonotakashi	0:8fdf9a60065b	315	Now build test binaries:
kadonotakashi	0:8fdf9a60065b	316
kadonotakashi	0:8fdf9a60065b	317	```.sh
kadonotakashi	0:8fdf9a60065b	318	mbed test --compile -t <toolchain> -m <target> -n mbed-os-tests-network-,mbed-os-tests-netsocket
kadonotakashi	0:8fdf9a60065b	319	```
kadonotakashi	0:8fdf9a60065b	320
kadonotakashi	0:8fdf9a60065b	321	Running tests
kadonotakashi	0:8fdf9a60065b	322	-------------
kadonotakashi	0:8fdf9a60065b	323
kadonotakashi	0:8fdf9a60065b	324	When device is connected to network, or in case of wireless device near
kadonotakashi	0:8fdf9a60065b	325	the access point.
kadonotakashi	0:8fdf9a60065b	326
kadonotakashi	0:8fdf9a60065b	327	```.sh
kadonotakashi	0:8fdf9a60065b	328	mbed test -n mbed-os-tests-network-,mbed-os-tests-netsocket
kadonotakashi	0:8fdf9a60065b	329	```
kadonotakashi	0:8fdf9a60065b	330
kadonotakashi	0:8fdf9a60065b	331	Test cases for Socket class
kadonotakashi	0:8fdf9a60065b	332	---------------------------
kadonotakashi	0:8fdf9a60065b	333
kadonotakashi	0:8fdf9a60065b	334	These test are equal for UDPSocket and TCPSocket but are described here
kadonotakashi	0:8fdf9a60065b	335	because of identical API and behaviour. Socket class is abstract so it
kadonotakashi	0:8fdf9a60065b	336	cannot be instantiated, therefore these test cases are implemented using
kadonotakashi	0:8fdf9a60065b	337	both TCPSocket and UDPSocket.
kadonotakashi	0:8fdf9a60065b	338
kadonotakashi	0:8fdf9a60065b	339	### SOCKET_OPEN_DESTRUCT
kadonotakashi	0:8fdf9a60065b	340
kadonotakashi	0:8fdf9a60065b	341	Description:
kadonotakashi	0:8fdf9a60065b	342
kadonotakashi	0:8fdf9a60065b	343	Call `Socket::open()` and then destruct the socket
kadonotakashi	0:8fdf9a60065b	344
kadonotakashi	0:8fdf9a60065b	345	Preconditions:
kadonotakashi	0:8fdf9a60065b	346
kadonotakashi	0:8fdf9a60065b	347	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	348	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	349
kadonotakashi	0:8fdf9a60065b	350	Test steps:
kadonotakashi	0:8fdf9a60065b	351
kadonotakashi	0:8fdf9a60065b	352	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	353	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	354	3. Call "delete" for the object
kadonotakashi	0:8fdf9a60065b	355	4. Repeat 1000 times.
kadonotakashi	0:8fdf9a60065b	356
kadonotakashi	0:8fdf9a60065b	357	Expected result:
kadonotakashi	0:8fdf9a60065b	358
kadonotakashi	0:8fdf9a60065b	359	`Socket::open()` should always return NSAPI_ERROR_OK
kadonotakashi	0:8fdf9a60065b	360
kadonotakashi	0:8fdf9a60065b	361
kadonotakashi	0:8fdf9a60065b	362
kadonotakashi	0:8fdf9a60065b	363	### SOCKET_OPEN_LIMIT
kadonotakashi	0:8fdf9a60065b	364
kadonotakashi	0:8fdf9a60065b	365	Description:
kadonotakashi	0:8fdf9a60065b	366
kadonotakashi	0:8fdf9a60065b	367	Call `Socket::open()` until it runs out of memory or other internal limit
kadonotakashi	0:8fdf9a60065b	368	in the stack is reached.
kadonotakashi	0:8fdf9a60065b	369
kadonotakashi	0:8fdf9a60065b	370	Preconditions:
kadonotakashi	0:8fdf9a60065b	371
kadonotakashi	0:8fdf9a60065b	372	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	373	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	374
kadonotakashi	0:8fdf9a60065b	375	Test steps:
kadonotakashi	0:8fdf9a60065b	376
kadonotakashi	0:8fdf9a60065b	377	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	378	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	379	3. repeat until `NSAPI_ERROR_NO_MEMORY` or `NSAPI_ERROR_NO_SOCKET`
kadonotakashi	0:8fdf9a60065b	380	error is returned.
kadonotakashi	0:8fdf9a60065b	381	4. Call "delete" for all previously allocated sockets.
kadonotakashi	0:8fdf9a60065b	382	5. repeat
kadonotakashi	0:8fdf9a60065b	383
kadonotakashi	0:8fdf9a60065b	384	Expected result:
kadonotakashi	0:8fdf9a60065b	385
kadonotakashi	0:8fdf9a60065b	386	Should be able to reserve at least 4 sockets. After freeing all sockets,
kadonotakashi	0:8fdf9a60065b	387	should be able to reserve same number of sockets.
kadonotakashi	0:8fdf9a60065b	388
kadonotakashi	0:8fdf9a60065b	389
kadonotakashi	0:8fdf9a60065b	390
kadonotakashi	0:8fdf9a60065b	391	### SOCKET_OPEN_TWICE
kadonotakashi	0:8fdf9a60065b	392
kadonotakashi	0:8fdf9a60065b	393	Description:
kadonotakashi	0:8fdf9a60065b	394
kadonotakashi	0:8fdf9a60065b	395	Call `Socket::open()` twice
kadonotakashi	0:8fdf9a60065b	396
kadonotakashi	0:8fdf9a60065b	397	Preconditions:
kadonotakashi	0:8fdf9a60065b	398
kadonotakashi	0:8fdf9a60065b	399	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	400	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	401
kadonotakashi	0:8fdf9a60065b	402	Test steps:
kadonotakashi	0:8fdf9a60065b	403
kadonotakashi	0:8fdf9a60065b	404	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	405	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	406	3. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	407	4. delete the socket
kadonotakashi	0:8fdf9a60065b	408
kadonotakashi	0:8fdf9a60065b	409	Expected result:
kadonotakashi	0:8fdf9a60065b	410
kadonotakashi	0:8fdf9a60065b	411	`Socket::open()` should first return `NSAPI_ERROR_OK` and second
kadonotakashi	0:8fdf9a60065b	412	call `NSAPI_ERROR_PARAMETER`.
kadonotakashi	0:8fdf9a60065b	413
kadonotakashi	0:8fdf9a60065b	414
kadonotakashi	0:8fdf9a60065b	415
kadonotakashi	0:8fdf9a60065b	416	### SOCKET_OPEN_CLOSE_REPEAT
kadonotakashi	0:8fdf9a60065b	417
kadonotakashi	0:8fdf9a60065b	418	Description:
kadonotakashi	0:8fdf9a60065b	419
kadonotakashi	0:8fdf9a60065b	420	Call `Socket::open()` followed by `Socket::close()` and then again
kadonotakashi	0:8fdf9a60065b	421	`Socket::open()`. Should allow you to reuse the same object.
kadonotakashi	0:8fdf9a60065b	422
kadonotakashi	0:8fdf9a60065b	423	Preconditions:
kadonotakashi	0:8fdf9a60065b	424
kadonotakashi	0:8fdf9a60065b	425	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	426	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	427
kadonotakashi	0:8fdf9a60065b	428	Test steps:
kadonotakashi	0:8fdf9a60065b	429
kadonotakashi	0:8fdf9a60065b	430	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	431	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	432	3. Call `Socket::close(stack)`
kadonotakashi	0:8fdf9a60065b	433	4. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	434	5. Call `Socket::close(stack)`
kadonotakashi	0:8fdf9a60065b	435	6. delete the socket
kadonotakashi	0:8fdf9a60065b	436
kadonotakashi	0:8fdf9a60065b	437	Expected result:
kadonotakashi	0:8fdf9a60065b	438
kadonotakashi	0:8fdf9a60065b	439	All `Socket::open()` and `Socket::close()` calls should return
kadonotakashi	0:8fdf9a60065b	440	NSAPI_ERROR_OK.
kadonotakashi	0:8fdf9a60065b	441
kadonotakashi	0:8fdf9a60065b	442
kadonotakashi	0:8fdf9a60065b	443	### SOCKET_BIND_PORT
kadonotakashi	0:8fdf9a60065b	444
kadonotakashi	0:8fdf9a60065b	445	Description:
kadonotakashi	0:8fdf9a60065b	446
kadonotakashi	0:8fdf9a60065b	447	Call `Socket::bind(port)`
kadonotakashi	0:8fdf9a60065b	448
kadonotakashi	0:8fdf9a60065b	449	Preconditions:
kadonotakashi	0:8fdf9a60065b	450
kadonotakashi	0:8fdf9a60065b	451	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	452	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	453
kadonotakashi	0:8fdf9a60065b	454	Test steps:
kadonotakashi	0:8fdf9a60065b	455
kadonotakashi	0:8fdf9a60065b	456	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	457	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	458	3. Call `Socket::bind(<any non-used port number>);`
kadonotakashi	0:8fdf9a60065b	459	4. destroy socket
kadonotakashi	0:8fdf9a60065b	460
kadonotakashi	0:8fdf9a60065b	461	Expected result:
kadonotakashi	0:8fdf9a60065b	462
kadonotakashi	0:8fdf9a60065b	463	All calls return NSAPI_ERROR_OK
kadonotakashi	0:8fdf9a60065b	464
kadonotakashi	0:8fdf9a60065b	465
kadonotakashi	0:8fdf9a60065b	466
kadonotakashi	0:8fdf9a60065b	467	### SOCKET_BIND_PORT_FAIL
kadonotakashi	0:8fdf9a60065b	468
kadonotakashi	0:8fdf9a60065b	469	Description:
kadonotakashi	0:8fdf9a60065b	470
kadonotakashi	0:8fdf9a60065b	471	Call `Socket::bind(port)` on port number that is already used
kadonotakashi	0:8fdf9a60065b	472
kadonotakashi	0:8fdf9a60065b	473	Preconditions:
kadonotakashi	0:8fdf9a60065b	474
kadonotakashi	0:8fdf9a60065b	475	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	476	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	477
kadonotakashi	0:8fdf9a60065b	478	Test steps:
kadonotakashi	0:8fdf9a60065b	479
kadonotakashi	0:8fdf9a60065b	480	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	481	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	482	3. Call `Socket::bind(<any non-used port number>);`
kadonotakashi	0:8fdf9a60065b	483	4. Repeat 1-3 for a new socket.
kadonotakashi	0:8fdf9a60065b	484	5. destroy both sockets
kadonotakashi	0:8fdf9a60065b	485
kadonotakashi	0:8fdf9a60065b	486	Expected result:
kadonotakashi	0:8fdf9a60065b	487
kadonotakashi	0:8fdf9a60065b	488	Second `Socket::bind()` should return NSAPI_ERROR_PARAMETER
kadonotakashi	0:8fdf9a60065b	489
kadonotakashi	0:8fdf9a60065b	490
kadonotakashi	0:8fdf9a60065b	491
kadonotakashi	0:8fdf9a60065b	492	### SOCKET_BIND_ADDRESS_PORT
kadonotakashi	0:8fdf9a60065b	493
kadonotakashi	0:8fdf9a60065b	494	Description:
kadonotakashi	0:8fdf9a60065b	495
kadonotakashi	0:8fdf9a60065b	496	Call `Socket::bind(addr, port)`
kadonotakashi	0:8fdf9a60065b	497
kadonotakashi	0:8fdf9a60065b	498	Preconditions:
kadonotakashi	0:8fdf9a60065b	499
kadonotakashi	0:8fdf9a60065b	500	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	501	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	502
kadonotakashi	0:8fdf9a60065b	503	Test steps:
kadonotakashi	0:8fdf9a60065b	504
kadonotakashi	0:8fdf9a60065b	505	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	506	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	507	3. Get address by calling NetworkInterface::get_ip_address();
kadonotakashi	0:8fdf9a60065b	508	4. Call `Socket::bind(address, <any non-used port number>);`
kadonotakashi	0:8fdf9a60065b	509	5. destroy socket
kadonotakashi	0:8fdf9a60065b	510
kadonotakashi	0:8fdf9a60065b	511	Expected result:
kadonotakashi	0:8fdf9a60065b	512
kadonotakashi	0:8fdf9a60065b	513	All calls return NSAPI_ERROR_OK
kadonotakashi	0:8fdf9a60065b	514
kadonotakashi	0:8fdf9a60065b	515
kadonotakashi	0:8fdf9a60065b	516
kadonotakashi	0:8fdf9a60065b	517	### SOCKET_BIND_ADDRESS_NULL
kadonotakashi	0:8fdf9a60065b	518
kadonotakashi	0:8fdf9a60065b	519	Description:
kadonotakashi	0:8fdf9a60065b	520
kadonotakashi	0:8fdf9a60065b	521	Call `Socket::bind(NULL, port)`
kadonotakashi	0:8fdf9a60065b	522
kadonotakashi	0:8fdf9a60065b	523	Preconditions:
kadonotakashi	0:8fdf9a60065b	524
kadonotakashi	0:8fdf9a60065b	525	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	526	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	527
kadonotakashi	0:8fdf9a60065b	528	Test steps:
kadonotakashi	0:8fdf9a60065b	529
kadonotakashi	0:8fdf9a60065b	530	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	531	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	532	3. Call `Socket::bind(NULL, <any non-used port number>);`
kadonotakashi	0:8fdf9a60065b	533	4. destroy socket
kadonotakashi	0:8fdf9a60065b	534
kadonotakashi	0:8fdf9a60065b	535	Expected result:
kadonotakashi	0:8fdf9a60065b	536
kadonotakashi	0:8fdf9a60065b	537	`Socket::bind()` should return NSAPI_ERROR_OK
kadonotakashi	0:8fdf9a60065b	538
kadonotakashi	0:8fdf9a60065b	539
kadonotakashi	0:8fdf9a60065b	540
kadonotakashi	0:8fdf9a60065b	541	### SOCKET_BIND_ADDRESS_INVALID
kadonotakashi	0:8fdf9a60065b	542
kadonotakashi	0:8fdf9a60065b	543	Description:
kadonotakashi	0:8fdf9a60065b	544
kadonotakashi	0:8fdf9a60065b	545	Call `Socket::bind(address, port)` with and address that is not assigned
kadonotakashi	0:8fdf9a60065b	546	to us.
kadonotakashi	0:8fdf9a60065b	547
kadonotakashi	0:8fdf9a60065b	548	Preconditions:
kadonotakashi	0:8fdf9a60065b	549
kadonotakashi	0:8fdf9a60065b	550	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	551	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	552
kadonotakashi	0:8fdf9a60065b	553	Test steps:
kadonotakashi	0:8fdf9a60065b	554
kadonotakashi	0:8fdf9a60065b	555	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	556	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	557	3. Check whether device is IPv4 or IPv6 connected.
kadonotakashi	0:8fdf9a60065b	558	1. For IPv4: Call `Socket::bind("190.2.3.4", <any non-used port number>);`
kadonotakashi	0:8fdf9a60065b	559	2. For IPv6: Call `Socket::bind("fe80::ff01", <any non-used port number>);`
kadonotakashi	0:8fdf9a60065b	560
kadonotakashi	0:8fdf9a60065b	561	4. destroy socket
kadonotakashi	0:8fdf9a60065b	562
kadonotakashi	0:8fdf9a60065b	563	Expected result:
kadonotakashi	0:8fdf9a60065b	564
kadonotakashi	0:8fdf9a60065b	565	`Socket::bind()` should return NSAPI_ERROR_PARAMETER
kadonotakashi	0:8fdf9a60065b	566
kadonotakashi	0:8fdf9a60065b	567
kadonotakashi	0:8fdf9a60065b	568
kadonotakashi	0:8fdf9a60065b	569	### SOCKET_BIND_ADDRESS_WRONG_TYPE
kadonotakashi	0:8fdf9a60065b	570
kadonotakashi	0:8fdf9a60065b	571	Description:
kadonotakashi	0:8fdf9a60065b	572
kadonotakashi	0:8fdf9a60065b	573	Call `Socket::bind(SocketAddress)` with and address that is not wrong type
kadonotakashi	0:8fdf9a60065b	574	for the connection.
kadonotakashi	0:8fdf9a60065b	575
kadonotakashi	0:8fdf9a60065b	576	Preconditions:
kadonotakashi	0:8fdf9a60065b	577
kadonotakashi	0:8fdf9a60065b	578	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	579	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	580
kadonotakashi	0:8fdf9a60065b	581	Test steps:
kadonotakashi	0:8fdf9a60065b	582
kadonotakashi	0:8fdf9a60065b	583	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	584	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	585	3. Check whether device is IPv4 or IPv6 connected.
kadonotakashi	0:8fdf9a60065b	586	1. For IPv4: Create `SocketAddress("fe80::ff01", <any non-used port number>);`
kadonotakashi	0:8fdf9a60065b	587	2. For IPv6: Create `SocketAddress("190.2.3.4", <any non-used port number>);`
kadonotakashi	0:8fdf9a60065b	588
kadonotakashi	0:8fdf9a60065b	589	4. Call `Socket::bind(address);`
kadonotakashi	0:8fdf9a60065b	590	5. destroy socket
kadonotakashi	0:8fdf9a60065b	591
kadonotakashi	0:8fdf9a60065b	592	Expected result:
kadonotakashi	0:8fdf9a60065b	593
kadonotakashi	0:8fdf9a60065b	594	`Socket::bind()` should return NSAPI_ERROR_PARAMETER
kadonotakashi	0:8fdf9a60065b	595
kadonotakashi	0:8fdf9a60065b	596
kadonotakashi	0:8fdf9a60065b	597
kadonotakashi	0:8fdf9a60065b	598	### SOCKET_BIND_ADDRESS
kadonotakashi	0:8fdf9a60065b	599
kadonotakashi	0:8fdf9a60065b	600	Description:
kadonotakashi	0:8fdf9a60065b	601
kadonotakashi	0:8fdf9a60065b	602	Call `Socket::bind(SocketAddress)`
kadonotakashi	0:8fdf9a60065b	603
kadonotakashi	0:8fdf9a60065b	604	Preconditions:
kadonotakashi	0:8fdf9a60065b	605
kadonotakashi	0:8fdf9a60065b	606	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	607	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	608
kadonotakashi	0:8fdf9a60065b	609	Test steps:
kadonotakashi	0:8fdf9a60065b	610
kadonotakashi	0:8fdf9a60065b	611	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	612	2. Call `Socket::open(stack)`
kadonotakashi	0:8fdf9a60065b	613	3. Get address by calling NetworkInterface::get_ip_address();
kadonotakashi	0:8fdf9a60065b	614	4. Create a SocketAddress object using this address and any non-used
kadonotakashi	0:8fdf9a60065b	615	port number.
kadonotakashi	0:8fdf9a60065b	616	5. Call `Socket::bind(address);`
kadonotakashi	0:8fdf9a60065b	617	6. destroy socket
kadonotakashi	0:8fdf9a60065b	618
kadonotakashi	0:8fdf9a60065b	619	Expected result:
kadonotakashi	0:8fdf9a60065b	620
kadonotakashi	0:8fdf9a60065b	621	All calls return NSAPI_ERROR_OK
kadonotakashi	0:8fdf9a60065b	622
kadonotakashi	0:8fdf9a60065b	623
kadonotakashi	0:8fdf9a60065b	624
kadonotakashi	0:8fdf9a60065b	625	### SOCKET_BIND_UNOPENED
kadonotakashi	0:8fdf9a60065b	626
kadonotakashi	0:8fdf9a60065b	627	Description:
kadonotakashi	0:8fdf9a60065b	628
kadonotakashi	0:8fdf9a60065b	629	Call `Socket::bind()` on socket that has not been opened
kadonotakashi	0:8fdf9a60065b	630
kadonotakashi	0:8fdf9a60065b	631	Preconditions:
kadonotakashi	0:8fdf9a60065b	632
kadonotakashi	0:8fdf9a60065b	633	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	634	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	635
kadonotakashi	0:8fdf9a60065b	636	Test steps:
kadonotakashi	0:8fdf9a60065b	637
kadonotakashi	0:8fdf9a60065b	638	1. Create a object by calling `new Socket()`
kadonotakashi	0:8fdf9a60065b	639	2. Call `Socket::bind(<any non-used port number>);`
kadonotakashi	0:8fdf9a60065b	640	3. destroy socket
kadonotakashi	0:8fdf9a60065b	641
kadonotakashi	0:8fdf9a60065b	642	Expected result:
kadonotakashi	0:8fdf9a60065b	643
kadonotakashi	0:8fdf9a60065b	644	NSAPI_ERROR_NO_SOCKET
kadonotakashi	0:8fdf9a60065b	645
kadonotakashi	0:8fdf9a60065b	646
kadonotakashi	0:8fdf9a60065b	647
kadonotakashi	0:8fdf9a60065b	648	Test cases for UDPSocket class
kadonotakashi	0:8fdf9a60065b	649	------------------------------
kadonotakashi	0:8fdf9a60065b	650
kadonotakashi	0:8fdf9a60065b	651	### UDPSOCKET_OPEN_DESTRUCT
kadonotakashi	0:8fdf9a60065b	652
kadonotakashi	0:8fdf9a60065b	653	Description: Run SOCKET_OPEN_DESTRUCT for UDPSocket
kadonotakashi	0:8fdf9a60065b	654
kadonotakashi	0:8fdf9a60065b	655	### UDPSOCKET_OPEN_LIMIT
kadonotakashi	0:8fdf9a60065b	656
kadonotakashi	0:8fdf9a60065b	657	Description: Run SOCKET_OPEN_LIMIT for UDPSocket
kadonotakashi	0:8fdf9a60065b	658
kadonotakashi	0:8fdf9a60065b	659	### UDPSOCKET_OPEN_TWICE
kadonotakashi	0:8fdf9a60065b	660
kadonotakashi	0:8fdf9a60065b	661	Description: Run SOCKET_OPEN_TWICE for UDPSocket
kadonotakashi	0:8fdf9a60065b	662
kadonotakashi	0:8fdf9a60065b	663	### UDPSOCKET_OPEN_CLOSE_REPEAT
kadonotakashi	0:8fdf9a60065b	664
kadonotakashi	0:8fdf9a60065b	665	Description: Run SOCKET_OPEN_CLOSE_REPEAT for UDPSocket
kadonotakashi	0:8fdf9a60065b	666
kadonotakashi	0:8fdf9a60065b	667	### UDPSOCKET_BIND_PORT
kadonotakashi	0:8fdf9a60065b	668
kadonotakashi	0:8fdf9a60065b	669	Description: Run SOCKET_BIND_PORT for UDPSocket
kadonotakashi	0:8fdf9a60065b	670
kadonotakashi	0:8fdf9a60065b	671	### UDPSOCKET_BIND_PORT_FAIL
kadonotakashi	0:8fdf9a60065b	672
kadonotakashi	0:8fdf9a60065b	673	Description: Run SOCKET_BIND_PORT_FAIL for UDPSocket
kadonotakashi	0:8fdf9a60065b	674
kadonotakashi	0:8fdf9a60065b	675	### UDPSOCKET_BIND_ADDRESS_PORT
kadonotakashi	0:8fdf9a60065b	676
kadonotakashi	0:8fdf9a60065b	677	Description: Run SOCKET_BIND_ADDRESS_PORT for UDPSocket
kadonotakashi	0:8fdf9a60065b	678
kadonotakashi	0:8fdf9a60065b	679	### UDPSOCKET_BIND_ADDRESS_NULL
kadonotakashi	0:8fdf9a60065b	680
kadonotakashi	0:8fdf9a60065b	681	Description: Run SOCKET_BIND_ADDRESS_NULL for UDPSocket
kadonotakashi	0:8fdf9a60065b	682
kadonotakashi	0:8fdf9a60065b	683	### UDPSOCKET_BIND_ADDRESS_INVALID
kadonotakashi	0:8fdf9a60065b	684
kadonotakashi	0:8fdf9a60065b	685	Description: Run SOCKET_BIND_ADDRESS_INVALID for UDPSocket
kadonotakashi	0:8fdf9a60065b	686
kadonotakashi	0:8fdf9a60065b	687	### UDPSOCKET_BIND_WRONG_TYPE
kadonotakashi	0:8fdf9a60065b	688
kadonotakashi	0:8fdf9a60065b	689	Description: Run SOCKET_BIND_WRONG_TYPE for UDPSocket
kadonotakashi	0:8fdf9a60065b	690
kadonotakashi	0:8fdf9a60065b	691	### UDPSOCKET_BIND_ADDRESS
kadonotakashi	0:8fdf9a60065b	692
kadonotakashi	0:8fdf9a60065b	693	Description: Run SOCKET_BIND_ADDRESS for UDPSocket
kadonotakashi	0:8fdf9a60065b	694
kadonotakashi	0:8fdf9a60065b	695	### UDPSOCKET_BIND_UNOPENED
kadonotakashi	0:8fdf9a60065b	696
kadonotakashi	0:8fdf9a60065b	697	Description: Run SOCKET_BIND_UNOPENED for UDPSocket
kadonotakashi	0:8fdf9a60065b	698
kadonotakashi	0:8fdf9a60065b	699	### UDPSOCKET_SENDTO_INVALID
kadonotakashi	0:8fdf9a60065b	700
kadonotakashi	0:8fdf9a60065b	701	Description:
kadonotakashi	0:8fdf9a60065b	702
kadonotakashi	0:8fdf9a60065b	703	Call `UDPSocket::sendto()` with invalid parameters.
kadonotakashi	0:8fdf9a60065b	704
kadonotakashi	0:8fdf9a60065b	705	Preconditions:
kadonotakashi	0:8fdf9a60065b	706
kadonotakashi	0:8fdf9a60065b	707	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	708	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	709	3. UDPSocket is open
kadonotakashi	0:8fdf9a60065b	710
kadonotakashi	0:8fdf9a60065b	711	Test steps:
kadonotakashi	0:8fdf9a60065b	712
kadonotakashi	0:8fdf9a60065b	713	1. Call `UDPSocket:sendto( NULL, 9, NULL, 0);`
kadonotakashi	0:8fdf9a60065b	714	2. Call `UDPSocket:sendto( "", 9, NULL, 0);`
kadonotakashi	0:8fdf9a60065b	715	3. Call `UDPSocket:sendto( "", 0, NULL, 0);`
kadonotakashi	0:8fdf9a60065b	716	4. Call `UDPSocket:sendto(NULL, 9, "hello", 5);`
kadonotakashi	0:8fdf9a60065b	717	5. Call `UDPSocket:sendto(NULL, 0, "hello", 5);`
kadonotakashi	0:8fdf9a60065b	718	6. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 9,NULL, 0);`
kadonotakashi	0:8fdf9a60065b	719	7. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 9, "hello", 5);`
kadonotakashi	0:8fdf9a60065b	720	8. destroy the socket
kadonotakashi	0:8fdf9a60065b	721
kadonotakashi	0:8fdf9a60065b	722	Expected result:
kadonotakashi	0:8fdf9a60065b	723
kadonotakashi	0:8fdf9a60065b	724	All sendto() calls should return some error code except:
kadonotakashi	0:8fdf9a60065b	725
kadonotakashi	0:8fdf9a60065b	726	- step 6 should return 5
kadonotakashi	0:8fdf9a60065b	727	- step 7 should return 0
kadonotakashi	0:8fdf9a60065b	728	- step 8 should return 5
kadonotakashi	0:8fdf9a60065b	729
kadonotakashi	0:8fdf9a60065b	730
kadonotakashi	0:8fdf9a60065b	731
kadonotakashi	0:8fdf9a60065b	732	### UDPSOCKET_SENDTO_REPEAT
kadonotakashi	0:8fdf9a60065b	733
kadonotakashi	0:8fdf9a60065b	734	Description:
kadonotakashi	0:8fdf9a60065b	735
kadonotakashi	0:8fdf9a60065b	736	Repeatedly send small packets.
kadonotakashi	0:8fdf9a60065b	737
kadonotakashi	0:8fdf9a60065b	738	Preconditions:
kadonotakashi	0:8fdf9a60065b	739
kadonotakashi	0:8fdf9a60065b	740	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	741	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	742	3. UDPSocket is open
kadonotakashi	0:8fdf9a60065b	743
kadonotakashi	0:8fdf9a60065b	744	Test steps:
kadonotakashi	0:8fdf9a60065b	745
kadonotakashi	0:8fdf9a60065b	746	1. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 9, "hello", 5);`
kadonotakashi	0:8fdf9a60065b	747	2. repeat 100 times
kadonotakashi	0:8fdf9a60065b	748	3. Fail if `NSAPI_ERROR_NO_MEMORY` is returned two times in a row,
kadonotakashi	0:8fdf9a60065b	749	wait 1 second before retry
kadonotakashi	0:8fdf9a60065b	750	4. destroy the socket
kadonotakashi	0:8fdf9a60065b	751
kadonotakashi	0:8fdf9a60065b	752	Expected result:
kadonotakashi	0:8fdf9a60065b	753
kadonotakashi	0:8fdf9a60065b	754	All sendto() calls should return 5.
kadonotakashi	0:8fdf9a60065b	755
kadonotakashi	0:8fdf9a60065b	756
kadonotakashi	0:8fdf9a60065b	757
kadonotakashi	0:8fdf9a60065b	758	### UDPSOCKET_BIND_SENDTO
kadonotakashi	0:8fdf9a60065b	759
kadonotakashi	0:8fdf9a60065b	760	Description:
kadonotakashi	0:8fdf9a60065b	761
kadonotakashi	0:8fdf9a60065b	762	Bind the socket to specific port before sending. Verify from DUT2 that
kadonotakashi	0:8fdf9a60065b	763	packet was coming from correct port.
kadonotakashi	0:8fdf9a60065b	764
kadonotakashi	0:8fdf9a60065b	765	Requires two devices with LAN connectivity (Eth, WiFi or mesh). For
kadonotakashi	0:8fdf9a60065b	766	Cellular or WAN connectivity, skip this test.
kadonotakashi	0:8fdf9a60065b	767
kadonotakashi	0:8fdf9a60065b	768	Preconditions:
kadonotakashi	0:8fdf9a60065b	769
kadonotakashi	0:8fdf9a60065b	770	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	771	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	772	3. UDPSocket is open
kadonotakashi	0:8fdf9a60065b	773
kadonotakashi	0:8fdf9a60065b	774	Test steps:
kadonotakashi	0:8fdf9a60065b	775
kadonotakashi	0:8fdf9a60065b	776	1. DUT1&2: Call `UDPSocket::bind(<unuser port number>);`
kadonotakashi	0:8fdf9a60065b	777	2. DUT2: Get devices IP address
kadonotakashi	0:8fdf9a60065b	778	3. DUT1: Call `UDPSocket::sendto( dut2, port, "hello", 5);`
kadonotakashi	0:8fdf9a60065b	779	4. DUT2: Call `UDPSocket::recvfrom();`
kadonotakashi	0:8fdf9a60065b	780	5. destroy the sockets
kadonotakashi	0:8fdf9a60065b	781
kadonotakashi	0:8fdf9a60065b	782	Expected result:
kadonotakashi	0:8fdf9a60065b	783
kadonotakashi	0:8fdf9a60065b	784	`UDPSocket::bind()` should return NSAPI_ERROR_OK.
kadonotakashi	0:8fdf9a60065b	785
kadonotakashi	0:8fdf9a60065b	786	`UDPSocket::sendto()` call should return 5.
kadonotakashi	0:8fdf9a60065b	787
kadonotakashi	0:8fdf9a60065b	788	`UDPSocket::recvfrom()` should return 5 and port number should match the
kadonotakashi	0:8fdf9a60065b	789	one used in bind() call. Data should contain "hello"
kadonotakashi	0:8fdf9a60065b	790
kadonotakashi	0:8fdf9a60065b	791
kadonotakashi	0:8fdf9a60065b	792
kadonotakashi	0:8fdf9a60065b	793	### UDPSOCKET_ECHOTEST
kadonotakashi	0:8fdf9a60065b	794
kadonotakashi	0:8fdf9a60065b	795	Description:
kadonotakashi	0:8fdf9a60065b	796
kadonotakashi	0:8fdf9a60065b	797	Repeatedly send packets to echo server and read incoming packets back.
kadonotakashi	0:8fdf9a60065b	798	Verify working of different packet sizes.
kadonotakashi	0:8fdf9a60065b	799
kadonotakashi	0:8fdf9a60065b	800	Preconditions:
kadonotakashi	0:8fdf9a60065b	801
kadonotakashi	0:8fdf9a60065b	802	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	803	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	804	3. UDPSocket is open
kadonotakashi	0:8fdf9a60065b	805
kadonotakashi	0:8fdf9a60065b	806	Test steps:
kadonotakashi	0:8fdf9a60065b	807
kadonotakashi	0:8fdf9a60065b	808	1. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = loop index>, <loop index>);`
kadonotakashi	0:8fdf9a60065b	809	2. Wait for incomming packet. If timeout happens, retry
kadonotakashi	0:8fdf9a60065b	810	sending&receiving, max 3 times.
kadonotakashi	0:8fdf9a60065b	811	3. Verify incomming content was the same that was sent
kadonotakashi	0:8fdf9a60065b	812	4. Repeat 1200 times
kadonotakashi	0:8fdf9a60065b	813	5. destroy the socket
kadonotakashi	0:8fdf9a60065b	814
kadonotakashi	0:8fdf9a60065b	815	Expected result:
kadonotakashi	0:8fdf9a60065b	816
kadonotakashi	0:8fdf9a60065b	817	All sendto() calls should return the packet size. All recvfrom() calls
kadonotakashi	0:8fdf9a60065b	818	should return the same sized packet that was send with same content.
kadonotakashi	0:8fdf9a60065b	819	Calculate packet loss rate, maximum tolerated packet loss rate is 30%
kadonotakashi	0:8fdf9a60065b	820
kadonotakashi	0:8fdf9a60065b	821
kadonotakashi	0:8fdf9a60065b	822
kadonotakashi	0:8fdf9a60065b	823	### UDPSOCKET_ECHOTEST_NONBLOCK
kadonotakashi	0:8fdf9a60065b	824
kadonotakashi	0:8fdf9a60065b	825	Description:
kadonotakashi	0:8fdf9a60065b	826
kadonotakashi	0:8fdf9a60065b	827	Repeatedly send packets to echo server and read incoming packets back.
kadonotakashi	0:8fdf9a60065b	828	Verify working of different packet sizes. Use socket in non-blocking
kadonotakashi	0:8fdf9a60065b	829	mode
kadonotakashi	0:8fdf9a60065b	830
kadonotakashi	0:8fdf9a60065b	831	Preconditions:
kadonotakashi	0:8fdf9a60065b	832
kadonotakashi	0:8fdf9a60065b	833	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	834	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	835	3. UDPSocket is open
kadonotakashi	0:8fdf9a60065b	836
kadonotakashi	0:8fdf9a60065b	837	Test steps:
kadonotakashi	0:8fdf9a60065b	838
kadonotakashi	0:8fdf9a60065b	839	1. Call `UDPSocket::set_blocking(false)`
kadonotakashi	0:8fdf9a60065b	840	2. Register event handler with `UDPSocket::sigio()`
kadonotakashi	0:8fdf9a60065b	841	3. Create another thread that constantly waits signal from sigio()
kadonotakashi	0:8fdf9a60065b	842	handler, when received try `UDPSocket::recvfrom()`
kadonotakashi	0:8fdf9a60065b	843	4. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = loop index>, <loop index>);`
kadonotakashi	0:8fdf9a60065b	844	5. Wait for incomming packet for one second. If nothing received retry,
kadonotakashi	0:8fdf9a60065b	845	max 3 times.
kadonotakashi	0:8fdf9a60065b	846	6. Verify incomming content was the same that was sent
kadonotakashi	0:8fdf9a60065b	847	7. Repeat 1200 times
kadonotakashi	0:8fdf9a60065b	848	8. destroy the socket
kadonotakashi	0:8fdf9a60065b	849
kadonotakashi	0:8fdf9a60065b	850	Expected result:
kadonotakashi	0:8fdf9a60065b	851
kadonotakashi	0:8fdf9a60065b	852	All sendto() calls should return the packet size. All recvfrom() calls
kadonotakashi	0:8fdf9a60065b	853	should return the same sized packet that was send with same content or
kadonotakashi	0:8fdf9a60065b	854	NSAPI_ERROR_WOULD_BLOCK.
kadonotakashi	0:8fdf9a60065b	855
kadonotakashi	0:8fdf9a60065b	856	Calculate packet loss rate, maximum tolerated packet loss rate is 30%
kadonotakashi	0:8fdf9a60065b	857
kadonotakashi	0:8fdf9a60065b	858
kadonotakashi	0:8fdf9a60065b	859
kadonotakashi	0:8fdf9a60065b	860	### UDPSOCKET_RECV_TIMEOUT
kadonotakashi	0:8fdf9a60065b	861
kadonotakashi	0:8fdf9a60065b	862	Description:
kadonotakashi	0:8fdf9a60065b	863
kadonotakashi	0:8fdf9a60065b	864	Test whether timeouts are obeyed in UDPSockets.
kadonotakashi	0:8fdf9a60065b	865
kadonotakashi	0:8fdf9a60065b	866	Preconditions:
kadonotakashi	0:8fdf9a60065b	867
kadonotakashi	0:8fdf9a60065b	868	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	869	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	870
kadonotakashi	0:8fdf9a60065b	871	Test steps:
kadonotakashi	0:8fdf9a60065b	872
kadonotakashi	0:8fdf9a60065b	873	1. Call `UDPSocket::set_timeout(100)`
kadonotakashi	0:8fdf9a60065b	874	2. Call `UDPSocket::sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 100>, 100);`
kadonotakashi	0:8fdf9a60065b	875	3. Repeat 5 times
kadonotakashi	0:8fdf9a60065b	876	1. record a time in millisecond precission
kadonotakashi	0:8fdf9a60065b	877	2. Call `UDPSocket::recvfrom()`
kadonotakashi	0:8fdf9a60065b	878	3. record a time in millisecond precission
kadonotakashi	0:8fdf9a60065b	879
kadonotakashi	0:8fdf9a60065b	880	4. repeat testcase 10 times.
kadonotakashi	0:8fdf9a60065b	881
kadonotakashi	0:8fdf9a60065b	882	Expected result:
kadonotakashi	0:8fdf9a60065b	883
kadonotakashi	0:8fdf9a60065b	884	Each `sendto()` calls should return 100.
kadonotakashi	0:8fdf9a60065b	885
kadonotakashi	0:8fdf9a60065b	886	Within each loop, one `recvfrom()` may return the received packet size
kadonotakashi	0:8fdf9a60065b	887	(100). Other calls should return NSAPI_ERROR_WOULD_BLOCK.
kadonotakashi	0:8fdf9a60065b	888
kadonotakashi	0:8fdf9a60065b	889	When NSAPI_ERROR_WOULD_BLOCK is received, check that time consumed is
kadonotakashi	0:8fdf9a60065b	890	more that 100 milliseconds but less than 200 milliseconds.
kadonotakashi	0:8fdf9a60065b	891
kadonotakashi	0:8fdf9a60065b	892	After repeating for 10 times, at least 5 packets must have been
kadonotakashi	0:8fdf9a60065b	893	received.
kadonotakashi	0:8fdf9a60065b	894
kadonotakashi	0:8fdf9a60065b	895
kadonotakashi	0:8fdf9a60065b	896	### UDPSOCKET_SENDTO_TIMEOUT
kadonotakashi	0:8fdf9a60065b	897
kadonotakashi	0:8fdf9a60065b	898	Description:
kadonotakashi	0:8fdf9a60065b	899
kadonotakashi	0:8fdf9a60065b	900	Test whether timeouts are obeyed in UDPSockets.
kadonotakashi	0:8fdf9a60065b	901
kadonotakashi	0:8fdf9a60065b	902	Preconditions:
kadonotakashi	0:8fdf9a60065b	903
kadonotakashi	0:8fdf9a60065b	904	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	905	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	906
kadonotakashi	0:8fdf9a60065b	907	Test steps:
kadonotakashi	0:8fdf9a60065b	908
kadonotakashi	0:8fdf9a60065b	909	1. Record time
kadonotakashi	0:8fdf9a60065b	910	2. Call `UDPSocket::sendto("echo.mbedcloudtesting.com", 9, <random packet, size = 100>, 100);`
kadonotakashi	0:8fdf9a60065b	911	3. Record time
kadonotakashi	0:8fdf9a60065b	912	4. Call `UDPSocket::set_timeout(1000)`
kadonotakashi	0:8fdf9a60065b	913	5. Call `UDPSocket::sendto("echo.mbedcloudtesting.com", 9, <random packet, size = 100>, 100);`
kadonotakashi	0:8fdf9a60065b	914	6. Record time
kadonotakashi	0:8fdf9a60065b	915
kadonotakashi	0:8fdf9a60065b	916	Expected result:
kadonotakashi	0:8fdf9a60065b	917
kadonotakashi	0:8fdf9a60065b	918	Each sendto() call should return 100.
kadonotakashi	0:8fdf9a60065b	919
kadonotakashi	0:8fdf9a60065b	920	All sendto() calls should return faster than 100 milliseconds because
kadonotakashi	0:8fdf9a60065b	921	UDP sending should not block that long.
kadonotakashi	0:8fdf9a60065b	922
kadonotakashi	0:8fdf9a60065b	923
kadonotakashi	0:8fdf9a60065b	924	Test cases for TCPSocket class
kadonotakashi	0:8fdf9a60065b	925	------------------------------
kadonotakashi	0:8fdf9a60065b	926
kadonotakashi	0:8fdf9a60065b	927	### TCPSOCKET_OPEN_DESTRUCT
kadonotakashi	0:8fdf9a60065b	928
kadonotakashi	0:8fdf9a60065b	929	Description: Run SOCKET_OPEN_DESTRUCT for TCPSocket
kadonotakashi	0:8fdf9a60065b	930
kadonotakashi	0:8fdf9a60065b	931	### TCPSOCKET_OPEN_LIMIT
kadonotakashi	0:8fdf9a60065b	932
kadonotakashi	0:8fdf9a60065b	933	Description: Run SOCKET_OPEN_LIMIT for TCPSocket
kadonotakashi	0:8fdf9a60065b	934
kadonotakashi	0:8fdf9a60065b	935	### TCPSOCKET_OPEN_TWICE
kadonotakashi	0:8fdf9a60065b	936
kadonotakashi	0:8fdf9a60065b	937	Description: Run SOCKET_OPEN_TWICE for TCPSocket
kadonotakashi	0:8fdf9a60065b	938
kadonotakashi	0:8fdf9a60065b	939	### TCPSOCKET_OPEN_CLOSE_REPEAT
kadonotakashi	0:8fdf9a60065b	940
kadonotakashi	0:8fdf9a60065b	941	Description: Run SOCKET_OPEN_CLOSE_REPEAT for TCPSocket
kadonotakashi	0:8fdf9a60065b	942
kadonotakashi	0:8fdf9a60065b	943	### TCPSOCKET_BIND_PORT
kadonotakashi	0:8fdf9a60065b	944
kadonotakashi	0:8fdf9a60065b	945	Description: Run SOCKET_BIND_PORT for TCPSocket
kadonotakashi	0:8fdf9a60065b	946
kadonotakashi	0:8fdf9a60065b	947	### TCPSOCKET_BIND_PORT_FAIL
kadonotakashi	0:8fdf9a60065b	948
kadonotakashi	0:8fdf9a60065b	949	Description: Run SOCKET_BIND_PORT_FAIL for TCPSocket
kadonotakashi	0:8fdf9a60065b	950
kadonotakashi	0:8fdf9a60065b	951	### TCPSOCKET_BIND_ADDRESS_PORT
kadonotakashi	0:8fdf9a60065b	952
kadonotakashi	0:8fdf9a60065b	953	Description: Run SOCKET_BIND_ADDRESS_PORT for TCPSocket
kadonotakashi	0:8fdf9a60065b	954
kadonotakashi	0:8fdf9a60065b	955	### TCPSOCKET_BIND_ADDRESS_NULL
kadonotakashi	0:8fdf9a60065b	956
kadonotakashi	0:8fdf9a60065b	957	Description: Run SOCKET_BIND_ADDRESS_NULL for TCPSocket
kadonotakashi	0:8fdf9a60065b	958
kadonotakashi	0:8fdf9a60065b	959	### TCPSOCKET_BIND_ADDRESS_INVALID
kadonotakashi	0:8fdf9a60065b	960
kadonotakashi	0:8fdf9a60065b	961	Description: Run SOCKET_BIND_ADDRESS_INVALID for TCPSocket
kadonotakashi	0:8fdf9a60065b	962
kadonotakashi	0:8fdf9a60065b	963	### TCPSOCKET_BIND_WRONG_TYPE
kadonotakashi	0:8fdf9a60065b	964
kadonotakashi	0:8fdf9a60065b	965	Description: Run SOCKET_BIND_WRONG_TYPE for TCPSocket
kadonotakashi	0:8fdf9a60065b	966
kadonotakashi	0:8fdf9a60065b	967	### TCPSOCKET_BIND_ADDRESS
kadonotakashi	0:8fdf9a60065b	968
kadonotakashi	0:8fdf9a60065b	969	Description: Run SOCKET_BIND_ADDRESS for TCPSocket
kadonotakashi	0:8fdf9a60065b	970
kadonotakashi	0:8fdf9a60065b	971	### TCPSOCKET_BIND_UNOPENED
kadonotakashi	0:8fdf9a60065b	972
kadonotakashi	0:8fdf9a60065b	973	Description: Run SOCKET_BIND_UNOPENED for TCPSocket
kadonotakashi	0:8fdf9a60065b	974
kadonotakashi	0:8fdf9a60065b	975	### TCPSOCKET_CONNECT_INVALID
kadonotakashi	0:8fdf9a60065b	976
kadonotakashi	0:8fdf9a60065b	977	Description:
kadonotakashi	0:8fdf9a60065b	978
kadonotakashi	0:8fdf9a60065b	979	Call `TCPSocket::connect()` with invalid parameters.
kadonotakashi	0:8fdf9a60065b	980
kadonotakashi	0:8fdf9a60065b	981	Preconditions:
kadonotakashi	0:8fdf9a60065b	982
kadonotakashi	0:8fdf9a60065b	983	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	984	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	985	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	986
kadonotakashi	0:8fdf9a60065b	987	Test steps:
kadonotakashi	0:8fdf9a60065b	988
kadonotakashi	0:8fdf9a60065b	989	1. Call `TCPSocket:connect( NULL, 9);`
kadonotakashi	0:8fdf9a60065b	990	2. Call `TCPSocket:connect( "", 9);`
kadonotakashi	0:8fdf9a60065b	991	3. Call `TCPSocket:connect( "", 0);`
kadonotakashi	0:8fdf9a60065b	992	4. Call `TCPSocket:connect( "echo.mbedcloudtesting.com", 9);`
kadonotakashi	0:8fdf9a60065b	993	5. destroy the socket
kadonotakashi	0:8fdf9a60065b	994
kadonotakashi	0:8fdf9a60065b	995	Expected result:
kadonotakashi	0:8fdf9a60065b	996
kadonotakashi	0:8fdf9a60065b	997	All connect() calls should return some error code except the number 5
kadonotakashi	0:8fdf9a60065b	998	should return NSAPI_ERROR_OK.
kadonotakashi	0:8fdf9a60065b	999
kadonotakashi	0:8fdf9a60065b	1000
kadonotakashi	0:8fdf9a60065b	1001
kadonotakashi	0:8fdf9a60065b	1002	### TCPSOCKET_SEND_REPEAT
kadonotakashi	0:8fdf9a60065b	1003
kadonotakashi	0:8fdf9a60065b	1004	Description:
kadonotakashi	0:8fdf9a60065b	1005
kadonotakashi	0:8fdf9a60065b	1006	Repeatedly send small packets.
kadonotakashi	0:8fdf9a60065b	1007
kadonotakashi	0:8fdf9a60065b	1008	Preconditions:
kadonotakashi	0:8fdf9a60065b	1009
kadonotakashi	0:8fdf9a60065b	1010	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1011	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1012	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	1013
kadonotakashi	0:8fdf9a60065b	1014	Test steps:
kadonotakashi	0:8fdf9a60065b	1015
kadonotakashi	0:8fdf9a60065b	1016	1. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 9);`
kadonotakashi	0:8fdf9a60065b	1017	2. Call `TCPSocket::send("hello", 5);`
kadonotakashi	0:8fdf9a60065b	1018	3. repeat 1000 times
kadonotakashi	0:8fdf9a60065b	1019	4. destroy the socket
kadonotakashi	0:8fdf9a60065b	1020
kadonotakashi	0:8fdf9a60065b	1021	Expected result:
kadonotakashi	0:8fdf9a60065b	1022
kadonotakashi	0:8fdf9a60065b	1023	`TCPSocket::connect()` should return NSAPI_ERROR_OK
kadonotakashi	0:8fdf9a60065b	1024
kadonotakashi	0:8fdf9a60065b	1025	All send() calls should return 5.
kadonotakashi	0:8fdf9a60065b	1026
kadonotakashi	0:8fdf9a60065b	1027
kadonotakashi	0:8fdf9a60065b	1028
kadonotakashi	0:8fdf9a60065b	1029	### TCPSOCKET_ECHOTEST
kadonotakashi	0:8fdf9a60065b	1030
kadonotakashi	0:8fdf9a60065b	1031	Description:
kadonotakashi	0:8fdf9a60065b	1032
kadonotakashi	0:8fdf9a60065b	1033	Repeatedly send packets to echo server and read incoming packets back.
kadonotakashi	0:8fdf9a60065b	1034	Verify working of different packet sizes.
kadonotakashi	0:8fdf9a60065b	1035
kadonotakashi	0:8fdf9a60065b	1036	Preconditions:
kadonotakashi	0:8fdf9a60065b	1037
kadonotakashi	0:8fdf9a60065b	1038	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1039	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1040	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	1041
kadonotakashi	0:8fdf9a60065b	1042	Test steps:
kadonotakashi	0:8fdf9a60065b	1043
kadonotakashi	0:8fdf9a60065b	1044	1. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 7);`
kadonotakashi	0:8fdf9a60065b	1045	2. Call `TCPSocket::send(<random packet, size = loop index>, <size>);`
kadonotakashi	0:8fdf9a60065b	1046	1. If less than <loop index> was returned, size = sent bytes
kadonotakashi	0:8fdf9a60065b	1047
kadonotakashi	0:8fdf9a60065b	1048	3. Call `TCPSocket::recv(buffer, <size>);`
kadonotakashi	0:8fdf9a60065b	1049	4. Verify incomming content was the same that was sent
kadonotakashi	0:8fdf9a60065b	1050	5. Repeat 1200 times
kadonotakashi	0:8fdf9a60065b	1051	6. destroy the socket
kadonotakashi	0:8fdf9a60065b	1052
kadonotakashi	0:8fdf9a60065b	1053	Expected result:
kadonotakashi	0:8fdf9a60065b	1054
kadonotakashi	0:8fdf9a60065b	1055	All send() calls should return the packet size or less. All recv() calls
kadonotakashi	0:8fdf9a60065b	1056	should return the same sized packet that was send with same content.
kadonotakashi	0:8fdf9a60065b	1057
kadonotakashi	0:8fdf9a60065b	1058	NOTE: This is stream so recv() might return less data than what was
kadonotakashi	0:8fdf9a60065b	1059	requested. In this case you need to keep calling recv() until all data
kadonotakashi	0:8fdf9a60065b	1060	that you have sent is returned.
kadonotakashi	0:8fdf9a60065b	1061
kadonotakashi	0:8fdf9a60065b	1062
kadonotakashi	0:8fdf9a60065b	1063	### TCPSOCKET_ECHOTEST_NONBLOCK
kadonotakashi	0:8fdf9a60065b	1064
kadonotakashi	0:8fdf9a60065b	1065	Description:
kadonotakashi	0:8fdf9a60065b	1066
kadonotakashi	0:8fdf9a60065b	1067	Repeatedly send packets to echo server and read incoming packets back.
kadonotakashi	0:8fdf9a60065b	1068	Verify working of different packet sizes. Use socket in non-blocking
kadonotakashi	0:8fdf9a60065b	1069	mode
kadonotakashi	0:8fdf9a60065b	1070
kadonotakashi	0:8fdf9a60065b	1071	Preconditions:
kadonotakashi	0:8fdf9a60065b	1072
kadonotakashi	0:8fdf9a60065b	1073	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1074	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1075	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	1076
kadonotakashi	0:8fdf9a60065b	1077	Test steps:
kadonotakashi	0:8fdf9a60065b	1078
kadonotakashi	0:8fdf9a60065b	1079	1. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 7);`
kadonotakashi	0:8fdf9a60065b	1080	2. Call `TCPSocket::set_blocking(false)`
kadonotakashi	0:8fdf9a60065b	1081	3. Register event handler with `TCPSocket::sigio()`
kadonotakashi	0:8fdf9a60065b	1082	4. Create another thread that constantly waits signal from `sigio()`
kadonotakashi	0:8fdf9a60065b	1083	handler, when received try `TCPSocket::recv(buf+index, <loop index> - index)`, where index is the amount of data
kadonotakashi	0:8fdf9a60065b	1084	already received.
kadonotakashi	0:8fdf9a60065b	1085	5. Call `TCPSocket:send(<random packet, size = loop index>, <loop index>);`
kadonotakashi	0:8fdf9a60065b	1086	1. If less than <loop index> was returned, try immeadiately
kadonotakashi	0:8fdf9a60065b	1087	sending remaining bytes.
kadonotakashi	0:8fdf9a60065b	1088	2. If NSAPI_ERROR_WOULD_BLOCK is returned, wait for sigio() call
kadonotakashi	0:8fdf9a60065b	1089	to happen.
kadonotakashi	0:8fdf9a60065b	1090
kadonotakashi	0:8fdf9a60065b	1091	6. Wait for incomming packet for one second.
kadonotakashi	0:8fdf9a60065b	1092	7. Verify incomming content was the same that was sent, set index for
kadonotakashi	0:8fdf9a60065b	1093	receiving thread to zero.
kadonotakashi	0:8fdf9a60065b	1094	8. Repeat 1200 times
kadonotakashi	0:8fdf9a60065b	1095	9. destroy the socket
kadonotakashi	0:8fdf9a60065b	1096
kadonotakashi	0:8fdf9a60065b	1097	Expected result:
kadonotakashi	0:8fdf9a60065b	1098
kadonotakashi	0:8fdf9a60065b	1099	All send() calls should return the packet size or less. All recv() calls
kadonotakashi	0:8fdf9a60065b	1100	should return NSAPI_ERROR_WOULD_BLOCK or packet size that is equal or
kadonotakashi	0:8fdf9a60065b	1101	less than what has been sent.
kadonotakashi	0:8fdf9a60065b	1102
kadonotakashi	0:8fdf9a60065b	1103	### TCPSOCKET_RECV_TIMEOUT
kadonotakashi	0:8fdf9a60065b	1104
kadonotakashi	0:8fdf9a60065b	1105	Description:
kadonotakashi	0:8fdf9a60065b	1106
kadonotakashi	0:8fdf9a60065b	1107	Test whether timeouts are obeyed in TCPSockets.
kadonotakashi	0:8fdf9a60065b	1108
kadonotakashi	0:8fdf9a60065b	1109	Preconditions:
kadonotakashi	0:8fdf9a60065b	1110
kadonotakashi	0:8fdf9a60065b	1111	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1112	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1113	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	1114
kadonotakashi	0:8fdf9a60065b	1115	Test steps:
kadonotakashi	0:8fdf9a60065b	1116
kadonotakashi	0:8fdf9a60065b	1117	1. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 7);`
kadonotakashi	0:8fdf9a60065b	1118	2. Call `TCPSocket::set_timeout(100);`
kadonotakashi	0:8fdf9a60065b	1119	3. Call `TCPSocket::send(<random packet, size = 100>;, 100);`
kadonotakashi	0:8fdf9a60065b	1120	4. Repeat 5 times
kadonotakashi	0:8fdf9a60065b	1121	1. record a time in millisecond precission
kadonotakashi	0:8fdf9a60065b	1122	2. Call `TCPSocket::recv()`
kadonotakashi	0:8fdf9a60065b	1123	3. record a time in millisecond precission
kadonotakashi	0:8fdf9a60065b	1124
kadonotakashi	0:8fdf9a60065b	1125	5. repeat testcase 10 times.
kadonotakashi	0:8fdf9a60065b	1126
kadonotakashi	0:8fdf9a60065b	1127	Expected result:
kadonotakashi	0:8fdf9a60065b	1128
kadonotakashi	0:8fdf9a60065b	1129	Each send() call should return 100.
kadonotakashi	0:8fdf9a60065b	1130
kadonotakashi	0:8fdf9a60065b	1131	Within each loop, one recv() may return the received packet size (100).
kadonotakashi	0:8fdf9a60065b	1132	Other calls should return NSAPI_ERROR_WOULD_BLOCK.
kadonotakashi	0:8fdf9a60065b	1133
kadonotakashi	0:8fdf9a60065b	1134	When NSAPI_ERROR_WOULD_BLOCK is received, check that time consumed is
kadonotakashi	0:8fdf9a60065b	1135	more that 100 milliseconds but less than 200 milliseconds.
kadonotakashi	0:8fdf9a60065b	1136
kadonotakashi	0:8fdf9a60065b	1137
kadonotakashi	0:8fdf9a60065b	1138	### TCPSOCKET_SEND_TIMEOUT
kadonotakashi	0:8fdf9a60065b	1139
kadonotakashi	0:8fdf9a60065b	1140	Description:
kadonotakashi	0:8fdf9a60065b	1141
kadonotakashi	0:8fdf9a60065b	1142	Repeatedly send small packets in a given time limit
kadonotakashi	0:8fdf9a60065b	1143
kadonotakashi	0:8fdf9a60065b	1144	Preconditions:
kadonotakashi	0:8fdf9a60065b	1145
kadonotakashi	0:8fdf9a60065b	1146	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1147	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1148	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	1149
kadonotakashi	0:8fdf9a60065b	1150	Test steps:
kadonotakashi	0:8fdf9a60065b	1151
kadonotakashi	0:8fdf9a60065b	1152	1. Call `TCPSocket:connect("echo.mbedcloudtesting.com", 9);`
kadonotakashi	0:8fdf9a60065b	1153	3. Call `TCPSocket:set_blocking(false);`
kadonotakashi	0:8fdf9a60065b	1154	3. Call `TCPSocket:send("hello", 5);`
kadonotakashi	0:8fdf9a60065b	1155	4. repeat 10 times
kadonotakashi	0:8fdf9a60065b	1156	5. destroy the socket
kadonotakashi	0:8fdf9a60065b	1157
kadonotakashi	0:8fdf9a60065b	1158	Expected result:
kadonotakashi	0:8fdf9a60065b	1159
kadonotakashi	0:8fdf9a60065b	1160	`TCPSocket::connect()` should return NSAPI_ERROR_OK
kadonotakashi	0:8fdf9a60065b	1161
kadonotakashi	0:8fdf9a60065b	1162	All send() calls should return in less than 800 milliseconds
kadonotakashi	0:8fdf9a60065b	1163
kadonotakashi	0:8fdf9a60065b	1164
kadonotakashi	0:8fdf9a60065b	1165	### TCPSOCKET_ENDPOINT_CLOSE
kadonotakashi	0:8fdf9a60065b	1166
kadonotakashi	0:8fdf9a60065b	1167	Description:
kadonotakashi	0:8fdf9a60065b	1168
kadonotakashi	0:8fdf9a60065b	1169	Test whether we tolerate endpoint closing the connection.
kadonotakashi	0:8fdf9a60065b	1170
kadonotakashi	0:8fdf9a60065b	1171	Preconditions:
kadonotakashi	0:8fdf9a60065b	1172
kadonotakashi	0:8fdf9a60065b	1173	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1174	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1175	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	1176
kadonotakashi	0:8fdf9a60065b	1177	Test steps:
kadonotakashi	0:8fdf9a60065b	1178
kadonotakashi	0:8fdf9a60065b	1179	1. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 13);`
kadonotakashi	0:8fdf9a60065b	1180	2. Call `TCPSocket::recv(<buffer>, 30);`
kadonotakashi	0:8fdf9a60065b	1181	3. Repeat until recv() returns 0
kadonotakashi	0:8fdf9a60065b	1182	4. Call `TCPSocket::close();`
kadonotakashi	0:8fdf9a60065b	1183	5. delete socket
kadonotakashi	0:8fdf9a60065b	1184
kadonotakashi	0:8fdf9a60065b	1185	Expected result:
kadonotakashi	0:8fdf9a60065b	1186	Connect should return NSAPI_ERROR_OK.
kadonotakashi	0:8fdf9a60065b	1187
kadonotakashi	0:8fdf9a60065b	1188	First recv() should return more that zero. Something between 10 and 30
kadonotakashi	0:8fdf9a60065b	1189	bytes (datetime string)
kadonotakashi	0:8fdf9a60065b	1190
kadonotakashi	0:8fdf9a60065b	1191	Second recv() should return zero because endpoint closed the connection.
kadonotakashi	0:8fdf9a60065b	1192	(EOF). close() should return NSAPI_ERROR_OK
kadonotakashi	0:8fdf9a60065b	1193
kadonotakashi	0:8fdf9a60065b	1194	### TCPSOCKET_SETSOCKOPT_KEEPALIVE_VALID
kadonotakashi	0:8fdf9a60065b	1195
kadonotakashi	0:8fdf9a60065b	1196	Description:
kadonotakashi	0:8fdf9a60065b	1197
kadonotakashi	0:8fdf9a60065b	1198	Test we are able to request setting valid TCP keepalive values
kadonotakashi	0:8fdf9a60065b	1199
kadonotakashi	0:8fdf9a60065b	1200	Preconditions:
kadonotakashi	0:8fdf9a60065b	1201
kadonotakashi	0:8fdf9a60065b	1202	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1203	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1204
kadonotakashi	0:8fdf9a60065b	1205	Test steps:
kadonotakashi	0:8fdf9a60065b	1206
kadonotakashi	0:8fdf9a60065b	1207	1. Call `TCPSocket::setsockopt(keepalive, [0,1 or 7200]);`
kadonotakashi	0:8fdf9a60065b	1208	2. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 9);`
kadonotakashi	0:8fdf9a60065b	1209	3. Call `TCPSocket::getsockopt(keepalive);`
kadonotakashi	0:8fdf9a60065b	1210
kadonotakashi	0:8fdf9a60065b	1211	Postconditions:
kadonotakashi	0:8fdf9a60065b	1212
kadonotakashi	0:8fdf9a60065b	1213	1. Call `TCPSocket::close();`
kadonotakashi	0:8fdf9a60065b	1214	2. delete socket
kadonotakashi	0:8fdf9a60065b	1215
kadonotakashi	0:8fdf9a60065b	1216	Expected result:
kadonotakashi	0:8fdf9a60065b	1217
kadonotakashi	0:8fdf9a60065b	1218	`TCPSocket::getsockopt(keepalive)` returns same value as was set with
kadonotakashi	0:8fdf9a60065b	1219	`TCPSocket::setsockopt()` or NSAPI_ERROR_UNSUPPORTED
kadonotakashi	0:8fdf9a60065b	1220
kadonotakashi	0:8fdf9a60065b	1221	### TCPSOCKET_SETSOCKOPT_KEEPALIVE_INVALID
kadonotakashi	0:8fdf9a60065b	1222
kadonotakashi	0:8fdf9a60065b	1223	Description:
kadonotakashi	0:8fdf9a60065b	1224
kadonotakashi	0:8fdf9a60065b	1225	Test we are able to detect if an invalid TCP keepalive value is tried to
kadonotakashi	0:8fdf9a60065b	1226	be set
kadonotakashi	0:8fdf9a60065b	1227
kadonotakashi	0:8fdf9a60065b	1228	Preconditions:
kadonotakashi	0:8fdf9a60065b	1229
kadonotakashi	0:8fdf9a60065b	1230	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1231	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1232
kadonotakashi	0:8fdf9a60065b	1233	Test steps:
kadonotakashi	0:8fdf9a60065b	1234
kadonotakashi	0:8fdf9a60065b	1235	1. Call `TCPSocket::setsockopt(keepalive, [-1 or 7201]);`
kadonotakashi	0:8fdf9a60065b	1236	2. Call `TCPSocket::getsockopt(keepalive);`
kadonotakashi	0:8fdf9a60065b	1237
kadonotakashi	0:8fdf9a60065b	1238	Postconditions:
kadonotakashi	0:8fdf9a60065b	1239
kadonotakashi	0:8fdf9a60065b	1240	1. Call `TCPSocket::close();`
kadonotakashi	0:8fdf9a60065b	1241	2. delete socket
kadonotakashi	0:8fdf9a60065b	1242
kadonotakashi	0:8fdf9a60065b	1243	Expected result:
kadonotakashi	0:8fdf9a60065b	1244
kadonotakashi	0:8fdf9a60065b	1245	`TCPSocket::setsockopt(keepalive)` returns error code or
kadonotakashi	0:8fdf9a60065b	1246	NSAPI_ERROR_UNSUPPORTED
kadonotakashi	0:8fdf9a60065b	1247
kadonotakashi	0:8fdf9a60065b	1248	`TCPSocket::getsockopt()` returns 0 or NSAPI_ERROR_UNSUPPORTED
kadonotakashi	0:8fdf9a60065b	1249
kadonotakashi	0:8fdf9a60065b	1250
kadonotakashi	0:8fdf9a60065b	1251	Test cases for TCPServer class
kadonotakashi	0:8fdf9a60065b	1252	------------------------------
kadonotakashi	0:8fdf9a60065b	1253
kadonotakashi	0:8fdf9a60065b	1254	These tests require two devices under test and connectivity between
kadonotakashi	0:8fdf9a60065b	1255	them. Therefore they can only be ran with LAN connectivity (Eth, Wifi or
kadonotakashi	0:8fdf9a60065b	1256	Mesh) or if there is no firewall between devices.
kadonotakashi	0:8fdf9a60065b	1257
kadonotakashi	0:8fdf9a60065b	1258
kadonotakashi	0:8fdf9a60065b	1259	### TCPSERVER_ACCEPT
kadonotakashi	0:8fdf9a60065b	1260
kadonotakashi	0:8fdf9a60065b	1261	Description:
kadonotakashi	0:8fdf9a60065b	1262
kadonotakashi	0:8fdf9a60065b	1263	Test that `TCPServer::bind()`, `TCPServer::listen()`
kadonotakashi	0:8fdf9a60065b	1264	and `TCPServer::accept()` works.
kadonotakashi	0:8fdf9a60065b	1265
kadonotakashi	0:8fdf9a60065b	1266	Requires 2 devices.
kadonotakashi	0:8fdf9a60065b	1267
kadonotakashi	0:8fdf9a60065b	1268	Preconditions:
kadonotakashi	0:8fdf9a60065b	1269
kadonotakashi	0:8fdf9a60065b	1270	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1271	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1272
kadonotakashi	0:8fdf9a60065b	1273	Test steps:
kadonotakashi	0:8fdf9a60065b	1274
kadonotakashi	0:8fdf9a60065b	1275	1. DUT1: `TCPServer::bind(<port>)`
kadonotakashi	0:8fdf9a60065b	1276	2. DUT1: `TCPServer::listen()`
kadonotakashi	0:8fdf9a60065b	1277	3. DUT1: Create a new `TCPSocket`
kadonotakashi	0:8fdf9a60065b	1278	4. DUT1: `TCPServer::accept()`
kadonotakashi	0:8fdf9a60065b	1279	5. DUT2: Create a new `TCPSocket`
kadonotakashi	0:8fdf9a60065b	1280	6. DUT2: `TCPSocket::connect(<dut1>, <port>)`
kadonotakashi	0:8fdf9a60065b	1281	7. DUT1: should receive new socket from accept(),
kadonotakashi	0:8fdf9a60065b	1282	call `TCPSocket::send("hello",5)` for it
kadonotakashi	0:8fdf9a60065b	1283	8. DUT2: call `TCPSocket::recv(buffer, 5)`
kadonotakashi	0:8fdf9a60065b	1284	9. DUT2: Verify that it received "hello"
kadonotakashi	0:8fdf9a60065b	1285	10. destroy all sockets.
kadonotakashi	0:8fdf9a60065b	1286
kadonotakashi	0:8fdf9a60065b	1287	Expected result:
kadonotakashi	0:8fdf9a60065b	1288
kadonotakashi	0:8fdf9a60065b	1289	On DUT1 accept() call blocks until connection is received. Other calls
kadonotakashi	0:8fdf9a60065b	1290	should return NSAPI_ERROR_OK
kadonotakashi	0:8fdf9a60065b	1291
kadonotakashi	0:8fdf9a60065b	1292	On DUT2 all calls should return NSAPI_ERROR_OK
kadonotakashi	0:8fdf9a60065b	1293
kadonotakashi	0:8fdf9a60065b	1294
kadonotakashi	0:8fdf9a60065b	1295
kadonotakashi	0:8fdf9a60065b	1296	### TCPSERVER_LISTEN
kadonotakashi	0:8fdf9a60065b	1297
kadonotakashi	0:8fdf9a60065b	1298	Description:
kadonotakashi	0:8fdf9a60065b	1299
kadonotakashi	0:8fdf9a60065b	1300	Test that `TCPServer::listen()` has the backlog functionality.
kadonotakashi	0:8fdf9a60065b	1301
kadonotakashi	0:8fdf9a60065b	1302	Requires 2 devices.
kadonotakashi	0:8fdf9a60065b	1303
kadonotakashi	0:8fdf9a60065b	1304	Preconditions:
kadonotakashi	0:8fdf9a60065b	1305
kadonotakashi	0:8fdf9a60065b	1306	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1307	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1308
kadonotakashi	0:8fdf9a60065b	1309	Test steps:
kadonotakashi	0:8fdf9a60065b	1310
kadonotakashi	0:8fdf9a60065b	1311	1. DUT1: `TCPServer::bind(<port>)`
kadonotakashi	0:8fdf9a60065b	1312	2. DUT1: `TCPServer::listen(2)`
kadonotakashi	0:8fdf9a60065b	1313	3. loop 2 times:
kadonotakashi	0:8fdf9a60065b	1314	1. DUT2: Create a new TCPSocket
kadonotakashi	0:8fdf9a60065b	1315	2. DUT2: `TCPSocket::connect(<dut1>, <port>)`
kadonotakashi	0:8fdf9a60065b	1316
kadonotakashi	0:8fdf9a60065b	1317	4. loop 2 times:
kadonotakashi	0:8fdf9a60065b	1318	1. DUT1: Create a new TCPSocket
kadonotakashi	0:8fdf9a60065b	1319	2. DUT1: `TCPServer::accept()`
kadonotakashi	0:8fdf9a60065b	1320	3. DUT1: should receive new socket from accept(),
kadonotakashi	0:8fdf9a60065b	1321	call `TCPSocket::send("hello",5)` for it
kadonotakashi	0:8fdf9a60065b	1322
kadonotakashi	0:8fdf9a60065b	1323	5. DUT2: call `TCPSocket::recv(buffer, 5)` for both socket.
kadonotakashi	0:8fdf9a60065b	1324	6. DUT2: Verify that it received "hello"
kadonotakashi	0:8fdf9a60065b	1325	7. destroy all sockets.
kadonotakashi	0:8fdf9a60065b	1326
kadonotakashi	0:8fdf9a60065b	1327	Expected result:
kadonotakashi	0:8fdf9a60065b	1328
kadonotakashi	0:8fdf9a60065b	1329	DUT2 should receive connection before the server have called accept(),
kadonotakashi	0:8fdf9a60065b	1330	because backlog must be minimum of 2.
kadonotakashi	0:8fdf9a60065b	1331
kadonotakashi	0:8fdf9a60065b	1332
kadonotakashi	0:8fdf9a60065b	1333	### TCPSERVER_LISTEN_WITHOUT_BIND
kadonotakashi	0:8fdf9a60065b	1334
kadonotakashi	0:8fdf9a60065b	1335	Description:
kadonotakashi	0:8fdf9a60065b	1336
kadonotakashi	0:8fdf9a60065b	1337	Call `TCPServer::listen()` without calling bind() first. Should fail,
kadonotakashi	0:8fdf9a60065b	1338	because no listening port have been defined.
kadonotakashi	0:8fdf9a60065b	1339
kadonotakashi	0:8fdf9a60065b	1340	Preconditions:
kadonotakashi	0:8fdf9a60065b	1341
kadonotakashi	0:8fdf9a60065b	1342	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1343	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1344
kadonotakashi	0:8fdf9a60065b	1345	Test steps:
kadonotakashi	0:8fdf9a60065b	1346
kadonotakashi	0:8fdf9a60065b	1347	1. Create TCPServer
kadonotakashi	0:8fdf9a60065b	1348	2. Call `TCPServer::listen()`
kadonotakashi	0:8fdf9a60065b	1349
kadonotakashi	0:8fdf9a60065b	1350	Expected result:
kadonotakashi	0:8fdf9a60065b	1351
kadonotakashi	0:8fdf9a60065b	1352	Should
kadonotakashi	0:8fdf9a60065b	1353	return NSAPI_ERROR_UNSUPPORTED, NSAPI_ERROR_PARAMETER, NSAPI_ERROR_NO_ADDRESS
kadonotakashi	0:8fdf9a60065b	1354	or NSAPI_ERROR_DEVICE_ERROR
kadonotakashi	0:8fdf9a60065b	1355
kadonotakashi	0:8fdf9a60065b	1356
kadonotakashi	0:8fdf9a60065b	1357	### TCPSERVER_ACCEPT_WITHOUT_LISTEN
kadonotakashi	0:8fdf9a60065b	1358
kadonotakashi	0:8fdf9a60065b	1359	Description:
kadonotakashi	0:8fdf9a60065b	1360
kadonotakashi	0:8fdf9a60065b	1361	Call `TCPServer::accept()` without calling listen() first. Should fail,
kadonotakashi	0:8fdf9a60065b	1362	because socket is not listening for connections.
kadonotakashi	0:8fdf9a60065b	1363
kadonotakashi	0:8fdf9a60065b	1364	Preconditions:
kadonotakashi	0:8fdf9a60065b	1365
kadonotakashi	0:8fdf9a60065b	1366	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1367	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1368
kadonotakashi	0:8fdf9a60065b	1369	Test steps:
kadonotakashi	0:8fdf9a60065b	1370
kadonotakashi	0:8fdf9a60065b	1371	1. Create TCPServer
kadonotakashi	0:8fdf9a60065b	1372	2. Call `TCPServer::bind(<unused port number>)`
kadonotakashi	0:8fdf9a60065b	1373	3. Create new TCPSocket.
kadonotakashi	0:8fdf9a60065b	1374	4. Call `TCPServer::accept()`
kadonotakashi	0:8fdf9a60065b	1375
kadonotakashi	0:8fdf9a60065b	1376	Expected result:
kadonotakashi	0:8fdf9a60065b	1377
kadonotakashi	0:8fdf9a60065b	1378	Should return NSAPI_ERROR_UNSUPPORTED, NSAPI_ERROR_PARAMETER
kadonotakashi	0:8fdf9a60065b	1379	or NSAPI_ERROR_DEVICE_ERROR
kadonotakashi	0:8fdf9a60065b	1380
kadonotakashi	0:8fdf9a60065b	1381
kadonotakashi	0:8fdf9a60065b	1382	Performance tests
kadonotakashi	0:8fdf9a60065b	1383	-----------------
kadonotakashi	0:8fdf9a60065b	1384
kadonotakashi	0:8fdf9a60065b	1385
kadonotakashi	0:8fdf9a60065b	1386	### UDPSOCKET_ECHOTEST_BURST
kadonotakashi	0:8fdf9a60065b	1387
kadonotakashi	0:8fdf9a60065b	1388	Description:
kadonotakashi	0:8fdf9a60065b	1389
kadonotakashi	0:8fdf9a60065b	1390	Send burst of packets to echo server and read incoming packets back.
kadonotakashi	0:8fdf9a60065b	1391
kadonotakashi	0:8fdf9a60065b	1392	Preconditions:
kadonotakashi	0:8fdf9a60065b	1393
kadonotakashi	0:8fdf9a60065b	1394	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1395	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1396	3. UDPSocket is open
kadonotakashi	0:8fdf9a60065b	1397
kadonotakashi	0:8fdf9a60065b	1398	Test steps:
kadonotakashi	0:8fdf9a60065b	1399
kadonotakashi	0:8fdf9a60065b	1400	1. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 100>, 100);`
kadonotakashi	0:8fdf9a60065b	1401	2. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 200>, 200);`
kadonotakashi	0:8fdf9a60065b	1402	3. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 300>, 300);`
kadonotakashi	0:8fdf9a60065b	1403	4. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 120>, 120);`
kadonotakashi	0:8fdf9a60065b	1404	5. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 500>, 500);`
kadonotakashi	0:8fdf9a60065b	1405	6. Wait for incomming packets for five second.
kadonotakashi	0:8fdf9a60065b	1406	7. Verify incomming content was the same that was sent. Allow
kadonotakashi	0:8fdf9a60065b	1407	packet reordering.
kadonotakashi	0:8fdf9a60065b	1408	8. Repeat 100 times
kadonotakashi	0:8fdf9a60065b	1409	9. destroy the socket
kadonotakashi	0:8fdf9a60065b	1410
kadonotakashi	0:8fdf9a60065b	1411	Expected result:
kadonotakashi	0:8fdf9a60065b	1412
kadonotakashi	0:8fdf9a60065b	1413	All sendto() calls should return the packet size.
kadonotakashi	0:8fdf9a60065b	1414
kadonotakashi	0:8fdf9a60065b	1415	All recvfrom() calls should return the same sized packet that was send
kadonotakashi	0:8fdf9a60065b	1416	with same content. Allow packet reordering.
kadonotakashi	0:8fdf9a60065b	1417
kadonotakashi	0:8fdf9a60065b	1418	Calculate packet loss rate, maximum tolerated packet loss rate is 30%
kadonotakashi	0:8fdf9a60065b	1419
kadonotakashi	0:8fdf9a60065b	1420	Calculate number of succesfull rounds, it should be higher than 70
kadonotakashi	0:8fdf9a60065b	1421
kadonotakashi	0:8fdf9a60065b	1422
kadonotakashi	0:8fdf9a60065b	1423	### UDPSOCKET_ECHOTEST_BURST_NONBLOCK
kadonotakashi	0:8fdf9a60065b	1424
kadonotakashi	0:8fdf9a60065b	1425	Description:
kadonotakashi	0:8fdf9a60065b	1426
kadonotakashi	0:8fdf9a60065b	1427	Send burst of packets to echo server and read incoming packets back. Use
kadonotakashi	0:8fdf9a60065b	1428	socket in non-blocking mode
kadonotakashi	0:8fdf9a60065b	1429
kadonotakashi	0:8fdf9a60065b	1430	Preconditions:
kadonotakashi	0:8fdf9a60065b	1431
kadonotakashi	0:8fdf9a60065b	1432	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1433	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1434	3. UDPSocket is open
kadonotakashi	0:8fdf9a60065b	1435
kadonotakashi	0:8fdf9a60065b	1436	Test steps:
kadonotakashi	0:8fdf9a60065b	1437
kadonotakashi	0:8fdf9a60065b	1438	1. Call `UDPSocket::set_blocking(false)`
kadonotakashi	0:8fdf9a60065b	1439	2. Register event handler with `UDPSocket::sigio()`
kadonotakashi	0:8fdf9a60065b	1440	3. Create another thread that constantly waits signal from sigio()
kadonotakashi	0:8fdf9a60065b	1441	handler, when received try `UDPSocket::recvfrom()`
kadonotakashi	0:8fdf9a60065b	1442	4. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 100>, 100);`
kadonotakashi	0:8fdf9a60065b	1443	5. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 200>, 200);`
kadonotakashi	0:8fdf9a60065b	1444	6. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 300>, 300);`
kadonotakashi	0:8fdf9a60065b	1445	7. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 120>, 120);`
kadonotakashi	0:8fdf9a60065b	1446	8. Call `UDPSocket:sendto("echo.mbedcloudtesting.com", 7, <random packet, size = 500>, 500);`
kadonotakashi	0:8fdf9a60065b	1447	9. Wait for incomming packets for five second.
kadonotakashi	0:8fdf9a60065b	1448	10. Verify incomming content was the same that was sent. Allow
kadonotakashi	0:8fdf9a60065b	1449	packet reordering.
kadonotakashi	0:8fdf9a60065b	1450	11. Repeat 100 times
kadonotakashi	0:8fdf9a60065b	1451	12. destroy the socket
kadonotakashi	0:8fdf9a60065b	1452
kadonotakashi	0:8fdf9a60065b	1453	Expected result:
kadonotakashi	0:8fdf9a60065b	1454
kadonotakashi	0:8fdf9a60065b	1455	All sendto() calls should return the packet size.
kadonotakashi	0:8fdf9a60065b	1456
kadonotakashi	0:8fdf9a60065b	1457	All recvfrom() calls should return the same sized packet that was send
kadonotakashi	0:8fdf9a60065b	1458	with same content. Allow packet reordering.
kadonotakashi	0:8fdf9a60065b	1459
kadonotakashi	0:8fdf9a60065b	1460	Calculate packet loss rate, maximum tolerated packet loss rate is 30%
kadonotakashi	0:8fdf9a60065b	1461
kadonotakashi	0:8fdf9a60065b	1462	Calculate number of succesfull rounds, it should be higher than 70
kadonotakashi	0:8fdf9a60065b	1463
kadonotakashi	0:8fdf9a60065b	1464
kadonotakashi	0:8fdf9a60065b	1465
kadonotakashi	0:8fdf9a60065b	1466	### TCPSOCKET_ECHOTEST_BURST
kadonotakashi	0:8fdf9a60065b	1467
kadonotakashi	0:8fdf9a60065b	1468	Description:
kadonotakashi	0:8fdf9a60065b	1469
kadonotakashi	0:8fdf9a60065b	1470	Send burst of packets to echo server and read incoming packets back.
kadonotakashi	0:8fdf9a60065b	1471
kadonotakashi	0:8fdf9a60065b	1472	Preconditions:
kadonotakashi	0:8fdf9a60065b	1473
kadonotakashi	0:8fdf9a60065b	1474	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1475	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1476	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	1477
kadonotakashi	0:8fdf9a60065b	1478	Test steps:
kadonotakashi	0:8fdf9a60065b	1479
kadonotakashi	0:8fdf9a60065b	1480	1. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 7);`
kadonotakashi	0:8fdf9a60065b	1481	2. Call `TCPSocket::send(<random packet, size = 100>, 100);`
kadonotakashi	0:8fdf9a60065b	1482	3. Call `TCPSocket::send(<random packet, size = 200>, 200);`
kadonotakashi	0:8fdf9a60065b	1483	4. Call `TCPSocket::send(<random packet, size = 300>, 300);`
kadonotakashi	0:8fdf9a60065b	1484	5. Call `TCPSocket::send(<random packet, size = 120>, 120);`
kadonotakashi	0:8fdf9a60065b	1485	6. Call `TCPSocket::send(<random packet, size = 500>, 500);`
kadonotakashi	0:8fdf9a60065b	1486	7. Call `TCPSocket::recv(buf, 1220)`
kadonotakashi	0:8fdf9a60065b	1487	8. Verify incomming content was the same that was sent.
kadonotakashi	0:8fdf9a60065b	1488	9. Repeat 100 times
kadonotakashi	0:8fdf9a60065b	1489	10. destroy the socket
kadonotakashi	0:8fdf9a60065b	1490
kadonotakashi	0:8fdf9a60065b	1491	Expected result:
kadonotakashi	0:8fdf9a60065b	1492
kadonotakashi	0:8fdf9a60065b	1493	All send() calls should return the packet size.
kadonotakashi	0:8fdf9a60065b	1494
kadonotakashi	0:8fdf9a60065b	1495	NOTE: This is stream so recv() might return less data than what was
kadonotakashi	0:8fdf9a60065b	1496	requested. In this case you need to keep calling recv() with remaining
kadonotakashi	0:8fdf9a60065b	1497	size until all data that you have sent is returned.
kadonotakashi	0:8fdf9a60065b	1498
kadonotakashi	0:8fdf9a60065b	1499	Consecutive calls to recv() should return all the data that has been
kadonotakashi	0:8fdf9a60065b	1500	send. Total amount of returned must match 1220.
kadonotakashi	0:8fdf9a60065b	1501
kadonotakashi	0:8fdf9a60065b	1502
kadonotakashi	0:8fdf9a60065b	1503	### TCPSOCKET_ECHOTEST_BURST_NONBLOCK
kadonotakashi	0:8fdf9a60065b	1504
kadonotakashi	0:8fdf9a60065b	1505	Description:
kadonotakashi	0:8fdf9a60065b	1506
kadonotakashi	0:8fdf9a60065b	1507	Send burst of packets to echo server and read incoming packets back. Use
kadonotakashi	0:8fdf9a60065b	1508	socket in non-blocking mode
kadonotakashi	0:8fdf9a60065b	1509
kadonotakashi	0:8fdf9a60065b	1510	Preconditions:
kadonotakashi	0:8fdf9a60065b	1511
kadonotakashi	0:8fdf9a60065b	1512	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1513	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1514	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	1515
kadonotakashi	0:8fdf9a60065b	1516	Test steps:
kadonotakashi	0:8fdf9a60065b	1517
kadonotakashi	0:8fdf9a60065b	1518	1. Register event handler with `TCPSocket::sigio()`
kadonotakashi	0:8fdf9a60065b	1519	2. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 7);`
kadonotakashi	0:8fdf9a60065b	1520	3. Call `TCPSocket::set_blocking(false)`
kadonotakashi	0:8fdf9a60065b	1521	4. Create another thread that constantly waits signal from sigio()
kadonotakashi	0:8fdf9a60065b	1522	handler, when received try `TCPSocket::recv()`
kadonotakashi	0:8fdf9a60065b	1523	5. For randomly generated packets, sized 100, 200, 300, 120 and 500 do
kadonotakashi	0:8fdf9a60065b	1524	1. Call `TCPSocket::send(packet, size);`
kadonotakashi	0:8fdf9a60065b	1525	2. If less than size is sent, repeat with remaining.
kadonotakashi	0:8fdf9a60065b	1526	3. If NSAPI_ERROR_WOULD_BLOCK returned, wait for next sigio()
kadonotakashi	0:8fdf9a60065b	1527
kadonotakashi	0:8fdf9a60065b	1528	6. Wait for incomming packets for five second.
kadonotakashi	0:8fdf9a60065b	1529	7. Verify incomming content was the same that was sent. Allow recv() to
kadonotakashi	0:8fdf9a60065b	1530	return smaller piezes.
kadonotakashi	0:8fdf9a60065b	1531	8. Repeat 100 times
kadonotakashi	0:8fdf9a60065b	1532	9. destroy the socket
kadonotakashi	0:8fdf9a60065b	1533
kadonotakashi	0:8fdf9a60065b	1534	Expected result:
kadonotakashi	0:8fdf9a60065b	1535
kadonotakashi	0:8fdf9a60065b	1536	All send() calls should return NSAPI_ERROR_WOULD_BLOCK or size which
kadonotakashi	0:8fdf9a60065b	1537	is equal or less than requested.
kadonotakashi	0:8fdf9a60065b	1538
kadonotakashi	0:8fdf9a60065b	1539	All recv() calls should return value that is less or equal to what have
kadonotakashi	0:8fdf9a60065b	1540	been sent. With consecutive calls, size should match.
kadonotakashi	0:8fdf9a60065b	1541
kadonotakashi	0:8fdf9a60065b	1542	When recv() returns NSAPI_ERROR_WOULD_BLOCK wait for next sigio()
kadonotakashi	0:8fdf9a60065b	1543	event. No other error codes allowed.
kadonotakashi	0:8fdf9a60065b	1544
kadonotakashi	0:8fdf9a60065b	1545
kadonotakashi	0:8fdf9a60065b	1546	### TCPSOCKET_RECV_100K
kadonotakashi	0:8fdf9a60065b	1547
kadonotakashi	0:8fdf9a60065b	1548	Description:
kadonotakashi	0:8fdf9a60065b	1549
kadonotakashi	0:8fdf9a60065b	1550	Download 100kB of data
kadonotakashi	0:8fdf9a60065b	1551
kadonotakashi	0:8fdf9a60065b	1552	Preconditions:
kadonotakashi	0:8fdf9a60065b	1553
kadonotakashi	0:8fdf9a60065b	1554	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1555	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1556	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	1557
kadonotakashi	0:8fdf9a60065b	1558	Test steps:
kadonotakashi	0:8fdf9a60065b	1559
kadonotakashi	0:8fdf9a60065b	1560	1. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 19);`
kadonotakashi	0:8fdf9a60065b	1561	2. Call `TCPSocket::recv(buffer, 100);`
kadonotakashi	0:8fdf9a60065b	1562	3. Verify input according to known pattern.
kadonotakashi	0:8fdf9a60065b	1563	4. Loop until 100kB of data received.
kadonotakashi	0:8fdf9a60065b	1564	5. close socket.
kadonotakashi	0:8fdf9a60065b	1565
kadonotakashi	0:8fdf9a60065b	1566	Expected result:
kadonotakashi	0:8fdf9a60065b	1567
kadonotakashi	0:8fdf9a60065b	1568	Each recv() call should return equal or less than 100 bytes of data. No
kadonotakashi	0:8fdf9a60065b	1569	errors should be returned.
kadonotakashi	0:8fdf9a60065b	1570
kadonotakashi	0:8fdf9a60065b	1571	Measure time taken for receiving, report speed
kadonotakashi	0:8fdf9a60065b	1572
kadonotakashi	0:8fdf9a60065b	1573	### TCPSOCKET_RECV_100K_NONBLOCK
kadonotakashi	0:8fdf9a60065b	1574
kadonotakashi	0:8fdf9a60065b	1575	Description:
kadonotakashi	0:8fdf9a60065b	1576
kadonotakashi	0:8fdf9a60065b	1577	Download 100kB of data
kadonotakashi	0:8fdf9a60065b	1578
kadonotakashi	0:8fdf9a60065b	1579	Preconditions:
kadonotakashi	0:8fdf9a60065b	1580
kadonotakashi	0:8fdf9a60065b	1581	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1582	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1583	3. TCPSocket is open
kadonotakashi	0:8fdf9a60065b	1584
kadonotakashi	0:8fdf9a60065b	1585	Test steps:
kadonotakashi	0:8fdf9a60065b	1586
kadonotakashi	0:8fdf9a60065b	1587	1. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 19);`
kadonotakashi	0:8fdf9a60065b	1588	2. Call `TCPSocket::set_blocking(false)`
kadonotakashi	0:8fdf9a60065b	1589	3. Create another thread that constantly waits signal from sigio()
kadonotakashi	0:8fdf9a60065b	1590	handler, when received try `TCPSocket::recv()`
kadonotakashi	0:8fdf9a60065b	1591	1. Call `TCPSocket::recv(buffer, 100);`
kadonotakashi	0:8fdf9a60065b	1592	2. Verify input according to known pattern.
kadonotakashi	0:8fdf9a60065b	1593
kadonotakashi	0:8fdf9a60065b	1594	4. Wait until 100kB of data received.
kadonotakashi	0:8fdf9a60065b	1595	5. close socket.
kadonotakashi	0:8fdf9a60065b	1596
kadonotakashi	0:8fdf9a60065b	1597	Expected result:
kadonotakashi	0:8fdf9a60065b	1598
kadonotakashi	0:8fdf9a60065b	1599	Each recv() call should return equal or less than 100 bytes of data or
kadonotakashi	0:8fdf9a60065b	1600	NSAPI_ERROR_WOULD_BLOCK in which case thread should wait for another
kadonotakashi	0:8fdf9a60065b	1601	sigio(). No errors should be returned.
kadonotakashi	0:8fdf9a60065b	1602
kadonotakashi	0:8fdf9a60065b	1603	Measure time taken for receiving, report speed
kadonotakashi	0:8fdf9a60065b	1604
kadonotakashi	0:8fdf9a60065b	1605	### TCPSOCKET_THREAD_PER_SOCKET_SAFETY
kadonotakashi	0:8fdf9a60065b	1606
kadonotakashi	0:8fdf9a60065b	1607	Description:
kadonotakashi	0:8fdf9a60065b	1608
kadonotakashi	0:8fdf9a60065b	1609	Run two threads which both exercise the underlying stack and driver
kadonotakashi	0:8fdf9a60065b	1610	through a dedicated socket
kadonotakashi	0:8fdf9a60065b	1611
kadonotakashi	0:8fdf9a60065b	1612	Preconditions:
kadonotakashi	0:8fdf9a60065b	1613
kadonotakashi	0:8fdf9a60065b	1614	1. Network interface and stack are initialised
kadonotakashi	0:8fdf9a60065b	1615	2. Network connection is up
kadonotakashi	0:8fdf9a60065b	1616	3. 2 TCPSockets are open and one additional thread has been created
kadonotakashi	0:8fdf9a60065b	1617	4. Both threads get their own socket instance
kadonotakashi	0:8fdf9a60065b	1618
kadonotakashi	0:8fdf9a60065b	1619	Test steps:
kadonotakashi	0:8fdf9a60065b	1620
kadonotakashi	0:8fdf9a60065b	1621	1. Call `TCPSocket::connect("echo.mbedcloudtesting.com", 7)`
kadonotakashi	0:8fdf9a60065b	1622	in both threads - in the main thread executing the test case and on
kadonotakashi	0:8fdf9a60065b	1623	the additional one;
kadonotakashi	0:8fdf9a60065b	1624	2. On main thread
kadonotakashi	0:8fdf9a60065b	1625	1. For randomly generated packets, sized 1001, 901, 801,...,101,1
kadonotakashi	0:8fdf9a60065b	1626	do
kadonotakashi	0:8fdf9a60065b	1627	1. Call `TCPSocket::send(packet, size);`
kadonotakashi	0:8fdf9a60065b	1628	2. Verify incoming content was the same that was sent.
kadonotakashi	0:8fdf9a60065b	1629	Allow recv() to return smaller piezes.
kadonotakashi	0:8fdf9a60065b	1630
kadonotakashi	0:8fdf9a60065b	1631	3. Simultaneously with the earlier step do on the additional thread
kadonotakashi	0:8fdf9a60065b	1632	1. For randomly generated packets, sized 10 do
kadonotakashi	0:8fdf9a60065b	1633	1. Call `TCPSocket::send(packet, size);`
kadonotakashi	0:8fdf9a60065b	1634	2. Verify incomming content was the same that was sent.
kadonotakashi	0:8fdf9a60065b	1635	Allow recv() to return smaller piezes.
kadonotakashi	0:8fdf9a60065b	1636	3. stop the thread if inconsistensies were found and report it
kadonotakashi	0:8fdf9a60065b	1637	to main thread
kadonotakashi	0:8fdf9a60065b	1638
kadonotakashi	0:8fdf9a60065b	1639	4. Kill the additional thread
kadonotakashi	0:8fdf9a60065b	1640	5. Close and destroy the sockets
kadonotakashi	0:8fdf9a60065b	1641
kadonotakashi	0:8fdf9a60065b	1642	Expected result:
kadonotakashi	0:8fdf9a60065b	1643
kadonotakashi	0:8fdf9a60065b	1644	Echo server returns data to both threads and received data matches to
kadonotakashi	0:8fdf9a60065b	1645	send data. The additional thread isn't stopped prematurely
kadonotakashi	0:8fdf9a60065b	1646
kadonotakashi	0:8fdf9a60065b	1647	Subset for driver test
kadonotakashi	0:8fdf9a60065b	1648	----------------------
kadonotakashi	0:8fdf9a60065b	1649
kadonotakashi	0:8fdf9a60065b	1650	### For physical layer driver (emac, PPP):
kadonotakashi	0:8fdf9a60065b	1651
kadonotakashi	0:8fdf9a60065b	1652	- TCPSERVER_ACCEPT
kadonotakashi	0:8fdf9a60065b	1653	- TCPSERVER_LISTEN
kadonotakashi	0:8fdf9a60065b	1654	- TCPSOCKET_ECHOTEST
kadonotakashi	0:8fdf9a60065b	1655	- TCPSOCKET_ECHOTEST_BURST
kadonotakashi	0:8fdf9a60065b	1656	- TCPSOCKET_ECHOTEST_BURST_NONBLOCK
kadonotakashi	0:8fdf9a60065b	1657	- TCPSOCKET_ECHOTEST_NONBLOCK
kadonotakashi	0:8fdf9a60065b	1658	- TCPSOCKET_RECV_100K
kadonotakashi	0:8fdf9a60065b	1659	- TCPSOCKET_RECV_100K_NONBLOCK
kadonotakashi	0:8fdf9a60065b	1660	- TCPSOCKET_RECV_TIMEOUT
kadonotakashi	0:8fdf9a60065b	1661	- TCPSOCKET_SEND_REPEAT
kadonotakashi	0:8fdf9a60065b	1662	- UDPSOCKET_BIND_SENDTO
kadonotakashi	0:8fdf9a60065b	1663	- UDPSOCKET_ECHOTEST
kadonotakashi	0:8fdf9a60065b	1664	- UDPSOCKET_ECHOTEST_NONBLOCK
kadonotakashi	0:8fdf9a60065b	1665	- UDPSOCKET_RECV_TIMEOUT
kadonotakashi	0:8fdf9a60065b	1666	- UDPSOCKET_SENDTO_INVALID
kadonotakashi	0:8fdf9a60065b	1667	- UDPSOCKET_SENDTO_REPEAT
kadonotakashi	0:8fdf9a60065b	1668	- UDPSOCKET_SENDTO_TIMEOUT
kadonotakashi	0:8fdf9a60065b	1669
kadonotakashi	0:8fdf9a60065b	1670	### For socket layer driver (AT-driven, external IP stack):
kadonotakashi	0:8fdf9a60065b	1671
kadonotakashi	0:8fdf9a60065b	1672	All Socket, UDPSocket, TCPSocket and TCPServer testcases.

Repository toolbox

Export to desktop IDE

Build repository

Repository details

Type:	Program
Mbed OS support:	Mbed OS
Created:	11 Oct 2018
Imports:	15
Forks:	0
Commits:	4
Dependents:	0
Dependencies:	1
Followers:	1

mbed-os/TESTS/netsocket/README.md@0:8fdf9a60065b, 2018-10-10 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning