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 EA7E9A04DD; Thu, 5 Nov 2020 14:57:26 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id BBA90C806; Thu, 5 Nov 2020 14:57:25 +0100 (CET) Received: from GBR01-CWL-obe.outbound.protection.outlook.com (mail-eopbgr110128.outbound.protection.outlook.com [40.107.11.128]) by dpdk.org (Postfix) with ESMTP id 87132C7FC for ; Thu, 5 Nov 2020 14:57:23 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=BQZRHkHe6ygVz8LxKOL2rZZookGgj7YcCmSDO6xUBZVNjwb2GvbJ3lIkoVM43VaRCubqUbS2ASu3sIsPQD1iI4v+Jo3CVQyo1HAqNXtJ7qYmTK2OX7nwR+xwl4XlLqUrNbi55UKI274AXKZTq/CzIQwYKdFw7GrFoEVX9Rl7cC1epwRnTlaamYJu1fSxe2Q2nZcpvhQMUPV/U8fD/BR2VbxqyOQXEzWTYQ1AMu5D8MuC3YJpxJ2MBdMI5CeoN6i5VHTOxN1aLLu64C2nU/mb1CxY0VdRLGAHqwYvaNIVdIOWymw4DzsJ5XoyIqXTNTI4MvKQzHg41zNe4a0LsPe+MA== 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=8SWsCYF3aoF/8lSfFVMBojh+caznWqViUszOcAhtjzI=; b=XESbwqCI+dd3mx15ABQz4FJG1zWXVMm2LcP5Uvu3oOmmzIzGQwIdhHwrs1y5RxjtMbjiJhX30lWEOD8su4hze3LE+WsmyK+25lhtoFoFo6K3CbZIoHcuHzSJGFXVWOkMbOMt5x+wW7XZLOA7dyiBQAgvm3rpwKKIH7/aPi2M7Xy0joYcF5L/DQByvxSwbkZutzd0KD9+lCT2kTSZj1ox56hDRqW44OgoGQsImLInpNw04azGazIlj1W6Oej0QiykImNow/YMfG9x2fMAaTZbErTcZ7TDnzQV7qhCIcIjCmtAUhUX3KDNdGonahKMVbn7dHkZF53NFHMNgc+lsUMreg== 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=8SWsCYF3aoF/8lSfFVMBojh+caznWqViUszOcAhtjzI=; b=XsbyaKYNR7jem7qzi76mIGaoxc/pvFZKgLQBmUB+LfyTpeJAj5MMXZMMY4Tx7z4bJVvFnfVmdGCFFgej0Ta6oO5LbtS0xA418Q9V8BCJmpVjxsq/4EYSA5yxSRzfWZph1xcGONU54RYsftdy3yjkHymr/LXjRy4a/is5VBg9Z7s= 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 LNXP265MB1099.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:7b::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3499.29; Thu, 5 Nov 2020 13:57:21 +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 13:57:21 +0000 From: Aidan Goddard To: akhil.goyal@nxp.com Cc: dev@dpdk.org, Aidan Goddard Date: Thu, 5 Nov 2020 13:57:17 +0000 Message-Id: <1604584637-21906-1-git-send-email-aidan.goddard@accelercomm.com> X-Mailer: git-send-email 1.8.3.1 Content-Type: text/plain X-Originating-IP: [81.100.143.234] X-ClientProxiedBy: LO2P265CA0288.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:a1::36) 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 LO2P265CA0288.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:a1::36) 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 13:57:20 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: de2ad7e2-1e43-4bc9-9411-08d88192b6de X-MS-TrafficTypeDiagnostic: LNXP265MB1099: 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: C89hjAEPwUxOsAOMWoTiL56M2kNbAyNoQkthJEXawiTGCr3tj6jNBjmAL6EKktbDF6juMPYrfIDVklkrVPLrtjGPFm36JBnaZgCfiSHZ7b0YIS26ogaGQgH+1NeP3kAxoO481t8YwSTRVW4AEZ8LEXdN3EY3fwRtrN9l0xMlTJ78H5wUu5KgIL+QHSHycs1awJNsYaJGh2Gm/CfIwBx6nLcmHehnOgBmKo5hSCw6182TUKN3TXPQOwb9ELdJq1sP2nRY4k8/c4qybFoXyUGdHVpt1RUgiWjC4lvrbAW0XnmTKdnrP7tq8djENT2TAj+/ 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)(39830400003)(366004)(376002)(346002)(396003)(6512007)(6486002)(2906002)(8936002)(16526019)(8676002)(186003)(956004)(36756003)(2616005)(6916009)(107886003)(8886007)(26005)(316002)(4326008)(5660300002)(6666004)(6506007)(478600001)(86362001)(52116002)(66556008)(44832011)(66946007)(30864003)(83380400001)(66476007); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData: um7GRVABskBzJYQPbrCbbfdwT3FC8dr9ddZGWYoP7f3GYnFQQWAe0jPsQhNnnGWCTY7y4m8DDxQxaRFBrUnlBOJ0NWncMRyP56rCAkql9RCNVI/q7fZ8HDeqXybLqLtZPlfwhCOUZcOeJO2H9ZKvTFfyvBimGoHtxMDmgyE7ImmdIi4pCr3kWy6hnCuPMHr1n2tAuLMFq3mYZBPwLoZ6vUA7F1rgFRkhpi+F2rRAujX92h9GDLnSfA2x8ff13Keb9c1Bp5qHCcAFBKuYbvHKhU5GMqVe+7C4WuvsKxJwjVRbaR6E1CHxkjM/kLwcBEwQ15+6zjZLlO6GYsuzXklXdASNPj5nduRggn2HchsRWwUv9197uDkCpTcKprTbHYHDOJ/fi3x1JkE5CIxIZC7iFS1kfnnlTR+W3t426/u+POvfEusExakJZnuavN9NGnhAnoiXrXpHV4J+rUFTUj5n75NsLia2D3UDRRS6SYNDfxL5lpeHma6xGPH3tpuM3lCmemuTaPC+QwyR/dUNOC8FfuP9DI662o60Iwt0WgxV83r3Ylh8R9nLfmbqRRfbktnNN3ytKswEVUeh7mqwiE5BU/Dd7TI7wJhTT/Z4uLvlSjQXsLjvqijmhuJv4ngksgNQBOZ6KnAXM95IYJ+rgX5dbA== X-OriginatorOrg: accelercomm.com X-MS-Exchange-CrossTenant-Network-Message-Id: de2ad7e2-1e43-4bc9-9411-08d88192b6de X-MS-Exchange-CrossTenant-AuthSource: LNXP265MB0825.GBRP265.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Nov 2020 13:57:20.9411 (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: lQQ/bzSgOAaxWt8VZMjJ6plN1k9OkLejKDFUBOXu4031SbbwxRop++A/4mm1RFmm2ZceXsdRtzrn+G12eq7q54GmiQ77MQBrnucGV3Yz9hw= X-MS-Exchange-Transport-CrossTenantHeadersStamped: LNXP265MB1099 Subject: [dpdk-dev] [PATCH] 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 structure - add support for reading these parameters from test vector files - add sanity tests for RTE_BBDEV_LDPC_[ENC/DEC]_CBGT flag in test vector read - 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..6f448da 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..1fd44f2 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 that the earlier + * received instances of the same CBGs being decoded should be combined with + * the present CBGs being 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