openairinterface5g

Files

T

Laurent THOMAS d57ea715c0 Improve polar decoder/encoder

- Ensure packed struct through bitfield
- decoder tree buffer increase: i don't find evidence in the 3GPP
  standard of the max size of polar coded PDU.  even with this max size,
  the way this tree is built is not trivial.  so, it is hard to predict,
  i just put 8 system pages (32KB) that looks enough [1]
- a lot of reformatting

[1] https://arxiv.org/pdf/1804.04389
according to this paper, the largest polar code in 5G is in UL, so
likely the biggest problem will be in gNB, not the UE.  in DL, the max
output coded block is 512, in UL 1024.  probably the tree we discuss is
related to this size.

"frozen bits" means only bits we don't encode/decode because polar code
size is only by power of 2.
We see this in OAI code:  NR_POLAR_PUCCH_N_MAX is 10, so 2^10 is 1024,
that is the maximum size for 5G polar code length.  in the code, we
assert if N > 512: "N = %d, not done yet\n",
polarParams->N".  so, the today OAI code can't do PUCCH large blocks.

using current oai limitation of 2⁹ max code size, we can create up to
2^9+2⁸... nodes, so 1023 nodes in the tree.  the problem then is that
each node have variable size, depending on the 'level' (the power of 2
we are currently).  the algo provision large alpha and beta to be able
to store all lower levels in the tree (int leaf_sz = 1 << level)
therefore upper tree nodes are large (the top level for n=9 uses about
1.5KB) and the bottom nodes uses 64 bytes.  if all nodes are populated,
the size will be very large: 1.5KB + 2 * 800 + ....  but, we create
nodes in the tree only for the "information bits", so the payload, that
is limited to 128 bits (else we assert, the code is not "finished").
1.5KB * 128 is >> 8KB i allocated.  but, we can't create more than one
mode at top level, so there is maximum 1.5KB + 2 * 800, + 4 * 400 + 8 *
200 + 16 * 100 + remaining of 128-32 nodes of 64 bytes.  about 14KB.

i allocated 1024*sizeof(__m256i) bytes = 32KB that looks good.

2024-11-07 09:25:18 +01:00

DOC

Set default behaviour regarding nokrnmod as enabled, updating references and usages

2023-03-07 13:27:37 +00:00

nrLDPC_decoder

Configure T2 EAL Parameters via Command Line

2024-06-27 14:53:17 +02:00

nrLDPC_decoder_LYC

fix redundant member in ldpc decoder struct

2023-11-28 09:37:37 +01:00

nrLDPC_encoder

cleanup of encode_parity_check_part_optim including asserting for case not handled

2024-08-28 17:40:26 +02:00

nrPolar_tools

Improve polar decoder/encoder

2024-11-07 09:25:18 +01:00

nrSmallBlock

rework PUCCH codec with c16_t type, rewrite large parts of functions to make readable code. Not fixed parts that are using SIMD. No change, the code is still same block by block (variable visibility narrowed, declaration can be shifted)

2024-01-04 10:21:15 +01:00

TESTBENCH

Improve polar decoder/encoder

2024-11-07 09:25:18 +01:00

3gpplte_sse.c

Avoid complete rebuild on cmake run with git info change

2024-08-28 15:57:24 +02:00

3gpplte_turbo_decoder_avx2_16bit.c

First-level of support for new aarch64 machines

2023-09-13 17:19:20 +02:00

3gpplte_turbo_decoder_sse_8bit.c

First-level of support for new aarch64 machines

2023-09-13 17:19:20 +02:00

3gpplte_turbo_decoder_sse_16bit.c

First-level of support for new aarch64 machines

2023-09-13 17:19:20 +02:00

3gpplte_turbo_decoder_sse.c

First-level of support for new aarch64 machines

2023-09-13 17:19:20 +02:00

3gpplte_turbo_decoder.c

first-fix-rrc-mac-interface

2022-12-02 16:47:21 +01:00

3gpplte.c

CPPCHECK fixes for printf issues

2023-06-01 12:07:26 +02:00

ccoding_byte_lte.c

fix most of doxygen warnings and errors

2023-10-26 16:47:19 +02:00

ccoding_byte.c

fix most of doxygen warnings and errors

2023-10-26 16:47:19 +02:00

coding_defs.h

fix most of doxygen warnings and errors

2023-10-26 16:47:19 +02:00

coding_extern.h

fix a lot of file mode

2019-01-07 16:22:28 +01:00

coding_load.c

fix most of doxygen warnings and errors

2023-10-26 16:47:19 +02:00

crc_byte.c

First-level of support for new aarch64 machines

2023-09-13 17:19:20 +02:00

crc.h

First-level of support for new aarch64 machines

2023-09-13 17:19:20 +02:00

crcext.h

First-level of support for new aarch64 machines

2023-09-13 17:19:20 +02:00

defs_NB_IoT.h

code cleanup, no feature

2021-10-24 14:47:24 +02:00

lte_interleaver_inline.h

fix a lot of file mode

2019-01-07 16:22:28 +01:00

lte_rate_matching.c

Fix compilation errors due to -Werror

2023-06-08 19:15:24 +02:00

lte_segmentation.c

CPPCHECK fixes for printf issues

2023-06-01 12:07:26 +02:00

lte_tf.m

fix a lot of file mode

2019-01-07 16:22:28 +01:00

Makefile

fix a lot of file mode

2019-01-07 16:22:28 +01:00

Makefile.arm

fix a lot of file mode

2019-01-07 16:22:28 +01:00

nr_polar_init.c

Improve polar decoder/encoder

2024-11-07 09:25:18 +01:00

nr_rate_matching.c

code cleanup and small fixes

2024-07-11 11:25:22 +02:00

nr_segmentation.c

CPPCHECK fixes for printf issues

2023-06-01 12:07:26 +02:00

nrLDPC_defs.h

Enhance T2 Offload for gNB and UE

2024-06-27 14:40:41 +02:00

nrLDPC_extern.h

T2: Fix buffer overflow and HARQ codeblock ID out of range

2023-12-21 11:19:13 +01:00

nrLDPC_load.c

Refactor LDPC API to make common API with various implementations

2023-11-28 09:37:37 +01:00

README.txt

fix a lot of file mode

2019-01-07 16:22:28 +01:00

types.h

missing .h file for intel crc

2021-11-01 17:57:04 +01:00

viterbi_lte.c

getopt() returns int

2024-10-24 19:22:06 +02:00

viterbi.c

Scan build: Result of operation is garbage or undefined

2024-03-07 11:00:57 +01:00

README.txt

PHY/CODING
----------


This directory contains the transport channel coding/decoding functions for both OpenAirInterface and a subset of LTE/WiMAX/WIFI MODEMS.
They can only be compiled on x86 platforms (at least sse,sse2 are required).

Files
------


crc_byte.c                     : 3GPP CRC routines (8,16,24 bit, LTE - 36-212 and WCDMA 25-212)
ccoding_byte.c                 : WIFI/WIMAX rate 1/2 convolutional code
ccoding_byte_lte.c             : 3GPP LTE rate 1/3 tail-biting convolutional code with CRC embedding
3gpplte.c                      : 3GPP LTE rate 1/3 turbo code
3gpp_turbo_decoder.c           : 3GPP/LTE turbo decoder (non-optimized)
3gpplte_turbo_decoder_sse.c    : 3GPP/LTE turbo decoder (optimized for SSE2/SSE3)
lte_interleaver.h              : 3GPP/LTE interleaver coefficient table (from 3GPP 36-212)
lte_interleaver_inline.h       : 3GPP/LTE Interleaver inline functions (from 3GPP 36-212)
lte_tf.m                       : 3GPP/LTE transport format size calculator
rate_matching.c                : OpenAirInterface pseudo-random rate matching
viterbi.c                      : WIFI/WIMAX rate 1/2 Viterbi decoder (non-optimized and optimized versions)
viterbi_lte.c                  : 3GPP LTE Viterbi decoder (SIMD optimized)
lte_rate_matching.c            : 3GPP/LTE Rate (de)matching and sub-block (de)interleaving routines (strict compliance with 3GPP 36-212, Release 8, 2009-03)
Makefile		       : Generates simple unitary tests for the three coding formats.  Note this doesn't do a performance evaluation.


Directories
-----------

TESTBENCH                      : Testbench for channel coding/decoding



Use of unitary tests
--------------------

Three tests can be compiled with "make".  They are standalone and do not require the rest of openair1.
They only test the following files:

crc_byte.c
ccoding_byte.c
ccdoing_byte_lte.c
3gpp_turbo_decoder_sse.c
3gpplte.c
viterbi.c
viterbi_lte.c

After "make", you should have three executables, turbo_test, rate13cc_test and rate12cc_test which should 
all have executed and printed proof of correct execution (at least for the default block lengths).  Further 
tests should be performed with the performance tests in TESTBENCH, which require the rest of openair1.