[dts] [PATCH] test_plans: Add unit_tests_loopback_test_plan

[Tu, Lijuan]

Comments inline

> -----Original Message-----
> From: dts [mailto:dts-bounces at dpdk.org] On Behalf Of Peng Yuan
> Sent: Thursday, September 27, 2018 4:45 PM
> To: dts at dpdk.org
> Cc: Peng, Yuan <yuan.peng at 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 at 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