/** * 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