srsRAN_4G/lib/include/srsran/interfaces/phy_common_interface.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_PHY_COMMON_INTERFACE_H
#define SRSRAN_PHY_COMMON_INTERFACE_H

#include "../radio/rf_buffer.h"
#include "../radio/rf_timestamp.h"

namespace srsran {

/**
 * @brief Descibes a physical layer common interface
 */
class phy_common_interface
{
public:
  /**
   * @brief Describes a worker context
   */
  struct worker_context_t {
    uint32_t               sf_idx     = 0;       ///< Subframe index
    void*                  worker_ptr = nullptr; ///< Worker pointer for wait/release semaphore
    bool                   last       = false;   ///< Indicates this worker is the last one in the sub-frame processing
    srsran::rf_timestamp_t tx_time    = {};      ///< Transmit time, used only by last worker

    void copy(const worker_context_t& other)
    {
      sf_idx     = other.sf_idx;
      worker_ptr = other.worker_ptr;
      last       = other.last;
      tx_time.copy(other.tx_time);
    }

    worker_context_t() = default;
    worker_context_t(const worker_context_t& other) { copy(other); }
  };

  /**
   * @brief Common PHY interface for workers to indicate they ended
   * @param w_ctx Worker context
   * @param tx_enable Indicates whether the buffer has baseband samples to transmit
   * @param buffer Baseband buffer
   */
  virtual void worker_end(const worker_context_t& w_ctx, const bool& tx_enable, srsran::rf_buffer_t& buffer) = 0;
};

} // namespace srsran

#endif // SRSRAN_PHY_COMMON_INTERFACE_H