srsLTE/lib/include/srsran/phy/ue/ue_phy.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.
 *
 */

/******************************************************************************
 *  File:         ue_phy.h
 *
 *  Description:  Top-level class wrapper for PHY layer.
 *
 *  Reference:
 *****************************************************************************/

#include "srsran/phy/utils/queue.h"
#include "srsran/srsran.h"

#ifndef SRSRAN_UE_PHY_H
#define SRSRAN_UE_PHY_H

#define SYNC_MODE_CV 0
#define SYNC_MODE_CALLBACK 1
#define SYNC_MODE SYNC_MODE_CV

namespace srsran {

typedef _Complex float cf_t;

class ue_phy
{
public:
  typedef enum { DOWNLINK, UPLINK } direction_t;

  typedef enum {
    PDCCH_UL_SEARCH_CRNTI = 0,
    PDCCH_UL_SEARCH_RA_PROC,
    PDCCH_UL_SEARCH_SPS,
    PDCCH_UL_SEARCH_TEMPORAL,
    PDCCH_UL_SEARCH_TPC_PUSCH,
    PDCCH_UL_SEARCH_TPC_PUCCH
  } pdcch_ul_search_t;

  typedef enum {
    PDCCH_DL_SEARCH_CRNTI = 0,
    PDCCH_DL_SEARCH_SIRNTI,
    PDCCH_DL_SEARCH_PRNTI,
    PDCCH_DL_SEARCH_RARNTI,
    PDCCH_DL_SEARCH_TEMPORAL,
    PDCCH_DL_SEARCH_SPS
  } pdcch_dl_search_t;

  /* Uplink/Downlink scheduling dci generated by a successfully decoded PDCCH */
  class sched_grant
  {
  public:
    uint16_t get_rnti();
    uint32_t get_rv();
    void     set_rv(uint32_t rv);
    bool     get_ndi();
    bool     get_cqi_request();
    uint32_t get_harq_process();

  private:
    union {
      srsran_ra_ul_grant_t ul_grant;
      srsran_ra_dl_grant_t dl_grant;
    };
    direction_t dir;
  };

  /* Uplink scheduling assignment. The MAC instructs the PHY to prepare an UL packet (PUSCH or PUCCH)
   * for transmission. The MAC must call generate_pusch() to set the packet ready for transmission
   */
  class ul_buffer : public queue::element
  {
  public:
    ul_buffer(srsran_cell_t cell);
    void generate_pusch(sched_grant pusch_grant, uint8_t* payload, srsran_uci_data_t uci_data);
    void generate_pucch(srsran_uci_data_t uci_data);

  private:
    srsran_ue_ul_t ue_ul;
    bool           signal_generated = false;
    cf_t*          signal_buffer    = NULL;
    uint32_t       tti              = 0;
  };

  /* Class for the processing of Downlink buffers. The MAC obtains a buffer for a given TTI and then
   * gets ul/dl scheduling grants and/or processes phich/pdsch channels
   */
  class dl_buffer : public queue::element
  {
  public:
    dl_buffer(srsran_cell_t cell);
    sched_grant get_ul_grant(pdcch_ul_search_t mode, uint32_t rnti);
    sched_grant get_dl_grant(pdcch_dl_search_t mode, uint32_t rnti);
    bool        decode_phich(sched_grant pusch_grant);
    bool        decode_pdsch(sched_grant pdsch_grant, uint8_t* payload); // returns true or false for CRC OK/KO
  private:
    srsran_ue_dl_t ue_dl;
    srsran_phich_t phich;
    cf_t*          signal_buffer          = NULL;
    bool           sf_symbols_and_ce_done = false;
    bool           pdcch_llr_extracted    = false;
    uint32_t       tti                    = 0;
  };

#if SYNC_MODE == SYNC_MODE_CALLBACK
  typedef (*ue_phy_tti_clock_fcn_t)(void);
  ue_phy(ue_phy_tti_clock_fcn_t tti_clock_callback);
#else
  ue_phy();
#endif
  ~ue_phy();

  void measure(); // TBD
  void dl_bch();
  void start_rxtx();
  void stop_rxtx();
  void init_prach();
  void send_prach(/* prach_cfg_t in prach.h with power, seq idx, etc */);
  void set_param();

  uint32_t get_tti();
#if SYNC_MODE == SYNC_MODE_CV
  std::condition_variable tti_cv;
  std::mutex              tti_mutex;
#endif

  ul_buffer get_ul_buffer(uint32_t tti);
  dl_buffer get_dl_buffer(uint32_t tti);

private:
  enum { IDLE, MEASURE, RX_BCH, RXTX } phy_state;

  bool           prach_initiated     = false;
  bool           prach_ready_to_send = false;
  srsran_prach_t prach;

  queue ul_buffer_queue;
  queue dl_buffer_queue;

  pthread_t radio_thread;
  void*     radio_handler;
};

} // namespace srsran
#endif // SRSRAN_UE_PHY_H