[dpdk-dev] doc: update bbdev library documentation

Message ID 20180404140602.9344-1-kamilx.chalupnik@intel.com (mailing list archive)
State Superseded, archived
Delegated to: Pablo de Lara Guarch
Headers

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation success Compilation OK

Commit Message

Kamil Chalupnik April 4, 2018, 2:05 p.m. UTC
  From: "Chalupnik, KamilX" <kamilx.chalupnik@intel.com>

Update the documentation describing Wireless Basband Device:
- device capabilities updated
- input/output data buffers description added
- details about implementation of turbo encode/decode
  operation added
- images presenting CB/TB processing by turbo encoder/decoder
  added

Signed-off-by: KamilX Chalupnik <kamilx.chalupnik@intel.com>
---
 doc/guides/prog_guide/bbdev.rst               | 247 +++++++++++++++++++++++---
 doc/guides/prog_guide/img/turbo_tb_decode.png | Bin 0 -> 43552 bytes
 doc/guides/prog_guide/img/turbo_tb_encode.png | Bin 0 -> 46944 bytes
 3 files changed, 222 insertions(+), 25 deletions(-)
 create mode 100644 doc/guides/prog_guide/img/turbo_tb_decode.png
 create mode 100644 doc/guides/prog_guide/img/turbo_tb_encode.png

diff --git a/doc/guides/prog_guide/img/turbo_tb_decode.png b/doc/guides/prog_guide/img/turbo_tb_decode.png
new file mode 100644
index 0000000000000000000000000000000000000000..fe999cecf4b3f8a36ceb122445c3abb8af082958
GIT binary patch
literal 43552
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

literal 0
HcmV?d00001

diff --git a/doc/guides/prog_guide/img/turbo_tb_encode.png b/doc/guides/prog_guide/img/turbo_tb_encode.png
new file mode 100644
index 0000000000000000000000000000000000000000..bd50c62014a29364921f4b599c1e38537b61beef
GIT binary patch
literal 46944
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

literal 0
HcmV?d00001
  

Comments

Mokhtar, Amr April 13, 2018, 7:30 p.m. UTC | #1
> -----Original Message-----

> From: Chalupnik, KamilX

> Sent: Wednesday 4 April 2018 15:06

> To: dev@dpdk.org

> Cc: Mokhtar, Amr <amr.mokhtar@intel.com>; Chalupnik, KamilX

> <kamilx.chalupnik@intel.com>

> Subject: [PATCH] doc: update bbdev library documentation

> 

> From: "Chalupnik, KamilX" <kamilx.chalupnik@intel.com>

> 

> Update the documentation describing Wireless Basband Device:

> - device capabilities updated

> - input/output data buffers description added

> - details about implementation of turbo encode/decode

>   operation added

> - images presenting CB/TB processing by turbo encoder/decoder

>   added

> 

> Signed-off-by: KamilX Chalupnik <kamilx.chalupnik@intel.com>


Acked-by: Amr Mokhtar <amr.mokhtar@intel.com>
  
De Lara Guarch, Pablo April 19, 2018, 2:29 p.m. UTC | #2
> -----Original Message-----

> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Mokhtar, Amr

> Sent: Friday, April 13, 2018 8:31 PM

> To: Chalupnik, KamilX <kamilx.chalupnik@intel.com>; dev@dpdk.org

> Subject: Re: [dpdk-dev] [PATCH] doc: update bbdev library documentation

> 

> 

> > -----Original Message-----

> > From: Chalupnik, KamilX

> > Sent: Wednesday 4 April 2018 15:06

> > To: dev@dpdk.org

> > Cc: Mokhtar, Amr <amr.mokhtar@intel.com>; Chalupnik, KamilX

> > <kamilx.chalupnik@intel.com>

> > Subject: [PATCH] doc: update bbdev library documentation

> >

> > From: "Chalupnik, KamilX" <kamilx.chalupnik@intel.com>

> >

> > Update the documentation describing Wireless Basband Device:

> > - device capabilities updated

> > - input/output data buffers description added

> > - details about implementation of turbo encode/decode

> >   operation added

> > - images presenting CB/TB processing by turbo encoder/decoder

> >   added

> >

> > Signed-off-by: KamilX Chalupnik <kamilx.chalupnik@intel.com>

> 

> Acked-by: Amr Mokhtar <amr.mokhtar@intel.com>


Applied to dpdk-next-crypto.
Thanks,

Pablo
  
Thomas Monjalon April 22, 2018, 8:17 p.m. UTC | #3
Hi,

04/04/2018 16:05, KamilX Chalupnik:
> From: "Chalupnik, KamilX" <kamilx.chalupnik@intel.com>

The above line will appear as the author name in Git.
Please make sure it is the same as the Signed-off-by line.
Usually, we use FirstName LastName, without any comma.


> Update the documentation describing Wireless Basband Device:
> - device capabilities updated
> - input/output data buffers description added
> - details about implementation of turbo encode/decode
>   operation added
> - images presenting CB/TB processing by turbo encoder/decoder
>   added
> 
> Signed-off-by: KamilX Chalupnik <kamilx.chalupnik@intel.com>

Is KamilX your name? Or just Kamil?


>  doc/guides/prog_guide/bbdev.rst               | 247 +++++++++++++++++++++++---
>  doc/guides/prog_guide/img/turbo_tb_decode.png | Bin 0 -> 43552 bytes
>  doc/guides/prog_guide/img/turbo_tb_encode.png | Bin 0 -> 46944 bytes
>  3 files changed, 222 insertions(+), 25 deletions(-)
>  create mode 100644 doc/guides/prog_guide/img/turbo_tb_decode.png
>  create mode 100644 doc/guides/prog_guide/img/turbo_tb_encode.png

No, sorry, you cannot add binary file in this repository.
It is an Open Source project, we provide sources.
For figures, the SVG format is preferred.

I'm sorry that your Intel colleagues did not warn you.
  
De Lara Guarch, Pablo April 23, 2018, 10:24 a.m. UTC | #4
> -----Original Message-----
> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Thomas Monjalon
> Sent: Sunday, April 22, 2018 9:17 PM
> To: Chalupnik, KamilX <kamilx.chalupnik@intel.com>
> Cc: dev@dpdk.org; Mokhtar, Amr <amr.mokhtar@intel.com>
> Subject: Re: [dpdk-dev] [PATCH] doc: update bbdev library documentation
> 
> Hi,
> 
> 04/04/2018 16:05, KamilX Chalupnik:
> > From: "Chalupnik, KamilX" <kamilx.chalupnik@intel.com>
> 
> The above line will appear as the author name in Git.
> Please make sure it is the same as the Signed-off-by line.
> Usually, we use FirstName LastName, without any comma.
> 
> 
> > Update the documentation describing Wireless Basband Device:
> > - device capabilities updated
> > - input/output data buffers description added
> > - details about implementation of turbo encode/decode
> >   operation added
> > - images presenting CB/TB processing by turbo encoder/decoder
> >   added
> >
> > Signed-off-by: KamilX Chalupnik <kamilx.chalupnik@intel.com>
> 
> Is KamilX your name? Or just Kamil?
> 
> 
> >  doc/guides/prog_guide/bbdev.rst               | 247 +++++++++++++++++++++++--
> -
> >  doc/guides/prog_guide/img/turbo_tb_decode.png | Bin 0 -> 43552 bytes
> > doc/guides/prog_guide/img/turbo_tb_encode.png | Bin 0 -> 46944 bytes
> >  3 files changed, 222 insertions(+), 25 deletions(-)  create mode
> > 100644 doc/guides/prog_guide/img/turbo_tb_decode.png
> >  create mode 100644 doc/guides/prog_guide/img/turbo_tb_encode.png
> 
> No, sorry, you cannot add binary file in this repository.
> It is an Open Source project, we provide sources.
> For figures, the SVG format is preferred.
> 
> I'm sorry that your Intel colleagues did not warn you.
> 

Thomas is right. I should have spotted this, sorry about it.
Will drop this from next-crypto subtree, so this patch requires a v2.
Once it is sent, addressing Thomas' comments, it may be applied.

Apologies for the confusion,
Pablo
  
Mokhtar, Amr April 23, 2018, 10:56 a.m. UTC | #5
> -----Original Message-----
> From: Thomas Monjalon [mailto:thomas@monjalon.net]
> Sent: Sunday 22 April 2018 21:17
> To: Chalupnik, KamilX <kamilx.chalupnik@intel.com>
> Cc: dev@dpdk.org; Mokhtar, Amr <amr.mokhtar@intel.com>
> Subject: Re: [dpdk-dev] [PATCH] doc: update bbdev library documentation
> 
> Hi,
> 
> 04/04/2018 16:05, KamilX Chalupnik:
> > From: "Chalupnik, KamilX" <kamilx.chalupnik@intel.com>

> 
> >  doc/guides/prog_guide/bbdev.rst               | 247
> +++++++++++++++++++++++---
> >  doc/guides/prog_guide/img/turbo_tb_decode.png | Bin 0 -> 43552
> bytes
> >  doc/guides/prog_guide/img/turbo_tb_encode.png | Bin 0 -> 46944
> bytes
> >  3 files changed, 222 insertions(+), 25 deletions(-)
> >  create mode 100644 doc/guides/prog_guide/img/turbo_tb_decode.png
> >  create mode 100644 doc/guides/prog_guide/img/turbo_tb_encode.png
> 
> No, sorry, you cannot add binary file in this repository.
> It is an Open Source project, we provide sources.
> For figures, the SVG format is preferred.
> 
> I'm sorry that your Intel colleagues did not warn you.
> 

I wasn't aware there is specific preference for figures, this can be fixed.
There is no specific reason for choosing .png except that there are files already
in prog_guide/img/* of type .png. So it was assumed that its ok.
And BTW, did I miss it somewhere in DPDK documentation what particular image
types should be submitted.

Will get this fixed. Thanks.
  
Thomas Monjalon April 23, 2018, 11:12 a.m. UTC | #6
23/04/2018 12:56, Mokhtar, Amr:
> From: Thomas Monjalon [mailto:thomas@monjalon.net]
> > 04/04/2018 16:05, KamilX Chalupnik:
> > > From: "Chalupnik, KamilX" <kamilx.chalupnik@intel.com>
> > 
> > >  doc/guides/prog_guide/bbdev.rst               | 247
> > +++++++++++++++++++++++---
> > >  doc/guides/prog_guide/img/turbo_tb_decode.png | Bin 0 -> 43552
> > bytes
> > >  doc/guides/prog_guide/img/turbo_tb_encode.png | Bin 0 -> 46944
> > bytes
> > >  3 files changed, 222 insertions(+), 25 deletions(-)
> > >  create mode 100644 doc/guides/prog_guide/img/turbo_tb_decode.png
> > >  create mode 100644 doc/guides/prog_guide/img/turbo_tb_encode.png
> > 
> > No, sorry, you cannot add binary file in this repository.
> > It is an Open Source project, we provide sources.
> > For figures, the SVG format is preferred.
> > 
> > I'm sorry that your Intel colleagues did not warn you.
> > 
> 
> I wasn't aware there is specific preference for figures, this can be fixed.
> There is no specific reason for choosing .png except that there are files already
> in prog_guide/img/* of type .png. So it was assumed that its ok.
> And BTW, did I miss it somewhere in DPDK documentation what particular image
> types should be submitted.

Yes, it is in this doc:
	http://dpdk.org/doc/guides/contributing/documentation.html#images

> Will get this fixed. Thanks.

Thanks
  
Mokhtar, Amr April 23, 2018, 12:15 p.m. UTC | #7
> -----Original Message-----
> From: Thomas Monjalon [mailto:thomas@monjalon.net]
> Sent: Monday 23 April 2018 12:12
> To: Mokhtar, Amr <amr.mokhtar@intel.com>
> Cc: Chalupnik, KamilX <kamilx.chalupnik@intel.com>; dev@dpdk.org
> Subject: Re: [dpdk-dev] [PATCH] doc: update bbdev library documentation
> 
> 23/04/2018 12:56, Mokhtar, Amr:
> > From: Thomas Monjalon [mailto:thomas@monjalon.net]
> > > 04/04/2018 16:05, KamilX Chalupnik:
> > > > From: "Chalupnik, KamilX" <kamilx.chalupnik@intel.com>
> > >
> > > >  doc/guides/prog_guide/bbdev.rst               | 247
> > > +++++++++++++++++++++++---
> > > >  doc/guides/prog_guide/img/turbo_tb_decode.png | Bin 0 -> 43552
> > > bytes
> > > >  doc/guides/prog_guide/img/turbo_tb_encode.png | Bin 0 -> 46944
> > > bytes
> > > >  3 files changed, 222 insertions(+), 25 deletions(-)
> > > >  create mode 100644
> doc/guides/prog_guide/img/turbo_tb_decode.png
> > > >  create mode 100644
> doc/guides/prog_guide/img/turbo_tb_encode.png
> > >
> > > No, sorry, you cannot add binary file in this repository.
> > > It is an Open Source project, we provide sources.
> > > For figures, the SVG format is preferred.
> > >
> > > I'm sorry that your Intel colleagues did not warn you.
> > >
> >
> > I wasn't aware there is specific preference for figures, this can be fixed.
> > There is no specific reason for choosing .png except that there are files
> already
> > in prog_guide/img/* of type .png. So it was assumed that its ok.
> > And BTW, did I miss it somewhere in DPDK documentation what
> particular image
> > types should be submitted.
> 
> Yes, it is in this doc:
> 	http://dpdk.org/doc/guides/contributing/documentation.html#ima
> ges
>

Ok, perfect. Will get it sorted accordingly..
Thanks!!

> > Will get this fixed. Thanks.
> 
> Thanks
>
  

Patch

diff --git a/doc/guides/prog_guide/bbdev.rst b/doc/guides/prog_guide/bbdev.rst
index d40c7f4..93be5ed 100644
--- a/doc/guides/prog_guide/bbdev.rst
+++ b/doc/guides/prog_guide/bbdev.rst
@@ -6,12 +6,12 @@  Wireless Baseband Device Library
 
 The Wireless Baseband library provides a common programming framework that
 abstracts HW accelerators based on FPGA and/or Fixed Function Accelerators that
-assist with 3gpp Physical Layer processing. Furthermore, it decouples the
+assist with 3GPP Physical Layer processing. Furthermore, it decouples the
 application from the compute-intensive wireless functions by abstracting their
 optimized libraries to appear as virtual bbdev devices.
 
 The functional scope of the BBDEV library are those functions in relation to
-the 3gpp Layer 1 signal processing (channel coding, modulation, ...).
+the 3GPP Layer 1 signal processing (channel coding, modulation, ...).
 
 The framework currently only supports Turbo Code FEC function.
 
@@ -167,7 +167,7 @@  Logical Cores, Memory and Queues Relationships
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The bbdev device Library as the Poll Mode Driver library support NUMA for when
-a processor’s logical cores and interfaces utilize its local memory. Therefore
+a processor's logical cores and interfaces utilize its local memory. Therefore
 baseband operations, the mbuf being operated on should be allocated from memory
 pools created in the local memory. The buffers should, if possible, remain on
 the local processor to obtain the best performance results and buffer
@@ -202,7 +202,7 @@  structure in the *DPDK API Reference*.
 
 A device reports its capabilities when registering itself in the bbdev framework.
 With the aid of this capabilities mechanism, an application can query devices to
-discover which operations within the 3gpp physical layer they are capable of
+discover which operations within the 3GPP physical layer they are capable of
 performing. Below is an example of the capabilities for a PMD it supports in
 relation to Turbo Encoding and Decoding operations.
 
@@ -216,7 +216,10 @@  relation to Turbo Encoding and Decoding operations.
                     RTE_BBDEV_TURBO_SUBBLOCK_DEINTERLEAVE |
                     RTE_BBDEV_TURBO_POS_LLR_1_BIT_IN |
                     RTE_BBDEV_TURBO_NEG_LLR_1_BIT_IN |
-                    RTE_BBDEV_TURBO_CRC_TYPE_24B,
+                    RTE_BBDEV_TURBO_CRC_TYPE_24B |
+                    RTE_BBDEV_TURBO_DEC_TB_CRC_24B_KEEP |
+                    RTE_BBDEV_TURBO_EARLY_TERMINATION,
+                .max_llr_modulus = 16,
                 .num_buffers_src = RTE_BBDEV_MAX_CODE_BLOCKS,
                 .num_buffers_hard_out =
                         RTE_BBDEV_MAX_CODE_BLOCKS,
@@ -228,6 +231,7 @@  relation to Turbo Encoding and Decoding operations.
             .cap.turbo_enc = {
                 .capability_flags =
                         RTE_BBDEV_TURBO_CRC_24B_ATTACH |
+                        RTE_BBDEV_TURBO_CRC_24A_ATTACH |
                         RTE_BBDEV_TURBO_RATE_MATCH |
                         RTE_BBDEV_TURBO_RV_INDEX_BYPASS,
                 .num_buffers_src = RTE_BBDEV_MAX_CODE_BLOCKS,
@@ -391,27 +395,101 @@  operation to its allocating pool.
     void rte_bbdev_enc_op_free_bulk(struct rte_bbdev_enc_op **ops,
             unsigned int num_ops)
 
-BBDEV Operations
-~~~~~~~~~~~~~~~~
+BBDEV Inbound/Outbound Memory
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The bbdev operation structure contains all the mutable data relating to
-performing Turbo code processing on a referenced mbuf data buffer. It is used
-for either encode or decode operations.
+performing Turbo coding on a referenced mbuf data buffer. It is used for either
+encode or decode operations.
 
 Turbo Encode operation accepts one input and one output.
-
 Turbo Decode operation accepts one input and two outputs, called *hard-decision*
 and *soft-decision* outputs. *Soft-decision* output is optional.
 
-It is expected that the application provides input and output ``mbuf`` pointers
+It is expected that the application provides input and output mbuf pointers
 allocated and ready to use. The baseband framework supports turbo coding on
 Code Blocks (CB) and Transport Blocks (TB).
 
-For the output buffer(s), the application needs only to provide an allocated and
-free mbuf (containing only one mbuf segment), so that bbdev can write the
-operation outcome.
+For the output buffer(s), the application is required to provide an allocated
+and free mbuf, so that bbdev write back the resulting output.
+
+The support of split "scattered" buffers is a driver-specific feature, so it is
+reported individually by the supporting driver as a capability.
+
+Input and output data buffers are identified by ``rte_bbdev_op_data`` structure,
+as follows:
+
+.. code-block:: c
+
+    struct rte_bbdev_op_data {
+        struct rte_mbuf *data;
+        uint32_t offset;
+        uint32_t length;
+    };
+
+
+This structure has three elements:
+
+- ``data``: This is the mbuf data structure representing the data for BBDEV
+  operation.
+
+  This mbuf pointer can point to one Code Block (CB) data buffer or multiple CBs
+  contiguously located next to each other. A Transport Block (TB) represents a
+  whole piece of data that is divided into one or more CBs. Maximum number of
+  CBs can be contained in one TB is defined by ``RTE_BBDEV_MAX_CODE_BLOCKS``.
+
+  An mbuf data structure cannot represent more than one TB. The smallest piece
+  of data that can be contained in one mbuf is one CB.
+  An mbuf can include one contiguous CB, subset of contiguous CBs that are
+  belonging to one TB, or all contiguous CBs that are belonging to one TB.
+
+  If a BBDEV PMD supports the extended capability "Scatter-Gather", then it is
+  capable of collecting (gathering) non-contiguous (scattered) data from
+  multiple locations in the memory.
+  This capability is reported by the capability flags:
 
-**Turbo Encode Op structure**
+  - ``RTE_BBDEV_TURBO_ENC_SCATTER_GATHER``, and
+
+  - ``RTE_BBDEV_TURBO_DEC_SCATTER_GATHER``.
+
+  Only if a BBDEV PMD supports this feature, chained mbuf data structures are
+  accepted. A chained mbuf can represent one non-contiguous CB or multiple
+  non-contiguous CBs.
+  The first mbuf segment in the given chained mbuf represents the first piece
+  of the CB. Offset is only applicable to the first segment. ``length`` is the
+  total length of the CB.
+
+  BBDEV driver is responsible for identifying where the split is and enqueue
+  the split data to its internal queues.
+
+  If BBDEV PMD does not support this feature, it will assume inbound mbuf data
+  contains one segment.
+
+  The output mbuf data though is always one segment, even if the input was a
+  chained mbuf.
+
+
+- ``offset``: This is the starting point of the BBDEV (encode/decode) operation,
+  in bytes.
+
+  BBDEV starts to read data past this offset.
+  In case of chained mbuf, this offset applies only to the first mbuf segment.
+
+
+- ``length``: This is the total data length to be processed in one operation,
+  in bytes.
+
+  In case the mbuf data is representing one CB, this is the length of the CB
+  undergoing the operation.
+  If it is for multiple CBs, this is the total length of those CBs undergoing
+  the operation.
+  If it is for one TB, this is the total length of the TB under operation.
+  In case of chained mbuf, this data length includes the lengths of the
+  "scattered" data segments undergoing the operation.
+
+
+BBDEV Turbo Encode Operation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. code-block:: c
 
@@ -428,8 +506,74 @@  operation outcome.
         };
     };
 
+The Turbo encode structure is composed of the ``input`` and ``output`` mbuf
+data pointers. The provided mbuf pointer of ``input`` needs to be big enough to
+stretch for extra CRC trailers.
+
+``op_flags`` parameter holds all operation related flags, like whether CRC24A is
+included by the application or not.
 
-**Turbo Decode Op structure**
+``code_block_mode`` flag identifies the mode in which bbdev is operating in.
+
+The encode interface works on both the code block (CB) and the transport block
+(TB). An operation executes in "CB-mode" when the CB is standalone. While
+"TB-mode" executes when an operation performs on one or multiple CBs that
+belong to a TB. Therefore, a given data can be standalone CB, full-size TB or
+partial TB. Partial TB means that only a subset of CBs belonging to a bigger TB
+are being enqueued.
+
+  **NOTE:** It is assumed that all enqueued ops in one ``rte_bbdev_enqueue_enc_ops()``
+  call belong to one mode, either CB-mode or TB-mode.
+
+In case that the CB is smaller than Z (6144 bits), then effectively the TB = CB.
+CRC24A is appended to the tail of the CB. The application is responsible for
+calculating and appending CRC24A before calling BBDEV in case that the
+underlying driver does not support CRC24A generation.
+
+In CB-mode, CRC24A/B is an optional operation.
+The input ``k`` is the size of the CB (this maps to K as described in 3GPP TS
+36.212 section 5.1.2), this size is inclusive of CRC24A/B.
+The ``length`` is inclusive of CRC24A/B and equals to ``k`` in this case.
+
+Not all BBDEV PMDs are capable of CRC24A/B calculation. Flags
+``RTE_BBDEV_TURBO_CRC_24A_ATTACH`` and ``RTE_BBDEV_TURBO_CRC_24B_ATTACH``
+informs the application with relevant capability. These flags can be set in the
+``op_flags`` parameter to indicate BBDEV to calculate and append CRC24A to CB
+before going forward with Turbo encoding.
+
+Output format of the CB encode will have the encoded CB in ``e`` size output
+(this maps to E described in 3GPP TS 36.212 section 5.1.4.1.2). The output mbuf
+buffer size needs to be big enough to hold the encoded buffer of size ``e``.
+
+In TB-mode, CRC24A is assumed to be pre-calculated and appended to the inbound
+TB mbuf data buffer.
+The output mbuf data structure is expected to be allocated by the application
+with enough room for the output data.
+
+The difference between the partial and full-size TB is that we need to know the
+index of the first CB in this group and the number of CBs contained within.
+The first CB index is given by ``r`` but the number of the remaining CBs is
+calculated automatically by BBDEV before passing down to the driver.
+
+The number of remaining CBs should not be confused with ``c``. ``c`` is the
+total number of CBs that composes the whole TB (this maps to C as
+described in 3GPP TS 36.212 section 5.1.2).
+
+The ``length`` is total size of the CBs inclusive of any CRC24A and CRC24B in
+case they were appended by the application.
+
+The case when one CB belongs to TB and is being enqueued individually to BBDEV,
+this case is considered as a special case of partial TB where its number of CBs
+is 1. Therefore, it requires to get processed in TB-mode.
+
+The figure below visualizes the encoding of CBs using BBDEV interface in
+TB-mode. CB-mode is a reduced version, where only one CB exists:
+
+.. figure:: img/turbo_tb_encode.*
+
+
+BBDEV Turbo Decode Operation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. code-block:: c
 
@@ -452,18 +596,71 @@  operation outcome.
         };
     };
 
-Input and output data buffers are identified by ``rte_bbdev_op_data`` structure.
-This structure has three elements:
+The Turbo decode structure is composed of the ``input`` and ``output`` mbuf
+data pointers.
+
+``op_flags`` parameter holds all operation related flags, like whether CRC24B is
+retained or not.
+
+``code_block_mode`` flag identifies the mode in which bbdev is operating in.
+
+Similarly, the decode interface works on both the code block (CB) and the
+transport block (TB). An operation executes in "CB-mode" when the CB is
+standalone. While "TB-mode" executes when an operation performs on one or
+multiple CBs that belong to a TB. Therefore, a given data can be standalone CB,
+full-size TB or partial TB. Partial TB means that only a subset of CBs belonging
+to a bigger TB are being enqueued.
+
+  **NOTE:** It is assumed that all enqueued ops in one ``rte_bbdev_enqueue_dec_ops()``
+  call belong to one mode, either CB-mode or TB-mode.
+
+The input ``k`` is the size of the decoded CB (this maps to K as described in
+3GPP TS 36.212 section 5.1.2), this size is inclusive of CRC24A/B.
+The ``length`` is inclusive of CRC24A/B and equals to ``k`` in this case.
+
+The input encoded CB data is the Virtual Circular Buffer data stream, wk, with
+the null padding included as described in 3GPP TS 36.212 section 5.1.4.1.2 and
+shown in 3GPP TS 36.212 section 5.1.4.1 Figure 5.1.4-1.
+The size of the virtual circular buffer is 3*Kpi, where Kpi is the 32 byte
+aligned value of K, as specified in 3GPP TS 36.212 section 5.1.4.1.1.
+
+Each byte in the input circular buffer is the LLR value of each bit of the
+original CB.
+
+``hard_output`` is a mandatory capability that all BBDEV PMDs support. This is
+the decoded CBs of K sizes (CRC24A/B is the last 24-bit in each decoded CB).
+Soft output is an optional capability for BBDEV PMDs. Setting flag
+``RTE_BBDEV_TURBO_DEC_TB_CRC_24B_KEEP`` in ``op_flags`` directs BBDEV to retain
+CRC24B at the end of each CB. This might be useful for the application in debug
+mode.
+An LLR rate matched output is computed in the ``soft_output`` buffer structure
+for the given ``e`` size (this maps to E described in 3GPP TS 36.212 section
+5.1.4.1.2). The output mbuf buffer size needs to be big enough to hold the
+encoded buffer of size ``e``.
+
+The first CB Virtual Circular Buffer (VCB) index is given by ``r`` but the
+number of the remaining CB VCBs is calculated automatically by BBDEV before
+passing down to the driver.
+
+The number of remaining CB VCBs should not be confused with ``c``. ``c`` is the
+total number of CBs that composes the whole TB (this maps to C as
+described in 3GPP TS 36.212 section 5.1.2).
+
+The ``length`` is total size of the CBs inclusive of any CRC24A and CRC24B in
+case they were appended by the application.
+
+The case when one CB belongs to TB and is being enqueued individually to BBDEV,
+this case is considered as a special case of partial TB where its number of CBs
+is 1. Therefore, it requires to get processed in TB-mode.
+
+The output mbuf data structure is expected to be allocated by the application
+with enough room for the output data.
 
-- ``data`` - This is the mbuf reference
+The figure below visualizes the decoding of CBs using BBDEV interface in
+TB-mode. CB-mode is a reduced version, where only one CB exists:
 
-- ``offset`` - The starting point for the Turbo input/output, in bytes, from the
-  start of the data in the data buffer. It must be smaller than data_len of the
-  mbuf's first segment
+.. figure:: img/turbo_tb_decode.*
 
-- ``length`` - The length, in bytes, of the buffer on which the Turbo operation
-  will or has been computed. For the input, the length is set by the application.
-  For the output(s), the length is computed by the bbdev PMD driver.
 
 Sample code
 -----------