315 lines
14 KiB
C
315 lines
14 KiB
C
/*
|
|
* Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
* this work for additional information regarding copyright ownership.
|
|
* The OpenAirInterface Software Alliance licenses this file to You under
|
|
* the OAI Public License, Version 1.1 (the "License"); you may not use this file
|
|
* except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.openairinterface.org/?page_id=698
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*-------------------------------------------------------------------------------
|
|
* For more information about the OpenAirInterface (OAI) Software Alliance:
|
|
* contact@openairinterface.org
|
|
*/
|
|
|
|
/*! \file mac.h
|
|
* \brief common MAC function prototypes
|
|
* \author Navid Nikaein and Raymond Knopp, WIE-TAI CHEN
|
|
* \date Dec. 2019
|
|
* \version 0.1
|
|
* \company Eurecom
|
|
* \email raymond.knopp@eurecom.fr
|
|
*/
|
|
|
|
#ifndef __LAYER2_NR_MAC_COMMON_H__
|
|
#define __LAYER2_NR_MAC_COMMON_H__
|
|
|
|
#include "NR_MIB.h"
|
|
#include "NR_CellGroupConfig.h"
|
|
#include "nr_mac.h"
|
|
#include "common/utils/nr/nr_common.h"
|
|
|
|
typedef enum {
|
|
pusch_dmrs_pos0 = 0,
|
|
pusch_dmrs_pos1 = 1,
|
|
pusch_dmrs_pos2 = 2,
|
|
pusch_dmrs_pos3 = 3,
|
|
} pusch_dmrs_AdditionalPosition_t;
|
|
|
|
typedef enum {
|
|
pusch_len1 = 1,
|
|
pusch_len2 = 2
|
|
} pusch_maxLength_t;
|
|
|
|
typedef enum {
|
|
typeA = 0,
|
|
typeB = 1
|
|
} mappingType_t;
|
|
|
|
uint32_t get_Y(const NR_SearchSpace_t *ss, int slot, rnti_t rnti);
|
|
|
|
uint8_t get_BG(uint32_t A, uint16_t R);
|
|
|
|
uint64_t from_nrarfcn(int nr_bandP, uint8_t scs_index, uint32_t dl_nrarfcn);
|
|
|
|
uint32_t to_nrarfcn(int nr_bandP, uint64_t dl_CarrierFreq, uint8_t scs_index, uint32_t bw);
|
|
|
|
int16_t fill_dmrs_mask(const NR_PDSCH_Config_t *pdsch_Config,int dmrs_TypeA_Position,int NrOfSymbols,int startSymbol,mappingType_t mappingtype,int length);
|
|
|
|
int is_nr_DL_slot(NR_TDD_UL_DL_ConfigCommon_t *tdd_UL_DL_ConfigurationCommon,slot_t slotP);
|
|
|
|
int is_nr_UL_slot(NR_TDD_UL_DL_ConfigCommon_t *tdd_UL_DL_ConfigurationCommon, slot_t slotP, frame_type_t frame_type);
|
|
|
|
uint8_t compute_srs_resource_indicator(NR_PUSCH_ServingCellConfig_t *pusch_servingcellconfig,
|
|
NR_PUSCH_Config_t *pusch_Config,
|
|
NR_SRS_Config_t *srs_config,
|
|
nr_srs_feedback_t *srs_feedback,
|
|
uint32_t *val);
|
|
|
|
uint8_t compute_precoding_information(NR_PUSCH_Config_t *pusch_Config,
|
|
NR_SRS_Config_t *srs_config,
|
|
dci_field_t srs_resource_indicator,
|
|
nr_srs_feedback_t *srs_feedback,
|
|
const uint8_t *nrOfLayers,
|
|
uint32_t *val);
|
|
|
|
uint16_t nr_dci_size(const NR_BWP_DownlinkCommon_t *initialDownlinkBWP,
|
|
const NR_BWP_UplinkCommon_t *initialUplinkBWP,
|
|
const NR_UE_DL_BWP_t *DL_BWP,
|
|
const NR_UE_UL_BWP_t *UL_BWP,
|
|
const NR_CellGroupConfig_t *cg,
|
|
dci_pdu_rel15_t *dci_pdu,
|
|
nr_dci_format_t format,
|
|
nr_rnti_type_t rnti_type,
|
|
int controlResourceSetId,
|
|
int bwp_id,
|
|
int ss_type,
|
|
uint16_t cset0_bwp_size,
|
|
uint16_t alt_size);
|
|
|
|
uint16_t get_rb_bwp_dci(nr_dci_format_t format,
|
|
int ss_type,
|
|
uint16_t cset0_bwp_size,
|
|
uint16_t ul_bwp_size,
|
|
uint16_t dl_bwp_size,
|
|
uint16_t initial_ul_bwp_size,
|
|
uint16_t initial_dl_bwp_size);
|
|
|
|
void find_aggregation_candidates(uint8_t *aggregation_level,
|
|
uint8_t *nr_of_candidates,
|
|
const NR_SearchSpace_t *ss,
|
|
int maxL);
|
|
|
|
void find_monitoring_periodicity_offset_common(NR_SearchSpace_t *ss,
|
|
uint16_t *slot_period,
|
|
uint16_t *offset);
|
|
|
|
int get_nr_prach_info_from_index(uint8_t index,
|
|
int frame,
|
|
int slot,
|
|
uint32_t pointa,
|
|
uint8_t mu,
|
|
uint8_t unpaired,
|
|
uint16_t *format,
|
|
uint8_t *start_symbol,
|
|
uint8_t *N_t_slot,
|
|
uint8_t *N_dur,
|
|
uint16_t *RA_sfn_index,
|
|
uint8_t *N_RA_slot,
|
|
uint8_t *config_period);
|
|
|
|
int get_nr_prach_occasion_info_from_index(uint8_t index,
|
|
uint32_t pointa,
|
|
uint8_t mu,
|
|
uint8_t unpaired,
|
|
uint16_t *format,
|
|
uint8_t *start_symbol,
|
|
uint8_t *N_t_slot,
|
|
uint8_t *N_dur,
|
|
uint8_t *N_RA_slot,
|
|
uint16_t *N_RA_sfn,
|
|
uint8_t *max_association_period);
|
|
|
|
uint8_t get_pusch_mcs_table(long *mcs_Table,
|
|
int is_tp,
|
|
int dci_format,
|
|
int rnti_type,
|
|
int target_ss,
|
|
bool config_grant);
|
|
|
|
uint8_t compute_nr_root_seq(NR_RACH_ConfigCommon_t *rach_config,
|
|
uint8_t nb_preambles,
|
|
uint8_t unpaired,
|
|
frequency_range_t);
|
|
|
|
int ul_ant_bits(NR_DMRS_UplinkConfig_t *NR_DMRS_UplinkConfig,long transformPrecoder);
|
|
|
|
int get_format0(uint8_t index, uint8_t unpaired,frequency_range_t);
|
|
|
|
int64_t *get_prach_config_info(frequency_range_t freq_range,
|
|
uint8_t index,
|
|
uint8_t unpaired);
|
|
|
|
uint16_t get_NCS(uint8_t index, uint16_t format, uint8_t restricted_set_config);
|
|
|
|
uint8_t get_l0_ul(uint8_t mapping_type, uint8_t dmrs_typeA_position);
|
|
int32_t get_l_prime(uint8_t duration_in_symbols, uint8_t mapping_type, pusch_dmrs_AdditionalPosition_t additional_pos, pusch_maxLength_t pusch_maxLength, uint8_t start_symbolt, uint8_t dmrs_typeA_position);
|
|
|
|
uint8_t get_L_ptrs(uint8_t mcs1, uint8_t mcs2, uint8_t mcs3, uint8_t I_mcs, uint8_t mcs_table);
|
|
uint8_t get_K_ptrs(uint16_t nrb0, uint16_t nrb1, uint16_t N_RB);
|
|
|
|
uint32_t nr_compute_tbs(uint16_t Qm,
|
|
uint16_t R,
|
|
uint16_t nb_rb,
|
|
uint16_t nb_symb_sch,
|
|
uint16_t nb_dmrs_prb,
|
|
uint16_t nb_rb_oh,
|
|
uint8_t tb_scaling,
|
|
uint8_t Nl);
|
|
|
|
/** \brief Computes Q based on I_MCS PDSCH and table_idx for downlink. Implements MCS Tables from 38.214. */
|
|
uint8_t nr_get_Qm_dl(uint8_t Imcs, uint8_t table_idx);
|
|
uint32_t nr_get_code_rate_dl(uint8_t Imcs, uint8_t table_idx);
|
|
|
|
/** \brief Computes Q based on I_MCS PDSCH and table_idx for uplink. Implements MCS Tables from 38.214. */
|
|
uint8_t nr_get_Qm_ul(uint8_t Imcs, uint8_t table_idx);
|
|
uint32_t nr_get_code_rate_ul(uint8_t Imcs, uint8_t table_idx);
|
|
|
|
uint16_t get_nr_srs_offset(NR_SRS_PeriodicityAndOffset_t periodicityAndOffset);
|
|
|
|
int get_dlbw_tbslbrm(int scc_bwpsize,
|
|
NR_CellGroupConfig_t *cg);
|
|
|
|
int get_ulbw_tbslbrm(int scc_bwpsize,
|
|
NR_CellGroupConfig_t *cg);
|
|
|
|
uint32_t nr_compute_tbslbrm(uint16_t table,
|
|
uint16_t nb_rb,
|
|
uint8_t Nl);
|
|
|
|
void get_type0_PDCCH_CSS_config_parameters(NR_Type0_PDCCH_CSS_config_t *type0_PDCCH_CSS_config,
|
|
frame_t frameP,
|
|
NR_MIB_t *mib,
|
|
uint8_t num_slot_per_frame,
|
|
uint8_t ssb_subcarrier_offset,
|
|
uint16_t ssb_start_symbol,
|
|
NR_SubcarrierSpacing_t scs_ssb,
|
|
frequency_range_t frequency_range,
|
|
int nr_band,
|
|
uint32_t ssb_index,
|
|
uint32_t ssb_period,
|
|
uint32_t ssb_offset_point_a);
|
|
|
|
uint16_t get_ssb_start_symbol(const long band, NR_SubcarrierSpacing_t scs, int i_ssb);
|
|
|
|
void get_info_from_tda_tables(int default_abc,
|
|
int tda,
|
|
int dmrs_TypeA_Position,
|
|
int normal_CP,
|
|
bool *is_mapping_typeA,
|
|
int *startSymbolIndex,
|
|
int *nrOfSymbols);
|
|
|
|
void fill_coresetZero(NR_ControlResourceSet_t *coreset0, NR_Type0_PDCCH_CSS_config_t *type0_PDCCH_CSS_config);
|
|
void fill_searchSpaceZero(NR_SearchSpace_t *ss0, NR_Type0_PDCCH_CSS_config_t *type0_PDCCH_CSS_config);
|
|
|
|
uint8_t get_pusch_nb_antenna_ports(NR_PUSCH_Config_t *pusch_Config,
|
|
NR_SRS_Config_t *srs_config,
|
|
dci_field_t srs_resource_indicator);
|
|
|
|
uint16_t compute_pucch_prb_size(uint8_t format,
|
|
uint8_t nr_prbs,
|
|
uint16_t O_tot,
|
|
uint16_t O_csi,
|
|
NR_PUCCH_MaxCodeRate_t *maxCodeRate,
|
|
uint8_t Qm,
|
|
uint8_t n_symb,
|
|
uint8_t n_re_ctrl);
|
|
|
|
int16_t get_N_RA_RB (int delta_f_RA_PRACH,int delta_f_PUSCH);
|
|
|
|
void find_period_offset_SR(const NR_SchedulingRequestResourceConfig_t *SchedulingReqRec, int *period, int *offset);
|
|
|
|
void csi_period_offset(NR_CSI_ReportConfig_t *csirep,
|
|
struct NR_CSI_ResourcePeriodicityAndOffset *periodicityAndOffset,
|
|
int *period, int *offset);
|
|
|
|
void reverse_n_bits(uint8_t *value, uint16_t bitlen);
|
|
|
|
bool set_dl_ptrs_values(NR_PTRS_DownlinkConfig_t *ptrs_config,
|
|
uint16_t rbSize, uint8_t mcsIndex, uint8_t mcsTable,
|
|
uint8_t *K_ptrs, uint8_t *L_ptrs,uint8_t *portIndex,
|
|
uint8_t *nERatio,uint8_t *reOffset,
|
|
uint8_t NrOfSymbols);
|
|
|
|
bool set_ul_ptrs_values(NR_PTRS_UplinkConfig_t *ul_ptrs_config,
|
|
uint16_t rbSize,uint8_t mcsIndex, uint8_t mcsTable,
|
|
uint8_t *K_ptrs, uint8_t *L_ptrs,
|
|
uint8_t *reOffset, uint8_t *maxNumPorts, uint8_t *ulPower,
|
|
uint8_t NrOfSymbols);
|
|
|
|
/* \brief Set the transform precoding according to 6.1.3 of 3GPP TS 38.214 version 16.3.0 Release 16
|
|
@param *pusch_config, pointer to pusch config
|
|
@param *ubwp pointer to uplink bwp
|
|
@param *dci_format pointer to dci format
|
|
@param rnti_type rnti type
|
|
@param configuredGrant indicates whether a configured grant was received or not
|
|
@returns transformPrecoding value */
|
|
uint8_t get_transformPrecoding(const NR_BWP_UplinkCommon_t *initialUplinkBWP,
|
|
const NR_PUSCH_Config_t *pusch_config,
|
|
const NR_BWP_UplinkDedicated_t *ubwp,
|
|
uint8_t *dci_format,
|
|
int rnti_type,
|
|
uint8_t configuredGrant);
|
|
|
|
void nr_mac_gNB_rrc_ul_failure(const module_id_t Mod_instP,
|
|
const int CC_idP,
|
|
const frame_t frameP,
|
|
const sub_frame_t subframeP,
|
|
const rnti_t rntiP);
|
|
|
|
void nr_mac_gNB_rrc_ul_failure_reset(const module_id_t Mod_instP,
|
|
const frame_t frameP,
|
|
const sub_frame_t subframeP,
|
|
const rnti_t rntiP);
|
|
|
|
uint8_t number_of_bits_set(uint8_t buf);
|
|
|
|
void compute_rsrp_bitlen(struct NR_CSI_ReportConfig *csi_reportconfig,
|
|
uint8_t nb_resources,
|
|
nr_csi_report_t *csi_report);
|
|
|
|
uint8_t compute_ri_bitlen(struct NR_CSI_ReportConfig *csi_reportconfig,
|
|
nr_csi_report_t *csi_report);
|
|
|
|
void compute_li_bitlen(struct NR_CSI_ReportConfig *csi_reportconfig,
|
|
uint8_t ri_restriction,
|
|
nr_csi_report_t *csi_report);
|
|
|
|
void get_n1n2_o1o2_singlepanel(int *n1, int *n2, int *o1, int *o2,
|
|
struct NR_CodebookConfig__codebookType__type1__subType__typeI_SinglePanel__nrOfAntennaPorts__moreThanTwo *morethantwo);
|
|
|
|
void get_x1x2_bitlen_singlepanel(int n1, int n2, int o1, int o2,
|
|
int *x1, int *x2, int rank, int codebook_mode);
|
|
|
|
void compute_pmi_bitlen(struct NR_CSI_ReportConfig *csi_reportconfig,
|
|
uint8_t ri_restriction,
|
|
nr_csi_report_t *csi_report);
|
|
|
|
void compute_cqi_bitlen(struct NR_CSI_ReportConfig *csi_reportconfig,
|
|
uint8_t ri_restriction,
|
|
nr_csi_report_t *csi_report);
|
|
|
|
void compute_csi_bitlen(NR_CSI_MeasConfig_t *csi_MeasConfig, nr_csi_report_t *csi_report_template);
|
|
|
|
uint16_t nr_get_csi_bitlen(nr_csi_report_t *csi_report_template, uint8_t csi_report_id);
|
|
|
|
#endif
|