From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id BF6AFA058B; Wed, 25 Mar 2020 15:48:51 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 9A4672C15; Wed, 25 Mar 2020 15:48:50 +0100 (CET) Received: from EUR01-VE1-obe.outbound.protection.outlook.com (mail-eopbgr140072.outbound.protection.outlook.com [40.107.14.72]) by dpdk.org (Postfix) with ESMTP id 1079A2BCE for ; Wed, 25 Mar 2020 15:48:49 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=dgJ4SFGgnBjqRdqaykguqL8gHRKawdOj4bIarAr4x/JTF0xPa58RW/2pMAAYVkVkjDJn/lO6LYPWdFqxLj8Yfjjerd6Tuzx3y2L7C+0XhefDdy/RtS57Dk60ANgjRpntCLkOfbkJX8325fUpDB5kOyFSW1jwX28DDNs/mLWhoPI3RNjjdh2/oCsrJrJeIktq01BgtwR5SQ+rV61UH0IA5uaYpunknO7qNYf9zmdqYqdLx9I9iZL0ASDq1pogaiSsI39c0b/L8uscvhC8Jrs50897qGRaJhXunvOB31l+qdobTMAE2Ek7lJpCZYWm1nvaFnw3TNOxOL53ad/CLijBtw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=08tydv1LkzY6MsH70zleDm6AmBHtdFSBtPBCrxGMUz8=; b=Z4Xq7DctpiwUV9riRXvOCl6Ji4v3KW4R0leoAraci/UGHi4Nik9AuM1iTLeXMmGSoCTSgLwj+TaevIXuqI3BlUnVOcK+LTvMeedCrILr5xxRFN+UFTa6cetz6MK9lrXKY6EDV/5rroBFksc+WOZSD+JfHs+ZzGoKAcflQnQpPSh5DRAh5yJMgWM8W2kAS6xTUnYRWe7/R117THVr6/qDWguhtRmu1MiI7D8OXjaCcPMXR4NK081LuIzzd1e+Yo0VgjYsMgPwn34trmbyBYgM5qlqasAJ2U0LRVEJLcHvPIshyEFYaTLSN9QQxAb0D+LufLNfYXXPKP4FeBDINEpn9g== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=08tydv1LkzY6MsH70zleDm6AmBHtdFSBtPBCrxGMUz8=; b=F1mboJ+3QpcMMLb+0+wiNFEywvZXpyXTQPtdMBPmdPg2UeU629jC4kdRfsScL9XPbZvnC9W8HDzG/Ze8s/B+vB4R4ChnDXRAORIO1EfnSNKsDcOFsiIQLEo3Gf1c3QGiZkaEJyoXP91DUvpYyIA5O1uNNn92jCr+uLt6MKT8g/Y= Received: from VE1PR04MB6639.eurprd04.prod.outlook.com (10.255.118.11) by VE1PR04MB6432.eurprd04.prod.outlook.com (20.179.234.85) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2835.22; Wed, 25 Mar 2020 14:48:48 +0000 Received: from VE1PR04MB6639.eurprd04.prod.outlook.com ([fe80::8060:a35c:4858:c490]) by VE1PR04MB6639.eurprd04.prod.outlook.com ([fe80::8060:a35c:4858:c490%7]) with mapi id 15.20.2835.023; Wed, 25 Mar 2020 14:48:48 +0000 From: Akhil Goyal To: Nicolas Chautru , "thomas@monjalon.net" , "dev@dpdk.org" CC: "ferruh.yigit@intel.com" Thread-Topic: [PATCH v3 11/14] doc: update of testbbdev documentation Thread-Index: AQHV8lZ0TsOYX0wwmEahSJUi3jRzn6hZgDNA Date: Wed, 25 Mar 2020 14:48:48 +0000 Message-ID: References: <1582778348-113547-15-git-send-email-nicolas.chautru@intel.com> <1583348102-13253-1-git-send-email-nicolas.chautru@intel.com> <1583348102-13253-12-git-send-email-nicolas.chautru@intel.com> In-Reply-To: <1583348102-13253-12-git-send-email-nicolas.chautru@intel.com> Accept-Language: en-IN, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: spf=none (sender IP is ) smtp.mailfrom=akhil.goyal@nxp.com; x-originating-ip: [45.118.166.74] x-ms-publictraffictype: Email x-ms-office365-filtering-ht: Tenant x-ms-office365-filtering-correlation-id: d175a756-181a-43fb-0b43-08d7d0cba049 x-ms-traffictypediagnostic: VE1PR04MB6432: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:3044; x-forefront-prvs: 0353563E2B x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(4636009)(366004)(346002)(136003)(376002)(396003)(39860400002)(4326008)(186003)(66946007)(26005)(66476007)(55016002)(33656002)(478600001)(52536014)(2906002)(9686003)(8936002)(110136005)(44832011)(8676002)(81166006)(6506007)(81156014)(66556008)(5660300002)(76116006)(316002)(66446008)(64756008)(7696005)(71200400001)(15650500001)(86362001); DIR:OUT; SFP:1101; SCL:1; SRVR:VE1PR04MB6432; H:VE1PR04MB6639.eurprd04.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; received-spf: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: tomgJ4EfsnaUK+t6Qsior/8pbwQhaECVPVIc+ua2CspGyg1L/aDOIHADY7/QjRH8QnnISaVbpPP5pBCgiW0XAJFmEQrqtentsAFTZPHHR5yoxtiuFxe85uvFwQF3XCOFABOmPxhAlbT2/rQMqEon7dIfMK7tVOld6CBGszmR+WzFJuEVz7XYVTScNChOSql5nbnfC663SU5G1RLl3AtrBlA5s9nYhSyth6S8tl78dUPle+y9C1NGxkXs9TnUwmt5AVKVYtfVKAzj+xw07zxYVx73hXavFMo+rWNFRyByGk5vuDyP5luo2crBFLIW9Ps9ePgJIahUdF9Yk4Pk6JVY6Rr/cvHEC+3uWIEyozKRrCZ3h1ijHbbh5rNsbnj1tt3ywbP0+tjnWtu9G0U3tvqlcOezJL+Ne48LV0K7BS8bC+UG/eAMuU0E+VfccnUOafx7 x-ms-exchange-antispam-messagedata: CGB/j0IW1UE7tW1nxsYFtpoNktEDOIN2mJlq6eZ6g0YhM3DVhpECr+saG6Te3eZY04KXfkZdn0CvneCYAupeJob4bOLfThPXkc9fFl57dePB9iClqS6b/xJUHtsOIlmklk49lqcOWEqvcO2eQo70Aw== x-ms-exchange-transport-forked: True Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: d175a756-181a-43fb-0b43-08d7d0cba049 X-MS-Exchange-CrossTenant-originalarrivaltime: 25 Mar 2020 14:48:48.1245 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: WP9E1nDLLvnD3yWxRNTlceFej7PknDK3q8KYWIqHLYePm4c7cHgfwGc26Ay4aFYvNXK3rzlLSOOxqmtq3QUYGA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: VE1PR04MB6432 Subject: Re: [dpdk-dev] [PATCH v3 11/14] doc: update of testbbdev documentation X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" >=20 > From: Nic Chautru >=20 > Update related to the changes introduced by the > previous commits. >=20 > Signed-off-by: Nic Chautru > --- Please split this patch and merge the relevant sections in the respective p= atches. And it would be better to add reference to the Standards which were followe= d. > doc/guides/tools/testbbdev.rst | 337 > +++++++++++++++++++++++++++++++++++------ > 1 file changed, 291 insertions(+), 46 deletions(-) >=20 > 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 >=20 > The ``dpdk-test-bbdev`` tool is a Data Plane Development Kit (DPDK) util= ity that > allows measuring performance parameters of PMDs available in the bbdev > framework. > -Available tests available for execution are: latency, throughput, valida= tion and > -sanity tests. Execution of tests can be customized using various paramet= ers > -passed to a python running script. > +Available tests available for execution are: latency, throughput, valida= tion, > +bler and sanity tests. Execution of tests can be customized using variou= s > +parameters passed to a python running script. >=20 > 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 ...]] >=20 > 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. >=20 > +``-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 generatin= g > LLRs > + for bler tests. If not specified snr is set to 0 dB. > + > Test Cases > ~~~~~~~~~~ >=20 > -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: >=20 > * Sanity checks [-c unittest] > - Performs sanity checks on BBDEV interface, validating basic functi= onality > @@ -149,6 +159,11 @@ There are 6 main test cases that can be executed usi= ng > testbbdev tool: > - Results are printed in million operations per second and million b= its > per second >=20 > +* 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. >=20 > @@ -159,7 +174,7 @@ Parameter Globbing > Thanks to the globbing functionality in python test-bbdev.py script allo= ws to > run tests with different set of vector files without giving all of them = explicitly. >=20 > -**Example usage:** > +**Example usage for 4G:** >=20 > .. code-block:: console >=20 > @@ -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`` >=20 > +* ``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`` >=20 > 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 >=20 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 >=20 > ./test-bbdev.py -p ../../x86_64-native-linux-icc/app/testbbdev > -e=3D"--vdev=3Dbaseband_turbo_sw" -t 120 -c validation > - -v ./test_vectors/turbo_* -n 64 -b 8 32 > + -v ./test_vectors/* -n 64 -b 8 32 >=20 > -- ``RTE_BBDEV_TURBO_RV_INDEX_BYPASS`` > +Chain of operation statuses that are expected after operation is perform= ed. > +Following statuses can be used: >=20 > -- ``RTE_BBDEV_TURBO_RATE_MATCH`` > +- ``DMA`` >=20 > -- ``RTE_BBDEV_TURBO_CRC_24B_ATTACH`` > +- ``FCW`` >=20 > -- ``RTE_BBDEV_TURBO_CRC_24A_ATTACH`` > +- ``OK`` >=20 > -- ``RTE_BBDEV_TURBO_ENC_SCATTER_GATHER`` > +``OK`` means no errors are expected. Cannot be used with other values. >=20 > -``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 =3D > + OK > +Example: > + > + .. parsed-literal:: > + > + op_flags =3D > + 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 perform= ed. > +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 =3D > + CRC > +