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 5B037A04E7; Mon, 2 Nov 2020 21:01:50 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id B6B112D41; Mon, 2 Nov 2020 21:01:35 +0100 (CET) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by dpdk.org (Postfix) with ESMTP id 5364423D for ; Mon, 2 Nov 2020 21:01:33 +0100 (CET) IronPort-SDR: jRDNqrRiKZuJtPUU5mPnLMc8O4FD39x4GX9g/MkcDkE+7kyvY9O1/cl7wwX52q/QiL+Zke5WA7 zbFOf3qg3Cbg== X-IronPort-AV: E=McAfee;i="6000,8403,9793"; a="168160261" X-IronPort-AV: E=Sophos;i="5.77,445,1596524400"; d="scan'208";a="168160261" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 02 Nov 2020 12:01:29 -0800 IronPort-SDR: RsBz4Py91TB/MGUPzox6L3ieFEFZzeWmQZPkm4IlSUWcZ3YyfYzqAJa7aU30MTTn7ZYKkSjGNa iMJWW8I/pBbA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.77,445,1596524400"; d="scan'208";a="305805488" Received: from skx-5gnr-sc12-4.sc.intel.com ([172.25.69.210]) by fmsmga007.fm.intel.com with ESMTP; 02 Nov 2020 12:01:29 -0800 From: Nicolas Chautru To: dev@dpdk.org, akhil.goyal@nxp.com, thomas@monjalon.net Cc: john.mcnamara@intel.com, trix@redhat.com, david.marchand@redhat.com, bruce.richardson@intel.com, tianjiao.liu@intel.com, Nicolas Chautru Date: Mon, 2 Nov 2020 12:00:58 -0800 Message-Id: <1604347258-20546-2-git-send-email-nicolas.chautru@intel.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1604347258-20546-1-git-send-email-nicolas.chautru@intel.com> References: <1604347258-20546-1-git-send-email-nicolas.chautru@intel.com> Subject: [dpdk-dev] [PATCH] doc: add reference to companion configuration tool 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" Adding reference to pf_bb_config in github to do device configuration of the fpga_5gnr, fpga_lte and acc100 devices and pmds. Signed-off-by: Nicolas Chautru --- doc/guides/bbdevs/acc100.rst | 19 +++++++++++++++++++ doc/guides/bbdevs/fpga_5gnr_fec.rst | 19 +++++++++++++++++++ doc/guides/bbdevs/fpga_lte_fec.rst | 19 +++++++++++++++++++ 3 files changed, 57 insertions(+) diff --git a/doc/guides/bbdevs/acc100.rst b/doc/guides/bbdevs/acc100.rst index 7a23c16..3cbdabf 100644 --- a/doc/guides/bbdevs/acc100.rst +++ b/doc/guides/bbdevs/acc100.rst @@ -223,3 +223,22 @@ In addition to the simple LDPC decoder and LDPC encoder tests, bbdev also provid a range of additional tests under the test_vectors folder, which may be useful. The results of these tests will depend on the ACC100 5G/4G FEC capabilities which may cause some testcases to be skipped, but no failure should be reported. + + +Alternate Baseband Device configuration tool +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +On top of the embedded configuration feature supported in test-bbdev using "- -init-device" +option mentioned above, there is also a tool available to perform that device configuration +using a companion application. +The ``pf_bb_config`` application notably enables then to run bbdev-test from the VF +and not only limited to the the PF as captured above. + +See for more details: https://github.com/intel/pf-bb-config + +Specifically for the BBDEV ACC100 PMD, the command below can be used: + +.. code-block:: console + + ./pf_bb_config ACC100 -c acc100/acc100_config_vf_5g.cfg + ./test-bbdev.py -e="-c 0xff0 -w${VF_PCI_ADDR}" -c validation -n 64 -b 32 -l 1 -v ./ldpc_dec_default.data diff --git a/doc/guides/bbdevs/fpga_5gnr_fec.rst b/doc/guides/bbdevs/fpga_5gnr_fec.rst index 61c19c3..58ea141 100644 --- a/doc/guides/bbdevs/fpga_5gnr_fec.rst +++ b/doc/guides/bbdevs/fpga_5gnr_fec.rst @@ -286,3 +286,22 @@ Test Vectors In addition to the simple LDPC decoder and LDPC encoder tests, bbdev also provides a range of additional tests under the test_vectors folder, which may be useful. The results of these tests will depend on the FPGA 5GNR FEC capabilities. + + +Alternate Baseband Device configuration tool +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +On top of the embedded configuration feature supported in test-bbdev using "- -init-device" +option, there is also a tool available to perform that device configuration using a companion +application. +The ``pf_bb_config`` application notably enables then to run bbdev-test from the VF +and not only limited to the the PF as captured above. + +See for more details: https://github.com/intel/pf-bb-config + +Specifically for the BBDEV FPGA 5GNR FEC PMD, the command below can be used: + +.. code-block:: console + + ./pf_bb_config FPGA_5GNR -c fpga_5gnr/fpga_5gnr_config_vf.cfg + ./test-bbdev.py -e="-c 0xff0 -w${VF_PCI_ADDR}" -c validation -n 64 -b 32 -l 1 -v ./ldpc_dec_default.data diff --git a/doc/guides/bbdevs/fpga_lte_fec.rst b/doc/guides/bbdevs/fpga_lte_fec.rst index 9d64e15..7bfd628 100644 --- a/doc/guides/bbdevs/fpga_lte_fec.rst +++ b/doc/guides/bbdevs/fpga_lte_fec.rst @@ -305,3 +305,22 @@ of these tests will depend on the FPGA LTE FEC capabilities: - ``turbo_enc_c2_k5952_r0_e17868_crc24b.data`` - ``turbo_enc_c3_k4800_r2_e14412_crc24b.data`` - ``turbo_enc_c4_k4800_r2_e14412_crc24b.data`` + + +Alternate Baseband Device configuration tool +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +On top of the embedded configuration feature supported in test-bbdev using "- -init-device" +option, there is also a tool available to perform that device configuration using a companion +application. +The ``pf_bb_config`` application notably enables then to run bbdev-test from the VF +and not only limited to the the PF as captured above. + +See for more details: https://github.com/intel/pf-bb-config + +Specifically for the BBDEV FPGA LTE FEC PMD, the command below can be used: + +.. code-block:: console + + ./pf_bb_config FPGA_lte -c fpga_lte/fpga_lte_config_vf.cfg + ./test-bbdev.py -e="-c 0xff0 -w${VF_PCI_ADDR}" -c validation -n 64 -b 32 -l 1 -v ./turbo_dec_default.data -- 1.8.3.1