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 11E55A04E7; Tue, 3 Nov 2020 20:40:35 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 464A56889; Tue, 3 Nov 2020 20:40:20 +0100 (CET) Received: from mga07.intel.com (mga07.intel.com [134.134.136.100]) by dpdk.org (Postfix) with ESMTP id 0CEC55AB7 for ; Tue, 3 Nov 2020 20:40:16 +0100 (CET) IronPort-SDR: i7xLM2VuffRHI+hAiTRmfjJfcWj3PyGvLyCPoOZ1xgrmhLldLz5ouvD+9fb7FdPZUeiuxVwu9w kZU1Xd6ImTbg== X-IronPort-AV: E=McAfee;i="6000,8403,9794"; a="233280766" X-IronPort-AV: E=Sophos;i="5.77,448,1596524400"; d="scan'208";a="233280766" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga003.jf.intel.com ([10.7.209.27]) by orsmga105.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 03 Nov 2020 11:40:14 -0800 IronPort-SDR: CTLvKOWJLE2RjS+b4/jN3aKKadcBVvzdMGKWv2uX4B50hglD+3xvHZ66cxQN5AqBvwAj2w8dSg qhXzDC+AZT3g== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.77,448,1596524400"; d="scan'208";a="320553659" Received: from skx-5gnr-sc12-4.sc.intel.com ([172.25.69.210]) by orsmga003.jf.intel.com with ESMTP; 03 Nov 2020 11:40:14 -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: Tue, 3 Nov 2020 11:39:36 -0800 Message-Id: <1604432376-28515-2-git-send-email-nicolas.chautru@intel.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1604432376-28515-1-git-send-email-nicolas.chautru@intel.com> References: <1604432376-28515-1-git-send-email-nicolas.chautru@intel.com> Subject: [dpdk-dev] [PATCH v3] 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..b772854 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 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..78c1ce7 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 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..f0a05c9 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 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