From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id BE0A3A04DD; Thu, 5 Nov 2020 15:25:51 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A31D3C868; Thu, 5 Nov 2020 15:25:50 +0100 (CET) Received: from GBR01-CWL-obe.outbound.protection.outlook.com (mail-eopbgr110139.outbound.protection.outlook.com [40.107.11.139]) by dpdk.org (Postfix) with ESMTP id BFA14C858 for ; Thu, 5 Nov 2020 15:25:49 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=DBEUQUIhZlWTWWfG79MncXDeChMFjChKWDX0eqWOoUhmeki9P0WV3ocm7TtaMnHixL/xzkXF1irzD0MY3pZvmbbEC8oubKPq/YUQV/hQqW4lDzEzsJ5IlRvg+QTwque72Hxdul2CI4vsriCi76iGDnaVXT17i5s7gH2OfacG9fSfC/M4IrG2dpdvqX79sthz9vVO+Ssq/bQgcwBmenfoOt/+ty3+5i+gHG4LGnpPOLzS5iIFDL2U7elzV2++EK6WvtD4SjHVx5wCUSNSuyA7pKd2WyLgusxFAYwdjTOhOxQKKPTmYTKQCeiT0HdmJlCUa41eFL0Wxu2G6JIvAPNrjw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=U1ZhUR5l/76/GOjo5LxD/FLDfhhm+Iy5wWHKWFam4w8=; b=Ge27kX0tJPoF/gA5G2aSd2zJEVgqHnK6RjgWBNOZPoQ2ve+gJNnjEh7YaVcIf6G+nvITZZSECW4POjjmqtRfGXDmznTOfbsSoR8Xvv2JxOYFODZXFUTFzqwKCIcGS0prOPUz8azVHQ2/FuRVzwXClQeZXbpY70lAtfSH6/zGcIzlgt/ajqLLybyKndn2k33YRTheKsq3GxE7z8+nFEFfKVo/04JFUa5N4P23cgQtl1uSXy7vWFuZYXHPnA+dr7cXJY8Td0dh8OarENvkG8kjHksxXSgnfv8cBAz6R13IJs/vYZTgSFiF4Ki71FizkGG9Tika1SP1+tVZr6ykJ2VlHg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=accelercomm.com; dmarc=pass action=none header.from=accelercomm.com; dkim=pass header.d=accelercomm.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=accelercomm.onmicrosoft.com; s=selector1-accelercomm-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=U1ZhUR5l/76/GOjo5LxD/FLDfhhm+Iy5wWHKWFam4w8=; b=ekpgIVToYBiQlD9ViM4k4KL6HJZ1TQ6R+RRnayCKC2J+2CkJFcdu5qHXkmew2Rb3rX/HghcdWfhp4RYLRwUIKlb+N2q8mLxPFoguKsyBFrh1vnYSuoq2+zOkqYXGq5Wi3G7joGXA0iUk0Y0JpJF+cKUQsVVRfSNErJ7MOFGlY50= Authentication-Results: nxp.com; dkim=none (message not signed) header.d=none;nxp.com; dmarc=none action=none header.from=accelercomm.com; Received: from LNXP265MB0825.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:1a::22) by LOYP265MB2160.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:118::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3499.18; Thu, 5 Nov 2020 14:25:48 +0000 Received: from LNXP265MB0825.GBRP265.PROD.OUTLOOK.COM ([fe80::c081:231c:4cb1:7bb2]) by LNXP265MB0825.GBRP265.PROD.OUTLOOK.COM ([fe80::c081:231c:4cb1:7bb2%6]) with mapi id 15.20.3499.032; Thu, 5 Nov 2020 14:25:48 +0000 From: Aidan Goddard To: akhil.goyal@nxp.com Cc: nicolas.chautru@intel.com, dev@dpdk.org, Aidan Goddard Date: Thu, 5 Nov 2020 14:25:44 +0000 Message-Id: <1604586344-25634-1-git-send-email-aidan.goddard@accelercomm.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1604584637-21906-1-git-send-email-aidan.goddard@accelercomm.com> References: <1604584637-21906-1-git-send-email-aidan.goddard@accelercomm.com> Content-Type: text/plain X-Originating-IP: [81.100.143.234] X-ClientProxiedBy: LO2P265CA0214.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:9e::34) To LNXP265MB0825.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:1a::22) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from centossw-2.home (81.100.143.234) by LO2P265CA0214.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:9e::34) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3541.21 via Frontend Transport; Thu, 5 Nov 2020 14:25:47 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 36220a7c-ff04-4fbf-262d-08d88196b068 X-MS-TrafficTypeDiagnostic: LOYP265MB2160: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:2803; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: lNr19MjgxJldo4G1HPZ0L3IAe8usJxhSNppl9P6/5LxvHgyNC1Ca31sOSZlFRLQrEMuEa5tIz3Y3nRTbb0eaFPr83IrfFG/Z4tZOBVecIE3YJpVnWsOeO9G6dYu8vBaZvLAq7HSZgyblvTDFsk6G0sieYuVoc0gW7dwD1z3+4S6kd82iMCq0otRxKyUU/RtZ6TgaABr5D06kfkgf5yWWU3jwMb0rBe1CKW4WWWnHGWeoWmOtOLCr4cn0wbsf89KDcca/GUSyGdVtGXmArIl5JgoCmKEk1g2Pis3Fk1N7gOuJIlpE+OiDgzB1jfSwtR30 X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:LNXP265MB0825.GBRP265.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(136003)(376002)(396003)(366004)(39830400003)(346002)(478600001)(86362001)(30864003)(6666004)(316002)(6506007)(2616005)(5660300002)(956004)(44832011)(6486002)(8886007)(8936002)(8676002)(26005)(83380400001)(186003)(36756003)(2906002)(16526019)(52116002)(6512007)(66556008)(107886003)(66946007)(6916009)(66476007)(4326008); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData: Pma/8Up2zgIiLpwmPkRp+fu7UQah94XtFeu3n4K/SlJGvN4wUz9dYKtXr6IuTTobE5WCUSVqCQ4WWknrjSbfFZbot7afal6/BE1mp2jwLGA/Wo0xdYtE1ZV7oyjROKcHv73yIfvmnVv0bqKugCuixVVds5HrUnxt1bBpXTt1l74Lqlm6jyb5mxxKvNPcDDnmEGoHwUtJPNbuOmanhTzwMZ/RFCUU/1OcSzzqlHul8hW4kqxRyJZ6IRUfUsEYPePDfc2u2Wk5M4v7HIsF3jMk73GhIu4MFGyxlSvYMV/geQ2t+DYI1kyulCPdsy9JbSFQWpRLgNcf9YqPYkA8HqhbLF+U15AP22BhEodbsXhB9qPhC65vcLib/wVgW9V2fKCoEBAVX/cfA2WEGu4rcK6gt+CHvWyUZ6KPmbVtZCh/mTMCydF/wkMgRogaCD9PXSBcTtJrZSIS5cjtHdeCRMupccI1BBRbtwIhEIg0+ckMdREdckDEmw96nCvxgwW/K0EeCz8E52oeDEM1QSxPN80064NFEduMnvBec3X3aiO+Xi+HL1zOtRSzWjrpt8rFD3Gjgmydj7aFXd33s6L2RTeXat3n0NJCago6lILFugGjQxJo6hf2PteNbK70H5q3I3jJLT8b/IbLmnRBl5o4ar1uMA== X-OriginatorOrg: accelercomm.com X-MS-Exchange-CrossTenant-Network-Message-Id: 36220a7c-ff04-4fbf-262d-08d88196b068 X-MS-Exchange-CrossTenant-AuthSource: LNXP265MB0825.GBRP265.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Nov 2020 14:25:47.9347 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: a4aefd0f-62ef-4258-bd2b-0b6f6112bf2c X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: ZZwNPmfSrV/RK9e/nh6bFkvXrp1MmzQhWQBf6/UkYZDj1TugnWd/f2QOGVmaojbH85wNQ0nD2YSetJkLr7LTy2rViqXPvJ7Lcz6WsNtHriU= X-MS-Exchange-Transport-CrossTenantHeadersStamped: LOYP265MB2160 Subject: [dpdk-dev] [PATCH v3] BBDEV: add LDPC op parameters and flags to support CBGT 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" This commit adds support to BBDEV for LDPC Code Block Group Transmission (CBGT) as defined in 3GPP TS 38.214. The following changes facilitate this: - add RTE_BBDEV_LDPC_[ENC/DEC]_CBGT feature flag - add CBGT input parameters to LDPC encode transport block op structure - add CBGT input and output parameters to LDPC decode transport block op - add support for reading these parameters from test vector files - add sanity tests for RTE_BBDEV_LDPC_[ENC/DEC]_CBGT flag in test vector - update user guide with the flags and parameters CBGT parameters are only required when the RTE_BBDEV_LDPC_[ENC/DEC]_CBGT op flag is specified. Reported-by: Rob Maunder Signed-off-by: Aidan Goddard Acked-by: Dave Burley --- app/test-bbdev/test_bbdev_vector.c | 46 +++++++++++++++++++--- app/test-bbdev/test_bbdev_vector.h | 3 ++ doc/guides/prog_guide/bbdev.rst | 29 ++++++++++++++ lib/librte_bbdev/rte_bbdev_op.h | 80 +++++++++++++++++++++++++++++++++++++- 4 files changed, 151 insertions(+), 7 deletions(-) diff --git a/app/test-bbdev/test_bbdev_vector.c b/app/test-bbdev/test_bbdev_vector.c index 50d1da0..e5808b2 100644 --- a/app/test-bbdev/test_bbdev_vector.c +++ b/app/test-bbdev/test_bbdev_vector.c @@ -200,6 +200,8 @@ else if (!strcmp(token, "RTE_BBDEV_LDPC_INTERNAL_HARQ_MEMORY_LOOPBACK")) *op_flag_value = RTE_BBDEV_LDPC_INTERNAL_HARQ_MEMORY_LOOPBACK; + else if (!strcmp(token, "RTE_BBDEV_LDPC_DEC_CBGT")) + *op_flag_value = RTE_BBDEV_LDPC_DEC_CBGT; else { printf("The given value is not a LDPC decoder flag\n"); return -1; @@ -248,8 +250,10 @@ *op_flag_value = RTE_BBDEV_LDPC_ENC_INTERRUPTS; else if (!strcmp(token, "RTE_BBDEV_LDPC_ENC_SCATTER_GATHER")) *op_flag_value = RTE_BBDEV_LDPC_ENC_SCATTER_GATHER; + else if (!strcmp(token, "RTE_BBDEV_LDPC_ENC_CBGT")) + *op_flag_value = RTE_BBDEV_LDPC_ENC_CBGT; else { - printf("The given value is not a turbo encoder flag\n"); + printf("The given value is not a LDPC encoder flag\n"); return -1; } @@ -718,6 +722,14 @@ vector->mask |= TEST_BBDEV_VF_CODE_BLOCK_MODE; ldpc_enc->code_block_mode = (uint8_t) strtoul(token, &err, 0); ret = ((err == NULL) || (*err != '\0')) ? -1 : 0; + } else if (!strcmp(key_token, "max_cbg")) { + vector->mask |= TEST_BBDEV_VF_MAX_CBG_PER_TB; + ldpc_enc->tb_params.max_cbg = (uint8_t) strtoul(token, &err, 0); + ret = ((err == NULL) || (*err != '\0')) ? -1 : 0; + } else if (!strcmp(key_token, "cbgti")) { + vector->mask |= TEST_BBDEV_VF_CBGTI; + ldpc_enc->tb_params.cbgti = (uint8_t) strtoul(token, &err, 0); + ret = ((err == NULL) || (*err != '\0')) ? -1 : 0; } else if (!strcmp(key_token, "op_flags")) { vector->mask |= TEST_BBDEV_VF_OP_FLAGS; ret = parse_turbo_flags(token, &op_flags, vector->op_type); @@ -828,6 +840,18 @@ vector->mask |= TEST_BBDEV_VF_CODE_BLOCK_MODE; ldpc_dec->code_block_mode = (uint8_t) strtoul(token, &err, 0); ret = ((err == NULL) || (*err != '\0')) ? -1 : 0; + } else if (!strcmp(key_token, "max_cbg")) { + vector->mask |= TEST_BBDEV_VF_MAX_CBG_PER_TB; + ldpc_dec->tb_params.max_cbg = (uint8_t) strtoul(token, &err, 0); + ret = ((err == NULL) || (*err != '\0')) ? -1 : 0; + } else if (!strcmp(key_token, "cbgti")) { + vector->mask |= TEST_BBDEV_VF_CBGTI; + ldpc_dec->tb_params.cbgti = (uint8_t) strtoul(token, &err, 0); + ret = ((err == NULL) || (*err != '\0')) ? -1 : 0; + } else if (!strcmp(key_token, "cbgfi")) { + vector->mask |= TEST_BBDEV_VF_CBGFI; + ldpc_dec->tb_params.cbgfi = (uint8_t) strtoul(token, &err, 0); + ret = ((err == NULL) || (*err != '\0')) ? -1 : 0; } else if (!strcmp(key_token, "op_flags")) { vector->mask |= TEST_BBDEV_VF_OP_FLAGS; ret = parse_turbo_flags(token, &op_flags, vector->op_type); @@ -1162,6 +1186,12 @@ if (!(mask & TEST_BBDEV_VF_R)) printf( "WARNING: r was not specified in vector file and will be set to 0\n"); + if (!(mask & TEST_BBDEV_VF_MAX_CBG_PER_TB) && (ldpc_dec->op_flags & + RTE_BBDEV_LDPC_DEC_CBGT)) { + printf( + "WARNING: max_cbg was not specified in vector file and will be set to 1\n"); + ldpc_dec->tb_params.max_cbg = 1; + } } else { if (!(mask & TEST_BBDEV_VF_E)) printf( @@ -1298,12 +1328,18 @@ if (!(mask & TEST_BBDEV_VF_CODE_BLOCK_MODE)) { printf( "WARNING: code_block_mode was not specified in vector file and will be set to 1\n"); - vector->turbo_enc.code_block_mode = 1; + vector->ldpc_enc.code_block_mode = 1; } - if (vector->turbo_enc.code_block_mode == 0) { + if (vector->ldpc_enc.code_block_mode == 0) { + if (!(mask & TEST_BBDEV_VF_MAX_CBG_PER_TB) && (vector->ldpc_enc.op_flags & + RTE_BBDEV_LDPC_ENC_CBGT)) { + printf( + "WARNING: max_cbg was not specified in vector file and will be set to 1\n"); + vector->ldpc_enc.tb_params.max_cbg = 1; + } } else { - if (!(mask & TEST_BBDEV_VF_E) && (vector->turbo_enc.op_flags & - RTE_BBDEV_TURBO_RATE_MATCH)) + if (!(mask & TEST_BBDEV_VF_E) && (vector->ldpc_enc.op_flags & + RTE_BBDEV_LDPC_RATE_MATCH)) printf( "WARNING: e was not specified in vector file and will be set to 0\n"); if (!(mask & TEST_BBDEV_VF_NCB)) diff --git a/app/test-bbdev/test_bbdev_vector.h b/app/test-bbdev/test_bbdev_vector.h index 4e5dbf5..69f5b9c 100644 --- a/app/test-bbdev/test_bbdev_vector.h +++ b/app/test-bbdev/test_bbdev_vector.h @@ -35,6 +35,9 @@ enum { TEST_BBDEV_VF_CODE_BLOCK_MODE = (1ULL << 23), TEST_BBDEV_VF_OP_FLAGS = (1ULL << 24), TEST_BBDEV_VF_EXPECTED_STATUS = (1ULL << 25), + TEST_BBDEV_VF_MAX_CBG_PER_TB = (1ULL << 26), + TEST_BBDEV_VF_CBGTI = (1ULL << 27), + TEST_BBDEV_VF_CBGFI = (1ULL << 28), }; enum op_data_type { diff --git a/doc/guides/prog_guide/bbdev.rst b/doc/guides/prog_guide/bbdev.rst index 6b2bd54..0ff4039 100644 --- a/doc/guides/prog_guide/bbdev.rst +++ b/doc/guides/prog_guide/bbdev.rst @@ -747,6 +747,9 @@ given below. |RTE_BBDEV_LDPC_ENC_CONCATENATION | | Set if a device supports concatenation of non byte aligned output | +--------------------------------------------------------------------+ +|RTE_BBDEV_LDPC_ENC_CBGT | +| Set if a device supports CB group transmission | ++--------------------------------------------------------------------+ The structure passed for each LDPC encode operation is given below, with the operation flags forming a bitmask in the ``op_flags`` field. @@ -815,6 +818,10 @@ The LDPC encode parameters are set out in the table below. +----------------+------------+-------------------------------------------------------+ | |eb |Eb, length of the RM output sequence in bits, r >= cab | +----------------+------------+-------------------------------------------------------+ +| |max_cbg |maximum number of CB groups per TB: 1-8 | ++----------------+------------+-------------------------------------------------------+ +| |cbgti |CB group transmission information bitfield | ++----------------+------------+-------------------------------------------------------+ The mbuf input ``input`` is mandatory for all BBDEV PMDs and is the incoming code block or transport block data. @@ -869,6 +876,11 @@ Figure :numref:`figure_turbo_tb_encode` above showing the Turbo encoding of CBs using BBDEV interface in TB-mode is also valid for LDPC encode. +In TB-mode, If the ``RTE_BBDEV_LDPC_ENC_CBGT`` flag is specified the +``max_cbg`` and ``cbgti`` parameters are used for CB group transmission. If +the ``RTE_BBDEV_LDPC_ENC_CBGT`` flag is not specified, these parameters +are ignored. + BBDEV LDPC Decode Operation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -942,6 +954,9 @@ given below. |RTE_BBDEV_LDPC_INTERNAL_HARQ_MEMORY_LOOPBACK | | Set if a device supports loopback access to HARQ internal memory | +--------------------------------------------------------------------+ +|RTE_BBDEV_LDPC_DEC_CBGT | +| Set if a device supports CB group transmission | ++--------------------------------------------------------------------+ The structure passed for each LDPC decode operation is given below, with the operation flags forming a bitmask in the ``op_flags`` field. @@ -1027,6 +1042,14 @@ The LDPC decode parameters are set out in the table below. +----------------+------------+-------------------------------------------------------+ | |eb |Eb, length of the RM output sequence in bits r >= cab | +----------------+------------+-------------------------------------------------------+ +| |max_cbg |maximum number of CB groups per TB: 1-8 | ++----------------+------------+-------------------------------------------------------+ +| |cbgti |CB group transmission information bitfield | ++----------------+------------+-------------------------------------------------------+ +| |cbgfi |CB group Flushing out Information (CBGFI) | ++----------------+------------+-------------------------------------------------------+ +| |cbg_crc_err |CB group CRC failure bitfield (output) | ++----------------+------------+-------------------------------------------------------+ The mbuf input ``input`` encoded CB data is mandatory for all BBDEV PMDs and is the Virtual Circular Buffer data stream with null padding. @@ -1084,6 +1107,12 @@ Figure :numref:`figure_turbo_tb_decode` above showing the Turbo decoding of CBs using BBDEV interface in TB-mode is also valid for LDPC decode. +In TB-mode, If the ``RTE_BBDEV_LDPC_DEC_CBGT`` flag is specified the +``max_cbg`` and ``cbgti`` parameters are used for CB group transmission. The +``cbg_crc_err`` output parameter is a bitfield used to indicate crc failures +in the respective CB groups. If the ``RTE_BBDEV_LDPC_DEC_CBGT`` flag is not +specified, these parameters are ignored. + Sample code ----------- diff --git a/lib/librte_bbdev/rte_bbdev_op.h b/lib/librte_bbdev/rte_bbdev_op.h index f726d73..f3d00dc 100644 --- a/lib/librte_bbdev/rte_bbdev_op.h +++ b/lib/librte_bbdev/rte_bbdev_op.h @@ -186,7 +186,9 @@ enum rte_bbdev_op_ldpcdec_flag_bitmasks { * for HARQ memory. If not set, it is assumed the filler bits are not * in HARQ memory and handled directly by the LDPC decoder. */ - RTE_BBDEV_LDPC_INTERNAL_HARQ_MEMORY_FILLERS = (1ULL << 18) + RTE_BBDEV_LDPC_INTERNAL_HARQ_MEMORY_FILLERS = (1ULL << 18), + /** Set if a device supports CB group transmission. */ + RTE_BBDEV_LDPC_DEC_CBGT = (1ULL << 19) }; /** Flags for LDPC encoder operation and capability structure */ @@ -206,7 +208,9 @@ enum rte_bbdev_op_ldpcenc_flag_bitmasks { /** Set if a device supports scatter-gather functionality. */ RTE_BBDEV_LDPC_ENC_SCATTER_GATHER = (1ULL << 6), /** Set if a device supports concatenation of non byte aligned output */ - RTE_BBDEV_LDPC_ENC_CONCATENATION = (1ULL << 7) + RTE_BBDEV_LDPC_ENC_CONCATENATION = (1ULL << 7), + /** Set if a device supports CB group transmission. */ + RTE_BBDEV_LDPC_ENC_CBGT = (1ULL << 8) }; /** Data input and output buffer for BBDEV operations */ @@ -334,6 +338,56 @@ struct rte_bbdev_op_dec_ldpc_tb_params { uint8_t r; /** The number of CBs that use Ea before switching to Eb, [0:63] */ uint8_t cab; + /** If the RTE_BBDEV_LDPC_DEC_CBGT capability is not asserted, then + * the value of max_cbg is ignored. Otherwise, a max_cbg value of + * 0 or 1 indicates that codeBlockGroupTransmission is disabled, + * as defined in 3GPP TS 38.214. + * + * A max_cbg value of 2, 4, 6, or 8 sets the value of + * maxCodeBlockGroupsPerTransportBlock and indicates that + * codeBlockGroupTransmission is enabled, as defined in 3GPP TS 38.214. + */ + uint8_t max_cbg; + /** If codeBlockGroupTransmission is disabled, then the value of cbgti + * is ignored. Otherwise, cbgti represents the Code Block Group + * Transmission Information (CBGTI), as defined in 3GPP TS 38.214. + * In this case, the M = min(C, max_cbg) number of Most Significant + * Bits (MSBs) of the uint8_t cbgti have an in-order one-to-one mapping + * with the M code block groups (CBGs) of the transport block, with the + * MSB mapped to CBG#0, as detailed in 3GPP TS 38.214. + * + * Here, C is the total number of code blocks in the full transport block, + * as defined in 3GPP TS 38.212. + */ + uint8_t cbgti; + /** If codeBlockGroupTransmission is disabled, then the value of cbgfi + * should be ignored. Otherwise, cbgfi represents the Code Block Group + * Flushing out Information (CBGFI), as defined in 3GPP TS 38.214. In this + * case, if the LSB of the uint8_t cbgfi is set to 0, this indicates that + * the earlier received instances of the same CBGs being decoded may be + * corrupted and that the corresponding contents of the HARQ memory should + * be flushed and not combined with the present CBGs being decoded. If the + * LSB of the uint8_t cbgfi is set to 1, this indicates that the earlier + * received instances of the same CBGs being decoded should be combined with + * the present CBGs being decoded. + */ + uint8_t cbgfi; + + /** If codeBlockGroupTransmission is disabled or if + * RTE_BBDEV_LDPC_CRC_TYPE_24B_CHECK is not asserted, then the value of + * cbg_crc_err should be ignored. Otherwise, cbg_crc_err reports whether + * any CRC24B failures have been encountered in each of the code block + * groups (CBGs). In this case, the M = min(C, max_cbg) number of Most + * Significant Bits (MSBs) of the uint8_t cbg_crc_error have an in-order + * one-to-one mapping with the M CBGs of the transport block, with the MSB + * mapped to CBG#0, as detailed in 3GPP TS 38.214. An asserted bit + * indicates that a CRC24B failure was encountered among the code blocks + * of the corresponding CBG. + * + * Here, C is the total number of code blocks in the full transport block, + * as defined in 3GPP TS 38.212. + */ + uint8_t cbg_crc_err; }; /** Operation structure for Turbo decode. @@ -584,6 +638,28 @@ struct rte_bbdev_op_enc_ldpc_tb_params { uint8_t r; /** The number of CBs that use Ea before switching to Eb, [0:63] */ uint8_t cab; + /** If the RTE_BBDEV_LDPC_ENC_CBGT capability is not asserted, then + * the value of max_cbg is ignored. Otherwise, a max_cbg value of + * 0 or 1 indicates that codeBlockGroupTransmission is disabled, + * as defined in 3GPP TS 38.214. + * + * A max_cbg value of 2, 4, 6, or 8 sets the value of + * maxCodeBlockGroupsPerTransportBlock and indicates that + * codeBlockGroupTransmission is enabled, as defined in 3GPP TS 38.214. + */ + uint8_t max_cbg; + /** If codeBlockGroupTransmission is disabled, then the value of cbgti + * is ignored. Otherwise, cbgti represents the Code Block Group + * Transmission Information (CBGTI), as defined in 3GPP TS 38.214. + * In this case, the M = min(C, max_cbg) number of Most Significant + * Bits (MSBs) of the uint8_t cbgti have an in-order one-to-one mapping + * with the M code block groups (CBGs) of the transport block, with the + * MSB mapped to CBG#0, as detailed in 3GPP TS 38.214. + * + * Here, C is the total number of code blocks in the full transport block, + * as defined in 3GPP TS 38.212. + */ + uint8_t cbgti; }; /** Operation structure for Turbo encode. -- 1.8.3.1