Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/97128/?format=api
{ "id": 97128, "url": "http://patches.dpdk.org/api/patches/97128/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/1629407410-28822-6-git-send-email-nicolas.chautru@intel.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<1629407410-28822-6-git-send-email-nicolas.chautru@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/1629407410-28822-6-git-send-email-nicolas.chautru@intel.com", "date": "2021-08-19T21:10:09", "name": "[v2,5/6] doc: clarification of usage of HARQ in bbdev doc", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "d2a6a7b365a94686a3961928fe6fa8076c42991e", "submitter": { "id": 1314, "url": "http://patches.dpdk.org/api/people/1314/?format=api", "name": "Chautru, Nicolas", "email": "nicolas.chautru@intel.com" }, "delegate": { "id": 6690, "url": "http://patches.dpdk.org/api/users/6690/?format=api", "username": "akhil", "first_name": "akhil", "last_name": "goyal", "email": "gakhil@marvell.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/1629407410-28822-6-git-send-email-nicolas.chautru@intel.com/mbox/", "series": [ { "id": 18359, "url": "http://patches.dpdk.org/api/series/18359/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=18359", "date": "2021-08-19T21:10:04", "name": "bbdev update related to CRC usage", "version": 2, "mbox": "http://patches.dpdk.org/series/18359/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/97128/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/97128/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 50630A0C4B;\n\tThu, 19 Aug 2021 23:10:53 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 4FDC441239;\n\tThu, 19 Aug 2021 23:10:28 +0200 (CEST)", "from mga18.intel.com (mga18.intel.com [134.134.136.126])\n by mails.dpdk.org (Postfix) with ESMTP id 95C794003D\n for <dev@dpdk.org>; Thu, 19 Aug 2021 23:10:19 +0200 (CEST)", "from fmsmga003.fm.intel.com ([10.253.24.29])\n by orsmga106.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 19 Aug 2021 14:10:18 -0700", "from unknown (HELO icx-npg-scs1-cp1.localdomain) ([10.233.180.245])\n by FMSMGA003.fm.intel.com with ESMTP; 19 Aug 2021 14:10:18 -0700" ], "X-IronPort-AV": [ "E=McAfee;i=\"6200,9189,10081\"; a=\"203799159\"", "E=Sophos;i=\"5.84,335,1620716400\"; d=\"scan'208\";a=\"203799159\"", "E=Sophos;i=\"5.84,335,1620716400\"; d=\"scan'208\";a=\"522606851\"" ], "X-ExtLoop1": "1", "From": "Nicolas Chautru <nicolas.chautru@intel.com>", "To": "dev@dpdk.org,\n\tgakhil@marvell.com", "Cc": "thomas@monjalon.net, trix@redhat.com, hemant.agrawal@nxp.com,\n mingshan.zhang@intel.com, arun.joshi@intel.com,\n Nicolas Chautru <nicolas.chautru@intel.com>", "Date": "Thu, 19 Aug 2021 14:10:09 -0700", "Message-Id": "<1629407410-28822-6-git-send-email-nicolas.chautru@intel.com>", "X-Mailer": "git-send-email 1.8.3.1", "In-Reply-To": "<1629407410-28822-1-git-send-email-nicolas.chautru@intel.com>", "References": "<1629407410-28822-1-git-send-email-nicolas.chautru@intel.com>", "Subject": "[dpdk-dev] [PATCH v2 5/6] doc: clarification of usage of HARQ in\n bbdev doc", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "New paragraph detailing typical VRAN usecase and mapping\nto bbdev API usage.\n\nSigned-off-by: Nicolas Chautru <nicolas.chautru@intel.com>\n---\n doc/guides/prog_guide/bbdev.rst | 23 +++++++++++++++++++++++\n 1 file changed, 23 insertions(+)", "diff": "diff --git a/doc/guides/prog_guide/bbdev.rst b/doc/guides/prog_guide/bbdev.rst\nindex 8bd7cba..f39b62f 100644\n--- a/doc/guides/prog_guide/bbdev.rst\n+++ b/doc/guides/prog_guide/bbdev.rst\n@@ -1054,6 +1054,29 @@ capability RTE_BBDEV_LDPC_INTERNAL_HARQ_MEMORY_OUT_ENABLE is set\n then the HARQ is stored in memory internal to the device and not visible\n to BBDEV.\n \n+.. note::\n+ More explicitly for a typical usage of HARQ retransmission in a VRAN\n+ application using a HW PMD, there will be 2 cases.\n+\n+ For 1st transmission, only the HARQ output is enabled :\n+\n+ - the harq_combined_output.offset is provided to a given address. ie. typically an integer index * 32K, where the index is tracked by the application based on code block index for a given UE and HARQ process.\n+\n+ - the related operation flag would notably include RTE_BBDEV_LDPC_HQ_COMBINE_OUT_ENABLE and RTE_BBDEV_LDPC_HARQ_6BIT_COMPRESSION.\n+\n+ - note that not explicit flush or reset of the memory is required.\n+\n+ For 2nd transmission, an input is also required to benefit from HARQ combination gain:\n+\n+ - the changes mentioned above are the same (note that rvIndex may be adjusted).\n+\n+ - the operation flag would additionally include the LDPC_HQ_COMBINE_IN_ENABLE flag.\n+\n+ - the harq_combined_input.offset must set to the address of the related code block (ie. same as the harq_combine_output index above for the same code block, HARQ process, UE).\n+\n+ - the harq_combined_input.length must be set to the length which was provided back in the related harq_combined_output.length when it has processed and dequeued (previous HARQ iteration).\n+\n+\n The output mbuf data structures are expected to be allocated by the\n application with enough room for the output data.\n \n", "prefixes": [ "v2", "5/6" ] }