/** * Copyright 2013-2021 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_STATE_H #define SRSRAN_STATE_H #include "../phy_metrics.h" #include "srsran/adt/circular_array.h" #include "srsran/common/common.h" #include "srsran/interfaces/ue_nr_interfaces.h" #include "srsran/srsran.h" #include #include #include namespace srsue { namespace nr { class state { private: struct pending_ul_grant_t { bool enable; uint32_t pid; srsran_sch_cfg_nr_t sch_cfg; }; srsran::circular_array pending_ul_grant = {}; mutable std::mutex pending_ul_grant_mutex; struct pending_dl_grant_t { bool enable; uint32_t pid; srsran_sch_cfg_nr_t sch_cfg; srsran_pdsch_ack_resource_nr_t ack_resource; }; srsran::circular_array pending_dl_grant = {}; mutable std::mutex pending_dl_grant_mutex; srsran::circular_array pending_ack = {}; mutable std::mutex pending_ack_mutex; /// Metrics section info_metrics_t info_metrics = {}; sync_metrics_t sync_metrics = {}; ch_metrics_t ch_metrics = {}; dl_metrics_t dl_metrics = {}; ul_metrics_t ul_metrics = {}; mutable std::mutex metrics_mutex; /// CSI-RS measurements std::mutex csi_measurements_mutex; std::array csi_measurements = {}; /** * @brief Resets all metrics (unprotected) */ void reset_metrics_() { sync_metrics.reset(); ch_metrics.reset(); dl_metrics.reset(); ul_metrics.reset(); } public: mac_interface_phy_nr* stack = nullptr; /// Physical layer user configuration phy_args_nr_t args = {}; /// Physical layer higher layer configuration, provided by higher layers through configuration messages srsran::phy_cfg_nr_t cfg = {}; /// Semaphore for aligning UL work srsran::tti_semaphore dl_ul_semaphore; uint32_t rar_grant_tti = 0; state() { // Hard-coded values, this should be set when the measurements take place csi_measurements[0].K_csi_rs = 1; csi_measurements[0].nof_ports = 1; csi_measurements[1].K_csi_rs = 4; csi_measurements[1].nof_ports = 1; } /** * @brief Stores a received UL DCI into the pending UL grant list * @param tti_rx The TTI in which the grant was received * @param dci_ul The UL DCI message to store */ void set_ul_pending_grant(uint32_t tti_rx, const srsran_dci_ul_nr_t& dci_ul) { // Convert UL DCI to grant srsran_sch_cfg_nr_t pusch_cfg = {}; if (srsran_ra_ul_dci_to_grant_nr(&cfg.carrier, &cfg.pusch, &dci_ul, &pusch_cfg, &pusch_cfg.grant)) { std::array str; srsran_dci_ul_nr_to_str(NULL, &dci_ul, str.data(), str.size()); ERROR("Computing UL grant %s", str.data()); return; } // Calculate Transmit TTI uint32_t tti_tx = TTI_ADD(tti_rx, pusch_cfg.grant.k); // Scope mutex to protect read/write the list std::lock_guard lock(pending_ul_grant_mutex); // Save entry pending_ul_grant_t& pending_grant = pending_ul_grant[tti_tx]; pending_grant.sch_cfg = pusch_cfg; pending_grant.pid = dci_ul.pid; pending_grant.enable = true; } /** * @brief Checks the UL pending grant list if there is any grant to transmit for the given transmit TTI * @param tti_tx Current transmit TTI * @param sch_cfg Provides the Shared Channel configuration for the PUSCH transmission * @param pid Provides the HARQ process identifier * @return true if there is a pending grant for the given TX tti, false otherwise */ bool get_ul_pending_grant(uint32_t tti_tx, srsran_sch_cfg_nr_t& pusch_cfg, uint32_t& pid) { // Scope mutex to protect read/write the list std::lock_guard lock(pending_ul_grant_mutex); // Select entry pending_ul_grant_t& pending_grant = pending_ul_grant[tti_tx]; // If the entry is not active, just return if (!pending_grant.enable) { return false; } // Load shared channel configuration and PID pusch_cfg = pending_grant.sch_cfg; pid = pending_grant.pid; // Reset entry pending_grant.enable = false; return true; } /** * @brief Stores a received DL DCI into the pending DL grant list * @param tti_rx The TTI in which the grant was received * @param dci_dl The DL DCI message to store */ void set_dl_pending_grant(const srsran_slot_cfg_t& slot, const srsran_dci_dl_nr_t& dci_dl) { // Convert DL DCI to grant srsran_sch_cfg_nr_t pdsch_cfg = {}; if (srsran_ra_dl_dci_to_grant_nr(&cfg.carrier, &slot, &cfg.pdsch, &dci_dl, &pdsch_cfg, &pdsch_cfg.grant)) { ERROR("Computing UL grant"); return; } // Calculate DL DCI to PDSCH ACK resource srsran_pdsch_ack_resource_nr_t ack_resource = {}; if (srsran_ue_dl_nr_pdsch_ack_resource(&cfg.harq_ack, &dci_dl, &ack_resource) < SRSRAN_SUCCESS) { ERROR("Computing UL ACK resource"); return; } // Calculate Receive TTI uint32_t tti_rx = TTI_ADD(slot.idx, pdsch_cfg.grant.k); // Scope mutex to protect read/write the list std::lock_guard lock(pending_dl_grant_mutex); // Save entry pending_dl_grant_t& pending_grant = pending_dl_grant[tti_rx]; pending_grant.sch_cfg = pdsch_cfg; pending_grant.ack_resource = ack_resource; pending_grant.pid = dci_dl.pid; pending_grant.enable = true; } /** * @brief Checks the DL pending grant list if there is any grant to receive for the given receive TTI * @param tti_rx Current receive TTI * @param sch_cfg Provides the Shared Channel configuration for the PDSCH transmission * @param ack_resource Provides the UL ACK resource * @param pid Provides the HARQ process identifier * @return true if there is a pending grant for the given TX tti, false otherwise */ bool get_dl_pending_grant(uint32_t tti_rx, srsran_sch_cfg_nr_t& pdsch_cfg, srsran_pdsch_ack_resource_nr_t& ack_resource, uint32_t& pid) { // Scope mutex to protect read/write the list std::lock_guard lock(pending_dl_grant_mutex); // Select entry pending_dl_grant_t& pending_grant = pending_dl_grant[tti_rx]; // If the entry is not active, just return if (!pending_grant.enable) { return false; } // Load shared channel configuration and resource pdsch_cfg = pending_grant.sch_cfg; ack_resource = pending_grant.ack_resource; pid = pending_grant.pid; // Reset entry pending_grant.enable = false; return true; } /** * @brief Stores a pending PDSCH ACK into the pending ACK list * @param tti_rx The TTI in which the PDSCH transmission was received * @param dci_dl The DL DCI message to store */ void set_pending_ack(const uint32_t& tti_rx, const srsran_pdsch_ack_resource_nr_t& ack_resource, const bool& crc_ok) { // Calculate Receive TTI uint32_t tti_tx = TTI_ADD(tti_rx, ack_resource.k1); // Prepare ACK information srsran_pdsch_ack_m_nr_t ack_m = {}; ack_m.resource = ack_resource; ack_m.value[0] = crc_ok ? 1 : 0; ack_m.present = true; // Scope mutex to protect read/write the list std::lock_guard lock(pending_ack_mutex); // Select UL transmission time resource srsran_pdsch_ack_nr_t& ack = pending_ack[tti_tx]; ack.nof_cc = 1; // Insert PDSCH transmission information if (srsran_ue_dl_nr_ack_insert_m(&ack, &ack_m) < SRSRAN_SUCCESS) { ERROR("Error inserting ACK m value"); } } bool get_pending_ack(const uint32_t& tti_tx, srsran_pdsch_ack_nr_t& pdsch_ack) { // Scope mutex to protect read/write the list std::lock_guard lock(pending_ack_mutex); // Select UL transmission time resource srsran_pdsch_ack_nr_t& ack = pending_ack[tti_tx]; // No pending grant was set if (ack.nof_cc == 0) { return false; } // Copy data pdsch_ack = ack; // Reset list entry ack = {}; return true; } void reset() { clear_pending_grants(); reset_metrics(); reset_measurements(); } bool has_valid_sr_resource(uint32_t sr_id) { for (const srsran_pucch_nr_sr_resource_t& r : cfg.pucch.sr_resources) { if (r.configured && r.sr_id == sr_id) { return true; } } return false; } void clear_pending_grants() { // Scope mutex to protect read/write the list std::lock_guard lock(pending_ul_grant_mutex); // Clear all PDSCH assignments and PUSCH grants pending_dl_grant = {}; pending_ul_grant = {}; pending_ack = {}; } void get_pending_sr(const uint32_t& tti, srsran_uci_data_nr_t& uci_data) { // Calculate all SR opportunities in the given TTI uint32_t sr_resource_id[SRSRAN_PUCCH_MAX_NOF_SR_RESOURCES] = {}; int n = srsran_ue_ul_nr_sr_send_slot(cfg.pucch.sr_resources, tti, sr_resource_id); if (n < SRSRAN_SUCCESS) { ERROR("Calculating SR opportunities"); return; } // Initialise counters uint32_t sr_count_all = (uint32_t)n; uint32_t sr_count_positive = 0; // Iterate all opportunities and check if there is a pending SR for (uint32_t i = 0; i < sr_count_all; i++) { // Extract SR identifier uint32_t sr_id = cfg.pucch.sr_resources[sr_resource_id[i]].sr_id; // Check if the SR resource ID is pending if (args.fixed_sr.count(sr_id) > 0 || stack->sr_opportunity(tti, sr_id, false, pending_ul_grant[TTI_TX(tti)].enable)) { // Count it as present sr_count_positive++; } } // Configure SR fields in UCI data uci_data.cfg.pucch.sr_resource_id = sr_resource_id[0]; uci_data.cfg.o_sr = srsran_ra_ul_nr_nof_sr_bits(sr_count_all); uci_data.cfg.pucch.sr_positive_present = sr_count_positive > 0; uci_data.value.sr = sr_count_positive; } void get_periodic_csi(const uint32_t& tti, srsran_uci_data_nr_t& uci_data) { int n = srsran_csi_generate_reports(&cfg.csi, tti, csi_measurements.data(), uci_data.cfg.csi, uci_data.value.csi); if (n > SRSRAN_SUCCESS) { uci_data.cfg.nof_csi = n; } uci_data.cfg.pucch.rnti = stack->get_ul_sched_rnti_nr(tti).id; } /** * @brief Sets time and frequency synchronization metrics * @param m Metrics object */ void set_info_metrics(const info_metrics_t& m) { std::lock_guard lock(metrics_mutex); info_metrics = m; } /** * @brief Sets time and frequency synchronization metrics * @param m Metrics object */ void set_sync_metrics(const sync_metrics_t& m) { std::lock_guard lock(metrics_mutex); sync_metrics.set(m); } /** * @brief Sets DL channel metrics from received CSI-RS resources * @param m Metrics object */ void set_channel_metrics(const ch_metrics_t& m) { std::lock_guard lock(metrics_mutex); ch_metrics.set(m); } /** * @brief Sets DL metrics of a given PDSCH transmission * @param m Metrics object */ void set_dl_metrics(const dl_metrics_t& m) { std::lock_guard lock(metrics_mutex); dl_metrics.set(m); } /** * @brief Sets UL metrics of a given PUSCH transmission * @param m Metrics object */ void set_ul_metrics(const ul_metrics_t& m) { std::lock_guard lock(metrics_mutex); ul_metrics.set(m); } /** * @brief Resets all metrics (protected) */ void reset_metrics() { std::lock_guard lock(metrics_mutex); reset_metrics_(); } /** * @brief Appends the NR PHY metrics to the general metric hub * @param m PHY Metrics object */ void get_metrics(phy_metrics_t& m) { std::lock_guard lock(metrics_mutex); uint32_t cc = m.nof_active_cc; m.info[cc] = info_metrics; m.sync[cc] = sync_metrics; m.ch[cc] = ch_metrics; m.dl[cc] = dl_metrics; m.ul[cc] = ul_metrics; m.nof_active_cc++; // Reset all metrics reset_metrics_(); } /** * @brief Resets all PHY measurements (protected) */ void reset_measurements() { std::lock_guard lock(csi_measurements_mutex); csi_measurements = {}; } /** * @brief Processes a new NZP-CSI-RS channel measurement * @param new_measure New measurement * @param resource_set_id NZP-CSI-RS resource set identifier used for the channel measurement */ void new_nzp_csi_rs_channel_measurement(const srsran_csi_channel_measurements_t& new_measure, uint32_t resource_set_id) { std::lock_guard lock(csi_measurements_mutex); if (srsran_csi_new_nzp_csi_rs_measurement( cfg.csi.csi_resources, csi_measurements.data(), &new_measure, resource_set_id) < SRSRAN_SUCCESS) { ERROR("Error processing new NZP-CSI-RS"); return; } } }; } // namespace nr } // namespace srsue #endif // SRSRAN_STATE_H