mirror of https://github.com/PentHertz/srsLTE.git
93 lines
4.1 KiB
C
93 lines
4.1 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.
|
|
*
|
|
*/
|
|
|
|
#ifndef SRSRAN_CSI_NR_H
|
|
#define SRSRAN_CSI_NR_H
|
|
|
|
#include "uci_cfg_nr.h"
|
|
|
|
/**
|
|
* @brief Fills Uplink Control Information data with triggered reports for the given slot
|
|
* @param cfg CSI report configuration
|
|
* @param slot_idx Slot index within the radio frame
|
|
* @param measurements CSI measurements
|
|
* @param[out] uci_data Uplink Control Information data
|
|
* @return The number CSI reports for transmission if the provided data is valid, SRSRAN_ERROR code otherwise
|
|
*/
|
|
SRSRAN_API int srsran_csi_generate_reports(const srsran_csi_hl_cfg_t* cfg,
|
|
uint32_t slot_idx,
|
|
const srsran_csi_measurements_t measurements[SRSRAN_CSI_MAX_NOF_RESOURCES],
|
|
srsran_csi_report_cfg_t report_cfg[SRSRAN_CSI_MAX_NOF_REPORT],
|
|
srsran_csi_report_value_t report_value[SRSRAN_CSI_MAX_NOF_REPORT]);
|
|
|
|
/**
|
|
* @brief Compute number of CSI bits necessary to transmit all the CSI reports for a PUCCH transmission
|
|
* @param report_list Provides the CSI report list
|
|
* @param nof_reports Number of CSI reports in the list
|
|
* @return The number of bits if the provided list is valid, SRSRAN_ERROR code otherwise
|
|
*/
|
|
SRSRAN_API int srsran_csi_part1_nof_bits(const srsran_csi_report_cfg_t* report_list, uint32_t nof_reports);
|
|
|
|
/**
|
|
* @brief Checks if the report list contains part 2 CSI report
|
|
* @param report_list Report list
|
|
* @param nof_reports Number of reports in the list
|
|
* @return True if at least one report contains part 2, false otherwise
|
|
*/
|
|
SRSRAN_API bool srsran_csi_has_part2(const srsran_csi_report_cfg_t* report_list, uint32_t nof_reports);
|
|
|
|
/**
|
|
* @brief Pack CSI part 1 bits for a PUCCH or PUSCH transmission
|
|
* @param report_list Provides the CSI report list
|
|
* @param nof_reports Number of CSI reports in the list
|
|
* @param o_csi1 CSI bits
|
|
* @param max_o_csi1 Maximum number of CSI bits
|
|
* @return number of packed bits if provided data is valid, SRSRAN_ERROR code otherwise
|
|
*/
|
|
SRSRAN_API int srsran_csi_part1_pack(const srsran_csi_report_cfg_t* report_cfg,
|
|
const srsran_csi_report_value_t* report_value,
|
|
uint32_t nof_reports,
|
|
uint8_t* o_csi1,
|
|
uint32_t max_o_csi1);
|
|
|
|
/**
|
|
*@brief Unpacks CSI part 1 bits for PUCCH or PUSCH transmission
|
|
* @param report_list Provides the CSI report list
|
|
* @param nof_reports Number of CSI reports in the list
|
|
* @param o_csi1 CSI bits
|
|
* @param max_o_csi1 Maximum number of CSI bits
|
|
* @param report_value
|
|
* @return SRSRAN_SUCCESS if provided data is valid, SRSRAN_ERROR code otherwise
|
|
*/
|
|
SRSRAN_API int srsran_csi_part1_unpack(const srsran_csi_report_cfg_t* report_cfg,
|
|
uint32_t nof_reports,
|
|
uint8_t* o_csi1,
|
|
uint32_t max_o_csi1,
|
|
srsran_csi_report_value_t* report_value);
|
|
|
|
/**
|
|
* @brief Converts to string a given list of CSI reports
|
|
* @param report_cfg Report configuration list
|
|
* @param report_value Report value list
|
|
* @param nof_reports Number of reports
|
|
* @param str String pointer
|
|
* @param str_len Maximum string length
|
|
* @return Number of used characters
|
|
*/
|
|
SRSRAN_API uint32_t srsran_csi_str(const srsran_csi_report_cfg_t* report_cfg,
|
|
const srsran_csi_report_value_t* report_value,
|
|
uint32_t nof_reports,
|
|
char* str,
|
|
uint32_t str_len);
|
|
|
|
#endif // SRSRAN_CSI_NR_H
|