mirror of
https://gitlab.eurecom.fr/oai/openairinterface5g.git
synced 2026-07-13 04:30:28 +00:00
8107939f08
- all RAN code, CI code, configuration files, dockerfiles, in CSSL v1.0
- all deployment code (openshift, charts, ancillary files like shell
scripts), in MIT
- documentation in CC-BY-4.0
- exceptions might apply and are listed in NOTICE
- there is a new LICENSES folder with all licenses
- CONTRIBUTIONS.md has been updated accordingly
For automated changes based on OAI PL v1.1:
perl -i~ -0pe 's/\/\*.*Licensed to the OpenAirInterface.*openairinterface.org\n#?/\/*\n * SPDX-License-Identifier: LicenseRef-CSSL-1.0\n/s' **/*.{c,h,cpp}
perl -i~ -0pe 's/\/\*.*Licensed to the OpenAirInterface.*openairinterface.org\n#?/\/*\n * SPDX-License-Identifier: LicenseRef-CSSL-1.0\n/s' **/*.ts
perl -i~ -0pe 's/<!--.*Licensed to the OpenAirInterface.*openairinterface.org\n.*-->/<!-- SPDX-License-Identifier: LicenseRef-CSSL-1.0 -->/s' **/*.xml
The rest (cmake, files with missing license, cmake) manually.
258 lines
11 KiB
C
258 lines
11 KiB
C
/*
|
|
* SPDX-License-Identifier: LicenseRef-CSSL-1.0
|
|
*/
|
|
|
|
#ifndef __openair_SCHED_UE_H__
|
|
#define __openair_SCHED_UE_H__
|
|
|
|
#include "PHY/defs_UE.h"
|
|
#include "../SCHED/sched_common.h"
|
|
|
|
/*! \brief Scheduling for UE TX procedures in normal subframes.
|
|
@param phy_vars_ue Pointer to UE variables on which to act
|
|
@param proc Pointer to RXn-TXnp4 proc information
|
|
@param eNB_id Local id of eNB on which to act
|
|
@param abstraction_flag Indicator of PHY abstraction
|
|
@param mode calib/normal mode
|
|
@param r_type indicates the relaying operation: 0: no_relaying, 1: unicast relaying type 1, 2: unicast relaying type 2, 3: multicast relaying
|
|
*/
|
|
void phy_procedures_UE_TX(PHY_VARS_UE *phy_vars_ue,UE_rxtx_proc_t *proc,uint8_t eNB_id,uint8_t abstraction_flag,runmode_t mode);
|
|
/*! \brief Scheduling for UE RX procedures in normal subframes.
|
|
@param last_slot Index of last slot (0-19)
|
|
@param phy_vars_ue Pointer to UE variables on which to act
|
|
@param proc Pointer to RXn_TXnp4 proc information
|
|
@param eNB_id Local id of eNB on which to act
|
|
@param abstraction_flag Indicator of PHY abstraction
|
|
@param mode calibration/debug mode
|
|
@param r_type indicates the relaying operation: 0: no_relaying, 1: unicast relaying type 1, 2: unicast relaying type 2, 3: multicast relaying
|
|
@param phy_vars_rn pointer to RN variables
|
|
*/
|
|
int phy_procedures_UE_RX(PHY_VARS_UE *phy_vars_ue,UE_rxtx_proc_t *proc,uint8_t eNB_id,uint8_t abstraction_flag,uint8_t do_pdcch_flag,runmode_t mode);
|
|
|
|
/*! \brief Scheduling for UE Sidelink RX procedures in normal subframes.
|
|
@param ue Pointer to UE variables on which to act
|
|
@param proc Pointer to RXn_TXnp4 proc information
|
|
*/
|
|
void phy_procedures_UE_SL_RX(PHY_VARS_UE *ue,UE_rxtx_proc_t *proc);
|
|
|
|
/*! \brief Scheduling for UE Sidelink TX procedures in normal subframes.
|
|
@param ue Pointer to UE variables on which to act
|
|
@param proc Pointer to RXn_TXnp4 proc information
|
|
*/
|
|
void phy_procedures_UE_SL_TX(PHY_VARS_UE *ue,UE_rxtx_proc_t *proc);
|
|
|
|
int phy_procedures_slot_parallelization_UE_RX(PHY_VARS_UE *ue,UE_rxtx_proc_t *proc,uint8_t eNB_id,
|
|
uint8_t abstraction_flag,uint8_t do_pdcch_flag,runmode_t mode);
|
|
#ifdef UE_SLOT_PARALLELISATION
|
|
void *UE_thread_slot1_dl_processing(void *arg);
|
|
#endif
|
|
|
|
/*! \brief Scheduling for UE RX procedures in TDD S-subframes.
|
|
@param phy_vars_ue Pointer to UE variables on which to act
|
|
@param eNB_id Local id of eNB on which to act
|
|
@param abstraction_flag Indicator of PHY abstraction
|
|
@param r_type indicates the relaying operation: 0: no_relaying, 1: unicast relaying type 1, 2: unicast relaying type 2, 3: multicast relaying
|
|
*/
|
|
void phy_procedures_UE_S_RX(PHY_VARS_UE *phy_vars_ue,uint8_t eNB_id,uint8_t abstraction_flag);
|
|
|
|
/*! \brief Get ULSCH harq_pid for Msg3 from RAR subframe. This returns n+k mod 10 (k>6) and corresponds to the rule in Section 6.1.1 from 36.213
|
|
@param frame_parms Pointer to DL Frame Parameters
|
|
@param frame Frame index
|
|
@param current_subframe subframe of RAR transmission
|
|
@returns harq_pid (0 ... 7)
|
|
*/
|
|
uint8_t get_Msg3_harq_pid(LTE_DL_FRAME_PARMS *frame_parms,uint32_t frame,uint8_t current_subframe);
|
|
|
|
/*! \brief Get ULSCH harq_pid from PHICH subframe
|
|
@param frame_parms Pointer to DL Frame Parameters
|
|
@param subframe subframe of PHICH
|
|
@returns harq_pid (0 ... 7)
|
|
*/
|
|
|
|
/*! \brief Function to indicate failure of contention resolution or RA procedure. It places the UE back in PRACH mode.
|
|
@param Mod_id Instance index of UE
|
|
@param CC_id Component Carrier Index
|
|
@param eNB_index Index of eNB
|
|
*/
|
|
void ra_failed(uint8_t Mod_id,uint8_t CC_id,uint8_t eNB_index);
|
|
|
|
/*! \brief Function to indicate success of contention resolution or RA procedure.
|
|
@param Mod_id Instance index of UE
|
|
@param CC_id Component Carrier Index
|
|
@param eNB_index Index of eNB
|
|
*/
|
|
void ra_succeeded(uint8_t Mod_id,uint8_t CC_id,uint8_t eNB_index);
|
|
|
|
uint8_t phich_subframe_to_harq_pid(LTE_DL_FRAME_PARMS *frame_parms,uint32_t frame,uint8_t subframe);
|
|
|
|
/*! \brief Get PDSCH subframe (n+k) from PDCCH subframe n using relationship from Table 8-2 from 36.213
|
|
@param frame_parms Pointer to DL Frame Parameters
|
|
@param n subframe of PDCCH
|
|
@returns PDSCH subframe (0 ... 7) (note: this is n+k from Table 8-2)
|
|
*/
|
|
uint8_t pdcch_alloc2ul_subframe(LTE_DL_FRAME_PARMS *frame_parms,uint8_t n);
|
|
|
|
|
|
/*! \brief Compute ACK/NACK information for PUSCH/PUCCH for UE transmission in subframe n. This function implements table 10.1-1 of 36.213, p. 69.
|
|
@param frame_parms Pointer to DL frame parameter descriptor
|
|
@param harq_ack Pointer to dlsch_ue harq_ack status descriptor
|
|
@param subframe Subframe for UE transmission (n in 36.213)
|
|
@param o_ACK Pointer to ACK/NAK payload for PUCCH/PUSCH
|
|
@returns status indicator for PUCCH/PUSCH transmission
|
|
*/
|
|
uint8_t get_ack(LTE_DL_FRAME_PARMS *frame_parms,harq_status_t *harq_ack,uint8_t subframe_tx,uint8_t subframe_rx,uint8_t *o_ACK, uint8_t cw_idx);
|
|
|
|
/*! \brief Reset ACK/NACK information
|
|
@param frame_parms Pointer to DL frame parameter descriptor
|
|
@param harq_ack Pointer to dlsch_ue harq_ack status descriptor
|
|
@param subframe Subframe for UE transmission (n in 36.213)
|
|
@param o_ACK Pointer to ACK/NAK payload for PUCCH/PUSCH
|
|
@returns status indicator for PUCCH/PUSCH transmission
|
|
*/
|
|
uint8_t reset_ack(LTE_DL_FRAME_PARMS *frame_parms,
|
|
harq_status_t *harq_ack,
|
|
unsigned char subframe_tx,
|
|
unsigned char subframe_rx,
|
|
unsigned char *o_ACK,
|
|
uint8_t *pN_bundled,
|
|
uint8_t cw_idx);
|
|
|
|
/*! \brief Compute UL ACK subframe from DL subframe. This is used to retrieve corresponding DLSCH HARQ pid at eNB upon reception of ACK/NAK information on PUCCH/PUSCH. Derived from Table 10.1-1 in 36.213 (p. 69 in version 8.6)
|
|
@param frame_parms Pointer to DL frame parameter descriptor
|
|
@param subframe Subframe for UE transmission (n in 36.213)
|
|
@param ACK_index TTI bundling index (0,1)
|
|
@returns Subframe index for corresponding DL transmission
|
|
*/
|
|
uint8_t ul_ACK_subframe2_dl_subframe(LTE_DL_FRAME_PARMS *frame_parms,uint8_t subframe,uint8_t ACK_index);
|
|
|
|
/*! \brief Computes number of DL subframes represented by a particular ACK received on UL (M from Table 10.1-1 in 36.213, p. 69 in version 8.6)
|
|
@param frame_parms Pointer to DL frame parameter descriptor
|
|
@param subframe Subframe for UE transmission (n in 36.213)
|
|
@returns Number of DL subframes (M)
|
|
*/
|
|
uint8_t ul_ACK_subframe2_M(LTE_DL_FRAME_PARMS *frame_parms,unsigned char subframe);
|
|
|
|
/*! \brief Indicates the SR TXOp in current subframe. Implements Table 10.1-5 from 36.213.
|
|
@param phy_vars_ue Pointer to UE variables
|
|
@param proc Pointer to RXn_TXnp4 thread context
|
|
@param eNB_id ID of eNB which is to receive the SR
|
|
@returns 1 if TXOp is active.
|
|
*/
|
|
uint8_t is_SR_TXOp(PHY_VARS_UE *phy_vars_ue,UE_rxtx_proc_t *proc,uint8_t eNB_id);
|
|
|
|
uint8_t pdcch_alloc2ul_subframe(LTE_DL_FRAME_PARMS *frame_parms,uint8_t n);
|
|
|
|
/*! \brief Gives the UL frame corresponding to a PDDCH order in subframe n
|
|
@param frame_parms Pointer to DL frame parameters
|
|
@param frame Frame of received PDCCH
|
|
@param n subframe of PDCCH
|
|
@returns UL frame corresponding to pdcch order
|
|
*/
|
|
uint32_t pdcch_alloc2ul_frame(LTE_DL_FRAME_PARMS *frame_parms,uint32_t frame, uint8_t n);
|
|
|
|
|
|
uint16_t get_Np(uint8_t N_RB_DL,uint8_t nCCE,uint8_t plus1);
|
|
|
|
|
|
|
|
void process_timing_advance(module_id_t Mod_id,uint8_t CC_id,int16_t timing_advance);
|
|
void process_timing_advance_rar(PHY_VARS_UE *phy_vars_ue,UE_rxtx_proc_t *proc,uint16_t timing_advance);
|
|
|
|
unsigned int get_tx_amp(int power_dBm, int power_max_dBm, int N_RB_UL, int nb_rb);
|
|
|
|
void phy_reset_ue(module_id_t Mod_id,uint8_t CC_id,uint8_t eNB_index);
|
|
|
|
/*! \brief This function retrives the resource (n1_pucch) corresponding to a PDSCH transmission in
|
|
subframe n-4 which is acknowledged in subframe n (for FDD) according to n1_pucch = Ncce + N1_pucch. For
|
|
TDD, this routine computes the complex procedure described in Section 10.1 of 36.213 (through tables 10.1-1,10.1-2)
|
|
@param phy_vars_ue Pointer to UE variables
|
|
@param proc Pointer to RXn-TXnp4 proc information
|
|
@param harq_ack Pointer to dlsch_ue harq_ack status descriptor
|
|
@param eNB_id Index of eNB
|
|
@param b Pointer to PUCCH payload (b[0],b[1])
|
|
@param SR 1 means there's a positive SR in parallel to ACK/NAK
|
|
@returns n1_pucch
|
|
*/
|
|
uint16_t get_n1_pucch(PHY_VARS_UE *phy_vars_ue,
|
|
UE_rxtx_proc_t *proc,
|
|
harq_status_t *harq_ack,
|
|
uint8_t eNB_id,
|
|
uint8_t *b,
|
|
uint8_t SR);
|
|
|
|
|
|
|
|
|
|
/*! \brief This function retrieves the PHY UE mode. It is used as a helper function for the UE MAC.
|
|
@param Mod_id Local UE index on which to act
|
|
@param CC_id Component Carrier Index
|
|
@param eNB_index ID of eNB
|
|
@returns UE mode
|
|
*/
|
|
UE_MODE_t get_ue_mode(uint8_t Mod_id,uint8_t CC_id,uint8_t eNB_index);
|
|
|
|
/*! \brief This function implements the power control mechanism for PUCCH from 36.213.
|
|
@param phy_vars_ue PHY variables
|
|
@param proc Pointer to proc descriptor
|
|
@param eNB_id Index of eNB
|
|
@param pucch_fmt Format of PUCCH that is being transmitted
|
|
@returns Transmit power
|
|
*/
|
|
int16_t pucch_power_cntl(PHY_VARS_UE *ue,UE_rxtx_proc_t *proc,uint8_t subframe,uint8_t eNB_id,PUCCH_FMT_t pucch_fmt);
|
|
|
|
/*! \brief This function implements the power control mechanism for PUCCH from 36.213.
|
|
@param phy_vars_ue PHY variables
|
|
@param proc Pointer to proc descriptor
|
|
@param eNB_id Index of eNB
|
|
@param j index of type of PUSCH (SPS, Normal, Msg3)
|
|
@returns Transmit power
|
|
*/
|
|
void pusch_power_cntl(PHY_VARS_UE *phy_vars_ue,UE_rxtx_proc_t *proc,uint8_t eNB_id,uint8_t j, uint8_t abstraction_flag);
|
|
|
|
/*! \brief This function implements the power control mechanism for SRS from 36.213.
|
|
@param phy_vars_ue PHY variables
|
|
@param proc Pointer to proc descriptor
|
|
@param eNB_id Index of eNB
|
|
@param j index of type of PUSCH (SPS, Normal, Msg3)
|
|
@returns Transmit power
|
|
*/
|
|
void srs_power_cntl(PHY_VARS_UE *ue,UE_rxtx_proc_t *proc,uint8_t eNB_id,uint8_t *pnb_rb_srs, uint8_t abstraction_flag);
|
|
|
|
void get_cqipmiri_params(PHY_VARS_UE *ue,uint8_t eNB_id);
|
|
|
|
int8_t get_PHR(uint8_t Mod_id, uint8_t CC_id, uint8_t eNB_index);
|
|
|
|
|
|
|
|
LTE_DL_FRAME_PARMS *get_lte_frame_parms(module_id_t Mod_id, uint8_t CC_id);
|
|
|
|
MU_MIMO_mode* get_mu_mimo_mode (module_id_t Mod_id, uint8_t CC_id, rnti_t rnti);
|
|
|
|
int16_t get_hundred_times_delta_IF(PHY_VARS_UE *phy_vars_ue,uint8_t eNB_id,uint8_t harq_pid);
|
|
|
|
|
|
int16_t get_hundred_times_delta_IF_mac(module_id_t module_idP, uint8_t CC_id, rnti_t rnti, uint8_t harq_pid);
|
|
|
|
int16_t get_target_pusch_rx_power(module_id_t module_idP, uint8_t CC_id);
|
|
int16_t get_target_pucch_rx_power(module_id_t module_idP, uint8_t CC_id);
|
|
|
|
int get_ue_active_harq_pid(uint8_t Mod_id,uint8_t CC_id,uint16_t rnti,int frame, uint8_t subframe,uint8_t *harq_pid,uint8_t *round,uint8_t ul_flag);
|
|
|
|
void dump_dlsch(PHY_VARS_UE *phy_vars_ue,UE_rxtx_proc_t *proc,uint8_t eNB_id,uint8_t subframe,uint8_t harq_pid);
|
|
void dump_dlsch_SI(PHY_VARS_UE *phy_vars_ue,UE_rxtx_proc_t *proc,uint8_t eNB_id,uint8_t subframe);
|
|
void dump_dlsch_ra(PHY_VARS_UE *phy_vars_ue,UE_rxtx_proc_t *proc,uint8_t eNB_id,uint8_t subframe);
|
|
|
|
void dump_dlsch2(PHY_VARS_UE *phy_vars_ue,uint8_t eNB_id,uint8_t subframe, unsigned int *coded_bits_per_codeword,int round, unsigned char harq_pid);
|
|
|
|
|
|
int is_srs_occasion_common(LTE_DL_FRAME_PARMS *frame_parms,int frame_tx,int subframe_tx);
|
|
|
|
void compute_srs_pos(frame_type_t frameType,uint16_t isrs,uint16_t *psrsPeriodicity,uint16_t *psrsOffset);
|
|
|
|
/*@}*/
|
|
|
|
|
|
#endif
|
|
|
|
|