/** * * \section COPYRIGHT * * Copyright 2013-2021 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 SRSRAN_RLC_UM_LTE_H #define SRSRAN_RLC_UM_LTE_H #include "srsran/common/buffer_pool.h" #include "srsran/common/common.h" #include "srsran/rlc/rlc_um_base.h" #include "srsran/upper/byte_buffer_queue.h" #include #include #include #include namespace srsran { typedef struct { rlc_umd_pdu_header_t header; unique_byte_buffer_t buf; } rlc_umd_pdu_t; class rlc_um_lte : public rlc_um_base { public: rlc_um_lte(srslog::basic_logger& logger, uint32_t lcid_, srsue::pdcp_interface_rlc* pdcp_, srsue::rrc_interface_rlc* rrc_, srsran::timer_handler* timers_); ~rlc_um_lte(); bool configure(const rlc_config_t& cnfg); private: // Transmitter sub-class for LTE class rlc_um_lte_tx : public rlc_um_base_tx { public: rlc_um_lte_tx(rlc_um_base* parent_); bool configure(const rlc_config_t& cfg, std::string rb_name); uint32_t build_data_pdu(unique_byte_buffer_t pdu, uint8_t* payload, uint32_t nof_bytes); uint32_t get_buffer_state(); bool sdu_queue_is_full(); private: void reset(); /**************************************************************************** * State variables and counters * Ref: 3GPP TS 36.322 v10.0.0 Section 7 ***************************************************************************/ uint32_t vt_us = 0; // Send state. SN to be assigned for next PDU. // Metrics void debug_state(); }; // Receiver sub-class for LTE class rlc_um_lte_rx : public rlc_um_base_rx { public: rlc_um_lte_rx(rlc_um_base* parent_); ~rlc_um_lte_rx(); void stop(); void reestablish(); bool configure(const rlc_config_t& cnfg_, std::string rb_name_); void handle_data_pdu(uint8_t* payload, uint32_t nof_bytes); void reassemble_rx_sdus(); bool pdu_belongs_to_rx_sdu(); bool inside_reordering_window(uint16_t sn); // Timeout callback interface void timer_expired(uint32_t timeout_id); private: void reset(); // Rx window std::map rx_window; // RX SDU buffers uint32_t vr_ur_in_rx_sdu = 0; // Rx state variables and counter uint32_t vr_ur = 0; // Receive state. SN of earliest PDU still considered for reordering. uint32_t vr_ux = 0; // t_reordering state. SN following PDU which triggered t_reordering. uint32_t vr_uh = 0; // Highest rx state. SN following PDU with highest SN among rxed PDUs. bool pdu_lost = false; /**************************************************************************** * Timers * Ref: 3GPP TS 36.322 v10.0.0 Section 7 ***************************************************************************/ srsran::timer_handler::unique_timer reordering_timer; // helper functions void debug_state(); }; }; /**************************************************************************** * Header pack/unpack helper functions * Ref: 3GPP TS 36.322 v10.0.0 Section 6.2.1 ***************************************************************************/ void rlc_um_read_data_pdu_header(byte_buffer_t* pdu, rlc_umd_sn_size_t sn_size, rlc_umd_pdu_header_t* header); void rlc_um_read_data_pdu_header(uint8_t* payload, uint32_t nof_bytes, rlc_umd_sn_size_t sn_size, rlc_umd_pdu_header_t* header); void rlc_um_write_data_pdu_header(rlc_umd_pdu_header_t* header, byte_buffer_t* pdu); uint32_t rlc_um_packed_length(rlc_umd_pdu_header_t* header); bool rlc_um_start_aligned(uint8_t fi); bool rlc_um_end_aligned(uint8_t fi); } // namespace srsran #endif // SRSRAN_RLC_UM_LTE_H