/** * * \section COPYRIGHT * * Copyright 2013-2017 Software Radio Systems Limited * * \section LICENSE * * This file is part of srsLTE. * * srsUE 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. * * srsUE 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 MAC_H #define MAC_H #include #include "srslte/common/log.h" #include "srslte/common/timers.h" #include "srslte/interfaces/enb_interfaces.h" #include "srslte/interfaces/sched_interface.h" #include "srslte/common/tti_sync_cv.h" #include "srslte/common/threads.h" #include "srslte/common/tti_sync_cv.h" #include "srslte/common/mac_pcap.h" #include "mac/scheduler.h" #include "mac/scheduler_metric.h" #include "srslte/interfaces/enb_metrics_interface.h" #include "mac/ue.h" namespace srsenb { class pdu_process_handler { public: virtual bool process_pdus() = 0; }; typedef struct { sched_interface::sched_args_t sched; int link_failure_nof_err; } mac_args_t; class mac :public mac_interface_phy, public mac_interface_rlc, public mac_interface_rrc, public srslte::mac_interface_timers, public pdu_process_handler { public: mac(); bool init(mac_args_t *args, srslte_cell_t *cell, phy_interface_mac *phy, rlc_interface_mac *rlc, rrc_interface_mac *rrc, srslte::log *log_h); void stop(); void start_pcap(srslte::mac_pcap* pcap_); /******** Interface from PHY (PHY -> MAC) ****************/ int sr_detected(uint32_t tti, uint16_t rnti); int rach_detected(uint32_t tti, uint32_t preamble_idx, uint32_t time_adv); int cqi_info(uint32_t tti, uint16_t rnti, uint32_t cqi_value); int snr_info(uint32_t tti, uint16_t rnti, float snr); int ack_info(uint32_t tti, uint16_t rnti, bool ack); int crc_info(uint32_t tti, uint16_t rnti, uint32_t nof_bytes, bool crc_res); int get_dl_sched(uint32_t tti, dl_sched_t *dl_sched_res); int get_ul_sched(uint32_t tti, ul_sched_t *ul_sched_res); void rl_failure(uint16_t rnti); void rl_ok(uint16_t rnti); void tti_clock(); /******** Interface from RRC (RRC -> MAC) ****************/ /* Provides cell configuration including SIB periodicity, etc. */ int cell_cfg(sched_interface::cell_cfg_t *cell_cfg); void reset(); /* Manages UE scheduling context */ int ue_cfg(uint16_t rnti, sched_interface::ue_cfg_t *cfg); int ue_rem(uint16_t rnti); // Indicates that the PHY config dedicated has been enabled or not void phy_config_enabled(uint16_t rnti, bool enabled); /* Manages UE bearers and associated configuration */ int bearer_ue_cfg(uint16_t rnti, uint32_t lc_id, sched_interface::ue_bearer_cfg_t *cfg); int bearer_ue_rem(uint16_t rnti, uint32_t lc_id); int rlc_buffer_state(uint16_t rnti, uint32_t lc_id, uint32_t tx_queue, uint32_t retx_queue); bool process_pdus(); void timer_expired(uint32_t timer_id); srslte::timers::timer* get(uint32_t timer_id); u_int32_t get_unique_id(); uint32_t get_current_tti(); void get_metrics(mac_metrics_t metrics[ENB_METRICS_MAX_USERS]); enum { HARQ_RTT, TIME_ALIGNMENT, CONTENTION_TIMER, BSR_TIMER_PERIODIC, BSR_TIMER_RETX, PHR_TIMER_PERIODIC, PHR_TIMER_PROHIBIT, NOF_MAC_TIMERS } mac_timers_t; static const int MAC_NOF_UPPER_TIMERS = 20; private: void log_step_ul(uint32_t tti); void log_step_dl(uint32_t tti); static const int MAX_LOCATIONS = 20; static const uint32_t cfi = 3; srslte_dci_location_t locations[MAX_LOCATIONS]; static const int MAC_PDU_THREAD_PRIO = 3; // Interaction with PHY phy_interface_mac *phy_h; rlc_interface_mac *rlc_h; rrc_interface_mac *rrc_h; srslte::log *log_h; srslte_cell_t cell; mac_args_t args; uint32_t tti; bool started; /* Scheduler unit */ sched scheduler; dl_metric_rr sched_metric_dl_rr; ul_metric_rr sched_metric_ul_rr; /* Map of active UEs */ std::map ue_db; uint16_t last_rnti; uint8_t* assemble_rar(sched_interface::dl_sched_rar_grant_t *grants, uint32_t nof_grants, int rar_idx, uint32_t pdu_len); uint8_t* assemble_si(uint32_t index); const static int rar_payload_len = 128; std::vector rar_pdu_msg; uint8_t rar_payload[sched_interface::MAX_RAR_LIST][rar_payload_len]; typedef struct { uint32_t preamble_idx; uint32_t ta_cmd; uint16_t temp_crnti; } pending_rar_t; const static int MAX_PENDING_RARS = 64; pending_rar_t pending_rars[MAX_PENDING_RARS]; const static int NOF_BCCH_DLSCH_MSG=sched_interface::MAX_SIBS; uint8_t bcch_dlsch_payload[sched_interface::MAX_SIB_PAYLOAD_LEN]; const static int pcch_payload_buffer_len = 1024; uint8_t pcch_payload_buffer[pcch_payload_buffer_len]; srslte_softbuffer_tx_t bcch_softbuffer_tx[NOF_BCCH_DLSCH_MSG]; srslte_softbuffer_tx_t pcch_softbuffer_tx; srslte_softbuffer_tx_t rar_softbuffer_tx; /* Functions for MAC Timers */ srslte::timers timers_db; void setup_timers(); // pointer to MAC PCAP object srslte::mac_pcap* pcap; /* Class to run upper-layer timers with normal priority */ class upper_timers : public thread { public: upper_timers() : timers_db(MAC_NOF_UPPER_TIMERS),ttisync(10240) {start();} void tti_clock(); void stop(); void reset(); srslte::timers::timer* get(uint32_t timer_id); uint32_t get_unique_id(); private: void run_thread(); srslte::timers timers_db; srslte::tti_sync_cv ttisync; bool running; }; upper_timers upper_timers_thread; /* Class to process MAC PDUs from DEMUX unit */ class pdu_process : public thread { public: pdu_process(pdu_process_handler *h); void notify(); void stop(); private: void run_thread(); bool running; bool have_data; pthread_mutex_t mutex; pthread_cond_t cvar; pdu_process_handler *handler; }; pdu_process pdu_process_thread; }; } // namespace srsue #endif // MAC_H