[dpdk-dev] [PATCH v2 00/14] Documentation and Turbo Software Baseband Device Update

[Kamil Chalupnik]

Patchset adjusts BaseBand drivers code to changes in FlexRAN 1.4.0:
 - update usage of crc functions after API changes

Patchset includes following changes in Turbo Software drivers:
 - optimization of preparation data to encode processing (usage of memcpy
   changed or removed)
 - minor changes in defines definitions
 - function scaling input likelihood ratio (LLR)values to specific range
   [-16, 16] added
 - sizes of the internal buffers used by decoding were increased due to
   problem with memory for large vectors
 - support for optional CRC overlap in decode processing implemented
 - support for measurement of offload cost added
 - splitting Queue Groups into UL/DL Groups. They are independent for
   Decode/Encode

Baseband Device documentation was updated:
 - FlexRAN releases mapping table added
 - download and build instructions for BBDEV turbo_sw driver in
   compliance with FlexRAN 1.4.0 release added
 - device capabilities updated
 - input/output data buffers description added
 - details about implementation of turbo encode/decode operation added
 - added a note to enable building as a shared lib
 - vector test names updated
 - description of test added
 - usage of test app updated

Test vectors, test script and test application were updated:
 - creation of new vectors to test and validate BBDevice capabilities.
 - python script used for tests execuption updated
 - Improve readability of test application by replacing
   int values with rte_bbdev_event_type enum

Release note updated according to introduced changes.

Kamil Chalupnik (14):
  baseband/turbo_sw: update DPDK to work with FlexRAN 1.4.0
  baseband/turbo_sw: memory copying optimized or removed
  baseband/turbo_sw: minor changes in macro definitions
  baseband/turbo_sw: scalling likelihood ratio (LLR) input
  baseband/turbo_sw: increase internal buffers
  baseband/turbo_sw: support for optional CRC overlap
  bbdev: measure offload cost
  bbdev: split queue groups
  app/bbdev: update test vectors names
  app/bbdev: added new test vectors
  app/bbdev: improve readability of test application
  doc/turbo_sw: update Wireless Baseband Device documentation
  doc/bbdev: dynamic lib support
  doc: update tests and usage of test app description

 app/test-bbdev/Makefile                            |    2 +
 app/test-bbdev/test-bbdev.py                       |    2 +-
 app/test-bbdev/test_bbdev.c                        |   29 +-
 app/test-bbdev/test_bbdev_perf.c                   |  399 +++++--
 app/test-bbdev/test_bbdev_vector.c                 |    2 +
 app/test-bbdev/test_vectors/bbdev_null.data        |    5 +
 app/test-bbdev/test_vectors/bbdev_vector_null.data |    5 -
 .../test_vectors/bbdev_vector_td_default.data      |   54 -
 .../test_vectors/bbdev_vector_te_default.data      |   33 -
 .../turbo_dec_c1_k40_r0_e17280_sbd_negllr.data     |   57 +
 ...k6144_r0_e10376_crc24b_sbd_negllr_high_snr.data |  643 ++++++++++
 ..._k6144_r0_e10376_crc24b_sbd_negllr_low_snr.data |  643 ++++++++++
 .../turbo_dec_c1_k6144_r0_e34560_negllr.data       |  645 +++++++++++
 .../turbo_dec_c1_k6144_r0_e34560_posllr.data       |  645 +++++++++++
 .../turbo_dec_c1_k6144_r0_e34560_sbd_negllr.data   | 1224 +++++++++++++++++++
 .../turbo_dec_c1_k6144_r0_e34560_sbd_posllr.data   | 1225 ++++++++++++++++++++
 .../turbo_dec_c2_k3136_r0_e4920_sbd_negllr.data    |  676 +++++++++++
 ...bo_dec_c2_k3136_r0_e4920_sbd_negllr_crc24b.data |  677 +++++++++++
 .../test_vectors/turbo_enc_c1_k40_r0_e1190_rm.data |   36 +
 .../test_vectors/turbo_enc_c1_k40_r0_e1194_rm.data |   36 +
 .../test_vectors/turbo_enc_c1_k40_r0_e1196_rm.data |   36 +
 .../test_vectors/turbo_enc_c1_k40_r0_e272_rm.data  |   33 +
 .../turbo_enc_c1_k6144_r0_e120_rm_rvidx.data       |   63 +
 .../test_vectors/turbo_enc_c1_k6144_r0_e18444.data |  156 +++
 .../turbo_enc_c1_k6144_r0_e18448_crc24a.data       |  159 +++
 .../turbo_enc_c1_k6144_r0_e32256_crc24b_rm.data    |  180 +++
 .../turbo_enc_c2_k5952_r0_e17868_crc24b.data       |  300 +++++
 .../turbo_enc_c3_k4800_r2_e14412_crc24b.data       |  153 +++
 .../turbo_enc_c4_k4800_r2_e14412_crc24b.data       |  252 ++++
 app/test-bbdev/turbo_dec_default.data              |    1 +
 app/test-bbdev/turbo_enc_default.data              |    1 +
 config/common_base                                 |    5 +
 doc/guides/bbdevs/turbo_sw.rst                     |   58 +-
 doc/guides/prog_guide/bbdev.rst                    |  237 +++-
 doc/guides/rel_notes/release_18_05.rst             |   12 +
 doc/guides/tools/testbbdev.rst                     |  173 ++-
 drivers/baseband/null/bbdev_null.c                 |    3 +-
 drivers/baseband/turbo_sw/bbdev_turbo_software.c   |  267 +++--
 lib/librte_bbdev/rte_bbdev.c                       |   13 +-
 lib/librte_bbdev/rte_bbdev.h                       |    8 +-
 lib/librte_bbdev/rte_bbdev_op.h                    |   28 +-
 41 files changed, 8799 insertions(+), 377 deletions(-)
 create mode 100644 app/test-bbdev/test_vectors/bbdev_null.data
 delete mode 100644 app/test-bbdev/test_vectors/bbdev_vector_null.data
 delete mode 100644 app/test-bbdev/test_vectors/bbdev_vector_td_default.data
 delete mode 100644 app/test-bbdev/test_vectors/bbdev_vector_te_default.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_dec_c1_k40_r0_e17280_sbd_negllr.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_dec_c1_k6144_r0_e10376_crc24b_sbd_negllr_high_snr.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_dec_c1_k6144_r0_e10376_crc24b_sbd_negllr_low_snr.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_dec_c1_k6144_r0_e34560_negllr.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_dec_c1_k6144_r0_e34560_posllr.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_dec_c1_k6144_r0_e34560_sbd_negllr.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_dec_c1_k6144_r0_e34560_sbd_posllr.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_dec_c2_k3136_r0_e4920_sbd_negllr.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_dec_c2_k3136_r0_e4920_sbd_negllr_crc24b.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c1_k40_r0_e1190_rm.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c1_k40_r0_e1194_rm.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c1_k40_r0_e1196_rm.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c1_k40_r0_e272_rm.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c1_k6144_r0_e120_rm_rvidx.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c1_k6144_r0_e18444.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c1_k6144_r0_e18448_crc24a.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c1_k6144_r0_e32256_crc24b_rm.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c2_k5952_r0_e17868_crc24b.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c3_k4800_r2_e14412_crc24b.data
 create mode 100644 app/test-bbdev/test_vectors/turbo_enc_c4_k4800_r2_e14412_crc24b.data
 create mode 120000 app/test-bbdev/turbo_dec_default.data
 create mode 120000 app/test-bbdev/turbo_enc_default.data

-- 
2.5.5