/* * Copyright 2013-2020 Software Radio Systems Limited * * This file is part of srsLTE. * * srsLTE 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. * * srsLTE 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/. * */ #ifndef SRSLTE_SCHEDULER_TEST_COMMON_H #define SRSLTE_SCHEDULER_TEST_COMMON_H #include "scheduler_test_utils.h" #include "srsenb/hdr/stack/mac/scheduler.h" #include namespace srsenb { /*************************** * Random Utils **************************/ void set_randseed(uint64_t seed); float randf(); std::default_random_engine& get_rand_gen(); // other helpers int extract_dl_prbmask(const srslte_cell_t& cell, const srslte_dci_dl_t& dci, srslte::bounded_bitset<100, true>* alloc_mask); /************************** * Testers *************************/ class output_sched_tester { public: explicit output_sched_tester(const sched_cell_params_t& cell_params_) : cell_params(cell_params_) {} /* Check for collisions between RB allocations in the PUSCH and PUCCH */ int test_pusch_collisions(const tti_params_t& tti_params, const sched_interface::ul_sched_res_t& ul_result, prbmask_t& ul_allocs) const; /* Check for collision between RB allocations in the PDSCH */ int test_pdsch_collisions(const tti_params_t& tti_params, const sched_interface::dl_sched_res_t& dl_result, rbgmask_t& dl_mask) const; /* Check if SIBs are scheduled within their window */ int test_sib_scheduling(const tti_params_t& tti_params, const sched_interface::dl_sched_res_t& dl_result) const; /* Check for collisions in the PDCCH */ int test_pdcch_collisions(const sched_interface::dl_sched_res_t& dl_result, const sched_interface::ul_sched_res_t& ul_result, srslte::bounded_bitset<128, true>* used_cce) const; /* Check DCI params correctness */ int test_dci_values_consistency(const sched_interface::dl_sched_res_t& dl_result, const sched_interface::ul_sched_res_t& ul_result) const; int test_all(const tti_params_t& tti_params, const sched_interface::dl_sched_res_t& dl_result, const sched_interface::ul_sched_res_t& ul_result) const; private: const sched_cell_params_t& cell_params; }; using dl_sched_res_list = std::vector; using ul_sched_res_list = std::vector; struct ue_ctxt_test { // args srslte::log_ref log_h{"TEST"}; ue_ctxt_test_cfg sim_cfg; // prach args uint16_t rnti; uint32_t preamble_idx = 0; /* state */ srsenb::sched_interface::ue_cfg_t user_cfg; srslte::tti_point current_tti_rx; // RA state srslte::tti_point prach_tti, rar_tti, msg3_tti, msg4_tti; uint32_t msg3_riv = 0; struct cc_ue_ctxt_test { uint32_t ue_cc_idx = 0; uint32_t enb_cc_idx = 0; // Harq State struct harq_state_t { uint32_t pid = 0; srslte::tti_point tti_tx; bool active = false; bool ndi = false; uint32_t nof_retxs = 0; uint32_t nof_txs = 0; uint32_t riv = 0; }; std::array dl_harqs = {}; std::array ul_harqs = {}; }; std::vector active_ccs; bool drb_cfg_flag = false; ue_ctxt_test(uint16_t rnti_, uint32_t preamble_idx_, srslte::tti_point prach_tti, const ue_ctxt_test_cfg& cfg_, const std::vector& cell_params_); int set_cfg(const sched::ue_cfg_t& ue_cfg_); cc_ue_ctxt_test* get_cc_state(uint32_t enb_cc_idx); bool is_msg3_rx(const srslte::tti_point& tti_rx) const { return msg3_tti.is_valid() and msg3_tti <= tti_rx; } int new_tti(sched* sched_ptr, srslte::tti_point tti_rx); int test_sched_result(uint32_t enb_cc_idx, const sched::dl_sched_res_t& dl_result, const sched::ul_sched_res_t& ul_result); private: int fwd_pending_acks(sched* sched_ptr); struct cc_result { uint32_t enb_cc_idx; const sched::dl_sched_res_t* dl_result; const sched::ul_sched_res_t* ul_result; }; //! Test the timing of RAR, Msg3, Msg4 int test_ra(cc_result result); int test_harqs(cc_result result); //! Test correct activation of SCells int test_scell_activation(cc_result result); int schedule_acks(cc_result result); const std::vector& cell_params; struct pending_ack_t { srslte::tti_point tti_ack; uint32_t cc_idx, ue_cc_idx, tb, pid; bool ack; bool operator<(const pending_ack_t& other) const { return tti_ack > other.tti_ack; } }; std::priority_queue pending_dl_acks, pending_ul_acks; }; class user_state_sched_tester { public: explicit user_state_sched_tester(const std::vector& cell_params_) : cell_params(cell_params_) {} void new_tti(sched* sched_ptr, uint32_t tti_rx); bool user_exists(uint16_t rnti) const { return users.find(rnti) != users.end(); } const ue_ctxt_test* get_user_ctxt(uint16_t rnti) const { return users.count(rnti) > 0 ? &users.find(rnti)->second : nullptr; } const sched::ue_cfg_t* get_user_cfg(uint16_t rnti) const { return users.count(rnti) > 0 ? &users.find(rnti)->second.user_cfg : nullptr; } /* Config users */ int add_user(uint16_t rnti, uint32_t preamble_idx, const ue_ctxt_test_cfg& cfg); int user_reconf(uint16_t rnti, const srsenb::sched_interface::ue_cfg_t& ue_cfg); int bearer_cfg(uint16_t rnti, uint32_t lcid, const srsenb::sched_interface::ue_bearer_cfg_t& bearer_cfg); void rem_user(uint16_t rnti); /* Test allocs control content */ int test_ctrl_info(uint32_t enb_cc_idx, const sched_interface::dl_sched_res_t& dl_result, const sched_interface::ul_sched_res_t& ul_result); int test_all(uint32_t enb_cc_idx, const sched_interface::dl_sched_res_t& dl_result, const sched_interface::ul_sched_res_t& ul_result); private: const std::vector& cell_params; std::map users; srslte::tti_point tic; }; class sched_result_stats { public: explicit sched_result_stats(std::vector cell_params_) : cell_params(std::move(cell_params_)) {} void process_results(const tti_params_t& tti_params, const std::vector& dl_result, const std::vector& ul_result); struct user_stats { uint16_t rnti; std::vector tot_dl_sched_data; // includes retxs std::vector tot_ul_sched_data; }; std::map users; private: user_stats* get_user(uint16_t rnti); const std::vector cell_params; }; // Intrusive Scheduler Tester class common_sched_tester : public sched { public: struct tti_info_t { tti_params_t tti_params{10241}; uint32_t nof_prachs = 0; std::vector dl_sched_result; std::vector ul_sched_result; }; ~common_sched_tester() override = default; const ue_cfg_t* get_current_ue_cfg(uint16_t rnti) const; int sim_cfg(sim_sched_args args); virtual int add_user(uint16_t rnti, const ue_ctxt_test_cfg& ue_cfg_); virtual void rem_user(uint16_t rnti); virtual int process_results(); int process_tti_events(const tti_ev& tti_ev); int test_next_ttis(const std::vector& tti_events); int run_tti(const tti_ev& tti_events); // args sim_sched_args sim_args0; ///< arguments used to generate TTI events srslte::log* tester_log = nullptr; // tti specific params tti_info_t tti_info; srslte::tti_point tic; uint32_t tti_count = 0; // testers std::vector output_tester; std::unique_ptr ue_tester; std::unique_ptr sched_stats; protected: virtual void new_test_tti(); virtual void before_sched() {} }; } // namespace srsenb #endif // SRSLTE_SCHEDULER_TEST_COMMON_H