2020-11-26 01:25:22 -08:00
|
|
|
/**
|
2017-05-18 03:52:29 -07:00
|
|
|
*
|
2020-11-26 01:25:22 -08:00
|
|
|
* \section COPYRIGHT
|
2017-05-18 03:52:29 -07:00
|
|
|
*
|
2021-03-19 03:45:56 -07:00
|
|
|
* Copyright 2013-2021 Software Radio Systems Limited
|
2017-05-18 03:52:29 -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-05-18 03:52:29 -07:00
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
2021-03-19 03:45:56 -07:00
|
|
|
#ifndef SRSRAN_RLC_H
|
|
|
|
#define SRSRAN_RLC_H
|
2017-05-18 03:52:29 -07:00
|
|
|
|
2021-03-19 03:45:56 -07:00
|
|
|
#include "srsran/common/buffer_pool.h"
|
|
|
|
#include "srsran/common/common.h"
|
|
|
|
#include "srsran/common/task_scheduler.h"
|
|
|
|
#include "srsran/interfaces/ue_pdcp_interfaces.h"
|
|
|
|
#include "srsran/interfaces/ue_rlc_interfaces.h"
|
|
|
|
#include "srsran/interfaces/ue_rrc_interfaces.h"
|
2021-06-25 06:24:56 -07:00
|
|
|
#include "srsran/rlc/rlc_common.h"
|
|
|
|
#include "srsran/rlc/rlc_metrics.h"
|
2017-05-18 03:52:29 -07:00
|
|
|
|
2021-03-19 03:45:56 -07:00
|
|
|
namespace srsran {
|
2017-05-18 03:52:29 -07:00
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* RLC Layer
|
|
|
|
* Ref: 3GPP TS 36.322 v10.0.0
|
|
|
|
* Single interface for RLC layer - contains separate RLC entities for
|
|
|
|
* each bearer.
|
|
|
|
***************************************************************************/
|
2019-11-25 10:34:18 -08:00
|
|
|
class rlc : public srsue::rlc_interface_mac, public srsue::rlc_interface_pdcp, public srsue::rlc_interface_rrc
|
2017-05-18 03:52:29 -07:00
|
|
|
{
|
|
|
|
public:
|
2020-03-25 07:57:29 -07:00
|
|
|
rlc(const char* logname);
|
2018-07-20 01:19:08 -07:00
|
|
|
virtual ~rlc();
|
2019-10-21 10:00:49 -07:00
|
|
|
void init(srsue::pdcp_interface_rlc* pdcp_,
|
|
|
|
srsue::rrc_interface_rlc* rrc_,
|
2021-03-19 03:45:56 -07:00
|
|
|
srsran::timer_handler* timers_,
|
2019-10-21 10:00:49 -07:00
|
|
|
uint32_t lcid_);
|
2021-06-25 06:24:56 -07:00
|
|
|
|
2020-05-22 02:20:33 -07:00
|
|
|
void init(srsue::pdcp_interface_rlc* pdcp_,
|
|
|
|
srsue::rrc_interface_rlc* rrc_,
|
2021-03-19 03:45:56 -07:00
|
|
|
srsran::timer_handler* timers_,
|
2020-05-22 02:20:33 -07:00
|
|
|
uint32_t lcid_,
|
|
|
|
bsr_callback_t bsr_callback_);
|
2017-05-18 03:52:29 -07:00
|
|
|
void stop();
|
|
|
|
|
2020-11-30 07:32:06 -08:00
|
|
|
void get_metrics(rlc_metrics_t& m, const uint32_t nof_tti);
|
2017-05-18 03:52:29 -07:00
|
|
|
|
|
|
|
// PDCP interface
|
2020-07-10 13:23:35 -07:00
|
|
|
void write_sdu(uint32_t lcid, unique_byte_buffer_t sdu);
|
2019-05-13 07:34:15 -07:00
|
|
|
void write_sdu_mch(uint32_t lcid, unique_byte_buffer_t sdu);
|
2017-11-23 10:46:34 -08:00
|
|
|
bool rb_is_um(uint32_t lcid);
|
2019-11-25 10:34:18 -08:00
|
|
|
void discard_sdu(uint32_t lcid, uint32_t discard_sn);
|
2020-07-10 13:23:35 -07:00
|
|
|
bool sdu_queue_is_full(uint32_t lcid);
|
2017-05-18 03:52:29 -07:00
|
|
|
|
|
|
|
// MAC interface
|
2020-07-17 01:46:54 -07:00
|
|
|
bool has_data_locked(const uint32_t lcid);
|
2018-11-30 03:26:37 -08:00
|
|
|
uint32_t get_buffer_state(const uint32_t lcid);
|
2021-10-19 13:12:21 -07:00
|
|
|
void get_buffer_state(uint32_t lcid, uint32_t& tx_queue, uint32_t& prio_tx_queue);
|
2018-05-15 07:57:23 -07:00
|
|
|
uint32_t get_total_mch_buffer_state(uint32_t lcid);
|
2021-06-03 02:03:58 -07:00
|
|
|
uint32_t read_pdu(uint32_t lcid, uint8_t* payload, uint32_t nof_bytes);
|
|
|
|
uint32_t read_pdu_mch(uint32_t lcid, uint8_t* payload, uint32_t nof_bytes);
|
2018-05-15 07:57:23 -07:00
|
|
|
int get_increment_sequence_num();
|
2019-12-16 07:04:22 -08:00
|
|
|
void write_pdu(uint32_t lcid, uint8_t* payload, uint32_t nof_bytes);
|
2021-03-19 03:45:56 -07:00
|
|
|
void write_pdu_bcch_bch(srsran::unique_byte_buffer_t pdu);
|
2019-12-16 07:04:22 -08:00
|
|
|
void write_pdu_bcch_dlsch(uint8_t* payload, uint32_t nof_bytes);
|
2021-03-19 03:45:56 -07:00
|
|
|
void write_pdu_pcch(srsran::unique_byte_buffer_t pdu);
|
2019-12-16 07:04:22 -08:00
|
|
|
void write_pdu_mch(uint32_t lcid, uint8_t* payload, uint32_t nof_bytes);
|
2017-05-18 03:52:29 -07:00
|
|
|
|
|
|
|
// RRC interface
|
2020-07-17 01:46:54 -07:00
|
|
|
bool is_suspended(const uint32_t lcid);
|
|
|
|
bool has_data(const uint32_t lcid);
|
2017-11-23 10:46:34 -08:00
|
|
|
void reestablish();
|
2018-09-18 05:55:05 -07:00
|
|
|
void reestablish(uint32_t lcid);
|
2017-05-18 03:52:29 -07:00
|
|
|
void reset();
|
2017-08-22 06:06:51 -07:00
|
|
|
void empty_queue();
|
2021-05-06 06:24:05 -07:00
|
|
|
int add_bearer(uint32_t lcid, const rlc_config_t& cnfg);
|
|
|
|
int add_bearer_mrb(uint32_t lcid);
|
2018-08-03 07:28:06 -07:00
|
|
|
void del_bearer(uint32_t lcid);
|
2018-09-25 05:04:06 -07:00
|
|
|
void del_bearer_mrb(uint32_t lcid);
|
2019-07-09 13:54:04 -07:00
|
|
|
void suspend_bearer(uint32_t lcid);
|
2019-06-04 08:29:02 -07:00
|
|
|
void resume_bearer(uint32_t lcid);
|
2018-09-17 04:11:03 -07:00
|
|
|
void change_lcid(uint32_t old_lcid, uint32_t new_lcid);
|
2018-11-02 13:46:03 -07:00
|
|
|
bool has_bearer(uint32_t lcid);
|
2018-07-20 01:19:08 -07:00
|
|
|
|
2017-05-18 03:52:29 -07:00
|
|
|
private:
|
2019-06-27 01:50:47 -07:00
|
|
|
void reset_metrics();
|
|
|
|
|
2021-02-10 04:16:53 -08:00
|
|
|
srslog::basic_logger& logger;
|
2021-04-13 05:23:00 -07:00
|
|
|
byte_buffer_pool* pool = nullptr;
|
2020-03-25 07:57:29 -07:00
|
|
|
srsue::pdcp_interface_rlc* pdcp = nullptr;
|
|
|
|
srsue::rrc_interface_rlc* rrc = nullptr;
|
2021-03-19 03:45:56 -07:00
|
|
|
srsran::timer_handler* timers = nullptr;
|
2018-07-20 01:19:08 -07:00
|
|
|
|
2021-05-06 06:24:05 -07:00
|
|
|
typedef std::map<uint16_t, std::unique_ptr<rlc_common> > rlc_map_t;
|
|
|
|
typedef std::pair<uint16_t, std::unique_ptr<rlc_common> > rlc_map_pair_t;
|
2018-07-20 01:19:08 -07:00
|
|
|
|
2019-12-16 07:04:22 -08:00
|
|
|
rlc_map_t rlc_array, rlc_array_mrb;
|
2018-07-20 01:19:08 -07:00
|
|
|
pthread_rwlock_t rwlock;
|
|
|
|
|
2019-06-27 01:50:47 -07:00
|
|
|
uint32_t default_lcid = 0;
|
2017-05-18 03:52:29 -07:00
|
|
|
|
2020-05-22 02:20:33 -07:00
|
|
|
bsr_callback_t bsr_callback = nullptr;
|
|
|
|
|
2018-07-20 01:19:08 -07:00
|
|
|
// Timer needed for metrics calculation
|
2020-12-16 06:32:37 -08:00
|
|
|
std::chrono::high_resolution_clock::time_point metrics_tp;
|
2017-05-18 03:52:29 -07:00
|
|
|
|
|
|
|
bool valid_lcid(uint32_t lcid);
|
2018-05-15 07:57:23 -07:00
|
|
|
bool valid_lcid_mrb(uint32_t lcid);
|
2020-05-22 02:20:33 -07:00
|
|
|
|
|
|
|
void update_bsr(uint32_t lcid);
|
|
|
|
void update_bsr_mch(uint32_t lcid);
|
2017-05-18 03:52:29 -07:00
|
|
|
};
|
|
|
|
|
2020-06-25 12:52:31 -07:00
|
|
|
void rlc_bearer_metrics_print(const rlc_bearer_metrics_t& metrics);
|
|
|
|
|
2021-03-19 03:45:56 -07:00
|
|
|
} // namespace srsran
|
2017-05-18 03:52:29 -07:00
|
|
|
|
2021-03-19 03:45:56 -07:00
|
|
|
#endif // SRSRAN_RLC_H
|