srsRAN_4G/srsenb/hdr/stack/mac/nr/sched_nr_ue.h

/**
 *
 * \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 SRSRAN_SCHED_NR_UE_H
#define SRSRAN_SCHED_NR_UE_H

#include "sched_nr_common.h"
#include "sched_nr_harq.h"
#include "sched_nr_interface.h"
#include "srsran/adt/circular_map.h"
#include "srsran/adt/move_callback.h"
#include "srsran/adt/pool/cached_alloc.h"

namespace srsenb {

namespace sched_nr_impl {

class ue_carrier;

class slot_ue
{
public:
  slot_ue() = default;
  explicit slot_ue(bool& busy_signal, tti_point tti_rx_, uint32_t cc);
  ~slot_ue();
  slot_ue(slot_ue&&) noexcept = default;
  slot_ue& operator=(slot_ue&&) noexcept = default;
  bool     empty() const { return busy_signal == nullptr; }
  void     release();

  tti_point tti_rx;
  uint32_t  cc = SCHED_NR_MAX_CARRIERS;

  // UE parameters common to all sectors
  const sched_nr_ue_cfg* cfg = nullptr;
  bool                   pending_sr;

  // UE parameters that are sector specific
  uint32_t   dl_cqi;
  uint32_t   ul_cqi;
  harq_proc* h_dl = nullptr;
  harq_proc* h_ul = nullptr;

private:
  struct noop {
    void operator()(bool* ptr) {}
  };
  std::unique_ptr<bool, noop> busy_signal;
};

class ue_carrier
{
public:
  ue_carrier(uint16_t rnti, uint32_t cc, const sched_nr_ue_cfg& cfg);
  slot_ue try_reserve(tti_point tti_rx, const sched_nr_ue_cfg& cfg);
  void    push_feedback(srsran::move_callback<void(ue_carrier&)> callback);
  void    set_cfg(const sched_nr_ue_cfg& uecfg);

  const uint16_t rnti;
  const uint32_t cc;

  // Channel state
  uint32_t dl_cqi = 1;
  uint32_t ul_cqi = 0;

  harq_entity harq_ent;

private:
  const sched_nr_ue_cfg* cfg = nullptr;

  bool      busy{false};
  tti_point last_tti_rx;

  srsran::deque<srsran::move_callback<void(ue_carrier&)> > pending_feedback;
};

class ue
{
public:
  ue(uint16_t rnti, const sched_nr_ue_cfg& cfg);

  slot_ue try_reserve(tti_point tti_rx, uint32_t cc);

  void set_cfg(const sched_nr_ue_cfg& cfg);

  void ul_sr_info(tti_point tti_rx) { pending_sr = true; }

  std::array<std::unique_ptr<ue_carrier>, SCHED_NR_MAX_CARRIERS> carriers;

private:
  bool pending_sr = false;

  int                            current_idx = 0;
  std::array<sched_nr_ue_cfg, 4> ue_cfgs;
};

using ue_map_t = srsran::static_circular_map<uint16_t, std::unique_ptr<ue>, SCHED_NR_MAX_USERS>;

} // namespace sched_nr_impl

} // namespace srsenb

#endif // SRSRAN_SCHED_NR_UE_H