mirror of https://github.com/PentHertz/srsLTE.git
105 lines
5.1 KiB
C
105 lines
5.1 KiB
C
/**
|
|
*
|
|
* \section COPYRIGHT
|
|
*
|
|
* Copyright 2013-2020 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.
|
|
*
|
|
*/
|
|
|
|
#ifndef SRSLTE_DMRS_PUCCH_H
|
|
#define SRSLTE_DMRS_PUCCH_H
|
|
|
|
#include "srslte/config.h"
|
|
#include "srslte/phy/ch_estimation/chest_ul.h"
|
|
#include "srslte/phy/phch/pucch_nr.h"
|
|
|
|
#define SRSLTE_DMRS_PUCCH_FORMAT_3_4_MAX_NSYMB 4
|
|
|
|
/**
|
|
* @brief Computes the symbol indexes carrying DMRS for NR-PUCCH formats 3 and 4
|
|
* @remark Implements TS 38.211 Table 6.4.1.3.3.2-1: DM-RS positions for PUCCH format 3 and 4.
|
|
* @param[in] resource Provides the format 3 or 4 resource
|
|
* @param[out] idx Destination data for storing the symbol indexes
|
|
* @return The number of DMRS symbols if the resource is valid, SRSLTE_ERROR code otherwise
|
|
*/
|
|
SRSLTE_API int srslte_dmrs_pucch_format_3_4_get_symbol_idx(const srslte_pucch_nr_resource_t* resource,
|
|
uint32_t idx[SRSLTE_DMRS_PUCCH_FORMAT_3_4_MAX_NSYMB]);
|
|
|
|
/**
|
|
* @brief Puts NR-PUCCH format 1 DMRS in the provided resource grid
|
|
* @param[in] q NR-PUCCH encoder/decoder object
|
|
* @param[in] carrier Carrier configuration
|
|
* @param[in] cfg PUCCH common configuration
|
|
* @param[in] slot slot configuration
|
|
* @param[in] resource PUCCH format 1 resource
|
|
* @param[out] slot_symbols Resource grid of the given slot
|
|
* @return SRSLTE_SUCCESS if successful, SRSLTE_ERROR code otherwise
|
|
*/
|
|
SRSLTE_API int srslte_dmrs_pucch_format1_put(const srslte_pucch_nr_t* q,
|
|
const srslte_carrier_nr_t* carrier,
|
|
const srslte_pucch_nr_common_cfg_t* cfg,
|
|
const srslte_slot_cfg_t* slot,
|
|
const srslte_pucch_nr_resource_t* resource,
|
|
cf_t* slot_symbols);
|
|
|
|
/**
|
|
* @brief Estimates NR-PUCCH format 1 resource elements from their DMRS in the provided resource grid
|
|
* @param[in] q NR-PUCCH encoder/decoder object
|
|
* @param[in] carrier Carrier configuration
|
|
* @param[in] cfg PUCCH common configuration
|
|
* @param[in] slot slot configuration
|
|
* @param[in] resource PUCCH format 1 resource
|
|
* @param[in] slot_symbols Resource grid of the given slot
|
|
* @param[out] res UL Channel estimator result
|
|
* @return SRSLTE_SUCCESS if successful, SRSLTE_ERROR code otherwise
|
|
*/
|
|
SRSLTE_API int srslte_dmrs_pucch_format1_estimate(const srslte_pucch_nr_t* q,
|
|
const srslte_carrier_nr_t* carrier,
|
|
const srslte_pucch_nr_common_cfg_t* cfg,
|
|
const srslte_slot_cfg_t* slot,
|
|
const srslte_pucch_nr_resource_t* resource,
|
|
const cf_t* slot_symbols,
|
|
srslte_chest_ul_res_t* res);
|
|
|
|
/**
|
|
* @brief Puts NR-PUCCH format 2 DMRS in the provided resource grid
|
|
* @param[in] q NR-PUCCH encoder/decoder object
|
|
* @param[in] carrier Carrier configuration
|
|
* @param[in] cfg PUCCH common configuration
|
|
* @param[in] slot slot configuration
|
|
* @param[in] resource PUCCH format 2 resource
|
|
* @param[out] slot_symbols Resource grid of the given slot
|
|
* @return SRSLTE_SUCCESS if successful, SRSLTE_ERROR code otherwise
|
|
*/
|
|
int srslte_dmrs_pucch_format2_put(const srslte_pucch_nr_t* q,
|
|
const srslte_carrier_nr_t* carrier,
|
|
const srslte_pucch_nr_common_cfg_t* cfg,
|
|
const srslte_slot_cfg_t* slot,
|
|
const srslte_pucch_nr_resource_t* resource,
|
|
cf_t* slot_symbols);
|
|
|
|
/**
|
|
* @brief Estimates NR-PUCCH format 2 resource elements from their DMRS in the provided resource grid
|
|
* @param[in] q NR-PUCCH encoder/decoder object
|
|
* @param[in] carrier Carrier configuration
|
|
* @param[in] cfg PUCCH common configuration
|
|
* @param[in] slot slot configuration
|
|
* @param[in] resource PUCCH format 2 resource
|
|
* @param[in] slot_symbols Resource grid of the given slot
|
|
* @param[out] res UL Channel estimator result
|
|
* @return SRSLTE_SUCCESS if successful, SRSLTE_ERROR code otherwise
|
|
*/
|
|
int srslte_dmrs_pucch_format2_estimate(const srslte_pucch_nr_t* q,
|
|
const srslte_carrier_nr_t* carrier,
|
|
const srslte_pucch_nr_common_cfg_t* cfg,
|
|
const srslte_slot_cfg_t* slot,
|
|
const srslte_pucch_nr_resource_t* resource,
|
|
const cf_t* slot_symbols,
|
|
srslte_chest_ul_res_t* res);
|
|
|
|
#endif // SRSLTE_DMRS_PUCCH_H
|