srsLTE/lib/include/srsran/phy/phch/sch.h

133 lines
4.7 KiB
C

/**
*
* \section COPYRIGHT
*
* Copyright 2013-2021 Software Radio Systems Limited
*
* By using this file, you agree to the terms and conditions set
* forth in the LICENSE file which can be found at the top level of
* the distribution.
*
*/
/******************************************************************************
* File: sch.h
*
* Description: Common UL and DL shared channel encode/decode functions.
*
* Reference: 3GPP TS 36.212 version 10.0.0 Release 10
*****************************************************************************/
#ifndef SRSRAN_SCH_H
#define SRSRAN_SCH_H
#include "srsran/config.h"
#include "srsran/phy/common/phy_common.h"
#include "srsran/phy/fec/crc.h"
#include "srsran/phy/fec/turbo/rm_turbo.h"
#include "srsran/phy/fec/turbo/turbocoder.h"
#include "srsran/phy/fec/turbo/turbodecoder.h"
#include "srsran/phy/phch/pdsch_cfg.h"
#include "srsran/phy/phch/pusch_cfg.h"
#include "srsran/phy/phch/uci.h"
#ifndef SRSRAN_RX_NULL
#define SRSRAN_RX_NULL 10000
#endif
#ifndef SRSRAN_TX_NULL
#define SRSRAN_TX_NULL 100
#endif
/* DL-SCH AND UL-SCH common functions */
typedef struct SRSRAN_API {
uint32_t max_iterations;
float avg_iterations;
bool llr_is_8bit;
/* buffers */
uint8_t* cb_in;
uint8_t* parity_bits;
void* e;
uint8_t* temp_g_bits;
uint32_t* ul_interleaver;
srsran_uci_bit_t ack_ri_bits[57600]; // 4*M_sc*Qm_max for RI and ACK
srsran_tcod_t encoder;
srsran_tdec_t decoder;
srsran_crc_t crc_tb;
srsran_crc_t crc_cb;
srsran_uci_cqi_pusch_t uci_cqi;
} srsran_sch_t;
SRSRAN_API int srsran_sch_init(srsran_sch_t* q);
SRSRAN_API void srsran_sch_free(srsran_sch_t* q);
SRSRAN_API void srsran_sch_set_max_noi(srsran_sch_t* q, uint32_t max_iterations);
SRSRAN_API float srsran_sch_last_noi(srsran_sch_t* q);
SRSRAN_API int srsran_dlsch_encode(srsran_sch_t* q, srsran_pdsch_cfg_t* cfg, uint8_t* data, uint8_t* e_bits);
SRSRAN_API int srsran_dlsch_encode2(srsran_sch_t* q,
srsran_pdsch_cfg_t* cfg,
uint8_t* data,
uint8_t* e_bits,
int codeword_idx,
uint32_t nof_layers);
SRSRAN_API int srsran_dlsch_decode(srsran_sch_t* q, srsran_pdsch_cfg_t* cfg, int16_t* e_bits, uint8_t* data);
SRSRAN_API int srsran_dlsch_decode2(srsran_sch_t* q,
srsran_pdsch_cfg_t* cfg,
int16_t* e_bits,
uint8_t* data,
int codeword_idx,
uint32_t nof_layers);
SRSRAN_API int srsran_ulsch_encode(srsran_sch_t* q,
srsran_pusch_cfg_t* cfg,
uint8_t* data,
srsran_uci_value_t* uci_data,
uint8_t* g_bits,
uint8_t* q_bits);
SRSRAN_API int srsran_ulsch_decode(srsran_sch_t* q,
srsran_pusch_cfg_t* cfg,
int16_t* q_bits,
int16_t* g_bits,
uint8_t* c_seq,
uint8_t* data,
srsran_uci_value_t* uci_data);
SRSRAN_API float srsran_sch_beta_cqi(uint32_t I_cqi);
SRSRAN_API float srsran_sch_beta_ack(uint32_t I_harq);
SRSRAN_API uint32_t srsran_sch_find_Ioffset_ack(float beta);
SRSRAN_API uint32_t srsran_sch_find_Ioffset_cqi(float beta);
SRSRAN_API uint32_t srsran_sch_find_Ioffset_ri(float beta);
///< Sidelink uses PUSCH Interleaver in all channels
SRSRAN_API void srsran_sl_ulsch_interleave(uint8_t* g_bits,
uint32_t Qm,
uint32_t H_prime_total,
uint32_t N_pusch_symbs,
uint8_t* q_bits);
///< Sidelink uses PUSCH Deinterleaver in all channels
SRSRAN_API void srsran_sl_ulsch_deinterleave(int16_t* q_bits,
uint32_t Qm,
uint32_t H_prime_total,
uint32_t N_pusch_symbs,
int16_t* g_bits,
uint32_t* inteleaver_lut);
#endif // SRSRAN_SCH_H