From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by dpdk.org (Postfix) with ESMTP id E28A65F6E for ; Wed, 18 Apr 2018 20:04:50 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga006.jf.intel.com ([10.7.209.51]) by orsmga103.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Apr 2018 11:04:49 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.48,466,1517904000"; d="scan'208";a="35261382" Received: from silpixa00391537.ir.intel.com ([10.237.222.189]) by orsmga006.jf.intel.com with ESMTP; 18 Apr 2018 11:04:48 -0700 From: Amr Mokhtar To: dev@dpdk.org Cc: Amr Mokhtar Date: Wed, 18 Apr 2018 19:04:45 +0100 Message-Id: <1524074685-104405-1-git-send-email-amr.mokhtar@intel.com> X-Mailer: git-send-email 2.7.4 Subject: [dpdk-dev] [PATCH] doc: update turbo software driver build instructions 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: , X-List-Received-Date: Wed, 18 Apr 2018 18:04:51 -0000 * Download and build instructions for BBDEV turbo_sw driver in compliance with FlexRAN SDK 1.4.0 release. * Added a note to enable building as a shared lib * Minor update for test execution example instruction * Minor update for capabilities supported Signed-off-by: Amr Mokhtar --- doc/guides/bbdevs/turbo_sw.rst | 45 +++++++++++++++++++++--------------------- 1 file changed, 22 insertions(+), 23 deletions(-) diff --git a/doc/guides/bbdevs/turbo_sw.rst b/doc/guides/bbdevs/turbo_sw.rst index b3fed16..d1f26d9 100644 --- a/doc/guides/bbdevs/turbo_sw.rst +++ b/doc/guides/bbdevs/turbo_sw.rst @@ -26,6 +26,8 @@ For the decode operation: * ``RTE_BBDEV_TURBO_CRC_TYPE_24B`` * ``RTE_BBDEV_TURBO_POS_LLR_1_BIT_IN`` * ``RTE_BBDEV_TURBO_NEG_LLR_1_BIT_IN`` +* ``RTE_BBDEV_TURBO_DEC_TB_CRC_24B_KEEP`` +* ``RTE_BBDEV_TURBO_EARLY_TERMINATION`` Limitations @@ -40,13 +42,13 @@ FlexRAN SDK Download ~~~~~~~~~~~~~~~~~~~~ To build DPDK with the *turbo_sw* PMD the user is required to download -the export controlled ``FlexRAN SDK`` Libraries. An account at Intel Resource -Design Center needs to be registered from -``_. +the export controlled ``FlexRAN SDK`` Libraries. An account at `Intel Resource +Design Center `_ +needs to be registered. Once registered, the user needs to log in, and look for -*Intel SWA_SW_FlexRAN_Release_Package R1_3_0* and click for download. Or use -this direct download link ``_. +*Intel FlexRAN Software Release Package 1_4_0* to download or directly through +this `link `_. After download is complete, the user needs to unpack and compile on their system before building DPDK. @@ -68,31 +70,28 @@ The following instructions should be followed in this exact order: source /linux/bin/compilervars.sh intel64 -platform linux -#. Extract the ``FlexRAN-1.3.0.tar.gz.zip`` package, then run the SDK extractor - script and accept the license: +#. Extract the ``576288-576288-intel-swa-sw-flexran-release-package-r1-4-0.zip`` + package, then run the SDK extractor script and accept the license: .. code-block:: console - cd /FlexRAN-1.3.0/ - ./SDK-R1.3.0.sh + cd /FlexRAN-1.4.0/ + ./SDK-R1.4.0.sh -#. To allow ``FlexRAN SDK R1.3.0`` to work with bbdev properly, the following - hotfix is required. Change the return of function ``rate_matching_turbo_lte_avx2()`` - located in file - ``/FlexRAN-1.3.0/SDK-R1.3.0/sdk/source/phy/lib_rate_matching/phy_rate_match_avx2.cpp`` - to return 0 instead of 1. +#. Generate makefiles based on system configuration: - .. code-block:: c + .. code-block:: console - - return 1; - + return 0; + cd /FlexRAN-1.4.0/SDK-R1.4.0/sdk/ + ./create-makefiles-linux.sh -#. Generate makefiles based on system configuration: +#. If build as a shared library is required, then add "-fPIC" option to file + /FlexRAN-1.4.0/SDK-R1.4.0/sdk/cmake/intel-compile-options.cmake + as follows: .. code-block:: console - cd /FlexRAN-1.3.0/SDK-R1.3.0/sdk/ - ./create-makefiles-linux.sh + add_compile_options("-fPIC") #. A build folder is generated in this form ``build--``, enter that folder and install: @@ -118,8 +117,8 @@ Example: .. code-block:: console - export FLEXRAN_SDK=/FlexRAN-1.3.0/SDK-R1.3.0/sdk/build-avx2-icc/install - export DIR_WIRELESS_SDK=/FlexRAN-1.3.0/SDK-R1.3.0/sdk/ + export FLEXRAN_SDK=/FlexRAN-1.4.0/SDK-R1.4.0/sdk/build-avx2-icc/install + export DIR_WIRELESS_SDK=/FlexRAN-1.4.0/SDK-R1.4.0/sdk/ * Set ``CONFIG_RTE_LIBRTE_PMD_BBDEV_TURBO_SW=y`` in DPDK common configuration @@ -144,4 +143,4 @@ Example: .. code-block:: console ./test-bbdev.py -e="--vdev=turbo_sw,socket_id=0,max_nb_queues=8" \ - -c validation -v ./test_vectors/bbdev_vector_t?_default.data + -c validation -v ./turbo_*_default.data -- 2.7.4