2020-11-26 01:25:22 -08:00
|
|
|
/**
|
2017-06-02 03:46:06 -07:00
|
|
|
*
|
2020-11-26 01:25:22 -08:00
|
|
|
* \section COPYRIGHT
|
2017-06-02 03:46:06 -07:00
|
|
|
*
|
2021-03-19 03:45:56 -07:00
|
|
|
* Copyright 2013-2021 Software Radio Systems Limited
|
2017-06-02 03:46:06 -07:00
|
|
|
*
|
2020-11-26 01:25:22 -08:00
|
|
|
* By using this file, you agree to the terms and conditions set
|
|
|
|
* forth in the LICENSE file which can be found at the top level of
|
|
|
|
* the distribution.
|
2017-06-02 03:46:06 -07:00
|
|
|
*
|
|
|
|
*/
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2018-03-31 10:04:04 -07:00
|
|
|
#ifndef SRSENB_SCHEDULER_UE_H
|
|
|
|
#define SRSENB_SCHEDULER_UE_H
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2021-06-25 11:58:10 -07:00
|
|
|
#include "sched_lte_common.h"
|
2020-12-01 14:11:38 -08:00
|
|
|
#include "sched_ue_ctrl/sched_lch.h"
|
2021-01-14 11:54:48 -08:00
|
|
|
#include "sched_ue_ctrl/sched_ue_cell.h"
|
2020-12-01 14:11:38 -08:00
|
|
|
#include "sched_ue_ctrl/tpc.h"
|
2021-05-06 11:53:48 -07:00
|
|
|
#include "srsenb/hdr/common/common_enb.h"
|
|
|
|
#include "srsran/srslog/srslog.h"
|
2020-11-02 11:43:20 -08:00
|
|
|
#include <bitset>
|
2021-05-06 11:53:48 -07:00
|
|
|
#include <map>
|
|
|
|
#include <vector>
|
2017-06-01 03:25:57 -07:00
|
|
|
|
|
|
|
namespace srsenb {
|
|
|
|
|
2020-08-25 13:30:35 -07:00
|
|
|
typedef enum { UCI_PUSCH_NONE = 0, UCI_PUSCH_CQI, UCI_PUSCH_ACK, UCI_PUSCH_ACK_CQI } uci_pusch_t;
|
|
|
|
|
2018-07-05 02:00:19 -07:00
|
|
|
/** This class is designed to be thread-safe because it is called from workers through scheduler thread and from
|
|
|
|
* higher layers and mac threads.
|
|
|
|
*/
|
2019-10-17 08:53:06 -07:00
|
|
|
class sched_ue
|
|
|
|
{
|
2021-09-01 02:02:36 -07:00
|
|
|
using ue_cfg_t = sched_interface::ue_cfg_t;
|
2020-11-27 16:44:03 -08:00
|
|
|
|
2019-04-23 01:53:11 -07:00
|
|
|
public:
|
2021-02-16 09:23:15 -08:00
|
|
|
sched_ue(uint16_t rnti, const std::vector<sched_cell_params_t>& cell_list_params_, const ue_cfg_t& cfg);
|
2020-11-27 16:44:03 -08:00
|
|
|
void new_subframe(tti_point tti_rx, uint32_t enb_cc_idx);
|
2020-10-12 14:23:42 -07:00
|
|
|
|
2017-06-01 03:25:57 -07:00
|
|
|
/*************************************************************
|
2019-10-17 08:53:06 -07:00
|
|
|
*
|
|
|
|
* FAPI-like Interface
|
|
|
|
*
|
2017-06-01 03:25:57 -07:00
|
|
|
************************************************************/
|
|
|
|
|
2020-11-27 16:44:03 -08:00
|
|
|
void phy_config_enabled(tti_point tti_rx, bool enabled);
|
|
|
|
void set_cfg(const ue_cfg_t& cfg);
|
|
|
|
|
2021-09-01 02:02:36 -07:00
|
|
|
void set_bearer_cfg(uint32_t lc_id, const mac_lc_ch_cfg_t& cfg);
|
2017-06-01 03:25:57 -07:00
|
|
|
void rem_bearer(uint32_t lc_id);
|
2019-10-17 08:53:06 -07:00
|
|
|
|
2017-06-01 03:25:57 -07:00
|
|
|
void dl_buffer_state(uint8_t lc_id, uint32_t tx_queue, uint32_t retx_queue);
|
2020-06-27 08:05:20 -07:00
|
|
|
void ul_buffer_state(uint8_t lcg_id, uint32_t bsr);
|
2021-06-02 08:31:17 -07:00
|
|
|
void ul_phr(int phr, uint32_t grant_nof_prb);
|
2020-04-21 06:11:52 -07:00
|
|
|
void mac_buffer_state(uint32_t ce_code, uint32_t nof_cmds);
|
2020-03-02 06:14:13 -08:00
|
|
|
|
2020-12-01 14:11:38 -08:00
|
|
|
void set_ul_snr(tti_point tti_rx, uint32_t enb_cc_idx, float snr, uint32_t ul_ch_code);
|
2020-11-27 16:44:03 -08:00
|
|
|
void set_dl_ri(tti_point tti_rx, uint32_t enb_cc_idx, uint32_t ri);
|
|
|
|
void set_dl_pmi(tti_point tti_rx, uint32_t enb_cc_idx, uint32_t ri);
|
|
|
|
void set_dl_cqi(tti_point tti_rx, uint32_t enb_cc_idx, uint32_t cqi);
|
2021-07-15 04:06:42 -07:00
|
|
|
void set_dl_sb_cqi(tti_point tti_rx, uint32_t enb_cc_idx, uint32_t sb_idx, uint32_t cqi);
|
2020-11-27 16:44:03 -08:00
|
|
|
int set_ack_info(tti_point tti_rx, uint32_t enb_cc_idx, uint32_t tb_idx, bool ack);
|
|
|
|
void set_ul_crc(tti_point tti_rx, uint32_t enb_cc_idx, bool crc_res);
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2019-10-17 08:53:06 -07:00
|
|
|
/*******************************************************
|
|
|
|
* Custom functions
|
|
|
|
*******************************************************/
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2021-01-15 09:31:58 -08:00
|
|
|
const dl_harq_proc& get_dl_harq(uint32_t idx, uint32_t enb_cc_idx) const;
|
2020-11-27 16:44:03 -08:00
|
|
|
uint16_t get_rnti() const { return rnti; }
|
|
|
|
std::pair<bool, uint32_t> get_active_cell_index(uint32_t enb_cc_idx) const;
|
|
|
|
const ue_cfg_t& get_ue_cfg() const { return cfg; }
|
2021-01-15 09:31:58 -08:00
|
|
|
uint32_t get_aggr_level(uint32_t enb_cc_idx, uint32_t nof_bits);
|
2020-11-27 16:44:03 -08:00
|
|
|
void ul_buffer_add(uint8_t lcid, uint32_t bytes);
|
2019-04-23 01:53:11 -07:00
|
|
|
|
|
|
|
/*******************************************************
|
|
|
|
* Functions used by scheduler metric objects
|
|
|
|
*******************************************************/
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2021-01-15 09:31:58 -08:00
|
|
|
uint32_t get_required_prb_ul(uint32_t enb_cc_idx, uint32_t req_bytes);
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2021-04-30 06:08:27 -07:00
|
|
|
/// Get total pending bytes to be transmitted in DL.
|
|
|
|
/// The amount of CEs to transmit depends on whether enb_cc_idx is UE's PCell
|
2021-05-14 02:56:58 -07:00
|
|
|
uint32_t get_pending_dl_bytes(uint32_t enb_cc_idx);
|
|
|
|
srsran::interval<uint32_t> get_requested_dl_bytes(uint32_t enb_cc_idx);
|
|
|
|
rbg_interval get_required_dl_rbgs(uint32_t enb_cc_idx);
|
|
|
|
uint32_t get_pending_dl_rlc_data() const;
|
|
|
|
uint32_t get_expected_dl_bitrate(uint32_t enb_cc_idx, int nof_rbgs = -1) const;
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2021-01-15 09:31:58 -08:00
|
|
|
uint32_t get_pending_ul_data_total(tti_point tti_tx_ul, int this_enb_cc_idx);
|
|
|
|
uint32_t get_pending_ul_new_data(tti_point tti_tx_ul, int this_enb_cc_idx);
|
2020-11-06 09:01:04 -08:00
|
|
|
uint32_t get_pending_ul_old_data();
|
2021-01-15 09:31:58 -08:00
|
|
|
uint32_t get_pending_ul_old_data(uint32_t enb_cc_idx);
|
|
|
|
uint32_t get_expected_ul_bitrate(uint32_t enb_cc_idx, int nof_prbs = -1) const;
|
2020-11-06 09:01:04 -08:00
|
|
|
|
2021-01-15 09:31:58 -08:00
|
|
|
dl_harq_proc* get_pending_dl_harq(tti_point tti_tx_dl, uint32_t enb_cc_idx);
|
|
|
|
dl_harq_proc* get_empty_dl_harq(tti_point tti_tx_dl, uint32_t enb_cc_idx);
|
|
|
|
ul_harq_proc* get_ul_harq(tti_point tti_tx_ul, uint32_t enb_cc_idx);
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2019-12-02 11:25:34 -08:00
|
|
|
/*******************************************************
|
|
|
|
* Functions used by the scheduler carrier object
|
|
|
|
*******************************************************/
|
|
|
|
|
2020-11-27 16:44:03 -08:00
|
|
|
void finish_tti(tti_point tti_rx, uint32_t enb_cc_idx);
|
2019-12-02 11:25:34 -08:00
|
|
|
|
2019-04-23 01:53:11 -07:00
|
|
|
/*******************************************************
|
|
|
|
* Functions used by the scheduler object
|
|
|
|
*******************************************************/
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2019-10-17 08:53:06 -07:00
|
|
|
void set_sr();
|
|
|
|
void unset_sr();
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2020-03-09 04:23:23 -07:00
|
|
|
int generate_dl_dci_format(uint32_t pid,
|
|
|
|
sched_interface::dl_sched_data_t* data,
|
2020-11-27 16:44:03 -08:00
|
|
|
tti_point tti_tx_dl,
|
2021-01-15 09:31:58 -08:00
|
|
|
uint32_t enb_cc_idx,
|
2020-03-09 04:23:23 -07:00
|
|
|
uint32_t cfi,
|
|
|
|
const rbgmask_t& user_mask);
|
2019-04-26 06:57:50 -07:00
|
|
|
int generate_format0(sched_interface::ul_sched_data_t* data,
|
2020-11-27 16:44:03 -08:00
|
|
|
tti_point tti_tx_ul,
|
2021-01-15 09:31:58 -08:00
|
|
|
uint32_t enb_cc_idx,
|
2020-08-11 09:06:12 -07:00
|
|
|
prb_interval alloc,
|
2019-04-26 06:57:50 -07:00
|
|
|
bool needs_pdcch,
|
2021-03-19 03:45:56 -07:00
|
|
|
srsran_dci_location_t cce_range,
|
2020-07-06 06:05:17 -07:00
|
|
|
int explicit_mcs = -1,
|
2020-08-25 13:30:35 -07:00
|
|
|
uci_pusch_t uci_type = UCI_PUSCH_NONE);
|
2017-10-26 08:09:28 -07:00
|
|
|
|
2021-03-19 03:45:56 -07:00
|
|
|
srsran_dci_format_t get_dci_format();
|
2021-02-15 08:18:56 -08:00
|
|
|
const cce_cfi_position_table* get_locations(uint32_t enb_cc_idx, uint32_t current_cfi, uint32_t sf_idx) const;
|
2020-11-02 11:43:20 -08:00
|
|
|
|
2021-01-18 03:09:48 -08:00
|
|
|
sched_ue_cell* find_ue_carrier(uint32_t enb_cc_idx);
|
2021-01-18 04:35:59 -08:00
|
|
|
size_t nof_carriers_configured() const { return cfg.supported_cc_list.size(); }
|
2021-03-19 03:45:56 -07:00
|
|
|
std::bitset<SRSRAN_MAX_CARRIERS> scell_activation_mask() const;
|
2020-11-06 04:51:07 -08:00
|
|
|
int enb_to_ue_cc_idx(uint32_t enb_cc_idx) const;
|
2019-10-17 08:53:06 -07:00
|
|
|
|
|
|
|
uint32_t get_max_retx();
|
|
|
|
|
2020-11-27 16:44:03 -08:00
|
|
|
bool pdsch_enabled(tti_point tti_rx, uint32_t enb_cc_idx) const;
|
|
|
|
bool pusch_enabled(tti_point tti_rx, uint32_t enb_cc_idx, bool needs_pdcch) const;
|
2021-05-31 09:32:51 -07:00
|
|
|
bool phich_enabled(tti_point tti_rx, uint32_t enb_cc_idx) const;
|
2019-10-17 08:53:06 -07:00
|
|
|
|
|
|
|
private:
|
|
|
|
bool is_sr_triggered();
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2021-01-14 09:47:17 -08:00
|
|
|
tbs_info allocate_new_dl_mac_pdu(sched_interface::dl_sched_data_t* data,
|
|
|
|
dl_harq_proc* h,
|
|
|
|
const rbgmask_t& user_mask,
|
|
|
|
tti_point tti_tx_dl,
|
2021-01-15 09:31:58 -08:00
|
|
|
uint32_t enb_cc_idx,
|
2021-01-14 09:47:17 -08:00
|
|
|
uint32_t cfi,
|
|
|
|
uint32_t tb);
|
|
|
|
|
2021-01-15 09:31:58 -08:00
|
|
|
tbs_info compute_mcs_and_tbs(uint32_t enb_cc_idx,
|
2021-01-14 09:47:17 -08:00
|
|
|
tti_point tti_tx_dl,
|
2021-05-12 11:30:42 -07:00
|
|
|
const rbgmask_t& rbgs,
|
2021-01-14 09:47:17 -08:00
|
|
|
uint32_t cfi,
|
2021-03-19 03:45:56 -07:00
|
|
|
const srsran_dci_dl_t& dci);
|
2020-03-06 10:43:15 -08:00
|
|
|
|
2021-01-15 09:31:58 -08:00
|
|
|
bool needs_cqi(uint32_t tti, uint32_t enb_cc_idx, bool will_send = false);
|
2018-07-05 02:00:19 -07:00
|
|
|
|
2021-03-05 09:19:22 -08:00
|
|
|
int generate_format1_common(uint32_t pid,
|
|
|
|
sched_interface::dl_sched_data_t* data,
|
|
|
|
tti_point tti_tx_dl,
|
|
|
|
uint32_t enb_cc_idx,
|
|
|
|
uint32_t cfi,
|
|
|
|
const rbgmask_t& user_mask);
|
2020-03-09 04:23:23 -07:00
|
|
|
int generate_format1(uint32_t pid,
|
|
|
|
sched_interface::dl_sched_data_t* data,
|
2020-11-27 16:44:03 -08:00
|
|
|
tti_point tti_tx_dl,
|
2021-01-15 09:31:58 -08:00
|
|
|
uint32_t enb_cc_idx,
|
2020-03-09 04:23:23 -07:00
|
|
|
uint32_t cfi,
|
|
|
|
const rbgmask_t& user_mask);
|
2021-02-12 12:57:32 -08:00
|
|
|
int generate_format1a(uint32_t pid,
|
|
|
|
sched_interface::dl_sched_data_t* data,
|
|
|
|
tti_point tti_tx_dl,
|
|
|
|
uint32_t enb_cc_idx,
|
|
|
|
uint32_t cfi,
|
|
|
|
const rbgmask_t& user_mask);
|
2020-03-09 04:23:23 -07:00
|
|
|
int generate_format2a(uint32_t pid,
|
|
|
|
sched_interface::dl_sched_data_t* data,
|
2020-11-27 16:44:03 -08:00
|
|
|
tti_point tti_tx_dl,
|
2021-01-15 09:31:58 -08:00
|
|
|
uint32_t enb_cc_idx,
|
2020-03-09 04:23:23 -07:00
|
|
|
uint32_t cfi,
|
|
|
|
const rbgmask_t& user_mask);
|
|
|
|
int generate_format2(uint32_t pid,
|
|
|
|
sched_interface::dl_sched_data_t* data,
|
2020-11-27 16:44:03 -08:00
|
|
|
tti_point tti_tx_dl,
|
2021-01-15 09:31:58 -08:00
|
|
|
uint32_t enb_cc_idx,
|
2020-03-09 04:23:23 -07:00
|
|
|
uint32_t cfi,
|
|
|
|
const rbgmask_t& user_mask);
|
2018-07-05 02:00:19 -07:00
|
|
|
|
2019-12-02 03:54:05 -08:00
|
|
|
/* Args */
|
2021-01-14 11:54:48 -08:00
|
|
|
ue_cfg_t cfg = {};
|
2021-03-19 03:45:56 -07:00
|
|
|
srsran_cell_t cell = {};
|
2021-01-28 03:17:18 -08:00
|
|
|
srslog::basic_logger& logger;
|
2021-01-14 11:54:48 -08:00
|
|
|
const sched_cell_params_t* main_cc_params = nullptr;
|
2018-07-05 02:00:19 -07:00
|
|
|
|
2017-06-01 03:25:57 -07:00
|
|
|
/* Buffer states */
|
2020-11-20 08:45:41 -08:00
|
|
|
bool sr = false;
|
|
|
|
lch_ue_manager lch_handler;
|
2019-11-08 03:53:59 -08:00
|
|
|
|
|
|
|
uint32_t cqi_request_tti = 0;
|
|
|
|
uint16_t rnti = 0;
|
|
|
|
uint32_t max_msg3retx = 0;
|
|
|
|
|
2020-02-06 07:41:58 -08:00
|
|
|
bool phy_config_dedicated_enabled = false;
|
2019-11-29 05:09:06 -08:00
|
|
|
|
2021-01-18 04:35:59 -08:00
|
|
|
tti_point current_tti;
|
2021-01-14 11:54:48 -08:00
|
|
|
std::vector<sched_ue_cell> cells; ///< List of eNB cells that may be configured/activated/deactivated for the UE
|
2019-04-23 01:53:11 -07:00
|
|
|
};
|
2020-10-22 02:04:59 -07:00
|
|
|
|
2021-05-06 11:53:48 -07:00
|
|
|
using sched_ue_list = rnti_map_t<std::unique_ptr<sched_ue> >;
|
2020-10-22 02:04:59 -07:00
|
|
|
|
2019-10-17 08:53:06 -07:00
|
|
|
} // namespace srsenb
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2018-03-31 10:04:04 -07:00
|
|
|
#endif // SRSENB_SCHEDULER_UE_H
|