/** * Copyright 2013-2022 Software Radio Systems Limited * * This file is part of srsRAN. * * srsRAN 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. * * srsRAN 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 SRSRAN_BEARER_MANAGER_H #define SRSRAN_BEARER_MANAGER_H #include "srsenb/hdr/common/common_enb.h" #include "srsran/common/common.h" #include "srsran/common/rwlock_guard.h" #include "srsran/srslog/srslog.h" #include #include #include namespace srsran { namespace detail { /** * @brief Implementation of UE bearer manager internal functionality that is common to both srsue and * srsenb applications */ class ue_bearer_manager_impl { public: struct radio_bearer_t { srsran::srsran_rat_t rat; uint32_t lcid; uint32_t eps_bearer_id; uint32_t five_qi = 0; bool is_valid() const { return rat != srsran_rat_t::nulltype; } }; static const radio_bearer_t invalid_rb; /// Registers EPS bearer with PDCP RAT type and LCID bool add_eps_bearer(uint8_t eps_bearer_id, srsran::srsran_rat_t rat, uint32_t lcid); /// Single EPS bearer is removed from map when the associated DRB is deleted bool remove_eps_bearer(uint8_t eps_bearer_id); void reset(); bool has_active_radio_bearer(uint32_t eps_bearer_id); radio_bearer_t get_radio_bearer(uint32_t eps_bearer_id) const; radio_bearer_t get_eps_bearer_id_for_lcid(uint32_t lcid) const; bool set_five_qi(uint32_t eps_bearer_id, uint16_t five_qi); private: using eps_rb_map_t = std::map; eps_rb_map_t bearers; std::map lcid_to_eps_bearer_id; }; } // namespace detail } // namespace srsran namespace srsue { /** * @brief Helper class to manage the mapping between EPS bearer and radio bearer * * The class maps EPS bearers that are known to NAS and GW (UE) * to radio bearer (RB) that are only known to RRC. * Since the lifetime of a EPS bearer is usually longer than the lifetime of a RB, * the GW/GTPU needs to query the Stack to check whether a * given EPS bearer is active, i.e. a DRB is established, or not. * * The class also maps between RATs since each LCID can exist on either EUTRA or NR RATs, or both. * * Since the access of this class is happening from two different threads (GW+RRC/Stack) * it's public interface is protected. * * The class provides two interfaces to be used with RNTI or without. The version without * RNTI is used by the UE. The version with RNTI in the interface is intented to be * used by the eNB. * */ class ue_bearer_manager { public: using radio_bearer_t = srsran::detail::ue_bearer_manager_impl::radio_bearer_t; ue_bearer_manager(); ue_bearer_manager(const ue_bearer_manager&) = delete; ue_bearer_manager& operator=(const ue_bearer_manager&) = delete; ~ue_bearer_manager(); // RRC interface /// Registers EPS bearer with PDCP RAT type and LCID void add_eps_bearer(uint8_t eps_bearer_id, srsran::srsran_rat_t rat, uint32_t lcid); /// Single EPS bearer is removed from map when the associated DRB is deleted void remove_eps_bearer(uint8_t eps_bearer_id); /// All registered bearer are removed (e.g. after connection release) void reset(); bool has_active_radio_bearer(uint32_t eps_bearer_id) { srsran::rwlock_read_guard rw_lock(rwlock); return impl.has_active_radio_bearer(eps_bearer_id); } radio_bearer_t get_radio_bearer(uint32_t eps_bearer_id) { srsran::rwlock_read_guard rw_lock(rwlock); return impl.get_radio_bearer(eps_bearer_id); } radio_bearer_t get_lcid_bearer(uint32_t lcid) { srsran::rwlock_read_guard rw_lock(rwlock); return impl.get_eps_bearer_id_for_lcid(lcid); } private: pthread_rwlock_t rwlock = {}; /// RW lock to protect access from RRC/GW threads srslog::basic_logger& logger; srsran::detail::ue_bearer_manager_impl impl; }; } // namespace srsue namespace srsenb { class enb_bearer_manager { public: using radio_bearer_t = srsran::detail::ue_bearer_manager_impl::radio_bearer_t; enb_bearer_manager(); ~enb_bearer_manager(); /// Multi-user interface (see comments above) void add_eps_bearer(uint16_t rnti, uint8_t eps_bearer_id, srsran::srsran_rat_t rat, uint32_t lcid); void remove_eps_bearer(uint16_t rnti, uint8_t eps_bearer_id); void rem_user(uint16_t rnti); bool has_active_radio_bearer(uint16_t rnti, uint32_t eps_bearer_id); radio_bearer_t get_radio_bearer(uint16_t rnti, uint32_t eps_bearer_id); radio_bearer_t get_lcid_bearer(uint16_t rnti, uint32_t lcid) const; bool set_five_qi(uint16_t rnti, uint32_t eps_bearer_id, uint16_t five_qi); private: srslog::basic_logger& logger; std::unordered_map users_map; }; } // namespace srsenb #endif // SRSRAN_BEARER_MANAGER_H