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.
257 lines
8.7 KiB
C
257 lines
8.7 KiB
C
/**
|
|
* Copyright 2013-2023 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/.
|
|
*
|
|
*/
|
|
|
|
/******************************************************************************
|
|
* File: pdsch_cfg_nr.h
|
|
*
|
|
* Description: Physical downlink shared channel configuration
|
|
*
|
|
* Reference:
|
|
*****************************************************************************/
|
|
|
|
#ifndef SRSRAN_PHCH_CFG_NR_H
|
|
#define SRSRAN_PHCH_CFG_NR_H
|
|
|
|
#include "srsran/phy/ch_estimation/csi_rs_cfg.h"
|
|
#include "srsran/phy/common/phy_common_nr.h"
|
|
#include "srsran/phy/phch/sch_cfg_nr.h"
|
|
#include "srsran/phy/phch/uci_cfg_nr.h"
|
|
#include "srsran/phy/utils/re_pattern.h"
|
|
|
|
/**
|
|
* @brief Specifies the maximum number of ZP-CSI-RS resources configured per slot. It is not implicitly specified in the
|
|
* TS.
|
|
*/
|
|
#define SRSRAN_PHCH_CFG_MAX_NOF_ZP_CSI_RS_RES_PER_SLOT 16
|
|
|
|
/**
|
|
* @brief PDSCH DMRS type
|
|
*/
|
|
typedef enum {
|
|
srsran_dmrs_sch_type_1 = 0, // 1 pilot every 2 sub-carriers (default)
|
|
srsran_dmrs_sch_type_2 // 2 consecutive pilots every 6 sub-carriers
|
|
} srsran_dmrs_sch_type_t;
|
|
|
|
/**
|
|
* @brief PDSCH DMRS length in symbols
|
|
*/
|
|
typedef enum {
|
|
srsran_dmrs_sch_len_1 = 0, // single, 1 symbol long (default)
|
|
srsran_dmrs_sch_len_2 // double, 2 symbol long
|
|
} srsran_dmrs_sch_len_t;
|
|
|
|
/**
|
|
* @brief Determines additional symbols if possible to be added
|
|
*/
|
|
typedef enum {
|
|
srsran_dmrs_sch_add_pos_2 = 0,
|
|
srsran_dmrs_sch_add_pos_0,
|
|
srsran_dmrs_sch_add_pos_1,
|
|
srsran_dmrs_sch_add_pos_3
|
|
} srsran_dmrs_sch_add_pos_t;
|
|
|
|
/**
|
|
* @brief Provides PDSCH DMRS configuration
|
|
* @remark Parameters described in TS 38.331 V15.10.0
|
|
*/
|
|
typedef struct {
|
|
/// Parameters provided by IE DMRS-DownlinkConfig
|
|
srsran_dmrs_sch_type_t type;
|
|
srsran_dmrs_sch_add_pos_t additional_pos;
|
|
srsran_dmrs_sch_len_t length;
|
|
bool scrambling_id0_present;
|
|
uint32_t scrambling_id0;
|
|
bool scrambling_id1_present;
|
|
uint32_t scrambling_id1;
|
|
|
|
/// Parameters provided by ServingCellConfigCommon
|
|
srsran_dmrs_sch_typeA_pos_t typeA_pos;
|
|
bool lte_CRS_to_match_around;
|
|
|
|
uint32_t reference_point_k_rb;
|
|
|
|
/// Parameters provided by FeatureSetDownlink-v1540
|
|
bool additional_DMRS_DL_Alt;
|
|
|
|
} srsran_dmrs_sch_cfg_t;
|
|
|
|
/**
|
|
* @brief Common flatten PDSCH and PUSCH time domain allocation parameters
|
|
* @remark Described in TS 38.331 V15.10.0 Section PDSCH-TimeDomainResourceAllocationList
|
|
* @remark Described in TS 38.331 V15.10.0 Section PUSCH-TimeDomainResourceAllocationList
|
|
*/
|
|
typedef struct SRSRAN_API {
|
|
/// For PDSCH Slot offset between DCI and its scheduled PDSCH
|
|
/// For PUSCH parameter K2
|
|
uint32_t k;
|
|
|
|
/// SCH mapping type
|
|
srsran_sch_mapping_type_t mapping_type;
|
|
|
|
/// An index giving valid combinations of start symbol and length (jointly encoded) as start and length indicator
|
|
/// (SLIV). The network configures the field so that the allocation does not cross the slot boundary
|
|
uint32_t sliv;
|
|
|
|
} srsran_sch_time_ra_t;
|
|
|
|
/**
|
|
* @brief PDSCH grant information provided by the Downlink Control Information (DCI)
|
|
*/
|
|
typedef struct SRSRAN_API {
|
|
/// UE identifier
|
|
uint16_t rnti;
|
|
srsran_rnti_type_t rnti_type;
|
|
|
|
/// Time domain resources
|
|
uint32_t k; // k0 for PDSCH, k2 for PUSCH
|
|
uint32_t S;
|
|
uint32_t L;
|
|
srsran_sch_mapping_type_t mapping;
|
|
|
|
/// Frequency domain resources
|
|
bool prb_idx[SRSRAN_MAX_PRB_NR];
|
|
uint32_t nof_prb;
|
|
|
|
/// Number of DMRS groups without data
|
|
/// Described in TS 38.214 Section 5.1.6.2
|
|
uint32_t nof_dmrs_cdm_groups_without_data;
|
|
|
|
/// Linear DMRS power offset. Zero means unset and it is equivalent to one.
|
|
/// For PUSCH, see TS 38.214 Table 6.2.2-1 for more information
|
|
float beta_dmrs;
|
|
|
|
/// Spatial resources
|
|
uint32_t nof_layers;
|
|
|
|
/// DMRS Scrambling sequence initialization (false: 0 or true: 1)
|
|
bool n_scid;
|
|
|
|
/// DCI information
|
|
srsran_dci_format_nr_t dci_format;
|
|
srsran_search_space_type_t dci_search_space;
|
|
|
|
/// Transport block
|
|
uint32_t tb_scaling_field;
|
|
/// ....
|
|
|
|
srsran_sch_tb_t tb[SRSRAN_MAX_TB];
|
|
} srsran_sch_grant_nr_t;
|
|
|
|
/**
|
|
* @brief Beta offset configuration provided from upper layers
|
|
* @remark Configure according to TS 38.331 BetaOffsets
|
|
*/
|
|
typedef struct {
|
|
uint32_t ack_index1; ///< Use for up to 2 HARQ-ACK bits. Set to 11 if absent.
|
|
uint32_t ack_index2; ///< Use for up to 11 HARQ-ACK bits. Set to 11 if absent.
|
|
uint32_t ack_index3; ///< Use for more than 11 HARQ-ACK bits. Set to 11 if absent.
|
|
uint32_t csi1_index1; ///< Use for up to 11 CSI bits. Set to 13 if absent.
|
|
uint32_t csi1_index2; ///< Use for more than 11 CSI bits. Set to 13 if absent.
|
|
uint32_t csi2_index1; ///< Use for up to 11 CSI bits. Set to 13 if absent.
|
|
uint32_t csi2_index2; ///< Use for more than 11 CSI bits. Set to 13 if absent.
|
|
|
|
/// Fix values for testing purposes
|
|
float fix_ack; ///< Set to a non-zero value for fixing a beta offset value
|
|
float fix_csi1;
|
|
float fix_csi2;
|
|
} srsran_beta_offsets_t;
|
|
|
|
/**
|
|
* @brief flatten SCH configuration parameters provided by higher layers
|
|
* @remark Described in TS 38.331 V15.10.0 Section PDSCH-Config
|
|
* @remark Described in TS 38.331 V15.10.0 Section PUSCH-Config
|
|
*/
|
|
typedef struct SRSRAN_API {
|
|
// Serving cell parameters
|
|
uint32_t scs_cfg; // Subcarrier spacing configuration
|
|
srsran_dmrs_sch_typeA_pos_t typeA_pos;
|
|
|
|
bool scrambling_id_present;
|
|
uint32_t scambling_id; // Identifier used to initialize data scrambling (0-1023)
|
|
|
|
srsran_mcs_table_t mcs_table;
|
|
srsran_dmrs_sch_type_t dmrs_type;
|
|
srsran_dmrs_sch_len_t dmrs_max_length;
|
|
struct {
|
|
srsran_dmrs_sch_add_pos_t additional_pos;
|
|
bool scrambling_id0_present;
|
|
uint32_t scrambling_id0;
|
|
bool scrambling_id1_present;
|
|
uint32_t scrambling_id1;
|
|
bool present;
|
|
} dmrs_typeA;
|
|
|
|
struct {
|
|
srsran_dmrs_sch_add_pos_t additional_pos;
|
|
bool scrambling_id0_present;
|
|
uint32_t scrambling_id0;
|
|
bool scrambling_id1_present;
|
|
uint32_t scrambling_id1;
|
|
bool present;
|
|
} dmrs_typeB;
|
|
|
|
srsran_sch_time_ra_t common_time_ra[SRSRAN_MAX_NOF_TIME_RA];
|
|
uint32_t nof_common_time_ra;
|
|
|
|
srsran_sch_time_ra_t dedicated_time_ra[SRSRAN_MAX_NOF_TIME_RA];
|
|
uint32_t nof_dedicated_time_ra;
|
|
|
|
bool rbg_size_cfg_1; ///< RBG size configuration (1 or 2)
|
|
srsran_resource_alloc_t alloc;
|
|
|
|
srsran_sch_cfg_t sch_cfg; ///< Common shared channel parameters
|
|
|
|
/// PDSCH Periodic ZP-CSI-RS set
|
|
srsran_csi_rs_zp_set_t p_zp_csi_rs_set;
|
|
|
|
/// PDSCH Periodic NZP-CSI-RS set, indexed by nzp-CSI-ResourceSetId
|
|
srsran_csi_rs_nzp_set_t nzp_csi_rs_sets[SRSRAN_PHCH_CFG_MAX_NOF_CSI_RS_SETS];
|
|
|
|
/// PUSCH only
|
|
srsran_beta_offsets_t beta_offsets; /// Semi-static only.
|
|
bool enable_transform_precoder; /// Enables transform precoding
|
|
float scaling; /// Indicates a scaling factor to limit the number of resource elements assigned to UCI on PUSCH.
|
|
} srsran_sch_hl_cfg_nr_t;
|
|
|
|
/**
|
|
* @brief Common NR-SCH (PDSCH and PUSCH for NR) configuration
|
|
*/
|
|
typedef struct SRSRAN_API {
|
|
bool scrambling_id_present;
|
|
uint32_t scambling_id; ///< Identifier used to initialize data scrambling (0-1023)
|
|
|
|
srsran_dmrs_sch_cfg_t dmrs; ///< DMRS configuration for this transmission
|
|
srsran_sch_grant_nr_t grant; ///< Actual SCH grant
|
|
srsran_sch_cfg_t sch_cfg; ///< Common shared channel parameters
|
|
srsran_re_pattern_list_t rvd_re; ///< Reserved resource elements, as pattern
|
|
|
|
/// PUSCH only parameters
|
|
srsran_uci_cfg_nr_t uci; ///< Uplink Control Information configuration
|
|
bool enable_transform_precoder;
|
|
bool freq_hopping_enabled;
|
|
} srsran_sch_cfg_nr_t;
|
|
|
|
SRSRAN_API uint32_t srsran_sch_cfg_nr_nof_re(const srsran_sch_cfg_nr_t* sch_cfg);
|
|
|
|
SRSRAN_API uint32_t srsran_sch_cfg_nr_info(const srsran_sch_cfg_nr_t* sch_cfg, char* str, uint32_t str_len);
|
|
|
|
#endif // SRSRAN_PHCH_CFG_NR_H
|