[dts] [PATCH] test_plans: Add unit_tests_loopback_test_plan

[dts] [PATCH] test_plans: Add unit_tests_loopback_test_plan

[Peng Yuan]

Add unit_tests_loopback_test_plan.rst to test_plans

Signed-off-by: Peng Yuan <yuan.peng@intel.com>

diff --git a/test_plans/unit_tests_loopback_test_plan.rst b/test_plans/unit_tests_loopback_test_plan.rst
new file mode 100644
index 0000000..fe5498d
--- /dev/null
+++ b/test_plans/unit_tests_loopback_test_plan.rst
@@ -0,0 +1,86 @@
+.. Copyright (c) <2014-2017>, Intel Corporation
+   All rights reserved.
+
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+   - Redistributions of source code must retain the above copyright
+     notice, this list of conditions and the following disclaimer.
+
+   - Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in
+     the documentation and/or other materials provided with the
+     distribution.
+
+   - Neither the name of Intel Corporation nor the names of its
+     contributors may be used to endorse or promote products derived
+     from this software without specific prior written permission.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+   FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+   COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+   (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+   SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+   HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+   STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+   OF THE POSSIBILITY OF SUCH DAMAGE.
+
+====================================
+Unit Tests: single port MAC loopback
+====================================
+
+According to loopback mode, setup loopback link or not.
+If loopback mode is setted, packets will be sent to rx_q from tx_q directly.
+Else if loopback mode is disabled, packets will sent to peer port from tx_q. 
+Loopback mode can be used to support testing task.
+
+
+Prerequisites
+=============
+
+Two 40Gb Ethernet ports of the DUT are directly connected and link is up.
+
+
+single port MAC loopback
+========================
+
+This is the test plan for unit test to verify if XL710 can enable single port
+mac loopback.
+
+1. enable loopback mode:
+In dpdk/test/test/test_pmd_perf.c
+set::
+
+    .lpbk_mode=1
+    #define MAX_TRAFFIC_BURST              32
+
+then make test
+start test::
+
+    ./test/test/test -c f -n 4 -- -i
+    RTE>>pmd_perf_autotest
+
+The final output of the test will be matrix of average cycles of IO used per
+packet, and "Test OK" is printed out.
+the peer port can't receive any packet.
+
+2. disable lookback mode:
+In dpdk/test/test/test_pmd_perf.c
+set::
+
+    .lpbk_mode=0
+    #define MAX_TRAFFIC_BURST              32
+
+then make test
+start test::
+
+    ./test/test/test -c f -n 4 -- -i
+    RTE>>pmd_perf_autotest
+
+there is not "Test OK" presented.
+the peer port can receive all the 32 packets.
-- 
2.5.0

Re: [dts] [PATCH] test_plans: Add unit_tests_loopback_test_plan

[Tu, Lijuan]

Comments inline

> -----Original Message-----
> From: dts [mailto:dts-bounces@dpdk.org] On Behalf Of Peng Yuan
> Sent: Thursday, September 27, 2018 4:45 PM
> To: dts@dpdk.org
> Cc: Peng, Yuan <yuan.peng@intel.com>
> Subject: [dts] [PATCH] test_plans: Add unit_tests_loopback_test_plan
> 
> Add unit_tests_loopback_test_plan.rst to test_plans
> 
> Signed-off-by: Peng Yuan <yuan.peng@intel.com>
> 
> diff --git a/test_plans/unit_tests_loopback_test_plan.rst
> b/test_plans/unit_tests_loopback_test_plan.rst
> new file mode 100644
> index 0000000..fe5498d
> --- /dev/null
> +++ b/test_plans/unit_tests_loopback_test_plan.rst
> @@ -0,0 +1,86 @@
> +.. Copyright (c) <2014-2017>, Intel Corporation
> +   All rights reserved.
> +
> +   Redistribution and use in source and binary forms, with or without
> +   modification, are permitted provided that the following conditions
> +   are met:
> +
> +   - Redistributions of source code must retain the above copyright
> +     notice, this list of conditions and the following disclaimer.
> +
> +   - Redistributions in binary form must reproduce the above copyright
> +     notice, this list of conditions and the following disclaimer in
> +     the documentation and/or other materials provided with the
> +     distribution.
> +
> +   - Neither the name of Intel Corporation nor the names of its
> +     contributors may be used to endorse or promote products derived
> +     from this software without specific prior written permission.
> +
> +   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
> CONTRIBUTORS
> +   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
> NOT
> +   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
> FITNESS
> +   FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
> THE
> +   COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
> INDIRECT,
> +   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
> +   (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
> GOODS OR
> +   SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
> INTERRUPTION)
> +   HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
> CONTRACT,
> +   STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
> +   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
> ADVISED
> +   OF THE POSSIBILITY OF SUCH DAMAGE.
> +
> +====================================
> +Unit Tests: single port MAC loopback
> +====================================
> +
> +According to loopback mode, setup loopback link or not.
> +If loopback mode is setted, packets will be sent to rx_q from tx_q directly.
> +Else if loopback mode is disabled, packets will sent to peer port from tx_q.
> +Loopback mode can be used to support testing task.
> +
> +
> +Prerequisites
> +=============
> +
> +Two 40Gb Ethernet ports of the DUT are directly connected and link is up.
[Lijuan] I think it support more NICs, Could you clarify the topology?
> +
> +
> +single port MAC loopback
> +========================
> +
> +This is the test plan for unit test to verify if XL710 can enable
> +single port mac loopback.
> +
> +1. enable loopback mode:
> +In dpdk/test/test/test_pmd_perf.c
> +set::
> +
> +    .lpbk_mode=1
> +    #define MAX_TRAFFIC_BURST              32
> +
> +then make test
> +start test::
> +
> +    ./test/test/test -c f -n 4 -- -i
> +    RTE>>pmd_perf_autotest
> +
> +The final output of the test will be matrix of average cycles of IO
> +used per packet, and "Test OK" is printed out.
> +the peer port can't receive any packet.
> +
> +2. disable lookback mode:
> +In dpdk/test/test/test_pmd_perf.c
> +set::
> +
> +    .lpbk_mode=0
> +    #define MAX_TRAFFIC_BURST              32
> +
> +then make test
> +start test::
> +
> +    ./test/test/test -c f -n 4 -- -i
> +    RTE>>pmd_perf_autotest
> +
> +there is not "Test OK" presented.
> +the peer port can receive all the 32 packets.
> --
> 2.5.0