srsRAN_4G/lib/include/srslte/phy/fec/turbodecoder.h

/**
 *
 * \section COPYRIGHT
 *
 * Copyright 2013-2015 Software Radio Systems Limited
 *
 * \section LICENSE
 *
 * This file is part of the srsLTE library.
 *
 * srsLTE is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of
 * the License, or (at your option) any later version.
 *
 * srsLTE is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * A copy of the GNU Affero General Public License can be found in
 * the LICENSE file in the top-level directory of this distribution
 * and at http://www.gnu.org/licenses/.
 *
 */

/**********************************************************************************************
 *  File:         turbodecoder.h
 *
 *  Description:  Turbo Decoder.
 *                Parallel Concatenated Convolutional Code (PCCC) with two 8-state constituent
 *                encoders and one turbo code internal interleaver. The coding rate of turbo
 *                encoder is 1/3.
 *                MAP_GEN is the MAX-LOG-MAP generic implementation of the decoder.
 *
 *  Reference:    3GPP TS 36.212 version 10.0.0 Release 10 Sec. 5.1.3.2
 *********************************************************************************************/

#ifndef SRSLTE_TURBODECODER_H
#define SRSLTE_TURBODECODER_H

#include "srslte/config.h"
#include "srslte/phy/fec/tc_interl.h"
#include "srslte/phy/fec/cbsegm.h"

#define SRSLTE_TCOD_RATE 3
#define SRSLTE_TCOD_TOTALTAIL 12

#define SRSLTE_TCOD_MAX_LEN_CB     6144

// Expect the input to be aligned for sub-block window processing.
#define SRSLTE_TDEC_EXPECT_INPUT_SB 1

// Include interfaces for 8 and 16 bit decoder implementations
#define LLR_IS_8BIT
#include "srslte/phy/fec/turbodecoder_impl.h"
#undef LLR_IS_8BIT

#define LLR_IS_16BIT
#include "srslte/phy/fec/turbodecoder_impl.h"
#undef LLR_IS_16BIT

#define SRSLTE_TDEC_NOF_AUTO_MODES_8  2
#define SRSLTE_TDEC_NOF_AUTO_MODES_16 3

typedef enum {SRSLTE_TDEC_8, SRSLTE_TDEC_16} srslte_tdec_llr_type_t;

typedef struct SRSLTE_API {
  uint32_t max_long_cb;

  void *dec8_hdlr[SRSLTE_TDEC_NOF_AUTO_MODES_8];
  void *dec16_hdlr[SRSLTE_TDEC_NOF_AUTO_MODES_16];
  srslte_tdec_8bit_impl_t *dec8[SRSLTE_TDEC_NOF_AUTO_MODES_8];
  srslte_tdec_16bit_impl_t *dec16[SRSLTE_TDEC_NOF_AUTO_MODES_16];
  int nof_blocks8[SRSLTE_TDEC_NOF_AUTO_MODES_8];
  int nof_blocks16[SRSLTE_TDEC_NOF_AUTO_MODES_16];

  // Declare as void types as can be int8 or int16
  void *app1;
  void *app2;
  void *ext1;
  void *ext2;
  void *syst0;
  void *parity0;
  void *parity1;

  void *input_conv;

  bool force_not_sb;

  srslte_tdec_impl_type_t dec_type;

  srslte_tdec_llr_type_t current_llr_type;
  uint32_t current_dec;
  uint32_t current_long_cb;
  uint32_t current_inter_idx;
  int current_cbidx;
  srslte_tc_interl_t interleaver[4][SRSLTE_NOF_TC_CB_SIZES];
  int n_iter;
} srslte_tdec_t;

SRSLTE_API int srslte_tdec_init(srslte_tdec_t * h, 
                                uint32_t max_long_cb);

SRSLTE_API int srslte_tdec_init_manual(srslte_tdec_t * h,
                                      uint32_t max_long_cb,
                                      srslte_tdec_impl_type_t dec_type);

SRSLTE_API void srslte_tdec_free(srslte_tdec_t * h);

SRSLTE_API void srslte_tdec_force_not_sb(srslte_tdec_t *h);

SRSLTE_API int srslte_tdec_new_cb(srslte_tdec_t * h,
                                 uint32_t long_cb);

SRSLTE_API int srslte_tdec_get_nof_iterations(srslte_tdec_t * h);

SRSLTE_API uint32_t srslte_tdec_autoimp_get_subblocks(uint32_t long_cb);

SRSLTE_API uint32_t srslte_tdec_autoimp_get_subblocks_8bit(uint32_t long_cb);

SRSLTE_API void srslte_tdec_iteration(srslte_tdec_t * h, 
                                      int16_t* input,
                                      uint8_t *output);

SRSLTE_API int srslte_tdec_run_all(srslte_tdec_t * h,
                                   int16_t * input,
                                   uint8_t *output,
                                   uint32_t nof_iterations, 
                                   uint32_t long_cb);

SRSLTE_API void srslte_tdec_iteration_8bit(srslte_tdec_t * h,
                                            int8_t* input,
                                            uint8_t *output);

SRSLTE_API int srslte_tdec_run_all_8bit(srslte_tdec_t * h,
                                         int8_t * input,
                                         uint8_t *output,
                                         uint32_t nof_iterations,
                                         uint32_t long_cb);


#endif // SRSLTE_TURBODECODER_H