/** * * \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 SRSENB_ENB_EVENTS_H #define SRSENB_ENB_EVENTS_H #include #include namespace srslog { class log_channel; } namespace srsenb { /// This interface logs different kinds of events to the configured channel. By default, if no log channel is configured /// logging will be disabled. class event_logger_interface { public: virtual ~event_logger_interface() = default; /// Logs into the underlying log channel any RRC event. virtual void log_rrc_event(uint32_t enb_cc_idx, const std::string& asn1_oct_str, const std::string& asn1_txt_str, unsigned type, unsigned additional_info, uint16_t rnti) = 0; /// Logs into the underlying log channel the S1 context create event. virtual void log_s1_ctx_create(uint32_t enb_cc_idx, uint32_t mme_id, uint32_t enb_id, uint16_t rnti) = 0; /// Logs into the underlying log channel the S1 context delete event. virtual void log_s1_ctx_delete(uint32_t enb_cc_idx, uint32_t mme_id, uint32_t enb_id, uint16_t rnti) = 0; /// Logs into the underlying log channel when a sector has been started. virtual void log_sector_start(uint32_t cc_idx, uint32_t pci, uint32_t cell_id, const std::string &hnb_name) = 0; /// Logs into the underlying log channel when a sector has been stopped. virtual void log_sector_stop(uint32_t cc_idx, uint32_t pci, uint32_t cell_id, const std::string &hnb_name) = 0; /// Logs into the underlying log channel a measurement report event. virtual void log_measurement_report(uint32_t enb_cc_idx, const std::string& asn1_oct_str, const std::string& asn1_txt_str, uint16_t rnti) = 0; /// Logs into the underlying log channel a RLF report. virtual void log_rlf_report(uint32_t enb_cc_idx, const std::string& asn1_oct_str, const std::string& asn1_txt_str, uint16_t rnti) = 0; /// Logs into the underlying log channel a RLF detection event. virtual void log_rlf_detected(uint32_t enb_cc_idx, const std::string& type, uint16_t rnti) = 0; /// Logs into the underlying log channel a handover command event. virtual void log_handover_command(uint32_t enb_cc_idx, uint32_t target_pci, uint32_t target_earfcn, uint16_t new_ue_rnti, uint16_t rnti) = 0; /// Logs into the underlying log channel a connection resume event. virtual void log_connection_resume(uint32_t enb_cc_idx, uint16_t resume_rnti, uint16_t rnti) = 0; }; /// Singleton class to provide global access to the event_logger_interface interface. class event_logger { event_logger() = default; public: /// ASN1 output printing format. enum class asn1_output_format { text, octets }; /// Returns the instance of the event logger. static event_logger_interface& get(); /// Uses the specified log channel for event logging. /// NOTE: This method is not thread safe. static void configure(srslog::log_channel& c, asn1_output_format asn1_format); private: static std::unique_ptr pimpl; }; } // namespace srsenb #endif // SRSENB_ENB_EVENTS_H