DPDK patches and discussions
 help / color / mirror / Atom feed
* [dpdk-dev] [PATCH v2] doc: add reference to bbdev companion configuration tool
@ 2020-11-02 20:53 Nicolas Chautru
  2020-11-02 20:53 ` [dpdk-dev] [PATCH v2] doc: add reference to " Nicolas Chautru
  0 siblings, 1 reply; 6+ messages in thread
From: Nicolas Chautru @ 2020-11-02 20:53 UTC (permalink / raw)
  To: dev, akhil.goyal, thomas
  Cc: john.mcnamara, trix, david.marchand, bruce.richardson,
	tianjiao.liu, Nicolas Chautru

v2: typo corrections
Adding reference to companion tool to perform PF device configuration of HW bbdev devices : pf_bb_config This topic was previously discussed in https://patches.dpdk.org/patch/74270/
and it was preferred for the tool to be be upstreamed outside of DPDK in github.
This dependency notably allows to run the bbdev workload from VF.
Kept this as a single commit affecting the 3 distinct docs.


Nicolas Chautru (1):
  doc: add reference to companion configuration tool

 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(+)

-- 
1.8.3.1


^ permalink raw reply	[flat|nested] 6+ messages in thread

* [dpdk-dev] [PATCH v2] doc: add reference to companion configuration tool
  2020-11-02 20:53 [dpdk-dev] [PATCH v2] doc: add reference to bbdev companion configuration tool Nicolas Chautru
@ 2020-11-02 20:53 ` Nicolas Chautru
  2020-11-03 15:06   ` Tom Rix
  0 siblings, 1 reply; 6+ messages in thread
From: Nicolas Chautru @ 2020-11-02 20:53 UTC (permalink / raw)
  To: dev, akhil.goyal, thomas
  Cc: john.mcnamara, trix, david.marchand, bruce.richardson,
	tianjiao.liu, Nicolas Chautru

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 <nicolas.chautru@intel.com>
---
 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..a1b3e33 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


^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [dpdk-dev] [PATCH v2] doc: add reference to companion configuration tool
  2020-11-02 20:53 ` [dpdk-dev] [PATCH v2] doc: add reference to " Nicolas Chautru
@ 2020-11-03 15:06   ` Tom Rix
  2020-11-03 15:58     ` Chautru, Nicolas
  0 siblings, 1 reply; 6+ messages in thread
From: Tom Rix @ 2020-11-03 15:06 UTC (permalink / raw)
  To: Nicolas Chautru, dev, akhil.goyal, thomas
  Cc: john.mcnamara, david.marchand, bruce.richardson, tianjiao.liu


On 11/2/20 12:53 PM, Nicolas Chautru wrote:
> 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 <nicolas.chautru@intel.com>
> ---
>  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..a1b3e33 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

From inspection, pf_bb_config does not care about the case of FPGA_lte

However for documentation, it is best if these examples are consistent.

So this should be

./pf_bb_config FPGA_LTE ...

Tom


> +  ./test-bbdev.py -e="-c 0xff0 -w${VF_PCI_ADDR}" -c validation -n 64 -b 32 -l 1 -v ./turbo_dec_default.data


^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [dpdk-dev] [PATCH v2] doc: add reference to companion configuration tool
  2020-11-03 15:06   ` Tom Rix
@ 2020-11-03 15:58     ` Chautru, Nicolas
  2020-11-03 19:07       ` Tom Rix
  0 siblings, 1 reply; 6+ messages in thread
From: Chautru, Nicolas @ 2020-11-03 15:58 UTC (permalink / raw)
  To: Tom Rix, dev, akhil.goyal, thomas
  Cc: Mcnamara, John, david.marchand, Richardson, Bruce, Liu, Tianjiao



> -----Original Message-----
> From: Tom Rix <trix@redhat.com>
> Sent: Tuesday, November 3, 2020 7:07 AM
> To: Chautru, Nicolas <nicolas.chautru@intel.com>; dev@dpdk.org;
> akhil.goyal@nxp.com; thomas@monjalon.net
> Cc: Mcnamara, John <john.mcnamara@intel.com>;
> david.marchand@redhat.com; Richardson, Bruce
> <bruce.richardson@intel.com>; Liu, Tianjiao <tianjiao.liu@intel.com>
> Subject: Re: [PATCH v2] doc: add reference to companion configuration tool
> 
> 
> On 11/2/20 12:53 PM, Nicolas Chautru wrote:
> > 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 <nicolas.chautru@intel.com>
> > ---
> >  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..a1b3e33 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
> 
> From inspection, pf_bb_config does not care about the case of FPGA_lte

What do you mean?

> 
> However for documentation, it is best if these examples are consistent.
> 
> So this should be
> 
> ./pf_bb_config FPGA_LTE ...
> 
> Tom
> 
> 
> > +  ./test-bbdev.py -e="-c 0xff0 -w${VF_PCI_ADDR}" -c validation -n 64
> > + -b 32 -l 1 -v ./turbo_dec_default.data


^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [dpdk-dev] [PATCH v2] doc: add reference to companion configuration tool
  2020-11-03 15:58     ` Chautru, Nicolas
@ 2020-11-03 19:07       ` Tom Rix
  2020-11-03 19:34         ` Chautru, Nicolas
  0 siblings, 1 reply; 6+ messages in thread
From: Tom Rix @ 2020-11-03 19:07 UTC (permalink / raw)
  To: Chautru, Nicolas, dev, akhil.goyal, thomas
  Cc: Mcnamara, John, david.marchand, Richardson, Bruce, Liu, Tianjiao


On 11/3/20 7:58 AM, Chautru, Nicolas wrote:
>
>> -----Original Message-----
>> From: Tom Rix <trix@redhat.com>
>> Sent: Tuesday, November 3, 2020 7:07 AM
>> To: Chautru, Nicolas <nicolas.chautru@intel.com>; dev@dpdk.org;
>> akhil.goyal@nxp.com; thomas@monjalon.net
>> Cc: Mcnamara, John <john.mcnamara@intel.com>;
>> david.marchand@redhat.com; Richardson, Bruce
>> <bruce.richardson@intel.com>; Liu, Tianjiao <tianjiao.liu@intel.com>
>> Subject: Re: [PATCH v2] doc: add reference to companion configuration tool
>>
>>
>> On 11/2/20 12:53 PM, Nicolas Chautru wrote:
>>> 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 <nicolas.chautru@intel.com>
>>> ---
>>>  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
>>> +
>>> +  
>>> + ./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..a1b3e33 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
>> From inspection, pf_bb_config does not care about the case of FPGA_lte
> What do you mean?
comparing the call examples in the doc

./pf_bb_config ACC100 -c acc100/acc100_config_vf_5g.cfg
./pf_bb_config FPGA_5GNR -c fpga_5gnr/fpga_5gnr_config_vf.cfg
./pf_bb_config FPGA_lte -c fpga_lte/fpga_lte_config_vf.cfg

For consistency, the last should use FPGA_LTE

Tom

>
>> However for documentation, it is best if these examples are consistent.
>>
>> So this should be
>>
>> ./pf_bb_config FPGA_LTE ...
>>
>> Tom
>>
>>
>>> +  ./test-bbdev.py -e="-c 0xff0 -w${VF_PCI_ADDR}" -c validation -n 64
>>> + -b 32 -l 1 -v ./turbo_dec_default.data


^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [dpdk-dev] [PATCH v2] doc: add reference to companion configuration tool
  2020-11-03 19:07       ` Tom Rix
@ 2020-11-03 19:34         ` Chautru, Nicolas
  0 siblings, 0 replies; 6+ messages in thread
From: Chautru, Nicolas @ 2020-11-03 19:34 UTC (permalink / raw)
  To: Tom Rix, dev, akhil.goyal, thomas
  Cc: Mcnamara, John, david.marchand, Richardson, Bruce, Liu, Tianjiao



> -----Original Message-----
> From: Tom Rix <trix@redhat.com>
> Sent: Tuesday, November 3, 2020 11:08 AM
> To: Chautru, Nicolas <nicolas.chautru@intel.com>; dev@dpdk.org;
> akhil.goyal@nxp.com; thomas@monjalon.net
> Cc: Mcnamara, John <john.mcnamara@intel.com>;
> david.marchand@redhat.com; Richardson, Bruce
> <bruce.richardson@intel.com>; Liu, Tianjiao <tianjiao.liu@intel.com>
> Subject: Re: [PATCH v2] doc: add reference to companion configuration tool
> 
> 
> On 11/3/20 7:58 AM, Chautru, Nicolas wrote:
> >
> >> -----Original Message-----
> >> From: Tom Rix <trix@redhat.com>
> >> Sent: Tuesday, November 3, 2020 7:07 AM
> >> To: Chautru, Nicolas <nicolas.chautru@intel.com>; dev@dpdk.org;
> >> akhil.goyal@nxp.com; thomas@monjalon.net
> >> Cc: Mcnamara, John <john.mcnamara@intel.com>;
> >> david.marchand@redhat.com; Richardson, Bruce
> >> <bruce.richardson@intel.com>; Liu, Tianjiao <tianjiao.liu@intel.com>
> >> Subject: Re: [PATCH v2] doc: add reference to companion configuration
> >> tool
> >>
> >>
> >> On 11/2/20 12:53 PM, Nicolas Chautru wrote:
> >>> 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 <nicolas.chautru@intel.com>
> >>> ---
> >>>  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
> >>> +
> >>> +
> >>> + ./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..a1b3e33 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
> >> From inspection, pf_bb_config does not care about the case of
> >> FPGA_lte
> > What do you mean?
> comparing the call examples in the doc
> 
> ./pf_bb_config ACC100 -c acc100/acc100_config_vf_5g.cfg ./pf_bb_config
> FPGA_5GNR -c fpga_5gnr/fpga_5gnr_config_vf.cfg ./pf_bb_config FPGA_lte -c
> fpga_lte/fpga_lte_config_vf.cfg
> 
> For consistency, the last should use FPGA_LTE

Ok you are just referring to the casing. Fair enough can change now. 

> 
> Tom
> 
> >
> >> However for documentation, it is best if these examples are consistent.
> >>
> >> So this should be
> >>
> >> ./pf_bb_config FPGA_LTE ...
> >>
> >> Tom
> >>
> >>
> >>> +  ./test-bbdev.py -e="-c 0xff0 -w${VF_PCI_ADDR}" -c validation -n
> >>> + 64 -b 32 -l 1 -v ./turbo_dec_default.data


^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2020-11-03 19:34 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-11-02 20:53 [dpdk-dev] [PATCH v2] doc: add reference to bbdev companion configuration tool Nicolas Chautru
2020-11-02 20:53 ` [dpdk-dev] [PATCH v2] doc: add reference to " Nicolas Chautru
2020-11-03 15:06   ` Tom Rix
2020-11-03 15:58     ` Chautru, Nicolas
2020-11-03 19:07       ` Tom Rix
2020-11-03 19:34         ` Chautru, Nicolas

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).