From: Akhil Goyal <akhil.goyal@nxp.com> To: Nicolas Chautru <nicolas.chautru@intel.com>, "thomas@monjalon.net" <thomas@monjalon.net>, "dev@dpdk.org" <dev@dpdk.org> Cc: "ferruh.yigit@intel.com" <ferruh.yigit@intel.com> Subject: Re: [dpdk-dev] [PATCH v3 11/14] doc: update of testbbdev documentation Date: Wed, 25 Mar 2020 14:48:48 +0000 Message-ID: <VE1PR04MB66391E0B179C379BE4C64796E6CE0@VE1PR04MB6639.eurprd04.prod.outlook.com> (raw) In-Reply-To: <1583348102-13253-12-git-send-email-nicolas.chautru@intel.com> > > From: Nic Chautru <nicolas.chautru@intel.com> > > Update related to the changes introduced by the > previous commits. > > Signed-off-by: Nic Chautru <nicolas.chautru@intel.com> > --- Please split this patch and merge the relevant sections in the respective patches. And it would be better to add reference to the Standards which were followed. > doc/guides/tools/testbbdev.rst | 337 > +++++++++++++++++++++++++++++++++++------ > 1 file changed, 291 insertions(+), 46 deletions(-) > > diff --git a/doc/guides/tools/testbbdev.rst b/doc/guides/tools/testbbdev.rst > index 7e95696..016f3f9 100644 > --- a/doc/guides/tools/testbbdev.rst > +++ b/doc/guides/tools/testbbdev.rst > @@ -6,9 +6,9 @@ dpdk-test-bbdev Application > > The ``dpdk-test-bbdev`` tool is a Data Plane Development Kit (DPDK) utility that > allows measuring performance parameters of PMDs available in the bbdev > framework. > -Available tests available for execution are: latency, throughput, validation and > -sanity tests. Execution of tests can be customized using various parameters > -passed to a python running script. > +Available tests available for execution are: latency, throughput, validation, > +bler and sanity tests. Execution of tests can be customized using various > +parameters passed to a python running script. > > Compiling the Application > ------------------------- > @@ -47,6 +47,8 @@ The tool application has a number of command line > options: > [-c TEST_CASE [TEST_CASE ...]] > [-v TEST_VECTOR [TEST_VECTOR...]] [-n NUM_OPS] > [-b BURST_SIZE [BURST_SIZE ...]] [-l NUM_LCORES] > + [-t MAX_ITERS [MAX_ITERS ...]] > + [-s SNR [SNR ...]] > > command-line Options > ~~~~~~~~~~~~~~~~~~~~ > @@ -106,10 +108,18 @@ The following are the command-line options: > Specifies operations enqueue/dequeue burst size. If not specified burst_size is > set to 32. Maximum is 512. > > +``-t MAX_ITERS [MAX_ITERS ...], --iter_max MAX_ITERS [MAX_ITERS ...]`` > + Specifies LDPC decoder operations maximum number of iterations for > throughput > + and bler tests. If not specified iter_max is set to 6. > + > +``-s SNR [SNR ...], --snr SNR [SNR ...]`` > + Specifies for LDPC decoder operations the SNR in dB used when generating > LLRs > + for bler tests. If not specified snr is set to 0 dB. > + > Test Cases > ~~~~~~~~~~ > > -There are 6 main test cases that can be executed using testbbdev tool: > +There are 7 main test cases that can be executed using testbbdev tool: > > * Sanity checks [-c unittest] > - Performs sanity checks on BBDEV interface, validating basic functionality > @@ -149,6 +159,11 @@ There are 6 main test cases that can be executed using > testbbdev tool: > - Results are printed in million operations per second and million bits > per second > > +* BLER measurement [-c bler] > + - Performs full operation of enqueue and dequeue > + - Measures the achieved throughput on a subset or all available CPU cores > + - Computed BLER in % based on the total number of operations. > + Full form of BLER/LDPC should be explained atleast once > * Interrupt-mode Throughput [-c interrupt] > - Similar to Throughput test case, but using interrupts. No polling. > > @@ -159,7 +174,7 @@ Parameter Globbing > Thanks to the globbing functionality in python test-bbdev.py script allows to > run tests with different set of vector files without giving all of them explicitly. > > -**Example usage:** > +**Example usage for 4G:** > > .. code-block:: console > > @@ -221,6 +236,11 @@ It runs all tests with "default" vectors. > * ``turbo_enc_default.data`` is a soft link to > ``turbo_enc_c1_k6144_r0_e32256_crc24b_rm.data`` > > +* ``ldpc_dec_default.data`` is a soft link to > + ``ldpc_dec_v6563.data`` > + > +* ``ldpc_enc_default.data`` is a soft link to > + ``ldpc_enc_c1_k8148_r0_e9372_rm.data`` > > Running Tests > ------------- > @@ -254,6 +274,38 @@ x86_64-native-linux-icc target: > |-- turbo_dec_c1_k6144_r0_e34560_posllr.data > |-- turbo_enc_c1_k40_r0_e1194_rm.data > |-- turbo_enc_c1_k6144_r0_e32256_crc24b_rm.data > + |-- ldpc_enc_v9503.data > + |-- ldpc_enc_v8568.data > + |-- ldpc_enc_v7813.data > + |-- ldpc_enc_v2342.data > + |-- ldpc_enc_v11835.data > + |-- ldpc_dec_v8568.data > + |-- ldpc_dec_v8480.data > + |-- ldpc_dec_v7813.data > + |-- ldpc_dec_v2342_drop.data > + |-- ldpc_dec_v11835.data > + |-- ldpc_dec_HARQ_1_2.data > + |-- ldpc_dec_HARQ_1_1.data > + |-- ldpc_dec_HARQ_1_0.data > + |-- ldpc_enc_v8568_crc24a.data > + |-- ldpc_enc_v3964_rv1.data > + |-- ldpc_enc_c1_k8148_r0_e9372_rm.data > + |-- ldpc_enc_c1_k720_r0_e864_rm_crc24b.data > + |-- ldpc_enc_c1_k720_r0_e832_rm.data > + |-- ldpc_enc_c1_k330_r0_e360_rm.data > + |-- ldpc_enc_c1_k1144_r0_e1380_rm_crc24b.data > + |-- ldpc_enc_c1_k1144_r0_e1380_rm.data > + |-- ldpc_dec_vcrc_fail.data > + |-- ldpc_dec_v8568_low.data > + |-- ldpc_dec_v14298.data > + |-- ldpc_dec_HARQ_26449_1.loopback_w > + |-- ldpc_dec_HARQ_1_3.data > + |-- ldpc_enc_v2570_lbrm.data > + |-- ldpc_dec_v9503.data > + |-- ldpc_dec_v6563.data > + |-- ldpc_dec_HARQ_3_1_harq_comp.data > + |-- ldpc_dec_HARQ_2_1_llr_comp.data > + |-- ldpc_dec_HARQ_26449_1.loopback_r > It would be better to explain somewhere about these different types Of tests or atleast a reference about what they are for. ' > |-- x86_64-native-linux-icc > |-- app > @@ -280,7 +332,7 @@ baseband turbo_sw device > > ./test-bbdev.py -p ../../x86_64-native-linux-icc/app/testbbdev > -e="--vdev=baseband_turbo_sw" -t 120 -c validation > - -v ./test_vectors/turbo_* -n 64 -b 8 32 > + -v ./test_vectors/* -n 64 -b 8 32 > > -- ``RTE_BBDEV_TURBO_RV_INDEX_BYPASS`` > +Chain of operation statuses that are expected after operation is performed. > +Following statuses can be used: > > -- ``RTE_BBDEV_TURBO_RATE_MATCH`` > +- ``DMA`` > > -- ``RTE_BBDEV_TURBO_CRC_24B_ATTACH`` > +- ``FCW`` > > -- ``RTE_BBDEV_TURBO_CRC_24A_ATTACH`` > +- ``OK`` > > -- ``RTE_BBDEV_TURBO_ENC_SCATTER_GATHER`` > +``OK`` means no errors are expected. Cannot be used with other values. > > -``RTE_BBDEV_TURBO_ENC_SCATTER_GATHER`` is used to indicate the parser > to > -force the input data to be memory split and formed as a segmented mbuf. Explanation for each status should be explained here. > +.. parsed-literal:: > + > + expected_status = > + OK > +Example: > + > + .. parsed-literal:: > + > + op_flags = > + RTE_BBDEV_LDPC_ITERATION_STOP_ENABLE, > RTE_BBDEV_LDPC_HQ_COMBINE_OUT_ENABLE, > + RTE_BBDEV_LDPC_HQ_COMBINE_IN_ENABLE, > RTE_BBDEV_LDPC_HARQ_6BIT_COMPRESSION > + > +Chain of operation statuses that are expected after operation is performed. > +Following statuses can be used: > + > +- ``SYNCRC`` Explanation missing for these statuses. > + > +- ``SYN`` > + > +- ``CRC`` > + > +- ``OK`` > + > +``OK`` means no errors are expected. Cannot be used with other values. > + > +.. parsed-literal:: > + > + expected_status = > + CRC > +
next prev parent reply other threads:[~2020-03-25 14:48 UTC|newest] Thread overview: 115+ messages / expand[flat|nested] mbox.gz Atom feed top 2020-02-27 4:38 [dpdk-dev] [PATCH v1 00/14] bbdev new features Nicolas Chautru 2020-02-27 4:38 ` [dpdk-dev] [PATCH v1 01/14] bbdev: add capability flag for filler bits inclusion in HARQ Nicolas Chautru 2020-02-27 4:38 ` [dpdk-dev] [PATCH v1 02/14] bbdev: expose device HARQ buffer size at device level Nicolas Chautru 2020-02-27 4:38 ` [dpdk-dev] [PATCH v1 03/14] baseband/turbo_sw: fix the exposed LLR decimals assumption Nicolas Chautru 2020-02-27 4:38 ` [dpdk-dev] [PATCH v1 04/14] baseband/turbo_sw: support large size code block Nicolas Chautru 2020-02-27 4:38 ` [dpdk-dev] [PATCH v1 05/14] test-bbdev: rename FPGA LTE macros to be more explicit Nicolas Chautru 2020-02-27 4:39 ` [dpdk-dev] [PATCH v1 06/14] test-bbdev: support HARQ validation Nicolas Chautru 2020-02-27 4:39 ` [dpdk-dev] [PATCH v1 07/14] test-bbdev: support for performance tests Nicolas Chautru 2020-02-27 4:39 ` [dpdk-dev] [PATCH v1 08/14] test-bbdev: support for LDPC interrupt test Nicolas Chautru 2020-02-27 4:39 ` [dpdk-dev] [PATCH v1 09/14] test-bbdev: support for offload test for LDPC Nicolas Chautru 2020-02-27 4:39 ` [dpdk-dev] [PATCH v1 10/14] test-bbdev: vectors update Nicolas Chautru 2020-02-27 4:39 ` [dpdk-dev] [PATCH v1 11/14] doc: update of testbbdev documentation Nicolas Chautru 2020-02-27 4:39 ` [dpdk-dev] [PATCH v1 12/14] drivers/baseband: add PMD for FPGA 5GNR FEC Nicolas Chautru 2020-02-27 4:39 ` [dpdk-dev] [PATCH v1 13/14] test-bbdev: add support for FPGA driver initialization Nicolas Chautru 2020-02-27 4:39 ` [dpdk-dev] [PATCH v1 14/14] doc: add feature matrix table for bbdev devices Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 00/15] bbdev new features Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 01/15] bbdev: add capability flag for filler bits inclusion in HARQ Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 02/15] bbdev: expose device HARQ buffer size at device level Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 03/15] baseband/turbo_sw: fix the exposed LLR decimals assumption Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 04/15] baseband/turbo_sw: support large size code block Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 05/15] test-bbdev: rename FPGA LTE macros to be more explicit Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 06/15] test-bbdev: support HARQ validation Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 07/15] test-bbdev: support for performance tests Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 08/15] test-bbdev: support for LDPC interrupt test Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 09/15] test-bbdev: support for offload test for LDPC Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 10/15] test-bbdev: vectors update Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 11/15] doc: update of testbbdev documentation Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 12/15] drivers/baseband: add PMD for FPGA 5GNR FEC Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 13/15] test-bbdev: add support for FPGA driver initialization Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 14/15] doc: add feature matrix table for bbdev devices Nicolas Chautru 2020-03-04 18:22 ` [dpdk-dev] [PATCH v2 15/15] doc: add release note for bbdev PMD update Nicolas Chautru 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 00/14] bbdev new features Nicolas Chautru 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 01/14] bbdev: add capability flag for filler bits inclusion in HARQ Nicolas Chautru 2020-03-13 10:42 ` Dave Burley 2020-03-25 9:53 ` Akhil Goyal 2020-03-26 2:47 ` Chautru, Nicolas 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 02/14] bbdev: expose device HARQ buffer size at device level Nicolas Chautru 2020-03-13 10:47 ` Dave Burley 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 03/14] baseband/turbo_sw: fix the exposed LLR decimals assumption Nicolas Chautru 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 04/14] baseband/turbo_sw: support large size code block Nicolas Chautru 2020-03-13 16:10 ` Dave Burley 2020-03-25 10:18 ` Akhil Goyal 2020-03-26 2:50 ` Chautru, Nicolas 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 05/14] test-bbdev: rename FPGA LTE macros to be more explicit Nicolas Chautru 2020-03-13 10:55 ` Dave Burley 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 06/14] test-bbdev: support HARQ validation Nicolas Chautru 2020-03-25 13:23 ` Akhil Goyal 2020-03-26 2:53 ` Chautru, Nicolas 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 07/14] test-bbdev: support for performance tests Nicolas Chautru 2020-03-13 10:58 ` Dave Burley 2020-03-25 13:47 ` Akhil Goyal 2020-03-26 2:56 ` Chautru, Nicolas 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 08/14] test-bbdev: support for LDPC interrupt test Nicolas Chautru 2020-03-13 10:59 ` Dave Burley 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 09/14] test-bbdev: support for offload test for LDPC Nicolas Chautru 2020-03-25 13:54 ` Akhil Goyal 2020-03-26 2:57 ` Chautru, Nicolas 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 10/14] test-bbdev: vectors update Nicolas Chautru 2020-03-13 11:02 ` Dave Burley 2020-03-25 13:58 ` Akhil Goyal 2020-03-26 2:59 ` Chautru, Nicolas 2020-03-04 18:54 ` [dpdk-dev] [PATCH v3 11/14] doc: update of testbbdev documentation Nicolas Chautru 2020-03-13 11:03 ` Dave Burley 2020-03-25 14:48 ` Akhil Goyal [this message] 2020-03-26 3:02 ` Chautru, Nicolas 2020-03-04 18:55 ` [dpdk-dev] [PATCH v3 12/14] drivers/baseband: add PMD for FPGA 5GNR FEC Nicolas Chautru 2020-03-13 11:03 ` Dave Burley 2020-03-25 14:59 ` Akhil Goyal 2020-03-26 3:16 ` Chautru, Nicolas 2020-03-26 5:27 ` Akhil Goyal 2020-03-30 0:09 ` Chautru, Nicolas 2020-03-04 18:55 ` [dpdk-dev] [PATCH v3 13/14] test-bbdev: add support for FPGA driver initialization Nicolas Chautru 2020-03-13 11:05 ` Dave Burley 2020-03-04 18:55 ` [dpdk-dev] [PATCH v3 14/14] doc: add feature matrix table for bbdev devices Nicolas Chautru 2020-03-13 11:05 ` Dave Burley 2020-03-12 20:10 ` [dpdk-dev] [PATCH v3 00/14] bbdev new features Chautru, Nicolas 2020-03-13 7:15 ` Akhil Goyal 2020-03-24 23:47 ` Chautru, Nicolas 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 00/10] " Nicolas Chautru 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 01/10] bbdev: add capability flag for filler bits inclusion in HARQ Nicolas Chautru 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 02/10] bbdev: expose device HARQ buffer size at device level Nicolas Chautru 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 03/10] baseband/turbo_sw: fix the exposed LLR decimals assumption Nicolas Chautru 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 04/10] baseband/turbo_sw: support large size code block Nicolas Chautru 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 05/10] test-bbdev: rename FPGA LTE macros to be more explicit Nicolas Chautru 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 06/10] test-bbdev: support HARQ validation Nicolas Chautru 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 07/10] test-bbdev: support for performance tests Nicolas Chautru 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 08/10] test-bbdev: support for LDPC interrupt test Nicolas Chautru 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 09/10] test-bbdev: support for offload test for LDPC Nicolas Chautru 2020-03-26 2:45 ` [dpdk-dev] [PATCH v4 10/10] test-bbdev: vectors update Nicolas Chautru 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 00/10] bbdev new features Nicolas Chautru 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 01/10] bbdev: add capability flag for filler bits inclusion in HARQ Nicolas Chautru 2020-03-27 11:44 ` Dave Burley 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 02/10] bbdev: expose device HARQ buffer size at device level Nicolas Chautru 2020-03-27 11:45 ` Dave Burley 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 03/10] baseband/turbo_sw: fix the exposed LLR decimals assumption Nicolas Chautru 2020-03-27 11:45 ` Dave Burley 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 04/10] baseband/turbo_sw: support large size code block Nicolas Chautru 2020-03-27 11:45 ` Dave Burley 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 05/10] test-bbdev: rename FPGA LTE macros to be more explicit Nicolas Chautru 2020-03-27 11:45 ` Dave Burley 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 06/10] test-bbdev: support HARQ validation Nicolas Chautru 2020-03-27 11:47 ` Dave Burley 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 07/10] test-bbdev: support for performance tests Nicolas Chautru 2020-03-27 11:47 ` Dave Burley 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 08/10] test-bbdev: support for LDPC interrupt test Nicolas Chautru 2020-03-27 11:47 ` Dave Burley 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 09/10] test-bbdev: support for offload test for LDPC Nicolas Chautru 2020-03-27 11:47 ` Dave Burley 2020-03-26 3:27 ` [dpdk-dev] [PATCH v5 10/10] test-bbdev: vectors update Nicolas Chautru 2020-03-27 11:47 ` Dave Burley 2020-03-27 11:43 ` [dpdk-dev] [PATCH v5 00/10] bbdev new features Dave Burley 2020-04-05 16:41 ` Akhil Goyal 2020-03-03 18:08 ` [dpdk-dev] [PATCH v1 00/14] " Chautru, Nicolas 2020-03-04 8:23 ` Thomas Monjalon 2020-03-04 18:28 ` Chautru, Nicolas
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=VE1PR04MB66391E0B179C379BE4C64796E6CE0@VE1PR04MB6639.eurprd04.prod.outlook.com \ --to=akhil.goyal@nxp.com \ --cc=dev@dpdk.org \ --cc=ferruh.yigit@intel.com \ --cc=nicolas.chautru@intel.com \ --cc=thomas@monjalon.net \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: link
DPDK patches and discussions This inbox may be cloned and mirrored by anyone: git clone --mirror http://inbox.dpdk.org/dev/0 dev/git/0.git # If you have public-inbox 1.1+ installed, you may # initialize and index your mirror using the following commands: public-inbox-init -V2 dev dev/ http://inbox.dpdk.org/dev \ dev@dpdk.org public-inbox-index dev Example config snippet for mirrors. Newsgroup available over NNTP: nntp://inbox.dpdk.org/inbox.dpdk.dev AGPL code for this site: git clone https://public-inbox.org/public-inbox.git