2019-04-26 12:27:38 -07:00
|
|
|
/*
|
2020-03-13 04:12:52 -07:00
|
|
|
* Copyright 2013-2020 Software Radio Systems Limited
|
2017-06-02 03:46:06 -07:00
|
|
|
*
|
|
|
|
* This file is part of srsLTE.
|
|
|
|
*
|
2019-04-26 12:27:38 -07:00
|
|
|
* srsLTE is free software: you can redistribute it and/or modify
|
2017-06-02 03:46:06 -07:00
|
|
|
* 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.
|
|
|
|
*
|
2019-04-26 12:27:38 -07:00
|
|
|
* srsLTE is distributed in the hope that it will be useful,
|
2017-06-02 03:46:06 -07:00
|
|
|
* 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/.
|
|
|
|
*
|
|
|
|
*/
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2018-03-31 10:04:04 -07:00
|
|
|
#ifndef SRSENB_SCHEDULER_H
|
|
|
|
#define SRSENB_SCHEDULER_H
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2019-06-06 07:52:37 -07:00
|
|
|
#include "scheduler_grid.h"
|
2019-04-23 01:53:11 -07:00
|
|
|
#include "scheduler_harq.h"
|
|
|
|
#include "scheduler_ue.h"
|
2017-06-01 03:25:57 -07:00
|
|
|
#include "srslte/common/log.h"
|
|
|
|
#include "srslte/interfaces/enb_interfaces.h"
|
|
|
|
#include "srslte/interfaces/sched_interface.h"
|
2019-04-23 01:53:11 -07:00
|
|
|
#include <map>
|
2019-07-01 02:38:38 -07:00
|
|
|
#include <mutex>
|
2017-06-01 03:25:57 -07:00
|
|
|
#include <pthread.h>
|
2019-11-08 03:53:59 -08:00
|
|
|
#include <queue>
|
2017-06-01 03:25:57 -07:00
|
|
|
|
|
|
|
namespace srsenb {
|
2018-07-05 02:00:19 -07:00
|
|
|
|
2019-10-16 08:55:37 -07:00
|
|
|
namespace sched_utils {
|
|
|
|
|
|
|
|
inline bool is_in_tti_interval(uint32_t tti, uint32_t tti1, uint32_t tti2)
|
|
|
|
{
|
|
|
|
tti %= 10240;
|
|
|
|
tti1 %= 10240;
|
|
|
|
tti2 %= 10240;
|
|
|
|
if (tti1 <= tti2) {
|
|
|
|
return tti >= tti1 and tti <= tti2;
|
|
|
|
}
|
|
|
|
return tti >= tti1 or tti <= tti2;
|
|
|
|
}
|
|
|
|
|
|
|
|
} // namespace sched_utils
|
2018-07-05 02:00:19 -07:00
|
|
|
|
|
|
|
/* Caution: User addition (ue_cfg) and removal (ue_rem) are not thread-safe
|
|
|
|
* Rest of operations are thread-safe
|
|
|
|
*
|
|
|
|
* The subclass sched_ue is thread-safe so that access to shared variables like buffer states
|
|
|
|
* from scheduler thread and other threads is protected for each individual user.
|
|
|
|
*/
|
|
|
|
|
2017-06-01 03:25:57 -07:00
|
|
|
class sched : public sched_interface
|
2019-04-26 06:57:50 -07:00
|
|
|
{
|
|
|
|
public:
|
2017-06-01 03:25:57 -07:00
|
|
|
/*************************************************************
|
2019-10-15 08:35:12 -07:00
|
|
|
*
|
2017-06-01 03:25:57 -07:00
|
|
|
* Scheduling metric interface definition
|
2019-10-15 08:35:12 -07:00
|
|
|
*
|
2017-06-01 03:25:57 -07:00
|
|
|
************************************************************/
|
2019-04-26 06:57:50 -07:00
|
|
|
|
2017-06-01 03:25:57 -07:00
|
|
|
class metric_dl
|
|
|
|
{
|
2019-10-16 10:11:38 -07:00
|
|
|
public:
|
2017-06-01 03:25:57 -07:00
|
|
|
/* Virtual methods for user metric calculation */
|
2020-01-31 03:17:04 -08:00
|
|
|
virtual void set_params(const sched_cell_params_t& cell_params_) = 0;
|
2020-01-22 11:52:27 -08:00
|
|
|
virtual void sched_users(std::map<uint16_t, sched_ue>& ue_db, dl_sf_sched_itf* tti_sched) = 0;
|
2017-06-01 03:25:57 -07:00
|
|
|
};
|
|
|
|
|
|
|
|
class metric_ul
|
|
|
|
{
|
2019-10-16 10:11:38 -07:00
|
|
|
public:
|
2017-06-01 03:25:57 -07:00
|
|
|
/* Virtual methods for user metric calculation */
|
2020-01-31 03:17:04 -08:00
|
|
|
virtual void set_params(const sched_cell_params_t& cell_params_) = 0;
|
2020-01-22 11:52:27 -08:00
|
|
|
virtual void sched_users(std::map<uint16_t, sched_ue>& ue_db, ul_sf_sched_itf* tti_sched) = 0;
|
2017-06-01 03:25:57 -07:00
|
|
|
};
|
|
|
|
|
|
|
|
/*************************************************************
|
2019-10-16 10:11:38 -07:00
|
|
|
*
|
|
|
|
* FAPI-like Interface
|
|
|
|
*
|
2017-06-01 03:25:57 -07:00
|
|
|
************************************************************/
|
2019-10-16 10:11:38 -07:00
|
|
|
|
|
|
|
sched();
|
2020-03-02 08:38:53 -08:00
|
|
|
~sched() override;
|
2017-09-05 07:51:44 -07:00
|
|
|
|
2020-01-31 03:17:04 -08:00
|
|
|
void init(rrc_interface_mac* rrc);
|
2020-01-22 11:52:27 -08:00
|
|
|
int cell_cfg(const std::vector<cell_cfg_t>& cell_cfg) override;
|
2019-10-15 08:35:12 -07:00
|
|
|
void set_sched_cfg(sched_args_t* sched_cfg);
|
|
|
|
int reset() final;
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2020-02-06 07:41:58 -08:00
|
|
|
int ue_cfg(uint16_t rnti, const ue_cfg_t& ue_cfg) final;
|
2019-10-15 08:35:12 -07:00
|
|
|
int ue_rem(uint16_t rnti) final;
|
|
|
|
bool ue_exists(uint16_t rnti) final;
|
2019-10-23 09:09:39 -07:00
|
|
|
void ue_needs_ta_cmd(uint16_t rnti, uint32_t nof_ta_cmd);
|
|
|
|
|
2019-11-29 07:04:33 -08:00
|
|
|
void phy_config_enabled(uint16_t rnti, bool enabled);
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2019-10-15 08:35:12 -07:00
|
|
|
int bearer_ue_cfg(uint16_t rnti, uint32_t lc_id, ue_bearer_cfg_t* cfg) final;
|
|
|
|
int bearer_ue_rem(uint16_t rnti, uint32_t lc_id) final;
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2019-10-15 08:35:12 -07:00
|
|
|
uint32_t get_ul_buffer(uint16_t rnti) final;
|
|
|
|
uint32_t get_dl_buffer(uint16_t rnti) final;
|
|
|
|
|
|
|
|
int dl_rlc_buffer_state(uint16_t rnti, uint32_t lc_id, uint32_t tx_queue, uint32_t retx_queue) final;
|
|
|
|
int dl_mac_buffer_state(uint16_t rnti, uint32_t ce_code) final;
|
2019-01-17 03:42:01 -08:00
|
|
|
|
2020-03-02 06:14:13 -08:00
|
|
|
int dl_ack_info(uint32_t tti, uint16_t rnti, uint32_t enb_cc_idx, uint32_t tb_idx, bool ack) final;
|
|
|
|
int dl_rach_info(uint32_t enb_cc_idx, dl_sched_rar_info_t rar_info) final;
|
|
|
|
int dl_ri_info(uint32_t tti, uint16_t rnti, uint32_t enb_cc_idx, uint32_t ri_value) final;
|
|
|
|
int dl_pmi_info(uint32_t tti, uint16_t rnti, uint32_t enb_cc_idx, uint32_t pmi_value) final;
|
|
|
|
int dl_cqi_info(uint32_t tti, uint16_t rnti, uint32_t enb_cc_idx, uint32_t cqi_value) final;
|
|
|
|
int ul_crc_info(uint32_t tti, uint16_t rnti, uint32_t enb_cc_idx, bool crc) final;
|
2019-10-15 08:35:12 -07:00
|
|
|
int ul_sr_info(uint32_t tti, uint16_t rnti) override;
|
|
|
|
int ul_bsr(uint16_t rnti, uint32_t lcid, uint32_t bsr, bool set_value = true) final;
|
|
|
|
int ul_recv_len(uint16_t rnti, uint32_t lcid, uint32_t len) final;
|
|
|
|
int ul_phr(uint16_t rnti, int phr) final;
|
2020-03-02 06:14:13 -08:00
|
|
|
int ul_cqi_info(uint32_t tti, uint16_t rnti, uint32_t enb_cc_idx, uint32_t cqi, uint32_t ul_ch_code) final;
|
2019-04-26 06:57:50 -07:00
|
|
|
|
2020-03-02 06:14:13 -08:00
|
|
|
int dl_sched(uint32_t tti, uint32_t enb_cc_idx, dl_sched_res_t& sched_result) final;
|
|
|
|
int ul_sched(uint32_t tti, uint32_t enb_cc_idx, ul_sched_res_t& sched_result) final;
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2019-07-02 09:03:13 -07:00
|
|
|
/* Custom functions
|
2017-06-01 03:25:57 -07:00
|
|
|
*/
|
2020-03-11 09:15:25 -07:00
|
|
|
void set_dl_tti_mask(uint8_t* tti_mask, uint32_t nof_sfs) final;
|
|
|
|
void tpc_inc(uint16_t rnti);
|
|
|
|
void tpc_dec(uint16_t rnti);
|
|
|
|
std::array<int, SRSLTE_MAX_CARRIERS> get_enb_ue_cc_map(uint16_t rnti) final;
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2019-10-18 07:16:13 -07:00
|
|
|
class carrier_sched;
|
|
|
|
|
2019-04-23 01:53:11 -07:00
|
|
|
protected:
|
2020-03-02 09:59:03 -08:00
|
|
|
// Helper methods
|
|
|
|
template <typename Func>
|
2020-03-12 03:44:18 -07:00
|
|
|
int ue_db_access(uint16_t rnti, Func, const char* func_name = nullptr);
|
2020-03-02 09:59:03 -08:00
|
|
|
|
|
|
|
// args
|
2020-02-27 04:41:38 -08:00
|
|
|
srslte::log_ref log_h;
|
2020-01-31 03:17:04 -08:00
|
|
|
rrc_interface_mac* rrc = nullptr;
|
|
|
|
sched_args_t sched_cfg = {};
|
|
|
|
std::vector<sched_cell_params_t> sched_cell_params;
|
2018-07-07 03:17:55 -07:00
|
|
|
|
2019-10-16 04:03:30 -07:00
|
|
|
std::map<uint16_t, sched_ue> ue_db;
|
2019-04-26 06:57:50 -07:00
|
|
|
|
2019-10-17 08:17:43 -07:00
|
|
|
// independent schedulers for each carrier
|
2019-10-18 07:16:13 -07:00
|
|
|
std::vector<std::unique_ptr<carrier_sched> > carrier_schedulers;
|
2019-10-16 04:03:30 -07:00
|
|
|
|
2020-03-02 09:59:03 -08:00
|
|
|
uint32_t last_tti = 0;
|
|
|
|
std::mutex sched_mutex;
|
|
|
|
bool configured = false;
|
2017-06-01 03:25:57 -07:00
|
|
|
};
|
|
|
|
|
2019-10-16 10:11:38 -07:00
|
|
|
} // namespace srsenb
|
2017-06-01 03:25:57 -07:00
|
|
|
|
2018-03-31 10:04:04 -07:00
|
|
|
#endif // SRSENB_SCHEDULER_H
|