mirror of https://github.com/pvnis/srsRAN_4G.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
134 lines
6.4 KiB
C
134 lines
6.4 KiB
C
/**
|
|
* Copyright 2013-2021 Software Radio Systems Limited
|
|
*
|
|
* This file is part of srsRAN.
|
|
*
|
|
* srsRAN 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.
|
|
*
|
|
* srsRAN 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/.
|
|
*
|
|
*/
|
|
|
|
#ifndef SRSRAN_CSI_NR_H
|
|
#define SRSRAN_CSI_NR_H
|
|
|
|
#include "uci_cfg_nr.h"
|
|
|
|
/**
|
|
* @brief Processes a new NZP-CSI-RS channel measurement, it maps the given measurement into the current measurements
|
|
* applying an exponential moving average filter
|
|
* @param csi_resources CSI Resource configuration, links NZP-CSI-RS resources with CSI Measurements
|
|
* @param measurements Current CSI measurements
|
|
* @param new_measure New NZP-CSI-RS channel measurement
|
|
* @param nzp_csi_rs_id NZP-CSI-RS resource set identifier
|
|
* @return SRSRAN_SUCCESS if the provided information is valid, SRSRAN_ERROR code otherwise
|
|
*/
|
|
SRSRAN_API int
|
|
srsran_csi_new_nzp_csi_rs_measurement(const srsran_csi_hl_resource_cfg_t csi_resources[SRSRAN_CSI_MAX_NOF_RESOURCES],
|
|
srsran_csi_channel_measurements_t measurements[SRSRAN_CSI_MAX_NOF_RESOURCES],
|
|
const srsran_csi_channel_measurements_t* new_measure,
|
|
uint32_t nzp_csi_rs_id);
|
|
|
|
/**
|
|
* @brief Generates CSI report configuration from the higher layer configuration for a given slot
|
|
* @param cfg Higher layer report configuration
|
|
* @param slot_cfg Current slot configuration
|
|
* @param[out] report_cfg Report configuration for the given slot
|
|
* @return The number CSI reports for transmission if the provided data is valid, SRSRAN_ERROR code otherwise
|
|
*/
|
|
SRSRAN_API int srsran_csi_reports_generate(const srsran_csi_hl_cfg_t* cfg,
|
|
const srsran_slot_cfg_t* slot_cfg,
|
|
srsran_csi_report_cfg_t report_cfg[SRSRAN_CSI_SLOT_MAX_NOF_REPORT]);
|
|
|
|
/**
|
|
* @brief Quantifies a given set of CSI reports from the given set of measurements
|
|
* @param reports Set of report configuration
|
|
* @param measurements Set of measurements to quantify
|
|
* @param report_value Set of report values
|
|
* @return The number CSI reports for transmission if the provided data is valid, SRSRAN_ERROR code otherwise
|
|
*/
|
|
SRSRAN_API int
|
|
srsran_csi_reports_quantify(const srsran_csi_report_cfg_t reports[SRSRAN_CSI_SLOT_MAX_NOF_REPORT],
|
|
const srsran_csi_channel_measurements_t measurements[SRSRAN_CSI_MAX_NOF_RESOURCES],
|
|
srsran_csi_report_value_t report_value[SRSRAN_CSI_SLOT_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 Compute number of CSI bits necessary to transmit all the CSI part 2 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_part2_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
|