srsLTE/lib/include/srsran/phy/ch_estimation/refsignal_ul.h

185 lines
8.6 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: refsignal_ul.h
*
* Description: Object to manage uplink reference signals for channel estimation.
*
* Reference: 3GPP TS 36.211 version 10.0.0 Release 10 Sec. 5.5
*********************************************************************************************/
#ifndef SRSRAN_REFSIGNAL_UL_H
#define SRSRAN_REFSIGNAL_UL_H
#include "srsran/config.h"
#include "srsran/phy/common/phy_common.h"
#include "srsran/phy/phch/pucch_cfg.h"
#include "srsran/phy/phch/pusch_cfg.h"
#define SRSRAN_NOF_GROUPS_U 30
#define SRSRAN_NOF_SEQUENCES_U 2
#define SRSRAN_NOF_DELTA_SS 30
#define SRSRAN_NOF_CSHIFT 8
#define SRSRAN_REFSIGNAL_UL_L(ns_idx, cp) ((ns_idx + 1) * SRSRAN_CP_NSYMB(cp) - 4)
/* PUSCH DMRS common configuration (received in SIB2) */
typedef struct SRSRAN_API {
uint32_t cyclic_shift;
uint32_t delta_ss;
bool group_hopping_en;
bool sequence_hopping_en;
} srsran_refsignal_dmrs_pusch_cfg_t;
typedef struct SRSRAN_API {
// Common Configuration
uint32_t subframe_config;
uint32_t bw_cfg;
bool simul_ack;
// Dedicated configuration
uint32_t B;
uint32_t b_hop;
uint32_t n_srs;
uint32_t I_srs;
uint32_t k_tc;
uint32_t n_rrc;
bool dedicated_enabled;
bool common_enabled;
bool configured;
} srsran_refsignal_srs_cfg_t;
/** Uplink DeModulation Reference Signal (DMRS) */
typedef struct SRSRAN_API {
srsran_cell_t cell;
uint32_t n_cs_cell[SRSRAN_NSLOTS_X_FRAME][SRSRAN_CP_NORM_NSYMB];
uint32_t n_prs_pusch[SRSRAN_NOF_DELTA_SS][SRSRAN_NSLOTS_X_FRAME]; // We precompute n_prs needed for cyclic shift alpha
// at srsran_refsignal_dl_init()
uint32_t f_gh[SRSRAN_NSLOTS_X_FRAME];
uint32_t u_pucch[SRSRAN_NSLOTS_X_FRAME];
uint32_t v_pusch[SRSRAN_NSLOTS_X_FRAME][SRSRAN_NOF_DELTA_SS];
} srsran_refsignal_ul_t;
typedef struct {
uint32_t max_prb;
cf_t** r[SRSRAN_NOF_CSHIFT][SRSRAN_NOF_SF_X_FRAME];
} srsran_refsignal_ul_dmrs_pregen_t;
typedef struct {
cf_t* r[SRSRAN_NOF_SF_X_FRAME];
} srsran_refsignal_srs_pregen_t;
SRSRAN_API int srsran_refsignal_ul_set_cell(srsran_refsignal_ul_t* q, srsran_cell_t cell);
SRSRAN_API uint32_t srsran_refsignal_dmrs_N_rs(srsran_pucch_format_t format, srsran_cp_t cp);
SRSRAN_API uint32_t srsran_refsignal_dmrs_pucch_symbol(uint32_t m, srsran_pucch_format_t format, srsran_cp_t cp);
SRSRAN_API int srsran_refsignal_dmrs_pusch_pregen_init(srsran_refsignal_ul_dmrs_pregen_t* pregen, uint32_t max_prb);
SRSRAN_API int srsran_refsignal_dmrs_pusch_pregen(srsran_refsignal_ul_t* q,
srsran_refsignal_ul_dmrs_pregen_t* pregen,
srsran_refsignal_dmrs_pusch_cfg_t* cfg);
SRSRAN_API void srsran_refsignal_dmrs_pusch_pregen_free(srsran_refsignal_ul_t* q,
srsran_refsignal_ul_dmrs_pregen_t* pregen);
SRSRAN_API int srsran_refsignal_dmrs_pusch_pregen_put(srsran_refsignal_ul_t* q,
srsran_ul_sf_cfg_t* sf_cfg,
srsran_refsignal_ul_dmrs_pregen_t* pregen,
srsran_pusch_cfg_t* pusch_cfg,
cf_t* sf_symbols);
SRSRAN_API int srsran_refsignal_dmrs_pusch_gen(srsran_refsignal_ul_t* q,
srsran_refsignal_dmrs_pusch_cfg_t* cfg,
uint32_t nof_prb,
uint32_t sf_idx,
uint32_t cyclic_shift_for_dmrs,
cf_t* r_pusch);
SRSRAN_API void srsran_refsignal_dmrs_pusch_put(srsran_refsignal_ul_t* q,
srsran_pusch_cfg_t* pusch_cfg,
cf_t* r_pusch,
cf_t* sf_symbols);
SRSRAN_API void srsran_refsignal_dmrs_pusch_get(srsran_refsignal_ul_t* q,
srsran_pusch_cfg_t* pusch_cfg,
cf_t* sf_symbols,
cf_t* r_pusch);
SRSRAN_API int srsran_refsignal_dmrs_pucch_gen(srsran_refsignal_ul_t* q,
srsran_ul_sf_cfg_t* sf,
srsran_pucch_cfg_t* cfg,
cf_t* r_pucch);
SRSRAN_API int
srsran_refsignal_dmrs_pucch_put(srsran_refsignal_ul_t* q, srsran_pucch_cfg_t* cfg, cf_t* r_pucch, cf_t* output);
SRSRAN_API int
srsran_refsignal_dmrs_pucch_get(srsran_refsignal_ul_t* q, srsran_pucch_cfg_t* cfg, cf_t* input, cf_t* r_pucch);
SRSRAN_API int srsran_refsignal_srs_pregen(srsran_refsignal_ul_t* q,
srsran_refsignal_srs_pregen_t* pregen,
srsran_refsignal_srs_cfg_t* cfg,
srsran_refsignal_dmrs_pusch_cfg_t* dmrs);
SRSRAN_API int srsran_refsignal_srs_pregen_put(srsran_refsignal_ul_t* q,
srsran_refsignal_srs_pregen_t* pregen,
srsran_refsignal_srs_cfg_t* cfg,
uint32_t tti,
cf_t* sf_symbols);
SRSRAN_API void srsran_refsignal_srs_pregen_free(srsran_refsignal_ul_t* q, srsran_refsignal_srs_pregen_t* pregen);
SRSRAN_API int srsran_refsignal_srs_gen(srsran_refsignal_ul_t* q,
srsran_refsignal_srs_cfg_t* cfg,
srsran_refsignal_dmrs_pusch_cfg_t* pusch_cfg,
uint32_t sf_idx,
cf_t* r_srs);
SRSRAN_API int srsran_refsignal_srs_put(srsran_refsignal_ul_t* q,
srsran_refsignal_srs_cfg_t* cfg,
uint32_t tti,
cf_t* r_srs,
cf_t* sf_symbols);
SRSRAN_API int srsran_refsignal_srs_get(srsran_refsignal_ul_t* q,
srsran_refsignal_srs_cfg_t* cfg,
uint32_t tti,
cf_t* r_srs,
cf_t* sf_symbols);
SRSRAN_API void srsran_refsignal_srs_pusch_shortened(srsran_refsignal_ul_t* q,
srsran_ul_sf_cfg_t* sf,
srsran_refsignal_srs_cfg_t* srs_cfg,
srsran_pusch_cfg_t* pusch_cfg);
SRSRAN_API void srsran_refsignal_srs_pucch_shortened(srsran_refsignal_ul_t* q,
srsran_ul_sf_cfg_t* sf,
srsran_refsignal_srs_cfg_t* srs_cfg,
srsran_pucch_cfg_t* pucch_cfg);
SRSRAN_API int srsran_refsignal_srs_send_cs(uint32_t subframe_config, uint32_t sf_idx);
SRSRAN_API int srsran_refsignal_srs_send_ue(uint32_t I_srs, uint32_t tti);
SRSRAN_API uint32_t srsran_refsignal_srs_rb_start_cs(uint32_t bw_cfg, uint32_t nof_prb);
SRSRAN_API uint32_t srsran_refsignal_srs_rb_L_cs(uint32_t bw_cfg, uint32_t nof_prb);
SRSRAN_API uint32_t srsran_refsignal_srs_M_sc(srsran_refsignal_ul_t* q, srsran_refsignal_srs_cfg_t* cfg);
#endif // SRSRAN_REFSIGNAL_UL_H