mirror of
https://gitlab.eurecom.fr/oai/openairinterface5g.git
synced 2026-07-15 05:30:29 +00:00
Compare commits
2 Commits
pre-commit
...
ldpc_doc_r
| Author | SHA1 | Date | |
|---|---|---|---|
|
4e4d158e38 | ||
|
|
410b7caa79 |
@@ -17,12 +17,6 @@ loading default `libldpc.so`:
|
||||
|
||||
```
|
||||
./nr-softmodem -O libconfig:gnb.band78.tm1.106PRB.usrpx300.conf:dbgl5
|
||||
.......................
|
||||
[CONFIG] loader.ldpc.shlibversion set to default value ""
|
||||
[LIBCONFIG] loader.ldpc: 2/2 parameters successfully set, (2 to default value)
|
||||
shlib_path libldpc.so
|
||||
[LOADER] library libldpc.so successfully loaded
|
||||
........................
|
||||
```
|
||||
|
||||
`libldpc.so` has its decoder implemented in [nrLDPC_coding_segment_decoder.c](file://../nrLDPC_coding/nrLDPC_coding_segment/nrLDPC_coding_segment_decoder.c).\
|
||||
@@ -42,18 +36,8 @@ Linking C shared module libldpc_t2.so
|
||||
At runtime, to successfully use the T2 board, you need to install vendor specific drivers and tools.\
|
||||
Please refer to the dedicated documentation at [LDPC_T2_OFFLOAD_SETUP.md](file://../../../../doc/LDPC_T2_OFFLOAD_SETUP.md).
|
||||
|
||||
`./nr-softmodem -O libconfig:gnb.band78.sa.fr1.106PRB.usrpb210.conf:dbgl5 --rfsim --rfsimulator.serveraddr server --log_config.gtpu_log_level info --loader.ldpc.shlibversion _t2 --nrLDPC_coding_t2.dpdk_dev 01:00.0 --nrLDPC_coding_t2.dpdk_core_list 0-1`
|
||||
|
||||
```
|
||||
|
||||
.......................
|
||||
[CONFIG] loader.ldpc.shlibversion set to default value ""
|
||||
[LIBCONFIG] loader.ldpc: 2/2 parameters successfully set, (1 to default value)
|
||||
[CONFIG] shlibversion set to _t2 from command line
|
||||
[CONFIG] loader.ldpc 1 options set from command line
|
||||
shlib_path libldpc_t2.so
|
||||
[LOADER] library libldpc_t2.so successfully loaded
|
||||
........................
|
||||
```
|
||||
./nr-softmodem -O libconfig:gnb.band78.sa.fr1.106PRB.usrpb210.conf:dbgl5 --rfsim --rfsimulator.serveraddr server --log_config.gtpu_log_level info --loader.ldpc.shlibversion _t2 --nrLDPC_coding_t2.dpdk_dev 01:00.0 --nrLDPC_coding_t2.dpdk_core_list 0-1
|
||||
```
|
||||
|
||||
`libldpc_t2.so` has its decoder and its encoder implemented in [nrLDPC_coding_t2.c](file://../nrLDPC_coding/nrLDPC_coding_t2/nrLDPC_coding_t2.c).
|
||||
@@ -72,18 +56,9 @@ ninja ldpc_xdma
|
||||
At runtime, to successfully use the xdma, you need to install vendor specific drivers and tools.\
|
||||
Please refer to the dedicated documentation at [LDPC_XDMA_OFFLOAD_SETUP.md](file://../../../../doc/LDPC_XDMA_OFFLOAD_SETUP.md).
|
||||
|
||||
`./nr-softmodem -O libconfig:gnb.band78.sa.fr1.106PRB.usrpb210.conf:dbgl5 --rfsim --rfsimulator.serveraddr server --log_config.gtpu_log_level info --loader.ldpc.shlibversion _xdma --nrLDPC_coding_xdma.num_threads_prepare 2`
|
||||
|
||||
```
|
||||
.......................
|
||||
[CONFIG] loader.ldpc.shlibversion set to default value ""
|
||||
[LIBCONFIG] loader.ldpc: 2/2 parameters successfully set, (1 to default value)
|
||||
[CONFIG] shlibversion set to _xdma from command line
|
||||
[CONFIG] loader.ldpc 1 options set from command line
|
||||
shlib_path libldpc_xdma.so
|
||||
[LOADER] library libldpc_xdma.so successfully loaded
|
||||
........................
|
||||
```
|
||||
```
|
||||
./nr-softmodem -O libconfig:gnb.band78.sa.fr1.106PRB.usrpb210.conf:dbgl5 --rfsim --rfsimulator.serveraddr server --log_config.gtpu_log_level info --loader.ldpc.shlibversion _xdma --nrLDPC_coding_xdma.num_threads_prepare 2
|
||||
```
|
||||
|
||||
`libldpc_xdma.so` has its decoder implemented in [nrLDPC_coding_xdma.c](file://../nrLDPC_coding/nrLDPC_coding_xdma/nrLDPC_coding_xdma.c).\
|
||||
Its encoder is implemented in [nrLDPC_coding_segment_encoder.c](file://../nrLDPC_coding/nrLDPC_coding_segment/nrLDPC_coding_segment_encoder.c).
|
||||
@@ -125,13 +100,6 @@ loading `libldpc_orig.so` instead of `libldpc.so`:
|
||||
|
||||
```
|
||||
./nr-softmodem -O libconfig:gnb.band78.tm1.106PRB.usrpx300.conf:dbgl5 --loader.ldpc.shlibversion _orig
|
||||
.......................
|
||||
[CONFIG] loader.ldpc.shlibversion set to default value ""
|
||||
[LIBCONFIG] loader.ldpc: 2/2 parameters successfully set, (1 to default value)
|
||||
[CONFIG] shlibversion set to _orig from command line
|
||||
[CONFIG] loader.ldpc 1 options set from command line
|
||||
[LOADER] library libldpc_orig.so successfully loaded
|
||||
........................
|
||||
```
|
||||
|
||||
loading `libldpc_cl.so` instead of `libldpc.so`:
|
||||
@@ -160,76 +128,12 @@ Built target ldpc_cl
|
||||
|
||||
At runtime, to successfully use hardware acceleration via OpenCL, you need to install vendor specific packages which deliver the required drivers and tools to make use of their GPU (Nvidia, Intel...) , fpga (Xilinx, Intel) or CPU (Intel, AMD, ARM...) through OpenCL.
|
||||
|
||||
`./nr-softmodem -O libconfig:gnb.band78.sa.fr1.106PRB.usrpb210.conf:dbgl5 --rfsim --rfsimulator.serveraddr server --log_config.gtpu_log_level info --loader.ldpc.shlibversion _cl`
|
||||
|
||||
```
|
||||
------------------------------------------------
|
||||
[LOADER] library libldpc_cl.so successfully loaded
|
||||
[HW] Platform 0, OpenCL profile FULL_PROFILE
|
||||
[HW] Platform 0, OpenCL version OpenCL 2.1 LINUX
|
||||
[HW] Device 0 is available
|
||||
[HW] Device 0, type 2 = 0x00000002: cpu
|
||||
[HW] Device 0, number of Compute Units: 8
|
||||
[HW] Device 0, max Work Items dimension: 3
|
||||
[HW] Device 0, max Work Items size for dimension: 0 8192
|
||||
[HW] Device 0, max Work Items size for dimension: 1 8192
|
||||
[HW] Device 0, max Work Items size for dimension: 2 8192
|
||||
[New Thread 0x7fffcc258700 (LWP 3945123)]
|
||||
[New Thread 0x7fffc3e57700 (LWP 3945124)]
|
||||
[New Thread 0x7fffcbe57700 (LWP 3945125)]
|
||||
[New Thread 0x7fffcba56700 (LWP 3945126)]
|
||||
[New Thread 0x7fffcb254700 (LWP 3945128)]
|
||||
[New Thread 0x7fffcb655700 (LWP 3945127)]
|
||||
[New Thread 0x7fffcae53700 (LWP 3945129)]
|
||||
[HW] Platform 1, OpenCL profile FULL_PROFILE
|
||||
[HW] Platform 1, OpenCL version OpenCL 2.0 beignet 1.3
|
||||
[New Thread 0x7fffc965a700 (LWP 3945130)]
|
||||
[Thread 0x7fffc965a700 (LWP 3945130) exited]
|
||||
[HW] Device 0 is available
|
||||
[HW] Device 0, type 4 = 0x00000004: gpu
|
||||
[HW] Device 0, number of Compute Units: 20
|
||||
[HW] Device 0, max Work Items dimension: 3
|
||||
[HW] Device 0, max Work Items size for dimension: 0 512
|
||||
[HW] Device 0, max Work Items size for dimension: 1 512
|
||||
[HW] Device 0, max Work Items size for dimension: 2 512
|
||||
-----------------------------------------------------------------
|
||||
```
|
||||
./nr-softmodem -O libconfig:gnb.band78.sa.fr1.106PRB.usrpb210.conf:dbgl5 --rfsim --rfsimulator.serveraddr server --log_config.gtpu_log_level info --loader.ldpc.shlibversion _cl
|
||||
```
|
||||
|
||||
`./nr-uesoftmodem -r 106 --numerology 1 --band 78 -C 3619200000 --rfsim -O libconfig:/usr/local/oai/conf/nrue_sim.conf:dbgl5 --loader.ldpc.shlibversion _cl --log_config.hw_log_level info`
|
||||
|
||||
```
|
||||
............................................................
|
||||
[CONFIG] segment_shlibversion set to _cl from command line
|
||||
[CONFIG] loader.ldpc 1 options set from command line
|
||||
[LOADER] library libldpc_cl.so successfully loaded
|
||||
[HW] Platform 0, OpenCL profile FULL_PROFILE
|
||||
[HW] Platform 0, OpenCL version OpenCL 2.1 LINUX
|
||||
[HW] Device 0 is available
|
||||
[HW] Device 0, type 2 = 0x00000002: cpu
|
||||
[HW] Device 0, number of Compute Units: 8
|
||||
[HW] Device 0, max Work Items dimension: 3
|
||||
[HW] Device 0, max Work Items size for dimension: 0 8192
|
||||
[HW] Device 0, max Work Items size for dimension: 1 8192
|
||||
[HW] Device 0, max Work Items size for dimension: 2 8192
|
||||
[New Thread 0x7fffecccc700 (LWP 3945413)]
|
||||
[New Thread 0x7fffec8cb700 (LWP 3945415)]
|
||||
[New Thread 0x7fffec4ca700 (LWP 3945414)]
|
||||
[New Thread 0x7fffdf7fd700 (LWP 3945417)]
|
||||
[New Thread 0x7fffdfbfe700 (LWP 3945418)]
|
||||
[New Thread 0x7fffdffff700 (LWP 3945416)]
|
||||
[New Thread 0x7fffd73fc700 (LWP 3945419)]
|
||||
[HW] Platform 1, OpenCL profile FULL_PROFILE
|
||||
[HW] Platform 1, OpenCL version OpenCL 2.0 beignet 1.3
|
||||
[New Thread 0x7fffde105700 (LWP 3945420)]
|
||||
[Thread 0x7fffde105700 (LWP 3945420) exited]
|
||||
[HW] Device 0 is available
|
||||
[HW] Device 0, type 4 = 0x00000004: gpu
|
||||
[HW] Device 0, number of Compute Units: 20
|
||||
[HW] Device 0, max Work Items dimension: 3
|
||||
[HW] Device 0, max Work Items size for dimension: 0 512
|
||||
[HW] Device 0, max Work Items size for dimension: 1 512
|
||||
[HW] Device 0, max Work Items size for dimension: 2 512
|
||||
------------------------------------------------------------
|
||||
./nr-uesoftmodem -r 106 --numerology 1 --band 78 -C 3619200000 --rfsim -O libconfig:/usr/local/oai/conf/nrue_sim.conf:dbgl5 --loader.ldpc.shlibversion _cl --log_config.hw_log_level inf
|
||||
```
|
||||
|
||||
A mechanism to select ldpc implementation is also available in the `ldpctest` phy simulator via the `-v` option, which can be used to specify the version of the ldpc shared library to be used.
|
||||
@@ -240,69 +144,16 @@ Loading libldpc_cuda.so, the cuda implementation of the ldpc decoder:
|
||||
|
||||
```
|
||||
$ ./ldpctest -v _cuda
|
||||
ldpctest -v _cuda
|
||||
Initializing random number generator, seed 0
|
||||
block length 8448:
|
||||
n_trials 1:
|
||||
SNR0 -2.000000:
|
||||
[CONFIG] get parameters from cmdline , debug flags: 0x00400000
|
||||
[CONFIG] log_config: 2/3 parameters successfully set
|
||||
[CONFIG] log_config: 53/53 parameters successfully set
|
||||
[CONFIG] log_config: 53/53 parameters successfully set
|
||||
[CONFIG] log_config: 16/16 parameters successfully set
|
||||
[CONFIG] log_config: 16/16 parameters successfully set
|
||||
log init done
|
||||
[CONFIG] loader: 2/2 parameters successfully set
|
||||
[CONFIG] loader.ldpc: 2/2 parameters successfully set
|
||||
[LOADER] library libldpc_cuda.so successfully loaded
|
||||
...................................
|
||||
```
|
||||
|
||||
|
||||
Loading libldpc_cl.so, the opencl implementation of the ldpc decoder:
|
||||
|
||||
`make ldpc_cl`
|
||||
|
||||
|
||||
```
|
||||
$ ./ldpctest -v _cl
|
||||
Initializing random number generator, seed 0
|
||||
block length 8448:
|
||||
n_trials 1:
|
||||
SNR0 -2.000000:
|
||||
[CONFIG] get parameters from cmdline , debug flags: 0x00400000
|
||||
[CONFIG] log_config: 2/3 parameters successfully set
|
||||
[CONFIG] log_config: 53/53 parameters successfully set
|
||||
[CONFIG] log_config: 53/53 parameters successfully set
|
||||
[CONFIG] log_config: 16/16 parameters successfully set
|
||||
[CONFIG] log_config: 16/16 parameters successfully set
|
||||
log init done
|
||||
[CONFIG] loader: 2/2 parameters successfully set
|
||||
[CONFIG] loader.ldpc: 1/2 parameters successfully set
|
||||
[LOADER] library libldpc_cl.so successfully loaded
|
||||
[HW] Platform 0, OpenCL profile FULL_PROFILE
|
||||
[HW] Platform 0, OpenCL version OpenCL 2.1 LINUX
|
||||
[HW] Device 0 is available
|
||||
[HW] Device 0, type 2 = 0x00000002: cpu
|
||||
[HW] Device 0, number of Compute Units: 8
|
||||
[HW] Device 0, max Work Items dimension: 3
|
||||
[HW] Device 0, max Work Items size for dimension: 0 8192
|
||||
[HW] Device 0, max Work Items size for dimension: 1 8192
|
||||
[HW] Device 0, max Work Items size for dimension: 2 8192
|
||||
[HW] Platform 1, OpenCL profile FULL_PROFILE
|
||||
[HW] Platform 1, OpenCL version OpenCL 2.0 beignet 1.3
|
||||
[HW] Device 0 is available
|
||||
[HW] Device 0, type 4 = 0x00000004: gpu
|
||||
[HW] Device 0, number of Compute Units: 20
|
||||
[HW] Device 0, max Work Items dimension: 3
|
||||
[HW] Device 0, max Work Items size for dimension: 0 512
|
||||
[HW] Device 0, max Work Items size for dimension: 1 512
|
||||
[HW] Device 0, max Work Items size for dimension: 2 512
|
||||
................................
|
||||
```
|
||||
|
||||
|
||||
|
||||
### LDPC libraries
|
||||
The prototypes for the functions of the interface are defined in [nrLDPC_defs.h](file://nrLDPC_defs.h) as typedefs.
|
||||
Libraries implementing the LDPC algorithms must be named `libldpc<_version>.so`, they must implement four functions with the names and types:
|
||||
|
||||
Reference in New Issue
Block a user