/** * * \section COPYRIGHT * * Copyright 2013-2020 Software Radio Systems Limited * * 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. * */ #ifndef SRSUE_PROC_BSR_H #define SRSUE_PROC_BSR_H #include #include #include "proc_sr.h" #include "srslte/common/logmap.h" #include "srslte/common/timers.h" #include "srslte/interfaces/ue_interfaces.h" #include "srslte/srslog/srslog.h" /* Buffer status report procedure */ namespace srsue { class rlc_interface_mac; // BSR interface for MUX class bsr_interface_mux { public: typedef enum { LONG_BSR, SHORT_BSR, TRUNC_BSR } bsr_format_t; typedef struct { bsr_format_t format; uint32_t buff_size[4]; } bsr_t; /* MUX calls BSR to check if it should send (and can fit) a BSR into PDU */ virtual bool need_to_send_bsr_on_ul_grant(uint32_t grant_size, uint32_t total_data, bsr_t* bsr) = 0; /* MUX calls BSR to let it generate a padding BSR if there is space in PDU */ virtual bool generate_padding_bsr(uint32_t nof_padding_bytes, bsr_t* bsr) = 0; /* MUX calls BSR to update buffer state of each LCG after all PDUs for this TTI have been packed */ virtual void update_bsr_tti_end(const bsr_t* bsr) = 0; }; class bsr_proc : public srslte::timer_callback, public bsr_interface_mux { public: explicit bsr_proc(srslog::basic_logger& logger) : logger(logger) {} void init(sr_proc* sr_proc, rlc_interface_mac* rlc, srslte::ext_task_sched_handle* task_sched_); void step(uint32_t tti); void reset(); void set_config(srslte::bsr_cfg_t& bsr_cfg); void setup_lcid(uint32_t lcid, uint32_t lcg, uint32_t priority); void timer_expired(uint32_t timer_id); uint32_t get_buffer_state(); bool need_to_send_bsr_on_ul_grant(uint32_t grant_size, uint32_t total_data, bsr_t* bsr); bool generate_padding_bsr(uint32_t nof_padding_bytes, bsr_t* bsr); void update_bsr_tti_end(const bsr_t* bsr); private: const static int QUEUE_STATUS_PERIOD_MS = 1000; std::mutex mutex; srslte::ext_task_sched_handle* task_sched = nullptr; srslog::basic_logger& logger; rlc_interface_mac* rlc = nullptr; sr_proc* sr = nullptr; srslte::bsr_cfg_t bsr_cfg; bool initiated = false; const static int NOF_LCG = 4; typedef struct { int priority; uint32_t old_buffer; uint32_t new_buffer; } lcid_t; std::map lcgs[NOF_LCG]; // groups LCID in LCG uint32_t find_max_priority_lcg_with_data(); typedef enum { NONE, REGULAR, PADDING, PERIODIC } triggered_bsr_type_t; triggered_bsr_type_t triggered_bsr_type = NONE; void print_state(); void set_trigger(triggered_bsr_type_t new_trigger); void update_new_data(); void update_old_buffer(); bool check_highest_channel(); bool check_new_data(); bool check_any_channel(); uint32_t get_buffer_state_lcg(uint32_t lcg); bool generate_bsr(bsr_t* bsr, uint32_t nof_padding_bytes); char* bsr_type_tostring(triggered_bsr_type_t type); char* bsr_format_tostring(bsr_format_t format); srslte::timer_handler::unique_timer timer_periodic; srslte::timer_handler::unique_timer timer_retx; srslte::timer_handler::unique_timer timer_queue_status_print; }; } // namespace srsue #endif // SRSUE_PROC_BSR_H