alex/esp-idf
alex/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2024-10-05 20:47:46 -04:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
esp-idf/examples/system/network_tests
History
Angus Gratton 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 
Apply the pre-commit hook whitespace fixes to all files in the repo.

(Line endings, blank lines at end of file, trailing whitespace)
2020-11-11 07:36:35 +00:00
..
main
Whitespace: Automated whitespace fixes (large commit)
2020-11-11 07:36:35 +00:00
CMakeLists.txt
ci: added standard set of network suite for lwip as a part of weekend test
2019-06-04 08:27:53 +02:00
Makefile
Whitespace: Automated whitespace fixes (large commit)
2020-11-11 07:36:35 +00:00
README.md
esp_netif: update netsuite test example to use I/O driver configuration
2019-12-16 19:38:01 +00:00

README.md

Intel net test suite for LwIP network stack

This project provides a test interface to esp32 network stack in order to execute standard set of Intel network test suite defined in TTCN3 framework.

Important notice

This is an internal ESP-IDF test and not a user project example

Execute net test suite

These network tests could be executed in both manual or automated mode in CI.

Note: TTCN3 engine works reliably only on Linux and Windows.

Setup TTCN3

  • Clone a repository https://github.com/intel/net-test-suites.git and install titan core as described in the README.md
  • Copy files esp32_netsuite.cfg and esp32_netsuite.ttcn (located in $IDF_PATH/components/lwip/weekend_test) to src subdir of the cloned repository net-test-suites
  • Rebuild the netsuite tests (according to README.md in net-test-suite) by executing source make.sh in src subdir

Build application

cd $IDF_PATH/examples/system/network_tests
idf.py build
idf.py -p PORT flash

Run test

Open two terminals (1) and (2)

  1. Start the test server which would pass packets from TTCN3 test suite into ESP32 board in $IDF_PATH/components/lwip/weekend_test
python net_suite_test.py
  1. Start test suite in TTCN3 environment in src subdir of the cloned repository net-test-suites.git
ttcn3_start test_suite esp32_netsuite.cfg

Internal connection

Purpose of this test is to execute standard network suite on a ESP32 network stack.

DUT, Device (Network stack in this case) under test, runs normally on target, but a specific interface with configured esp-netif for passing arbitrary data to and from the network stack. Embedded code net_suite.c implements an application which serves stdin/stdout and propagates the data to/from this test interface.

Standard Intel net suite executed by TTCN3 engine uses udp ports for input/ouput of network packets. Python script net_suite.py translates this communication from/to those udp ports to stdin/stdout, where after propagating over USB/UART to the ESP32 board are processed in the network stack (on the target).

Actual test execution, progress, evaluation and test reporting is done using standard net-test-suite scripts running on PC.

  PC
+---------------------------------------------------------+       ESP32 board
|                                                         |    +----------------------------------------+
|  TTCN3 engine                                           |    |  +----------------------------------+  |
|                                                         |    |  | net_suite.c                      |  |
| +-----------------+            +--------------+         |    |  |         +------------------------+  |
| | net-test-suite  |--7777/udp--| net_suite.py |--stdout---------| ----->  | esp_netif / lwip       |  |
| |                 |--7771/udp--|              |--stdin----------| <-----  |                        |  |
| +-----------------+            +--------------+         |    |  +---------+------------------------+  |
+---------------------------------------------------------+    +----------------------------------------+