/* * Copyright 2013-2020 Software Radio Systems Limited * * This file is part of srsLTE. * * srsLTE 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. * * srsLTE 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 SRSUE_MAC_H #define SRSUE_MAC_H #include "demux.h" #include "dl_harq.h" #include "mac_metrics.h" #include "mux.h" #include "proc_bsr.h" #include "proc_phr.h" #include "proc_ra.h" #include "proc_sr.h" #include "srslte/common/logmap.h" #include "srslte/common/mac_pcap.h" #include "srslte/common/threads.h" #include "srslte/common/timers.h" #include "srslte/common/tti_sync_cv.h" #include "srslte/interfaces/ue_interfaces.h" #include "ul_harq.h" #include #include namespace srsue { class mac : public mac_interface_phy_lte, public mac_interface_rrc, public srslte::timer_callback, public mac_interface_demux { public: mac(const char* logname); ~mac(); bool init(phy_interface_mac_lte* phy, rlc_interface_mac* rlc, rrc_interface_mac* rrc, stack_interface_mac* stack_); void stop(); void get_metrics(mac_metrics_t m[SRSLTE_MAX_CARRIERS]); /******** Interface from PHY (PHY -> MAC) ****************/ /* see mac_interface.h for comments */ void new_grant_ul(uint32_t cc_idx, mac_grant_ul_t grant, tb_action_ul_t* action); void new_grant_dl(uint32_t cc_idx, mac_grant_dl_t grant, tb_action_dl_t* action); void new_mch_dl(srslte_pdsch_grant_t phy_grant, tb_action_dl_t* action); void tb_decoded(uint32_t cc_idx, mac_grant_dl_t grant, bool ack[SRSLTE_MAX_CODEWORDS]); void bch_decoded_ok(uint32_t cc_idx, uint8_t* payload, uint32_t len); uint16_t get_dl_sched_rnti(uint32_t tti); uint16_t get_ul_sched_rnti(uint32_t tti); void mch_decoded(uint32_t len, bool crc); void process_mch_pdu(uint32_t len); void set_mbsfn_config(uint32_t nof_mbsfn_services); void run_tti(const uint32_t tti); /******** Interface from RRC (RRC -> MAC) ****************/ void bcch_start_rx(int si_window_start, int si_window_length); void bcch_stop_rx(); void pcch_start_rx(); void setup_lcid(uint32_t lcid, uint32_t lcg, uint32_t priority, int PBR_x_tti, uint32_t BSD); void setup_lcid(const logical_channel_config_t& config); void mch_start_rx(uint32_t lcid); void reconfiguration(const uint32_t& cc_idx, const bool& enable); void reset(); void wait_uplink(); /******** set/get MAC configuration ****************/ void set_config(mac_cfg_t& mac_cfg); void set_contention_id(uint64_t uecri); /******* interface from demux object ****************/ void reset_harq(uint32_t cc_idx); bool contention_resolution_id_rcv(uint64_t id); void start_noncont_ho(uint32_t preamble_index, uint32_t prach_mask); void start_cont_ho(); void get_rntis(ue_rnti_t* rntis); void set_ho_rnti(uint16_t crnti, uint16_t target_pci); /*********** interface for stack ******************/ void process_pdus(); void start_pcap(srslte::mac_pcap* pcap); // Timer callback interface void timer_expired(uint32_t timer_id); uint32_t get_current_tti(); private: void clear_rntis(); bool is_in_window(uint32_t tti, int* start, int* len); static const int MAC_MAIN_THREAD_PRIO = -1; // Use default high-priority below UHD static const int MAC_PDU_THREAD_PRIO = 5; // Interaction with PHY phy_interface_mac_lte* phy_h = nullptr; rlc_interface_mac* rlc_h = nullptr; rrc_interface_mac* rrc_h = nullptr; stack_interface_mac* stack_h = nullptr; srslte::log_ref log_h; mac_interface_phy_lte::mac_phy_cfg_mbsfn_t phy_mbsfn_cfg = {}; // RNTI search window scheduling int si_window_length = -1, si_window_start = -1; int ra_window_length = -1, ra_window_start = -1; int p_window_start = -1; // UE-specific RNTIs ue_rnti_t uernti; /* Multiplexing/Demultiplexing Units */ mux mux_unit; demux demux_unit; /* DL/UL HARQ */ dl_harq_entity_vector dl_harq; ul_harq_entity_vector ul_harq; ul_harq_cfg_t ul_harq_cfg; /* MAC Uplink-related Procedures */ ra_proc ra_procedure; sr_proc sr_procedure; bsr_proc bsr_procedure; phr_proc phr_procedure; /* Buffers for PCH reception (not included in DL HARQ) */ const static uint32_t pch_payload_buffer_sz = 8 * 1024; srslte_softbuffer_rx_t pch_softbuffer; uint8_t pch_payload_buffer[pch_payload_buffer_sz]; /* Buffers for MCH reception (not included in DL HARQ) */ const static uint32_t mch_payload_buffer_sz = SRSLTE_MAX_BUFFER_SIZE_BYTES; srslte_softbuffer_rx_t mch_softbuffer; uint8_t mch_payload_buffer[mch_payload_buffer_sz]; srslte::mch_pdu mch_msg; /* Functions for MAC Timers */ srslte::timer_handler::unique_timer timer_alignment; void setup_timers(int time_alignment_timer); void timer_alignment_expire(); /* Queue to dispatch stack tasks */ srslte::task_multiqueue::queue_handler stack_task_dispatch_queue; srslte::byte_buffer_pool* pool = nullptr; // pointer to MAC PCAP object srslte::mac_pcap* pcap = nullptr; bool is_first_ul_grant = false; mac_metrics_t metrics[SRSLTE_MAX_CARRIERS] = {}; bool initialized = false; const uint8_t PCELL_CC_IDX = 0; }; } // namespace srsue #endif // SRSUE_MAC_H